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 /* ----------------------------------------------------------- */