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

NAME

6       gpssubframe - tool to dump subframe sentences from gpsd
7

SYNOPSIS

9       gpssubframe [-?] [--count COUNT] [--debug LVL] [--desc]
10                   [--device DEVICE] [--file FILE] [--help] [--host HOST]
11                   [--load FILE] [--port PORT] [--progress] [--satpos]
12                   [--save FILE] [--seconds SECONDS] [--test] [--time SECONDS]
13                   [--version] [-D LVL] [-f FILE] [-h] [-n COUNT] [-V]
14                   [-x SECONDS] [server [:port [:device]]]
15

DESCRIPTION

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

OPTIONS

35       -?, -h, --help
36           -Print a usage message and exit.
37
38       -c COUNT, --count COUNT
39           Exit after COUNT subframe messages.
40
41       --device DEVICE
42           Connect to device DEVICE on gpsd host.
43
44       -D LVL, --debug LVL
45           Set debug level to LVL.
46
47       --file FILE
48           Read JSON from FILE instead of from gpsd..
49
50       --host HOST
51           Connect to gpsd on host HOST.
52
53       --port PORT
54           Connect to gpsd on port PORT.
55
56       --progress
57           Print progress reports as messages are received.
58
59       --satpos
60           Compute GPS satellite positions before exit.
61
62       --time SEC
63           Compute satellite position at time SEC in POSIX seconds.
64
65       --test
66           Run --satpos selftest code.
67
68       -V, --version
69           Print the program version, then exit.
70
71       -x SEC, --seconds SEC
72           Seconds of messages to parse. 0 to disable.
73

EXAMPLES

75       First connfigure a u-blox 9-series to output subframe messages. Then
76       have gpssubframe gather one complete set of subframes, then print the
77       data organized by GPS satellite number. Then calculate and print the
78       known satellite positions as well as the azimuth, elevation, and range
79       from the current position:
80
81           ubxtool -P 22 -e SFRBX
82           gpssubframe -x 750 --satpos
83
84
85       If staring at a blank screen for 12.5 minutes is too stressful, then
86       enable progress messages:
87
88           gpssubframe -x 750 --satpos --progress
89
90
91

SEE ALSO

93       gpsd(8), gps(1), gpsprof(1), gpsfake(1), gpsctl(1), gpscat(1).
94
95       IS-GPS-200 "NAVSTAR GPS Space Segment/Navigation User Segment
96       Interfaces"
97

AUTHOR

99       Gary E. Miller <gem@rellim.com>.
100
101
102
103The GPSD Project                6 December 2020                 GPSSUBFRAME(1)
Impressum