2 * Guillemot Maxi Radio FM 2000 PCI radio card driver for Linux
3 * (C) 2001 Dimitromanolakis Apostolos <apdim@grecian.net>
5 * Based in the radio Maestro PCI driver. Actually it uses the same chip
6 * for radio but different pci controller.
8 * I didn't have any specs I reversed engineered the protocol from
9 * the windows driver (radio.dll).
11 * The card uses the TEA5757 chip that includes a search function but it
12 * is useless as I haven't found any way to read back the frequency. If
13 * anybody does please mail me.
15 * For the pdf file see:
16 * http://www.semiconductors.philips.com/pip/TEA5757H/V1
21 * - better pci interface thanks to Francois Romieu <romieu@cogenit.fr>
23 * 0.75 Sun Feb 4 22:51:27 EET 2001
25 * - removed support for multiple devices as it didn't work anyway
28 * - card unmutes if you change frequency
30 * (c) 2006, 2007 by Mauro Carvalho Chehab <mchehab@infradead.org>:
31 * - Conversion to V4L2 API
32 * - Uses video_ioctl2 for parsing and to add debug support
36 #include <linux/module.h>
37 #include <linux/init.h>
38 #include <linux/ioport.h>
39 #include <linux/delay.h>
41 #include <asm/uaccess.h>
42 #include <linux/mutex.h>
44 #include <linux/pci.h>
45 #include <linux/videodev2.h>
46 #include <media/v4l2-common.h>
47 #include <media/v4l2-ioctl.h>
49 #define DRIVER_VERSION "0.77"
51 #include <linux/version.h> /* for KERNEL_VERSION MACRO */
52 #define RADIO_VERSION KERNEL_VERSION(0,7,7)
54 static struct video_device maxiradio_radio;
56 #define dprintk(num, fmt, arg...) \
58 if (maxiradio_radio.debug >= num) \
59 printk(KERN_DEBUG "%s: " fmt, \
60 maxiradio_radio.name, ## arg); } while (0)
62 static struct v4l2_queryctrl radio_qctrl[] = {
64 .id = V4L2_CID_AUDIO_MUTE,
69 .type = V4L2_CTRL_TYPE_BOOLEAN,
73 #ifndef PCI_VENDOR_ID_GUILLEMOT
74 #define PCI_VENDOR_ID_GUILLEMOT 0x5046
77 #ifndef PCI_DEVICE_ID_GUILLEMOT
78 #define PCI_DEVICE_ID_GUILLEMOT_MAXIRADIO 0x1001
82 /* TEA5757 pin mappings */
83 static const int clk = 1, data = 2, wren = 4, mo_st = 8, power = 16 ;
85 static int radio_nr = -1;
86 module_param(radio_nr, int, 0);
88 static unsigned long in_use;
90 #define FREQ_LO 50*16000
91 #define FREQ_HI 150*16000
93 #define FREQ_IF 171200 /* 10.7*16000 */
94 #define FREQ_STEP 200 /* 12.5*16 */
96 /* (x==fmhz*16*1000) -> bits */
97 #define FREQ2BITS(x) ((( (unsigned int)(x)+FREQ_IF+(FREQ_STEP<<1)) \
100 #define BITS2FREQ(x) ((x) * FREQ_STEP - FREQ_IF)
103 static int maxiradio_exclusive_open(struct inode *inode, struct file *file)
105 return test_and_set_bit(0, &in_use) ? -EBUSY : 0;
108 static int maxiradio_exclusive_release(struct inode *inode, struct file *file)
110 clear_bit(0, &in_use);
114 static const struct file_operations maxiradio_fops = {
115 .owner = THIS_MODULE,
116 .open = maxiradio_exclusive_open,
117 .release = maxiradio_exclusive_release,
118 .ioctl = video_ioctl2,
120 .compat_ioctl = v4l_compat_ioctl32,
125 static struct radio_device
127 __u16 io, /* base of radio io */
128 muted, /* VIDEO_AUDIO_MUTE */
129 stereo, /* VIDEO_TUNER_STEREO_ON */
130 tuned; /* signal strength (0 or 0xffff) */
140 static void outbit(unsigned long bit, __u16 io)
144 outb( power|wren|data ,io); udelay(4);
145 outb( power|wren|data|clk ,io); udelay(4);
146 outb( power|wren|data ,io); udelay(4);
150 outb( power|wren ,io); udelay(4);
151 outb( power|wren|clk ,io); udelay(4);
152 outb( power|wren ,io); udelay(4);
156 static void turn_power(__u16 io, int p)
159 dprintk(1, "Radio powered on\n");
162 dprintk(1, "Radio powered off\n");
167 static void set_freq(__u16 io, __u32 freq)
169 unsigned long int si;
171 int val = FREQ2BITS(freq);
173 /* TEA5757 shift register bits (see pdf) */
175 outbit(0, io); /* 24 search */
176 outbit(1, io); /* 23 search up/down */
178 outbit(0, io); /* 22 stereo/mono */
180 outbit(0, io); /* 21 band */
181 outbit(0, io); /* 20 band (only 00=FM works I think) */
183 outbit(0, io); /* 19 port ? */
184 outbit(0, io); /* 18 port ? */
186 outbit(0, io); /* 17 search level */
187 outbit(0, io); /* 16 search level */
190 for (bl = 1; bl <= 16; bl++) {
191 outbit(val & si, io);
195 dprintk(1, "Radio freq set to %d.%02d MHz\n",
197 freq % 16000 * 100 / 16000);
202 static int get_stereo(__u16 io)
207 return !(inb(io) & mo_st);
210 static int get_tune(__u16 io)
215 return !(inb(io) & mo_st);
219 static int vidioc_querycap (struct file *file, void *priv,
220 struct v4l2_capability *v)
222 strlcpy(v->driver, "radio-maxiradio", sizeof (v->driver));
223 strlcpy(v->card, "Maxi Radio FM2000 radio", sizeof (v->card));
224 sprintf(v->bus_info,"ISA");
225 v->version = RADIO_VERSION;
226 v->capabilities = V4L2_CAP_TUNER;
231 static int vidioc_g_tuner (struct file *file, void *priv,
232 struct v4l2_tuner *v)
234 struct radio_device *card = video_drvdata(file);
239 memset(v,0,sizeof(*v));
240 strcpy(v->name, "FM");
241 v->type = V4L2_TUNER_RADIO;
244 v->rangehigh=FREQ_HI;
245 v->rxsubchans =V4L2_TUNER_SUB_MONO|V4L2_TUNER_SUB_STEREO;
246 v->capability=V4L2_TUNER_CAP_LOW;
247 if(get_stereo(card->io))
248 v->audmode = V4L2_TUNER_MODE_STEREO;
250 v->audmode = V4L2_TUNER_MODE_MONO;
251 v->signal=0xffff*get_tune(card->io);
256 static int vidioc_s_tuner (struct file *file, void *priv,
257 struct v4l2_tuner *v)
265 static int vidioc_g_audio (struct file *file, void *priv,
266 struct v4l2_audio *a)
271 strcpy(a->name, "FM");
272 a->capability = V4L2_AUDCAP_STEREO;
276 static int vidioc_g_input(struct file *filp, void *priv, unsigned int *i)
283 static int vidioc_s_input(struct file *filp, void *priv, unsigned int i)
292 static int vidioc_s_audio (struct file *file, void *priv,
293 struct v4l2_audio *a)
301 static int vidioc_s_frequency (struct file *file, void *priv,
302 struct v4l2_frequency *f)
304 struct radio_device *card = video_drvdata(file);
306 if (f->frequency < FREQ_LO || f->frequency > FREQ_HI) {
307 dprintk(1, "radio freq (%d.%02d MHz) out of range (%d-%d)\n",
308 f->frequency / 16000,
309 f->frequency % 16000 * 100 / 16000,
310 FREQ_LO / 16000, FREQ_HI / 16000);
315 card->freq = f->frequency;
316 set_freq(card->io, card->freq);
322 static int vidioc_g_frequency (struct file *file, void *priv,
323 struct v4l2_frequency *f)
325 struct radio_device *card = video_drvdata(file);
327 f->type = V4L2_TUNER_RADIO;
328 f->frequency = card->freq;
330 dprintk(4, "radio freq is %d.%02d MHz",
331 f->frequency / 16000,
332 f->frequency % 16000 * 100 / 16000);
337 static int vidioc_queryctrl (struct file *file, void *priv,
338 struct v4l2_queryctrl *qc)
342 for (i = 0; i < ARRAY_SIZE(radio_qctrl); i++) {
343 if (qc->id && qc->id == radio_qctrl[i].id) {
344 memcpy(qc, &(radio_qctrl[i]), sizeof(*qc));
352 static int vidioc_g_ctrl (struct file *file, void *priv,
353 struct v4l2_control *ctrl)
355 struct radio_device *card = video_drvdata(file);
358 case V4L2_CID_AUDIO_MUTE:
359 ctrl->value=card->muted;
366 static int vidioc_s_ctrl (struct file *file, void *priv,
367 struct v4l2_control *ctrl)
369 struct radio_device *card = video_drvdata(file);
372 case V4L2_CID_AUDIO_MUTE:
373 card->muted = ctrl->value;
375 turn_power(card->io, 0);
377 set_freq(card->io, card->freq);
384 static const struct v4l2_ioctl_ops maxiradio_ioctl_ops = {
385 .vidioc_querycap = vidioc_querycap,
386 .vidioc_g_tuner = vidioc_g_tuner,
387 .vidioc_s_tuner = vidioc_s_tuner,
388 .vidioc_g_audio = vidioc_g_audio,
389 .vidioc_s_audio = vidioc_s_audio,
390 .vidioc_g_input = vidioc_g_input,
391 .vidioc_s_input = vidioc_s_input,
392 .vidioc_g_frequency = vidioc_g_frequency,
393 .vidioc_s_frequency = vidioc_s_frequency,
394 .vidioc_queryctrl = vidioc_queryctrl,
395 .vidioc_g_ctrl = vidioc_g_ctrl,
396 .vidioc_s_ctrl = vidioc_s_ctrl,
399 static struct video_device maxiradio_radio = {
400 .name = "Maxi Radio FM2000 radio",
401 .fops = &maxiradio_fops,
402 .ioctl_ops = &maxiradio_ioctl_ops,
403 .release = video_device_release_empty,
406 static int __devinit maxiradio_init_one(struct pci_dev *pdev, const struct pci_device_id *ent)
408 if(!request_region(pci_resource_start(pdev, 0),
409 pci_resource_len(pdev, 0), "Maxi Radio FM 2000")) {
410 printk(KERN_ERR "radio-maxiradio: can't reserve I/O ports\n");
414 if (pci_enable_device(pdev))
415 goto err_out_free_region;
417 radio_unit.io = pci_resource_start(pdev, 0);
418 mutex_init(&radio_unit.lock);
419 video_set_drvdata(&maxiradio_radio, &radio_unit);
421 if (video_register_device(&maxiradio_radio, VFL_TYPE_RADIO, radio_nr) < 0) {
422 printk("radio-maxiradio: can't register device!");
423 goto err_out_free_region;
426 printk(KERN_INFO "radio-maxiradio: version "
433 printk(KERN_INFO "radio-maxiradio: found Guillemot MAXI Radio device (io = 0x%x)\n",
438 release_region(pci_resource_start(pdev, 0), pci_resource_len(pdev, 0));
443 static void __devexit maxiradio_remove_one(struct pci_dev *pdev)
445 video_unregister_device(&maxiradio_radio);
446 release_region(pci_resource_start(pdev, 0), pci_resource_len(pdev, 0));
449 static struct pci_device_id maxiradio_pci_tbl[] = {
450 { PCI_VENDOR_ID_GUILLEMOT, PCI_DEVICE_ID_GUILLEMOT_MAXIRADIO,
451 PCI_ANY_ID, PCI_ANY_ID, },
455 MODULE_DEVICE_TABLE(pci, maxiradio_pci_tbl);
457 static struct pci_driver maxiradio_driver = {
458 .name = "radio-maxiradio",
459 .id_table = maxiradio_pci_tbl,
460 .probe = maxiradio_init_one,
461 .remove = __devexit_p(maxiradio_remove_one),
464 static int __init maxiradio_radio_init(void)
466 return pci_register_driver(&maxiradio_driver);
469 static void __exit maxiradio_radio_exit(void)
471 pci_unregister_driver(&maxiradio_driver);
474 module_init(maxiradio_radio_init);
475 module_exit(maxiradio_radio_exit);
477 MODULE_AUTHOR("Dimitromanolakis Apostolos, apdim@grecian.net");
478 MODULE_DESCRIPTION("Radio driver for the Guillemot Maxi Radio FM2000 radio.");
479 MODULE_LICENSE("GPL");
481 module_param_named(debug,maxiradio_radio.debug, int, 0644);
482 MODULE_PARM_DESC(debug,"activates debug info");