Initial import from FreeBSD RELENG_4:
[dragonfly.git] / contrib / ntp / html / driver26.htm
1 <HTML>
2 <HEAD>
3    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
4    <META NAME="GENERATOR" CONTENT="Mozilla/4.01 [en] (Win95; I) [Netscape]">
5    <TITLE>Hewlett Packard 58503A GPS Receiver
6 </TITLE>
7 </HEAD>
8 <BODY>
9
10 <H3>
11 Hewlett Packard 58503A GPS Receiver</H3>
12
13 <HR>
14 <H4>
15 Synopsis</H4>
16 Address: 127.127.26.<I>u</I>
17 <BR>Reference ID: <TT>GPS</TT>
18 <BR>Driver ID: <TT>GPS_HP</TT>
19 <BR>Serial Port: <TT>/dev/hpgps<I>u</I></TT>; 9600 baud, 8-bits, no parity
20 <H4>
21 Description</H4>
22 This driver supports the HP 58503A Time and Frequency Reference Receiver.
23 It uses HP SmartClock (TM) to implement an Enhanced GPS receiver. The receiver
24 accuracy when locked to GPS in normal operation is better than 1 usec.
25 The accuracy when operating in holdover is typically better than 10 us
26 per day. It receiver should be operated with factory default settings.
27 Initial driver operation: expects the receiver to be already locked to
28 GPS, configured and able to output timecode format 2 messages.
29
30 <P>The driver uses the poll sequence <TT>:PTIME:TCODE?</TT> to get a response
31 from the receiver. The receiver responds with a timecode string of ASCII
32 printing characters, followed by a &lt;cr>&lt;lf>, followed by a prompt
33 string issued by the receiver, in the following format:
34 <PRE>T#yyyymmddhhmmssMFLRVcc&lt;cr>&lt;lf></PRE>
35 The driver processes the response at the &lt;cr> and &lt;lf>&lt;cr> and
36 &lt;lf>, so what the driver sees is the prompt from the previous poll,
37 followed by this timecode. The prompt from the current poll is (usually)
38 left unread until the next poll. So (except on the very first poll) the
39 driver sees this:
40 <PRE>T#yyyymmddhhmmssMFLRVcc&lt;cr>&lt;lf></PRE>
41 The T is the on-time character, at 980 msec. before the next 1PPS edge.
42 The # is the timecode format type. We look for format 2. Without any of
43 the CLK or PPS stuff, then, the receiver buffer timestamp at the &lt;cr>y
44 is 24 characters later, which is about 25 msec. at 9600 bps, so the first
45 approximation for fudge time1 is nominally -0.955 seconds. This number
46 probably needs adjusting for each machine / OS type, so far: -0.955000
47 on an HP 9000 Model 712/80 HP-UX 9.05 -0.953175 on an HP 9000 Model 370
48 HP-UX 9.10
49 <H4>
50 Fudge Factors</H4>
51
52 <DL>
53 <DT>
54 <TT>time1 <I>time</I></TT></DT>
55
56 <DD>
57 Specifies the time offset calibration factor, in seconds and fraction,
58 with default 0.0.</DD>
59
60 <DT>
61 <TT>time2 <I>time</I></TT></DT>
62
63 <DD>
64 Not used by this driver.</DD>
65
66 <DT>
67 <TT>stratum <I>number</I></TT></DT>
68
69 <DD>
70 Specifies the driver stratum, in decimal from 0 to 15, with default 0.</DD>
71
72 <DT>
73 <TT>refid <I>string</I></TT></DT>
74
75 <DD>
76 Specifies the driver reference identifier, an ASCII string from one to
77 four characters, with default <TT>GPS</TT>.</DD>
78
79 <DT>
80 <TT>flag1 0 | 1</TT></DT>
81
82 <DD>
83 Not used by this driver.</DD>
84
85 <DT>
86 <TT>flag2 0 | 1</TT></DT>
87
88 <DD>
89 Not used by this driver.</DD>
90
91 <DT>
92 <TT>flag3 0 | 1</TT></DT>
93
94 <DD>
95 Not used by this driver.</DD>
96
97 <DT>
98 <TT>flag4 0 | 1</TT></DT>
99
100 <DD>
101 Not used by this driver.</DD>
102 </DL>
103
104 <HR>
105 <ADDRESS>
106 David L. Mills (mills@udel.edu)</ADDRESS>
107
108 </BODY>
109 </HTML>