driver34.html revision 182007
1182007Sroberto<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2132451Sroberto
3132451Sroberto<html>
4132451Sroberto
5182007Sroberto	<head>
6182007Sroberto		<title>Ultralink Clock</title>
7182007Sroberto		<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
8182007Sroberto		<link <link href="scripts/style.css" type="text/css" rel="stylesheet"> </HEAD> <BODY> <H3> Ultralink Clock</H3>
9182007Sroberto		<hr>
10182007Sroberto		<h4>Synopsis</h4>
11182007Sroberto			Address: 127.127.34.<i>u</i><br>
12182007Sroberto			Reference ID: <tt>WWVB</tt><br>
13182007Sroberto			Driver ID: <tt>ULINK</tt><br>
14182007Sroberto			Serial Port: <tt>/dev/wwvb<i>u</i></tt>; 9600 bps, 8-bits, no parity<br>
15182007Sroberto		<br>
16182007Sroberto			Features: <tt>(none)</tt>
17182007Sroberto		<h4>Description</h4>
18182007Sroberto		<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>
19182007Sroberto				Leap second and quality are supported.</p>
20182007Sroberto		<p>Most of this code is originally from refclock_wwvb.c with thanks. Any mistakes are mine. Any improvements are welcome.</p>
21182007Sroberto		<hr>
22182007Sroberto		<pre>  The Model 325 timecode format is:
23132451Sroberto 
24182007Sroberto   &lt;cr&gt;&lt;lf&gt;RQ_1C00LYYYY+DDDUTCS_HH:MM:SSL+5
25182007Sroberto 
26182007Sroberto  where:
27182007Sroberto 
28182007Sroberto  R = Signal readability indicator, ranging from R1 to R5  
29182007Sroberto  Q	R1 is unreadable, R5 is best reception
30182007Sroberto  _ = Space
31182007Sroberto  1 = prev. received data bit, values: 0, 1 ,M or ? unknown
32182007Sroberto  C = Signal reception from (C)olorado or (H)awaii
33182007Sroberto  0 = Hours since last WWVB time and flag code update, values
34182007Sroberto  0	00 to 99 (hopefully always 00)
35182007Sroberto  L = HEX A5 if receiver is locked to WWVB, Space if not
36182007Sroberto  YYYY = Year from 2000 to 2099
37182007Sroberto  + = '+' if current year is a leap year, else ' '
38182007Sroberto  DDD = current day in the year from 1 to 365/366
39182007Sroberto  UTC = timezone (always UTC)
40182007Sroberto  S = Daylight savings indicator, (S)TD, (D)ST, (O) transition
41182007Sroberto      into DST, (I) transition out of DST
42182007Sroberto  _ = Space
43182007Sroberto  HH = UTC hour 0 to 23
44182007Sroberto  : = Time delimiter, ':' if synced, Space if not
45182007Sroberto  MM = Minutes of current hour from 0 to 59
46182007Sroberto  : = Time delimiter, ':' if synced, Space if not
47182007Sroberto  SS = Seconds of current minute from 0 to 59
48182007Sroberto  mm = 10's milliseconds of the current second from 00 to 99
49182007Sroberto  L  = Leap second pending at end of month, (I)nsert, (D)elete
50182007Sroberto       or Space
51182007Sroberto  +5 = UT1 correction, +/- .1 sec increments
52182007Sroberto </pre>
53182007Sroberto		<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>
54182007Sroberto		<hr>
55182007Sroberto		<pre>  The Model 320 timecode format is:
56182007Sroberto 
57132451Sroberto   &lt;cr&gt;&lt;lf&gt;SQRYYYYDDD+HH:MM:SS.mmLT&lt;cr&gt;
58132451Sroberto 
59132451Sroberto  where:
60132451Sroberto 
61132451Sroberto  S = 'S' -- sync'd in last hour, '0'-'9' - hours x 10 since last update, else '?'
62132451Sroberto  Q = Number of correlating time-frames, from 0 to 5
63132451Sroberto  R = 'R' -- reception in progress, 'N' -- Noisy reception, ' ' -- standby mode
64132451Sroberto  YYYY = year from 1990 to 2089
65132451Sroberto  DDD = current day from 1 to 366
66132451Sroberto  + = '+' if current year is a leap year, else ' '
67132451Sroberto  HH = UTC hour 0 to 23
68132451Sroberto  MM = Minutes of current hour from 0 to 59
69132451Sroberto  SS = Seconds of current minute from 0 to 59
70132451Sroberto  mm = 10's milliseconds of the current second from 00 to 99
71132451Sroberto  L  = Leap second pending at end of month -- 'I' = inset, 'D'=delete
72132451Sroberto  T  = DST &lt;-&gt; STD transition indicators
73132451Sroberto </pre>
74182007Sroberto		<p>Note that this driver does not do anything with the T flag.</p>
75182007Sroberto		<p>The M320 also has a 'U' command which returns UT1 correction information. It is not used in this driver.</p>
76182007Sroberto		<hr>
77182007Sroberto		<pre>  The Model 33x timecode format is:
78132451Sroberto
79132451Sroberto    S9+D 00 YYYY+DDDUTCS HH:MM:SSl+5
80132451Sroberto
81132451Sroberto  Where:
82132451Sroberto
83132451Sroberto  S =    sync indicator S insync N not in sync
84132451Sroberto         the sync flag is WWVB decoder sync
85132451Sroberto         nothing to do with time being correct
86132451Sroberto  9+ =   signal level 0 thru 9+ If over 9 indicated as 9+
87132451Sroberto  D  =   data bit ( fun to watch but useless ;-)
88132451Sroberto  space
89132451Sroberto  00 =   hours since last GOOD WWVB frame sync
90132451Sroberto  space
91132451Sroberto  YYYY = current year
92132451Sroberto  +  =   leap year indicator
93132451Sroberto  DDD =  day of year
94132451Sroberto  UTC =  timezone (always UTC)
95132451Sroberto  S  =   daylight savings indicator
96132451Sroberto  space
97132451Sroberto  HH  =  hours
98132451Sroberto  :  =   This is the REAL in sync indicator (: = insync)
99132451Sroberto  MM  =  minutes
100132451Sroberto  :  =   : = in sync ? = NOT in sync
101132451Sroberto  SS  =  seconds
102132451Sroberto  L  =   leap second flag
103132451Sroberto  +5 =   UT1 correction (sign + digit ))
104132451Sroberto </pre>
105182007Sroberto		<p>This driver ignores UT1 correction,DST indicator,Leap year and signal level.</p>
106182007Sroberto		<hr>
107182007Sroberto		<h4>Fudge factors</h4>
108182007Sroberto		<p>flag1 polling enable (1=poll 0=no poll)</p>
109182007Sroberto		<hr>
110182007Sroberto		<address><a href="mailto:frank.migge@oracle.com">mail</a></address>
111182007Sroberto		<!-- hhmts start -->Last modified: Mon Mar 8 10:12:08 PST 2004<!-- hhmts end -->
112182007Sroberto		<hr>
113182007Sroberto		<script type="text/javascript" language="javascript" src="Ultralink Clock_files/footer.txt"></script>
114182007Sroberto		</BODY>
115182007Sroberto	</head>
116132451Sroberto
117132451Sroberto</html>