Initial import from FreeBSD RELENG_4:
[dragonfly.git] / contrib / ntp / html / driver10.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>Austron 2200A/2201A GPS Receivers
6 </TITLE>
7 </HEAD>
8 <BODY>
9
10 <H3>
11 Austron 2200A/2201A GPS Receivers</H3>
12
13 <HR>
14 <H4>
15 Synopsis</H4>
16 Address: 127.127.10.<I>u</I>
17 <BR>Reference ID: <TT>GPS</TT>
18 <BR>Driver ID: <TT>GPS_AS2201</TT>
19 <BR>Serial Port: <TT>/dev/gps<I>u</I></TT>; 9600 baud, 8-bits, no parity
20 <BR>Features: <TT>tty_clk</TT>
21 <H4>
22 Description</H4>
23 This driver supports the Austron 2200A/2201A GPS/LORAN Synchronized Clock
24 and Timing Receiver connected via a serial port. It supports several special
25 features of the clock, including the Input Buffer Module, Output Buffer
26 Module, IRIG-B Interface Module and LORAN Assist Module. It requires the
27 RS232 Buffered Serial Interface module for communication with the driver.
28 For operation with multiple computers, it requires the <TT>ppsclock</TT>
29 streams module described in the <A HREF="ldisc.htm">Line Disciplines and
30 Streams Modules</A> page. The streams module requires a gadget box and
31 1-PPS level converter, such as described in the <A HREF="pps.htm">Pulse-per-second
32 (PPS) Signal Interfacing</A> page.
33
34 <P>For use with a single computer, the receiver can be connected directly
35 to the receiver. For use with multiple computers, one of them is connected
36 directly to the receiver and generates the polling messages. The other
37 computers just listen to the receiver output directly or through a buffer
38 amplifier. For computers that just listen, <TT>fudge flag2</TT> must be
39 set and the <TT>ppsclock </TT>streams module configured on each of them.
40
41 <P>This receiver is capable of a comprehensive and large volume of statistics
42 and operational data. The specific data collection commands and attributes
43 are embedded in the driver source code; however, the collection process
44 can be enabled or disabled using the flag4 flag. If set, collection is
45 enabled; if not, which is the default, it is disabled. A comprehensive
46 suite of data reduction and summary scripts is in the ./scripts/stats directory
47 of the ntp3 distribution.
48 <H4>
49 Monitor Data</H4>
50 When enabled by the <TT>flag4</TT> fudge flag, every received timecode
51 is written as-is to the <TT>clockstats</TT> file.
52 <H4>
53 Fudge Factors</H4>
54
55 <DL>
56 <DT>
57 <TT>time1 <I>time</I></TT></DT>
58
59 <DD>
60 Specifies the time offset calibration factor, in seconds and fraction,
61 with default 0.0.</DD>
62
63 <DT>
64 <TT>time2 <I>time</I></TT></DT>
65
66 <DD>
67 Not used by this driver.</DD>
68
69 <DT>
70 <TT>stratum <I>number</I></TT></DT>
71
72 <DD>
73 Specifies the driver stratum, in decimal from 0 to 15, with default 0.</DD>
74
75 <DT>
76 <TT>refid <I>string</I></TT></DT>
77
78 <DD>
79 Specifies the driver reference identifier, an ASCII string from one to
80 four characters, with default <TT>GPS</TT>.</DD>
81
82 <DT>
83 <TT>flag1 0 | 1</TT></DT>
84
85 <DD>
86 Not used by this driver.</DD>
87
88 <DT>
89 <TT>flag2 0 | 1</TT></DT>
90
91 <DD>
92 Set for computers that listen-only.</DD>
93
94 <DT>
95 <TT>flag3 0 | 1</TT></DT>
96
97 <DD>
98 Not used by this driver.</DD>
99
100 <DT>
101 <TT>flag4 0 | 1</TT></DT>
102
103 <DD>
104 Enable verbose <TT>clockstats</TT> recording if set.</DD>
105 </DL>
106 Additional Information
107
108 <P><A HREF="refclock.htm">Reference Clock Drivers</A>&nbsp;
109 <HR>
110 <ADDRESS>
111 David L. Mills (mills@udel.edu)</ADDRESS>
112
113 </BODY>
114 </HTML>