gpspositionprovider.jar

Description
This bundle provides provides a org.osgi.service.wireadmin.Producer service that polls GPS positions from a GPS receiver connected to the gateway by a serial link or others receiver (CellID from Cellular Phone, ...)
In fact, this bundle use classes from GPSMap (http://gpsmap.sourceforge.net) done by Christof Dallermassl.

For more details on how to use this bundle, refer to the /doc/readme.html file embedded in the bundle jarfile.

Contributors
Didier Donsez (Didier.Donsez@ieee.org)

License
LGPL

Services
org.osgi.service.wireadmin.Producer

Properties

• wireadmin.producer.flavors=Class[] { org.osgi.util.position.Position.class, java.lang.String.class }
• service.pid=fr.imag.adele.bundle.gpspositionproducer
• service.description=A service that polls positions from a GPS receiver
• PositioningMethod=GPS

Requirements

• javax.comm
• org.osgi.service.wireadmin; specification-version=1.0
• org.osgi.util.measurement; specification-version=1.0
• org.osgi.util.position; specification-version=1.0

Download

• Bundle binaries
• Bundle sources
• The latest version of this documentation
• The OBR descriptor (text format)

Build

1. download a recent distribution of GPSMap available from http://gpsmap.sourceforge.net
2. install javax.comm (which can be put in $JAVA_HOME/jre/lib)
3. download a recent distribution of the javax.comm available from http://java.sun.com/products/javacomm/
4. configure the build properties in build.xml
5. build the embedded lib extracted from gpstool.jar with ant build.embeddedlibs
6. configure the properties (serial port, ...) in ./res/config.properties
7. build with ant

Usage
1 bundle use the fr.imag.adele.bundle.location.LocationProvider service registered by this bundle

• locationservlet.jar is a servlet which offer a simple front end to display the current GPS position (http://thegateway/location/read)

Tested gateways (testers are welcome)

• OSCAR (done by Didier Donsez) under SUN VM under WinXP
• Knopflerfish OSGi (done by David Tacconi) under IBM J9 for Palm and IBM J9 for iPaq6300.
• SUN JES (to do)
• IBM SMF (to do)

Tested GPS Receiver (testers are welcome)

• Trimble Lassen SK8 (serial port : NMEA output mode) (by Didier Donsez)
• Garmin eTrex Legend (serial port : NMEA output mode) (by Didier Donsez)
• Sanav BT-48 (Bluetooth serial port : NMEA output mode) (by david [dot] tacconi [at] create-net [dot] it)

TODO (contributions are welcome)

• provides a service for the J2ME Location API (JSR 179)
• produces Location objects (J2ME Location API (JSR 179)) optionallaly by using dynamic import
• Package as a Driver/Device for a Device Access Manager
• test it with RXTX under Linux (http://www.frii.com/~jarvi/rxtx/intro.html), a GNU javax.comm alternative (for Linux, ...). requires to add a GsmTransport using org.gnu.rxtx

Typical usage

• in telematics

Links
Some links on other wire admin materials:

• My Wire Admin Implementation
• The OSCAR shell command for the wire admin
• The Customer Servlet that display polled objects
• A GPS Position Producer (requires a serial GPS Receiver !)
• A POI Tracker (Point Of Interest) (is a position consumer)
• My Bundle Farm

• Download the latest version of GPSMap
• GPS - NMEA sentence information
• NMEA Web Site
• FAQ on GPS and NMEA
• http://home.mira.net/~gnb/gps/nmea.html
• http://www.grc.nasa.gov/WWW/MAEL/ag/agnmea1.htm
• J2ME and the Location API
• * Location API for J2ME specification (JSR 179)
• A fine NASA tool to get positions from sattelite maps

My GPS position
lat 45 11'37"N, lon 05 46'15"E, alt 223m