drivers/media/video/em28xx/em28xx-audio.c

   1 /*
   2  *  Empiatech em28x1 audio extension
   3  *
   4  *  Copyright (C) 2006 Markus Rechberger <mrechberger@gmail.com>
   5  *
   6  *  Copyright (C) 2007 Mauro Carvalho Chehab <mchehab@infradead.org>
   7  *      - Port to work with the in-kernel driver
   8  *      - Several cleanups
   9  *
  10  *  This driver is based on my previous au600 usb pstn audio driver
  11  *  and inherits all the copyrights
  12  *
  13  *  This program is free software; you can redistribute it and/or modify
  14  *  it under the terms of the GNU General Public License as published by
  15  *  the Free Software Foundation; either version 2 of the License, or
  16  *  (at your option) any later version.
  17  *
  18  *  This program is distributed in the hope that it will be useful,
  19  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  20  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21  *  GNU General Public License for more details.
  22  *
  23  *  You should have received a copy of the GNU General Public License
  24  *  along with this program; if not, write to the Free Software
  25  *  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  26  */
  27
  28 #include <linux/kernel.h>
  29 #include <linux/usb.h>
  30 #include <linux/init.h>
  31 #include <linux/sound.h>
  32 #include <linux/spinlock.h>
  33 #include <linux/soundcard.h>
  34 #include <linux/slab.h>
  35 #include <linux/vmalloc.h>
  36 #include <linux/proc_fs.h>
  37 #include <linux/module.h>
  38 #include <sound/core.h>
  39 #include <sound/pcm.h>
  40 #include <sound/pcm_params.h>
  41 #include <sound/info.h>
  42 #include <sound/initval.h>
  43 #include <sound/control.h>
  44 #include <media/v4l2-common.h>
  45 #include "em28xx.h"
  46
  47 static int debug;
  48 module_param(debug, int, 0644);
  49 MODULE_PARM_DESC(debug, "activates debug info");
  50
  51 #define dprintk(fmt, arg...) do {                                       \
  52             if (debug)                                                  \
  53                 printk(KERN_INFO "em28xx-audio %s: " fmt,               \
  54                                   __func__, ##arg);             \
  55         } while (0)
  56
  57 static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX;
  58
  59 static int em28xx_deinit_isoc_audio(struct em28xx *dev)
  60 {
  61         int i;
  62
  63         dprintk("Stopping isoc\n");
  64         for (i = 0; i < EM28XX_AUDIO_BUFS; i++) {
  65                 if (!irqs_disabled())
  66                         usb_kill_urb(dev->adev.urb[i]);
  67                 else
  68                         usb_unlink_urb(dev->adev.urb[i]);
  69
  70                 usb_free_urb(dev->adev.urb[i]);
  71                 dev->adev.urb[i] = NULL;
  72
  73                 kfree(dev->adev.transfer_buffer[i]);
  74                 dev->adev.transfer_buffer[i] = NULL;
  75         }
  76
  77         return 0;
  78 }
  79
  80 static void em28xx_audio_isocirq(struct urb *urb)
  81 {
  82         struct em28xx            *dev = urb->context;
  83         int                      i;
  84         unsigned int             oldptr;
  85         int                      period_elapsed = 0;
  86         int                      status;
  87         unsigned char            *cp;
  88         unsigned int             stride;
  89         struct snd_pcm_substream *substream;
  90         struct snd_pcm_runtime   *runtime;
  91
  92         switch (urb->status) {
  93         case 0:             /* success */
  94         case -ETIMEDOUT:    /* NAK */
  95                 break;
  96         case -ECONNRESET:   /* kill */
  97         case -ENOENT:
  98         case -ESHUTDOWN:
  99                 return;
 100         default:            /* error */
 101                 dprintk("urb completition error %d.\n", urb->status);
 102                 break;
 103         }
 104
 105         if (dev->adev.capture_pcm_substream) {
 106                 substream = dev->adev.capture_pcm_substream;
 107                 runtime = substream->runtime;
 108                 stride = runtime->frame_bits >> 3;
 109
 110                 for (i = 0; i < urb->number_of_packets; i++) {
 111                         int length =
 112                             urb->iso_frame_desc[i].actual_length / stride;
 113                         cp = (unsigned char *)urb->transfer_buffer +
 114                             urb->iso_frame_desc[i].offset;
 115
 116                         if (!length)
 117                                 continue;
 118
 119                         oldptr = dev->adev.hwptr_done_capture;
 120                         if (oldptr + length >= runtime->buffer_size) {
 121                                 unsigned int cnt =
 122                                     runtime->buffer_size - oldptr;
 123                                 memcpy(runtime->dma_area + oldptr * stride, cp,
 124                                        cnt * stride);
 125                                 memcpy(runtime->dma_area, cp + cnt * stride,
 126                                        length * stride - cnt * stride);
 127                         } else {
 128                                 memcpy(runtime->dma_area + oldptr * stride, cp,
 129                                        length * stride);
 130                         }
 131
 132                         snd_pcm_stream_lock(substream);
 133
 134                         dev->adev.hwptr_done_capture += length;
 135                         if (dev->adev.hwptr_done_capture >=
 136                             runtime->buffer_size)
 137                                 dev->adev.hwptr_done_capture -=
 138                                     runtime->buffer_size;
 139
 140                         dev->adev.capture_transfer_done += length;
 141                         if (dev->adev.capture_transfer_done >=
 142                             runtime->period_size) {
 143                                 dev->adev.capture_transfer_done -=
 144                                     runtime->period_size;
 145                                 period_elapsed = 1;
 146                         }
 147
 148                         snd_pcm_stream_unlock(substream);
 149                 }
 150                 if (period_elapsed)
 151                         snd_pcm_period_elapsed(substream);
 152         }
 153         urb->status = 0;
 154
 155         status = usb_submit_urb(urb, GFP_ATOMIC);
 156         if (status < 0) {
 157                 em28xx_errdev("resubmit of audio urb failed (error=%i)\n",
 158                               status);
 159         }
 160         return;
 161 }
 162
 163 static int em28xx_init_audio_isoc(struct em28xx *dev)
 164 {
 165         int       i, errCode;
 166         const int sb_size = EM28XX_NUM_AUDIO_PACKETS *
 167                             EM28XX_AUDIO_MAX_PACKET_SIZE;
 168
 169         dprintk("Starting isoc transfers\n");
 170
 171         for (i = 0; i < EM28XX_AUDIO_BUFS; i++) {
 172                 struct urb *urb;
 173                 int j, k;
 174
 175                 dev->adev.transfer_buffer[i] = kmalloc(sb_size, GFP_ATOMIC);
 176                 if (!dev->adev.transfer_buffer[i])
 177                         return -ENOMEM;
 178
 179                 memset(dev->adev.transfer_buffer[i], 0x80, sb_size);
 180                 urb = usb_alloc_urb(EM28XX_NUM_AUDIO_PACKETS, GFP_ATOMIC);
 181                 if (!urb) {
 182                         em28xx_errdev("usb_alloc_urb failed!\n");
 183                         for (j = 0; j < i; j++) {
 184                                 usb_free_urb(dev->adev.urb[j]);
 185                                 kfree(dev->adev.transfer_buffer[j]);
 186                         }
 187                         return -ENOMEM;
 188                 }
 189
 190                 urb->dev = dev->udev;
 191                 urb->context = dev;
 192                 urb->pipe = usb_rcvisocpipe(dev->udev, 0x83);
 193                 urb->transfer_flags = URB_ISO_ASAP;
 194                 urb->transfer_buffer = dev->adev.transfer_buffer[i];
 195                 urb->interval = 1;
 196                 urb->complete = em28xx_audio_isocirq;
 197                 urb->number_of_packets = EM28XX_NUM_AUDIO_PACKETS;
 198                 urb->transfer_buffer_length = sb_size;
 199
 200                 for (j = k = 0; j < EM28XX_NUM_AUDIO_PACKETS;
 201                              j++, k += EM28XX_AUDIO_MAX_PACKET_SIZE) {
 202                         urb->iso_frame_desc[j].offset = k;
 203                         urb->iso_frame_desc[j].length =
 204                             EM28XX_AUDIO_MAX_PACKET_SIZE;
 205                 }
 206                 dev->adev.urb[i] = urb;
 207         }
 208
 209         for (i = 0; i < EM28XX_AUDIO_BUFS; i++) {
 210                 errCode = usb_submit_urb(dev->adev.urb[i], GFP_ATOMIC);
 211                 if (errCode) {
 212                         em28xx_deinit_isoc_audio(dev);
 213                         return errCode;
 214                 }
 215         }
 216
 217         return 0;
 218 }
 219
 220 static int em28xx_cmd(struct em28xx *dev, int cmd, int arg)
 221 {
 222         dprintk("%s transfer\n", (dev->adev.capture_stream == STREAM_ON) ?
 223                                  "stop" : "start");
 224
 225         switch (cmd) {
 226         case EM28XX_CAPTURE_STREAM_EN:
 227                 if (dev->adev.capture_stream == STREAM_OFF &&
 228                     arg == EM28XX_START_AUDIO) {
 229                         dev->adev.capture_stream = STREAM_ON;
 230                         em28xx_init_audio_isoc(dev);
 231                 } else if (dev->adev.capture_stream == STREAM_ON &&
 232                            arg == EM28XX_STOP_AUDIO) {
 233                         dev->adev.capture_stream = STREAM_OFF;
 234                         em28xx_deinit_isoc_audio(dev);
 235                 } else {
 236                         em28xx_errdev("An underrun very likely occurred. "
 237                                         "Ignoring it.\n");
 238                 }
 239                 return 0;
 240         default:
 241                 return -EINVAL;
 242         }
 243 }
 244
 245 static int snd_pcm_alloc_vmalloc_buffer(struct snd_pcm_substream *subs,
 246                                         size_t size)
 247 {
 248         struct snd_pcm_runtime *runtime = subs->runtime;
 249
 250         dprintk("Allocating vbuffer\n");
 251         if (runtime->dma_area) {
 252                 if (runtime->dma_bytes > size)
 253                         return 0;
 254
 255                 vfree(runtime->dma_area);
 256         }
 257         runtime->dma_area = vmalloc(size);
 258         if (!runtime->dma_area)
 259                 return -ENOMEM;
 260
 261         runtime->dma_bytes = size;
 262
 263         return 0;
 264 }
 265
 266 static struct snd_pcm_hardware snd_em28xx_hw_capture = {
 267         .info = SNDRV_PCM_INFO_BLOCK_TRANSFER |
 268                 SNDRV_PCM_INFO_MMAP           |
 269                 SNDRV_PCM_INFO_INTERLEAVED    |
 270                 SNDRV_PCM_INFO_MMAP_VALID,
 271
 272         .formats = SNDRV_PCM_FMTBIT_S16_LE,
 273
 274         .rates = SNDRV_PCM_RATE_CONTINUOUS | SNDRV_PCM_RATE_KNOT,
 275
 276         .rate_min = 48000,
 277         .rate_max = 48000,
 278         .channels_min = 2,
 279         .channels_max = 2,
 280         .buffer_bytes_max = 62720 * 8,  /* just about the value in usbaudio.c */
 281         .period_bytes_min = 64,         /* 12544/2, */
 282         .period_bytes_max = 12544,
 283         .periods_min = 2,
 284         .periods_max = 98,              /* 12544, */
 285 };
 286
 287 static int snd_em28xx_capture_open(struct snd_pcm_substream *substream)
 288 {
 289         struct em28xx *dev = snd_pcm_substream_chip(substream);
 290         struct snd_pcm_runtime *runtime = substream->runtime;
 291         int ret = 0;
 292
 293         dprintk("opening device and trying to acquire exclusive lock\n");
 294
 295         if (!dev) {
 296                 em28xx_err("BUG: em28xx can't find device struct."
 297                                 " Can't proceed with open\n");
 298                 return -ENODEV;
 299         }
 300
 301         /* Sets volume, mute, etc */
 302
 303         dev->mute = 0;
 304         mutex_lock(&dev->lock);
 305         ret = em28xx_audio_analog_set(dev);
 306         mutex_unlock(&dev->lock);
 307         if (ret < 0)
 308                 goto err;
 309
 310         runtime->hw = snd_em28xx_hw_capture;
 311         if (dev->alt == 0 && dev->adev.users == 0) {
 312                 int errCode;
 313                 dev->alt = 7;
 314                 errCode = usb_set_interface(dev->udev, 0, 7);
 315                 dprintk("changing alternate number to 7\n");
 316         }
 317
 318         mutex_lock(&dev->lock);
 319         dev->adev.users++;
 320         mutex_unlock(&dev->lock);
 321
 322         snd_pcm_hw_constraint_integer(runtime, SNDRV_PCM_HW_PARAM_PERIODS);
 323         dev->adev.capture_pcm_substream = substream;
 324         runtime->private_data = dev;
 325
 326         return 0;
 327 err:
 328         em28xx_err("Error while configuring em28xx mixer\n");
 329         return ret;
 330 }
 331
 332 static int snd_em28xx_pcm_close(struct snd_pcm_substream *substream)
 333 {
 334         struct em28xx *dev = snd_pcm_substream_chip(substream);
 335
 336         dprintk("closing device\n");
 337
 338         dev->mute = 1;
 339         mutex_lock(&dev->lock);
 340         dev->adev.users--;
 341         em28xx_audio_analog_set(dev);
 342         if (substream->runtime->dma_area) {
 343                 dprintk("freeing\n");
 344                 vfree(substream->runtime->dma_area);
 345                 substream->runtime->dma_area = NULL;
 346         }
 347         mutex_unlock(&dev->lock);
 348
 349         return 0;
 350 }
 351
 352 static int snd_em28xx_hw_capture_params(struct snd_pcm_substream *substream,
 353                                         struct snd_pcm_hw_params *hw_params)
 354 {
 355         unsigned int channels, rate, format;
 356         int ret;
 357
 358         dprintk("Setting capture parameters\n");
 359
 360         ret = snd_pcm_alloc_vmalloc_buffer(substream,
 361                                 params_buffer_bytes(hw_params));
 362         format = params_format(hw_params);
 363         rate = params_rate(hw_params);
 364         channels = params_channels(hw_params);
 365
 366         /* TODO: set up em28xx audio chip to deliver the correct audio format,
 367            current default is 48000hz multiplexed => 96000hz mono
 368            which shouldn't matter since analogue TV only supports mono */
 369         return 0;
 370 }
 371
 372 static int snd_em28xx_hw_capture_free(struct snd_pcm_substream *substream)
 373 {
 374         struct em28xx *dev = snd_pcm_substream_chip(substream);
 375
 376         dprintk("Stop capture, if needed\n");
 377
 378         if (dev->adev.capture_stream == STREAM_ON)
 379                 em28xx_cmd(dev, EM28XX_CAPTURE_STREAM_EN, EM28XX_STOP_AUDIO);
 380
 381         return 0;
 382 }
 383
 384 static int snd_em28xx_prepare(struct snd_pcm_substream *substream)
 385 {
 386         struct em28xx *dev = snd_pcm_substream_chip(substream);
 387
 388         dev->adev.hwptr_done_capture = 0;
 389         dev->adev.capture_transfer_done = 0;
 390
 391         return 0;
 392 }
 393
 394 static int snd_em28xx_capture_trigger(struct snd_pcm_substream *substream,
 395                                       int cmd)
 396 {
 397         struct em28xx *dev = snd_pcm_substream_chip(substream);
 398         int retval;
 399
 400         dprintk("Should %s capture\n", (cmd == SNDRV_PCM_TRIGGER_START) ?
 401                                        "start" : "stop");
 402
 403         spin_lock(&dev->adev.slock);
 404         switch (cmd) {
 405         case SNDRV_PCM_TRIGGER_START:
 406                 em28xx_cmd(dev, EM28XX_CAPTURE_STREAM_EN, EM28XX_START_AUDIO);
 407                 retval = 0;
 408                 break;
 409         case SNDRV_PCM_TRIGGER_STOP:
 410                 em28xx_cmd(dev, EM28XX_CAPTURE_STREAM_EN, EM28XX_STOP_AUDIO);
 411                 retval = 0;
 412                 break;
 413         default:
 414                 retval = -EINVAL;
 415         }
 416
 417         spin_unlock(&dev->adev.slock);
 418         return retval;
 419 }
 420
 421 static snd_pcm_uframes_t snd_em28xx_capture_pointer(struct snd_pcm_substream
 422                                                     *substream)
 423 {
 424         unsigned long flags;
 425         struct em28xx *dev;
 426         snd_pcm_uframes_t hwptr_done;
 427
 428         dev = snd_pcm_substream_chip(substream);
 429         spin_lock_irqsave(&dev->adev.slock, flags);
 430         hwptr_done = dev->adev.hwptr_done_capture;
 431         spin_unlock_irqrestore(&dev->adev.slock, flags);
 432
 433         return hwptr_done;
 434 }
 435
 436 static struct page *snd_pcm_get_vmalloc_page(struct snd_pcm_substream *subs,
 437                                              unsigned long offset)
 438 {
 439         void *pageptr = subs->runtime->dma_area + offset;
 440
 441         return vmalloc_to_page(pageptr);
 442 }
 443
 444 static struct snd_pcm_ops snd_em28xx_pcm_capture = {
 445         .open      = snd_em28xx_capture_open,
 446         .close     = snd_em28xx_pcm_close,
 447         .ioctl     = snd_pcm_lib_ioctl,
 448         .hw_params = snd_em28xx_hw_capture_params,
 449         .hw_free   = snd_em28xx_hw_capture_free,
 450         .prepare   = snd_em28xx_prepare,
 451         .trigger   = snd_em28xx_capture_trigger,
 452         .pointer   = snd_em28xx_capture_pointer,
 453         .page      = snd_pcm_get_vmalloc_page,
 454 };
 455
 456 static int em28xx_audio_init(struct em28xx *dev)
 457 {
 458         struct em28xx_audio *adev = &dev->adev;
 459         struct snd_pcm      *pcm;
 460         struct snd_card     *card;
 461         static int          devnr;
 462         int                 err;
 463
 464         if (dev->has_alsa_audio != 1) {
 465                 /* This device does not support the extension (in this case
 466                    the device is expecting the snd-usb-audio module or
 467                    doesn't have analog audio support at all) */
 468                 return 0;
 469         }
 470
 471         printk(KERN_INFO "em28xx-audio.c: probing for em28x1 "
 472                          "non standard usbaudio\n");
 473         printk(KERN_INFO "em28xx-audio.c: Copyright (C) 2006 Markus "
 474                          "Rechberger\n");
 475
 476         err = snd_card_create(index[devnr], "Em28xx Audio", THIS_MODULE, 0,
 477                               &card);
 478         if (err < 0)
 479                 return err;
 480
 481         spin_lock_init(&adev->slock);
 482         err = snd_pcm_new(card, "Em28xx Audio", 0, 0, 1, &pcm);
 483         if (err < 0) {
 484                 snd_card_free(card);
 485                 return err;
 486         }
 487
 488         snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_CAPTURE, &snd_em28xx_pcm_capture);
 489         pcm->info_flags = 0;
 490         pcm->private_data = dev;
 491         strcpy(pcm->name, "Empia 28xx Capture");
 492
 493         snd_card_set_dev(card, &dev->udev->dev);
 494         strcpy(card->driver, "Em28xx-Audio");
 495         strcpy(card->shortname, "Em28xx Audio");
 496         strcpy(card->longname, "Empia Em28xx Audio");
 497
 498         err = snd_card_register(card);
 499         if (err < 0) {
 500                 snd_card_free(card);
 501                 return err;
 502         }
 503         adev->sndcard = card;
 504         adev->udev = dev->udev;
 505
 506         return 0;
 507 }
 508
 509 static int em28xx_audio_fini(struct em28xx *dev)
 510 {
 511         if (dev == NULL)
 512                 return 0;
 513
 514         if (dev->has_alsa_audio != 1) {
 515                 /* This device does not support the extension (in this case
 516                    the device is expecting the snd-usb-audio module or
 517                    doesn't have analog audio support at all) */
 518                 return 0;
 519         }
 520
 521         if (dev->adev.sndcard) {
 522                 snd_card_free(dev->adev.sndcard);
 523                 dev->adev.sndcard = NULL;
 524         }
 525
 526         return 0;
 527 }
 528
 529 static struct em28xx_ops audio_ops = {
 530         .id   = EM28XX_AUDIO,
 531         .name = "Em28xx Audio Extension",
 532         .init = em28xx_audio_init,
 533         .fini = em28xx_audio_fini,
 534 };
 535
 536 static int __init em28xx_alsa_register(void)
 537 {
 538         return em28xx_register_extension(&audio_ops);
 539 }
 540
 541 static void __exit em28xx_alsa_unregister(void)
 542 {
 543         em28xx_unregister_extension(&audio_ops);
 544 }
 545
 546 MODULE_LICENSE("GPL");
 547 MODULE_AUTHOR("Markus Rechberger <mrechberger@gmail.com>");
 548 MODULE_AUTHOR("Mauro Carvalho Chehab <mchehab@infradead.org>");
 549 MODULE_DESCRIPTION("Em28xx Audio driver");
 550
 551 module_init(em28xx_alsa_register);
 552 module_exit(em28xx_alsa_unregister);