drivers/media/radio/radio-terratec.c

   1 /* Terratec ActiveRadio ISA Standalone card driver for Linux radio support
   2  * (c) 1999 R. Offermanns (rolf@offermanns.de)
   3  * based on the aimslab radio driver from M. Kirkwood
   4  * many thanks to Michael Becker and Friedhelm Birth (from TerraTec)
   5  *
   6  *
   7  * History:
   8  * 1999-05-21   First preview release
   9  *
  10  *  Notes on the hardware:
  11  *  There are two "main" chips on the card:
  12  *  - Philips OM5610 (http://www-us.semiconductors.philips.com/acrobat/datasheets/OM5610_2.pdf)
  13  *  - Philips SAA6588 (http://www-us.semiconductors.philips.com/acrobat/datasheets/SAA6588_1.pdf)
  14  *  (you can get the datasheet at the above links)
  15  *
  16  *  Frequency control is done digitally -- ie out(port,encodefreq(95.8));
  17  *  Volume Control is done digitally
  18  *
  19  *  there is a I2C controlled RDS decoder (SAA6588)  onboard, which i would like to support someday
  20  *  (as soon i have understand how to get started :)
  21  *  If you can help me out with that, please contact me!!
  22  *
  23  *
  24  * Converted to V4L2 API by Mauro Carvalho Chehab <mchehab@infradead.org>
  25  */
  26
  27 #include <linux/module.h>       /* Modules                      */
  28 #include <linux/init.h>         /* Initdata                     */
  29 #include <linux/ioport.h>       /* request_region               */
  30 #include <linux/delay.h>        /* udelay                       */
  31 #include <asm/io.h>             /* outb, outb_p                 */
  32 #include <asm/uaccess.h>        /* copy to/from user            */
  33 #include <linux/videodev2.h>    /* kernel radio structs         */
  34 #include <media/v4l2-common.h>
  35 #include <media/v4l2-ioctl.h>
  36 #include <linux/spinlock.h>
  37
  38 #include <linux/version.h>      /* for KERNEL_VERSION MACRO     */
  39 #define RADIO_VERSION KERNEL_VERSION(0,0,2)
  40
  41 static struct v4l2_queryctrl radio_qctrl[] = {
  42         {
  43                 .id            = V4L2_CID_AUDIO_MUTE,
  44                 .name          = "Mute",
  45                 .minimum       = 0,
  46                 .maximum       = 1,
  47                 .default_value = 1,
  48                 .type          = V4L2_CTRL_TYPE_BOOLEAN,
  49         },{
  50                 .id            = V4L2_CID_AUDIO_VOLUME,
  51                 .name          = "Volume",
  52                 .minimum       = 0,
  53                 .maximum       = 0xff,
  54                 .step          = 1,
  55                 .default_value = 0xff,
  56                 .type          = V4L2_CTRL_TYPE_INTEGER,
  57         }
  58 };
  59
  60 #ifndef CONFIG_RADIO_TERRATEC_PORT
  61 #define CONFIG_RADIO_TERRATEC_PORT 0x590
  62 #endif
  63
  64 /**************** this ones are for the terratec *******************/
  65 #define BASEPORT        0x590
  66 #define VOLPORT         0x591
  67 #define WRT_DIS         0x00
  68 #define CLK_OFF         0x00
  69 #define IIC_DATA        0x01
  70 #define IIC_CLK         0x02
  71 #define DATA            0x04
  72 #define CLK_ON          0x08
  73 #define WRT_EN          0x10
  74 /*******************************************************************/
  75
  76 static int io = CONFIG_RADIO_TERRATEC_PORT;
  77 static int radio_nr = -1;
  78 static spinlock_t lock;
  79
  80 struct tt_device
  81 {
  82         unsigned long in_use;
  83         int port;
  84         int curvol;
  85         unsigned long curfreq;
  86         int muted;
  87 };
  88
  89
  90 /* local things */
  91
  92 static void cardWriteVol(int volume)
  93 {
  94         int i;
  95         volume = volume+(volume * 32); // change both channels
  96         spin_lock(&lock);
  97         for (i=0;i<8;i++)
  98         {
  99                 if (volume & (0x80>>i))
 100                         outb(0x80, VOLPORT);
 101                 else outb(0x00, VOLPORT);
 102         }
 103         spin_unlock(&lock);
 104 }
 105
 106
 107
 108 static void tt_mute(struct tt_device *dev)
 109 {
 110         dev->muted = 1;
 111         cardWriteVol(0);
 112 }
 113
 114 static int tt_setvol(struct tt_device *dev, int vol)
 115 {
 116
 117 //      printk(KERN_ERR "setvol called, vol = %d\n", vol);
 118
 119         if(vol == dev->curvol) {        /* requested volume = current */
 120                 if (dev->muted) {       /* user is unmuting the card  */
 121                         dev->muted = 0;
 122                         cardWriteVol(vol);      /* enable card */
 123                 }
 124
 125                 return 0;
 126         }
 127
 128         if(vol == 0) {                  /* volume = 0 means mute the card */
 129                 cardWriteVol(0);        /* "turn off card" by setting vol to 0 */
 130                 dev->curvol = vol;      /* track the volume state!      */
 131                 return 0;
 132         }
 133
 134         dev->muted = 0;
 135
 136         cardWriteVol(vol);
 137
 138         dev->curvol = vol;
 139
 140         return 0;
 141
 142 }
 143
 144
 145 /* this is the worst part in this driver */
 146 /* many more or less strange things are going on here, but hey, it works :) */
 147
 148 static int tt_setfreq(struct tt_device *dev, unsigned long freq1)
 149 {
 150         int freq;
 151         int i;
 152         int p;
 153         int  temp;
 154         long rest;
 155
 156         unsigned char buffer[25];               /* we have to bit shift 25 registers */
 157         freq = freq1/160;                       /* convert the freq. to a nice to handle value */
 158         for(i=24;i>-1;i--)
 159                 buffer[i]=0;
 160
 161         rest = freq*10+10700;           /* i once had understood what is going on here */
 162                                         /* maybe some wise guy (friedhelm?) can comment this stuff */
 163         i=13;
 164         p=10;
 165         temp=102400;
 166         while (rest!=0)
 167         {
 168                 if (rest%temp  == rest)
 169                         buffer[i] = 0;
 170                 else
 171                 {
 172                         buffer[i] = 1;
 173                         rest = rest-temp;
 174                 }
 175                 i--;
 176                 p--;
 177                 temp = temp/2;
 178         }
 179
 180         spin_lock(&lock);
 181
 182         for (i=24;i>-1;i--)                     /* bit shift the values to the radiocard */
 183         {
 184                 if (buffer[i]==1)
 185                 {
 186                         outb(WRT_EN|DATA, BASEPORT);
 187                         outb(WRT_EN|DATA|CLK_ON  , BASEPORT);
 188                         outb(WRT_EN|DATA, BASEPORT);
 189                 }
 190                 else
 191                 {
 192                         outb(WRT_EN|0x00, BASEPORT);
 193                         outb(WRT_EN|0x00|CLK_ON  , BASEPORT);
 194                 }
 195         }
 196         outb(0x00, BASEPORT);
 197
 198         spin_unlock(&lock);
 199
 200         return 0;
 201 }
 202
 203 static int tt_getsigstr(struct tt_device *dev)          /* TODO */
 204 {
 205         if (inb(io) & 2)        /* bit set = no signal present  */
 206                 return 0;
 207         return 1;               /* signal present               */
 208 }
 209
 210 static int vidioc_querycap(struct file *file, void *priv,
 211                                         struct v4l2_capability *v)
 212 {
 213         strlcpy(v->driver, "radio-terratec", sizeof(v->driver));
 214         strlcpy(v->card, "ActiveRadio", sizeof(v->card));
 215         sprintf(v->bus_info, "ISA");
 216         v->version = RADIO_VERSION;
 217         v->capabilities = V4L2_CAP_TUNER;
 218         return 0;
 219 }
 220
 221 static int vidioc_g_tuner(struct file *file, void *priv,
 222                                         struct v4l2_tuner *v)
 223 {
 224         struct video_device *dev = video_devdata(file);
 225         struct tt_device *tt = video_get_drvdata(dev);
 226
 227         if (v->index > 0)
 228                 return -EINVAL;
 229
 230         strcpy(v->name, "FM");
 231         v->type = V4L2_TUNER_RADIO;
 232         v->rangelow = (87*16000);
 233         v->rangehigh = (108*16000);
 234         v->rxsubchans = V4L2_TUNER_SUB_MONO;
 235         v->capability = V4L2_TUNER_CAP_LOW;
 236         v->audmode = V4L2_TUNER_MODE_MONO;
 237         v->signal = 0xFFFF*tt_getsigstr(tt);
 238         return 0;
 239 }
 240
 241 static int vidioc_s_tuner(struct file *file, void *priv,
 242                                         struct v4l2_tuner *v)
 243 {
 244         if (v->index > 0)
 245                 return -EINVAL;
 246         return 0;
 247 }
 248
 249 static int vidioc_s_frequency(struct file *file, void *priv,
 250                                         struct v4l2_frequency *f)
 251 {
 252         struct video_device *dev = video_devdata(file);
 253         struct tt_device *tt = video_get_drvdata(dev);
 254
 255         tt->curfreq = f->frequency;
 256         tt_setfreq(tt, tt->curfreq);
 257         return 0;
 258 }
 259
 260 static int vidioc_g_frequency(struct file *file, void *priv,
 261                                         struct v4l2_frequency *f)
 262 {
 263         struct video_device *dev = video_devdata(file);
 264         struct tt_device *tt = video_get_drvdata(dev);
 265
 266         f->type = V4L2_TUNER_RADIO;
 267         f->frequency = tt->curfreq;
 268         return 0;
 269 }
 270
 271 static int vidioc_queryctrl(struct file *file, void *priv,
 272                                         struct v4l2_queryctrl *qc)
 273 {
 274         int i;
 275
 276         for (i = 0; i < ARRAY_SIZE(radio_qctrl); i++) {
 277                 if (qc->id && qc->id == radio_qctrl[i].id) {
 278                         memcpy(qc, &(radio_qctrl[i]),
 279                                                 sizeof(*qc));
 280                         return 0;
 281                 }
 282         }
 283         return -EINVAL;
 284 }
 285
 286 static int vidioc_g_ctrl(struct file *file, void *priv,
 287                                         struct v4l2_control *ctrl)
 288 {
 289         struct video_device *dev = video_devdata(file);
 290         struct tt_device *tt = video_get_drvdata(dev);
 291
 292         switch (ctrl->id) {
 293         case V4L2_CID_AUDIO_MUTE:
 294                 if (tt->muted)
 295                         ctrl->value = 1;
 296                 else
 297                         ctrl->value = 0;
 298                 return 0;
 299         case V4L2_CID_AUDIO_VOLUME:
 300                 ctrl->value = tt->curvol * 6554;
 301                 return 0;
 302         }
 303         return -EINVAL;
 304 }
 305
 306 static int vidioc_s_ctrl(struct file *file, void *priv,
 307                                         struct v4l2_control *ctrl)
 308 {
 309         struct video_device *dev = video_devdata(file);
 310         struct tt_device *tt = video_get_drvdata(dev);
 311
 312         switch (ctrl->id) {
 313         case V4L2_CID_AUDIO_MUTE:
 314                 if (ctrl->value)
 315                         tt_mute(tt);
 316                 else
 317                         tt_setvol(tt,tt->curvol);
 318                 return 0;
 319         case V4L2_CID_AUDIO_VOLUME:
 320                 tt_setvol(tt,ctrl->value);
 321                 return 0;
 322         }
 323         return -EINVAL;
 324 }
 325
 326 static int vidioc_g_audio(struct file *file, void *priv,
 327                                         struct v4l2_audio *a)
 328 {
 329         if (a->index > 1)
 330                 return -EINVAL;
 331
 332         strcpy(a->name, "Radio");
 333         a->capability = V4L2_AUDCAP_STEREO;
 334         return 0;
 335 }
 336
 337 static int vidioc_g_input(struct file *filp, void *priv, unsigned int *i)
 338 {
 339         *i = 0;
 340         return 0;
 341 }
 342
 343 static int vidioc_s_input(struct file *filp, void *priv, unsigned int i)
 344 {
 345         if (i != 0)
 346                 return -EINVAL;
 347         return 0;
 348 }
 349
 350 static int vidioc_s_audio(struct file *file, void *priv,
 351                                         struct v4l2_audio *a)
 352 {
 353         if (a->index != 0)
 354                 return -EINVAL;
 355         return 0;
 356 }
 357
 358 static struct tt_device terratec_unit;
 359
 360 static int terratec_exclusive_open(struct inode *inode, struct file *file)
 361 {
 362         return test_and_set_bit(0, &terratec_unit.in_use) ? -EBUSY : 0;
 363 }
 364
 365 static int terratec_exclusive_release(struct inode *inode, struct file *file)
 366 {
 367         clear_bit(0, &terratec_unit.in_use);
 368         return 0;
 369 }
 370
 371 static const struct file_operations terratec_fops = {
 372         .owner          = THIS_MODULE,
 373         .open           = terratec_exclusive_open,
 374         .release        = terratec_exclusive_release,
 375         .ioctl          = video_ioctl2,
 376 #ifdef CONFIG_COMPAT
 377         .compat_ioctl   = v4l_compat_ioctl32,
 378 #endif
 379         .llseek         = no_llseek,
 380 };
 381
 382 static const struct v4l2_ioctl_ops terratec_ioctl_ops = {
 383         .vidioc_querycap    = vidioc_querycap,
 384         .vidioc_g_tuner     = vidioc_g_tuner,
 385         .vidioc_s_tuner     = vidioc_s_tuner,
 386         .vidioc_g_frequency = vidioc_g_frequency,
 387         .vidioc_s_frequency = vidioc_s_frequency,
 388         .vidioc_queryctrl   = vidioc_queryctrl,
 389         .vidioc_g_ctrl      = vidioc_g_ctrl,
 390         .vidioc_s_ctrl      = vidioc_s_ctrl,
 391         .vidioc_g_audio     = vidioc_g_audio,
 392         .vidioc_s_audio     = vidioc_s_audio,
 393         .vidioc_g_input     = vidioc_g_input,
 394         .vidioc_s_input     = vidioc_s_input,
 395 };
 396
 397 static struct video_device terratec_radio = {
 398         .name           = "TerraTec ActiveRadio",
 399         .fops           = &terratec_fops,
 400         .ioctl_ops      = &terratec_ioctl_ops,
 401         .release        = video_device_release_empty,
 402 };
 403
 404 static int __init terratec_init(void)
 405 {
 406         if(io==-1)
 407         {
 408                 printk(KERN_ERR "You must set an I/O address with io=0x???\n");
 409                 return -EINVAL;
 410         }
 411         if (!request_region(io, 2, "terratec"))
 412         {
 413                 printk(KERN_ERR "TerraTec: port 0x%x already in use\n", io);
 414                 return -EBUSY;
 415         }
 416
 417         video_set_drvdata(&terratec_radio, &terratec_unit);
 418
 419         spin_lock_init(&lock);
 420
 421         if (video_register_device(&terratec_radio, VFL_TYPE_RADIO, radio_nr) < 0) {
 422                 release_region(io,2);
 423                 return -EINVAL;
 424         }
 425
 426         printk(KERN_INFO "TERRATEC ActivRadio Standalone card driver.\n");
 427
 428         /* mute card - prevents noisy bootups */
 429
 430         /* this ensures that the volume is all the way down  */
 431         cardWriteVol(0);
 432         terratec_unit.curvol = 0;
 433
 434         return 0;
 435 }
 436
 437 MODULE_AUTHOR("R.OFFERMANNS & others");
 438 MODULE_DESCRIPTION("A driver for the TerraTec ActiveRadio Standalone radio card.");
 439 MODULE_LICENSE("GPL");
 440 module_param(io, int, 0);
 441 MODULE_PARM_DESC(io, "I/O address of the TerraTec ActiveRadio card (0x590 or 0x591)");
 442 module_param(radio_nr, int, 0);
 443
 444 static void __exit terratec_cleanup_module(void)
 445 {
 446         video_unregister_device(&terratec_radio);
 447         release_region(io,2);
 448         printk(KERN_INFO "TERRATEC ActivRadio Standalone card driver unloaded.\n");
 449 }
 450
 451 module_init(terratec_init);
 452 module_exit(terratec_cleanup_module);
 453