1 .. SPDX-License-Identifier: GPL-2.0 2 3 The Radiotrack radio driver 4 =========================== 5 6 Author: Stephen M. Benoit <benoits@servicepro.com> 7 8 Date: Dec 14, 1996 9 10 ACKNOWLEDGMENTS 11 ---------------- 12 13 This document was made based on 'C' code for Linux from Gideon le Grange 14 (legrang@active.co.za or legrang@cs.sun.ac.za) in 1994, and elaborations from 15 Frans Brinkman (brinkman@esd.nl) in 1996. The results reported here are from 16 experiments that the author performed on his own setup, so your mileage may 17 vary... I make no guarantees, claims or warranties to the suitability or 18 validity of this information. No other documentation on the AIMS 19 Lab (http://www.aimslab.com/) RadioTrack card was made available to the 20 author. This document is offered in the hopes that it might help users who 21 want to use the RadioTrack card in an environment other than MS Windows. 22 23 WHY THIS DOCUMENT? 24 ------------------ 25 26 I have a RadioTrack card from back when I ran an MS-Windows platform. After 27 converting to Linux, I found Gideon le Grange's command-line software for 28 running the card, and found that it was good! Frans Brinkman made a 29 comfortable X-windows interface, and added a scanning feature. For hack 30 value, I wanted to see if the tuner could be tuned beyond the usual FM radio 31 broadcast band, so I could pick up the audio carriers from North American 32 broadcast TV channels, situated just below and above the 87.0-109.0 MHz range. 33 I did not get much success, but I learned about programming ioports under 34 Linux and gained some insights about the hardware design used for the card. 35 36 So, without further delay, here are the details. 37 38 39 PHYSICAL DESCRIPTION 40 -------------------- 41 42 The RadioTrack card is an ISA 8-bit FM radio card. The radio frequency (RF) 43 input is simply an antenna lead, and the output is a power audio signal 44 available through a miniature phone plug. Its RF frequencies of operation are 45 more or less limited from 87.0 to 109.0 MHz (the commercial FM broadcast 46 band). Although the registers can be programmed to request frequencies beyond 47 these limits, experiments did not give promising results. The variable 48 frequency oscillator (VFO) that demodulates the intermediate frequency (IF) 49 signal probably has a small range of useful frequencies, and wraps around or 50 gets clipped beyond the limits mentioned above. 51 52 53 CONTROLLING THE CARD WITH IOPORT 54 -------------------------------- 55 56 The RadioTrack (base) ioport is configurable for 0x30c or 0x20c. Only one 57 ioport seems to be involved. The ioport decoding circuitry must be pretty 58 simple, as individual ioport bits are directly matched to specific functions 59 (or blocks) of the radio card. This way, many functions can be changed in 60 parallel with one write to the ioport. The only feedback available through 61 the ioports appears to be the "Stereo Detect" bit. 62 63 The bits of the ioport are arranged as follows: 64 65 .. code-block:: none 66 67 MSb LSb 68 +------+------+------+--------+--------+-------+---------+--------+ 69 | VolA | VolB | ???? | Stereo | Radio | TuneA | TuneB | Tune | 70 | (+) | (-) | | Detect | Audio | (bit) | (latch) | Update | 71 | | | | Enable | Enable | | | Enable | 72 +------+------+------+--------+--------+-------+---------+--------+ 73 74 75 ==== ==== ================================= 76 VolA VolB Description 77 ==== ==== ================================= 78 0 0 audio mute 79 0 1 volume + (some delay required) 80 1 0 volume - (some delay required) 81 1 1 stay at present volume 82 ==== ==== ================================= 83 84 ==================== =========== 85 Stereo Detect Enable Description 86 ==================== =========== 87 0 No Detect 88 1 Detect 89 ==================== =========== 90 91 Results available by reading ioport >60 msec after last port write. 92 93 0xff ==> no stereo detected, 0xfd ==> stereo detected. 94 95 ============================= ============================= 96 Radio to Audio (path) Enable Description 97 ============================= ============================= 98 0 Disable path (silence) 99 1 Enable path (audio produced) 100 ============================= ============================= 101 102 ===== ===== ================== 103 TuneA TuneB Description 104 ===== ===== ================== 105 0 0 "zero" bit phase 1 106 0 1 "zero" bit phase 2 107 1 0 "one" bit phase 1 108 1 1 "one" bit phase 2 109 ===== ===== ================== 110 111 112 24-bit code, where bits = (freq*40) + 10486188. 113 The Most Significant 11 bits must be 1010 xxxx 0x0 to be valid. 114 The bits are shifted in LSb first. 115 116 ================== =========================== 117 Tune Update Enable Description 118 ================== =========================== 119 0 Tuner held constant 120 1 Tuner updating in progress 121 ================== =========================== 122 123 124 PROGRAMMING EXAMPLES 125 -------------------- 126 127 .. code-block:: none 128 129 Default: BASE <-- 0xc8 (current volume, no stereo detect, 130 radio enable, tuner adjust disable) 131 132 Card Off: BASE <-- 0x00 (audio mute, no stereo detect, 133 radio disable, tuner adjust disable) 134 135 Card On: BASE <-- 0x00 (see "Card Off", clears any unfinished business) 136 BASE <-- 0xc8 (see "Default") 137 138 Volume Down: BASE <-- 0x48 (volume down, no stereo detect, 139 radio enable, tuner adjust disable) 140 wait 10 msec 141 BASE <-- 0xc8 (see "Default") 142 143 Volume Up: BASE <-- 0x88 (volume up, no stereo detect, 144 radio enable, tuner adjust disable) 145 wait 10 msec 146 BASE <-- 0xc8 (see "Default") 147 148 Check Stereo: BASE <-- 0xd8 (current volume, stereo detect, 149 radio enable, tuner adjust disable) 150 wait 100 msec 151 x <-- BASE (read ioport) 152 BASE <-- 0xc8 (see "Default") 153 154 x=0xff ==> "not stereo", x=0xfd ==> "stereo detected" 155 156 Set Frequency: code = (freq*40) + 10486188 157 foreach of the 24 bits in code, 158 (from Least to Most Significant): 159 to write a "zero" bit, 160 BASE <-- 0x01 (audio mute, no stereo detect, radio 161 disable, "zero" bit phase 1, tuner adjust) 162 BASE <-- 0x03 (audio mute, no stereo detect, radio 163 disable, "zero" bit phase 2, tuner adjust) 164 to write a "one" bit, 165 BASE <-- 0x05 (audio mute, no stereo detect, radio 166 disable, "one" bit phase 1, tuner adjust) 167 BASE <-- 0x07 (audio mute, no stereo detect, radio 168 disable, "one" bit phase 2, tuner adjust)
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.