xref: /freebsd/contrib/ntp/html/audio.html (revision 3bdf775801b218aa5a89564839405b122f4b233e)
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
3<html>
4
5	<head>
6		<meta http-equiv="content-type" content="text/html;charset=iso-8859-1">
7		<meta name="generator" content="HTML Tidy, see www.w3.org">
8		<title>Reference Clock Audio Drivers</title>
9		<link href="scripts/style.css" type="text/css" rel="stylesheet">
10	</head>
11
12	<body>
13		<h3>Reference Clock Audio Drivers</h3>
14		<img src="pic/radio2.jpg" alt="jpg" align="left">ICOM R-72 shortwave receiver and Sure audio mixer
15		<p>Last update: <csobj format="ShortTime" h="25" locale="00000409" region="0" t="DateTime" w="61">18:36</csobj> UTC <csobj format="LongDate" h="25" locale="00000409" region="0" t="DateTime" w="246">Thursday, July 28, 2005</csobj></p>
16		<br clear="left">
17		<h4>Related Links</h4>
18		<script type="text/javascript" language="javascript" src="scripts/links8.txt"></script>
19		<h4>Table of Contents</h4>
20		<ul>
21			<li class="inline"><a href="#sound">Sound Card Drivers</a>
22			<li class="inline"><a href="#short">Shortwave Radio Drivers</a>
23			<li class="inline"><a href="#setup">Setup and Debugging Aids</a>
24		</ul>
25		<hr>
26		<h4 id="sound">Sound Card Drivers</h4>
27		<p>There are some applications in which the computer time can be disciplined to an audio signal, rather than a serial timecode and communications port or special purpose bus peripheral. This is useful in such cases where the audio signal is sent over a telephone circuit, for example, or received directly from a shortwave receiver. In such cases the audio signal can be connected via an ordinary sound card or baseboard audio codec. The suite of NTP reference clock drivers currently includes three drivers suitable for these applications. They include a driver for the Inter Range Instrumentation Group (IRIG) signals produced by many radio clocks and timing devices, another for the Canadian time/frequency radio station CHU and a third for the NIST time/frequency radio stations WWV and WWVH. The radio drivers are designed to work with ordinary inexpensive shortwave radios and may be one of the least expensive ways to build a good primary time server.</p>
28		<p>All three drivers make ample use of sophisticated digital signal processing algorithms designed to efficiently extract timing signals from noise and interference. The radio station drivers in particular implement optimum linear demodulation and decoding techniques, including maximum likelihood and soft-decision methods. The documentation page for each driver contains an in-depth discussion on the algorithms and performance expectations. In some cases the algorithms are further analyzed, modelled and evaluated in a technical report.</p>
29		<p>Currently, the audio drivers work with with Sun operating systems and audio codecs, including SunOS 4.1.3 and Solaris from 2.6 and probably all others in between. They also work with FreeBSD from 4.1 with compatible sound card. In fact, the interface is quite generic and support for other systems, in particular the various Unix generics, should not be difficult. Volunteers are solicited.</p>
30		<p>The audio drivers include a number of common features designed to groom input signals, suppress spikes and normalize signal levels. An automatic gain control (AGC) feature provides protection against overdriven or underdriven input signals. It is designed to maintain adequate demodulator signal amplitude while avoiding occasional noise spikes. In order to assure reliable operation, the signal level must be in the range where the audio gain control is effective. In general, this means the input signal level must be such as to cause the AGC to set the gain somewhere in the middle of the range from 0 to 255, as indicated in the timecode displayed by the <tt>ntpq</tt> program.</p>
31		<p>The drivers operate by disciplining a logical clock based on the codec sample clock to the audio signal as received. This is done by stuffing or slipping samples as required to maintain exact frequency to the order of 0.1 PPM. In order for the driver to reliably lock on the audio signal, the sample clock frequency tolerance must be less than 250 PPM (.025 percent) for the IRIG driver and half that for the radio drivers. The largest error observed so far is about 60 PPM, but it is possible some sound cards or codecs may exceed that value.</p>
32		<p>The drivers include provisions to select the input port and to monitor the input signal. The <tt>fudge flag 2</tt> selects the microphone port if set to zero or the line-in port if set to one. It does not seem useful to specify the compact disc player port. The <tt>fudge flag 3</tt> enables the input signal monitor using the previously selected output port and output gain. Both of these flags can be set in the configuration file or remotely using the <tt>ntpdc</tt> utility program.</p>
33		<h4 id="short">Shortwave Radio Drivers</h4>
34		<p>The WWV/H and CHU audio drivers require an external shortwave radio with the radio output - speaker or headphone jack - connected to either the microphone or line-in port on the computer. There is some degree of art in setting up the radio and antenna and getting the setup to work. While the drivers are highly sophisticated and efficient in extracting timing signals from noise and interference, it always helps to have as clear a signal as possible.</p>
35		<p>The most important factor affecting the radio signal is the antenna. It need not be long - even 15 feet is enough if it is located outside of a metal frame building, preferably on the roof, and away from metallic objects. An ordinary CB whip mounted on a PVC pipe and wooden X-frame on the roof should work well with most portable radios, as they are optimized for small antennas.</p>
36		<p>The radio need not be located near the computer; in fact, it generally works better if the radio is outside the near field of computers and other electromagnetic noisemakers. It can be in the elevator penthouse connected by house wiring, which can also be used to power the radio. A couple of center-tapped audio transformers will minimize noise pickup and provide phantom power to the radio with return via the building ground.</p>
37		<p>The WWV/H and CHU transmitters operate on several frequencies simultaneously, so that in most parts of North America at least one frequency supports propagation to the receiver location at any given hour. While both drivers support the ICOM CI-V radio interface and can tune the radio automatically, computer-tunable radios are expensive and probably not cost effective compared to a GPS receiver. So, the radio frequency must usually be fixed and chosen by compromise.</p>
38		<p>Shortwave (3-30 MHz) radio propagation phenomena are well known to shortwave enthusiasts. The phenomena generally obey the following rules:</p>
39		<ul>
40			<li>The optimum frequency is higher in daytime than nighttime, stays high longer on summer days and low longer on winter nights.
41			<li>Transitions between daytime and nightime conditions generally occur somewhat after sunrise and sunset at the midpoint of the path from transmitter to receiver.
42			<li>Ambient noise (static) on the lower frequencies follows the thunderstorm season, so is higher on summer afternoons and evenings.
43			<li>The lower frequency bands are best for shorter distances, while the higher bands are best for longer distances.
44			<li>The optimum frequencies are higher at the peak of the 11-year sunspot cycle and lower at the trough. The current sunspot cycle should peak in the first couple of years beginning the century.
45		</ul>
46		<p>The best way to choose a frequency is to listen at various times over the day and determine the best highest (daytime) and lowest (nighttime) frequencies. Then, assuming one is available, choose the highest frequency between these frequencies. This strategy assumes that the high frequency is more problematic than the low, that the low frequency probably comes with severe multipath and static, and insures that probably twice a day the chosen frequency will work. For instance, on the east coast the best compromise CHU frequency is probably 7335 kHz and the best WWV frequency is probably 15 MHz.</p>
47		<h4>Autotune Modes</h4>
48		<p>The shortwave drivers include support for an optional autotune function compatible with ICOM&nbsp;receivers and transceivers. The <tt>mode</tt> keyword of the <tt>server</tt> configuration command specifies the ICOM ID select code in decimal. A missing or zero argument disables the CI-V interface. Since all ICOM select codes are less than 128, the high order bit of the code is used by the driver to specify the baud rate. If this bit is not set, the rate is 9600 bps for the newer radios; if set, the rate is 1200 bps for the older radios. Following are the ID select codes for the known radios.</p>
49		<table width="100%" cols="6">
50			<tr>
51				<td>Radio</td>
52				<td>Hex</td>
53				<td>Decimal</td>
54				<td>Radio</td>
55				<td>Hex</td>
56				<td>Decimal</td>
57			</tr>
58			<tr>
59				<td>706</td>
60				<td>0x4e</td>
61				<td>78</td>
62				<td>775</td>
63				<td>0x46</td>
64				<td>70</td>
65			</tr>
66			<tr>
67				<td>706MKIIG</td>
68				<td>0x58</td>
69				<td>88</td>
70				<td>781</td>
71				<td>0x26</td>
72				<td>38</td>
73			</tr>
74			<tr>
75				<td>725</td>
76				<td>0x28</td>
77				<td>40</td>
78				<td>970</td>
79				<td>0x2e</td>
80				<td>46</td>
81			</tr>
82			<tr>
83				<td>726</td>
84				<td>0x30</td>
85				<td>48</td>
86				<td>R71</td>
87				<td>0x1A</td>
88				<td>26</td>
89			</tr>
90			<tr>
91				<td>735</td>
92				<td>0x04</td>
93				<td>4</td>
94				<td>R72</td>
95				<td>0x32</td>
96				<td>50</td>
97			</tr>
98			<tr>
99				<td>746</td>
100				<td>0x66</td>
101				<td>102</td>
102				<td>R75</td>
103				<td>0x5a</td>
104				<td>90</td>
105			</tr>
106			<tr>
107				<td>751</td>
108				<td>0x1c</td>
109				<td>28</td>
110				<td>R7000</td>
111				<td>0x08</td>
112				<td>8</td>
113			</tr>
114			<tr>
115				<td>756PROII</td>
116				<td>0x64</td>
117				<td>100</td>
118				<td>R7100</td>
119				<td>0x34</td>
120				<td>52</td>
121			</tr>
122			<tr>
123				<td>761</td>
124				<td>0x1e</td>
125				<td>30</td>
126				<td>R8500</td>
127				<td>0x4a</td>
128				<td>74</td>
129			</tr>
130			<tr>
131				<td>765</td>
132				<td>0x2c</td>
133				<td>44</td>
134				<td>R9000</td>
135				<td>0x2a</td>
136				<td>42</td>
137			</tr>
138		</table>
139		<h4 id="setup">Setup and Debugging Aids</h4>
140		<p>The audio drivers include extensive setup and debugging support to help hook up the audio signals and monitor the driver operations. The documentation page for each driver describes the various messages that can be produced either in real time or written to the <tt>clockstats</tt> file for later analysis. Of particular help in verifying signal connections and compatibility is a provision to monitor the signal via headphones or speaker.</p>
141		<p>Connecting radios and IRIG devices to the computer and verifying correct configuration is somewhat of a black art. The signals have to be connected to the correct ports and the signal level maintained within tolerances. Some radios have recorder outputs which produce a line level signal not affected by the volume control. These signals can be connected to the line-in port on the computer. If the level is too low, connect to the microphone-in port instead. If the radio does not have a recorder output, connect the headphone or speaker output to the line-in port and adjust the volume control so the driver indicates comfortably above the minimum specified and the AGC level somewhere in the middle of the range 0-255. IRIG signals are usually much larger than radio outputs, usually in the range to several volts and may even overload the line-in port. In such cases an attenuator must be used to reduce the signal level below the overload point.</p>
142		<p>It is very easy to underdrive or overdrive the audio codec, in which case the drivers will not synchronize to the signal. The drivers use <tt>fudge flag2</tt> to enable audio monitoring of the input signal. This is useful during setup to confirm the signal is actually reaching the audio codec and generally free of hum and interference. This feature is not intended for regular use, since it does increase the processor load on the system. Note that the speaker volume must be set before the driver is started.</p>
143		<p>The drivers write a synthesized timecode to the <tt>clockstats</tt> file each time the clock is set or verified and at other times if verbose monitoring is enabled. The format includes several fixed-length fields defining the UTC time to the millisecond, together with additional variable-length fields specific to each driver. The data include the intervals since the clock was last set or verified, the audio gain and various state variables and counters specific to each driver.</p>
144		<hr>
145		<script type="text/javascript" language="javascript" src="scripts/footer.txt"></script>
146	</body>
147
148</html>