Add References page.

7 files changed, 182 insertions, 35 deletions

diff --git a/www/faq.html b/www/faq.html
index cf14b42b..f5dd16df 100644
--- a/www/faq.html
+++ b/www/faq.html
@@ -26,6 +26,7 @@ GPSD Frequently Asked Questions
     <a href="index.html#recipes">Recipes</a><br/>
     <a href="index.html#others">Other GPSDs</a><br/>
     <a href="hardware.html">Hardware</a><br/>
+    <a href="references.html">References</a><br/>
     <a href="history.html">History</a><br/>
 
     <a href='http://www.catb.org/hacker-emblem/'>
diff --git a/www/gps-hacking.html b/www/gps-hacking.html
index cdc6f263..4ae31d79 100644
--- a/www/gps-hacking.html
+++ b/www/gps-hacking.html
@@ -26,6 +26,7 @@ ESR's Guide to Hacking With GPS
     <a href="index.html#recipes">Recipes</a><br/>
     <a href="index.html#others">Other GPSDs</a><br/>
     <a href="hardware.html">Hardware</a><br/>
+    <a href="references.html">References</a><br/>
     <a href="history.html">History</a><br/>
 
     <a href='http://www.catb.org/hacker-emblem/'>
@@ -365,10 +366,6 @@ client connects to the daemon.</p>
 <dt><a href="http://34n118w.net/htmldir/GPS.html">GPS Resources</a></dt>
 <dd>This is where the orbital simulation came from.</dd>
 
-<dt><a href='http://www.topology.org/soft/gps.html'>GPS interfaces and 
-software</a></dt>
-<dd>Linux and open-source resources for working with GPSes.</dd>
-
 <dt><a
 href='http://www.circuitcellar.com/library/print/0899/Cyliax109/index.htm'>Where
 in the World</a></dt>
@@ -377,9 +374,6 @@ like <a
 href="http://www.circuitcellar.com/library/print/0899/Cyliax109/3.htm">CEP
 and DGPS</a>.</dd>
 
-<dt><a href="http://www.gpsinformation.org/dale/nmea.htm">NMEA data</a></dt>
-<dd>Excellent document on the NMEA protocol.</dd>
-
 <dt><a href="http://www.ualberta.ca/~ckuethe/gps/">GPS Hackery</a></dt>
 <dd>Chris Kuethe's page has links to many interesting resources.</dd>
 
@@ -394,10 +388,9 @@ the non-technical description</a></dt>
 <dt><a href='http://users.erols.com/dlwilson/gps.htm'>David L. Wilson's GPS Accuracy Web Page</a></dt>
 <dd>Goes in-depth on accuracy, with the math.</dd>
 
-
-<dt><a
-href='http://www.itu.int/rec/recommendation.asp?type=items&amp;lang=E&amp;parent=R-REC-M.823-2-199710-I'>ITU-R M.823-2</a></dt> 
-<dd>This specification documents some of the murky depths of RTCM-104.</dd>
+<dt><a href='http://www.topology.org/soft/gps.html'>GPS interfaces and 
+software</a></dt>
+<dd>Linux and open-source resources for working with GPSes.</dd>
 </dl>
 
 </body>
diff --git a/www/hardware.html b/www/hardware.html
index 6f2f484d..21046487 100644
--- a/www/hardware.html
+++ b/www/hardware.html
@@ -502,28 +502,8 @@ gives a vendor and product ID, send us those numbers.)</li>
 
 <h2>Notes on chipset support:</h2>
 
-<p>SiRF-II: A <a
-href='http://www.rayming.com/download/NEMA_commands.pdf'>technical
-manual</a> describing NMEA extensions supported by this chipset is
-available from Globalsat's U.S. reseller.  For SiRF binary
-protocol, look <a href='sirf_binary.pdf'>here</a>.</p>
-
-<p>The SiRFstar-I chipset used by uBlox and some others is documented <a
-href='http://www.linkwave.co.uk/assets/GPS.G2-X-01003-E1.pdf'>here</a>.</p>
-
-<p>A spec sheet for the Evermore chipset <a
-href='http://www.twintrading.co.kr/pdf/himark/bbp120brief.pdf'>is
-available</a>. User's guide, including protocol spec, is <a
-href='GM-X205_UG_revB.pdf'>here</a>.</p>
-
-<p>Zodiac: See the <a href='zodiac.pdf'>Zodiac Serial Data
-Interface Specification</a></p>
-
-<p>Sony: the Sony CXD2951 command set is dcumented 
-<a href='cxd2951-commands.pdf'>here</a>.</p>
-
-<p>Garmin serial GPSes: a manual for the 16 and 17 series is
-<a href='http://www.garmin.com/manuals/GPS17N_GPS16_17NSeriesTechnicalSpecification.pdf'>here</a>.</p>
+<p>For vendor protocol protocol manuals see our
+<a href='references.html'>Programmer's References</a> page.</p>
 
 <p>PL2303: support is broken in late 2.4 Linux kernels (it broke after
 2.4.18) but good in 2.6.8 and later.</p>
diff --git a/www/history.html b/www/history.html
index ca7184be..7923234f 100644
--- a/www/history.html
+++ b/www/history.html
@@ -26,6 +26,8 @@ A Brief History of GPSD
     <a href="index.html#recipes">Recipes</a><br/>
     <a href="index.html#others">Other GPSDs</a><br/>
     <a href="hardware.html">Hardware</a><br/>
+    <a href="references.html">References</a><br/>
+    <a href="hardware.html">Hardware</a><br/>
     History<br/>
 
     <a href='http://www.catb.org/hacker-emblem/'>
diff --git a/www/index.html.in b/www/index.html.in
index da596004..6384905b 100644
--- a/www/index.html.in
+++ b/www/index.html.in
@@ -26,6 +26,7 @@
     <a href="#recipes">Recipes</a><br/>
     <a href="#others">Other GPSDs</a><br/>
     <a href="hardware.html">Hardware</a><br/>
+    <a href="references.html">References</a><br/>
     <a href="history.html">History</a><br/>
 
     <a href='http://www.catb.org/hacker-emblem/'>
diff --git a/www/references.html b/www/references.html
new file mode 100644
index 00000000..17b024f4
--- /dev/null
+++ b/www/references.html
@@ -0,0 +1,171 @@
+<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
+<html>
+<head>
+   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+   <meta name="Description" content="Programmer's references for GPSD">
+   <meta name="Keywords" content="GPS, translator, GIS">
+   <title>Reference links on GPS technology</title>
+   <link rel="stylesheet" href="main.css" type="text/css"/>
+</head>
+<body>
+
+<div id="Header">Programmer's References</div>
+
+<div id="Menu">
+    <img src="gpsd-logo-small.png"/><br />
+    <a href="index.html">Home<br/>
+    <a href="index.html#news">News</a><br/>
+    <a href="index.html#downloads">Downloads</a><br/>
+    <a href="index.html#mailing-lists">Mailing lists</a><br/>
+    <a href="index.html#documentation">Documentation</a><br/>
+    <a href="faq.html">FAQ</a><br/>
+    <a href="xgps-sample.html">Screenshots</a><br/>
+    <a href="index.html#recipes">Recipes</a><br/>
+    <a href="index.html#others">Other GPSDs</a><br/>
+    <a href="hardware.html">Hardware</a><br/>
+    References<br/>
+    <a href="history.html">History</a><br/>
+
+    <a href='http://www.catb.org/hacker-emblem/'>
+    <img src='http://www.catb.org/hacker-emblem/glider.png'
+    alt='hacker emblem' /></a><br />
+
+    <a href="http://validator.w3.org/check/referer"><img
+          src="http://www.w3.org/Icons/valid-xhtml10"
+          alt="Valid XHTML 1.0!" height="31" width="88" /></a>
+</div>
+<div id="Content">
+
+<p>This page lists both onsite and offsite resources for programmers
+trying to understand GPS technology.</p>
+
+<h1>GPS standards</h1>
+
+<dl>
+<dt><a href='NMEA.txt'>NMEA sentences</a></dt>
+<dd>The NMEA 0183 standard describing how GPSes are supposed to report
+to computers is proprietary.  The GPSD project has collected fairly
+comprehensive information on the contents of that standard from
+various Web sources.  This is the collection.</dd>
+
+<dt><a href="http://www.gpsinformation.org/dale/nmea.htm">NMEA data</a></dt>
+<dd>This is one of the sources for the above. Includes some 
+information on vendor-specific quirks that we son't.</dd>
+
+<dt><a href='http://www.nmea.org/pub/0183/'>NMEA 0183</a></dt>
+<dd>This is the actual standard.  The distribution terms are evil,
+e.g. it's proprietary and expensive and NMEA's attack lawyers have been
+known to threaten people who quote it directly.  Consequently, nobody
+on the GPSD project has ever looked at it.</dd>
+
+<dt><a href='IS-GPS-200D.pdf'>Navstar Global Positioning Interface
+Specification</a></dt>
+<dd>This is the official specification for interpreting radio
+transmission from GPS satellites. You do not need to read this 
+unless you are trying to make sense of the raw 50BPS subframe 
+data.  Be warned: this specification is complex and nasty.</dd>
+
+<dt><a
+href='http://www.itu.int/rec/recommendation.asp?type=items&amp;lang=E&amp;parent=R-REC-M.823-2-199710-I'>ITU-R M.823-2</a></dt> 
+<dd>This specification documents some of the murky depths of
+RTCM-104. Unfortunately, its distribution terms are also evil.</dd>
+
+</dl>
+
+<h1>Vendor protocols</h1>
+
+<p>Due to the inadequacies of NMEA, GPS chipset vendors have invented
+NMEA extensions or their own more tightly-designed reporting formats.
+This is a collection of descriptions of them.  Many of these have
+already been used in the implementation of <code>gpsd</code>; others
+may be used in the future.</p>
+
+<dl>
+<dt><a href='sirf_binary.pdf'>SiRF Binary Protocol Reference Manual</a></dt>
+<dd>The binary protocol for the chip used by over 80% of consumer-grade
+GPSes in 2005.</dd>
+
+<dt><a href='sirf_protocol.pdf'>SiRF GPS Protocol Reference Manual</a></dt>
+<dd>This what SiRF gives OEMs as a reference for SiRF's NMEA 0183
+extensions. Notably, it describes the commands for switching to SiRF
+binary mode.</dd>
+
+<dt><a href='uBlox.pdf'>u-blox extension to SiRF binary protocol</a></dt>
+<dd>uBlox was an OEM-enhanced firmware variant of the SiRF-I chip.
+<code>gpsd</code> supports it.  It's obsolete.</dd>
+
+<dt><a
+href='http://www.linkwave.co.uk/assets/GPS.G2-X-01003-E1.pdf'>TIM GPS
+Receiver Maco-Component(offsite link)</a></dt>
+<dd> Describes the SiRFstar-I chipset used by uBlox and some others.
+<code>gpsd</code> supports it.  It's obsolete.</dd>
+
+<dt><a
+href='http://www.garmin.com/manuals/GPS17N_GPS16_17NSeriesTechnicalSpecification.pdf'>
+GPS 16/17 Series Technical Specification (offsite link)</a></dt>
+<dd>A manual for the 16 and 17 series of Garmin serial GPSes.  These
+don't use Garmin binary protocol, but rather an enhanced
+NMEA. <code>gpsd</code> supports it.</dd>
+
+<dt><a href='zodiac.pdf'>Zodiac Serial Data Interface Specification</a></dt>
+<dd>Describes the binary protocol used by Rockwell Zodiac chipsets.
+Supported by <code>gpsd</code>.  Now obsolete.</dd>
+
+<dt><a href='garmin-binary.pdf'>GARMIN GPS Interface Specification</a></dt> 
+<dd>The binary protocol used by Garmin USB GPSes. Supported by
+<code>gpsd</code>.</dd>
+
+<dt><a href='cxd2951-commands.pdf'>CXD2951 Communication Command Specification</a></dt>
+<dd>Describes the extension command set supported by the Sony GPS
+CXD2951 chipset. Supported by <code>gpsd</code>.</dd>
+
+<dt><a href='fastrax.pdf'>NMEA Protocol Specification for iTrax02
+Evaluation Kit</a></dt> <dd>Describes the NMEA extensions for the
+iTrax chipset used by Fastrax GPSes, including the commands to switch
+to binary iTalk mode. Not yet supported by <code>gpsd</code> but work
+is in progress.</dd>
+
+<dt><a href='iTalk.pdf'>iTALK protocol specification</a></dt>
+<dd>Describes the binary protocol for the iTrax chipset used by
+Fastrax GPSes. Not yet supported by <code>gpsd</code> but work is in
+progress.</dd>
+
+<dt><a href='fv-18_manual.pdf'>FV18 user manual</a></dt>
+<dd>Describes NMEA extensions supported by the San Jose Navigation
+FV-18 GPS chipset. Supported by <code>gpsd</code>.</dd>
+
+<dt><a href='GPS-210-Manual-E.pdf'>Holux GM-210 GPS Receiver User's
+Guide</a></dt>
+<dd>Describes NMEA as emitted by the Holux GM210.  This is a very
+generic NMEA GPS.   Supported by <code>gpsd</code>.</dd>
+
+<dt><a href='GM-X205_UG_revB.pdf'>GM-X205 GPS Receiver Module User's Guide</a></dt>
+<dd>Describes the binary protocol emitted by EverMore GM-X205 GPS
+chipset. Not yet supported by <code>gpsd</code> but work is in
+progress.</dd>
+
+<dt><a href='garmin_simpletext.txt'>Garmin Simple Text Protocol</a></dt>
+<dd>Some digital cameras are alleged to use this very simple textual
+report format.  Not yet supported by <code>gpsd</code></dt>
+</dl>
+
+<h1>Other</h1>
+
+<dl>
+<dt><a href='XYZ-NED.pdf'>ECEF-to-Geodetic C Code</a></dt>
+<dd>Sample C code for conversion from the Earth Centered-Earth Fixed
+coordinates reported by many vendor binary protocols to ordinary
+geodetic coordinates.</dd>
+</dl>
+
+</div>
+<hr/>
+<script language="JavaScript" src="datestamp.js" type='text/javascript'></script>
+</body>
+</html>
+
+<!--
+Local Variables:
+compile-command: "(scp bibiography.html esr@shell.berlios.de:/home/groups/gpsd/htdocs)"
+End:
+-->
diff --git a/www/upload b/www/upload
index 05cd10c1..3471a064 100755
--- a/www/upload
+++ b/www/upload
@@ -24,5 +24,4 @@ xmlto xhtml-nochunks ../rtcm.xml
 xmlto xhtml-nochunks ../srec.xml
 xmlto xhtml-nochunks replacing-nmea.xml
 (cd performance; xmlto xhtml-nochunks performance.xml)
-# Doesn't upload PDFs or GIFs -- they aren't expected to change frequently
-scp *.html *.png performance/{*.html,*.txt,*.png} *.css *.js *.txt *.ebuild $webdir
+scp *.html *.png *.pdf *.gif performance/{*.html,*.txt,*.png} *.css *.js *.txt *.ebuild $webdir