xref: /freebsd/contrib/ntp/html/drivers/driver38.html (revision aa24f48b361effe51163877d84f1b70d32b77e04)
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>hopf clock drivers by ATLSoft</title>
8		<link href="scripts/style.css" type="text/css" rel="stylesheet">
9	</head>
10
11	<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
12		<h1><font face="Arial"><i><blink><font size="5">hopf</font></blink></i><font size="+2"> </font><font size="3">Serial Line Receivers (6021 and&nbsp; kompatible)</font></font></h1>
13<p>Last update:
14  <!-- #BeginDate format:En2m -->21-Oct-2010  23:44<!-- #EndDate -->
15  UTC</p>
16		<hr>
17		<h2><font size="+1">Synopsis</font></h2>
18		<table width="100%">
19			<tr>
20				<td>
21					<table bgcolor="#C0C0C0">
22						<tr>
23							<td height="21">
24								<div align="right">
25									<tt>Address:&nbsp;&nbsp;</tt></div>
26							</td>
27							<td><b>127.127.38.<i>X</i></b></td>
28						</tr>
29						<tr>
30							<td height="1">
31								<div align="right">
32									<tt>Reference ID:&nbsp;&nbsp;</tt></div>
33							</td>
34							<td height="1"><a name="REFID"></a><b>.hopf. </b>(default)<b>, GPS, DCF</b></td>
35						</tr>
36						<tr>
37							<td height="21">
38								<div align="right">
39									<tt>Driver ID:&nbsp;&nbsp;</tt></div>
40							</td>
41							<td height="21"><b>HOPF_S</b></td>
42						</tr>
43						<tr>
44							<td height="16">
45								<div align="right">
46									<tt>Serial Port:&nbsp;&nbsp;</tt></div>
47							</td>
48							<td height="16"><b>/dev/hopfclock<i>X</i></b></td>
49						</tr>
50						<tr>
51							<td height="23">
52								<div align="right">
53									<tt><font size="+1">Serial I/O</font>:&nbsp;&nbsp;</tt></div>
54							</td>
55							<td height="23"><b>9600 baud, 8-bits, 1-stop, no parity</b></td>
56						</tr>
57					</table>
58				</td>
59				<td align="center"><img src="../pic/fg6021.gif" alt="gif" height="207" width="238" border="0"></td>
60			</tr>
61		</table>
62		<hr>
63		<h2><font size="+1">Description</font></h2>
64		<p>The <b>refclock_hopf_serial</b> driver supports <a href="http://www.hopf.com">hopf electronic receivers</a> with serial Interface kompatibel 6021.<br>
65		</p>
66		<p>Additional software and information about the software drivers is available from: <a href="http://www.ATLSoft.de/ntp">http://www.ATLSoft.de/ntp</a>.<br>
67		</p>
68		<p>Latest NTP driver source, executables and documentation is maintained at: <a href="http://www.ATLSoft.de/ntp">http://www.ATLSoft.de/ntp</a></p>
69		<hr>
70		<h2><font size="+1">Operating System Compatibility</font></h2>
71		<p align="left">The hopf clock driver has been tested on the following software and hardware platforms:<br>&nbsp;</p>
72		<table bgcolor="#C0C0C0">
73			<tr>
74				<td valign="CENTER" nowrap width="23%">
75					<p align="left"><b>Platform</b></p>
76				</td>
77				<td valign="CENTER" nowrap>
78					<p align="left"><b>Operating System</b></p>
79				</td>
80			</tr>
81			<tr>
82				<td valign="CENTER" nowrap width="23%">
83					<p align="left">i386 (PC)&nbsp;</p>
84				</td>
85				<td valign="CENTER" nowrap>
86					<p align="left">Linux</p>
87				</td>
88			</tr>
89			<tr>
90				<td nowrap>
91					<p align="left">i386 (PC)&nbsp;</p>
92				</td>
93				<td nowrap>
94					<p align="left">Windows NT</p>
95				</td>
96			</tr>
97			<tr>
98				<td nowrap>
99					<p align="left">i386 (PC)&nbsp;</p>
100				</td>
101				<center>
102					<td nowrap>Windows 2000</td>
103				</center>
104			</tr>
105		</table>
106		<hr>
107		<h2><font size="+1">O/S Serial Port Configuration</font></h2>
108		The driver attempts to open the device <b><tt><a href="#REFID">/dev/hopfclock<i>X</i></a></tt></b> where <i><b>X</b></i> is the NTP refclock unit number as defined by the LSB of the refclock address.&nbsp; Valid refclock unit numbers are 0 - 3.
109		<p>The user is expected to provide a symbolic link to an available serial port device.&nbsp; This is typically performed by a command such as:</p>
110		<blockquote>
111			<tt>ln -s /dev/ttyS0 /dev/hopfclock0</tt></blockquote>Windows NT does not support symbolic links to device files.&nbsp;<br>
112		<b>COMx</b>: is used by the driver, based on the refclock unit number, where <b>unit 1</b> corresponds to <b>COM1</b>: and <b>unit 3</b> corresponds to <b>COM3</b>:<br>&nbsp;
113		<hr>
114		<h2><font size="+1">Fudge Factors</font></h2>
115		<dl>
116			<dt><b><tt><font size="+1">time1 <i>time</i></font></tt></b>
117			<dd>Specifies the time offset calibration factor, in seconds and fraction, with default 0.0. Should be set to 20 milliseconds to correct serial line and operating system delays incurred in capturing time stamps from the synchronous packets.
118			<dt><tt><font size="+1"><a href="#REFID"><b>refid <i>string</i></b></a></font></tt>
119			<dd>Specifies the driver reference identifier, <b>GPS </b><i>or</i> <b>DCF</b>.
120			<dt><tt><font size="+1"><b>flag1 0 | 1</b></font></tt>
121			<dd>When set to 1, driver sync's even if only crystal driven.
122		</dl>
123		<hr>
124		<h2><a name="DataFormat"></a><font size="+1">Data Format</font></h2>
125		<p>as specified in clock manual under pt. <u>[ <span style="font-size:10.0pt;font-family: Arial;mso-fareast-font-family:&quot;Times New Roman&quot;;mso-bidi-font-family:&quot;Times New Roman&quot;; mso-ansi-language:EN-GB;mso-fareast-language:DE;mso-bidi-language:AR-SA" lang="EN-GB"><b>Data String for NTP</b> ( <b><i>Network Time Protocol </i></b>) </span>]</u></p>
126		<hr>
127		<h3>Questions or Comments:</h3>
128		<p><a href="mailto:altmeier@atlsoft.de">Bernd Altmeier</a><a href="http://www.ATLSoft.de"><br>Ing.-B&uuml;ro f&uuml;r Software www.ATLSoft.de</a></p>
129		<hr>
130		<script type="text/javascript" language="javascript" src="scripts/footer.txt"></script>
131	</body>
132
133</html>
134