1GPSCTL(1) GPSCTL(1)
2
3
4
6 gpsctl - control the modes of a GPS
7
9 gpsctl [-h] [-b | -n] [-f] [-l] [-s speed] [-t devicetype]
10 [-D debuglevel] [-V] [serial-port]
11
12
14 gpsctl can switch a dual-mode GPS between NMEA and vendor-binary modes.
15 It can also be used to set the device baudrate. Note: Not all devices
16 have these capabilities.
17
18
19 If you have only one GPS attached to your machine, and gpsd is running,
20 it is not necessary to specify the device; gpsctl does its work through
21 gpsd, which will locate it for you.
22
23
24 When gpsd is not running, the device specification is required, and you
25 will almost certainly need to be running as root in order to have write
26 access to the device.
27
28
29 The program accepts the following options:
30
31
32 -b Put GPS into binary mode. After the GPS resets itself autobaud
33 to the new speed.
34
35
36 -n Put GPS into NMEA mode. After the GPS resets itself autobaud to
37 its new speed.
38
39
40 -f Force low-level access (not through the daemon).
41
42
43 -l List the known device types and exit..
44
45
46 -s Set the baud rate at which the GPS emits packets.
47
48
49 -t Force the device type.
50
51
52 -h Display program usage and exit.
53
54
55 -D Set level of debug messages.
56
57
58 -V Display program version and exit.
59
60
61 The argument of the forcing option. -t, should be a string which should
62 be contained in exactly one of the known driver names; for a list, do
63 gpsctl -l.
64
65
66 Forcing the device type behaves somewhat differently depending on
67 whether this tool, is going through the daemon or not. In high-level
68 mode, if the device that daemon selects for you doesn't match the driv‐
69 er you specified, gpsctl exits with a warning. (This may be useful in
70 scripts.)
71
72
73 In low-level mode, if the device identifies as a Generic NMEA, use the
74 selected driver instead. This will be useful if you have a GPS device
75 of known type that is in NMEA mode and not responding to probes. (This
76 option was originally implemented for talking to SiRFStar I chips,
77 which don't respond to the normal SiRF ID probe.)
78
79
80 If no options are given, the program will display a message identifying
81 the GPS type of the selected device and exit.
82
83
85 gpsd(8), gps(1), libgps(3), libgpsd(3), gpsprof(1), gpsfake(1).
86
87
89 Eric S. Raymond <esr@thyrsus.com>. There is a project page for gpsd
90 here: http://gpsd.berlios.de/.
91
92
93
94
95 GPSCTL(1)