1GPS(1) GPS(1)
2
6 gps, xgps, xgpsspeed, cgps, cgpxlogger - test clients for gpsd
7
9 xgps [X-options] [-h] [-j] [-V] [-speedunits {mph | kph | knots}]
10 [-altunits {feet | meters}] [-l [d | m | s]] [-s smoothing]
11 [server [:port [:device]]]
12 xgpsspeed [-rv] [X-options] [-h] [-V] [-nc X-color]
14 [-speedunits {mph | kph | knots}] [server [:port [:device]]]
15 cgps [-h] [-j] [-V] [-speedunits {mph | kph | knots}]
17 [-altunits {feet | meters}] [-l [d | m | s]] [server [:port
18 [:device]]]
19 gpxlogger [logfile]
21 cgpxlogger [-s gpsd-server] [-p gpsd-port] [-i poll-interval] [-h]
23
26 xgps
27 xgps is a simple test client for gpsd with an X interface. It displays
28 current GPS position/time/velocity information and (for GPSes that sup‐
29 port the feature) the locations of accessible satellites.
30 In the sky view, satellites are color-coded to indicate quality of sig‐
33 nal; consult the data display to the left for exact figures in dB. Dia‐
34 mond icons indicate WAAS/EGNOS satellites, circles indicate ordinary
35 GPS satellites. Filled icons were used in the last fix, outline icons
36 were not.
37 xgps accepts an -h option as for gpsd, or a -V option to dump the pack‐
40 age version and exit.
41 An optional argument may specify a server to get data from; a
44 colon-separated suffix is taken as a port number. If there is a second
45 colon-separated suffix, that is taken as a device name to be handed to
46 the daemon in an F= command.
47 The -speedunits option can be used to set the speed units for display;
50 follow the keyword with knots for nautical miles per hour, kph for
51 kilometres per hour, or mph for miles per hour. The default is miles
52 per hour. This option can also be set as the X resource 'speedunits'.
53 The -altunits option can be used to set the altitude units for display;
56 follow the keyword with 'meters' or 'feet'. The default is feet. This
57 option can also be set as the X resource 'altunits'.
58 The -j option tells the daemon to hold fix data across cycles, elimi‐
61 nating jitter from NMEA devices that emit several partial reports. The
62 downside is that with this switch on the client will occasionally re‐
63 port stale or invalid data held over from a previous cycle. This option
64 is ineffective, and not needed, on SiRFs and most other non-NMEA GPSes.
65 The -l option sets the format of latitude and longitude reports. The
68 value 'd' produces decimal degrees and is the default. The value 'm'
69 produces degrees and decimal minutes. The value 's' produces degrees,
70 minutes, and decimal seconds.
71 There is a known bug in xgps; it assumes the default font size is no
74 more than 18 pixels. If this is not the case, the satellite data dis‐
75 play will show fewer than 12 satellites.
76 xgpsspeed
79 xgpsspeed is a speedometer that uses position information from the GPS.
80 It accepts an -h option and optional argument as for gps, or a -V op‐
81 tion to dump the package version and exit. Additionally, it accepts -rv
82 (reverse video) and -nc (needle color) options.
83 The -speedunits option can be used to set the speed units for display;
86 follow the keyword with knots for nautical miles per hour, kph for
87 kilometres per hour, or mph for miles per hour. The default is miles
88 per hour. This option can also be set as the X resource 'speedunits'.
89 cgps
92 cgps is a client resembling xgps, but without the pictorial satellite
93 display and able to run on a serial terminal or terminal emulator.
94 The -s option prevents cgps from printing the raw data. This display
97 can also be toggled with the s command.
98 The -j option is as described for xgps above.
101 Rather than use X resources to determine which units to use, cgps looks
104 at variables in its environment. Here are the variables and values it
105 checks:
106 GPSD_UNITS one of:
109 imperial = miles/feet
110 nautical = knots/feet
111 metric = km/meters
112 LC_MEASUREMENT en_US = miles/feet
113 C = miles/feet
114 POSIX = miles/feet
115 [other] = km/meters
116 LANG en_US = miles/feet
117 C = miles/feet
118 POSIX = miles/feet
119 [other] = km/meters
120 cgps terminates when you send it a SIGHUP or SIGINT; given default ter‐
123 minal settings this will happen when you type Ctl-C at it. It will also
124 terminate on 'q'
125 The 'j' command toggles whether or not fix data is cleared at start of
128 cycle; see the description of the -j of xgps (above) and gpsd(8) for
129 discussion.
130 cgpxlogger
133 This program connects to gpsd, polls for location, and logs each fix to
134 standard output in GPX (XML) format.
135 The -s and -p options can be used to specify a server and port to
138 query.
139 The -i option sets the poll interval at which the logger will collect
142 samples.
143 The -j option is as described for xgps above.
146 The -h option causes the program to emit a summary of its options and
149 then exit.
150 The program also writes start and end messages to syslog.
153 gpxlogger
156 This program listens to DBUS broadcasts from gpsd (org.gpsd.fix) and
157 logs each fix to standard output as they arrive in an XML format.
158 The output may be composed of multiple tracks. A new track is created
161 if there's no fix for 5 seconds.
162 The program also writes start and end messages to syslog.
165
168 gpsd(8), libgps(3), libgpsd(3), gpsfake(1), gpsctl(1), gpscat(1), gp‐
169 sprof(1).
170
173 Remco Treffcorn, Derrick Brashear, Russ Nelson & Eric S. Raymond(xgps).
174 Jeff Francis (cgps). Amaury Jacquot <sxpert@esitcom.org> & Petter Rein‐
175 holdtsen <pere@hungry.com> (gpxlogger). Chris Kuethe
176 <chris.kuethe@gmail.com> (cgpxlogger).
177 This manual page by Eric S. Raymond <esr@thyrsus.com>. There is a
180 project page, with xgps screenshots, at berlios.de:
181 http://gpsd.berlios.de/.
182 GPS(1)