xref: /freebsd/contrib/ntp/html/drivers/driver34.html (revision 9f44a47fd07924afc035991af15d84e6585dea4f)
1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
3<html>
4
5	<head>
6		<meta http-equiv="content-type" content="text/html;charset=iso-8859-1">
7		<title>Ultralink Clock</title>
8		<link href="scripts/style.css" type="text/css" rel="stylesheet">
9	</head>
10
11	<body>
12		<h3>Ultralink Clock</h3>
13<p>Last update:
14  <!-- #BeginDate format:En2m -->31-Dec-2007  19:43<!-- #EndDate -->
15  UTC</p>
16		<hr>
17		<h4>Synopsis</h4>
18		<p>Address: 127.127.34.<i>u</i><br>
19				Reference ID: <tt>WWVB</tt><br>
20				Driver ID: <tt>ULINK</tt><br>
21				Serial Port: <tt>/dev/wwvb<i>u</i></tt>; 9600 bps, 8-bits, no parity<br>
22				Features: <tt>(none)</tt></p>
23		<h4>Description</h4>
24		<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.Leap second and quality are supported. Most of this code is originally from refclock_wwvb.c with thanks. Any mistakes are mine. Any improvements are welcome.</p>
25		<h4>Model 325 timecode format</h4>
26		<p><tt>&lt;cr&gt;&lt;lf&gt;RQ_1C00LYYYY+DDDUTCS_HH:MM:SSL+5</tt></p>
27		<p>R = Signal readability indicator, ranging from R1 to R5 Q R1 is unreadable, R5 is best reception<br>
28				_ = Space<br>
29			1 = prev. received data bit, values: 0, 1 ,M or ? unknown
30		C = Signal reception from (C)olorado or (H)awaii 0 = Hours since last WWVB time and flag code update, values 0 00 to 99 (hopefully always 00)<br>
31				L = HEX A5 if receiver is locked to WWVB, Space if not<br>
32				YYYY = Year from 2000 to 2099<br>
33				+ = '+' if current year is a leap year, else ' '<br>
34				DDD = current day in the year from 1 to 365/366<br>
35				UTC = timezone (always UTC)<br>
36				S = Daylight savings indicator, (S)TD, (D)ST, (O) transition into DST, (I) transition out of DST<br>
37				_ = Space<br>
38				HH = UTC hour 0 to 23<br>
39				: = Time delimiter, ':' if synced, Space if not<br>
40		   MM = Minutes of current hour from 0 to 59<br>
41				: = Time delimiter, ':' if synced, Space if not<br>
42				SS = Seconds of current minute from 0 to 59<br>
43				mm = 10's milliseconds of the current second from 00 to 99<br>
44				L = Leap second pending at end of month, (I)nsert, (D)elete or Space<br>
45				+5 = UT1 correction, +/- .1 sec increments</p>
46		<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>
47		<h4>Model 320 timecode format</h4>
48		<p><tt>&lt;cr&gt;&lt;lf&gt;SQRYYYYDDD+HH:MM:SS.mmLT&lt;cr&gt;</tt></p>
49		<p>S = 'S' -- sync'd in last hour, '0'-'9' - hours x 10 since last update, else '?'<br>
50				Q = Number of correlating time-frames, from 0 to 5<br>
51				R = 'R' -- reception in progress,'N' -- Noisy reception, ' ' -- standby mode<br>
52				YYYY = year from 1990 to 2089<br>
53				DDD = current day from 1 to 366 + = '+' if current year is a leap year, else ' '<br>
54				HH = UTC hour 0 to 23<br>
55				MM = Minutes of current hour from 0 to 59<br>
56				SS = Seconds of current minute from 0 to 59<br>
57				mm = 10's milliseconds of the current second from 00 to 99<br>
58				L = Leap second pending at end of month -- 'I' = insert, 'D'=delete<br>
59			T = DST &lt;-&gt; STD transition indicators</p>
60		<p>Note that this driver does not do anything with the T flag. The M320 also has a 'U' command which returns UT1 correction information. It is not used in this driver.</p>
61		<h4>Model 33x timecode format</h4>
62		<p><tt>S9+D 00 YYYY+DDDUTCS HH:MM:SSl+5</tt></p>
63		<p>S = sync indicator S insync N not in sync the sync flag is WWVB decoder sync nothing to do with time being correct </p>
64		<p>9+ = signal level 0 thru 9+ If over 9 indicated as 9<br>
65				D = data bit (fun to watch but useless ;-) space<br>
66				00 = hours since last GOOD WWVB frame sync space<br>
67				YYYY = current year + = leap year indicator<br>
68				DDD = day of year<br>
69				UTC = timezone (always UTC)<br>
70				S = daylight savings indicator space<br>
71				HH = hours : = This is the REAL in sync indicator (: = insync)<br>
72				MM = minutes : = : = in sync ? = NOT in sync<br>
73				SS = seconds<br>
74				L = leap second flag<br>
75				+5 = UT1 correction (sign + digit ))</p>
76		<p>This driver ignores UT1 correction, DST indicator,Leap year and signal level.</p>
77		<h4>Fudge factors</h4>
78		<p>flag1 polling enable (1=poll 0=no poll)</p>
79		<hr>
80		<script type="text/javascript" language="javascript" src="scripts/footer.txt"></script>
81	</body>
82</html>
83