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                                   __FUNCTION__, ##arg);                 \
 55         } while (0)
 56 
 57 static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX;
 58 
 59 static int em28xx_isoc_audio_deinit(struct em28xx *dev)
 60 {
 61         int i;
 62 
 63         dprintk("Stopping isoc\n");
 64         for (i = 0; i < EM28XX_AUDIO_BUFS; i++) {
 65                 usb_kill_urb(dev->adev->urb[i]);
 66                 usb_free_urb(dev->adev->urb[i]);
 67                 dev->adev->urb[i] = NULL;
 68         }
 69 
 70         return 0;
 71 }
 72 
 73 static void em28xx_audio_isocirq(struct urb *urb)
 74 {
 75         struct em28xx            *dev = urb->context;
 76         int                      i;
 77         unsigned int             oldptr;
 78         unsigned long            flags;
 79         int                      period_elapsed = 0;
 80         int                      status;
 81         unsigned char            *cp;
 82         unsigned int             stride;
 83         struct snd_pcm_substream *substream;
 84         struct snd_pcm_runtime   *runtime;
 85         if (dev->adev->capture_pcm_substream) {
 86                 substream = dev->adev->capture_pcm_substream;
 87                 runtime = substream->runtime;
 88                 stride = runtime->frame_bits >> 3;
 89 
 90                 for (i = 0; i < urb->number_of_packets; i++) {
 91                         int length =
 92                             urb->iso_frame_desc[i].actual_length / stride;
 93                         cp = (unsigned char *)urb->transfer_buffer +
 94                             urb->iso_frame_desc[i].offset;
 95 
 96                         if (!length)
 97                                 continue;
 98 
 99                         spin_lock_irqsave(&dev->adev->slock, flags);
100 
101                         oldptr = dev->adev->hwptr_done_capture;
102                         dev->adev->hwptr_done_capture += length;
103                         if (dev->adev->hwptr_done_capture >=
104                             runtime->buffer_size)
105                                 dev->adev->hwptr_done_capture -=
106                                     runtime->buffer_size;
107 
108                         dev->adev->capture_transfer_done += length;
109                         if (dev->adev->capture_transfer_done >=
110                             runtime->period_size) {
111                                 dev->adev->capture_transfer_done -=
112                                     runtime->period_size;
113                                 period_elapsed = 1;
114                         }
115 
116                         spin_unlock_irqrestore(&dev->adev->slock, flags);
117 
118                         if (oldptr + length >= runtime->buffer_size) {
119                                 unsigned int cnt =
120                                     runtime->buffer_size - oldptr - 1;
121                                 memcpy(runtime->dma_area + oldptr * stride, cp,
122                                        cnt * stride);
123                                 memcpy(runtime->dma_area, cp + cnt,
124                                        length * stride - cnt * stride);
125                         } else {
126                                 memcpy(runtime->dma_area + oldptr * stride, cp,
127                                        length * stride);
128                         }
129                 }
130                 if (period_elapsed)
131                         snd_pcm_period_elapsed(substream);
132         }
133         urb->status = 0;
134 
135         if (dev->adev->shutdown)
136                 return;
137 
138         status = usb_submit_urb(urb, GFP_ATOMIC);
139         if (status < 0) {
140                 em28xx_errdev("resubmit of audio urb failed (error=%i)\n",
141                               status);
142         }
143         return;
144 }
145 
146 static int em28xx_init_audio_isoc(struct em28xx *dev)
147 {
148         int       i, errCode;
149         const int sb_size = EM28XX_NUM_AUDIO_PACKETS *
150                             EM28XX_AUDIO_MAX_PACKET_SIZE;
151 
152         dprintk("Starting isoc transfers\n");
153 
154         for (i = 0; i < EM28XX_AUDIO_BUFS; i++) {
155                 struct urb *urb;
156                 int j, k;
157 
158                 dev->adev->transfer_buffer[i] = kmalloc(sb_size, GFP_ATOMIC);
159                 if (!dev->adev->transfer_buffer[i])
160                         return -ENOMEM;
161 
162                 memset(dev->adev->transfer_buffer[i], 0x80, sb_size);
163                 urb = usb_alloc_urb(EM28XX_NUM_AUDIO_PACKETS, GFP_ATOMIC);
164                 if (!urb)
165                         return -ENOMEM;
166 
167                 urb->dev = dev->udev;
168                 urb->context = dev;
169                 urb->pipe = usb_rcvisocpipe(dev->udev, 0x83);
170                 urb->transfer_flags = URB_ISO_ASAP;
171                 urb->transfer_buffer = dev->adev->transfer_buffer[i];
172                 urb->interval = 1;
173                 urb->complete = em28xx_audio_isocirq;
174                 urb->number_of_packets = EM28XX_NUM_AUDIO_PACKETS;
175                 urb->transfer_buffer_length = sb_size;
176 
177                 for (j = k = 0; j < EM28XX_NUM_AUDIO_PACKETS;
178                              j++, k += EM28XX_AUDIO_MAX_PACKET_SIZE) {
179                         urb->iso_frame_desc[j].offset = k;
180                         urb->iso_frame_desc[j].length =
181                             EM28XX_AUDIO_MAX_PACKET_SIZE;
182                 }
183                 dev->adev->urb[i] = urb;
184         }
185 
186         for (i = 0; i < EM28XX_AUDIO_BUFS; i++) {
187                 errCode = usb_submit_urb(dev->adev->urb[i], GFP_ATOMIC);
188                 if (errCode) {
189                         em28xx_isoc_audio_deinit(dev);
190 
191                         return errCode;
192                 }
193         }
194 
195         return 0;
196 }
197 
198 static int em28xx_cmd(struct em28xx *dev, int cmd, int arg)
199 {
200         dprintk("%s transfer\n", (dev->adev->capture_stream == STREAM_ON)?
201                                  "stop" : "start");
202 
203         switch (cmd) {
204         case EM28XX_CAPTURE_STREAM_EN:
205                 if (dev->adev->capture_stream == STREAM_OFF && arg == 1) {
206                         dev->adev->capture_stream = STREAM_ON;
207                         em28xx_init_audio_isoc(dev);
208                 } else if (dev->adev->capture_stream == STREAM_ON && arg == 0) {
209                         dev->adev->capture_stream = STREAM_OFF;
210                         em28xx_isoc_audio_deinit(dev);
211                 } else {
212                         printk(KERN_ERR "An underrun very likely occurred. "
213                                         "Ignoring it.\n");
214                 }
215                 return 0;
216         default:
217                 return -EINVAL;
218         }
219 }
220 
221 static int snd_pcm_alloc_vmalloc_buffer(struct snd_pcm_substream *subs,
222                                         size_t size)
223 {
224         struct snd_pcm_runtime *runtime = subs->runtime;
225 
226         dprintk("Alocating vbuffer\n");
227         if (runtime->dma_area) {
228                 if (runtime->dma_bytes > size)
229                         return 0;
230 
231                 vfree(runtime->dma_area);
232         }
233         runtime->dma_area = vmalloc(size);
234         if (!runtime->dma_area)
235                 return -ENOMEM;
236 
237         runtime->dma_bytes = size;
238 
239         return 0;
240 }
241 
242 static struct snd_pcm_hardware snd_em28xx_hw_capture = {
243         .info = SNDRV_PCM_INFO_BLOCK_TRANSFER |
244                 SNDRV_PCM_INFO_MMAP           |
245                 SNDRV_PCM_INFO_INTERLEAVED    |
246                 SNDRV_PCM_INFO_MMAP_VALID,
247 
248         .formats = SNDRV_PCM_FMTBIT_S16_LE,
249 
250         .rates = SNDRV_PCM_RATE_CONTINUOUS | SNDRV_PCM_RATE_KNOT,
251 
252         .rate_min = 48000,
253         .rate_max = 48000,
254         .channels_min = 2,
255         .channels_max = 2,
256         .buffer_bytes_max = 62720 * 8,  /* just about the value in usbaudio.c */
257         .period_bytes_min = 64,         /* 12544/2, */
258         .period_bytes_max = 12544,
259         .periods_min = 2,
260         .periods_max = 98,              /* 12544, */
261 };
262 
263 static int snd_em28xx_capture_open(struct snd_pcm_substream *substream)
264 {
265         struct em28xx *dev = snd_pcm_substream_chip(substream);
266         struct snd_pcm_runtime *runtime = substream->runtime;
267         int ret = 0;
268 
269         dprintk("opening device and trying to acquire exclusive lock\n");
270 
271         /* Sets volume, mute, etc */
272 
273         dev->mute = 0;
274         mutex_lock(&dev->lock);
275         ret = em28xx_audio_analog_set(dev);
276         mutex_unlock(&dev->lock);
277         if (ret < 0)
278                 goto err;
279 
280         runtime->hw = snd_em28xx_hw_capture;
281         if (dev->alt == 0 && dev->adev->users == 0) {
282                 int errCode;
283                 dev->alt = 7;
284                 errCode = usb_set_interface(dev->udev, 0, 7);
285                 dprintk("changing alternate number to 7\n");
286         }
287 
288         dev->adev->users++;
289 
290         snd_pcm_hw_constraint_integer(runtime, SNDRV_PCM_HW_PARAM_PERIODS);
291         dev->adev->capture_pcm_substream = substream;
292         runtime->private_data = dev;
293 
294         return 0;
295 err:
296         printk(KERN_ERR "Error while configuring em28xx mixer\n");
297         return ret;
298 }
299 
300 static int snd_em28xx_pcm_close(struct snd_pcm_substream *substream)
301 {
302         struct em28xx *dev = snd_pcm_substream_chip(substream);
303         dev->adev->users--;
304 
305         dprintk("closing device\n");
306 
307         dev->mute = 1;
308         mutex_lock(&dev->lock);
309         em28xx_audio_analog_set(dev);
310         mutex_unlock(&dev->lock);
311 
312         if (dev->adev->users == 0 && dev->adev->shutdown == 1) {
313                 dprintk("audio users: %d\n", dev->adev->users);
314                 dprintk("disabling audio stream!\n");
315                 dev->adev->shutdown = 0;
316                 dprintk("released lock\n");
317                 em28xx_cmd(dev, EM28XX_CAPTURE_STREAM_EN, 0);
318         }
319         return 0;
320 }
321 
322 static int snd_em28xx_hw_capture_params(struct snd_pcm_substream *substream,
323                                         struct snd_pcm_hw_params *hw_params)
324 {
325         unsigned int channels, rate, format;
326         int ret;
327 
328         dprintk("Setting capture parameters\n");
329 
330         ret = snd_pcm_alloc_vmalloc_buffer(substream,
331                                 params_buffer_bytes(hw_params));
332         format = params_format(hw_params);
333         rate = params_rate(hw_params);
334         channels = params_channels(hw_params);
335 
336         /* TODO: set up em28xx audio chip to deliver the correct audio format,
337            current default is 48000hz multiplexed => 96000hz mono
338            which shouldn't matter since analogue TV only supports mono */
339         return 0;
340 }
341 
342 static int snd_em28xx_hw_capture_free(struct snd_pcm_substream *substream)
343 {
344         struct em28xx *dev = snd_pcm_substream_chip(substream);
345 
346         dprintk("Stop capture, if needed\n");
347 
348         if (dev->adev->capture_stream == STREAM_ON)
349                 em28xx_cmd(dev, EM28XX_CAPTURE_STREAM_EN, 0);
350 
351         return 0;
352 }
353 
354 static int snd_em28xx_prepare(struct snd_pcm_substream *substream)
355 {
356         return 0;
357 }
358 
359 static int snd_em28xx_capture_trigger(struct snd_pcm_substream *substream,
360                                       int cmd)
361 {
362         struct em28xx *dev = snd_pcm_substream_chip(substream);
363 
364         dprintk("Should %s capture\n", (cmd == SNDRV_PCM_TRIGGER_START)?
365                                        "start": "stop");
366         switch (cmd) {
367         case SNDRV_PCM_TRIGGER_START:
368                 em28xx_cmd(dev, EM28XX_CAPTURE_STREAM_EN, 1);
369                 return 0;
370         case SNDRV_PCM_TRIGGER_STOP:
371                 dev->adev->shutdown = 1;
372                 return 0;
373         default:
374                 return -EINVAL;
375         }
376 }
377 
378 static snd_pcm_uframes_t snd_em28xx_capture_pointer(struct snd_pcm_substream
379                                                     *substream)
380 {
381         struct em28xx *dev;
382 
383         snd_pcm_uframes_t hwptr_done;
384         dev = snd_pcm_substream_chip(substream);
385         hwptr_done = dev->adev->hwptr_done_capture;
386 
387         return hwptr_done;
388 }
389 
390 static struct page *snd_pcm_get_vmalloc_page(struct snd_pcm_substream *subs,
391                                              unsigned long offset)
392 {
393         void *pageptr = subs->runtime->dma_area + offset;
394 
395         return vmalloc_to_page(pageptr);
396 }
397 
398 static struct snd_pcm_ops snd_em28xx_pcm_capture = {
399         .open      = snd_em28xx_capture_open,
400         .close     = snd_em28xx_pcm_close,
401         .ioctl     = snd_pcm_lib_ioctl,
402         .hw_params = snd_em28xx_hw_capture_params,
403         .hw_free   = snd_em28xx_hw_capture_free,
404         .prepare   = snd_em28xx_prepare,
405         .trigger   = snd_em28xx_capture_trigger,
406         .pointer   = snd_em28xx_capture_pointer,
407         .page      = snd_pcm_get_vmalloc_page,
408 };
409 
410 static int em28xx_audio_init(struct em28xx *dev)
411 {
412         struct em28xx_audio *adev;
413         struct snd_pcm      *pcm;
414         struct snd_card     *card;
415         static int          devnr;
416         int                 ret, err;
417 
418         printk(KERN_INFO "em28xx-audio.c: probing for em28x1 "
419                          "non standard usbaudio\n");
420         printk(KERN_INFO "em28xx-audio.c: Copyright (C) 2006 Markus "
421                          "Rechberger\n");
422 
423         adev = kzalloc(sizeof(*adev), GFP_KERNEL);
424         if (!adev) {
425                 printk(KERN_ERR "em28xx-audio.c: out of memory\n");
426                 return -1;
427         }
428         card = snd_card_new(index[devnr], "Em28xx Audio", THIS_MODULE, 0);
429         if (card == NULL) {
430                 kfree(adev);
431                 return -ENOMEM;
432         }
433 
434         spin_lock_init(&adev->slock);
435         ret = snd_pcm_new(card, "Em28xx Audio", 0, 0, 1, &pcm);
436         snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_CAPTURE, &snd_em28xx_pcm_capture);
437         pcm->info_flags = 0;
438         pcm->private_data = dev;
439         strcpy(pcm->name, "Empia 28xx Capture");
440         strcpy(card->driver, "Empia Em28xx Audio");
441         strcpy(card->shortname, "Em28xx Audio");
442         strcpy(card->longname, "Empia Em28xx Audio");
443 
444         err = snd_card_register(card);
445         if (err < 0) {
446                 snd_card_free(card);
447                 return -ENOMEM;
448         }
449         adev->sndcard = card;
450         adev->udev = dev->udev;
451         dev->adev = adev;
452 
453         return 0;
454 }
455 
456 static int em28xx_audio_fini(struct em28xx *dev)
457 {
458         if (dev == NULL)
459                 return 0;
460 
461         if (dev->adev) {
462                 snd_card_free(dev->adev->sndcard);
463                 kfree(dev->adev);
464                 dev->adev = NULL;
465         }
466 
467         return 0;
468 }
469 
470 static struct em28xx_ops audio_ops = {
471         .id   = EM28XX_AUDIO,
472         .name = "Em28xx Audio Extension",
473         .init = em28xx_audio_init,
474         .fini = em28xx_audio_fini,
475 };
476 
477 static int __init em28xx_alsa_register(void)
478 {
479         return em28xx_register_extension(&audio_ops);
480 }
481 
482 static void __exit em28xx_alsa_unregister(void)
483 {
484         em28xx_unregister_extension(&audio_ops);
485 }
486 
487 MODULE_LICENSE("GPL");
488 MODULE_AUTHOR("Markus Rechberger <mrechberger@gmail.com>");
489 MODULE_AUTHOR("Mauro Carvalho Chehab <mchehab@infradead.org>");
490 MODULE_DESCRIPTION("Em28xx Audio driver");
491 
492 module_init(em28xx_alsa_register);
493 module_exit(em28xx_alsa_unregister);
494 
  This page was automatically generated by the LXR engine.