Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gpscat(1) [debian man page]

GPSCAT(1)							GPSD Documentation							 GPSCAT(1)

NAME
gpscat - dump the output from a GPS SYNOPSIS
gpscat [-s speed] [-p] [-t] [-D debuglevel] serial-port DESCRIPTION
gpscat is a simple program for logging and packetizing GPS data streams. It takes input from a specified file or serial device (presumed to have a GPS attached) and reports to standard output. The program runs until end of input or it is interrupted by ^C or other means. It does not terminate on a bad backet; this is intentional. In raw mode (the default) gpscat simply dumps its input to standard output. Nonprintable characters other than ASCII whitespace are rendered as hexadecimal string escapes. In packetizing mode, gpscat uses the same code as gpsd(8)'s packet sniffer to break the input into packets. Packets are reported one per line; line breaks in the packets themselves are escaped. This program is useful as a sanity checker when examining a new device. It can be used as a primitive NMEA logger, but beware that (a) interrupting it likely to cut off output in mid-sentence, and (b) to avoid displaying incomplete NMEA sentences right up next to shell prompts that often contain a $, raw mode always emits an extra final linefeed. Also, be aware that packetizing mode will produce useless results -- probably consuming the entirety of input and appearing to hang -- if it is fed data that is not a sequence of packets of one of the known types. The program accepts the following options: -p Invoke packetizer mode. -s Set the port's baud rate (and optionally its parity and stop bits) before reading. Argument should begin with one of the normal integer baud rates (300, 1200, 4800, 9600, 19200, 38400, etc.). It may be followed by an optional suffix [NOE][12] to set parity (None, Even, Odd) and stop bits (1 or 2). -t Invoke packetizer mode, with the packet type and length (in parentheses) reported before a colon and space on each line. -D In packetizer mode, enable progress messages from the packet getter. Probably only of interest to developers testing packet getter changes. -h Display program usage and exit. Specifying -s 4800N1 is frequently helpful with unknown devices. SEE ALSO
gpsd(8), gps(1), libgps(3), libgpsd(3), gpsfake(1). gpsprof(1), gpsctl(1), gpsdctl(8), gpsmon(1). AUTHOR
Eric S. Raymond esr@thyrsus.com. The GPSD Project 16 Nov 2006 GPSCAT(1)

Check Out this Related Man Page

GPSDECODE(1)							GPSD Documentation						      GPSDECODE(1)

NAME
gpsdecode - decode GPS, RTCM or AIS streams into a readable format SYNOPSIS
gpsdecode [-c] [-d] [-e] [-j] [-t typelist] [-u] [-v] [-D debuglevel] [-V] DESCRIPTION
This tool is a batch-mode decoder for NMEA and various binary packet formats associated with GPS, AIS, and differential-correction services. It produces a JSON dump on standard output from binary on standard input. The JSON is the same format documented in gpsd(8); this tool uses the same decoding logic as gpsd, but with a simpler interface intended for batch processing of data files. All sensor-input formats known to the GPSD project can be decoded by this tool. These include: NMEA, AIVDM (the NMEA-derived sentence format used by AIS, the marine Automatic Identification System), RTCM2, and all supported GPS binary formats (notably including SiRF). See gpsd(8) for applicable standards and known limitations of the decoding logic. You can use this tool with nc(1) to examine AIS feeds from AIS pooling services, RTCM feeds from RTCM receivers or NTRIP broadcasters. OPTIONS
The -d option tells the program to decode packets presented on standard input to standard output. This is the default behavior. The -j explicitly sets the output dump format to JSON (the default behavior). The -e option option tells the program to encode JSON on standard input to JSON on standard output. This option is only useful for regression-testing of the JSON dumping and parsing code. The -t accepts a comma-separated list of numeric types. Packets with a numeric AIS, RTCM2, or RTCM3 type are passed through and output only if they match a type in the list. Packets of other kinds (in particular GPS packets) are passed through unconditionally. The -u suppresses scaling of AIS data to float quantities and text expansion of numeric codes. A dump with this option is lossless. The -v enables dumping of textual packets to output as they are received on input, immediately preceding corresponding output. The -c sets the AIS dump format to separate fields with an ASCII pipe symbol. Fields are dumped in the order they occur in the AIS packet. Numerics are not scaled (-u is forced). Strings are unpacked from six-bit to full ASCII The -V option directs the program to emit its version number, then exit. The -D option sets a debug verbosity level. It is mainly of interest to developers. AIS DSV FORMAT
With the -c option, dump lines are values of AIS payload fields, pipe-separated, in the order that they occur in the payload. Spans of fields expressing a date are emitted as an ISO8601 timestamp (look for colons and the trailing Z indicating Zulu/UTC time), and the 19-bit group of TDMA status fields found at the end of message types 1-4 are are dumped as a single unsigned integer (in hex preceded by "0x"). Unused regional-authority fields are also dumped (in hex preceded by "0x"). Variable-length binary fields are dumped as an integer bit length, followed by a colon, followed by a hex dump. SEE ALSO
gpsd(8), gpsctl(1), gpsdctl(8), gps(1), libgps(3), libgpsd(3), gpsprof(1), gpsfake(1), AUTHOR
Eric S. Raymond esr@thyrsus.com. The GPSD Project 13 Jul 2005 GPSDECODE(1)

Featured Tech Videos