1 /* radiotrack (radioreveal) driver for Linux radio support
3 * Converted to V4L2 API by Mauro Carvalho Chehab <mchehab@infradead.org>
4 * Converted to new API by Alan Cox <alan@lxorguk.ukuu.org.uk>
5 * Various bugfixes and enhancements by Russell Kroll <rkroll@exploits.org>
8 * 1999-02-24 Russell Kroll <rkroll@exploits.org>
9 * Fine tuning/VIDEO_TUNER_LOW
10 * Frequency range expanded to start at 87 MHz
12 * TODO: Allow for more than one of these foolish entities :-)
14 * Notes on the hardware (reverse engineered from other peoples'
15 * reverse engineering of AIMS' code :-)
17 * Frequency control is done digitally -- ie out(port,encodefreq(95.8));
19 * The signal strength query is unsurprisingly inaccurate. And it seems
20 * to indicate that (on my card, at least) the frequency setting isn't
21 * too great. (I have to tune up .025MHz from what the freq should be
22 * to get a report that the thing is tuned.)
24 * Volume control is (ugh) analogue:
25 * out(port, start_increasing_volume);
27 * out(port, stop_changing_the_volume);
31 #include <linux/module.h> /* Modules */
32 #include <linux/init.h> /* Initdata */
33 #include <linux/ioport.h> /* request_region */
34 #include <linux/videodev2.h> /* kernel radio structs */
35 #include <linux/version.h> /* for KERNEL_VERSION MACRO */
36 #include <linux/io.h> /* outb, outb_p */
37 #include <media/v4l2-device.h>
38 #include <media/v4l2-ioctl.h>
40 MODULE_AUTHOR("M.Kirkwood");
41 MODULE_DESCRIPTION("A driver for the RadioTrack/RadioReveal radio card.");
42 MODULE_LICENSE("GPL");
44 #ifndef CONFIG_RADIO_RTRACK_PORT
45 #define CONFIG_RADIO_RTRACK_PORT -1
48 static int io
= CONFIG_RADIO_RTRACK_PORT
;
49 static int radio_nr
= -1;
51 module_param(io
, int, 0);
52 MODULE_PARM_DESC(io
, "I/O address of the RadioTrack card (0x20f or 0x30f)");
53 module_param(radio_nr
, int, 0);
55 #define RADIO_VERSION KERNEL_VERSION(0, 0, 2)
59 struct v4l2_device v4l2_dev
;
60 struct video_device vdev
;
63 unsigned long curfreq
;
69 static struct rtrack rtrack_card
;
73 static void rt_decvol(struct rtrack
*rt
)
75 outb(0x58, rt
->io
); /* volume down + sigstr + on */
77 outb(0xd8, rt
->io
); /* volume steady + sigstr + on */
80 static void rt_incvol(struct rtrack
*rt
)
82 outb(0x98, rt
->io
); /* volume up + sigstr + on */
84 outb(0xd8, rt
->io
); /* volume steady + sigstr + on */
87 static void rt_mute(struct rtrack
*rt
)
90 mutex_lock(&rt
->lock
);
91 outb(0xd0, rt
->io
); /* volume steady, off */
92 mutex_unlock(&rt
->lock
);
95 static int rt_setvol(struct rtrack
*rt
, int vol
)
99 mutex_lock(&rt
->lock
);
101 if (vol
== rt
->curvol
) { /* requested volume = current */
102 if (rt
->muted
) { /* user is unmuting the card */
104 outb(0xd8, rt
->io
); /* enable card */
106 mutex_unlock(&rt
->lock
);
110 if (vol
== 0) { /* volume = 0 means mute the card */
111 outb(0x48, rt
->io
); /* volume down but still "on" */
112 msleep(2000); /* make sure it's totally down */
113 outb(0xd0, rt
->io
); /* volume steady, off */
114 rt
->curvol
= 0; /* track the volume state! */
115 mutex_unlock(&rt
->lock
);
120 if (vol
> rt
->curvol
)
121 for (i
= rt
->curvol
; i
< vol
; i
++)
124 for (i
= rt
->curvol
; i
> vol
; i
--)
128 mutex_unlock(&rt
->lock
);
132 /* the 128+64 on these outb's is to keep the volume stable while tuning
133 * without them, the volume _will_ creep up with each frequency change
134 * and bit 4 (+16) is to keep the signal strength meter enabled
137 static void send_0_byte(struct rtrack
*rt
)
139 if (rt
->curvol
== 0 || rt
->muted
) {
140 outb_p(128+64+16+ 1, rt
->io
); /* wr-enable + data low */
141 outb_p(128+64+16+2+1, rt
->io
); /* clock */
144 outb_p(128+64+16+8+ 1, rt
->io
); /* on + wr-enable + data low */
145 outb_p(128+64+16+8+2+1, rt
->io
); /* clock */
150 static void send_1_byte(struct rtrack
*rt
)
152 if (rt
->curvol
== 0 || rt
->muted
) {
153 outb_p(128+64+16+4 +1, rt
->io
); /* wr-enable+data high */
154 outb_p(128+64+16+4+2+1, rt
->io
); /* clock */
157 outb_p(128+64+16+8+4 +1, rt
->io
); /* on+wr-enable+data high */
158 outb_p(128+64+16+8+4+2+1, rt
->io
); /* clock */
164 static int rt_setfreq(struct rtrack
*rt
, unsigned long freq
)
168 mutex_lock(&rt
->lock
); /* Stop other ops interfering */
172 /* now uses VIDEO_TUNER_LOW for fine tuning */
174 freq
+= 171200; /* Add 10.7 MHz IF */
175 freq
/= 800; /* Convert to 50 kHz units */
177 send_0_byte(rt
); /* 0: LSB of frequency */
179 for (i
= 0; i
< 13; i
++) /* : frequency bits (1-13) */
185 send_0_byte(rt
); /* 14: test bit - always 0 */
186 send_0_byte(rt
); /* 15: test bit - always 0 */
188 send_0_byte(rt
); /* 16: band data 0 - always 0 */
189 send_0_byte(rt
); /* 17: band data 1 - always 0 */
190 send_0_byte(rt
); /* 18: band data 2 - always 0 */
191 send_0_byte(rt
); /* 19: time base - always 0 */
193 send_0_byte(rt
); /* 20: spacing (0 = 25 kHz) */
194 send_1_byte(rt
); /* 21: spacing (1 = 25 kHz) */
195 send_0_byte(rt
); /* 22: spacing (0 = 25 kHz) */
196 send_1_byte(rt
); /* 23: AM/FM (FM = 1, always) */
198 if (rt
->curvol
== 0 || rt
->muted
)
199 outb(0xd0, rt
->io
); /* volume steady + sigstr */
201 outb(0xd8, rt
->io
); /* volume steady + sigstr + on */
203 mutex_unlock(&rt
->lock
);
208 static int rt_getsigstr(struct rtrack
*rt
)
212 mutex_lock(&rt
->lock
);
213 if (inb(rt
->io
) & 2) /* bit set = no signal present */
215 mutex_unlock(&rt
->lock
);
219 static int vidioc_querycap(struct file
*file
, void *priv
,
220 struct v4l2_capability
*v
)
222 strlcpy(v
->driver
, "radio-aimslab", sizeof(v
->driver
));
223 strlcpy(v
->card
, "RadioTrack", sizeof(v
->card
));
224 strlcpy(v
->bus_info
, "ISA", sizeof(v
->bus_info
));
225 v
->version
= RADIO_VERSION
;
226 v
->capabilities
= V4L2_CAP_TUNER
| V4L2_CAP_RADIO
;
230 static int vidioc_g_tuner(struct file
*file
, void *priv
,
231 struct v4l2_tuner
*v
)
233 struct rtrack
*rt
= video_drvdata(file
);
238 strlcpy(v
->name
, "FM", sizeof(v
->name
));
239 v
->type
= V4L2_TUNER_RADIO
;
240 v
->rangelow
= 87 * 16000;
241 v
->rangehigh
= 108 * 16000;
242 v
->rxsubchans
= V4L2_TUNER_SUB_MONO
;
243 v
->capability
= V4L2_TUNER_CAP_LOW
;
244 v
->audmode
= V4L2_TUNER_MODE_MONO
;
245 v
->signal
= 0xffff * rt_getsigstr(rt
);
249 static int vidioc_s_tuner(struct file
*file
, void *priv
,
250 struct v4l2_tuner
*v
)
252 return v
->index
? -EINVAL
: 0;
255 static int vidioc_s_frequency(struct file
*file
, void *priv
,
256 struct v4l2_frequency
*f
)
258 struct rtrack
*rt
= video_drvdata(file
);
260 if (f
->tuner
!= 0 || f
->type
!= V4L2_TUNER_RADIO
)
262 rt_setfreq(rt
, f
->frequency
);
266 static int vidioc_g_frequency(struct file
*file
, void *priv
,
267 struct v4l2_frequency
*f
)
269 struct rtrack
*rt
= video_drvdata(file
);
273 f
->type
= V4L2_TUNER_RADIO
;
274 f
->frequency
= rt
->curfreq
;
278 static int vidioc_queryctrl(struct file
*file
, void *priv
,
279 struct v4l2_queryctrl
*qc
)
282 case V4L2_CID_AUDIO_MUTE
:
283 return v4l2_ctrl_query_fill(qc
, 0, 1, 1, 1);
284 case V4L2_CID_AUDIO_VOLUME
:
285 return v4l2_ctrl_query_fill(qc
, 0, 0xff, 1, 0xff);
290 static int vidioc_g_ctrl(struct file
*file
, void *priv
,
291 struct v4l2_control
*ctrl
)
293 struct rtrack
*rt
= video_drvdata(file
);
296 case V4L2_CID_AUDIO_MUTE
:
297 ctrl
->value
= rt
->muted
;
299 case V4L2_CID_AUDIO_VOLUME
:
300 ctrl
->value
= rt
->curvol
;
306 static int vidioc_s_ctrl(struct file
*file
, void *priv
,
307 struct v4l2_control
*ctrl
)
309 struct rtrack
*rt
= video_drvdata(file
);
312 case V4L2_CID_AUDIO_MUTE
:
316 rt_setvol(rt
, rt
->curvol
);
318 case V4L2_CID_AUDIO_VOLUME
:
319 rt_setvol(rt
, ctrl
->value
);
325 static int vidioc_g_input(struct file
*filp
, void *priv
, unsigned int *i
)
331 static int vidioc_s_input(struct file
*filp
, void *priv
, unsigned int i
)
333 return i
? -EINVAL
: 0;
336 static int vidioc_g_audio(struct file
*file
, void *priv
,
337 struct v4l2_audio
*a
)
340 strlcpy(a
->name
, "Radio", sizeof(a
->name
));
341 a
->capability
= V4L2_AUDCAP_STEREO
;
345 static int vidioc_s_audio(struct file
*file
, void *priv
,
346 struct v4l2_audio
*a
)
348 return a
->index
? -EINVAL
: 0;
351 static const struct v4l2_file_operations rtrack_fops
= {
352 .owner
= THIS_MODULE
,
353 .unlocked_ioctl
= video_ioctl2
,
356 static const struct v4l2_ioctl_ops rtrack_ioctl_ops
= {
357 .vidioc_querycap
= vidioc_querycap
,
358 .vidioc_g_tuner
= vidioc_g_tuner
,
359 .vidioc_s_tuner
= vidioc_s_tuner
,
360 .vidioc_g_audio
= vidioc_g_audio
,
361 .vidioc_s_audio
= vidioc_s_audio
,
362 .vidioc_g_input
= vidioc_g_input
,
363 .vidioc_s_input
= vidioc_s_input
,
364 .vidioc_g_frequency
= vidioc_g_frequency
,
365 .vidioc_s_frequency
= vidioc_s_frequency
,
366 .vidioc_queryctrl
= vidioc_queryctrl
,
367 .vidioc_g_ctrl
= vidioc_g_ctrl
,
368 .vidioc_s_ctrl
= vidioc_s_ctrl
,
371 static int __init
rtrack_init(void)
373 struct rtrack
*rt
= &rtrack_card
;
374 struct v4l2_device
*v4l2_dev
= &rt
->v4l2_dev
;
377 strlcpy(v4l2_dev
->name
, "rtrack", sizeof(v4l2_dev
->name
));
381 v4l2_err(v4l2_dev
, "you must set an I/O address with io=0x20f or 0x30f\n");
385 if (!request_region(rt
->io
, 2, "rtrack")) {
386 v4l2_err(v4l2_dev
, "port 0x%x already in use\n", rt
->io
);
390 res
= v4l2_device_register(NULL
, v4l2_dev
);
392 release_region(rt
->io
, 2);
393 v4l2_err(v4l2_dev
, "could not register v4l2_device\n");
397 strlcpy(rt
->vdev
.name
, v4l2_dev
->name
, sizeof(rt
->vdev
.name
));
398 rt
->vdev
.v4l2_dev
= v4l2_dev
;
399 rt
->vdev
.fops
= &rtrack_fops
;
400 rt
->vdev
.ioctl_ops
= &rtrack_ioctl_ops
;
401 rt
->vdev
.release
= video_device_release_empty
;
402 video_set_drvdata(&rt
->vdev
, rt
);
404 /* Set up the I/O locking */
406 mutex_init(&rt
->lock
);
408 /* mute card - prevents noisy bootups */
410 /* this ensures that the volume is all the way down */
411 outb(0x48, rt
->io
); /* volume down but still "on" */
412 msleep(2000); /* make sure it's totally down */
413 outb(0xc0, rt
->io
); /* steady volume, mute card */
415 if (video_register_device(&rt
->vdev
, VFL_TYPE_RADIO
, radio_nr
) < 0) {
416 v4l2_device_unregister(&rt
->v4l2_dev
);
417 release_region(rt
->io
, 2);
420 v4l2_info(v4l2_dev
, "AIMSlab RadioTrack/RadioReveal card driver.\n");
425 static void __exit
rtrack_exit(void)
427 struct rtrack
*rt
= &rtrack_card
;
429 video_unregister_device(&rt
->vdev
);
430 v4l2_device_unregister(&rt
->v4l2_dev
);
431 release_region(rt
->io
, 2);
434 module_init(rtrack_init
);
435 module_exit(rtrack_exit
);