source: trunk/third/xntp/html/driver2.htm @ 16192

Revision 16192, 4.0 KB checked in by ghudson, 24 years ago (diff)
This commit was generated by cvs2svn to compensate for changes in r16191, which included commits to RCS files with non-trunk default branches.
Line 
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>Trak 8820 GPS Receiver
6</TITLE>
7</HEAD>
8<BODY>
9
10<H3>
11Trak 8820 GPS Receiver</H3>
12
13<HR>
14<H4>
15Synopsis</H4>
16Address: 127.127.2.<I>u</I>
17<BR>Reference ID: <TT>GPS</TT>
18<BR>Driver ID: <TT>GPS_TRAK</TT>
19<BR>Serial Port: <TT>/dev/trak<I>u</I></TT>; 9600 baud, 8-bits, no parity
20<BR>Features: <TT>tty_clk</TT>
21<H4>
22Description</H4>
23This driver supports the Trak 8820 GPS Station Clock. The claimed accuracy
24at the 1-PPS output is 200-300 ns relative to the broadcast signal; however,
25in most cases the actual accuracy is limited by the precision of the timecode
26and the latencies of the serial interface and operating system.
27
28<P>For best accuracy, this radio requires the <TT>tty_clk</TT> line discipline,
29which captures a timestamp at the <TT>*</TT> on-time character of the timecode.
30Using this discipline the jitter is in the order of 1 ms and systematic
31error about 0.5 ms. If unavailable, the buffer timestamp is used, which
32is captured at the <TT>\r</TT> ending the timecode message. This introduces
33a systematic error of 23 character times, or about 24 ms at 9600 bps, together
34with a jitter well over 8 ms on Sun IPC-class machines.
35
36<P>Using the menus, the radio should be set for 9600 bps, one stop bit
37and no parity. It should be set to operate in computer (no echo) mode.
38The timecode format includes neither the year nor leap-second warning.
39
40<P>In operation, this driver sends a <TT>RQTS\r</TT> request to the radio
41at initialization in order to put it in continuous time output mode. The
42radio then sends the following message once each second:
43<PRE>*RQTS U,ddd:hh:mm:ss.0,q&lt;cr>&lt;lf>
44
45on-time = '*'
46ddd = day of year
47hh:mm:ss = hours, minutes, seconds
48q = quality indicator (phase error), 0-6:
49&nbsp;&nbsp;&nbsp;&nbsp; 0 > 20 us
50&nbsp;&nbsp;&nbsp;&nbsp; 6 > 10 us
51&nbsp;&nbsp;&nbsp;&nbsp; 5 > 1 us
52&nbsp;&nbsp;&nbsp;&nbsp; 4 > 100 ns
53&nbsp;&nbsp;&nbsp;&nbsp; 3 > 10 ns
54&nbsp;&nbsp;&nbsp;&nbsp; 2 &lt; 10 ns</PRE>
55The alarm condition is indicated by <TT>0</TT> at <TT>Q</TT>, which means
56the radio has a phase error greater than 20 us relative to the broadcast
57time. The absence of year, DST and leap-second warning in this format is
58also alarmed.
59
60<P>The continuous time mode is disabled using the <TT>RQTX\r</TT> request,
61following which the radio sends a <TT>RQTX DONE&lt;cr>&lt;lf></TT> response.
62In the normal mode, other control and status requests are effective, including
63the leap-second status request <TT>RQLS&lt;cr></TT>. The radio responds
64with <TT>RQLS yy,mm,dd&lt;cr>&lt;lf></TT>, where <TT>yy,mm,dd</TT> are
65the year, month and day. Presumably, this gives the epoch of the next leap
66second, <TT>RQLS 00,00,00</TT> if none is specified in the GPS message.
67Specified in this form, the information is generally useless and is ignored
68by the driver.
69<H4>
70Monitor Data</H4>
71When enabled by the <TT>flag4</TT> fudge flag, every received timecode
72is written as-is to the <TT>clockstats</TT> file.
73<H4>
74Fudge Factors</H4>
75
76<DL>
77<DT>
78<TT>time1 <I>time</I></TT></DT>
79
80<DD>
81Specifies the time offset calibration factor, in seconds and fraction,
82with default 0.0.</DD>
83
84<DT>
85<TT>time2 <I>time</I></TT></DT>
86
87<DD>
88Not used by this driver.</DD>
89
90<DT>
91<TT>stratum <I>number</I></TT></DT>
92
93<DD>
94Specifies the driver stratum, in decimal from 0 to 15, with default 0.</DD>
95
96<DT>
97<TT>refid <I>string</I></TT></DT>
98
99<DD>
100Specifies the driver reference identifier, an ASCII string from one to
101four characters, with default <TT>GPS</TT>.</DD>
102
103<DT>
104<TT>flag1 0 | 1</TT></DT>
105
106<DD>
107Not used by this driver.</DD>
108
109<DT>
110<TT>flag2 0 | 1</TT></DT>
111
112<DD>
113Not used by this driver.</DD>
114
115<DT>
116<TT>flag3 0 | 1</TT></DT>
117
118<DD>
119Not used by this driver.</DD>
120
121<DT>
122<TT>flag4 0 | 1</TT></DT>
123
124<DD>
125Not used by this driver.</DD>
126
127
128<P>Additional Information
129
130<P><A HREF="refclock.htm">Reference Clock Drivers</A></DL>
131
132<HR>
133<ADDRESS>
134David L. Mills (mills@udel.edu)</ADDRESS>
135
136</BODY>
137</HTML>
Note: See TracBrowser for help on using the repository browser.