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
|
.TH GPSTRANS 1 "1998 August 15" "" \" -*- nroff -*-
.SH NAME
gpstrans \- communicate with Garmin GPS receiver
.SH SYNOPOSIS
.BR gpstrans " [ " options " ] [ "
.IR " 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
.B -v
print program version.
.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
.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
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>.
.SH SEE ALSO
.BR mXmap (1)
|