File: gpstrans.1

package info (click to toggle)
gpstrans 0.34-2
  • links: PTS
  • area: main
  • in suites: slink
  • size: 476 kB
  • ctags: 348
  • sloc: ansic: 3,463; makefile: 97
file content (129 lines) | stat: -rw-r--r-- 4,158 bytes parent folder | download | duplicates (2)
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)