1 /* zoltrix radio plus driver for Linux radio support
2 * (c) 1998 C. van Schaik <carl@leg.uct.ac.za>
5 * Due to the inconsistency in reading from the signal flags
6 * it is difficult to get an accurate tuned signal.
8 * It seems that the card is not linear to 0 volume. It cuts off
9 * at a low volume, and it is not possible (at least I have not found)
10 * to get fine volume control over the low volume range.
12 * Some code derived from code by Romolo Manfredini
15 * 1999-05-06 - (C. van Schaik)
16 * - Make signal strength and stereo scans
17 * kinder to cpu while in delay
18 * 1999-01-05 - (C. van Schaik)
19 * - Changed tuning to 1/160Mhz accuracy
20 * - Added stereo support
21 * (card defaults to stereo)
22 * (can explicitly force mono on the card)
23 * (can detect if station is in stereo)
24 * - Added unmute function
25 * - Reworked ioctl functions
26 * 2002-07-15 - Fix Stereo typo
28 * 2006-07-24 - Converted to V4L2 API
29 * by Mauro Carvalho Chehab <mchehab@infradead.org>
32 #include <linux/module.h> /* Modules */
33 #include <linux/init.h> /* Initdata */
34 #include <linux/ioport.h> /* request_region */
35 #include <linux/delay.h> /* udelay, msleep */
36 #include <linux/videodev2.h> /* kernel radio structs */
37 #include <linux/mutex.h>
38 #include <linux/version.h> /* for KERNEL_VERSION MACRO */
39 #include <linux/io.h> /* outb, outb_p */
40 #include <media/v4l2-device.h>
41 #include <media/v4l2-ioctl.h>
43 MODULE_AUTHOR("C.van Schaik");
44 MODULE_DESCRIPTION("A driver for the Zoltrix Radio Plus.");
45 MODULE_LICENSE("GPL");
47 #ifndef CONFIG_RADIO_ZOLTRIX_PORT
48 #define CONFIG_RADIO_ZOLTRIX_PORT -1
51 static int io
= CONFIG_RADIO_ZOLTRIX_PORT
;
52 static int radio_nr
= -1;
54 module_param(io
, int, 0);
55 MODULE_PARM_DESC(io
, "I/O address of the Zoltrix Radio Plus (0x20c or 0x30c)");
56 module_param(radio_nr
, int, 0);
58 #define RADIO_VERSION KERNEL_VERSION(0, 0, 2)
61 struct v4l2_device v4l2_dev
;
62 struct video_device vdev
;
65 unsigned long curfreq
;
71 static struct zoltrix zoltrix_card
;
73 static int zol_setvol(struct zoltrix
*zol
, int vol
)
79 mutex_lock(&zol
->lock
);
83 inb(zol
->io
+ 3); /* Zoltrix needs to be read to confirm */
84 mutex_unlock(&zol
->lock
);
88 outb(zol
->curvol
-1, zol
->io
);
91 mutex_unlock(&zol
->lock
);
95 static void zol_mute(struct zoltrix
*zol
)
98 mutex_lock(&zol
->lock
);
101 inb(zol
->io
+ 3); /* Zoltrix needs to be read to confirm */
102 mutex_unlock(&zol
->lock
);
105 static void zol_unmute(struct zoltrix
*zol
)
108 zol_setvol(zol
, zol
->curvol
);
111 static int zol_setfreq(struct zoltrix
*zol
, unsigned long freq
)
113 /* tunes the radio to the desired frequency */
114 struct v4l2_device
*v4l2_dev
= &zol
->v4l2_dev
;
115 unsigned long long bitmask
, f
, m
;
116 unsigned int stereo
= zol
->stereo
;
120 v4l2_warn(v4l2_dev
, "cannot set a frequency of 0.\n");
124 m
= (freq
/ 160 - 8800) * 2;
125 f
= (unsigned long long)m
+ 0x4d1c;
127 bitmask
= 0xc480402c10080000ull
;
130 mutex_lock(&zol
->lock
);
136 inb(zol
->io
+ 3); /* Zoltrix needs to be read to confirm */
141 bitmask
= (bitmask
^ ((f
& 0xff) << 47) ^ ((f
& 0xff00) << 30) ^ (stereo
<< 31));
143 if ((bitmask
& 0x8000000000000000ull
) != 0) {
160 /* termination sequence */
176 mutex_unlock(&zol
->lock
);
179 zol_setvol(zol
, zol
->curvol
);
183 /* Get signal strength */
184 static int zol_getsigstr(struct zoltrix
*zol
)
188 mutex_lock(&zol
->lock
);
189 outb(0x00, zol
->io
); /* This stuff I found to do nothing */
190 outb(zol
->curvol
, zol
->io
);
197 mutex_unlock(&zol
->lock
);
202 /* I found this out by playing with a binary scanner on the card io */
203 return a
== 0xcf || a
== 0xdf || a
== 0xef;
206 static int zol_is_stereo(struct zoltrix
*zol
)
210 mutex_lock(&zol
->lock
);
213 outb(zol
->curvol
, zol
->io
);
220 mutex_unlock(&zol
->lock
);
222 return x1
== x2
&& x1
== 0xcf;
225 static int vidioc_querycap(struct file
*file
, void *priv
,
226 struct v4l2_capability
*v
)
228 strlcpy(v
->driver
, "radio-zoltrix", sizeof(v
->driver
));
229 strlcpy(v
->card
, "Zoltrix Radio", sizeof(v
->card
));
230 strlcpy(v
->bus_info
, "ISA", sizeof(v
->bus_info
));
231 v
->version
= RADIO_VERSION
;
232 v
->capabilities
= V4L2_CAP_TUNER
| V4L2_CAP_RADIO
;
236 static int vidioc_g_tuner(struct file
*file
, void *priv
,
237 struct v4l2_tuner
*v
)
239 struct zoltrix
*zol
= video_drvdata(file
);
244 strlcpy(v
->name
, "FM", sizeof(v
->name
));
245 v
->type
= V4L2_TUNER_RADIO
;
246 v
->rangelow
= 88 * 16000;
247 v
->rangehigh
= 108 * 16000;
248 v
->rxsubchans
= V4L2_TUNER_SUB_MONO
| V4L2_TUNER_SUB_STEREO
;
249 v
->capability
= V4L2_TUNER_CAP_LOW
;
250 if (zol_is_stereo(zol
))
251 v
->audmode
= V4L2_TUNER_MODE_STEREO
;
253 v
->audmode
= V4L2_TUNER_MODE_MONO
;
254 v
->signal
= 0xFFFF * zol_getsigstr(zol
);
258 static int vidioc_s_tuner(struct file
*file
, void *priv
,
259 struct v4l2_tuner
*v
)
261 return v
->index
? -EINVAL
: 0;
264 static int vidioc_s_frequency(struct file
*file
, void *priv
,
265 struct v4l2_frequency
*f
)
267 struct zoltrix
*zol
= video_drvdata(file
);
269 if (f
->tuner
!= 0 || f
->type
!= V4L2_TUNER_RADIO
)
271 if (zol_setfreq(zol
, f
->frequency
) != 0)
276 static int vidioc_g_frequency(struct file
*file
, void *priv
,
277 struct v4l2_frequency
*f
)
279 struct zoltrix
*zol
= video_drvdata(file
);
283 f
->type
= V4L2_TUNER_RADIO
;
284 f
->frequency
= zol
->curfreq
;
288 static int vidioc_queryctrl(struct file
*file
, void *priv
,
289 struct v4l2_queryctrl
*qc
)
292 case V4L2_CID_AUDIO_MUTE
:
293 return v4l2_ctrl_query_fill(qc
, 0, 1, 1, 1);
294 case V4L2_CID_AUDIO_VOLUME
:
295 return v4l2_ctrl_query_fill(qc
, 0, 65535, 4096, 65535);
300 static int vidioc_g_ctrl(struct file
*file
, void *priv
,
301 struct v4l2_control
*ctrl
)
303 struct zoltrix
*zol
= video_drvdata(file
);
306 case V4L2_CID_AUDIO_MUTE
:
307 ctrl
->value
= zol
->muted
;
309 case V4L2_CID_AUDIO_VOLUME
:
310 ctrl
->value
= zol
->curvol
* 4096;
316 static int vidioc_s_ctrl(struct file
*file
, void *priv
,
317 struct v4l2_control
*ctrl
)
319 struct zoltrix
*zol
= video_drvdata(file
);
322 case V4L2_CID_AUDIO_MUTE
:
327 zol_setvol(zol
, zol
->curvol
);
330 case V4L2_CID_AUDIO_VOLUME
:
331 zol_setvol(zol
, ctrl
->value
/ 4096);
335 if (zol_setfreq(zol
, zol
->curfreq
) != 0)
338 /* FIXME: Implement stereo/mono switch on V4L2 */
339 if (v
->mode
& VIDEO_SOUND_STEREO
) {
341 zol_setfreq(zol
, zol
->curfreq
);
343 if (v
->mode
& VIDEO_SOUND_MONO
) {
345 zol_setfreq(zol
, zol
->curfreq
);
351 static int vidioc_g_input(struct file
*filp
, void *priv
, unsigned int *i
)
357 static int vidioc_s_input(struct file
*filp
, void *priv
, unsigned int i
)
359 return i
? -EINVAL
: 0;
362 static int vidioc_g_audio(struct file
*file
, void *priv
,
363 struct v4l2_audio
*a
)
366 strlcpy(a
->name
, "Radio", sizeof(a
->name
));
367 a
->capability
= V4L2_AUDCAP_STEREO
;
371 static int vidioc_s_audio(struct file
*file
, void *priv
,
372 struct v4l2_audio
*a
)
374 return a
->index
? -EINVAL
: 0;
377 static const struct v4l2_file_operations zoltrix_fops
=
379 .owner
= THIS_MODULE
,
380 .ioctl
= video_ioctl2
,
383 static const struct v4l2_ioctl_ops zoltrix_ioctl_ops
= {
384 .vidioc_querycap
= vidioc_querycap
,
385 .vidioc_g_tuner
= vidioc_g_tuner
,
386 .vidioc_s_tuner
= vidioc_s_tuner
,
387 .vidioc_g_audio
= vidioc_g_audio
,
388 .vidioc_s_audio
= vidioc_s_audio
,
389 .vidioc_g_input
= vidioc_g_input
,
390 .vidioc_s_input
= vidioc_s_input
,
391 .vidioc_g_frequency
= vidioc_g_frequency
,
392 .vidioc_s_frequency
= vidioc_s_frequency
,
393 .vidioc_queryctrl
= vidioc_queryctrl
,
394 .vidioc_g_ctrl
= vidioc_g_ctrl
,
395 .vidioc_s_ctrl
= vidioc_s_ctrl
,
398 static int __init
zoltrix_init(void)
400 struct zoltrix
*zol
= &zoltrix_card
;
401 struct v4l2_device
*v4l2_dev
= &zol
->v4l2_dev
;
404 strlcpy(v4l2_dev
->name
, "zoltrix", sizeof(v4l2_dev
->name
));
407 v4l2_err(v4l2_dev
, "You must set an I/O address with io=0x20c or 0x30c\n");
410 if (zol
->io
!= 0x20c && zol
->io
!= 0x30c) {
411 v4l2_err(v4l2_dev
, "invalid port, try 0x20c or 0x30c\n");
415 if (!request_region(zol
->io
, 2, "zoltrix")) {
416 v4l2_err(v4l2_dev
, "port 0x%x already in use\n", zol
->io
);
420 res
= v4l2_device_register(NULL
, v4l2_dev
);
422 release_region(zol
->io
, 2);
423 v4l2_err(v4l2_dev
, "Could not register v4l2_device\n");
427 strlcpy(zol
->vdev
.name
, v4l2_dev
->name
, sizeof(zol
->vdev
.name
));
428 zol
->vdev
.v4l2_dev
= v4l2_dev
;
429 zol
->vdev
.fops
= &zoltrix_fops
;
430 zol
->vdev
.ioctl_ops
= &zoltrix_ioctl_ops
;
431 zol
->vdev
.release
= video_device_release_empty
;
432 video_set_drvdata(&zol
->vdev
, zol
);
434 if (video_register_device(&zol
->vdev
, VFL_TYPE_RADIO
, radio_nr
) < 0) {
435 v4l2_device_unregister(v4l2_dev
);
436 release_region(zol
->io
, 2);
439 v4l2_info(v4l2_dev
, "Zoltrix Radio Plus card driver.\n");
441 mutex_init(&zol
->lock
);
443 /* mute card - prevents noisy bootups */
445 /* this ensures that the volume is all the way down */
458 static void __exit
zoltrix_exit(void)
460 struct zoltrix
*zol
= &zoltrix_card
;
462 video_unregister_device(&zol
->vdev
);
463 v4l2_device_unregister(&zol
->v4l2_dev
);
464 release_region(zol
->io
, 2);
467 module_init(zoltrix_init
);
468 module_exit(zoltrix_exit
);