xref: /freebsd/contrib/ntp/html/drivers/driver26.html (revision ea906c4152774dff300bb26fbfc1e4188351c89a)
19c2daa00SOllivier Robert<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
29c2daa00SOllivier Robert
39c2daa00SOllivier Robert<html>
49c2daa00SOllivier Robert
59c2daa00SOllivier Robert    <head>
69c2daa00SOllivier Robert        <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
79c2daa00SOllivier Robert        <meta name="GENERATOR" content="Mozilla/4.01 [en] (Win95; I) [Netscape]">
8ea906c41SOllivier Robert        <title>Hewlett Packard 58503A GPS Receiver and HP Z3801A</title>
9ea906c41SOllivier Robert        <link href="scripts/style.css" type="text/css" rel="stylesheet">
109c2daa00SOllivier Robert    </head>
119c2daa00SOllivier Robert
129c2daa00SOllivier Robert    <body>
13ea906c41SOllivier Robert        <h3>Hewlett Packard 58503A GPS Receiver and HP Z3801A</h3>
149c2daa00SOllivier Robert        <hr>
159c2daa00SOllivier Robert        <h4>Synopsis</h4>
169c2daa00SOllivier Robert        <p>Address: 127.127.26.<i>u</i><br>
179c2daa00SOllivier Robert            Reference ID: <tt>GPS</tt><br>
189c2daa00SOllivier Robert            Driver ID: <tt>GPS_HP</tt><br>
19ea906c41SOllivier Robert            Serial Port: <tt>/dev/hpgps<i>u</i></tt>; 9600 baud, 8-bits, no parity, 19200 baud 7-bits, odd parity for the HP Z3801A</p>
209c2daa00SOllivier Robert        <h4>Description</h4>
21ea906c41SOllivier Robert        <p>This driver supports the HP 58503A Time and Frequency Reference Receiver and HP Z3801A GPS Receiver. They use HP SmartClock (TM) to implement an Enhanced GPS receiver. The receiver accuracy when locked to GPS in normal operation is better than 1 usec. The accuracy when operating in holdover is typically better than 10 us per day. It receiver should be operated with factory default settings. Initial driver operation: expects the receiver to be already locked to GPS, configured and able to output timecode format 2 messages.</p>
229c2daa00SOllivier Robert        <p>The driver uses the poll sequence <tt>:PTIME:TCODE?</tt> to get a response from the receiver. The receiver responds with a timecode string of ASCII printing characters, followed by a &lt;cr&gt;&lt;lf&gt;, followed by a prompt string issued by the receiver, in the following format:</p>
23ea906c41SOllivier Robert        <pre>T#yyyymmddhhmmssMFLRVcc&lt;cr&gt;&lt;lf&gt;scpi &gt;</pre>
24ea906c41SOllivier Robert        The driver processes the response at the &lt;cr&gt; and &lt;lf&gt;, so what the driver sees is the prompt from the previous poll, followed by this timecode. The prompt from the current poll is (usually) left unread until the next poll. So (except on the very first poll) the driver sees this:
25ea906c41SOllivier Robert        <pre>scpi &gt;T#yyyymmddhhmmssMFLRVcc&lt;cr&gt;&lt;lf&gt;</pre>
26ea906c41SOllivier Robert        <p>The T is the on-time character, at 980 msec. before the next 1PPS edge. The # is the timecode format type. We look for format 2. Without any of the CLK or PPS stuff, then, the receiver buffer timestamp at the &lt;cr&gt; is 24 characters later, which is about 25 msec. at 9600 bps, so the first approximation for fudge time1 is nominally -0.955 seconds. This number probably needs adjusting for each machine / OS type, so far: -0.955000 on an HP 9000 Model 712/80 HP-UX 9.05 -0.953175 on an HP 9000 Model 370 HP-UX 9.10</p>
27ea906c41SOllivier RobertThis driver will probably work with the 58503B and 59551A if they are setup appropriately.<P>
28ea906c41SOllivier RobertTo use an HP Z3801A, specify <tt>mode 1</tt> on the server config line to setup the right line paramters.<P>
29ea906c41SOllivier RobertThe timekeeping portion of HP's business has been sold to <a href="http://www.symmetricom.com/">Symmetricom</a>.<P>
309c2daa00SOllivier Robert        <h4>Fudge Factors</h4>
319c2daa00SOllivier Robert        <dl>
329c2daa00SOllivier Robert            <dt><tt>time1 <i>time</i></tt>
339c2daa00SOllivier Robert            <dd>Specifies the time offset calibration factor, in seconds and fraction, with default 0.0.
349c2daa00SOllivier Robert            <dt><tt>time2 <i>time</i></tt>
359c2daa00SOllivier Robert            <dd>Not used by this driver.
369c2daa00SOllivier Robert            <dt><tt>stratum <i>number</i></tt>
379c2daa00SOllivier Robert            <dd>Specifies the driver stratum, in decimal from 0 to 15, with default 0.
389c2daa00SOllivier Robert            <dt><tt>refid <i>string</i></tt>
399c2daa00SOllivier Robert            <dd>Specifies the driver reference identifier, an ASCII string from one to four characters, with default <tt>GPS</tt>.
409c2daa00SOllivier Robert            <dt><tt>flag1 0 | 1</tt>
419c2daa00SOllivier Robert            <dd>Not used by this driver.
429c2daa00SOllivier Robert            <dt><tt>flag2 0 | 1</tt>
439c2daa00SOllivier Robert            <dd>Not used by this driver.
449c2daa00SOllivier Robert            <dt><tt>flag3 0 | 1</tt>
459c2daa00SOllivier Robert            <dd>Not used by this driver.
469c2daa00SOllivier Robert            <dt><tt>flag4 0 | 1</tt>
479c2daa00SOllivier Robert            <dd>Not used by this driver.
489c2daa00SOllivier Robert        </dl>
499c2daa00SOllivier Robert        <hr>
50ea906c41SOllivier Robert        <script type="text/javascript" language="javascript" src="scripts/footer.txt"></script>
519c2daa00SOllivier Robert    </body>
529c2daa00SOllivier Robert
539c2daa00SOllivier Robert</html>
54