Linux kernel & device driver programming

Cross-Referenced Linux and Device Driver Code

[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ]
Version: [ 2.6.11.8 ] [ 2.6.25 ] [ 2.6.25.8 ] [ 2.6.31.13 ] Architecture: [ i386 ]
  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                 printk(KERN_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         printk(KERN_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, "Empia 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);
553 
  This page was automatically generated by the LXR engine.