NetBSD/usr.sbin/xntp/html/driver3.html

112 lines
3.6 KiB
HTML

<!-- $NetBSD: driver3.html,v 1.1 1998/12/30 20:20:34 mcr Exp $ -->
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML Strict//EN">
<html><head><title>
PSTI/Traconex 1020 WWV/WWVH Receiver
</title></head><body><h3>
PSTI/Traconex 1020 WWV/WWVH Receiver
</h3><hr>
<p><h4>Synopsis</h4>
<p>Address: 127.127.3.<var>u</var>
<br>Reference ID: WWV
<br>Driver ID: WWV-PST
<br>Serial Port: <code>/dev/wwv<var>u</var></code>; 9600 baud, 8-bits,
no parity
<br>Features: <code>tty_clk</code>
<p><h4>Description</h4>
<p>This driver supports the PSTI 1010 and Traconex 1020 WWV/WWVH
Receivers. No specific claim of accuracy is made for these receiver, but
actual experience suggests that 10 ms would be a conservative
assumption.
<p>The DIP-switches should be set for 9600 bps line speed, 24-hour day-
of-year format and UTC time zone. Automatic correction for DST should be
disabled. It is very important that the year be set correctly in the
DIP-switches; otherwise, the day of year will be incorrect after 28 April
of a normal or leap year. The propagation delay DIP-switches should be
set according to the distance from the transmitter for both WWV and
WWVH, as described in the instructions. While the delay can be set only
to within 11 ms, the fudge time1 parameter can be used for vernier
corrections.
<p>Using the poll sequence <code>QTQDQM</code>, the response timecode is
in three sections totalling 50 ASCII printing characters, as
concatenated by the driver, in the following format:
<pre>
ahh:mm:ss.fffs&lt;cr&gt; yy/dd/mm/ddd&lt;cr&gt;
frdzycchhSSFTttttuuxx&lt;cr&gt;
on-time = first &lt;cr&gt;
hh:mm:ss.fff = hours, minutes, seconds, milliseconds
a = AM/PM indicator (' ' for 24-hour mode)
yy = year (from DIPswitches)
dd/mm/ddd = day of month, month, day of year
s = daylight-saving indicator (' ' for 24-hour mode)
f = frequency enable (O = all frequencies enabled)
r = baud rate (3 = 1200, 6 = 9600)
d = features indicator (@ = month/day display enabled)
z = time zone (0 = UTC)
y = year (5 = 91)
cc = WWV propagation delay (52 = 22 ms)
hh = WWVH propagation delay (81 = 33 ms)
SS = status (80 or 82 = operating correctly)
F = current receive frequency (4 = 15 MHz)
T = transmitter (C = WWV, H = WWVH)
tttt = time since last update (0000 = minutes)
uu = flush character (03 = ^c)
xx = 94 (unknown)
</pre>
<p>The alarm condition is indicated by other than <code>8</code> at
<code>a</code>, which occurs during initial synchronization and when
received signal is lost for an extended period; unlock condition is
indicated by other than <code>0000</code> in the <code>tttt</code>
subfield.
<p><h4>Monitor Data</h4>
<p>When enabled by the <code>flag4</code> fudge flag, every received
timecode is written as-is to the <code>clockstats</code> file.
<p><h4>Fudge Factors</h4>
<dl>
<dt><code>time1 <i>time</i></code>
<dd>Specifies the time offset calibration factor, in seconds and
fraction, with default 0.0.
<p><dt><code>time2 <i>time</i></code>
<dd>Not used by this driver.
<p><dt><code>stratum <i>number</i></code>
<dd>Specifies the driver stratum, in decimal from 0 to 15, with default
0.
<p><dt><code>refid <i>string</i></code>
<dd>Specifies the driver reference identifier, an ASCII string from one
to four characters, with default <code>WWV</code>.
<p><dt><code>flag1 0 | 1</code>
<dd>Not used by this driver.
<p><dt><code>flag2 0 | 1</code>
<dd>Not used by this driver.
<p><dt><code>flag3 0 | 1</code>
<dd>Enable <code>ppsclock</code> line discipline/streams module if set.
<p><dt><code>flag4 0 | 1</code>
<dd>Enable <code>clockstats</code> recording if set.
</dl>
<p>Additional Information
<p><a href="refclock.html"> Reference Clock Drivers</a>
<hr><address>David L. Mills (mills@udel.edu)</address></body></html>