1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205
|
.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
<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>.
.SH "SEE ALSO"
.BR mxmap (1),
.BR GPSMan
|