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

NAME

6       zerk - All purpose GREIS fitting
7

SYNOPSIS

9       zerk [-?] [-c command] [-d disable] [-e enable] [-f file/device] [-h]
10            [-O oaf] [-p preset] [-R rawfile] [-r] [-S setspeed] [-s speed]
11            [-V] [-v verbosity] [-W] [-w wait] [[server[:port[:device]]]]
12

DESCRIPTION

14       zerk is an all purpose GREIS fitting. If you do not have a Javad GPS
15       that speaks the GREIS protocol then you can stop reading now.
16
17       This tool operates with your Javad GPS at a very low level. To
18       understand zerk you must first be familiar with your Javad GPS and the
19       documentation for the GREIS protocol.  GREIS (GNSS Receiver External
20       Interface Specification) Guide[1].
21
22       zerk can decode common GREIS messages, poll the GPS status, enable and
23       disable GPS features, and send user generated commands to the GPS. It
24       can read GREIS messages from a file. It can read and write directly
25       through a serial device, or through a running gpsd instance.
26

OPTIONS

28       The program accepts the following options:
29
30       -c COMMAND
31           Send a text string to the GPS. Accepts one parameter, COMMAND, the
32           command string to send to the GPS. The string is sent verbatim,
33           except a newline is appended.
34
35       -d OPTION
36           Disable an option in the GPS. Accepts one parameter, OPTION, the
37           option to disable.  zerk will exit after the GPS acknowledges the
38           command, unless the -W is given.
39
40           4HZ
41               Disable basic GREIS messages at 4Hz. The messages are: [RT],
42               [UO], [GT], [PV], [SG], [DP], [SI], [EL], [AZ], [EC], [SS], and
43               [ET]
44
45           COMPASS
46               Disable use of the COMPASS (BeiDou) constellation.
47
48           CONS
49               Disable use of all constellations.
50
51           DEFMSG
52               Disable the default message set (/dev/msg) at 1Hz.
53
54           GALILEO
55               Disable use of the GALILEO constellation.
56
57           GLONASS
58               Disable use of the GLONASS constellation.
59
60           GPS
61               Disable use of the GPS constellation.
62
63           IPR
64               Disable all Integer Pseudo Range messages. These are [rx],
65               [rc], [r1], [r2], [r3], [r5], [rl].
66
67           IRNSS
68               Disable use of the IRNSS constellation.
69
70           NMEA
71               Disable basic NMEA 4.1e messages at 4Hz. The messages are GBS,
72               GGA, GSA, GST, GSV, RMC, VTG, and ZDA.
73
74           QZSS
75               Disable use of the QZSS constellation.
76
77           SBAS
78               Disable use of the SBAS constellation.
79
80           SNR
81               Disable all SNR messages, except [EC]. The messages disabled
82               are: [E1], [E2], [E3], [E5], [El].
83
84       -e OPTION
85           Enable an option in the GPS. Accepts one parameter, OPTION, the
86           option to enable.  zerk will exit after the GPS acknowledges the
87           command, unless the -W is given. -e accepts the same OPTIONs as -d,
88           except the action is to enable the option.
89
90       -f FILE
91           Connect to a file or device. Accepts one parameter, FILE, the file
92           or device to open. Files are opened read-only. Character devices
93           are opened red/write, unless the -r parameter is given.
94
95       -h
96           Makes zerk print a usage message and exit.
97
98       -O OAF
99           Load an Option Authorization File (OAF) into the GPS. Accepts one
100           parameter, OAF, command file to read. The OAF is just a special
101           case of a .jpo (GREIS command file). -O will send any valid .jpo
102           file to the GPS.
103
104       -p PRESET
105           Send a preset command the GPS. Accepts one parameter, PRESET, the
106           name of the command to send.  zerk will exit after the GPS
107           acknowledges the command, unless the -W is given.
108
109           COLDBOOT
110               Coldboot the GPS.
111
112           CONS
113               Poll the enabled constellations.
114
115           DM
116               Disable all periodic GREIS messages..
117
118           ID
119               Poll the receiver ID.
120
121           IPR
122               Poll all Integer Pseudo Range messages. These are [rx], [rc],
123               [r1], [r2], [r3], [r5], [rl].
124
125           OAF
126               Poll all OAF options.
127
128           RESET
129               Reset (reboot) the GPS.
130
131           SERIAL
132               Poll receiver serial number.
133
134           SNR
135               Poll all Signal to Noise Ratio (SNR) messages. [EC], [E1],
136               [E2], [E3], [E5], [El].
137
138           VENDOR
139               Poll GPS vendor.
140
141           VER
142               Poll GPS version.
143
144       -r
145           Read only. Do not send anything to the GPS.
146
147       -R RAW
148           Save all raw data from the GPS into the file RAW.
149
150       -S SPEED
151           Configure the GPS serial speed to SPEED bps.
152
153       -s SPEED
154           Set local serial port speed to SPEED bps. Default 115,200 bps.
155
156       -V
157           Print zerk version and exit.
158
159       -v VERBOSITY
160           Set verbosity level to VERBOSITY. Verbosity can be from 0 (very
161           quiet), to 4 (very noisy). Default 2.
162
163       -v VERBOSITY
164           Set verbosity level to VERBOSITY. Verbosity can be from 0 (very
165           quiet), 2 (decode messages), to 4 (very noisy). Default 1.
166
167       -W
168           Force waiting the entire wait time. No early exit for completion of
169           -d, -e or -p command.
170
171       -w WAIT
172           Wait for WAIT seconds before exiting. Will exit early on command
173           completion of -d, -e or -p command, unless -W is given. Default 2.0
174           second.
175
176       [server[:port[:device]]]
177           By default, zerk collects data from all compatible devices on
178           localhost, using the default GPSD port 2947. An optional argument
179           may specify a server to get data from. A colon-separated suffix is
180           taken as a port number. If there is a second colon-separated
181           suffix, that is taken as a specific device name to be watched.
182           Further details on the gps(1) man page.
183
184       -?
185           Makes zerk print a usage message and exit.
186

ENVIRONMENT

188       Options can be placed in the ZERKOPTS environment variable. ZERKOPTS is
189       processed before the CLI options.
190

EXAMPLES

192       Print current Javad serial portC of GPS connected to local running
193       gpsd::
194
195            zerk -c "print,/cur/term"
196
197       Decode raw log file:
198
199           zerk -r -f greis-binary.log -v 2
200
201       Change GPS port speed of device on /dev/ttyAMA0 to 230,400 bps::
202
203           zerk -S 230400 -f /dev/ttyAMA0
204
205       Watch entire GPS reset cycle:
206
207           zerk -p RESET -v 2 -w 20 -W
208
209       Poll SVs Status:
210
211           zerk -W -w 2 -v 2 -c "out,,jps/{CS,ES,GS,Is,WS,QS}"
212
213       Dump gpsd data from remote server:
214
215           zerk -v 2 -w 5 server
216
217

SEE ALSO

219       zerk is written to conform to the official Javad documentation for the
220       GREIS protocol.  GREIS (GNSS Receiver External Interface Specification)
221       Guide[1].
222
223       gpsd(8), gps(1), cgps(1), xgps(1), gpsfake(1), gpsctl(1), gpscat(1),
224       gnuplot(1).
225

AUTHOR

227       Gary E. Miller<gem@rellim.com>
228

NOTES

230        1. GREIS (GNSS Receiver External Interface Specification) Guide
231           http://www.javad.com/downloads/javadgnss/manuals/GREIS/GREIS_Reference_Guide.pdf
232
233
234
235The GPSD Project                  18 Sep 2018                          ZERK(1)