diff options
author | Chris Kuethe <chris.kuethe@gmail.com> | 2007-01-15 21:45:20 +0000 |
---|---|---|
committer | Chris Kuethe <chris.kuethe@gmail.com> | 2007-01-15 21:45:20 +0000 |
commit | ec49f1c556b7a88f5a7fcd430983242c05680be8 (patch) | |
tree | a718476eb4fa8ec063a71bcb62972cf239e620ae /contrib | |
parent | 8bd4eace15fe79d2b88ac84ff9498d9740c6c569 (diff) | |
download | gpsd-ec49f1c556b7a88f5a7fcd430983242c05680be8.tar.gz |
Add a little bit of documentation for my crufty hack-job scripts.
Diffstat (limited to 'contrib')
-rw-r--r-- | contrib/README | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/contrib/README b/contrib/README index 1d90a6a9..68502329 100644 --- a/contrib/README +++ b/contrib/README @@ -1,2 +1,32 @@ etc_default_gpsd and etc_init.d_gpsd are Debian init files to be used when it is desired to support gpsd using a set of serial GPSes. + +/* ********************************************************************** */ + +The following tools are not production-ready. They are included only as +conveniences, examples or rudimetary starting points for other development +efforts. + +binlog and binreplay are probably only useful for people developing +new protocols, when gpsfake does not yet know what to do with a log +file. These utilities are not particularly clever - they merely slurp +a tty's output into a file, or spray the contents of a file out of a +tty. + +nmeasend is probably only useful to people developing new protocols +or testing odd features of their hardware. it takes the body of an +NMEA sentence (without the $ or the *checksum) and ships a properly +formatted NMEA sentence to the specified tty. + +sirfctl might be used to reset an uncooperative sirfstar receiver to +a usable state. For whatever reason sometimes they do not respond to +a protocol switch command; this spams the receiver with configuration +commands, and hopefully it listens. This works at least as well as +the official SiRF tools. + +skyview.php is used to generate pictures of your skyview, and may be +used to help determine if a given antenna placement is appropriate for +some purpose. This tool requires about 24hrs worth of "Y" messages and +outputs an image of accumulated SV position and signal strength. It is +sometimes entertaining to "see" occulted SVs using multipath. You must +have the PHP-GD installed to use this script. |