Initial import from FreeBSD RELENG_4:
[dragonfly.git] / contrib / ntp / html / driver38.htm
1 <!doctype html public "-//w3c//dtd html 4.0 transitional//en">
2 <html>
3 <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
5    <title>hopf clock drivers by ATLSoft</title>
6 </head>
7 <body text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#800080" alink="#FF0000">
8
9 <h1>
10 <font face="Arial"><i><blink><font size="5">hopf</font></blink></i><font size="+2">
11 </font><font size="3">Serial Line Receivers (6021 and&nbsp; kompatible)</font></font></h1>
12 <hr>
13
14 <h2>
15 <font size=+1>Synopsis</font></h2>
16
17 <table border="0" cellpadding cellspacing width="100%">
18   <tr>
19     <td>
20
21 <table border="0" cellpadding="3" bgcolor="#C0C0C0">
22 <tr>
23 <td height="21">
24 <div align=right><tt>Address:&nbsp;&nbsp;</tt></div>
25 </td>
26
27 <td><b>127.127.38.<i>X</i></b></td>
28 </tr>
29
30 <tr>
31 <td height="1">
32 <div align=right><tt>Reference ID:&nbsp;&nbsp;</tt></div>
33 </td>
34
35 <td height="1"><a NAME="REFID"></a><b>.hopf. </b>(default)<b>, GPS, DCF</b></td>
36 </tr>
37
38 <tr>
39 <td height="21">
40 <div align=right><tt>Driver ID:&nbsp;&nbsp;</tt></div>
41 </td>
42
43 <td height="21"><b>HOPF_S</b></td>
44 </tr>
45
46 <tr>
47 <td height="16">
48 <div align=right><tt>Serial Port:&nbsp;&nbsp;</tt></div>
49 </td>
50
51 <td height="16"><b>/dev/hopfclock<i>X</i></b></td>
52 </tr>
53
54 <tr>
55 <td height="23">
56 <div align=right><tt><font size=+1>Serial I/O</font>:&nbsp;&nbsp;</tt></div>
57 </td>
58
59 <td height="23"><b>9600 baud, 8-bits, 1-stop, no parity</b></td>
60 </tr>
61 </table>
62
63     </td>
64     <td align="center"><img border="0" src="pic/fg6021.gif" width="238" height="207"></td>
65   </tr>
66 </table>
67
68 <hr>
69
70 <h2>
71 <font size=+1>Description</font></h2>
72 The <b>refclock_hopf_serial</b> driver supports <a href="http://www.hopf.com">hopf
73 electronic receivers</a> with serial Interface kompatibel 6021.
74 <br>Additional software and information about the software drivers is available
75 from: <a href="http://www.ATLSoft.de/ntp">http://www.ATLSoft.de/ntp</a>.
76 <br>Latest NTP driver source, executables and documentation is maintained
77 at: <a href="http://www.ATLSoft.de/ntp">http://www.ATLSoft.de/ntp</a>
78 <hr>
79 <h2>
80 <font size=+1>Operating System Compatibility</font></h2>
81 <p align="left">
82 The hopf clock driver has been tested on the following software and hardware
83 platforms:
84 <br>&nbsp;<table bgcolor="#C0C0C0">
85 <tr>
86 <td VALIGN=CENTER WIDTH="23%" nowrap>
87   <p align="left"><b>Platform</b></p>
88 </td>
89
90 <td VALIGN=CENTER nowrap>
91   <p align="left"><b>Operating System</b></p>
92 </td>
93
94 </tr>
95
96 <tr>
97 <td VALIGN=CENTER WIDTH="23%" nowrap>
98   <p align="left">i386 (PC)&nbsp;</p>
99 </td>
100
101 <td VALIGN=CENTER nowrap>
102   <p align="left">Linux</p>
103 </td>
104
105 </tr>
106
107 <tr>
108 <td nowrap>
109   <p align="left">i386 (PC)&nbsp;</p>
110   </td>
111
112 <td nowrap>
113   <p align="left">Windows NT</p>
114   </td>
115
116 </tr>
117
118 <tr>
119 <td nowrap>
120   <p align="left">i386 (PC)&nbsp;</p>
121 </td>
122
123 <center>
124
125 <td nowrap>Windows 2000</td>
126
127 </tr>
128
129 </table></center>
130
131 <hr>
132
133 <h2>
134 <font size=+1>O/S Serial Port Configuration</font></h2>
135 The driver attempts to open the device <b><tt><a href="#REFID">/dev/hopfclock<i>X</i></a></tt></b>
136 where <i><b>X</b></i> is the NTP refclock unit number as defined by the
137 LSB of the refclock address.&nbsp; Valid refclock unit numbers are 0 -
138 3.
139 <p>The user is expected to provide a symbolic link to an available serial
140 port device.&nbsp; This is typically performed by a command such as:
141 <blockquote><tt>ln -s /dev/ttyS0 /dev/hopfclock0</tt></blockquote>
142 Windows NT does not support symbolic links to device files.&nbsp;<br>
143 <b> COMx</b>:
144 is used by the driver, based on the refclock unit number, where <b> unit 1</b>
145 corresponds to <b> COM1</b>: and <b> unit 3</b> corresponds to <b>COM3</b>:
146 <br>&nbsp;
147 <hr>
148
149 <h2>
150 <font size=+1>Fudge Factors</font></h2>
151
152 <dl>
153 <dt>
154 <b>
155 <a NAME="time1"></a><tt><font size=+1><a href="#Configuration">time1 <i>time</i></a></font></tt></b></dt>
156
157 <dd>
158 Specifies the time offset calibration factor, in seconds and fraction,
159 with default 0.0. Should be set to
160 20 milliseconds to correct serial line and operating system delays incurred
161 in capturing time stamps from the synchronous packets.</dd>
162
163 <dt>
164 <tt><font size=+1><a href="#REFID"><b>refid <i>string</i></b></a></font></tt></dt>
165
166 <dd>
167 Specifies the driver reference identifier, <b>GPS </b><i>or</i> <b> DCF</b>.</dd>
168
169 <dt>
170 <tt><font size=+1><b>flag1 0
171 | 1</b></font></tt></dt>
172
173 <dd>
174 When set to 1, driver sync's even if only crystal driven.</dd>
175 </dl>
176
177 <hr>
178
179 <h2>
180 <a NAME="DataFormat"></a><font size=+1>Data Format</font></h2>
181 <p>as specified in clock manual under pt. <u>[ <span lang="EN-GB" style="font-size:10.0pt;font-family:
182 Arial;mso-fareast-font-family:&quot;Times New Roman&quot;;mso-bidi-font-family:&quot;Times New Roman&quot;;
183 mso-ansi-language:EN-GB;mso-fareast-language:DE;mso-bidi-language:AR-SA"><b>Data
184 String for NTP</b> ( <b><i>Network Time Protocol </i></b>) </span>]</u></p>
185 <hr>
186 <h3>Questions or Comments:</h3>
187 <p><a href="mailto:altmeier@atlsoft.de">Bernd Altmeier</a><a href="http://www.ATLSoft.de"><br>
188 Ing.-B\92ro f\92r Software www.ATLSoft.de</a><p>(last updated 02/28/2001)
189 <br>&nbsp;
190 </body>
191 </html>