1GPSCTL(1)                                                            GPSCTL(1)
2
3
4

NAME

6       gpsctl - control the modes of a GPS
7

SYNOPSIS

9       gpsctl [-h] [-b | -n] [-f] [-l] [-s speed] [-t devicetype]
10              [-D debuglevel] [-V] [serial-port]
11
12

DESCRIPTION

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

SEE ALSO

85        gpsd(8), gps(1), libgps(3), libgpsd(3), gpsprof(1), gpsfake(1).
86
87

AUTHOR

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)
Impressum