1GPSCAT(1)                                                            GPSCAT(1)
2
3
4

NAME

6       gpscat - dump the output from a GPS
7

SYNOPSIS

9       gpscat [-s speed] [-p] [-t] serial-port
10
11

DESCRIPTION

13       gpscat  is  a  simple  program  for  logging  and  packetizing GPS data
14       streams. It takes input from a specified file or  serial  device  (pre‐
15       sumed  to have a GPS attached) and reports to standard output. The pro‐
16       gram runs until end of input or ot is interrupted by ^C or other means.
17
18
19       In raw mode (the default) gpscat simply dumps  its  input  to  standard
20       output.  Nonprintable characters are rendered as hexadecimal string es‐
21       capes, except for CR followed by LF or LF preceded by CR.
22
23
24       In packetizing mode, gpscat uses the  same  code  as  gpsd(8)'s  packet
25       sniffer  to  break the input into packets. Packets are reported one per
26       line; line breaks in the packets themselves are escaped.
27
28
29       This program is useful as a sanity checker when examining a new device.
30       It  can  be used as a primitive NMEA logger, but beware that (a) inter‐
31       rupting it likely to cut off output in mid-sentence, and (b)  to  avoid
32       displaying  incomplete  NMEA  sentences  right up next to shell prompts
33       that often contain a $, raw mode always emits an extra final linefeed.
34
35
36       Also, be aware that packetizing mode will produce  useless  results  --
37       probably consuming the entirety of input and appearing to hang -- if it
38       is fed data that is not a sequence of  packets  of  one  of  the  known
39       types.
40
41
42       The program accepts the following options:
43
44
45       -p     Invoke packetizer mode.
46
47
48       -s     Set  the  port's  baud  rate (and optionally its parity and stop
49              bits) before reading. Argument should begin with one of the nor‐
50              mal  integer  baud  rates  (300, 1200, 4800, 9600, 19200, 38400,
51              etc.). It may be followed by an optional suffix [NOE][12] to set
52              parity (None, Even, Odd) and stop bits (1 or 2).
53
54
55       -t     Invoke  packetizer  mode, with the packet type reported before a
56              colon on each line.
57
58
59       -h     Display program usage and exit.
60
61
62       -V     Display program version and exit.
63
64
65       Specifying -s 4800N1 is frequently helpful with unknown devices.
66
67

SEE ALSO

69        gpsd(8), gps(1), libgps(3), libgpsd(3),  gpsfake(1).  gpsprof(1),  gp‐
70       sctl(1), sirfmon(1).
71
72

AUTHOR

74       Eric  S.  Raymond  <esr@thyrsus.com>.  There is a project page for gpsd
75       here: http://gpsd.berlios.de/.
76
77
78
79
80                                                                     GPSCAT(1)
Impressum