contrib/ntp/html/driver19.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>Heath WWV/WWVH Receiver
   6 </TITLE>
   7 </HEAD>
   8 <BODY>
   9
  10 <H3>
  11 Heath WWV/WWVH Receiver</H3>
  12
  13 <HR>
  14 <H4>
  15 Synopsis</H4>
  16 Address: 127.127.19.<I>u</I>
  17 <BR>Reference ID: <TT>WWV</TT>
  18 <BR>Driver ID: <TT>WWV_HEATH</TT>
  19 <BR>Serial Port: <TT>/dev/heath<I>u</I></TT>; 1200 baud, 8-bits, no parity
  20 <BR>Features: <TT>tty_clk</TT>
  21 <BR>Requires: <TT>/usr/include/sys/termios.h</TT> header file with modem
  22 control
  23 <H4>
  24 Description</H4>
  25 This driver supports the Heath GC-1000 Most Accurate Clock, with RS232C
  26 Output Accessory. This is a WWV/WWVH receiver somewhat less robust than
  27 other supported receivers. Its claimed accuracy is 100 ms when actually
  28 synchronized to the broadcast signal, but this doesn't happen even most
  29 of the time, due to propagation conditions, ambient noise sources, etc.
  30 When not synchronized, the accuracy is at the whim of the internal clock
  31 oscillator, which can wander into the sunset without warning. Since the
  32 indicated precision is 100 ms, expect a host synchronized only to this
  33 thing to wander to and fro, occasionally being rudely stepped when the
  34 offset exceeds the default CLOCK_MAX of 128 ms.
  35
  36 <P>The internal DIPswitches should be set to operate at 1200 baud in MANUAL
  37 mode and the current year. The external DIPswitches should be set to GMT
  38 and 24-hour format. It is very important that the year be set correctly
  39 in the DIPswitches; otherwise, the day of year will be incorrect after
  40 28 April of a normal or leap year.
  41
  42 <P>In MANUAL mode the clock responds to a rising edge of the request to
  43 send (RTS) modem control line by sending the timecode. Therefore, it is
  44 necessary that the operating system implement the <TT>TIOCMBIC</TT> and
  45 <TT>TIOCMBIS</TT> ioctl system calls and <TT>TIOCM_RTS</TT> control bit.
  46 Present restrictions require the use of a POSIX-compatible programming
  47 interface, although other interfaces may work as well.
  48
  49 <P>The clock message consists of 23 ASCII printing characters in the following
  50 format:
  51 <PRE>hh:mm:ss.f&nbsp;&nbsp;&nbsp;&nbsp; dd/mm/yr&lt;cr>
  52
  53 hh:mm:ss.f = hours, minutes, seconds
  54 f = deciseconds ('?' when out of spec)
  55 dd/mm/yr = day, month, year</PRE>
  56 The alarm condition is indicated by '?', rather than a digit, at A. Note
  57 that 0?:??:??.? is displayed before synchronization is first established
  58 and hh:mm:ss.? once synchronization is established and then lost again
  59 for about a day.
  60
  61 <P>A fudge time1 value of .07 s appears to center the clock offset residuals.
  62 <H4>
  63 Fudge Factors</H4>
  64
  65 <DL>
  66 <DT>
  67 <TT>time1 <I>time</I></TT></DT>
  68
  69 <DD>
  70 Specifies the time offset calibration factor, in seconds and fraction,
  71 with default 0.0.</DD>
  72
  73 <DT>
  74 <TT>time2 <I>time</I></TT></DT>
  75
  76 <DD>
  77 Not used by this driver.</DD>
  78
  79 <DT>
  80 <TT>stratum <I>number</I></TT></DT>
  81
  82 <DD>
  83 Specifies the driver stratum, in decimal from 0 to 15, with default 0.</DD>
  84
  85 <DT>
  86 <TT>refid <I>string</I></TT></DT>
  87
  88 <DD>
  89 Specifies the driver reference identifier, an ASCII string from one to
  90 four characters, with default <TT>WWV</TT>.</DD>
  91
  92 <DT>
  93 <TT>flag1 0 | 1</TT></DT>
  94
  95 <DD>
  96 Not used by this driver.</DD>
  97
  98 <DT>
  99 <TT>flag2 0 | 1</TT></DT>
 100
 101 <DD>
 102 Not used by this driver.</DD>
 103
 104 <DT>
 105 <TT>flag3 0 | 1</TT></DT>
 106
 107 <DD>
 108 Not used by this driver.</DD>
 109
 110 <DT>
 111 <TT>flag4 0 | 1</TT></DT>
 112
 113 <DD>
 114 Not used by this driver</DD>
 115 </DL>
 116 Additional Information
 117
 118 <P><A HREF="refclock.htm">Reference Clock Drivers</A>&nbsp;
 119 <HR>
 120 <ADDRESS>
 121 David L. Mills (mills@udel.edu)</ADDRESS>
 122
 123 </BODY>
 124 </HTML>