From d13868b166f0dc088074d8276545aa1bc5c09989 Mon Sep 17 00:00:00 2001 From: "Eric S. Raymond" Date: Mon, 31 Aug 2009 17:36:04 +0000 Subject: Refresh NEWS and website to reflect support for AIS devices. --- www/gps_report.cgi | 78 ++++++++++++++++++++++++++------------------------ www/hardware-head.html | 18 ++++++------ www/history.html | 5 ++++ www/index.html.in | 16 +++++------ 4 files changed, 62 insertions(+), 55 deletions(-) (limited to 'www') diff --git a/www/gps_report.cgi b/www/gps_report.cgi index c2536f64..83bebd7c 100644 --- a/www/gps_report.cgi +++ b/www/gps_report.cgi @@ -13,7 +13,7 @@ use strict; my $query = new CGI; print $query->header; -print $query->start_html(-title=>"GPS Reporting Form", +print $query->start_html(-title=>"GPSD Receiver Reporting Form", -background=>"../paper.gif"); my $output_sample_file = $query->param('output_sample'); @@ -81,10 +81,10 @@ if (hasNeededElements($query) && $query->param("action") eq "Send Report"){ print $query->start_multipart_form; print <GPS Behavior Reporting Form +

GPSD Receiver Reporting Form

Please use this form to report gpsd successes or -failures with GPS units, and also to upload a sample of the GPS's +failures with GPS and AIS units, and also to upload a sample of the receiver's output so we can add it to our regression tests and ensure continued support of the device.

@@ -92,7 +92,7 @@ support of the device.

in for the report to be useful. These are: submitter contact address, vendor, model, documentation URL, and output sample. Other fields represent things we might be able to find out ourselves, but which are easier for you to determine. -Every bit of information you can give us about your GPS will help make the +Every bit of information you can give us about your receiver will help make the support for it more reliable.

@@ -114,13 +114,13 @@ print <(It is not actually very likely we will contact you, but we need to be able to do it if we can find no other way of getting information -about the device. Expect to hear from us if your GPS is obsolescent or +about the device. Expect to hear from us if your receiver is obsolescent or exotic and the information you provide in the rest of this form turns out to be insufficient. Or if your browser is broken enough to botch the output-sample upload.)

-

GPS type identification

+

Receiver type identification

Important! Identify the vendor and model of your device. @@ -147,15 +147,15 @@ EOF print $query->textfield(-name=>"techdoc", -size=>72); print <It is useful to have an indication of how the GPS is packaged. +

It is useful to have an indication of how the receiver is packaged.

    -
  • A "GPS mouse" is a standalone sensor in a display-less case designed -be used as an outbard peripheral to a computer.
    • -
  • A "handset" is a standalone GPS with a display and human-usable controls.
    • +
  • A "mouse" is a standalone sensor in a display-less case designed +be used as an peripheral to a computer.
    • +
  • A "handset" is a standalone unit with a display and human-usable controls.
  • A "handsfree" is a hands-free unit with display designed for mounting on a car windshield or boat dash.
    • -
  • A "survey" GPS is packaged for field-survey use.
    • +
  • A "survey" unit is packaged for field-survey use.
  • An "OEM module" is an un-cased circuit board with edge connectors.
  • "chipset" is a bare chip or chips packaged for surface mount.
@@ -164,16 +164,16 @@ on a car windshield or boat dash. EOF print $query->radio_group(-name=>'packaging', - -values=>['GPS mouse', 'handset', 'handsfree', + -values=>['mouse', 'handset', 'handsfree', 'survey', 'OEM module', 'chipset', 'other'], - -default=>"GPS mouse", + -default=>"mouse", -linebreak=>'false'); print <Please identify the GPS chipset and firmware version, if possible. You +

Please identify the device chipset and firmware version, if possible. You may be able to get this from the display of xgps; look for -a GPS Type field or at the window title bar. Alternatively, you may find +a Device Type field or at the window title bar. Alternatively, you may find it in the technical manual.
Example: SiRF-II amd 2.31ES.

EOF @@ -184,7 +184,7 @@ print "

Firmware:", $query->textfield(-name=>"firmware", -size=>72),"

\n"; print <Please identify, if possible, the NMEA version the GPS emits. +

Please identify, if possible, the NMEA version the receiver emits. You may be able to get this information from the technical manual. Likely values are 2.0, 2.2, and 3.0. If the GPS emits only a vendor binary protocol, leave this field blank.

@@ -198,11 +198,11 @@ print <

Interfaces

-

Please identify the GPS's interface type (USB, RS-232, Compact Flash, -etc.). If the GPS has adapters that support other interfaces, tell us -the one you have and mention the adapters in the "Technical Notes" box. -If it has an exotic interface not listed here, select "Other" and tell us -about it in "Technical Notes".

+

Please identify the receiver's interface type (USB, RS-232, Bluetooth, +Compact Flash, etc.). If the receiver has adapters that support other +interfaces, tell us the one you have and mention the adapters in the "Technical +Notes" box. If it has an exotic interface not listed here, select "Other" and +tell us about it in "Technical Notes".

EOF @@ -240,13 +240,13 @@ print "Tested with:",$query->textfield(-name=>"tested", -size=>6); print <Please rate how well this GPS functions with GPSD:

+

Please rate how well this receiver functions with GPSD:

EOF my %labels=( "excellent", - "Excellent -- gpsd recognizes the GPS rapidly and reliably, reports are complete and correct.", + "Excellent -- gpsd recognizes the receiver rapidly and reliably, reports are complete and correct.", "good", "Good -- gpsd has minor problems or lag recognizing the device, but reports are complete and correct.", "fair", @@ -292,13 +292,13 @@ print <Output sample

Important! We need a sample of the output -from your GPS - not the gpsd logfile, just raw output. We'll use this for +from your receiver - not the gpsd logfile, just raw output. We'll use this for mechanical regression testing, which is your best guarantee that support for your device won't get broken in a future release. Please be advised that these logs will be sent to a publicly archived mailing list, and will be available in the public SVN repository.

-

Almost all GPS receivers will simply start throwing data to your port +

Almost all receivers will simply start throwing data to your port immediately when they're plugged in. You should normally be able to capture this output to a file with the gpscat utility.

@@ -311,9 +311,9 @@ href="mailto:gpsd-dev\@lists.berlios.de">GPSD developers for help.

A log file is most useful when it contains (a) some sentences -generated when the GPS has no fix, (b) some sentences representing -a fix with the GPS stationary, and (c) some sentences representing -a fix with the GPS moving.

+generated when the receiver has no fix, (b) some sentences representing +a fix with the unit stationary, and (c) some sentences representing +a fix with the unit moving.

EOF @@ -328,7 +328,7 @@ files.

Location of the log capture. A good format would include your nearest city or other landmark, state/province, country code, and a -rough latitude/longitude. The GPS will give an exact location; we +rough latitude/longitude. A GPS will give an exact location; we want this as a sanity check.
Example: Groningen, NL, 53.2N 6.6E

@@ -339,7 +339,7 @@ print"Location:",$query->textfield(-name=>"location", print <Day/month/year of the log capture (the GPS will give us +

Day/month/year of the log capture (the receiver will give us hour/minute/second).
Example: 20 May 2006.

@@ -350,9 +350,10 @@ print"Date:",$query->textfield(-name=>"date", -size=>72); print <The GPS's default sampling interval in seconds. This will usually be 1. -For SiRF chips it's always 1 and you can leave it blank; it's mainly -interesting for NMEA devices with unknown chipsets.

+

If the receiver is a GPS, the default sampling interval in seconds (not +relevant for AIS receivers). This will usually be 1. For SiRF chips it's +always 1 and you can leave it blank; it's mainly interesting for NMEA devices +with unknown chipsets.

EOF @@ -361,10 +362,11 @@ print"Sampling interval:",$query->textfield(-name=>"interval", print <First sentence in the GPS's reporting cycle. Leave this blank for SiRF -devices; it is mainly interesting for NMEA devices with unknown chipsets. -You may be able to read it from the manual; if not, slowing the GPS to -4800 will probably make the intercycle pause visible.

+

First sentence in the GPS's reporting cycle (not relevant or AIS +receivers). Leave this blank for SiRF devices; it is mainly interesting for +NMEA devices with unknown chipsets. You may be able to read it from the +manual; if not, slowing the GPS to 4800 will probably make the intercycle pause +visible.

EOF @@ -374,7 +376,7 @@ print"First sentence:",$query->textfield(-name=>"leader", print <Finally, add any notes you want to about how the sample was taken. One -good thing to put here would a description of how the GPS was moving while the +good thing to put here would a description of how the unit was moving while the log was being captured. If the sentence mix changes between "fix" and "no fix" states, that too is a good thing to note.

diff --git a/www/hardware-head.html b/www/hardware-head.html index cfd86499..38fd7417 100644 --- a/www/hardware-head.html +++ b/www/hardware-head.html @@ -103,14 +103,14 @@ -

gpsd should work with any GPS using an RS232C or USB -interface that advertises NMEA-0183 compliance. Here are some notes -on hardware we have tested. Hyperlinks lead to technical information. -The "Works with" column is the last gpsd version with -which this GPS is known to have been successfully tested; A in this column means we have a regression test -load for the device that is checked before each release. Vendors are -listed in alphabetical order.

+

gpsd should work with any GPS or AIS receiver using an +RS232C or USB interface that advertises NMEA-0183 compliance. Here +are some notes on hardware we have tested. Hyperlinks lead to +technical information. The "Works with" column is the last +gpsd version with which this receiver is known to have been +successfully tested; A in this column +means we have a regression test load for the device that is checked +before each release. Vendors are listed in alphabetical order.

There is also a table of PPS-capable receivers which may be appropriate for timing use.

@@ -126,7 +126,7 @@ of the problem. Where possible, we indicate this in the device table.

  • marks devices with Excellent performance: gpsd -recognizes the GPS rapidly and reliably, reports are complete and +recognizes the receiver rapidly and reliably, reports are complete and correct.
  • marks diff --git a/www/history.html b/www/history.html index bec3c624..f0e57180 100644 --- a/www/history.html +++ b/www/history.html @@ -157,6 +157,11 @@ configuration tools; gpsmon dates from this time author believes to be our design mistakes. We discuss it here..

    +

    In July and August 2009 ESR redesigned the GPSD command +protocol and gave gpsd the ability to read data from +marine AIS receivers and pass it to clients.

    +

    Further forks of gpsd seem unlikely, as the project is now sufficiently large and visible to co-opt most developers who might otherwise have forked the old 1.x sources or written a competing diff --git a/www/index.html.in b/www/index.html.in index 15d856ba..d00746b7 100644 --- a/www/index.html.in +++ b/www/index.html.in @@ -66,11 +66,11 @@

    About gpsd

    gpsd is a service daemon that monitors one or more -GPSes attached to a host computer through serial or USB ports, making -all data on the location/course/velocity of the sensors available to -be queried on TCP port 2947 of the host computer. With -gpsd, multiple GPS client applications (such as -navigational and wardriving software) can share access to GPSes +GPSes or AIS receivers attached to a host computer through serial or +USB ports, making all data on the location/course/velocity of the +sensors available to be queried on TCP port 2947 of the host computer. +With gpsd, multiple location-aware client applications (such as +navigational and wardriving software) can share access to receivers without contention or loss of data. Also, gpsd responds to queries with a format that is substantially easier to parse than the NMEA 0183 emitted by most GPSes. The gpsd @@ -80,8 +80,8 @@ applications can use to encapsulate all communication with gpsd.

    Besides gpsd itself, the project provides auxiliary -tools for diagnostic monitoring and profiling of GPSes and feeding -GPS-aware applications GPS logs for diagnostic purposes.

    +tools for diagnostic monitoring and profiling of receivers and feeding +location-aware applications GPS/AIS logs for diagnostic purposes.

    The goal of the gpsd project is to create a solid layer of open-source infrastructure for programs running under Linux @@ -105,7 +105,7 @@ configuration. Binary packages for this program install hotplug scripts that do the right thing when a USB device goes active, launching gpsd if needed and telling gpsd which device to read data from. Then, gpsd deduces a -baud rate and GPS type by looking at the data stream.

    +baud rate and GPS/AIS type by looking at the data stream.

    gpsd is high-quality, carefully-audited code. It is regularly checked with the standard mode of