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>
40 #include <linux/mutex.h>
41 #include <linux/pci.h>
42 #include <linux/videodev2.h>
43 #include <linux/version.h> /* for KERNEL_VERSION MACRO */
45 #include <media/v4l2-device.h>
46 #include <media/v4l2-ioctl.h>
48 MODULE_AUTHOR("Dimitromanolakis Apostolos, apdim@grecian.net");
49 MODULE_DESCRIPTION("Radio driver for the Guillemot Maxi Radio FM2000 radio.");
50 MODULE_LICENSE("GPL");
52 static int radio_nr = -1;
53 module_param(radio_nr, int, 0);
57 module_param(debug, int, 0644);
58 MODULE_PARM_DESC(debug, "activates debug info");
60 #define DRIVER_VERSION "0.77"
62 #define RADIO_VERSION KERNEL_VERSION(0, 7, 7)
64 #define dprintk(dev, num, fmt, arg...) \
65 v4l2_dbg(num, debug, &dev->v4l2_dev, fmt, ## arg)
67 #ifndef PCI_VENDOR_ID_GUILLEMOT
68 #define PCI_VENDOR_ID_GUILLEMOT 0x5046
71 #ifndef PCI_DEVICE_ID_GUILLEMOT
72 #define PCI_DEVICE_ID_GUILLEMOT_MAXIRADIO 0x1001
76 /* TEA5757 pin mappings */
77 static const int clk = 1, data = 2, wren = 4, mo_st = 8, power = 16;
79 #define FREQ_LO (50 * 16000)
80 #define FREQ_HI (150 * 16000)
82 #define FREQ_IF 171200 /* 10.7*16000 */
83 #define FREQ_STEP 200 /* 12.5*16 */
85 /* (x==fmhz*16*1000) -> bits */
86 #define FREQ2BITS(x) \
87 ((((unsigned int)(x) + FREQ_IF + (FREQ_STEP << 1)) / (FREQ_STEP << 2)) << 2)
89 #define BITS2FREQ(x) ((x) * FREQ_STEP - FREQ_IF)
94 struct v4l2_device v4l2_dev;
95 struct video_device vdev;
98 u16 io; /* base of radio io */
99 u16 muted; /* VIDEO_AUDIO_MUTE */
100 u16 stereo; /* VIDEO_TUNER_STEREO_ON */
101 u16 tuned; /* signal strength (0 or 0xffff) */
108 static inline struct maxiradio *to_maxiradio(struct v4l2_device *v4l2_dev)
110 return container_of(v4l2_dev, struct maxiradio, v4l2_dev);
113 static void outbit(unsigned long bit, u16 io)
115 int val = power | wren | (bit ? data : 0);
125 static void turn_power(struct maxiradio *dev, int p)
128 dprintk(dev, 1, "Radio powered on\n");
129 outb(power, dev->io);
131 dprintk(dev, 1, "Radio powered off\n");
136 static void set_freq(struct maxiradio *dev, u32 freq)
138 unsigned long int si;
141 int val = FREQ2BITS(freq);
143 /* TEA5757 shift register bits (see pdf) */
145 outbit(0, io); /* 24 search */
146 outbit(1, io); /* 23 search up/down */
148 outbit(0, io); /* 22 stereo/mono */
150 outbit(0, io); /* 21 band */
151 outbit(0, io); /* 20 band (only 00=FM works I think) */
153 outbit(0, io); /* 19 port ? */
154 outbit(0, io); /* 18 port ? */
156 outbit(0, io); /* 17 search level */
157 outbit(0, io); /* 16 search level */
160 for (bl = 1; bl <= 16; bl++) {
161 outbit(val & si, io);
165 dprintk(dev, 1, "Radio freq set to %d.%02d MHz\n",
167 freq % 16000 * 100 / 16000);
172 static int get_stereo(u16 io)
177 return !(inb(io) & mo_st);
180 static int get_tune(u16 io)
185 return !(inb(io) & mo_st);
189 static int vidioc_querycap(struct file *file, void *priv,
190 struct v4l2_capability *v)
192 struct maxiradio *dev = video_drvdata(file);
194 strlcpy(v->driver, "radio-maxiradio", sizeof(v->driver));
195 strlcpy(v->card, "Maxi Radio FM2000 radio", sizeof(v->card));
196 snprintf(v->bus_info, sizeof(v->bus_info), "PCI:%s", pci_name(dev->pdev));
197 v->version = RADIO_VERSION;
198 v->capabilities = V4L2_CAP_TUNER | V4L2_CAP_RADIO;
202 static int vidioc_g_tuner(struct file *file, void *priv,
203 struct v4l2_tuner *v)
205 struct maxiradio *dev = video_drvdata(file);
210 mutex_lock(&dev->lock);
211 strlcpy(v->name, "FM", sizeof(v->name));
212 v->type = V4L2_TUNER_RADIO;
213 v->rangelow = FREQ_LO;
214 v->rangehigh = FREQ_HI;
215 v->rxsubchans = V4L2_TUNER_SUB_MONO | V4L2_TUNER_SUB_STEREO;
216 v->capability = V4L2_TUNER_CAP_LOW;
217 if (get_stereo(dev->io))
218 v->audmode = V4L2_TUNER_MODE_STEREO;
220 v->audmode = V4L2_TUNER_MODE_MONO;
221 v->signal = 0xffff * get_tune(dev->io);
222 mutex_unlock(&dev->lock);
227 static int vidioc_s_tuner(struct file *file, void *priv,
228 struct v4l2_tuner *v)
230 return v->index ? -EINVAL : 0;
233 static int vidioc_g_input(struct file *filp, void *priv, unsigned int *i)
239 static int vidioc_s_input(struct file *filp, void *priv, unsigned int i)
241 return i ? -EINVAL : 0;
244 static int vidioc_g_audio(struct file *file, void *priv,
245 struct v4l2_audio *a)
248 strlcpy(a->name, "Radio", sizeof(a->name));
249 a->capability = V4L2_AUDCAP_STEREO;
254 static int vidioc_s_audio(struct file *file, void *priv,
255 struct v4l2_audio *a)
257 return a->index ? -EINVAL : 0;
260 static int vidioc_s_frequency(struct file *file, void *priv,
261 struct v4l2_frequency *f)
263 struct maxiradio *dev = video_drvdata(file);
265 if (f->frequency < FREQ_LO || f->frequency > FREQ_HI) {
266 dprintk(dev, 1, "radio freq (%d.%02d MHz) out of range (%d-%d)\n",
267 f->frequency / 16000,
268 f->frequency % 16000 * 100 / 16000,
269 FREQ_LO / 16000, FREQ_HI / 16000);
274 mutex_lock(&dev->lock);
275 dev->freq = f->frequency;
276 set_freq(dev, dev->freq);
278 mutex_unlock(&dev->lock);
283 static int vidioc_g_frequency(struct file *file, void *priv,
284 struct v4l2_frequency *f)
286 struct maxiradio *dev = video_drvdata(file);
288 f->type = V4L2_TUNER_RADIO;
289 f->frequency = dev->freq;
291 dprintk(dev, 4, "radio freq is %d.%02d MHz",
292 f->frequency / 16000,
293 f->frequency % 16000 * 100 / 16000);
298 static int vidioc_queryctrl(struct file *file, void *priv,
299 struct v4l2_queryctrl *qc)
302 case V4L2_CID_AUDIO_MUTE:
303 return v4l2_ctrl_query_fill(qc, 0, 1, 1, 1);
308 static int vidioc_g_ctrl(struct file *file, void *priv,
309 struct v4l2_control *ctrl)
311 struct maxiradio *dev = video_drvdata(file);
314 case V4L2_CID_AUDIO_MUTE:
315 ctrl->value = dev->muted;
322 static int vidioc_s_ctrl(struct file *file, void *priv,
323 struct v4l2_control *ctrl)
325 struct maxiradio *dev = video_drvdata(file);
328 case V4L2_CID_AUDIO_MUTE:
329 mutex_lock(&dev->lock);
330 dev->muted = ctrl->value;
334 set_freq(dev, dev->freq);
335 mutex_unlock(&dev->lock);
342 static int maxiradio_open(struct file *file)
347 static int maxiradio_release(struct file *file)
352 static const struct v4l2_file_operations maxiradio_fops = {
353 .owner = THIS_MODULE,
354 .open = maxiradio_open,
355 .release = maxiradio_release,
356 .ioctl = video_ioctl2,
359 static const struct v4l2_ioctl_ops maxiradio_ioctl_ops = {
360 .vidioc_querycap = vidioc_querycap,
361 .vidioc_g_tuner = vidioc_g_tuner,
362 .vidioc_s_tuner = vidioc_s_tuner,
363 .vidioc_g_audio = vidioc_g_audio,
364 .vidioc_s_audio = vidioc_s_audio,
365 .vidioc_g_input = vidioc_g_input,
366 .vidioc_s_input = vidioc_s_input,
367 .vidioc_g_frequency = vidioc_g_frequency,
368 .vidioc_s_frequency = vidioc_s_frequency,
369 .vidioc_queryctrl = vidioc_queryctrl,
370 .vidioc_g_ctrl = vidioc_g_ctrl,
371 .vidioc_s_ctrl = vidioc_s_ctrl,
374 static int __devinit maxiradio_init_one(struct pci_dev *pdev, const struct pci_device_id *ent)
376 struct maxiradio *dev;
377 struct v4l2_device *v4l2_dev;
378 int retval = -ENOMEM;
380 dev = kzalloc(sizeof(*dev), GFP_KERNEL);
382 dev_err(&pdev->dev, "not enough memory\n");
386 v4l2_dev = &dev->v4l2_dev;
387 mutex_init(&dev->lock);
392 strlcpy(v4l2_dev->name, "maxiradio", sizeof(v4l2_dev->name));
394 retval = v4l2_device_register(&pdev->dev, v4l2_dev);
396 v4l2_err(v4l2_dev, "Could not register v4l2_device\n");
400 if (!request_region(pci_resource_start(pdev, 0),
401 pci_resource_len(pdev, 0), "Maxi Radio FM 2000")) {
402 v4l2_err(v4l2_dev, "can't reserve I/O ports\n");
406 if (pci_enable_device(pdev))
407 goto err_out_free_region;
409 dev->io = pci_resource_start(pdev, 0);
410 strlcpy(dev->vdev.name, v4l2_dev->name, sizeof(dev->vdev.name));
411 dev->vdev.v4l2_dev = v4l2_dev;
412 dev->vdev.fops = &maxiradio_fops;
413 dev->vdev.ioctl_ops = &maxiradio_ioctl_ops;
414 dev->vdev.release = video_device_release_empty;
415 video_set_drvdata(&dev->vdev, dev);
417 if (video_register_device(&dev->vdev, VFL_TYPE_RADIO, radio_nr) < 0) {
418 v4l2_err(v4l2_dev, "can't register device!");
419 goto err_out_free_region;
422 v4l2_info(v4l2_dev, "version " DRIVER_VERSION
423 " time " __TIME__ " " __DATE__ "\n");
425 v4l2_info(v4l2_dev, "found Guillemot MAXI Radio device (io = 0x%x)\n",
430 release_region(pci_resource_start(pdev, 0), pci_resource_len(pdev, 0));
432 v4l2_device_unregister(v4l2_dev);
438 static void __devexit maxiradio_remove_one(struct pci_dev *pdev)
440 struct v4l2_device *v4l2_dev = dev_get_drvdata(&pdev->dev);
441 struct maxiradio *dev = to_maxiradio(v4l2_dev);
443 video_unregister_device(&dev->vdev);
444 v4l2_device_unregister(&dev->v4l2_dev);
445 release_region(pci_resource_start(pdev, 0), pci_resource_len(pdev, 0));
448 static struct pci_device_id maxiradio_pci_tbl[] = {
449 { PCI_VENDOR_ID_GUILLEMOT, PCI_DEVICE_ID_GUILLEMOT_MAXIRADIO,
450 PCI_ANY_ID, PCI_ANY_ID, },
454 MODULE_DEVICE_TABLE(pci, maxiradio_pci_tbl);
456 static struct pci_driver maxiradio_driver = {
457 .name = "radio-maxiradio",
458 .id_table = maxiradio_pci_tbl,
459 .probe = maxiradio_init_one,
460 .remove = __devexit_p(maxiradio_remove_one),
463 static int __init maxiradio_radio_init(void)
465 return pci_register_driver(&maxiradio_driver);
468 static void __exit maxiradio_radio_exit(void)
470 pci_unregister_driver(&maxiradio_driver);
473 module_init(maxiradio_radio_init);
474 module_exit(maxiradio_radio_exit);