19c2daa00SOllivier Robert<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 29c2daa00SOllivier Robert 39c2daa00SOllivier Robert<html> 49c2daa00SOllivier Robert 59c2daa00SOllivier Robert <head> 6ea906c41SOllivier Robert <meta http-equiv="content-type" content="text/html;charset=iso-8859-1"> 79c2daa00SOllivier Robert <title>Generic Reference Driver</title> 8ea906c41SOllivier Robert <link href="scripts/style.css" type="text/css" rel="stylesheet"> 99c2daa00SOllivier Robert </head> 109c2daa00SOllivier Robert 119c2daa00SOllivier Robert <body> 129c2daa00SOllivier Robert <h3>Generic Reference Driver</h3> 139c2daa00SOllivier Robert <hr> 149c2daa00SOllivier Robert <h4>Synopsis</h4> 159c2daa00SOllivier Robert Address: 127.127.8.<i>u</i><br> 169c2daa00SOllivier Robert Reference ID: <tt>PARSE</tt><br> 179c2daa00SOllivier Robert Driver ID: <tt>GENERIC</tt><br> 18ea906c41SOllivier Robert Serial Port: <tt>/dev/refclock-<i>u</i></tt>; TTY mode according to clock type<br> 19ea906c41SOllivier Robert PPS device: <tt>/dev/refclockpps-<i>u</i></tt>; alternate PPS device (if not available via the serial port) 209c2daa00SOllivier Robert <h4>Description</h4> 21ea906c41SOllivier Robert The PARSE driver supports 20 different clock types/configurations. PARSE is actually a multi-clock driver.<br> 22ea906c41SOllivier Robert <br> 23ea906c41SOllivier Robert <p>The actual receiver status is mapped into various synchronization states generally used by receivers. The driver is configured to interpret the time codes of Meinberg DCF77 AM receivers, DCF77 FM receivers, Meinberg GPS16x/17x receivers, Trimble SV6 GPS, ELV DCF7000, Schmid, Wharton 400A and low cost receivers (see <a href="#clocklist">list below</a>).</p> 24ea906c41SOllivier Robert <p>The reference clock support in NTP contains the necessary configuration tables for those receivers. In addition to supporting several different clock types and up to 4 devices, the processing of a PPS signal is also provided as a configuration option. The PPS configuration option uses the receiver-generated time stamps for feeding the PPS loopfilter control for much finer clock synchronization.</p> 259c2daa00SOllivier Robert <p>CAUTION: The PPS configuration option is different from the hardware PPS signal, which is also supported (see below), as it controls the way ntpd is synchronized to the reference clock, while the hardware PPS signal controls the way time offsets are determined.</p> 269c2daa00SOllivier Robert <p>The use of the PPS option requires receivers with an accuracy of better than 1ms.</p> 27ea906c41SOllivier Robert <h4>Timecode variables listed by ntpq (8)</h4> 28ea906c41SOllivier Robert <p>The ntpq program can read and display several clock variables. These hold the following information:</p> 29ea906c41SOllivier Robert <dl> 30ea906c41SOllivier Robert <dt><tt>refclock_format</tt></dt> 31ea906c41SOllivier Robert <dd>A qualification of the decoded time code format.</dd> 32ea906c41SOllivier Robert <dt><tt>refclock_states</tt></dt> 33ea906c41SOllivier Robert <dd>The overall running time and the accumulated times for the clock event states.</dd> 34ea906c41SOllivier Robert <dt><tt>refclock_status</tt></dt> 35ea906c41SOllivier Robert <dd>Lists the currently active receiver flags. Additional feature flags for the receiver are optionally listed in parentheses.</dd> 36ea906c41SOllivier Robert <dt><tt>refclock_time</tt></dt> 37ea906c41SOllivier Robert <dd>The local time with the offset to UTC (format HHMM).</dd> 38ea906c41SOllivier Robert <dt><tt>timecode</tt></dt> 39ea906c41SOllivier Robert <dd>The actual time code.</dd> 40ea906c41SOllivier Robert </dl> 41ea906c41SOllivier Robert <p>If PPS information is present, additional variables are available:</p> 42ea906c41SOllivier Robert <dl> 43ea906c41SOllivier Robert <dt><tt>refclock_ppsskew</tt></dt> 44ea906c41SOllivier Robert <dd>The difference between the RS-232-derived timestamp and the PPS timestamp.</dd> 45ea906c41SOllivier Robert <dt><tt>refclock_ppstime</tt></dt> 46ea906c41SOllivier Robert <dd>The PPS timestamp.</dd> 47ea906c41SOllivier Robert </dl> 48ea906c41SOllivier Robert <h4>Supported Devices</h4> 49ea906c41SOllivier Robert <p>Currently, nineteen clock types (devices /dev/refclock-0 - /dev/refclock-3) are supported by the PARSE driver.<br> 509c2daa00SOllivier Robert A note on the implementations:</p> 519c2daa00SOllivier Robert <ul> 52ea906c41SOllivier Robert <li>These implementations were mainly done without actual access to the hardware, thus not all implementations provide full support. The development was done with the help of many kind souls who had the hardware and kindly lent me their time and patience during the development and debugging cycle. Thus for continued support and quality, direct access to the receivers is a big help. Nevertheless I am not prepared to buy these reference clocks - donations to (<a href="mailto:kardel <AT> ntp.org">kardel <AT> ntp.org</a>) are welcome as long as they work within Europe 8-). 539c2daa00SOllivier Robert <p>Verified implementations are:</p> 549c2daa00SOllivier Robert <ul> 559c2daa00SOllivier Robert <li>RAWDCF variants 56ea906c41SOllivier Robert <p>These variants have been tested for correct decoding with my own homegrown receivers. Interfacing with specific commercial products may involve some fiddling with cables. In particular, commercial RAWDCF receivers have a seemingly unlimited number of ways to draw power from the RS-232 port and to encode the DCF77 datastream. You are mainly on your own here unless I have a sample of the receiver.</p> 579c2daa00SOllivier Robert <li><a href="http://www.meinberg.de">Meinberg clocks</a> 58ea906c41SOllivier Robert <p>These implementations have been verified by the Meinberg people themselves and I have access to one of these clocks.</p> 599c2daa00SOllivier Robert </ul> 609c2daa00SOllivier Robert </ul> 61ea906c41SOllivier Robert <p>The pictures below have been taken from and are linked to the vendors' web pages.</p> 62ea906c41SOllivier Robert <a name="clocklist"></a> 639c2daa00SOllivier Robert <ul> 649c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 0</tt></b> 65ea906c41SOllivier Robert <p><b><tt><a href="http://www.meinberg.de">Meinberg</a> <a href="http://www.meinberg.de/english/products/timesource.htm#dcf---freq_sync">PZF5xx receiver family</a> (FM demodulation/TCXO / 50μs)</tt></b><br> 66ea906c41SOllivier Robert <br></p> 67ea906c41SOllivier Robert 689c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 1</tt></b> 69ea906c41SOllivier Robert <p><b><tt><a href="http://www.meinberg.de">Meinberg</a> <a href="http://www.meinberg.de/english/products/timesource.htm#dcf---freq_sync">PZF5xx receiver family</a> (FM demodulation/OCXO / 50μs)</tt></b><br> 70ea906c41SOllivier Robert <a href="http://www.meinberg.de/english/products/pzf-eurocard.htm"><img src="../pic/pzf511.jpg" alt="Image PZF511" height="300" width="260" align="top" border="0"></a><br> 71ea906c41SOllivier Robert <br></p> 72ea906c41SOllivier Robert 73ea906c41SOllivier Robert <li><a name="mode2"></a><b><tt>server 127.127.8.0-3 mode 2</tt></b> 74ea906c41SOllivier Robert <p><b><tt><a href="http://www.meinberg.de">Meinberg</a> <a href="http://www.meinberg.de/english/products/c51.htm">DCF C51 receiver and similar</a> (AM demodulation / 4ms)</tt></b><br> 75ea906c41SOllivier Robert <a href="http://www.meinberg.de/english/products/c51.htm"><img src="../pic/c51.jpg" alt="Image C51" height="239" width="330" align="top" border="0"></a><br> 769c2daa00SOllivier Robert </p> 77ea906c41SOllivier Robert <p>This mode expects the Meinberg standard time string format with 9600/7E2.</p> 78ea906c41SOllivier Robert <p><b>Note:</b> mode 2 must also be used for <a href="http://www.meinberg.de/english/products/formfactor.htm#slot_card">Meinberg PCI cards</a> under Linux, e.g. <a href="http://www.meinberg.de/english/products/gps-pcicard.htm">the GPS PCI card</a> or <a href="http://www.meinberg.de/english/products/dcf-pcicard.htm">the DCF77 PCI card</a>. Please note the <a href="http://www.meinberg.de/english/sw/#linux">Meinberg Linux driver</a> must be installed. That driver emulates a refclock device in order to allow ntpd to access those cards. For details, please refer to the README file that comes with the Meinberg driver package.<br> 79ea906c41SOllivier Robert <br></p> 80ea906c41SOllivier Robert 819c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 3</tt></b> 829c2daa00SOllivier Robert <p><b><tt><a href="http://www.elv.de">ELV</a> DCF7000 (sloppy AM demodulation / 50ms)</tt></b><br> 83ea906c41SOllivier Robert <br></p> 84ea906c41SOllivier Robert 859c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 4</tt></b> 869c2daa00SOllivier Robert <p><b><tt>Walter Schmid DCF receiver Kit (AM demodulation / 1ms)</tt></b><br> 87ea906c41SOllivier Robert <br></p> 88ea906c41SOllivier Robert 899c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 5</tt></b> 909c2daa00SOllivier Robert <p><b><tt>RAW DCF77 100/200ms pulses (Conrad DCF77 receiver module / 5ms)</tt></b><br> 91ea906c41SOllivier Robert <br></p> 92ea906c41SOllivier Robert 939c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 6</tt></b> 949c2daa00SOllivier Robert <p><b><tt>RAW DCF77 100/200ms pulses (TimeBrick DCF77 receiver module / 5ms)</tt></b><br> 95ea906c41SOllivier Robert <br></p> 96ea906c41SOllivier Robert 979c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 7</tt></b> 98ea906c41SOllivier Robert <p><b><tt><a href="http://www.meinberg.de">Meinberg</a> <a href="http://www.meinberg.de/english/products/timesource.htm#gps---freq_sync">GPS16x/GPS17x receivers</a> (GPS / <<1μs)</tt></b><br> 99ea906c41SOllivier Robert <a href="http://www.meinberg.de/english/products/gps-eurocard.htm"><img src="../pic/gps167.jpg" alt="Image GPS167" height="300" width="280" align="top" border="0"></a><br> 1009c2daa00SOllivier Robert </p> 101ea906c41SOllivier Robert <p>This mode expects either the University of Erlangen time string format or the Meinberg standard time string format at 19200/8N1.</p> 102ea906c41SOllivier Robert <p>The University of Erlangen format is preferred. Newer Meinberg GPS receivers can be configured to transmit that format; for older devices, a special firmware version may be available.</p> 103ea906c41SOllivier Robert <p>In this mode some additional GPS receiver status information is also read. However, this requires a point-to-point connection. <a href="#mode18">Mode 18</a> should be used if the device is accessed by a multidrop connection.</p> 104ea906c41SOllivier Robert <p><b>Note:</b> mode 7 must not be used with Meinberg PCI cards; use <a href="#mode2">mode 2</a> instead.<br> 105ea906c41SOllivier Robert <br></p> 106ea906c41SOllivier Robert 1079c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 8</tt></b> 1089c2daa00SOllivier Robert <p><b><tt><a href="http://www.igel.de">IGEL</a> <a href="http://www.igel.de/eigelmn.html">clock</a></tt></b><br> 109ea906c41SOllivier Robert <a href="http://www.igel.de/eigelmn.html"><img src="../pic/igclock.gif" alt="Image IGEL clock" height="174" width="200" border="0"></a><br> 110ea906c41SOllivier Robert <br></p> 111ea906c41SOllivier Robert 1129c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 9</tt></b> 113ea906c41SOllivier Robert <p><b><tt><a href="http://www.trimble.com">Trimble</a> <a href="http://www.trimble.com/cgi/omprod.cgi/pd_om011.html">SVeeSix GPS receiver</a> TAIP protocol (GPS / <<1μs)</tt></b><br> 114ea906c41SOllivier Robert <br></p> 115ea906c41SOllivier Robert 1169c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 10</tt></b> 117ea906c41SOllivier Robert <p><b><tt><a href="http://www.trimble.com">Trimble</a> <a href="http://www.trimble.com/cgi/omprod.cgi/pd_om011.html">SVeeSix GPS receiver</a> TSIP protocol (GPS / <<1μs) (no kernel support yet)</tt></b><br> 118ea906c41SOllivier Robert <a href="http://www.trimble.com/cgi/omprod.cgi/pd_om011.html"><img src="../pic/pd_om011.gif" alt="Image SVeeSix-CM3" height="100" width="420" align="top" border="0"></a><br> 119ea906c41SOllivier Robert <a href="http://www.trimble.com/cgi/omprod.cgi/pd_om006.html"><img src="../pic/pd_om006.gif" alt="Image Lassen-SK8" height="100" width="420" border="0"></a><br> 120ea906c41SOllivier Robert <br></p> 121ea906c41SOllivier Robert 1229c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 11</tt></b> 1239c2daa00SOllivier Robert <p><b><tt>Radiocode Clocks Ltd RCC 8000 Intelligent Off-Air Master Clock support </tt></b><br> 124ea906c41SOllivier Robert <br></p> 125ea906c41SOllivier Robert 1269c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 12</tt></b> 1279c2daa00SOllivier Robert <p><b><tt><a href="http://www.hopf-time.com">HOPF</a> <a href="http://www.hopf-time.com/kart6021.html">Funkuhr 6021</a></tt></b><br> 128ea906c41SOllivier Robert <a href="http://www.hopf-time.com/engl/kart6021.html"><img src="../pic/fg6021.gif" alt="Image DCF77 Interface Board" height="207" width="238" align="top" border="0"></a><br> 129ea906c41SOllivier Robert <br></p> 130ea906c41SOllivier Robert 1319c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 13</tt></b> 1329c2daa00SOllivier Robert <p><b><tt>Diem's Computime Radio Clock</tt></b><br> 133ea906c41SOllivier Robert <br></p> 134ea906c41SOllivier Robert 1359c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 14</tt></b> 136ea906c41SOllivier Robert <p><b><tt>RAWDCF receiver (DTR=high/RTS=low)</tt></b><br> 137ea906c41SOllivier Robert <br></p> 138ea906c41SOllivier Robert 1399c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 15</tt></b> 140ea906c41SOllivier Robert <p><b><tt>WHARTON 400A Series Clocks with a 404.2 Serial Interface</tt></b><br> 141ea906c41SOllivier Robert <br></p> 142ea906c41SOllivier Robert 1439c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 16</tt></b> 144ea906c41SOllivier Robert <p><b><tt>RAWDCF receiver (DTR=low/RTS=high) </tt></b><br> 145ea906c41SOllivier Robert <br></p> 146ea906c41SOllivier Robert 1479c2daa00SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 17</tt></b> 148ea906c41SOllivier Robert <p><b><tt>VARITEXT Receiver (MSF) </tt></b><br> 149ea906c41SOllivier Robert <br></p> 150ea906c41SOllivier Robert 151ea906c41SOllivier Robert <li><a name="mode18"></a><b><tt>server 127.127.8.0-3 mode 18</tt></b> 152ea906c41SOllivier Robert <p><b><tt><a href="http://www.meinberg.de">Meinberg </a><a href="http://www.meinberg.de/english/products/timesource.htm#gps---freq_sync">GPS16x/GPS17x receivers</a> (GPS / <<1μs)</tt></b><br> 153ea906c41SOllivier Robert </p> 154ea906c41SOllivier Robert <p>This mode works without additional data communication (version, GPS status etc.) and thus should be used with multidrop, heterogeneous multiclient operation.</p> 155ea906c41SOllivier Robert <p><b>Note:</b> mode 18 must not be used with Meinberg PCI cards, use mode 2 instead.<br> 156ea906c41SOllivier Robert <br></p> 157ea906c41SOllivier Robert <li><b><tt>server 127.127.8.0-3 mode 19</tt></b> 158ea906c41SOllivier Robert <p><b><tt>Gude Analog- und Digitalsystem GmbH 'Expert mouseCLOCK USB v2.0'</tt></b><br> 159ea906c41SOllivier Robert <br></p> 160ea906c41SOllivier Robert 1619c2daa00SOllivier Robert </ul> 162ea906c41SOllivier Robert <p>Actual data formats and setup requirements of the various clocks can be found in <a href="../parsedata.html">NTP PARSE clock data formats</a>.</p> 163ea906c41SOllivier Robert <h4>Operation</h4> 164ea906c41SOllivier Robert <p>The reference clock support software carefully monitors the state transitions of the receiver. All state changes and exceptional events (such as loss of time code transmission) are logged via the syslog facility. Every hour a summary of the accumulated times for the clock states is listed via syslog.</p> 165ea906c41SOllivier Robert <p>PPS support is only available when the receiver is completely synchronized. The receiver is believed to deliver correct time for an additional period of time after losing synchronization, unless a disruption in time code transmission is detected (possible power loss). The trust period is dependent on the receiver oscillator and thus is a function of clock type.</p> 166ea906c41SOllivier Robert <p>Raw DCF77 pulses can be fed via a level converter to the RXD pin of an RS-232 serial port (pin 3 of a 25-pin connector or pin 2 of a 9-pin connector). The telegrams are decoded and used for synchronization. DCF77 AM receivers can be bought for as little as $25. The accuracy is dependent on the receiver and is somewhere between 2ms (expensive) and 10ms (cheap). Synchronization ceases when reception of the DCF77 signal deteriorates, since no backup oscillator is available as usually found in other reference clock receivers. So it is important to have a good place for the DCF77 antenna. During transmitter shutdowns you are out of luck unless you have other NTP servers with alternate time sources available.</p> 167ea906c41SOllivier Robert <p>In addition to the PPS loopfilter control, a true PPS hardware signal can be utilized via the PPSAPI interface. PPS pulses are usually fed via a level converter to the DCD pin of an RS-232 serial port (pin 8 of a 25-pin connector or pin 1 of a 9-pin connector). To select PPS support, the mode parameter is the mode value as above plus 128. If 128 is not added to the mode value, PPS will be detected to be available but will not be used. 168ea906c41SOllivier Robert </p> 169ea906c41SOllivier Robert <h4>Hardware PPS support<br> 170ea906c41SOllivier Robert </h4> 171ea906c41SOllivier Robert <p>For PPS to be used, add 128 to the mode parameter.</p> 172ea906c41SOllivier Robert <p>If the PPS signal is fed in from a device different from the device providing the serial communication (/dev/refclock-{0..3}), this device is configured as /dev/refclockpps-{0..3}. This allows the PPS information to be fed in e.g. via the parallel port (if supported by the underlying operation system) and the date/time telegrams to be handled via the serial port.</p> 1739c2daa00SOllivier Robert <h4>Monitor Data</h4> 174ea906c41SOllivier Robert <p>Clock state statistics are written hourly to the syslog service. Online information can be found by examining the clock variables via the <code>ntpq cv</code> command.<br> 175ea906c41SOllivier Robert Some devices have quite extensive additional information (GPS16x/GPS17x, Trimble). The driver reads out much of the internal GPS data 176ea906c41SOllivier Robert and makes it accessible via clock variables. To find out about additional variable names, query for the clock_var_list variable on 177ea906c41SOllivier Robert a specific clock association as shown below. 178ea906c41SOllivier Robert </p> 179ea906c41SOllivier Robert <p>First let <code>ntpq</code> display the table of associations:</p> 180ea906c41SOllivier Robert <pre> 181ea906c41SOllivier Robert ntpq> as 182ea906c41SOllivier Robert ind assID status conf reach auth condition last_event cnt 183ea906c41SOllivier Robert =========================================================== 184ea906c41SOllivier Robert 1 19556 9154 yes yes none falsetick reachable 5 185ea906c41SOllivier Robert 2 19557 9435 yes yes none candidat clock expt 3 186ea906c41SOllivier Robert 3 19558 9714 yes yes none pps.peer reachable 1 187ea906c41SOllivier Robert </pre> 188ea906c41SOllivier Robert <p>Then switch to raw output. This may be required because of display limitations in ntpq/ntpd - so large lists need to be retrieved in several queries.</p> 189ea906c41SOllivier Robert <pre> 190ea906c41SOllivier Robert ntpq> raw 191ea906c41SOllivier Robert Output set to raw 192ea906c41SOllivier Robert </pre> 193ea906c41SOllivier Robert <p>Use the cv command to read the list of clock variables of a selected association:</p> 194ea906c41SOllivier Robert <pre> 195ea906c41SOllivier Robert ntpq> cv 19557 clock_var_list 196ea906c41SOllivier Robert </pre> 197ea906c41SOllivier Robert <p>The long output of the command above looks similar to:</p> 198ea906c41SOllivier Robert <pre> 199ea906c41SOllivier Robert assID=19557 status=0x0000, 200ea906c41SOllivier Robert clock_var_list="type,timecode,poll,noreply,badformat,baddata,fudgetime1, 201ea906c41SOllivier Robert fudgetime2,stratum,refid,flags,device,clock_var_list,refclock_time,refclock_status, 202ea906c41SOllivier Robert refclock_format,refclock_states,refclock_id,refclock_iomode,refclock_driver_version, 203ea906c41SOllivier Robert meinberg_gps_status,gps_utc_correction,gps_message,meinberg_antenna_status,gps_tot_51, 204ea906c41SOllivier Robert gps_tot_63,gps_t0a,gps_cfg[1],gps_health[1],gps_cfg[2],gps_health[2],gps_cfg[3], 205ea906c41SOllivier Robert gps_health[3],gps_cfg[4],gps_health[4],gps_cfg[5]" 206ea906c41SOllivier Robert </pre> 207ea906c41SOllivier Robert <p>Then use the cv command again to list selected clock variables. The following command must be entered as a single line:</p> 208ea906c41SOllivier Robert <pre> 209ea906c41SOllivier Robert ntpq> cv 19557 refclock_status,refclock_format,refclock_states,refclock_id, 210ea906c41SOllivier Robert refclock_iomode,refclock_driver_version,meinberg_gps_status,gps_utc_correction, 211ea906c41SOllivier Robert gps_message,meinberg_antenna_status,gps_tot_51,gps_tot_63,gps_t0a,gps_cfg[1], 212ea906c41SOllivier Robert gps_health[1],gps_cfg[2],gps_health[2],gps_cfg[3],gps_health[3],gps_cfg[4], 213ea906c41SOllivier Robert gps_health[4],gps_cfg[5] 214ea906c41SOllivier Robert </pre> 215ea906c41SOllivier Robert <p>The output of the command above is wrapped around depending on the screen width and looks similar to:</p> 216ea906c41SOllivier Robert <pre> 217ea906c41SOllivier Robert status=0x0003, 218ea906c41SOllivier Robert refclock_status="UTC DISPLAY; TIME CODE; PPS; POSITION; (LEAP INDICATION; 219ea906c41SOllivier Robert PPS SIGNAL; POSITION)", 220ea906c41SOllivier Robert refclock_format="Meinberg GPS Extended", 221ea906c41SOllivier Robert refclock_states="*NOMINAL: 21:21:36 (99.99%); FAULT: 00:00:03 (0.00%); 222ea906c41SOllivier Robert running time: 21:21:39", 223ea906c41SOllivier Robert refclock_id="GPS", refclock_iomode="normal", 224ea906c41SOllivier Robert refclock_driver_version="refclock_parse.c,v 4.77 2006/08/05 07:44:49 225ea906c41SOllivier Robert kardel RELEASE_20060805_A", 226ea906c41SOllivier Robert meinberg_gps_status="[0x0000] <OK>", 227ea906c41SOllivier Robert gps_utc_correction="current correction 14 sec, last correction 228ea906c41SOllivier Robert on c7619a00.00000000 Sun, Jan 1 2006 0:00:00.000", 229ea906c41SOllivier Robert gps_message="/PFU3SOP-4WG14EPU0V1KA", 230ea906c41SOllivier Robert meinberg_antenna_status="RECONNECTED on 2006-07-18 08:13:20.0000000 (+0000) 231ea906c41SOllivier Robert UTC CORR, LOCAL TIME, reconnect clockoffset +0.0000000 s, 232ea906c41SOllivier Robert disconnect time 0000-00-00 00:00:00.0000000 (+0000) ", 233ea906c41SOllivier Robert gps_tot_51="week 1400 + 3 days + 42300.0000000 sec", 234ea906c41SOllivier Robert gps_tot_63="week 1400 + 3 days + 42294.0000000 sec", 235ea906c41SOllivier Robert gps_t0a="week 1400 + 5 days + 71808.0000000 sec", 236ea906c41SOllivier Robert gps_cfg[1]="[0x9] BLOCK II", gps_health[1]="[0x0] OK;SIGNAL OK", 237ea906c41SOllivier Robert gps_cfg[2]="[0x0] BLOCK I", gps_health[2]="[0x3f] PARITY;MULTIPLE ERRS", 238ea906c41SOllivier Robert gps_cfg[3]="[0x9] BLOCK II", gps_health[3]="[0x0] OK;SIGNAL OK", 239ea906c41SOllivier Robert gps_cfg[4]="[0x9] BLOCK II", gps_health[6]="[0x0] OK;SIGNAL OK", 240ea906c41SOllivier Robert gps_cfg[5]="[0x9] BLOCK II" 241ea906c41SOllivier Robert </pre> 2429c2daa00SOllivier Robert <h4>Fudge Factors</h4> 2439c2daa00SOllivier Robert <dl> 2449c2daa00SOllivier Robert <dt><tt>time1 <i>time</i></tt> 245ea906c41SOllivier Robert <dd>Specifies the time offset calibration factor, in seconds and fraction. The default value depends on the clock type. 2469c2daa00SOllivier Robert <dt><tt>time2 <i>time</i></tt> 247ea906c41SOllivier Robert <dd> 248ea906c41SOllivier Robert If flag1 is 0, time2 specifies the offset of the PPS signal from the actual time (PPS fine tuning). 249ea906c41SOllivier Robert <dd> 250ea906c41SOllivier Robert If flag1 is 1, time2 specifies the number of seconds a receiver with a premium local oscillator can be trusted after losing synchronisation. 251ea906c41SOllivier Robert <dt><tt>stratum <i>stratum</i></tt> 252ea906c41SOllivier Robert <dd>The stratum for this reference clock. 253ea906c41SOllivier Robert <dt><tt>refid <i>refid</i></tt> 254ea906c41SOllivier Robert <dd>The refid for this reference clock. 255ea906c41SOllivier Robert </dl> 256ea906c41SOllivier Robert <dl> 257ea906c41SOllivier Robert <dt><tt>flag1 { 0 | 1 }</tt> 258ea906c41SOllivier Robert <dd>If 0, the fudge factor <tt>time2</tt> refers to the PPS offset. 259ea906c41SOllivier Robert <dd>If 1, <tt>time2</tt> refers to the TRUST TIME. 260ea906c41SOllivier Robert <dt><tt>flag2 { 0 | 1 }</tt> 261ea906c41SOllivier Robert <dd>If <tt>flag2</tt> is 1, sample PPS on CLEAR instead of on ASSERT. 262ea906c41SOllivier Robert <dt><tt>flag3 { 0 | 1 }</tt> 263ea906c41SOllivier Robert <dd>If <tt>flag3</tt> is 1, link kernel PPS tracking to this refclock instance. 264ea906c41SOllivier Robert <dt><tt>flag4 { 0 | 1 }</tt> 265ea906c41SOllivier Robert <dd>Delete next leap second instead of adding it. (You'll need to wait a bit for that to happen 8-) 266ea906c41SOllivier Robert </dl> 267ea906c41SOllivier Robert <span style="font-weight: bold;">Note about auxiliary Sun STREAMS modules (SunOS and Solaris):</span><br> 268ea906c41SOllivier Robert <dl> 269ea906c41SOllivier Robert <dt>The timecode of these receivers can be sampled via a STREAMS module in the kernel. (The STREAMS module has been designed for use with Sun systems under SunOS 4.1.x or Solaris 2.3 - 2.8. It can be linked directly into the kernel or loaded via the loadable driver mechanism.) This STREAMS module can be adapted to convert different time code formats. Nowadays the PPSAPI mechanism is usually used. 2709c2daa00SOllivier Robert </dl> 2719c2daa00SOllivier Robert <h4>Making your own PARSE clocks</h4> 272ea906c41SOllivier Robert <p>The parse clock mechanism deviates from the way other NTP reference clocks work. For a short description of how to build parse reference clocks, see <a href="../parsenew.html">making PARSE clocks</a>.</p> 2739c2daa00SOllivier Robert <p>Additional Information</p> 2749c2daa00SOllivier Robert <p><a href="../refclock.html">Reference Clock Drivers</a></p> 2759c2daa00SOllivier Robert <hr> 276ea906c41SOllivier Robert <script type="text/javascript" language="javascript" src="scripts/footer.txt"></script> 2779c2daa00SOllivier Robert </body> 2789c2daa00SOllivier Robert 2799c2daa00SOllivier Robert</html> 280
