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
|
.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "GPSCTL" 1 "" "" ""
.SH NAME
gpsctl \- control the modes of a GPS
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 7
\fBgpsctl\fR [\-h] [\fB\-b\fR | \fB\-n\fR] [\-f] [\-l] [\-s\ \fIspeed\fR] [\-t\ \fIdevicetype\fR] [\-D\ \fIdebuglevel\fR] [\-V] [\fIserial\-port\fR]
.ad
.hy
.SH "DESCRIPTION"
.PP
gpsctl can switch a dual\-mode GPS between NMEA and vendor\-binary modes\&. It can also be used to set the device baudrate\&. Note: Not all devices have these capabilities\&.
.PP
If you have only one GPS attached to your machine, and gpsd is running, it is not necessary to specify the device; gpsctl does its work through gpsd, which will locate it for you\&.
.PP
When gpsd is not running, the device specification is required, and you will almost certainly need to be running as root in order to have write access to the device\&.
.PP
The program accepts the following options:
.TP
\-b
Put GPS into binary mode\&. After the GPS resets itself autobaud to the new speed\&.
.TP
\-n
Put GPS into NMEA mode\&. After the GPS resets itself autobaud to its new speed\&.
.TP
\-f
Force low\-level access (not through the daemon)\&.
.TP
\-l
List the known device types and exit\&.\&.
.TP
\-s
Set the baud rate at which the GPS emits packets\&.
.TP
\-t
Force the device type\&.
.TP
\-h
Display program usage and exit\&.
.TP
\-D
Set level of debug messages\&.
.TP
\-V
Display program version and exit\&.
.PP
The argument of the forcing option\&. \fB\-t\fR, should be a string which should be contained in exactly one of the known driver names; for a list, do \fBgpsctl \-l\fR\&.
.PP
Forcing the device type behaves somewhat differently depending on whether this tool, is going through the daemon or not\&. In high\-level mode, if the device that daemon selects for you doesn't match the driver you specified, gpsctl exits with a warning\&. (This may be useful in scripts\&.)
.PP
In low\-level mode, if the device identifies as a Generic NMEA, use the selected driver instead\&. This will be useful if you have a GPS device of known type that is in NMEA mode and not responding to probes\&. (This option was originally implemented for talking to SiRFStar I chips, which don't respond to the normal SiRF ID probe\&.)
.PP
If no options are given, the program will display a message identifying the GPS type of the selected device and exit\&.
.SH "SEE ALSO"
.PP
\fBgpsd\fR(8), \fBgps\fR(1), \fBlibgps\fR(3), \fBlibgpsd\fR(3), \fBgpsprof\fR(1), \fBgpsfake\fR(1)\&.
.SH "AUTHOR"
.PP
Eric S\&. Raymond <esr@thyrsus\&.com>\&. There is a project page for gpsd here: \fIhttp://gpsd.berlios.de/\fR\&.
|
