3 * Support for audio capture
4 * PCI function #1 of the cx2388x.
6 * (c) 2005,2006 Ricardo Cerqueira <v4l@cerqueira.org>
7 * (c) 2005 Mauro Carvalho Chehab <mchehab@infradead.org>
8 * Based on a dummy cx88 module by Gerd Knorr <kraxel@bytesex.org>
9 * Based on dummy.c by Jaroslav Kysela <perex@suse.cz>
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
21 * You should have received a copy of the GNU General Public License
22 * along with this program; if not, write to the Free Software
23 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
26 #include <linux/module.h>
27 #include <linux/init.h>
28 #include <linux/device.h>
29 #include <linux/interrupt.h>
30 #include <linux/dma-mapping.h>
32 #include <asm/delay.h>
33 #include <sound/driver.h>
34 #include <sound/core.h>
35 #include <sound/pcm.h>
36 #include <sound/pcm_params.h>
37 #include <sound/control.h>
38 #include <sound/initval.h>
43 #define dprintk(level,fmt, arg...) if (debug >= level) \
44 printk(KERN_INFO "%s/1: " fmt, chip->core->name , ## arg)
46 #define dprintk_core(level,fmt, arg...) if (debug >= level) \
47 printk(KERN_DEBUG "%s/1: " fmt, chip->core->name , ## arg)
50 /****************************************************************************
51 Data type declarations - Can be moded to a header file later
52 ****************************************************************************/
54 /* These can be replaced after done */
55 #define MIXER_ADDR_LAST MAX_CX88_INPUT
57 struct cx88_audio_dev {
58 struct cx88_core *core;
59 struct cx88_dmaqueue q;
63 unsigned char pci_rev,pci_lat;
68 struct snd_card *card;
72 unsigned int dma_size;
73 unsigned int period_size;
74 unsigned int num_periods;
76 struct videobuf_dmabuf dma_risc;
78 int mixer_volume[MIXER_ADDR_LAST+1][2];
79 int capture_source[MIXER_ADDR_LAST+1][2];
84 struct cx88_buffer *buf;
87 struct snd_pcm_substream *substream;
90 typedef struct cx88_audio_dev snd_cx88_card_t;
94 /****************************************************************************
95 Module global static vars
96 ****************************************************************************/
98 static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX; /* Index 0-MAX */
99 static char *id[SNDRV_CARDS] = SNDRV_DEFAULT_STR; /* ID for this card */
100 static int enable[SNDRV_CARDS] = {1, [1 ... (SNDRV_CARDS - 1)] = 1};
101 static struct snd_card *snd_cx88_cards[SNDRV_CARDS];
103 module_param_array(enable, bool, NULL, 0444);
104 MODULE_PARM_DESC(enable, "Enable cx88x soundcard. default enabled.");
106 module_param_array(index, int, NULL, 0444);
107 MODULE_PARM_DESC(index, "Index value for cx88x capture interface(s).");
110 /****************************************************************************
112 ****************************************************************************/
114 MODULE_DESCRIPTION("ALSA driver module for cx2388x based TV cards");
115 MODULE_AUTHOR("Ricardo Cerqueira");
116 MODULE_AUTHOR("Mauro Carvalho Chehab <mchehab@infradead.org>");
117 MODULE_LICENSE("GPL");
118 MODULE_SUPPORTED_DEVICE("{{Conexant,23881},"
120 "{{Conexant,23883}");
121 static unsigned int debug;
122 module_param(debug,int,0644);
123 MODULE_PARM_DESC(debug,"enable debug messages");
125 /****************************************************************************
126 Module specific funtions
127 ****************************************************************************/
130 * BOARD Specific: Sets audio DMA
133 static int _cx88_start_audio_dma(snd_cx88_card_t *chip)
135 struct cx88_buffer *buf = chip->buf;
136 struct cx88_core *core=chip->core;
137 struct sram_channel *audio_ch = &cx88_sram_channels[SRAM_CH25];
140 dprintk(1, "Starting audio DMA for %i bytes/line and %i (%i) lines at address %08x\n",buf->bpl, chip->num_periods, audio_ch->fifo_size / buf->bpl, audio_ch->fifo_start);
142 /* setup fifo + format - out channel */
143 cx88_sram_channel_setup(chip->core, &cx88_sram_channels[SRAM_CH25],
144 buf->bpl, buf->risc.dma);
147 cx_write(MO_AUDD_LNGTH, buf->bpl);
150 cx_write(MO_AUDD_GPCNTRL,GP_COUNT_CONTROL_RESET);
152 dprintk(1,"Enabling IRQ, setting mask from 0x%x to 0x%x\n",chip->core->pci_irqmask,(chip->core->pci_irqmask | 0x02));
154 cx_set(MO_PCI_INTMSK, chip->core->pci_irqmask | 0x02);
157 /* Enables corresponding bits at AUD_INT_STAT */
158 cx_write(MO_AUD_INTMSK,
166 cx_set(MO_DEV_CNTRL2, (1<<5)); /* Enables Risc Processor */
167 cx_set(MO_AUD_DMACNTRL, 0x11); /* audio downstream FIFO and RISC enable */
170 cx88_sram_channel_dump(chip->core, &cx88_sram_channels[SRAM_CH25]);
176 * BOARD Specific: Resets audio DMA
178 static int _cx88_stop_audio_dma(snd_cx88_card_t *chip)
180 struct cx88_core *core=chip->core;
181 dprintk(1, "Stopping audio DMA\n");
184 cx_clear(MO_AUD_DMACNTRL, 0x11);
187 cx_clear(MO_PCI_INTMSK, 0x02);
188 cx_clear(MO_AUD_INTMSK,
196 cx88_sram_channel_dump(chip->core, &cx88_sram_channels[SRAM_CH25]);
201 #define MAX_IRQ_LOOP 10
204 * BOARD Specific: IRQ dma bits
206 static char *cx88_aud_irqs[32] = {
207 "dn_risci1", "up_risci1", "rds_dn_risc1", /* 0-2 */
209 "dn_risci2", "up_risci2", "rds_dn_risc2", /* 4-6 */
211 "dnf_of", "upf_uf", "rds_dnf_uf", /* 8-10 */
213 "dn_sync", "up_sync", "rds_dn_sync", /* 12-14 */
215 "opc_err", "par_err", "rip_err", /* 16-18 */
216 "pci_abort", "ber_irq", "mchg_irq" /* 19-21 */
220 * BOARD Specific: Threats IRQ audio specific calls
222 static void cx8801_aud_irq(snd_cx88_card_t *chip)
224 struct cx88_core *core = chip->core;
228 status = cx_read(MO_AUD_INTSTAT);
229 mask = cx_read(MO_AUD_INTMSK);
230 if (0 == (status & mask)) {
231 spin_unlock(&chip->reg_lock);
234 cx_write(MO_AUD_INTSTAT, status);
235 if (debug > 1 || (status & mask & ~0xff))
236 cx88_print_irqbits(core->name, "irq aud",
237 cx88_aud_irqs, ARRAY_SIZE(cx88_aud_irqs),
239 /* risc op code error */
240 if (status & (1 << 16)) {
241 printk(KERN_WARNING "%s/0: audio risc op code error\n",core->name);
242 cx_clear(MO_AUD_DMACNTRL, 0x11);
243 cx88_sram_channel_dump(core, &cx88_sram_channels[SRAM_CH25]);
246 /* risc1 downstream */
248 spin_lock(&chip->reg_lock);
249 count = cx_read(MO_AUDD_GPCNT);
250 spin_unlock(&chip->reg_lock);
251 if (chip->read_count == 0)
252 chip->read_count += chip->dma_size;
255 if (chip->read_count >= chip->period_size) {
256 dprintk(2, "Elapsing period\n");
257 snd_pcm_period_elapsed(chip->substream);
260 dprintk(3,"Leaving audio IRQ handler...\n");
262 /* FIXME: Any other status should deserve a special handling? */
266 * BOARD Specific: Handles IRQ calls
268 static irqreturn_t cx8801_irq(int irq, void *dev_id)
270 snd_cx88_card_t *chip = dev_id;
271 struct cx88_core *core = chip->core;
273 int loop, handled = 0;
275 for (loop = 0; loop < MAX_IRQ_LOOP; loop++) {
276 status = cx_read(MO_PCI_INTSTAT) & (core->pci_irqmask | 0x02);
279 dprintk( 3, "cx8801_irq\n" );
280 dprintk( 3, " loop: %d/%d\n", loop, MAX_IRQ_LOOP );
281 dprintk( 3, " status: %d\n", status );
283 cx_write(MO_PCI_INTSTAT, status);
287 dprintk( 2, " ALSA IRQ handling\n" );
288 cx8801_aud_irq(chip);
292 if (MAX_IRQ_LOOP == loop) {
293 dprintk( 0, "clearing mask\n" );
294 dprintk(1,"%s/0: irq loop -- clearing mask\n",
296 cx_clear(MO_PCI_INTMSK,0x02);
300 return IRQ_RETVAL(handled);
304 static int dsp_buffer_free(snd_cx88_card_t *chip)
306 BUG_ON(!chip->dma_size);
308 dprintk(2,"Freeing buffer\n");
309 videobuf_pci_dma_unmap(chip->pci, &chip->dma_risc);
310 videobuf_dma_free(&chip->dma_risc);
311 btcx_riscmem_free(chip->pci,&chip->buf->risc);
319 /****************************************************************************
321 ****************************************************************************/
324 * Digital hardware definition
326 static struct snd_pcm_hardware snd_cx88_digital_hw = {
327 .info = SNDRV_PCM_INFO_MMAP |
328 SNDRV_PCM_INFO_INTERLEAVED |
329 SNDRV_PCM_INFO_BLOCK_TRANSFER |
330 SNDRV_PCM_INFO_MMAP_VALID,
331 .formats = SNDRV_PCM_FMTBIT_S16_LE,
333 .rates = SNDRV_PCM_RATE_48000,
338 .buffer_bytes_max = (2*2048),
339 .period_bytes_min = 2048,
340 .period_bytes_max = 2048,
346 * audio pcm capture runtime free
348 static void snd_card_cx88_runtime_free(struct snd_pcm_runtime *runtime)
352 * audio pcm capture open callback
354 static int snd_cx88_pcm_open(struct snd_pcm_substream *substream)
356 snd_cx88_card_t *chip = snd_pcm_substream_chip(substream);
357 struct snd_pcm_runtime *runtime = substream->runtime;
360 if (test_and_set_bit(0, &chip->opened))
363 err = snd_pcm_hw_constraint_integer(runtime, SNDRV_PCM_HW_PARAM_PERIODS);
367 chip->substream = substream;
369 chip->read_count = 0;
370 chip->read_offset = 0;
372 runtime->private_free = snd_card_cx88_runtime_free;
373 runtime->hw = snd_cx88_digital_hw;
377 dprintk(1,"Error opening PCM!\n");
378 clear_bit(0, &chip->opened);
379 smp_mb__after_clear_bit();
384 * audio close callback
386 static int snd_cx88_close(struct snd_pcm_substream *substream)
388 snd_cx88_card_t *chip = snd_pcm_substream_chip(substream);
390 clear_bit(0, &chip->opened);
391 smp_mb__after_clear_bit();
399 static int snd_cx88_hw_params(struct snd_pcm_substream * substream,
400 struct snd_pcm_hw_params * hw_params)
402 snd_cx88_card_t *chip = snd_pcm_substream_chip(substream);
403 struct cx88_buffer *buf;
405 if (substream->runtime->dma_area) {
406 dsp_buffer_free(chip);
407 substream->runtime->dma_area = NULL;
411 chip->period_size = params_period_bytes(hw_params);
412 chip->num_periods = params_periods(hw_params);
413 chip->dma_size = chip->period_size * params_periods(hw_params);
415 BUG_ON(!chip->dma_size);
417 dprintk(1,"Setting buffer\n");
419 buf = kzalloc(sizeof(*buf),GFP_KERNEL);
423 buf->vb.memory = V4L2_MEMORY_MMAP;
424 buf->vb.width = chip->period_size;
425 buf->vb.height = chip->num_periods;
426 buf->vb.size = chip->dma_size;
427 buf->vb.field = V4L2_FIELD_NONE;
429 videobuf_dma_init(&buf->vb.dma);
430 videobuf_dma_init_kernel(&buf->vb.dma,PCI_DMA_FROMDEVICE,
431 (PAGE_ALIGN(buf->vb.size) >> PAGE_SHIFT));
433 videobuf_pci_dma_map(chip->pci,&buf->vb.dma);
436 cx88_risc_databuffer(chip->pci, &buf->risc,
438 buf->vb.width, buf->vb.height);
440 buf->risc.jmp[0] = cpu_to_le32(RISC_JUMP | RISC_IRQ1 | RISC_CNT_INC);
441 buf->risc.jmp[1] = cpu_to_le32(buf->risc.dma);
443 buf->vb.state = STATE_PREPARED;
445 buf->bpl = chip->period_size;
447 chip->dma_risc = buf->vb.dma;
449 dprintk(1,"Buffer ready at %u\n",chip->dma_risc.nr_pages);
450 substream->runtime->dma_area = chip->dma_risc.vmalloc;
457 static int snd_cx88_hw_free(struct snd_pcm_substream * substream)
460 snd_cx88_card_t *chip = snd_pcm_substream_chip(substream);
462 if (substream->runtime->dma_area) {
463 dsp_buffer_free(chip);
464 substream->runtime->dma_area = NULL;
473 static int snd_cx88_prepare(struct snd_pcm_substream *substream)
482 static int snd_cx88_card_trigger(struct snd_pcm_substream *substream, int cmd)
484 snd_cx88_card_t *chip = snd_pcm_substream_chip(substream);
487 spin_lock(&chip->reg_lock);
490 case SNDRV_PCM_TRIGGER_START:
491 err=_cx88_start_audio_dma(chip);
493 case SNDRV_PCM_TRIGGER_STOP:
494 err=_cx88_stop_audio_dma(chip);
501 spin_unlock(&chip->reg_lock);
509 static snd_pcm_uframes_t snd_cx88_pointer(struct snd_pcm_substream *substream)
511 snd_cx88_card_t *chip = snd_pcm_substream_chip(substream);
512 struct snd_pcm_runtime *runtime = substream->runtime;
514 if (chip->read_count) {
515 chip->read_count -= snd_pcm_lib_period_bytes(substream);
516 chip->read_offset += snd_pcm_lib_period_bytes(substream);
517 if (chip->read_offset == chip->dma_size)
518 chip->read_offset = 0;
521 dprintk(2, "Pointer time, will return %li, read %li\n",chip->read_offset,chip->read_count);
522 return bytes_to_frames(runtime, chip->read_offset);
529 static struct snd_pcm_ops snd_cx88_pcm_ops = {
530 .open = snd_cx88_pcm_open,
531 .close = snd_cx88_close,
532 .ioctl = snd_pcm_lib_ioctl,
533 .hw_params = snd_cx88_hw_params,
534 .hw_free = snd_cx88_hw_free,
535 .prepare = snd_cx88_prepare,
536 .trigger = snd_cx88_card_trigger,
537 .pointer = snd_cx88_pointer,
541 * create a PCM device
543 static int __devinit snd_cx88_pcm(snd_cx88_card_t *chip, int device, char *name)
548 err = snd_pcm_new(chip->card, name, device, 0, 1, &pcm);
551 pcm->private_data = chip;
552 strcpy(pcm->name, name);
553 snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_CAPTURE, &snd_cx88_pcm_ops);
558 /****************************************************************************
560 ****************************************************************************/
561 static int snd_cx88_capture_volume_info(struct snd_kcontrol *kcontrol,
562 struct snd_ctl_elem_info *info)
564 info->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
566 info->value.integer.min = 0;
567 info->value.integer.max = 0x3f;
572 /* OK - TODO: test it */
573 static int snd_cx88_capture_volume_get(struct snd_kcontrol *kcontrol,
574 struct snd_ctl_elem_value *value)
576 snd_cx88_card_t *chip = snd_kcontrol_chip(kcontrol);
577 struct cx88_core *core=chip->core;
579 value->value.integer.value[0] = 0x3f - (cx_read(AUD_VOL_CTL) & 0x3f);
584 /* OK - TODO: test it */
585 static int snd_cx88_capture_volume_put(struct snd_kcontrol *kcontrol,
586 struct snd_ctl_elem_value *value)
588 snd_cx88_card_t *chip = snd_kcontrol_chip(kcontrol);
589 struct cx88_core *core=chip->core;
593 spin_lock_irq(&chip->reg_lock);
594 old_control = 0x3f - (cx_read(AUD_VOL_CTL) & 0x3f);
595 v = 0x3f - (value->value.integer.value[0] & 0x3f);
596 cx_andor(AUD_VOL_CTL, 0x3f, v);
597 spin_unlock_irq(&chip->reg_lock);
599 return v != old_control;
602 static struct snd_kcontrol_new snd_cx88_capture_volume = {
603 .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
604 .name = "Capture Volume",
605 .info = snd_cx88_capture_volume_info,
606 .get = snd_cx88_capture_volume_get,
607 .put = snd_cx88_capture_volume_put,
611 /****************************************************************************
612 Basic Flow for Sound Devices
613 ****************************************************************************/
616 * PCI ID Table - 14f1:8801 and 14f1:8811 means function 1: Audio
617 * Only boards with eeprom and byte 1 at eeprom=1 have it
620 static struct pci_device_id cx88_audio_pci_tbl[] __devinitdata = {
621 {0x14f1,0x8801,PCI_ANY_ID,PCI_ANY_ID,0,0,0},
622 {0x14f1,0x8811,PCI_ANY_ID,PCI_ANY_ID,0,0,0},
625 MODULE_DEVICE_TABLE(pci, cx88_audio_pci_tbl);
628 * Chip-specific destructor
631 static int snd_cx88_free(snd_cx88_card_t *chip)
635 synchronize_irq(chip->irq);
636 free_irq(chip->irq, chip);
639 cx88_core_put(chip->core,chip->pci);
641 pci_disable_device(chip->pci);
646 * Component Destructor
648 static void snd_cx88_dev_free(struct snd_card * card)
650 snd_cx88_card_t *chip = card->private_data;
657 * Alsa Constructor - Component probe
661 static int __devinit snd_cx88_create(struct snd_card *card,
663 snd_cx88_card_t **rchip)
665 snd_cx88_card_t *chip;
666 struct cx88_core *core;
671 err = pci_enable_device(pci);
677 chip = (snd_cx88_card_t *) card->private_data;
679 core = cx88_core_get(pci);
686 if (!pci_dma_supported(pci,DMA_32BIT_MASK)) {
687 dprintk(0, "%s/1: Oops: no 32bit PCI DMA ???\n",core->name);
689 cx88_core_put(core,pci);
698 spin_lock_init(&chip->reg_lock);
703 err = request_irq(chip->pci->irq, cx8801_irq,
704 IRQF_SHARED | IRQF_DISABLED, chip->core->name, chip);
706 dprintk(0, "%s: can't get IRQ %d\n",
707 chip->core->name, chip->pci->irq);
712 pci_read_config_byte(pci, PCI_CLASS_REVISION, &chip->pci_rev);
713 pci_read_config_byte(pci, PCI_LATENCY_TIMER, &chip->pci_lat);
715 dprintk(1,"ALSA %s/%i: found at %s, rev: %d, irq: %d, "
716 "latency: %d, mmio: 0x%llx\n", core->name, devno,
717 pci_name(pci), chip->pci_rev, pci->irq,
718 chip->pci_lat,(unsigned long long)pci_resource_start(pci,0));
720 chip->irq = pci->irq;
721 synchronize_irq(chip->irq);
723 snd_card_set_dev(card, &pci->dev);
730 static int __devinit cx88_audio_initdev(struct pci_dev *pci,
731 const struct pci_device_id *pci_id)
733 struct snd_card *card;
734 snd_cx88_card_t *chip;
737 if (devno >= SNDRV_CARDS)
740 if (!enable[devno]) {
745 card = snd_card_new(index[devno], id[devno], THIS_MODULE, sizeof(snd_cx88_card_t));
749 card->private_free = snd_cx88_dev_free;
751 err = snd_cx88_create(card, pci, &chip);
755 err = snd_cx88_pcm(chip, 0, "CX88 Digital");
762 err = snd_ctl_add(card, snd_ctl_new1(&snd_cx88_capture_volume, chip));
768 strcpy (card->driver, "CX88x");
769 sprintf(card->shortname, "Conexant CX%x", pci->device);
770 sprintf(card->longname, "%s at %#llx",
771 card->shortname,(unsigned long long)pci_resource_start(pci, 0));
772 strcpy (card->mixername, "CX88");
774 dprintk (0, "%s/%i: ALSA support for cx2388x boards\n",
777 err = snd_card_register(card);
782 snd_cx88_cards[devno] = card;
784 pci_set_drvdata(pci,card);
792 static void __devexit cx88_audio_finidev(struct pci_dev *pci)
794 struct cx88_audio_dev *card = pci_get_drvdata(pci);
796 snd_card_free((void *)card);
798 pci_set_drvdata(pci, NULL);
804 * PCI driver definition
807 static struct pci_driver cx88_audio_pci_driver = {
808 .name = "cx88_audio",
809 .id_table = cx88_audio_pci_tbl,
810 .probe = cx88_audio_initdev,
811 .remove = cx88_audio_finidev,
814 /****************************************************************************
816 ****************************************************************************/
821 static int cx88_audio_init(void)
823 printk(KERN_INFO "cx2388x alsa driver version %d.%d.%d loaded\n",
824 (CX88_VERSION_CODE >> 16) & 0xff,
825 (CX88_VERSION_CODE >> 8) & 0xff,
826 CX88_VERSION_CODE & 0xff);
828 printk(KERN_INFO "cx2388x: snapshot date %04d-%02d-%02d\n",
829 SNAPSHOT/10000, (SNAPSHOT/100)%100, SNAPSHOT%100);
831 return pci_register_driver(&cx88_audio_pci_driver);
837 static void cx88_audio_fini(void)
840 pci_unregister_driver(&cx88_audio_pci_driver);
843 module_init(cx88_audio_init);
844 module_exit(cx88_audio_fini);
846 /* ----------------------------------------------------------- */