SAFE public projects git trees. - safe/jmp/linux-2.6/blob - drivers/media/radio/radio-maxiradio.c

   1 /*
   2  * Guillemot Maxi Radio FM 2000 PCI radio card driver for Linux
   3  * (C) 2001 Dimitromanolakis Apostolos <apdim@grecian.net>
   4  *
   5  * Based in the radio Maestro PCI driver. Actually it uses the same chip
   6  * for radio but different pci controller.
   7  *
   8  * I didn't have any specs I reversed engineered the protocol from
   9  * the windows driver (radio.dll).
  10  *
  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.
  14  *
  15  * For the pdf file see:
  16  * http://www.semiconductors.philips.com/pip/TEA5757H/V1
  17  *
  18  *
  19  * CHANGES:
  20  *   0.75b
  21  *     - better pci interface thanks to Francois Romieu <romieu@cogenit.fr>
  22  *
  23  *   0.75      Sun Feb  4 22:51:27 EET 2001
  24  *     - tiding up
  25  *     - removed support for multiple devices as it didn't work anyway
  26  *
  27  * BUGS:
  28  *   - card unmutes if you change frequency
  29  *
  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
  33  */
  34
  35
  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     */
  44 #include <linux/io.h>
  45 #include <linux/uaccess.h>
  46 #include <media/v4l2-device.h>
  47 #include <media/v4l2-ioctl.h>
  48
  49 MODULE_AUTHOR("Dimitromanolakis Apostolos, apdim@grecian.net");
  50 MODULE_DESCRIPTION("Radio driver for the Guillemot Maxi Radio FM2000 radio.");
  51 MODULE_LICENSE("GPL");
  52
  53 static int radio_nr = -1;
  54 module_param(radio_nr, int, 0);
  55
  56 static int debug;
  57
  58 module_param(debug, int, 0644);
  59 MODULE_PARM_DESC(debug, "activates debug info");
  60
  61 #define DRIVER_VERSION  "0.77"
  62
  63 #define RADIO_VERSION KERNEL_VERSION(0, 7, 7)
  64
  65 #define dprintk(dev, num, fmt, arg...) \
  66         v4l2_dbg(num, debug, &dev->v4l2_dev, fmt, ## arg)
  67
  68 #ifndef PCI_VENDOR_ID_GUILLEMOT
  69 #define PCI_VENDOR_ID_GUILLEMOT 0x5046
  70 #endif
  71
  72 #ifndef PCI_DEVICE_ID_GUILLEMOT
  73 #define PCI_DEVICE_ID_GUILLEMOT_MAXIRADIO 0x1001
  74 #endif
  75
  76
  77 /* TEA5757 pin mappings */
  78 static const int clk = 1, data = 2, wren = 4, mo_st = 8, power = 16;
  79
  80 #define FREQ_LO         (50 * 16000)
  81 #define FREQ_HI         (150 * 16000)
  82
  83 #define FREQ_IF         171200 /* 10.7*16000   */
  84 #define FREQ_STEP       200    /* 12.5*16      */
  85
  86 /* (x==fmhz*16*1000) -> bits */
  87 #define FREQ2BITS(x) \
  88   ((((unsigned int)(x) + FREQ_IF + (FREQ_STEP << 1)) / (FREQ_STEP << 2)) << 2)
  89
  90 #define BITS2FREQ(x)    ((x) * FREQ_STEP - FREQ_IF)
  91
  92
  93 struct maxiradio
  94 {
  95         struct v4l2_device v4l2_dev;
  96         struct video_device vdev;
  97         struct pci_dev *pdev;
  98
  99         u16     io;     /* base of radio io */
 100         u16     muted;  /* VIDEO_AUDIO_MUTE */
 101         u16     stereo; /* VIDEO_TUNER_STEREO_ON */
 102         u16     tuned;  /* signal strength (0 or 0xffff) */
 103
 104         unsigned long freq;
 105
 106         struct mutex lock;
 107 };
 108
 109 static inline struct maxiradio *to_maxiradio(struct v4l2_device *v4l2_dev)
 110 {
 111         return container_of(v4l2_dev, struct maxiradio, v4l2_dev);
 112 }
 113
 114 static void outbit(unsigned long bit, u16 io)
 115 {
 116         int val = power | wren | (bit ? data : 0);
 117
 118         outb(val, io);
 119         udelay(4);
 120         outb(val | clk, io);
 121         udelay(4);
 122         outb(val, io);
 123         udelay(4);
 124 }
 125
 126 static void turn_power(struct maxiradio *dev, int p)
 127 {
 128         if (p != 0) {
 129                 dprintk(dev, 1, "Radio powered on\n");
 130                 outb(power, dev->io);
 131         } else {
 132                 dprintk(dev, 1, "Radio powered off\n");
 133                 outb(0, dev->io);
 134         }
 135 }
 136
 137 static void set_freq(struct maxiradio *dev, u32 freq)
 138 {
 139         unsigned long int si;
 140         int bl;
 141         int io = dev->io;
 142         int val = FREQ2BITS(freq);
 143
 144         /* TEA5757 shift register bits (see pdf) */
 145
 146         outbit(0, io); /* 24  search */
 147         outbit(1, io); /* 23  search up/down */
 148
 149         outbit(0, io); /* 22  stereo/mono */
 150
 151         outbit(0, io); /* 21  band */
 152         outbit(0, io); /* 20  band (only 00=FM works I think) */
 153
 154         outbit(0, io); /* 19  port ? */
 155         outbit(0, io); /* 18  port ? */
 156
 157         outbit(0, io); /* 17  search level */
 158         outbit(0, io); /* 16  search level */
 159
 160         si = 0x8000;
 161         for (bl = 1; bl <= 16; bl++) {
 162                 outbit(val & si, io);
 163                 si >>= 1;
 164         }
 165
 166         dprintk(dev, 1, "Radio freq set to %d.%02d MHz\n",
 167                                 freq / 16000,
 168                                 freq % 16000 * 100 / 16000);
 169
 170         turn_power(dev, 1);
 171 }
 172
 173 static int get_stereo(u16 io)
 174 {
 175         outb(power,io);
 176         udelay(4);
 177
 178         return !(inb(io) & mo_st);
 179 }
 180
 181 static int get_tune(u16 io)
 182 {
 183         outb(power+clk,io);
 184         udelay(4);
 185
 186         return !(inb(io) & mo_st);
 187 }
 188
 189
 190 static int vidioc_querycap(struct file *file, void  *priv,
 191                             struct v4l2_capability *v)
 192 {
 193         struct maxiradio *dev = video_drvdata(file);
 194
 195         strlcpy(v->driver, "radio-maxiradio", sizeof(v->driver));
 196         strlcpy(v->card, "Maxi Radio FM2000 radio", sizeof(v->card));
 197         snprintf(v->bus_info, sizeof(v->bus_info), "PCI:%s", pci_name(dev->pdev));
 198         v->version = RADIO_VERSION;
 199         v->capabilities = V4L2_CAP_TUNER | V4L2_CAP_RADIO;
 200         return 0;
 201 }
 202
 203 static int vidioc_g_tuner(struct file *file, void *priv,
 204                            struct v4l2_tuner *v)
 205 {
 206         struct maxiradio *dev = video_drvdata(file);
 207
 208         if (v->index > 0)
 209                 return -EINVAL;
 210
 211         mutex_lock(&dev->lock);
 212         strlcpy(v->name, "FM", sizeof(v->name));
 213         v->type = V4L2_TUNER_RADIO;
 214         v->rangelow = FREQ_LO;
 215         v->rangehigh = FREQ_HI;
 216         v->rxsubchans = V4L2_TUNER_SUB_MONO | V4L2_TUNER_SUB_STEREO;
 217         v->capability = V4L2_TUNER_CAP_LOW;
 218         if (get_stereo(dev->io))
 219                 v->audmode = V4L2_TUNER_MODE_STEREO;
 220         else
 221                 v->audmode = V4L2_TUNER_MODE_MONO;
 222         v->signal = 0xffff * get_tune(dev->io);
 223         mutex_unlock(&dev->lock);
 224
 225         return 0;
 226 }
 227
 228 static int vidioc_s_tuner(struct file *file, void *priv,
 229                            struct v4l2_tuner *v)
 230 {
 231         return v->index ? -EINVAL : 0;
 232 }
 233
 234 static int vidioc_g_input(struct file *filp, void *priv, unsigned int *i)
 235 {
 236         *i = 0;
 237         return 0;
 238 }
 239
 240 static int vidioc_s_input(struct file *filp, void *priv, unsigned int i)
 241 {
 242         return i ? -EINVAL : 0;
 243 }
 244
 245 static int vidioc_g_audio(struct file *file, void *priv,
 246                            struct v4l2_audio *a)
 247 {
 248         a->index = 0;
 249         strlcpy(a->name, "Radio", sizeof(a->name));
 250         a->capability = V4L2_AUDCAP_STEREO;
 251         return 0;
 252 }
 253
 254
 255 static int vidioc_s_audio(struct file *file, void *priv,
 256                            struct v4l2_audio *a)
 257 {
 258         return a->index ? -EINVAL : 0;
 259 }
 260
 261 static int vidioc_s_frequency(struct file *file, void *priv,
 262                                struct v4l2_frequency *f)
 263 {
 264         struct maxiradio *dev = video_drvdata(file);
 265
 266         if (f->frequency < FREQ_LO || f->frequency > FREQ_HI) {
 267                 dprintk(dev, 1, "radio freq (%d.%02d MHz) out of range (%d-%d)\n",
 268                                         f->frequency / 16000,
 269                                         f->frequency % 16000 * 100 / 16000,
 270                                         FREQ_LO / 16000, FREQ_HI / 16000);
 271
 272                 return -EINVAL;
 273         }
 274
 275         mutex_lock(&dev->lock);
 276         dev->freq = f->frequency;
 277         set_freq(dev, dev->freq);
 278         msleep(125);
 279         mutex_unlock(&dev->lock);
 280
 281         return 0;
 282 }
 283
 284 static int vidioc_g_frequency(struct file *file, void *priv,
 285                                struct v4l2_frequency *f)
 286 {
 287         struct maxiradio *dev = video_drvdata(file);
 288
 289         f->type = V4L2_TUNER_RADIO;
 290         f->frequency = dev->freq;
 291
 292         dprintk(dev, 4, "radio freq is %d.%02d MHz",
 293                                 f->frequency / 16000,
 294                                 f->frequency % 16000 * 100 / 16000);
 295
 296         return 0;
 297 }
 298
 299 static int vidioc_queryctrl(struct file *file, void *priv,
 300                              struct v4l2_queryctrl *qc)
 301 {
 302         switch (qc->id) {
 303         case V4L2_CID_AUDIO_MUTE:
 304                 return v4l2_ctrl_query_fill(qc, 0, 1, 1, 1);
 305         }
 306         return -EINVAL;
 307 }
 308
 309 static int vidioc_g_ctrl(struct file *file, void *priv,
 310                 struct v4l2_control *ctrl)
 311 {
 312         struct maxiradio *dev = video_drvdata(file);
 313
 314         switch (ctrl->id) {
 315         case V4L2_CID_AUDIO_MUTE:
 316                 ctrl->value = dev->muted;
 317                 return 0;
 318         }
 319
 320         return -EINVAL;
 321 }
 322
 323 static int vidioc_s_ctrl(struct file *file, void *priv,
 324                 struct v4l2_control *ctrl)
 325 {
 326         struct maxiradio *dev = video_drvdata(file);
 327
 328         switch (ctrl->id) {
 329         case V4L2_CID_AUDIO_MUTE:
 330                 mutex_lock(&dev->lock);
 331                 dev->muted = ctrl->value;
 332                 if (dev->muted)
 333                         turn_power(dev, 0);
 334                 else
 335                         set_freq(dev, dev->freq);
 336                 mutex_unlock(&dev->lock);
 337                 return 0;
 338         }
 339
 340         return -EINVAL;
 341 }
 342
 343 static int maxiradio_open(struct file *file)
 344 {
 345         return 0;
 346 }
 347
 348 static int maxiradio_release(struct file *file)
 349 {
 350         return 0;
 351 }
 352
 353 static const struct v4l2_file_operations maxiradio_fops = {
 354         .owner          = THIS_MODULE,
 355         .open           = maxiradio_open,
 356         .release        = maxiradio_release,
 357         .ioctl          = video_ioctl2,
 358 };
 359
 360 static const struct v4l2_ioctl_ops maxiradio_ioctl_ops = {
 361         .vidioc_querycap    = vidioc_querycap,
 362         .vidioc_g_tuner     = vidioc_g_tuner,
 363         .vidioc_s_tuner     = vidioc_s_tuner,
 364         .vidioc_g_audio     = vidioc_g_audio,
 365         .vidioc_s_audio     = vidioc_s_audio,
 366         .vidioc_g_input     = vidioc_g_input,
 367         .vidioc_s_input     = vidioc_s_input,
 368         .vidioc_g_frequency = vidioc_g_frequency,
 369         .vidioc_s_frequency = vidioc_s_frequency,
 370         .vidioc_queryctrl   = vidioc_queryctrl,
 371         .vidioc_g_ctrl      = vidioc_g_ctrl,
 372         .vidioc_s_ctrl      = vidioc_s_ctrl,
 373 };
 374
 375 static int __devinit maxiradio_init_one(struct pci_dev *pdev, const struct pci_device_id *ent)
 376 {
 377         struct maxiradio *dev;
 378         struct v4l2_device *v4l2_dev;
 379         int retval = -ENOMEM;
 380
 381         dev = kzalloc(sizeof(*dev), GFP_KERNEL);
 382         if (dev == NULL) {
 383                 dev_err(&pdev->dev, "not enough memory\n");
 384                 return -ENOMEM;
 385         }
 386
 387         v4l2_dev = &dev->v4l2_dev;
 388         mutex_init(&dev->lock);
 389         dev->pdev = pdev;
 390         dev->muted = 1;
 391         dev->freq = FREQ_LO;
 392
 393         strlcpy(v4l2_dev->name, "maxiradio", sizeof(v4l2_dev->name));
 394
 395         retval = v4l2_device_register(&pdev->dev, v4l2_dev);
 396         if (retval < 0) {
 397                 v4l2_err(v4l2_dev, "Could not register v4l2_device\n");
 398                 goto errfr;
 399         }
 400
 401         if (!request_region(pci_resource_start(pdev, 0),
 402                            pci_resource_len(pdev, 0), "Maxi Radio FM 2000")) {
 403                 v4l2_err(v4l2_dev, "can't reserve I/O ports\n");
 404                 goto err_out;
 405         }
 406
 407         if (pci_enable_device(pdev))
 408                 goto err_out_free_region;
 409
 410         dev->io = pci_resource_start(pdev, 0);
 411         strlcpy(dev->vdev.name, v4l2_dev->name, sizeof(dev->vdev.name));
 412         dev->vdev.v4l2_dev = v4l2_dev;
 413         dev->vdev.fops = &maxiradio_fops;
 414         dev->vdev.ioctl_ops = &maxiradio_ioctl_ops;
 415         dev->vdev.release = video_device_release_empty;
 416         video_set_drvdata(&dev->vdev, dev);
 417
 418         if (video_register_device(&dev->vdev, VFL_TYPE_RADIO, radio_nr) < 0) {
 419                 v4l2_err(v4l2_dev, "can't register device!");
 420                 goto err_out_free_region;
 421         }
 422
 423         v4l2_info(v4l2_dev, "version " DRIVER_VERSION
 424                         " time " __TIME__ "  " __DATE__ "\n");
 425
 426         v4l2_info(v4l2_dev, "found Guillemot MAXI Radio device (io = 0x%x)\n",
 427                dev->io);
 428         return 0;
 429
 430 err_out_free_region:
 431         release_region(pci_resource_start(pdev, 0), pci_resource_len(pdev, 0));
 432 err_out:
 433         v4l2_device_unregister(v4l2_dev);
 434 errfr:
 435         kfree(dev);
 436         return -ENODEV;
 437 }
 438
 439 static void __devexit maxiradio_remove_one(struct pci_dev *pdev)
 440 {
 441         struct v4l2_device *v4l2_dev = dev_get_drvdata(&pdev->dev);
 442         struct maxiradio *dev = to_maxiradio(v4l2_dev);
 443
 444         video_unregister_device(&dev->vdev);
 445         v4l2_device_unregister(&dev->v4l2_dev);
 446         release_region(pci_resource_start(pdev, 0), pci_resource_len(pdev, 0));
 447 }
 448
 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, },
 452         { 0 }
 453 };
 454
 455 MODULE_DEVICE_TABLE(pci, maxiradio_pci_tbl);
 456
 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),
 462 };
 463
 464 static int __init maxiradio_radio_init(void)
 465 {
 466         return pci_register_driver(&maxiradio_driver);
 467 }
 468
 469 static void __exit maxiradio_radio_exit(void)
 470 {
 471         pci_unregister_driver(&maxiradio_driver);
 472 }
 473
 474 module_init(maxiradio_radio_init);
 475 module_exit(maxiradio_radio_exit);