[Git][NTPsec/ntpsec][master] Address GitLab issue #326: Motorola GPSes reporting that it's 13 Oct 1997.

[Eric S. Raymond]

Eric S. Raymond pushed to branch master at NTPsec / ntpsec


Commits:
3992c2e1 by Eric S. Raymond at 2017-08-09T06:13:10-04:00
Address GitLab issue #326: Motorola GPSes reporting that it's 13 Oct 1997.

The entire Oncore line has been EOLed.  The bug is for hardware 15
years old in 1017.  Fix the driver doc to note this and mark the driver
deprecated - to be removed in a future release.

- - - - -


2 changed files:

- docs/driver_oncore.txt
- docs/refclock.txt


Changes:

=====================================
docs/driver_oncore.txt
=====================================
--- a/docs/driver_oncore.txt
+++ b/docs/driver_oncore.txt
@@ -8,6 +8,13 @@ Reference ID: GPS
 Serial Port: /dev/oncore.serial._u_; 9600bps 8N1.
 PPS Port: /dev/oncore.pps._u_
 
+== Deprecation warning ==
+
+This refclock is deprecated and obsolete; the entire Oncore line has
+been end-of-lifed. The NTPsec maintainers plan to remove it in a
+future release.  If you have a requirement for it, please make this
+known to us.
+
 == Description ==
 
 This driver supports most models of the
@@ -15,14 +22,13 @@ https://web.archive.org/web/19990427102123/http://www.mot.com/AECS/PNSB/products
 (Basic, PVT6, VP, UT, UT+, GT, GT+, SL, M12, M12+T), as long as they
 support the _Motorola Binary Protocol_.
 
-The interesting versions of the Oncore are the VP, the UT+, the "Remote"
-which is a prepackaged UT+, and the M12 Timing. The VP is no longer
-available new, and the UT, GT, and SL are at end-of-life. The Motorola
-evaluation kit can be recommended. It interfaces to a PC straightaway,
-using the serial (DCD) or parallel port for PPS input and packs the
-receiver in a nice and sturdy box. Less expensive interface kits are
-available from http://www.tapr.org[TAPR].
- 
+The (formerly) interesting versions of the Oncore were the VP, the
+UT+, the "Remote" which is a prepackaged UT+, and the M12 Timing. The
+Motorola evaluation kit can be recommended. It interfaces to a PC
+straightaway, using the serial (DCD) or parallel port for PPS input
+and packs the receiver in a nice and sturdy box. Less expensive
+interface kits are available from http://www.tapr.org[TAPR].
+
 [width="100%",cols="<34%,<33%,<33%",align="center",frame="none",grid="none"]
 |==========================================================================
 |image:pic/oncore_utplusbig.gif[]|image:pic/oncore_evalbig.gif[]|image:pic/oncore_remoteant.jpg[gif]
@@ -118,11 +124,15 @@ the kernel PLL.
 
 === Performance ===
 
-Really good. With the VP/UT+, the generated PPS pulse is referenced to
-UTC(GPS) with better than 50 nsec (1 sigma) accuracy. The limiting
-factor will be the timebase of the computer and the precision with which
-you can timestamp the rising flank of the PPS signal. Using FreeBSD, a
-FPGA based Timecounter/PPS interface, and an ovenized quartz oscillator,
+Even the newest of these variants, the M12+T with firmware dated 9 Jun
+2004 now reports bad dates due to era rollover.
+
+Performance is really good, other than the rollover issue. With the
+VP/UT+, the generated PPS pulse is referenced to UTC(GPS) with better
+than 50 nsec (1 sigma) accuracy. The limiting factor will be the
+timebase of the computer and the precision with which you can
+timestamp the rising flank of the PPS signal. Using FreeBSD, a FPGA
+based Timecounter/PPS interface, and an ovenized quartz oscillator,
 that performance has been reproduced. For more details on this aspect:
 https://web.archive.org/web/19990221121441/http://phk.freebsd.dk/rover.html[Sub-Microsecond
 timekeeping under FreeBSD].


=====================================
docs/refclock.txt
=====================================
--- a/docs/refclock.txt
+++ b/docs/refclock.txt
@@ -174,7 +174,7 @@ parse driver.
 |link:driver_hpgps.html[hpgps]          | T | Hewlett Packard GPS Receivers
 |link:driver_shm.html[shm]              | T | Shared Memory Driver
 |link:driver_trimble.html[trimble]      | T | Trimble Palisade/Thunderbolt/Acutime GPSes
-|link:driver_oncore.html[oncore]        | - | Motorola UT Oncore GPS
+|link:driver_oncore.html[oncore]        | D | Motorola UT Oncore GPS
 |link:driver_jjy.html[jjy]              | T | JJY Receivers
 |link:driver_zyfer.html[zyfer]          | - | Zyfer GPStarplus Receiver
 |link:driver_neoclock.html[neoclock]    | - | NeoClock4X DCF77 / TDF Receiver



View it on GitLab: https://gitlab.com/NTPsec/ntpsec/commit/3992c2e18b8d6a7b7455bbecdb877f1551c793f9

---
View it on GitLab: https://gitlab.com/NTPsec/ntpsec/commit/3992c2e18b8d6a7b7455bbecdb877f1551c793f9
You're receiving this email because of your account on gitlab.com.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ntpsec.org/pipermail/vc/attachments/20170809/08a32bd9/attachment.html>