Revert "Removed contrib/skyview.php amd contrib/maxsats.pl, they used the old protocol."

This reverts commit 0dac112485e7a7117bd9ac735625f20e10750e79.

Sanjeev Gupta wants a chance to fix the old programs.

1 files changed, 13 insertions, 1 deletions

diff --git a/contrib/README b/contrib/README
index 6f51b025..849bae44 100644
--- a/contrib/README
+++ b/contrib/README
@@ -8,6 +8,13 @@ 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.
 
+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 library installed to use this script.
+
 ashctl might be used to reset an uncooperative Ashtech receiver to
 a usable state. For whatever reason sometimes they do not respond to
 a protocol switch command; this spams the receiver with configuration
@@ -18,6 +25,11 @@ protocol (like motorola oncore or rockwell jupiter). it's a little
 buggy with syncing up to the start of a packet, but it'll send control
 strings OK.
 
+maxsats.pl analyzes a collection of "Y" messages and outputs records
+describing periods of excellent visibility (ie. 10 or more PRNs tracked).
+With over 30 SVs on orbit, there are periods where 14 PRNs are above the
+horizon, 13 are tracking, and at least 12 are actually used in a solution.
+
 lla2ecef transforms latitude/longitude/altitude (aka north-east-up or local
 tangential plane) coordinates into the earth-centered-earth-fixed frame. If
 invoked as "ecef2lla" it will transform coordinates in the opposite manner.
@@ -32,7 +44,7 @@ to create a snapshot of the current sat view.
 
 ntpoffset generate an estimate of your GPS's offset from a peerstats
 file.  For instructions on how to use this script, see the GPSD Time
-Service HOWTO in this distribution.
+Service HOWTO in this distrubution.
 
 ppscheck watches a specified serial device for changes in handshake lines
 CD, RI, and CTS by running ioctl(...., TIOCMIWAIT, ...) in a loop.  When it