Neo 1973 GPS

From Openmoko

(Difference between revisions)
Jump to: navigation, search
(Rearranged sections)
Line 3: Line 3:
 
The external antenna for the GPS uses an [http://en.wikipedia.org/wiki/MMCX MMCX] connector.  More information about external antennas on the [[GPS antennas for neo1973|GPS antennas page]]. The connector for the internal GPS antenna also uses an MMCX connector. The external connector is located on the side of Freerunner.
 
The external antenna for the GPS uses an [http://en.wikipedia.org/wiki/MMCX MMCX] connector.  More information about external antennas on the [[GPS antennas for neo1973|GPS antennas page]]. The connector for the internal GPS antenna also uses an MMCX connector. The external connector is located on the side of Freerunner.
  
The two current models (Neo 1973 and Neo Freerunner) use different GPS chipsets.
 
 
The Neo 1973 used the [[Neo1973 hardware#AGPS|Hmamerhead]].
 
The Neo 1973 used the [[Neo1973 hardware#AGPS|Hmamerhead]].
The Neo Freerunner [[GTA02 GPS]] device contains the [[u-blox ANTARIS 4 ATR0635]].
 
 
A critical problem with early (current) GTA02s is that accesssing the SD card generates RF noise, which causes very long TTFF (time to first fix) (10min+ or longer). See [[GPS Problems | this page]] for more discussion and suggested fixes. Using an external antenna is one.
 
  
 
== Low level access ==
 
== Low level access ==
 
=== GTA01 GPS ===
 
  
 
The Neo 1973 uses a separate userland driver to access the Hammerhead GPS. See this article for more information on this driver: [[gllin]]
 
The Neo 1973 uses a separate userland driver to access the Hammerhead GPS. See this article for more information on this driver: [[gllin]]
Line 28: Line 22:
  
 
Please see the important information on [[gllin]]!
 
Please see the important information on [[gllin]]!
 
=== GTA02 GPS ===
 
 
There is no userland driver required for the GTA02, the driver is built into the kernel.
 
 
To turn on the GPS, echo 1 to the sys file:
 
 
echo 1 > /sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron
 
 
To read from the GPS, simply read /dev/ttySAC1. Use the gpspipe command like this:
 
 
gpspipe -r 127.0.0.1 2947
 
 
You will find gpspipe in the package gps-utils. You can also just "cat /dev/ttySAC1" but it produces the unknown msg*58; This doesn't happen with gpspipe.
 
 
Before getting a fix, the GPS spits out lots of "$GPTXT,01,01,01,NMEA unknown msg*58", though these stop once a fix is obtained.
 
 
A position without a fix looks like this:
 
$GPGGA,235946.99,,,,,00,00,5.0,,M,0.0001999,M,0.0020199,*57
 
 
One with a fix:
 
$GPGGA,065852.00,5613.022527,N,00306.725890,W,1,05,0.5,158.0,M,0.277000,M,-0.010 0515,*7A
 
 
(The given position is in central Scotland.)
 
 
--[[User:Speedevil|Speedevil]] 11:52, 7 April 2008 (CEST)
 
 
If you are having GPS problems with your Freerunner, please document them on the page [[GPS Problems]]. [[FreeRunner GPS antenna repair SOP]] documents a possible solution.
 
 
In Openmoko projects, there is a GPS test program called '''agpsui''' that provides graphical and text dump of GPS information. See [[Howto Test Your GPS with agpsui]]. The project is called [http://svn.projects.openmoko.org/svnroot/openmoko-agpsui Openmoko AGPS UI project].
 
  
 
== Using GPS ==
 
== Using GPS ==
Line 73: Line 37:
 
This procedure depends upon being able to set up a network connection between your Neo and your laptop. The connection can be over either WiFi or USB cable.
 
This procedure depends upon being able to set up a network connection between your Neo and your laptop. The connection can be over either WiFi or USB cable.
  
First be sure you have gllin (on Neo 1973) and gpsd installed. Some Neo Freerunner images don't have gpsd, they use a different GPS stack called gypsy.  
+
First be sure you have gllin and gpsd installed.
  
 
# On host type: '''nc -vvn -l -p 5000 > /tmp/nmeaNP''' (Host starts listening on port 5000 for GPS-signals and sends them to /tmp/nmeaNP)
 
# On host type: '''nc -vvn -l -p 5000 > /tmp/nmeaNP''' (Host starts listening on port 5000 for GPS-signals and sends them to /tmp/nmeaNP)
Line 88: Line 52:
  
 
Here is how to make your smartphone appear to be a Bluetooth GPS.
 
Here is how to make your smartphone appear to be a Bluetooth GPS.
 
==== GTA01 ====
 
  
 
#Power up the bluetooth radio
 
#Power up the bluetooth radio
Line 96: Line 58:
 
#Run '''rfcomm watch 0 1 sh -c "cat /tmp/nmeaNP >/dev/rfcomm0" &'''
 
#Run '''rfcomm watch 0 1 sh -c "cat /tmp/nmeaNP >/dev/rfcomm0" &'''
  
==== GTA02 ====
+
{{GPS applications}}
 
+
#Power up the bluetooth radio
+
#Ensure [http://wiki.openmoko.org/wiki/Gpsd#GPS_on_GTA02 gpsd] is running and the gps-utils package is installed
+
#Run '''sdptool add SP'''
+
#Run '''rfcomm -r watch 0 1 sh -c "gpspipe -r >/dev/rfcomm0" &'''
+
 
+
 
+
== Possible GPS applications ==
+
 
+
As people develop more sophisticated GPS applications, please note them here.
+
 
+
=== Use cases ===
+
 
+
* I want to look at maps.
+
* I want to be able to prepare data and load my own maps.
+
* I want to load map data in a WKB (well known binary) format such as shapefiles.
+
* I want to go somewhere; please tell me how to get there. Routing.
+
* I want to help with the [[Openstreetmap]] project by collecting data.
+
* I want to use [[Openstreetmap]] data in a map viewer.
+
* I want to use the smartphone GPS to go [[Geocaching]]
+
* I want the GPS to update profile settings based on my location. Example, mute the phone ringer when I am at work.
+
* I want to log GPS data for later analysis.
+
* I want to collect GPS data for scientific field work (forestry, biology, etc)
+
 
+
See [http://lists.openmoko.org/pipermail/community/2007-July/007252.html for another collection of ideas.
+
 
+
=== Applications software ===
+
 
+
'''Please note if a program works or if it's vapourware.'''
+
 
+
* Cairo-based mapping (I wonder what this is?)
+
* [http://www.kflog.org/cumulus/ Cumulus] GPS software for glider pilots (and pilots in general), has a port for Qtopia and pulls (world) maps from the KFLog flight planner project. I think someone has put a project like this on the projects website * [http://wiki.openstreetmap.org/index.php/Pyroute Pyroute] is a routing program written in Python by Ojw, and a mobile phone GUI for maps, GPS, and routing.
+
:* [http://wiki.openstreetmap.org/index.php/Rana Raná] is the new version of pyroute
+
* [http://wiki.openstreetmap.org/index.php/Gosmore Gosmore] is a routing and viewer of OSM XML data such as the planet.osm.
+
* [[GPS Sight]], a popular Openmoko project under LGPL.
+
* [[GPS-Trail]] a simple trail logger.
+
* [[GPS_Navigation#roadmap|roadmap]] mapping system using freely available maps (US census TIGER, DGLib, shapefiles).
+
* [[Navit]] a car navigation system with routing engine.
+
* [http://svn.projects.openmoko.org/svnroot/openmoko-agpsui Openmoko AGPS UI project].* [[Orrery]], an unpopular Openmoko project for displaying the night sky.
+
* [[qpegps]] qtopia (arm PDA) based map viewer with gps features
+
* [[QMapControl]] Qtopia based mapping widget. Displays maps and custom data, also other widgets can be bound to coordinates. GPS parser for the gllin output included.
+
[http://projects.openmoko.org/projects/openvario/ here].
+
* [http://www.tangogps.org TangoGPS] mapping program. Downloads maps on demand and caches them, very efficient. '''Works very well.'''
+
  
 
[[Category:GPS]]
 
[[Category:GPS]]
 
[[category:Documentation]]
 
[[category:Documentation]]
 
[[category:Standard]]
 
[[category:Standard]]

Revision as of 23:02, 15 August 2008

The smartphones contain an integrated GPS receiver. The devices used are marketed as Assisted GPS ('AGPS'). Performance requirements are defined in GSM/GPRS 3GPP TS 25.171, CDMA 3GPP2 C.S0036-0. There is some discussion available as to what significance that "A" might have.

The external antenna for the GPS uses an MMCX connector. More information about external antennas on the GPS antennas page. The connector for the internal GPS antenna also uses an MMCX connector. The external connector is located on the side of Freerunner.

The Neo 1973 used the Hmamerhead.

Contents

Low level access

The Neo 1973 uses a separate userland driver to access the Hammerhead GPS. See this article for more information on this driver: gllin

The gllin driver itself is available here: http://3rdparty.downloads.openmoko.org/gllin/ It can be run from a command line. It outputs the NMEA data stream from the Hammerhead chip on a pseudotty device, so that it can be read as if the data were coming in on a serial port.

Here is email from Michael Shiloh about it. http://lists.openmoko.org/pipermail/community/2007-November/011916.html

There was an effort to write a Free Software program that could be used instead of this binary-only program, but this stalled after the decision to change GPS chips in GTA02. The Iphone 3G uses the same GPS chip. It's not inconceivable that this might lead to further effort.

See Hammerhead/Protocol for details and the latest status.

Some scripts for those with the binary are on Manually_using_GPS

Please see the important information on gllin!

Using GPS

Aside from accessing the GPS data in applications programs running directly on the smartphone, you can also access the GPS data stream from another gadget such as a laptop.

Here are a couple ways to do that. You can use a network connection to pull data from the gpsd daemon, or you can make the smartphone appear to be a generic Bluetooth-connected GPS receiver.

Using gpsd requires a program that understands its protocol, such as GPSdrive. Using Bluetooth would allow using just about any program that understands the NMEA protocol.

Using gpsd with a network connection

This procedure depends upon being able to set up a network connection between your Neo and your laptop. The connection can be over either WiFi or USB cable.

First be sure you have gllin and gpsd installed.

  1. On host type: nc -vvn -l -p 5000 > /tmp/nmeaNP (Host starts listening on port 5000 for GPS-signals and sends them to /tmp/nmeaNP)
  2. On the Neo type: nc 192.168.0.200 5000 < /dev/ttySAC1 (Signals from device will be send to port 5000 on host.) If your host is connected to the neo via wifi, change the IP address in the command to the one of the host.
  3. On the host PC install GPSD, your GPS is attached as /tmp/nmeaNP
  4. start gpsd on host with: gpsd -p /tmp/nmeaNP
  5. run your application! I used gpsdrive and it works better than my stand-alone GPS.

Tested with RoadNav. Works great!

If you have an unlimited GPRS data package you could make your gpsd service accessible over the Internet. This opens up many possibilities. For example, you could implemented AVL (Automatic Vehicle Location) by having a web server somewhere query your gpsd server for your position and write it to a KML file which would then display your location on a Google map.

Bluetooth GPS relay

Here is how to make your smartphone appear to be a Bluetooth GPS.

  1. Power up the bluetooth radio
  2. Run the gllin script
  3. Run sdptool add SP
  4. Run rfcomm watch 0 1 sh -c "cat /tmp/nmeaNP >/dev/rfcomm0" &

Template:GPS applications

Personal tools

The smartphones contain an integrated GPS receiver. The devices used are marketed as Assisted GPS ('AGPS'). Performance requirements are defined in GSM/GPRS 3GPP TS 25.171, CDMA 3GPP2 C.S0036-0. There is some discussion available as to what significance that "A" might have.

The external antenna for the GPS uses an MMCX connector. More information about external antennas on the GPS antennas page. The connector for the internal GPS antenna also uses an MMCX connector. The external connector is located on the side of Freerunner.

The two current models (Neo 1973 and Neo Freerunner) use different GPS chipsets. The Neo 1973 used the Hmamerhead. The Neo Freerunner GTA02 GPS device contains the u-blox ANTARIS 4 ATR0635.

A critical problem with early (current) GTA02s is that accesssing the SD card generates RF noise, which causes very long TTFF (time to first fix) (10min+ or longer). See this page for more discussion and suggested fixes. Using an external antenna is one.

Low level access

GTA01 GPS

The Neo 1973 uses a separate userland driver to access the Hammerhead GPS. See this article for more information on this driver: gllin

The gllin driver itself is available here: http://3rdparty.downloads.openmoko.org/gllin/ It can be run from a command line. It outputs the NMEA data stream from the Hammerhead chip on a pseudotty device, so that it can be read as if the data were coming in on a serial port.

Here is email from Michael Shiloh about it. http://lists.openmoko.org/pipermail/community/2007-November/011916.html

There was an effort to write a Free Software program that could be used instead of this binary-only program, but this stalled after the decision to change GPS chips in GTA02. The Iphone 3G uses the same GPS chip. It's not inconceivable that this might lead to further effort.

See Hammerhead/Protocol for details and the latest status.

Some scripts for those with the binary are on Manually_using_GPS

Please see the important information on gllin!

GTA02 GPS

There is no userland driver required for the GTA02, the driver is built into the kernel.

To turn on the GPS, echo 1 to the sys file:

echo 1 > /sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron

To read from the GPS, simply read /dev/ttySAC1. Use the gpspipe command like this:

gpspipe -r 127.0.0.1 2947

You will find gpspipe in the package gps-utils. You can also just "cat /dev/ttySAC1" but it produces the unknown msg*58; This doesn't happen with gpspipe.

Before getting a fix, the GPS spits out lots of "$GPTXT,01,01,01,NMEA unknown msg*58", though these stop once a fix is obtained.

A position without a fix looks like this:

$GPGGA,235946.99,,,,,00,00,5.0,,M,0.0001999,M,0.0020199,*57

One with a fix:

$GPGGA,065852.00,5613.022527,N,00306.725890,W,1,05,0.5,158.0,M,0.277000,M,-0.010 0515,*7A

(The given position is in central Scotland.)

--Speedevil 11:52, 7 April 2008 (CEST)

If you are having GPS problems with your Freerunner, please document them on the page GPS Problems. FreeRunner GPS antenna repair SOP documents a possible solution.

In Openmoko projects, there is a GPS test program called agpsui that provides graphical and text dump of GPS information. See Howto Test Your GPS with agpsui. The project is called Openmoko AGPS UI project.

Using GPS

Aside from accessing the GPS data in applications programs running directly on the smartphone, you can also access the GPS data stream from another gadget such as a laptop.

Here are a couple ways to do that. You can use a network connection to pull data from the gpsd daemon, or you can make the smartphone appear to be a generic Bluetooth-connected GPS receiver.

Using gpsd requires a program that understands its protocol, such as GPSdrive. Using Bluetooth would allow using just about any program that understands the NMEA protocol.

Using gpsd with a network connection

This procedure depends upon being able to set up a network connection between your Neo and your laptop. The connection can be over either WiFi or USB cable.

First be sure you have gllin (on Neo 1973) and gpsd installed. Some Neo Freerunner images don't have gpsd, they use a different GPS stack called gypsy.

  1. On host type: nc -vvn -l -p 5000 > /tmp/nmeaNP (Host starts listening on port 5000 for GPS-signals and sends them to /tmp/nmeaNP)
  2. On the Neo type: nc 192.168.0.200 5000 < /dev/ttySAC1 (Signals from device will be send to port 5000 on host.) If your host is connected to the neo via wifi, change the IP address in the command to the one of the host.
  3. On the host PC install GPSD, your GPS is attached as /tmp/nmeaNP
  4. start gpsd on host with: gpsd -p /tmp/nmeaNP
  5. run your application! I used gpsdrive and it works better than my stand-alone GPS.

Tested with RoadNav. Works great!

If you have an unlimited GPRS data package you could make your gpsd service accessible over the Internet. This opens up many possibilities. For example, you could implemented AVL (Automatic Vehicle Location) by having a web server somewhere query your gpsd server for your position and write it to a KML file which would then display your location on a Google map.

Bluetooth GPS relay

Here is how to make your smartphone appear to be a Bluetooth GPS.

GTA01

  1. Power up the bluetooth radio
  2. Run the gllin script
  3. Run sdptool add SP
  4. Run rfcomm watch 0 1 sh -c "cat /tmp/nmeaNP >/dev/rfcomm0" &

GTA02

  1. Power up the bluetooth radio
  2. Ensure gpsd is running and the gps-utils package is installed
  3. Run sdptool add SP
  4. Run rfcomm -r watch 0 1 sh -c "gpspipe -r >/dev/rfcomm0" &


Possible GPS applications

As people develop more sophisticated GPS applications, please note them here.

Use cases

  • I want to look at maps.
  • I want to be able to prepare data and load my own maps.
  • I want to load map data in a WKB (well known binary) format such as shapefiles.
  • I want to go somewhere; please tell me how to get there. Routing.
  • I want to help with the Openstreetmap project by collecting data.
  • I want to use Openstreetmap data in a map viewer.
  • I want to use the smartphone GPS to go Geocaching
  • I want the GPS to update profile settings based on my location. Example, mute the phone ringer when I am at work.
  • I want to log GPS data for later analysis.
  • I want to collect GPS data for scientific field work (forestry, biology, etc)

See [http://lists.openmoko.org/pipermail/community/2007-July/007252.html for another collection of ideas.

Applications software

Please note if a program works or if it's vapourware.

  • Cairo-based mapping (I wonder what this is?)
  • Cumulus GPS software for glider pilots (and pilots in general), has a port for Qtopia and pulls (world) maps from the KFLog flight planner project. I think someone has put a project like this on the projects website * Pyroute is a routing program written in Python by Ojw, and a mobile phone GUI for maps, GPS, and routing.
  • Raná is the new version of pyroute
  • Gosmore is a routing and viewer of OSM XML data such as the planet.osm.
  • GPS Sight, a popular Openmoko project under LGPL.
  • GPS-Trail a simple trail logger.
  • roadmap mapping system using freely available maps (US census TIGER, DGLib, shapefiles).
  • Navit a car navigation system with routing engine.
  • Openmoko AGPS UI project.* Orrery, an unpopular Openmoko project for displaying the night sky.
  • qpegps qtopia (arm PDA) based map viewer with gps features
  • QMapControl Qtopia based mapping widget. Displays maps and custom data, also other widgets can be bound to coordinates. GPS parser for the gllin output included.

here.

  • TangoGPS mapping program. Downloads maps on demand and caches them, very efficient. Works very well.