Initial import from FreeBSD RELENG_4:
[games.git] / contrib / ntp / html / driver3.htm
1 <HTML>
2 <HEAD>
3    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
4    <META NAME="GENERATOR" CONTENT="Mozilla/4.01 [en] (Win95; I) [Netscape]">
5    <TITLE>PSTI/Traconex 1020 WWV/WWVH Receiver
6 </TITLE>
7 </HEAD>
8 <BODY>
9
10 <H3>
11 PSTI/Traconex 1020 WWV/WWVH Receiver</H3>
12
13 <HR>
14 <H4>
15 Synopsis</H4>
16 Address: 127.127.3.<I>u</I>
17 <BR>Reference ID: <TT>WWV</TT>
18 <BR>Driver ID: <TT>WWV_PST</TT>
19 <BR>Serial Port: <TT>/dev/wwv<I>u</I></TT>; 9600 baud, 8-bits, no parity
20 <BR>Features: <TT>tty_clk</TT>
21 <H4>
22 Description</H4>
23 This driver supports the PSTI 1010 and Traconex 1020 WWV/WWVH Receivers.
24 No specific claim of accuracy is made for these receiver, but actual experience
25 suggests that 10 ms would be a conservative assumption.
26
27 <P>The DIP-switches should be set for 9600 bps line speed, 24-hour day-of-year
28 format and UTC time zone. Automatic correction for DST should be disabled.
29 It is very important that the year be set correctly in the DIP-switches;
30 otherwise, the day of year will be incorrect after 28 April of a normal
31 or leap year. The propagation delay DIP-switches should be set according
32 to the distance from the transmitter for both WWV and WWVH, as described
33 in the instructions. While the delay can be set only to within 11 ms, the
34 fudge time1 parameter can be used for vernier corrections.
35
36 <P>Using the poll sequence <TT>QTQDQM</TT>, the response timecode is in
37 three sections totalling 50 ASCII printing characters, as concatenated
38 by the driver, in the following format:
39 <PRE>ahh:mm:ss.fffs&lt;cr> yy/dd/mm/ddd&lt;cr>
40 frdzycchhSSFTttttuuxx&lt;cr>
41
42 on-time = first &lt;cr>
43 hh:mm:ss.fff = hours, minutes, seconds, milliseconds
44 a = AM/PM indicator (' ' for 24-hour mode)
45 yy = year (from DIPswitches)
46 dd/mm/ddd = day of month, month, day of year
47 s = daylight-saving indicator (' ' for 24-hour mode)
48 f = frequency enable (O = all frequencies enabled)
49 r = baud rate (3 = 1200, 6 = 9600)
50 d = features indicator (@ = month/day display enabled)
51 z = time zone (0 = UTC)
52 y = year (5 = 91)
53 cc = WWV propagation delay (52 = 22 ms)
54 hh = WWVH propagation delay (81 = 33 ms)
55 SS = status (80 or 82 = operating correctly)
56 F = current receive frequency (4 = 15 MHz)
57 T = transmitter (C = WWV, H = WWVH)
58 tttt = time since last update (0000 = minutes)
59 uu = flush character (03 = ^c)
60 xx = 94 (unknown)</PRE>
61 The alarm condition is indicated by other than <TT>8</TT> at <TT>a</TT>,
62 which occurs during initial synchronization and when received signal is
63 lost for an extended period; unlock condition is indicated by other than
64 <TT>0000</TT> in the <TT>tttt</TT> subfield.
65 <H4>
66 Monitor Data</H4>
67 When enabled by the <TT>flag4</TT> fudge flag, every received timecode
68 is written as-is to the <TT>clockstats</TT> file.
69 <H4>
70 Fudge Factors</H4>
71
72 <DL>
73 <DT>
74 <TT>time1 <I>time</I></TT></DT>
75
76 <DD>
77 Specifies the time offset calibration factor, in seconds and fraction,
78 with default 0.0.</DD>
79
80 <DT>
81 <TT>time2 <I>time</I></TT></DT>
82
83 <DD>
84 Not used by this driver.</DD>
85
86 <DT>
87 <TT>stratum <I>number</I></TT></DT>
88
89 <DD>
90 Specifies the driver stratum, in decimal from 0 to 15, with default 0.</DD>
91
92 <DT>
93 <TT>refid <I>string</I></TT></DT>
94
95 <DD>
96 Specifies the driver reference identifier, an ASCII string from one to
97 four characters, with default <TT>WWV</TT>.</DD>
98
99 <DT>
100 <TT>flag1 0 | 1</TT></DT>
101
102 <DD>
103 Not used by this driver.</DD>
104
105 <DT>
106 <TT>flag2 0 | 1</TT></DT>
107
108 <DD>
109 Not used by this driver.</DD>
110
111 <DT>
112 <TT>flag3 0 | 1</TT></DT>
113
114 <DD>
115 Not used by this driver.</DD>
116
117 <DT>
118 <TT>flag4 0 | 1</TT></DT>
119
120 <DD>
121 Not used by this driver.</DD>
122 </DL>
123 Additional Information
124
125 <P><A HREF="refclock.htm">Reference Clock Drivers</A>&nbsp;
126 <HR>
127 <ADDRESS>
128 David L. Mills (mills@udel.edu)</ADDRESS>
129
130 </BODY>
131 </HTML>