xref: /freebsd/contrib/ntp/html/drivers/driver34.html (revision 40a8ac8f62b535d30349faf28cf47106b7041b83)
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2
3<html>
4
5	<head>
6		<title>Ultralink Clock</title>
7		<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
8		<link <link href="scripts/style.css" type="text/css" rel="stylesheet"> </HEAD> <BODY> <H3> Ultralink Clock</H3>
9		<hr>
10		<h4>Synopsis</h4>
11			Address: 127.127.34.<i>u</i><br>
12			Reference ID: <tt>WWVB</tt><br>
13			Driver ID: <tt>ULINK</tt><br>
14			Serial Port: <tt>/dev/wwvb<i>u</i></tt>; 9600 bps, 8-bits, no parity<br>
15		<br>
16			Features: <tt>(none)</tt>
17		<h4>Description</h4>
18		<p>This driver supports the Ultralink Model 325 (replacement for Model 320) RS-232 powered WWVB receiver. PDF specs available on <a href="http://www.ulio.com/">http://www.ulio.com/</a>. This driver also supports the Model 320, 330,331,332 decoders in both polled or continous time code mode.<br>
19				Leap second and quality are supported.</p>
20		<p>Most of this code is originally from refclock_wwvb.c with thanks. Any mistakes are mine. Any improvements are welcome.</p>
21		<hr>
22		<pre>  The Model 325 timecode format is:
23
24   &lt;cr&gt;&lt;lf&gt;RQ_1C00LYYYY+DDDUTCS_HH:MM:SSL+5
25
26  where:
27
28  R = Signal readability indicator, ranging from R1 to R5
29  Q	R1 is unreadable, R5 is best reception
30  _ = Space
31  1 = prev. received data bit, values: 0, 1 ,M or ? unknown
32  C = Signal reception from (C)olorado or (H)awaii
33  0 = Hours since last WWVB time and flag code update, values
34  0	00 to 99 (hopefully always 00)
35  L = HEX A5 if receiver is locked to WWVB, Space if not
36  YYYY = Year from 2000 to 2099
37  + = '+' if current year is a leap year, else ' '
38  DDD = current day in the year from 1 to 365/366
39  UTC = timezone (always UTC)
40  S = Daylight savings indicator, (S)TD, (D)ST, (O) transition
41      into DST, (I) transition out of DST
42  _ = Space
43  HH = UTC hour 0 to 23
44  : = Time delimiter, ':' if synced, Space if not
45  MM = Minutes of current hour from 0 to 59
46  : = Time delimiter, ':' if synced, Space if not
47  SS = Seconds of current minute from 0 to 59
48  mm = 10's milliseconds of the current second from 00 to 99
49  L  = Leap second pending at end of month, (I)nsert, (D)elete
50       or Space
51  +5 = UT1 correction, +/- .1 sec increments
52 </pre>
53		<p>Note that Model 325 reports a very similar output like Model 33X series. The driver for this clock is similar to Model 33X behavior. On a unmodified new ULM325 clock, the polling flag (flag1 =1) needs to be set.</p>
54		<hr>
55		<pre>  The Model 320 timecode format is:
56
57   &lt;cr&gt;&lt;lf&gt;SQRYYYYDDD+HH:MM:SS.mmLT&lt;cr&gt;
58
59  where:
60
61  S = 'S' -- sync'd in last hour, '0'-'9' - hours x 10 since last update, else '?'
62  Q = Number of correlating time-frames, from 0 to 5
63  R = 'R' -- reception in progress, 'N' -- Noisy reception, ' ' -- standby mode
64  YYYY = year from 1990 to 2089
65  DDD = current day from 1 to 366
66  + = '+' if current year is a leap year, else ' '
67  HH = UTC hour 0 to 23
68  MM = Minutes of current hour from 0 to 59
69  SS = Seconds of current minute from 0 to 59
70  mm = 10's milliseconds of the current second from 00 to 99
71  L  = Leap second pending at end of month -- 'I' = inset, 'D'=delete
72  T  = DST &lt;-&gt; STD transition indicators
73 </pre>
74		<p>Note that this driver does not do anything with the T flag.</p>
75		<p>The M320 also has a 'U' command which returns UT1 correction information. It is not used in this driver.</p>
76		<hr>
77		<pre>  The Model 33x timecode format is:
78
79    S9+D 00 YYYY+DDDUTCS HH:MM:SSl+5
80
81  Where:
82
83  S =    sync indicator S insync N not in sync
84         the sync flag is WWVB decoder sync
85         nothing to do with time being correct
86  9+ =   signal level 0 thru 9+ If over 9 indicated as 9+
87  D  =   data bit ( fun to watch but useless ;-)
88  space
89  00 =   hours since last GOOD WWVB frame sync
90  space
91  YYYY = current year
92  +  =   leap year indicator
93  DDD =  day of year
94  UTC =  timezone (always UTC)
95  S  =   daylight savings indicator
96  space
97  HH  =  hours
98  :  =   This is the REAL in sync indicator (: = insync)
99  MM  =  minutes
100  :  =   : = in sync ? = NOT in sync
101  SS  =  seconds
102  L  =   leap second flag
103  +5 =   UT1 correction (sign + digit ))
104 </pre>
105		<p>This driver ignores UT1 correction,DST indicator,Leap year and signal level.</p>
106		<hr>
107		<h4>Fudge factors</h4>
108		<p>flag1 polling enable (1=poll 0=no poll)</p>
109		<hr>
110		<address><a href="mailto:frank.migge@oracle.com">mail</a></address>
111		<!-- hhmts start -->Last modified: Mon Mar 8 10:12:08 PST 2004<!-- hhmts end -->
112		<hr>
113		<script type="text/javascript" language="javascript" src="Ultralink Clock_files/footer.txt"></script>
114		</BODY>
115	</head>
116
117</html>