gpsfake
1
12 Feb 2005
gpsfake
test harness for gpsd, simulating a GPS
gpsfake
-h
-b
-c interval
-D debuglevel
-g
-l
-m monitor
-o options
-p
-s speed
-v
logfile
DESCRIPTION
gpsfake is a test harness for
gpsd and its clients. It opens a pty
(pseudo-TTY), launches a gpsd instance that
thinks the slave side of the pty is its GPS device, and repeatedly
feeds the contents of a test logfile through the master side to the
GPS.
gpsfake does not require root
privileges, and can be run concurrently with a production
gpsd instance without causing problems.
The logfile may be of NMEA, SiRF-II packets, or Zodiac packets.
Leading lines beginning with # will be treated as comments and
ignored.
The gpsd instance is run in
foreground. The thread sending fake GPS data to the daemon
uis run in background.
OPTIONS
The -b option enables a twirling-baton progress indicator
on standard error. At termination, it reports elaped time.
The -c option sets the delay between sentences in
seconds. Fractional values of seconds are legal.
The -g option runs gpsd under the
control of gdb, the GNU debugger. The thread that will send data to
the daemon instance waits until it sees the pidfile created, so you
may do any setup necessary at the gdb command prompt before typing
"run" to begin feeding the log to the daemon.
The -l option makes the program dump a line or packet number just
before each sentence is fed to the daemon. If the sentence is
textual (e.g. NMEA, the text is dumped as well).
The -m option specifies a monitor program inside which the
daemon should be run. This option is intended to be used with
valgrind1
and similar programs.
The -o option specifies options to pass to the daemon.
Passing "-n" is often useful. The -D option passes a -D option
to the daemon: thus -D 4 is shorthand for -o "-D 4".
The -p option dumps the NMEA and GPSD notifications generated
by the log to standard output. The logfile is interpreted once
only. (This option is intended to facilitate regression testing.)
The -s option sets the baud rate for the slave tty. The
default is 4800.
The -v option enables more progress messages to standard error.
The -h option makes gpsfake print
a usage message and exit.
The argument must be the name of a file containing the
data to be cycled at the device. gpsfake
will print a notification each time it cycles.
SEE ALSO
gpsd8,
xgps1,
libgps3,
libgpsd3,
gpsprof1,
gnuplot1.
AUTHOR
Eric S. Raymond esr@thyrsus.com. There is a
project page for gpsd here.