xref: /netbsd-src/external/bsd/ntp/dist/scripts/stats/README.timecodes (revision abb0f93cd77b67f080613360c65701f85e5f5cfe)
1*abb0f93cSkardelRadio Timecode Formats (README.timecodes)
2*abb0f93cSkardel
3*abb0f93cSkardelFollowing are examples of the serial timecode formats used by various
4*abb0f93cSkardeltimecode receivers as given in the instruction manuals. These examples
5*abb0f93cSkardelare intended only for illustration and not as the basis of system
6*abb0f93cSkardeldesign. The following symbols are used to identify the timecode
7*abb0f93cSkardelcharacter that begins a subfield. The values given after this symbol
8*abb0f93cSkardelrepresent the character offset from the beginning of the timecode string
9*abb0f93cSkardelas edited to remove control characters.
10*abb0f93cSkardel
11*abb0f93cSkardelC         on-time character (start bit)
12*abb0f93cSkardelY         year of century
13*abb0f93cSkardelT         time of day
14*abb0f93cSkardelD         day of year or month/day
15*abb0f93cSkardelA         alarm indicator (format specific)
16*abb0f93cSkardelQ         quality indicator (format specific)
17*abb0f93cSkardel<LF>      ASCII line feed (hex 0a)
18*abb0f93cSkardel<CR>      ASCII carriage return (hex 0d)
19*abb0f93cSkardel<SP>      ASCII space (hex 20)
20*abb0f93cSkardel
21*abb0f93cSkardelIn order to promote uniform behavior in the various implementations, it
22*abb0f93cSkardelis useful to have a common interpretation of alarm conditions and signal
23*abb0f93cSkardelquality. When the alarm indicator it on, the receiver is not operating
24*abb0f93cSkardelcorrectly or has never synchronized to the broadcast signal. When the
25*abb0f93cSkardelalarm indicator is off and the quality indicator is on, the receiver has
26*abb0f93cSkardelsynchronized to the broadcast signal, then lost the signal and is
27*abb0f93cSkardelcoasting on its internal oscillator.
28*abb0f93cSkardel
29*abb0f93cSkardelIn the following uppercase letters, punctuation marks and spaces <SP>
30*abb0f93cSkardelstand for themselves; lowercase letters stand for fields as described.
31*abb0f93cSkardelSpecial characters other than <LF>, <CR> and <SP> are preceded by ^.
32*abb0f93cSkardel
33*abb0f93cSkardelSpectracom 8170 and Netclock/2 WWV Synchonized Clock (format 0)
34*abb0f93cSkardel
35*abb0f93cSkardel"<CR><LF>i  ddd hh:mm:ss  TZ=zz<CR><LF>"
36*abb0f93cSkardel C       A  D   T
37*abb0f93cSkardel
38*abb0f93cSkardel     poll: ?; offsets: Y = none, D = 3, T = 7, A = 0, Q = none
39*abb0f93cSkardel     i = synchronization flag (<SP> = in synch, ? = out synch)
40*abb0f93cSkardel     ddd = day of year
41*abb0f93cSkardel     hh:mm:ss = hours, minutes, seconds
42*abb0f93cSkardel     zz = timezone offset (hours from UTC)
43*abb0f93cSkardel
44*abb0f93cSkardel     Note: alarm condition is indicated by other than <SP> at A, which
45*abb0f93cSkardel     occurs during initial synchronization and when received signal has
46*abb0f93cSkardel     been lost for about ten hours
47*abb0f93cSkardel
48*abb0f93cSkardel     example: "   216 15:36:43  TZ=0"
49*abb0f93cSkardel               A  D   T
50*abb0f93cSkardel
51*abb0f93cSkardelNetclock/2 WWV Synchonized Clock (format 2)
52*abb0f93cSkardel
53*abb0f93cSkardel"<CR><LF>iqyy ddd hh:mm:ss.fff ld"
54*abb0f93cSkardel C       AQY  D   T
55*abb0f93cSkardel
56*abb0f93cSkardel     poll: ?; offsets: Y = 2, D = 5, T = 9, A = 0, Q = 1
57*abb0f93cSkardel     i = synchronization flag (<SP> = in synch, ? = out synch)
58*abb0f93cSkardel     q = quality indicator (<SP> < 1ms, A < 10 ms, B < 100 ms, C < 500
59*abb0f93cSkardel     ms, D > 500 ms)
60*abb0f93cSkardel     yy = year (as broadcast)
61*abb0f93cSkardel     ddd = day of year
62*abb0f93cSkardel     hh:mm:ss.fff = hours, minutes, seconds, milliseconds of day
63*abb0f93cSkardel     l = leap-second warning (L indicates leap at end of month)
64*abb0f93cSkardel     d = standard/daylight time indicator (<SP> standard, D daylight)
65*abb0f93cSkardel
66*abb0f93cSkardel     Note: alarm condition is indicated by other than <SP> at A, which
67*abb0f93cSkardel     occurs during initial synchronization and when received signal has
68*abb0f93cSkardel     been lost for about ten hours; unlock condition is indicated by
69*abb0f93cSkardel     other than <SP> at Q, with time since last lock indicated by the
70*abb0f93cSkardel     letter code A < 13 min, B < 1.5 hr, C < 7 hr, D > 7 hr.
71*abb0f93cSkardel
72*abb0f93cSkardel     example: "  92 216 15:36:43.640  D"
73*abb0f93cSkardel               AQ   D   T
74*abb0f93cSkardel
75*abb0f93cSkardelTrueTime 468-DC Satellite Synchronized Clock (and other TrueTime
76*abb0f93cSkardelreceivers)
77*abb0f93cSkardel
78*abb0f93cSkardel"<CR><LF><^A>ddd:hh:mm:ssq<CR>"
79*abb0f93cSkardel              D   T       QC
80*abb0f93cSkardel
81*abb0f93cSkardel     poll: none; offsets: Y = none, D = 0, T = 4, A = 12, Q = 12
82*abb0f93cSkardel     hh:mm:ss = hours, minutes, seconds
83*abb0f93cSkardel     q = quality/alarm indicator (<SP> = locked, ? = alarm)
84*abb0f93cSkardel
85*abb0f93cSkardel     Note: alarm condition is indicated by ? at A, which occurs during
86*abb0f93cSkardel     initial synchronization and when received signal is lost for an
87*abb0f93cSkardel     extended period; unlock condition is indicated by other than <SP>
88*abb0f93cSkardel     at Q
89*abb0f93cSkardel
90*abb0f93cSkardel     example: "216:15:36:43 "
91*abb0f93cSkardel               D   T       Q
92*abb0f93cSkardel
93*abb0f93cSkardelHeath GC-1000 Most Accurate Clock (WWV/H)
94*abb0f93cSkardel
95*abb0f93cSkardel"<CR>hh:mm:ss.f     dd/mm/yy<CR>"
96*abb0f93cSkardel C   T        A     D
97*abb0f93cSkardel
98*abb0f93cSkardel     poll: none; offsets: Y = none, D = 15, T = 0, A = 9, Q = none
99*abb0f93cSkardel     hh:mm:ss = hours, minutes, seconds
100*abb0f93cSkardel     f = deciseconds (? when out of spec)
101*abb0f93cSkardel     dd/mm = day, month
102*abb0f93cSkardel     yy = year of century (from DIPswitches)
103*abb0f93cSkardel
104*abb0f93cSkardel     Note: 0?:??:??.? is displayed before synch is first established and
105*abb0f93cSkardel     hh:mm:ss.? once synch is established and then lost again for about
106*abb0f93cSkardel     a day.
107*abb0f93cSkardel
108*abb0f93cSkardel     example: "15:36:43.6     04/08/91"
109*abb0f93cSkardel               T        A     D     Y
110*abb0f93cSkardel
111*abb0f93cSkardelPST/Traconex 1020 Time Source (WWV/H) (firmware revision V4.01)
112*abb0f93cSkardel
113*abb0f93cSkardel"frdzycchhSSFTttttuuxx<CR>" "ahh:mm:ss.fffs<CR>" "yy/dd/mm/ddd<CR>"
114*abb0f93cSkardel          A   Q               T                   Y  D
115*abb0f93cSkardel
116*abb0f93cSkardel     poll: "QMQDQT"; offsets: Y = 0, D = 3 T = 1,, A = 11, Q = 13
117*abb0f93cSkardel     f = frequency enable (O = all frequencies enabled)
118*abb0f93cSkardel     r = baud rate (3 = 1200, 6 = 9600)
119*abb0f93cSkardel     d = features indicator (@ = month/day display enabled)
120*abb0f93cSkardel     z = time zone (0 = UTC)
121*abb0f93cSkardel     y = year (5 = 1991)
122*abb0f93cSkardel     cc = WWV propagation delay (52 = 22 ms)
123*abb0f93cSkardel     hh = WWVH propagation delay (81 = 33 ms)
124*abb0f93cSkardel     SS = status (80 or 82 = operating correctly)
125*abb0f93cSkardel     F = current receive frequency (1-5 = 2.5, 5, 10, 15, 20 MHz)
126*abb0f93cSkardel     T = transmitter (C = WWV, H = WWVH)
127*abb0f93cSkardel     tttt = time since last update (minutes)
128*abb0f93cSkardel     uu = flush character (03 = ^C)
129*abb0f93cSkardel     xx = 94 (unknown) (firmware revision X4.01.999 only)
130*abb0f93cSkardel
131*abb0f93cSkardel     a = AM/PM indicator (A = AM, P = PM, <SP> - 24-hour format)
132*abb0f93cSkardel     hh:mm:ss.fff = hours, minutes, seconds, milliseconds of day
133*abb0f93cSkardel     s = daylight-saving indicator (<SP> standard, D daylight)
134*abb0f93cSkardel
135*abb0f93cSkardel     yy = year of century (from DIPswitches)
136*abb0f93cSkardel     dd/mm/ddd = day of month, month of year, day of year
137*abb0f93cSkardel
138*abb0f93cSkardel     Note: The alarm condition is indicated by other than ? at A, which
139*abb0f93cSkardel     occurs during initial synchronization and when received signal is
140*abb0f93cSkardel     lost for an extended period. A receiver unlock condition is
141*abb0f93cSkardel     indicated by other than "0000" in the tttt subfield at Q.
142*abb0f93cSkardel
143*abb0f93cSkardel     example: "O3@055281824C00000394 91/08/04/216  15:36:43.640"
144*abb0f93cSkardel                             T       Y        D    T
145*abb0f93cSkardel
146*abb0f93cSkardelDavid L. Mills
147*abb0f93cSkardelUniversity of Delaware
148*abb0f93cSkardelmills@udel.edu
149*abb0f93cSkardel23 October 1993
150