1GPSSUBFRAME(1)                GPSD Documentation                GPSSUBFRAME(1)
2
3
4

NAME

6       gpssubframe - tool to dump subframe sentences from gpsd
7

SYNOPSIS

9       gpssubframe [OPTIONS] [server[:port[:device]]]
10
11       gpssubframe -h
12
13       gpssubframe -V
14

DESCRIPTION

16       gpssubframe is a tool to connect to gpsd and dump decoded subframe data
17       to stdout. This is only useful if your GNSS receiver can output GPS
18       subframe messages, and is configured to do so. A working knowledge of
19       IS-GPS-200 is also required. Keep your copy close at hand.
20
21       gpssubframe does not require root privileges, but will run fine as
22       root. It can be run concurrently with other tools connecting to the
23       local gpsd without causing problems.
24
25       The program will accumulate subframe messages and output them by GPS
26       satellite number on exit. By default the program never exits unless the
27       user selects the number of seconds to run or number of messages to
28       capture.
29
30       By default gpssubframe connects to a gpsd running on the local host.
31       Optionally a host, TCP/IP port number and remote device can be given.
32

OPTIONS

34       -?, -h, --help
35           -Print a usage message and exit.
36
37       -c COUNT, --count COUNT
38           Exit after COUNT subframe messages.
39
40       -D DEBUG, --debug DEBUG
41           Set level of debug. Must be integer. Default 0.
42
43       --desc
44           Print long descriptions.
45
46       --device DEVICE
47           Connect to device DEVICE on gpsd host.
48
49       -D LVL, --debug LVL
50           Set debug level to LVL.
51
52       --file FILE
53           Read gpsd JSON from FILE instead of from gpsd..
54
55       --host HOST
56           Connect to gpsd on host HOST.
57
58       --load LOADFILE
59           Load saved JSON Subframe, TPV, and RAW data trom LOADFILE.
60
61       -n COUNT, --count COUNT
62           Count of messages to parse. 0 to disable.
63
64       --port PORT
65           Connect to gpsd on port PORT.
66
67       --progress
68           Print progress reports as messages are received.
69
70       --satpos
71           Compute GPS satellite positions before exit. If --time is given,
72           the positions will be calculated at the time. Otherwise if a RAW
73           message was received, the measurement time in that message will be
74           used. The last resort is to use the time from the last TPV message
75           is used.
76
77       --save SAVEFILE
78           Save decoded Subframe data in SAVEFILE as JSON. If present, the
79           last TPV and RAW JSON records will also be saved.
80
81       --test
82           Run --satpos selftest code.
83
84       --time SEC
85           Compute satellite position at time SEC in POSIX seconds.
86
87       -V, --version
88           Print the program version, then exit.
89
90       -x SEC, --seconds SEC
91           Seconds of messages to parse. 0 to disable.
92

ARGUMENTS

94       By default, clients collect data from the local gpsd daemon running on
95       localhost, using the default GPSD port 2947. The optional argument to
96       any client may override this behavior: [server[:port[:device]]]
97
98       For further explanation, and examples, see the ARGUMENTS section in the
99       gps(1) man page
100

EXAMPLES

102       First configure a u-blox 9-series to output subframe messages. Then
103       have gpssubframe gather one complete set of subframes, then print the
104       data organized by GPS satellite number. Be sure to replace -P 22 with
105       the correct protocol version for your receiver. Then calculate and
106       print the known satellite positions as well as the azimuth, elevation,
107       and range from the current position:
108
109           ubxtool -P 22 -e SFRBX
110           gpssubframe -x 750 --satpos
111
112       If staring at a blank screen for 12.5 minutes is too stressful, then
113       enable progress messages:
114
115           gpssubframe -x 750 --satpos --progress
116

RETURN VALUES

118       0
119           on success.
120
121       1
122           on failure
123

SEE ALSO

125       gpsd(8), gps(1), gpsprof(1), gpsfake(1).
126
127       IS-GPS-200 "NAVSTAR GPS Space Segment/Navigation User Segment
128       Interfaces"
129

RESOURCES

131       Project web site: https://gpsd.io/
132

COPYING

134       This file is Copyright 2020 by the GPSD project
135       SPDX-License-Identifier: BSD-2-clause
136

AUTHOR

138       Gary E. Miller
139
140
141
142GPSD Version 3.25                 2023-01-10                    GPSSUBFRAME(1)
Impressum