Initial import from FreeBSD RELENG_4:
[dragonfly.git] / contrib / ntp / html / driver35.htm
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
2 <html>
3 <head>
4 <title>Conrad parallel port radio clock</title>
5 </head>
6 <body>
7
8 <h3>Conrad parallel port radio clock</h3>
9 <hr>
10
11 <h4>Synopsis</h4>
12
13 <p>Address: 127.127.35.<i>u</i><br>
14 Reference ID: <tt>PCF</tt><br>
15 Driver ID: <tt>PCF</tt><br>
16 Parallel Port: <tt>/dev/pcfclocks/<i>u</i></tt> or <tt>/dev/pcfclock<i>u</i></tt>
17 </p>
18
19 <h4>Description</h4>
20
21 <p>This driver supports the parallel port radio clock sold by
22 <a href="http://www.conrad-electronic.com/">Conrad Electronic</a> under
23 order numbers 967602 and 642002.  This clock is put between a parallel
24 port and your printer.  It receives the legal German time, which is
25 either CET or CEST, from the DCF77 transmitter and uses it to set its
26 internal quartz clock.  The DCF77 transmitter is located near to
27 Frankfurt/Main and covers a radius of more than 1500 kilometers.
28
29 <p>The pcfclock device driver is required in order to use this
30 reference clock driver. Currently device drivers for
31 <a href="http://home.pages.de/~voegele/pcf.html">Linux</a> and
32 <a href="http://schumann.cx/pcfclock/">FreeBSD</a> are available.</p>
33
34 <p>This driver uses C library functions to convert the received
35 timecode to UTC and thus requires that the local timezone be CET or
36 CEST.  If your server is not located in Central Europe you have to set
37 the environment variable TZ to CET before starting <tt>ntpd</tt>.
38 </p>
39
40 <h4>Monitor Data</h4>
41
42 <p>Each timecode is written to the <tt>clockstats</tt> file in the format
43 <tt>YYYY MM DD HH MI SS</tt>.</p>
44
45 <h4>Fudge Factors</h4>
46
47 <dl>
48 <dt><tt>time1 <i>time</i></tt></dt>
49 <dd>Specifies the time offset calibration factor, in seconds and fraction,
50 with default 0.1725.</dd>
51
52 <dt><tt>time2 <i>time</i></tt></dt>
53 <dd>Not used by this driver.</dd>
54
55 <dt><tt>stratum <i>number</i></tt></dt>
56 <dd>Specifies the driver stratum, in decimal from 0 to 15, with default 0.
57 </dd>
58
59 <dt><tt>refid <i>string</i></tt></dt>
60 <dd>Specifies the driver reference identifier, an ASCII string from one to
61 four characters, with default <tt>PCF</tt>.</dd>
62
63 <dt><tt>flag1 0 | 1</tt></dt>
64 <dd>Not used by this driver.</dd>
65
66 <dt><tt>flag2 0 | 1</tt></dt>
67 <dd>If set to 1, the radio clock's synchronisation status bit is
68 ignored, ie the timecode is used without a check.</dd>
69
70 <dt><tt>flag3 0 | 1</tt></dt>
71 <dd>Not used by this driver.</dd>
72
73 <dt><tt>flag4 0 | 1</tt></dt>
74 <dd>Not used by this driver.</dd>
75 </dl>
76
77 <hr>
78 <address>Andreas Voegele &lt;voegelas@users.sourceforge.net&gt;</address>
79 </body>
80 </html>