1fmio(1) BSD General Commands Manual fmio(1)
2
4 fmio — small utility to manipulate fm radio card
5
7 fmio [-d driver] [-f freq] [-i] [-m] [-s] [-v vol] [-x vol] [-X vol]
8 fmio [-d driver] -S [-c count] [-l begin] [-h end]
9 fmio [-d driver] -W frequency
10 fmio -D
11
13 The fmio is a small program to set and change fm radio card parameters.
14 It sets frequency, volume of a card, reports signal strength on the work‐
16 ing frequency and can set a radio card output to mono provided that the
17 card driver supports it.
18 The fmio has two additional modes - scanning and detection. In the scan
20 mode fmio scans frequency range with step 10 kHz and outputs measured
21 signal strength. Frequency range and number of probes for each frequency
22 are configurable. In the detection mode fmio detects any supported radio
23 card. Use this mode if you are not sure which card you have or do not
24 know which port your card uses.
25 Also, it can control the output volume of a sound card through
27 /dev/mixer.
28 The options are as follows:
30 -d driver
32 Use driver driver. See list of currently known drivers in section
33 DRIVERS. If no driver was specified, default one will be used.
34 -f freq
36 Set fm card frequency (in MHz).
37 -i Show all available information about a driver and a card.
39 -m Set output of a card to mono. Works only in conjunction with option
41 -f. Note, that not all drivers support this option.
42 -s Show current signal status of a radio card.
44 -v volume
46 Set volume of a card. Option -v 0 will mute a card. Each driver
47 has its own maximal volume.
48 -x volume
50 Set volume of an arbitrary mixer line of a sound card thru
51 /dev/mixer. The volume has following format:
52 <line name>=[+-]<left channel>,[+-]<right channel>.
54 For the line names see
56 under OpenBSD and NetBSD: /usr/include/sys/audioio.h
57 under Linux and FreeBSD: /usr/include/sys/soundcard.h
58 Some examples of the option -x usage are in the section EXAMPLES
60 below.
61 -X volume
63 Set volume of the sound card master output through /dev/mixer. For‐
64 mat of this option is similar to option -x, except there is no need
65 to specify <line name>.
66 -D Detection mode. All known cards will be probed and results will be
68 printed to standard output. Note, this procedure is very slow.
69 -S Scan mode. If some of the listed below parameters were not speci‐
71 fied the FM maximal and minimal frequencies are used. Measured data
72 is dumped to standard output.
73 -l begin
75 Lower border of scan range (in MHz). If it is less than the FM min‐
76 imal frequency (87.5 MHz), it is set to the FM minimal frequency.
77 -h end
79 Upper border of scan range (in MHz). If it is greater than the FM
80 maximal frequency (108.0 MHz), it is set to the FM maximal fre‐
81 quency.
82 -c count
84 Number of probes for each frequency. The higher this number is the
85 more precise will be results. Since stereo signal has weight 3,
86 none - weight 0 and mono is in between, the strongest signal will
87 have value 3 * count. If not set, each frequency will be probed
88 only once.
89 -W frequency
91 Search mode. Nearest to frequency station is searched and, if
92 found, tuned to. The search direction is determined by frequency
93 sign. If frequency has negative value, the station is searched
94 downward. If frequency is positive the search is performed upward.
95
97 Aztech/PackardBell FM Radio Card (ISA) ‘az’
98 port 0x350 - az1
99 port 0x358 - az2
100 Volume - 0 .. 3
101 Can set mono - yes
102 Software search
103 Brooktree Bt848 Driver ‘bktr’
105 Volume - 0 .. 1
106 Can set mono - yes
107 Software search
108 Use with bktrctl
109 BMC FM Radio Card (ISA) ‘bmc’
111 port 0x20F - bmc1
112 port 0x30F - bmc2
113 Volume - 0 .. 15
114 Can set mono - yes
115 Search not implemented yet
116 BSD Radio Driver ‘br’
118 Volume - 0 .. 255
119 Can set mono - yes
120 Software search
121 EcoRadio Card (ISA) ‘er’
123 port 0x316 - er1
124 port 0x336 - er2
125 Volume - 0 .. 3
126 Can set mono - no
127 Search not implemented yet
128 Detection not implemented yet
129 Gemtek FM Radio Card (ISA) ‘gti’
131 port 0x20c - gti1
132 port 0x30c - gti2
133 port 0x24c - gti3
134 port 0x34c - gti4
135 port 0x248 - gti5
136 Volume - 0 .. 1
137 Can set mono - no
138 Software search
139 Gemtek FM Radio Card (PCI) ‘gtp’
141 Volume - 0 .. 1
142 Can set mono - yes
143 Hardware search
144 AIMS Lab Highway Xtreme TV card with FM tuner Driver ‘hx’
146 Volume - 0 .. 1
147 Can set mono - yes
148 Software search
149 BSD only
150 Use with bktrctl
151 Needs kernel with ‘option BT848_GPIO_ACCESS’
152 Guillemot MaxiRadio FM 2000 Radio Card (PCI) ‘mr’
154 Volume - 0 .. 1
155 Can set mono - yes
156 Hardware search
157 AIMS Lab RadioTrack/RadioReveal RA300 FM Radio Card (ISA) ‘rt’
159 port 0x20c - rt1
160 port 0x30c - rt2
161 Volume - 0 .. 10
162 Can set mono - yes
163 Software search
164 AIMS Lab RadioTrack II FM Radio Card (ISA) ‘rtII’
166 port 0x20c - rtII1
167 port 0x30c - rtII2
168 Volume - 0 .. 1
169 Can set mono - yes
170 Hardware search
171 SoundForte Awesome 64R SF64-PCE2 Driver (PCI) ‘sae’
173 Volume - 0 .. 1
174 Can set mono - yes
175 Hardware Search
176 SoundForte Legacy 128 SF16-FMD2 Driver (ISA) ‘sf2d’
178 port 0x284 - sf2d1
179 port 0x384 - sf2d2
180 Volume - 0 .. 1
181 Can set mono - yes
182 Search not implemented yet
183 Detection not implemented yet
184 SoundForte RadioX SF16-FMI Driver (ISAPNP) ‘sfi’
186 Also known as Creative ViBRA 16c PnP
187 port 0x284 - sfi1
188 port 0x384 - sfi2
189 Volume - 0 .. 1
190 Can set mono - no
191 Search not implemented yet
192 Detection not implemented yet
193 SoundForte RadioLink SF16-FMR FM Radio Card (ISA) ‘sfr’
195 port 0x284 - sfr1
196 port 0x384 - sfr2
197 Volume - 0 .. 15
198 Can set mono - no
199 Use with fmrinit
200 Search not implemented yet
201 SoundForte RadioLink SF16-FMR2 FM Radio Card (ISA) ‘sf2r’
203 Volume - 0 .. 1
204 Can set mono - yes
205 Hardware search
206 SoundForte RadioLink SF64-PCR FM Radio Card (PCI) ‘sf4r’
208 Volume - 0 .. 1
209 Can set mono - yes
210 Software search
211 Spase PCRadio Card (ISA) ‘sp’
213 port 0x1b0 - sp1
214 port 0x1f0 - sp2
215 port 0x278 - sp3
216 port 0x378 - sp4
217 port 0x2f8 - sp5
218 port 0x3bc - sp6
219 Volume - 0 .. 63
220 Can set mono - yes
221 Search not implemented yet
222 SoundForte Quad X-treme SF256-PCP-R Driver (PCI) ‘sqx’
224 Volume - 0 .. 1
225 Can set mono - yes
226 Hardware search
227 SoundForte Theatre X-treme 5.1 SF256-PCS-R Driver (PCI) ‘stx’
229 Volume - 0 .. 1
230 Can set mono - yes
231 Hardware search
232 Sound Vision 16 Gold Sound Card with FM Radio (ISA) ‘svg’
234 Volume - 0 .. 1
235 Can set mono - no
236 Software search
237 Trust FM Radio Card (ISA) ‘tr’
239 Volume - 0 .. 63
240 Can set mono - yes
241 Software search
242 Terratec FM Radio Card (ISAPNP) ‘tt’
244 Volume - 0 .. 7
245 Can set mono - yes
246 Hardware search
247 Video4Linux Driver ‘v4l’
249 Volume - 0 .. 10
250 Can set mono - yes
251 Software search
252 Zoltrix RadioPlus 108 FM Radio Card (ISA) ‘zx’
254 port 0x20c - zx1
255 port 0x30c - zx2
256 Volume - 0 .. 16
257 Can set mono - yes
258 Software search
259
261 Set frequency to 104.5 MHz:
262 # fmio -f 104.5
264 Set frequency to 104.5 MHz and show signal state on this frequency:
266 # fmio -f 104.5 -s
268 Set frequency to 104.5 MHz, hardware volume to 4:
270 # fmio -v 4 -f 104.5
272 Set volume of both channels of line input to 9:
274 # fmio -x line=9
276 For line1, increase volume of left channel by 2, set volume of right
278 channel to 10:
279 # fmio -x line1=+2,10
281 For master output, increase volume of left channel by 2 and decrease vol‐
283 ume of right channel by 1:
284 # fmio -X +2,-1
286 Decrease volume of both channels by 2:
288 # fmio -X -2
290 Scan range [100.0...107.6] using driver ‘bktr’:
292 # fmio -d bktr -S -l 100.0 -h 107.6
294 Search station below 104.3 MHz using driver ‘sf2r’:
296 # fmio -d sf2r -W -104.3
298 Detect all available cards:
300 # fmio -D
302
304 /dev/mixer mixer audio device
305 /dev/tuner radio tuner device used by the BSD bktr driver.
307 /dev/radio radio tuner device used by ‘v4l’ driver (Linux) and ‘br’
309 driver (OpenBSD and NetBSD)
310
312 The following environment variables affect the execution of fmio:
313 FMTUNER The driver that should be used as default.
315 RADIODEVICE
317 The radio tuner device (OpenBSD, NetBSD and Linux).
318 MIXERDEVICE
320 The audio mixer device to use.
321
323 Frequency and hardware volume should be absolute. They cannot be
324 increased or decreased relatively to the current value.
325 The Gemtek PCI card implementation has some flaw. Namely, when turning a
327 card off, don't use option -f.
328 The SF16-FMR card has 16 volume levels. Thus, fmio -f 104.5 can be eas‐
330 ily taken in as fmio -v 0. Use some volume level when setting up a fre‐
331 quency. Also, this card has to be initialized during bootup. Launch
332 fmrinit from some start script (most likely /etc/rc.local).
333 There's a flaw in the BSD bktr driver - after closing /dev/tuner a card
335 is turned off too. Thus, you cannot use fmio alone to manage bktr cards
336 because fmio opens /dev/tuner, tunes a card to some frequency and closes
337 /dev/tuner - and a card is turned off. Since fmio cannot hold /dev/tuner
338 open all the time, use it with bktrctl. The same concerns Linux users.
339 Some cards supported by kernel are turned off after closing /dev/radio
340 (e.g. USB tuners). Use fmio with bktrctl.
341 Due to the above limitation the BSD bktr driver cannot work correctly if
343 frequency was not specified. E.g. fmio -d bktr -i will not work as
344 expected. Correct use is fmio -d bktr -f <some freq> -i.
345
347 Vladimir Popov ⟨jumbo@narod.ru⟩
348BSD November 20, 2000 BSD