xref: /freebsd/contrib/ntp/html/drivers/driver3.html (revision 02e9120893770924227138ba49df1edb3896112a)
1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3<head>
4<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
5<meta name="GENERATOR" content="Mozilla/4.01 [en] (Win95; I) [Netscape]">
6<title>PSTI/Traconex 1020 WWV/WWVH Receiver</title>
7<link href="scripts/style.css" type="text/css" rel="stylesheet">
8</head>
9<body>
10<h3>PSTI/Traconex 1020 WWV/WWVH Receiver</h3>
11<p>Author: David L. Mills (mills@udel.edu)<br>
12Last update:
13  <!-- #BeginDate format:En2m -->11-Sep-2010  05:56<!-- #EndDate -->
14  UTC</p>
15<hr>
16<h4>Synopsis</h4>
17<p>Address: 127.127.3.<i>u</i><br>
18  Reference ID: <tt>WWV</tt><br>
19  Driver ID: <tt>WWV_PST</tt><br>
20  Serial Port: <tt>/dev/wwv<i>u</i></tt>; 9600 baud, 8-bits, no parity<br>
21  Features: <tt>tty_clk</tt></p>
22<h4>Description</h4>
23<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>
24<p>The dipswitches 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. As the there are only four dipswitches to set the year and the base value of zero correspondes to 1986, years beyond 2001 recycle with the value of zero corresponding to 2002. 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>
25<p>Using the poll sequence <tt>QTQDQM</tt>, the response timecode is in three sections totalling 50 ASCII printing characters, as concatenated by the driver, in the following format:</p>
26<pre>
27ahh:mm:ss.fffs&lt;cr&gt; yy/dd/mm/ddd&lt;cr&gt;
28frdzycchhSSFTttttuuxx&lt;cr&gt;
29
30on-time = first &lt;cr&gt;
31hh:mm:ss.fff = hours, minutes, seconds, milliseconds
32a = AM/PM indicator (' ' for 24-hour mode)
33yy = year (from DIPswitches)
34dd/mm/ddd = day of month, month, day of year
35s = daylight-saving indicator (' ' for 24-hour mode)
36f = frequency enable (O = all frequencies enabled)
37r = baud rate (3 = 1200, 6 = 9600)
38d = features indicator (@ = month/day display enabled)
39z = time zone (0 = UTC)
40y = year (5 = 91)
41cc = WWV propagation delay (52 = 22 ms)
42hh = WWVH propagation delay (81 = 33 ms)
43SS = status (80 or 82 = operating correctly)
44F = current receive frequency (4 = 15 MHz)
45T = transmitter (C = WWV, H = WWVH)
46tttt = time since last update (0000 = minutes)
47uu = flush character (03 = ^c)
48xx = 94 (unknown)</pre>
49<p>The alarm condition is indicated by other than <tt>8</tt> at <tt>a</tt>, which occurs during initial synchronization and when received signal is lost for an extended period; unlock condition is indicated by other than <tt>0000</tt> in the <tt>tttt</tt> subfield.</p>
50<h4>Monitor Data</h4>
51<p>When enabled by the <tt>flag4</tt> fudge flag, every received timecode is written as-is to the <tt>clockstats</tt> file.</p>
52<h4>Fudge Factors</h4>
53<dl>
54  <dt><tt>time1 <i>time</i></tt>
55  <dd>Specifies the time offset calibration factor, in seconds and fraction, with default 0.0.
56  <dt><tt>time2 <i>time</i></tt>
57  <dd>Not used by this driver.
58  <dt><tt>stratum <i>number</i></tt>
59  <dd>Specifies the driver stratum, in decimal from 0 to 15, with default 0.
60  <dt><tt>refid <i>string</i></tt>
61  <dd>Specifies the driver reference identifier, an ASCII string from one to four characters, with default <tt>WWV</tt>.
62  <dt><tt>flag1 0 | 1</tt>
63  <dd>Not used by this driver.
64  <dt><tt>flag2 0 | 1</tt>
65  <dd>Not used by this driver.
66  <dt><tt>flag3 0 | 1</tt>
67  <dd>Not used by this driver.
68  <dt><tt>flag4 0 | 1</tt>
69  <dd>Not used by this driver.
70</dl>
71<h4>Additional Information</h4>
72<p><a href="../refclock.html">Reference Clock Drivers</a></p>
73<hr>
74<script type="text/javascript" language="javascript" src="scripts/footer.txt"></script>
75</body>
76</html>
77