xref: /freebsd/contrib/ntp/html/drivers/driver35.html (revision 5ca8e32633c4ffbbcd6762e5888b6a4ba0708c6c)
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>Conrad parallel port radio clock</title>
8		<link href="scripts/style.css" type="text/css" rel="stylesheet">
9	</head>
10
11	<body>
12		<h3>Conrad parallel port radio clock</h3>
13<p>Last update:
14  <!-- #BeginDate format:En2m -->21-Oct-2010  23:44<!-- #EndDate -->
15  UTC</p>
16		<hr>
17		<h4>Synopsis</h4>
18		<p>Address: 127.127.35.<i>u</i><br>
19			Reference ID: <tt>PCF</tt><br>
20			Driver ID: <tt>PCF</tt><br>
21			Parallel Port: <tt>/dev/pcfclocks/<i>u</i></tt> or <tt>/dev/pcfclock<i>u</i></tt></p>
22		<h4>Description</h4>
23		<p>This driver supports the parallel port radio clock sold by <a href="http://www.conrad-electronic.com/">Conrad Electronic</a> under order numbers 967602 and 642002. This clock is put between a parallel port and your printer. It receives the legal German time, which is either CET or CEST, from the DCF77 transmitter and uses it to set its internal quartz clock. The DCF77 transmitter is located near to Frankfurt/Main and covers a radius of more than 1500 kilometers.</p>
24		<p>The pcfclock device driver is required in order to use this reference clock driver. Currently device drivers for <a href="http://home.pages.de/%7evoegele/pcf.html">Linux</a> and <a href="http://schumann.cx/pcfclock/">FreeBSD</a> are available.</p>
25		<p>This driver uses C library functions to convert the received timecode to UTC and thus requires that the local timezone be CET or CEST. If your server is not located in Central Europe you have to set the environment variable TZ to CET before starting <tt>ntpd</tt>.</p>
26		<h4>Monitor Data</h4>
27		<p>Each timecode is written to the <tt>clockstats</tt> file in the format <tt>YYYY MM DD HH MI SS</tt>.</p>
28		<h4>Fudge Factors</h4>
29		<dl>
30			<dt><tt>time1 <i>time</i></tt>
31			<dd>Specifies the time offset calibration factor, in seconds and fraction, with default 0.1725.
32			<dt><tt>time2 <i>time</i></tt>
33			<dd>Not used by this driver.
34			<dt><tt>stratum <i>number</i></tt>
35			<dd>Specifies the driver stratum, in decimal from 0 to 15, with default 0.
36			<dt><tt>refid <i>string</i></tt>
37			<dd>Specifies the driver reference identifier, an ASCII string from one to four characters, with default <tt>PCF</tt>.
38			<dt><tt>flag1 0 | 1</tt>
39			<dd>Not used by this driver.
40			<dt><tt>flag2 0 | 1</tt>
41			<dd>If set to 1, the radio clock's synchronisation status bit is ignored, ie the timecode is used without a check.
42			<dt><tt>flag3 0 | 1</tt>
43			<dd>Not used by this driver.
44			<dt><tt>flag4 0 | 1</tt>
45			<dd>Not used by this driver.
46		</dl>
47		<hr>
48		<script type="text/javascript" language="javascript" src="scripts/footer.txt"></script>
49	</body>
50
51</html>
52