.TH "GPSTRANS" "1" "2006 May 7" "-" "GPS Utility" .SH "NAME" gpstrans \- communicate with Garmin GPS receiver .SH "SYNOPOSIS" .BR gpstrans " [ " .IR options " ] [ " "file " ] .SH "DESCRIPTION" .PP \fBgpstrans\fP allows the user with a Garmin GPS receiver to upload and download waypoints, routes, almanacs (satellite orbital elements) and trackroutes. If \fIfile\fP is not supplied, data will be read from stdin (\fB\-u\fP\fIx\fP switch) or written to stdout (\fB\-d\fP\fIx\fP switch). .SH "OPTIONS" .TP .BI \-p "port" set serial I/O device .TP .B \-s set datum, format, offset, and device interactively, and save them in \fI$HOME/.gpstrans\fP. .TP .B \-i identify connected GPS .TP .B \-o turn off GPS device .TP .B \-t get time from GPS .TP .B \-ts get time from GPS and set system time on host .TP .BI \-d x download data indicated by \fIx\fP: \fBr\fP=route, \fBt\fP=track, \fBw\fP=waypoint, \fBa\fP=almanac .TP .B \-m With \fB\-dt\fP, downloads track data in the format which can be displayed by Mayko mXmap(1). With \fB\-dr\fP or \fB\-ur\fP, downloads or uploads route data in a format compatible with Mayko mXmap. .TP .BI \-u x upload data indicated by \fIx\fP: \fBr\fP=route, \fBt\fP=track, \fBw\fP=waypoint, \fBa\fP=almanac .TP .B \-v print program version. .TP .BI \-\-verbose Increase verbosity. .TP .BI \-\-debug Add debug printouts. .TP .BI \-\-help Print help text. .SH "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. .nf .sp 1 ### ##### o o o # # # o # o o o o o o o o o o o # o o o o o .fi Connect the Garmin cable as follows: .nf .sp 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) .fi 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: .nf .sp _____ _____,\-\-\-\-\-, 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.) .fi 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: .BR _____,\-\-\-\-\-, 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, \fBgpstrans\fP won't work. After finishing the test, be sure to set your GPS receiver to GRMN/GRMN. .SH "ENVIRONMENT" .TP .B GPSDEV Serial I/O device (overrides contents of \fI$HOME/.gpstrans\fP, and is overridden by \fB\-p\fP switch). .SH "FILES" .TP .I $HOME/.gpstrans Has user preferences for datum, format, offset, and serial I/O device (see \fB\-s\fP switch, above). .SH "AUTHOR" GPStrans is Copyright 1995 by Carsten Tschach . The datum translation routines are based on the program MacGPS from John F. Waers . Mayko mXmap output format by Matthias Kattanek . German Grid by Andreas Lange . etrex support by Joao Seabra CT2GNL \- . Other Garmin formats added by Jim Van Zandt . .SH "SEE ALSO" .BR mxmap (1), .BR GPSMan