contrib/ntp/html/driver23.htm

   1 <HTML>
   2 <HEAD>
   3   <META NAME="GENERATOR" CONTENT="Adobe PageMill 3.0 per Windows">
   4   <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
   5   <TITLE>PTB Modem Time Service </TITLE>
   6 </HEAD>
   7 <BODY>
   8
   9 <H3>PTB Modem Time Service and other European Laboratories Time
  10 Services</H3>
  11
  12 <HR ALIGN=LEFT>
  13
  14 <H4>Synopsis</H4>
  15
  16 <P>Address: 127.127.23.<I>u</I> <BR>
  17 Reference ID: <TT>PTB</TT> <BR>
  18 Driver ID: <TT>ACTS_PTB</TT><BR>
  19 Serial Port: <TT>/dev/ptb<I>u</I></TT>; 1200 baud, 8-bits, no
  20 parity <BR>
  21 Requires: <TT>/usr/include/sys/termios.h</TT> header file with
  22 modem control</P>
  23
  24 <H4>Description</H4>
  25
  26 <P>This driver supports the PTB Automated Computer Time Service
  27 (ACTS) and it is a modified version of the NIST ACTS driver so
  28 see it for more informations..</P>
  29
  30 <P>It periodically dials a prespecified telephone number, receives
  31 the PTB timecode data and calculates the local clock correction.
  32 It designed primarily for use when neither a radio clock nor connectivity
  33 to Internet time servers is available. For the best accuracy,
  34 the individual telephone line/modem delay needs to be calibrated
  35 using outside sources.</P>
  36
  37 <P>The only change between this driver and the NIST one is the
  38 data format. Infact PTB data format is the following:</P>
  39
  40 <P><FONT SIZE="-1" FACE="Courier New">Data format<BR>
  41 0000000000111111111122222222223333333333444444444455555555556666666666777777777
  42   7<BR>
  43 0123456789012345678901234567890123456789012345678901234567890123456789012345678
  44   9<BR>
  45 1995-01-23 20:58:51 MEZ  10402303260219950123195849740+40000500
  46               *<BR>
  47 A    B  C  D EF  G  H    IJ K  L M N O   P Q R S T    U V  W
  48 XY              Z&lt;CR&gt;&lt;LF&gt;<BR>
  49 A year<BR>
  50 B month<BR>
  51 C day<BR>
  52 D hour<BR>
  53 E : normally<BR>
  54 A for DST to ST switch first hour<BR>
  55 B for DST to ST switch second hour if not marked in H<BR>
  56 F minute<BR>
  57 G second<BR>
  58 H timezone<BR>
  59 I day of week<BR>
  60 J week of year<BR>
  61 K day of year<BR>
  62 L month for next ST/DST changes<BR>
  63 M day<BR>
  64 N hour<BR>
  65 O UTC year<BR>
  66 P UTC month<BR>
  67 Q UTC day<BR>
  68 R UTC hour<BR>
  69 S UTC minute<BR>
  70 T modified julian day (MJD)<BR>
  71 U DUT1<BR>
  72 V direction and month if leap second<BR>
  73 W signal delay (assumed/measured)<BR>
  74 X sequence number for additional text line in Y<BR>
  75 Y additional text<BR>
  76 Z on time marker (* - assumed delay / # measured delay)<BR>
  77  &lt;CR&gt;!&lt;LF&gt; ! is second change !<BR>
  78 </FONT><BR>
  79 This format is an ITU-R Recommendation (ITU-R TF583.4) and is now available from the primary
  80 timing centres of the following countries:
  81 Austria, Belgium, Germany, Italy, The Netherlands, Poland, Portugal, Romania, Spain, Sweden,
  82 Switzerland, Turkey, United Kingdom.
  83 Some examples are:
  84 </P>
  85
  86 <UL>
  87   <LI>In Germany by Physikalisch-Technische Bundesanstalt  (PTB)'s
  88    timecode service. Phone number:   +49 5 31 51 20 38.
  89 </UL>
  90
  91 <BLOCKQUOTE>
  92   <P>For more detail, see <A HREF="http://www.ptb.de/english/org/4/43/433/disse.htm">http://www.ptb.de/english/org/4/43/433/disse.htm</A></P>
  93 </BLOCKQUOTE>
  94
  95 <UL>
  96   <LI>In the UK by National Physical Laboratory (NPL)'s  TRUETIME
  97   service. Phone number:  0891 516 333
  98 </UL>
  99
 100 <BLOCKQUOTE>
 101   <P>For more detail, see <A HREF="http://www.npl.co.uk/npl/ctm/truetime.html">http://www.npl.co.uk/npl/ctm/truetime.html</A></P>
 102 </BLOCKQUOTE>
 103
 104 <UL>
 105   <LI>In Italy by Istituto Elettrotecnico Nazionale &quot;Galileo
 106   Ferrais&quot;  (IEN)'s  CTD service. Phone number:  166 11 46
 107   15
 108 </UL>
 109
 110 <BLOCKQUOTE>
 111   <P>For more detail, see <A HREF="http://www.ien.it/tf/time/Pagina42.html">http://www.ien.it/tf/time/Pagina42.html</A></P>
 112 </BLOCKQUOTE>
 113
 114 <UL>
 115   <LI>In Switzerland by Swiss Federal Office of Metrology 's timecode
 116   service. Phone number:  031 323 32 25
 117 </UL>
 118
 119 <BLOCKQUOTE>
 120   <P>For more detail, see <A HREF="http://www.ofmet.admin.ch/de/labors/4/Zeitvert.html%20">http://www.ofmet.admin.ch/de/labors/4/Zeitvert.html
 121   </A></P>
 122 </BLOCKQUOTE>
 123
 124 <UL>
 125   <LI>In Sweden by SP Swedish National Testing and Research Institute
 126   's timecode service. Phone number:  +46 33 415783
 127 </UL>
 128
 129 <BLOCKQUOTE>
 130   <P>For more detail, see <A HREF="http://www.sp.se/pne/ElectricalMetrology/ElMeteng/frameset.htm">http://www.sp.se/pne/ElectricalMetrology/ElMeteng/frameset.htm</A><BR>
 131 <BR>
 132   </P>
 133 </BLOCKQUOTE>
 134
 135 <H4>Fudge Factors</H4>
 136
 137 <DL>
 138   <DT><TT>time1 <I>time</I></TT>
 139   <DD>Specifies the time offset calibration factor, in seconds
 140   and fraction, with default 0.0.
 141   <DT><TT>time2 <I>time</I></TT>
 142   <DD>Not used by this driver.
 143   <DT><TT>stratum <I>number</I></TT>
 144   <DD>Specifies the driver stratum, in decimal from 0 to 15, with
 145   default 0.
 146   <DT><TT>refid <I>string</I></TT>
 147   <DD>Specifies the driver reference identifier, an ASCII string
 148   from one to four characters, with default PTB.
 149   <DT><TT>flag1 0 | 1</TT>
 150   <DD>Not used by this driver.
 151   <DT><TT>flag2 0 | 1</TT>
 152   <DD>Not used by this driver.
 153   <DT><TT>flag3 0 | 1</TT>
 154   <DD>Not used by this driver.
 155   <DT><TT>flag4 0 | 1</TT>
 156   <DD>Not used by this driver.
 157 </DL>
 158
 159 <P>Additional Information</P>
 160
 161 <P>A keyword in the ntp.conf file permits a direct connection
 162 to a serial port of  source of time like IEN CTD signal. It is
 163 sufficient to use the string DIRECT in place of the phone number.</P>
 164
 165 <P>Example:</P>
 166
 167 <P><FONT FACE="Courier New">server 127.127.23.1</FONT></P>
 168
 169 <P><FONT FACE="Courier New">phone DIRECT</FONT></P>
 170
 171 <P><A HREF="refclock.htm">Reference Clock Drivers</A>&nbsp; <HR ALIGN=LEFT></P>
 172
 173 <ADDRESS>by Marco Mascarello (masca@tf.ien.it) for David L. Mills
 174 (mills@udel.edu)</ADDRESS>
 175
 176 </BODY>
 177 </HTML>
 178