1GPSSUBFRAME(1) GPSD Documentation GPSSUBFRAME(1)
2
6 gpssubframe - tool to dump subframe sentences from gpsd
7
9 gpssubframe [OPTIONS] [server[:port[:device]]]
10 gpssubframe -h
12 gpssubframe -V
14
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 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 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 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
34 -?, -h, --help
35 -Print a usage message and exit.
36 -c COUNT, --count COUNT
38 Exit after COUNT subframe messages.
39 -D DEBUG, --debug DEBUG
41 Set level of debug. Must be integer. Default 0.
42 --desc
44 Print long descriptions.
45 --device DEVICE
47 Connect to device DEVICE on gpsd host.
48 -D LVL, --debug LVL
50 Set debug level to LVL.
51 --file FILE
53 Read gpsd JSON from FILE instead of from gpsd..
54 --host HOST
56 Connect to gpsd on host HOST.
57 --load LOADFILE
59 Load saved JSON Subframe, TPV, and RAW data trom LOADFILE.
60 -n COUNT, --count COUNT
62 Count of messages to parse. 0 to disable.
63 --port PORT
65 Connect to gpsd on port PORT.
66 --progress
68 Print progress reports as messages are received.
69 --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 --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 --test
82 Run --satpos selftest code.
83 --time SEC
85 Compute satellite position at time SEC in POSIX seconds.
86 -V, --version
88 Print the program version, then exit.
89 -x SEC, --seconds SEC
91 Seconds of messages to parse. 0 to disable.
92
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 For further explanation, and examples, see the ARGUMENTS section in the
99 gps(1) man page
100
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 ubxtool -P 22 -e SFRBX
110 gpssubframe -x 750 --satpos
111 If staring at a blank screen for 12.5 minutes is too stressful, then
113 enable progress messages:
114 gpssubframe -x 750 --satpos --progress
116
118 0
119 on success.
120 1
122 on failure
123
125 gpsd(8), gps(1), gpsprof(1), gpsfake(1).
126 IS-GPS-200 "NAVSTAR GPS Space Segment/Navigation User Segment
128 Interfaces"
129
131 Project web site: https://gpsd.io/
132
134 This file is Copyright 2020 by the GPSD project
135 SPDX-License-Identifier: BSD-2-clause
136
138 Gary E. Miller
139GPSD Version 3.25 2023-01-10 GPSSUBFRAME(1)