gps.1

来自「gpsd, a popular GPS daemon.」· 1 代码 · 共 175 行

.\"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 "GPS" 1 "" "" ""
.SH NAME
gps, xgps, xgpsspeed, cgps, cgpxlogger \- test clients for gpsd
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 5
\fBxgps\fR [\fIX\-options\fR] [\-h] [\-j] [\-V] [\-speedunits\ {\fBmph\fR\ |\ \fBkph\fR\ |\ \fBknots\fR}] [\-altunits\ {\fBfeet\fR\ |\ \fBmeters\fR}] [\-l\ [\fBd\fR\ |\ \fBm\fR\ |\ \fBs\fR]] [\-s\ \fIsmoothing\fR] [\fIserver\fR [\fI:port\fR [\fI:device\fR]]]
.ad
.hy
.ad l
.hy 0
.HP 10
\fBxgpsspeed\fR [\-rv] [\fIX\-options\fR] [\-h] [\-V] [\-nc\ \fIX\-color\fR] [\-speedunits\ {\fBmph\fR\ |\ \fBkph\fR\ |\ \fBknots\fR}] [\fIserver\fR [\fI:port\fR [\fI:device\fR]]]
.ad
.hy
.ad l
.hy 0
.HP 5
\fBcgps\fR [\-h] [\-j] [\-V] [\-speedunits\ {\fBmph\fR\ |\ \fBkph\fR\ |\ \fBknots\fR}] [\-altunits\ {\fBfeet\fR\ |\ \fBmeters\fR}] [\-l\ [\fBd\fR\ |\ \fBm\fR\ |\ \fBs\fR]] [\fIserver\fR [\fI:port\fR [\fI:device\fR]]]
.ad
.hy
.ad l
.hy 0
.HP 10
\fBgpxlogger\fR [\fIlogfile\fR]
.ad
.hy
.ad l
.hy 0
.HP 11
\fBcgpxlogger\fR [\-s\ \fIgpsd\-server\fR] [\-p\ \fIgpsd\-port\fR] [\-i\ \fIpoll\-interval\fR] [\-h]
.ad
.hy

.SH "DESCRIPTION"

.SS "xgps"

.PP
xgps is a simple test client for gpsd with an X interface\&. It displays current GPS position/time/velocity information and (for GPSes that support the feature) the locations of accessible satellites\&.

.PP
In the sky view, satellites are color\-coded to indicate quality of signal; consult the data display to the left for exact figures in dB\&. Diamond icons indicate WAAS/EGNOS satellites, circles indicate ordinary GPS satellites\&. Filled icons were used in the last fix, outline icons were not\&.

.PP
xgps accepts an \-h option as for gpsd, or a \-V option to dump the package version and exit\&.

.PP
An optional argument may specify a server to get data from; a colon\-separated suffix is taken as a port number\&. If there is a second colon\-separated suffix, that is taken as a device name to be handed to the daemon in an F= command\&.

.PP
The \fB\-speedunits\fR option can be used to set the speed units for display; follow the keyword with knots for nautical miles per hour, kph for kilometres per hour, or mph for miles per hour\&. The default is miles per hour\&. This option can also be set as the X resource 'speedunits'\&.

.PP
The \fB\-altunits\fR option can be used to set the altitude units for display; follow the keyword with 'meters' or 'feet'\&. The default is feet\&. This option can also be set as the X resource 'altunits'\&.

.PP
The \fB\-j\fR option tells the daemon to hold fix data across cycles, eliminating jitter from NMEA devices that emit several partial reports\&. The downside is that with this switch on the client will occasionally report stale or invalid data held over from a previous cycle\&. This option is ineffective, and not needed, on SiRFs and most other non\-NMEA GPSes\&.

.PP
The \fB\-l\fR option sets the format of latitude and longitude reports\&. The value 'd' produces decimal degrees and is the default\&. The value 'm' produces degrees and decimal minutes\&. The value 's' produces degrees, minutes, and decimal seconds\&.

.PP
There is a known bug in xgps; it assumes the default font size is no more than 18 pixels\&. If this is not the case, the satellite data display will show fewer than 12 satellites\&.

.SS "xgpsspeed"

.PP
xgpsspeed is a speedometer that uses position information from the GPS\&. It accepts an \-h option and optional argument as for gps, or a \-V option to dump the package version and exit\&. Additionally, it accepts \-rv (reverse video) and \-nc (needle color) options\&.

.PP
The \-speedunits option can be used to set the speed units for display; follow the keyword with knots for nautical miles per hour, kph for kilometres per hour, or mph for miles per hour\&. The default is miles per hour\&. This option can also be set as the X resource 'speedunits'\&.

.SS "cgps"

.PP
cgps is a client resembling xgps, but without the pictorial satellite display and able to run on a serial terminal or terminal emulator\&.

.PP
The \fB\-s\fR option prevents cgps from printing the raw data\&. This display can also be toggled with the s command\&.

.PP
The \fB\-j\fR option is as described for xgps above\&.

.PP
Rather than use X resources to determine which units to use, cgps looks at variables in its environment\&. Here are the variables and values it checks:

.IP

    GPSD_UNITS one of: 
              imperial   = miles/feet
              nautical   = knots/feet
              metric     = km/meters
    LC_MEASUREMENT
	      en_US      = miles/feet
              C          = miles/feet
              POSIX      = miles/feet
              [other]    = km/meters
    LANG
	      en_US      = miles/feet
              C          = miles/feet
              POSIX      = miles/feet
              [other]    = km/meters

.PP
cgps terminates when you send it a SIGHUP or SIGINT; given default terminal settings this will happen when you type Ctl\-C at it\&. It will also terminate on 'q'

.PP
The 'j' command toggles whether or not fix data is cleared at start of cycle; see the description of the \fB\-j\fR of xgps (above) and \fBgpsd\fR(8) for discussion\&.

.SS "cgpxlogger"

.PP
This program connects to gpsd, polls for location, and logs each fix to standard output in GPX (XML) format\&.

.PP
The \fB\-s\fR and \fB\-p\fR options can be used to specify a server and port to query\&.

.PP
The \fB\-i\fR option sets the poll interval at which the logger will collect samples\&.

.PP
The \fB\-j\fR option is as described for xgps above\&.

.PP
The \fB\-h\fR option causes the program to emit a summary of its options and then exit\&.

.PP
The program also writes start and end messages to syslog\&.

.SS "gpxlogger"

.PP
This program listens to DBUS broadcasts from gpsd (org\&.gpsd\&.fix) and logs each fix to standard output as they arrive in an XML format\&.

.PP
The output may be composed of multiple tracks\&. A new track is created if there's no fix for 5 seconds\&.

.PP
The program also writes start and end messages to syslog\&.

.SH "SEE ALSO"

.PP
 \fBgpsd\fR(8), \fBlibgps\fR(3), \fBlibgpsd\fR(3), \fBgpsfake\fR(1), \fBgpsctl\fR(1), \fBgpscat\fR(1), \fBgpsprof\fR(1)\&.

.SH "AUTHORS"

.PP
Remco Treffcorn, Derrick Brashear, Russ Nelson & Eric S\&. Raymond(xgps)\&. Jeff Francis (cgps)\&. Amaury Jacquot <sxpert@esitcom\&.org> & Petter Reinholdtsen <pere@hungry\&.com> (gpxlogger)\&. Chris Kuethe <chris\&.kuethe@gmail\&.com> (cgpxlogger)\&.

.PP
This manual page by Eric S\&. Raymond <esr@thyrsus\&.com>\&. There is a project page, with xgps screenshots, at berlios\&.de: \fIhttp://gpsd.berlios.de/\fR\&.