|
|
Prune GPS tool: version 6 released
10-07-2008
|
|
GPSTRANS(1) GPS Utility GPSTRANS(1) NAME
gpstrans - communicate with Garmin GPS receiver SYNOPOSIS
gpstrans [ options ] [ file ] DESCRIPTION
gpstrans allows the user with a Garmin GPS receiver to upload and download waypoints, routes, almanacs (satellite orbital elements) and trackroutes. If file is not supplied, data will be read from stdin (-ux switch) or written to stdout (-dx switch). OPTIONS
-pport set serial I/O device -s set datum, format, offset, and device interactively, and save them in $HOME/.gpstrans. -i identify connected GPS -o turn off GPS device -t get time from GPS -ts get time from GPS and set system time on host -dx download data indicated by x: r=route, t=track, w=waypoint, a=almanac -m With -dt, downloads track data in the format which can be displayed by Mayko mXmap(1). With -dr or -ur, downloads or uploads route data in a format compatible with Mayko mXmap. -ux upload data indicated by x: r=route, t=track, w=waypoint, a=almanac -v print program version. --verbose Increase verbosity. --debug Add debug printouts. --help Print help text. CONNECTION
For a DB-25 connector, you may need to connect pin 4, 5 and 6, 8, 20 together. This sets handshake signals so that your workstation can use the serial port to communicate with the GPS. 1 ### ##### o o o # # # o # o o o o o o o o o o o # o o o o o Connect the Garmin cable as follows: 2 3 7 o o o o o o o o o o o o o o o o o o o o o o o o o Pin 2 goes to DATA IN (White) Pin 3 goes to DATA OUT (Brown) Pin 7 goes to GROUND (Black) If it doesn't work in this way, try exchanging pins 2 and 3 at the connector. The circular connector on a Garmin GPS II receiver can be wired to a DB-9 connector as follows: _____ _____,-----, 3 / 4 | | | | o o | | | |_____ | < <- groove -> |=====| |----,| | o o | | | | || 2 _____ / 1 |_____| | || `-----' || || views are looking || into connector || at each end of cable || || || 5 3 2 ________ || o o o o o | \___________|| o o o o |_________,------------' DB-9 pin 2 goes to circular connector pin 2 DB-9 pin 3 goes to circular connector pin 4 DB-9 pin 5 goes to circular connector pin 3 other pins are not connected (Note: the pin numbers for the circular connector are arbitrary, and may not match the `official' numbers.) If your plug is more recent than the one above (ex: etrex) then you need DB-9 or DB-25 to be connected to your Garmin GPS like this: _____,-----, POWER(+) | | | groove --> |=====| |_____ DATA IN | | |----,| DATA OUT | | | || GROUND(-) |_____| | || `-----' || || || || || || || ________ || | \___________|| |_________,------------' DB-25 : 2 3 7 o o o o o o o o o o o o o o o o o o o o o o o o o Pin 2 goes to DATA IN (White) Pin 3 goes to DATA OUT (Brown) Pin 7 goes to GROUND (Black) DB-9: 5 3 2 o o o o o o o o o pin 2 goes to DATA IN (White) pin 3 goes to DATA OUT (Brown) pin 5 goes to GROUND (Black) other pins are not connected For testing, you might try setting the GPS to NMEA-Output and using a terminal emulator program like Kermit. The GPS will send a data record every 2 seconds. As long as you don't see any data on your computer, gpstrans won't work. After finishing the test, be sure to set your GPS receiver to GRMN/GRMN. ENVIRONMENT
GPSDEV Serial I/O device (overrides contents of $HOME/.gpstrans, and is overridden by -p switch). FILES
$HOME/.gpstrans Has user preferences for datum, format, offset, and serial I/O device (see -s switch, above). AUTHOR
GPStrans is Copyright 1995 by Carsten Tschach <tschach@zedat.fu-berlin.de>. The datum translation routines are based on the program MacGPS from John F. Waers <jfwaers@csn.net>. Mayko mXmap output format by Matthias Kattanek <mattes@ugraf.com>. German Grid by Andreas Lange <andreas.lange@rhein-main.de>. etrex support by Joao Seabra CT2GNL - <seabra@ci.aac.uc.pt>. Other Garmin formats added by Jim Van Zandt <jrvz@comcast.remove.me.net>. SEE ALSO
mxmap(1), GPSMan - 2006 May 7 GPSTRANS(1)