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

NAME

6       gps2udp - feed the take from gpsd to one or more aggregation sites
7

SYNOPSIS

9       gps2udp [--ais] [--count COUNT] [--daemonize] [--debug LVL] [--help]
10               [--json] [--nmea] [--tpv] [--udp HOST:PORT] [-a] [-c COUNT]
11               [-d LVL] [-h] [-j] [-n] [-t] [-u HOST:PORT] [-V] [-V] [server
12               [:port [:device]]]
13

DESCRIPTION

15       gps2udp is a tool to connect to gpsd and output the received sentences
16       to one or many UDP host:port destinations. This makes the program
17       useful for feeding AIS information from gpsd to aishub, marinetraffic,
18       shipfinder,...
19
20       gps2udp does not require root privileges, and can be run concurrently
21       with other tools connecting to the local gpsd without causing problems.
22
23       The output will consist of one or both of NMEA (-n option) or JSON (-j
24       option) gpsd sentences. The output is sent to one or many destinations
25       host through a UDP network socket (-u HOST:PORT options) .
26
27       Optionally a server, TCP/IP port number and remote device can be given.
28       If omitted, gps2udp connects to localhost on the default port (2947)
29       and watches all devices opened by gpsd.
30
31       gps2udp may be run as a daemon (-b option).
32
33       gps2udp is designed to run smoothly in background; it reconnects
34       automatically to gpsd whenever it is restarted. For debugging
35       purporses, there is an option to exit gracefully after a given count of
36       packets (-c option).
37

OPTIONS

39       -?, -h, --help
40           -Print a usage message and exit.
41
42       -a, --ais
43           Send only AIS messages.
44
45       -b, --daemon
46           Causes gps2udp to run as a daemon.
47
48       -c COUNT, --count COUNT
49           Exit after COUNT sentences are sent.
50
51       -d LVL, --debug LVL
52           Set debug level to LVL. LVL = 0 prints nothing. LVL =1 prints sent
53           packet on stdout. LVL =2 prints ignored packets.
54
55       -j, --json
56           Causes JSON sentences to be output.
57
58       -n, --nmea
59           Causes NMEA sentences to be output.
60
61       -t, --tpv
62           Only output TPV sentences. Implies --json.
63
64       -u HOST:PORT, --udp HOST:PORT
65           UDP destination for output sentenses (up to five destinations).
66
67       -v, -V, --version
68           Prints the program version, then exit. -v is deprecated December
69           2020.
70

EXAMPLE

72       With a running gpsd accessible on the network
73
74       gps2udp -d 1 -n -u data.aishub.net:2222 will collect data from
75       localhost:gpsd display them on stdout and send a copy to test aishub in
76       NMEA format.
77
78       gps2udp -a -n -b -u data.aishub.net:2222 -u 5.9.207.224:5321 -u
79       109.200.19.151:4001 fridu.net:2947 will collect data from a remote gpsd
80       located on fridu.net host, will filter AIS messages and send them to 3
81       destination (aishub, marinetraffic, shipfinder) in NMEA format, command
82       is running in background mode
83

SEE ALSO

85       gpsd(8), gps(1), libgps(3), libgpsmm(3), gpsprof(1), gpsfake(1),
86       gpsctl(1), gpscat(1).  gpsmon(1).
87

AUTHOR

89       Fulup Ar Foll <fulup@sinagot.net>.
90
91
92
93The GPSD Project                6 December 2020                     GPS2UDP(1)
Impressum