File: gpstrans.1

package info (click to toggle)
gpstrans 0.41-4
  • links: PTS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 756 kB
  • ctags: 1,253
  • sloc: ansic: 6,195; makefile: 153
file content (205 lines) | stat: -rw-r--r-- 6,243 bytes parent folder | download | duplicates (7)
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