2 * Driver for the Conexant CX25821 PCIe bridge
4 * Copyright (C) 2009 Conexant Systems Inc.
5 * Authors <shu.lin@conexant.com>, <hiep.huynh@conexant.com>
6 * Based on SAA713x ALSA driver and CX88 driver
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation, version 2
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
25 #include <linux/module.h>
26 #include <linux/init.h>
27 #include <linux/device.h>
28 #include <linux/interrupt.h>
29 #include <linux/vmalloc.h>
30 #include <linux/dma-mapping.h>
31 #include <linux/pci.h>
32 #include <linux/slab.h>
34 #include <linux/delay.h>
35 #include <sound/core.h>
36 #include <sound/pcm.h>
37 #include <sound/pcm_params.h>
38 #include <sound/control.h>
39 #include <sound/initval.h>
40 #include <sound/tlv.h>
43 #include "cx25821-reg.h"
45 #define AUDIO_SRAM_CHANNEL SRAM_CH08
47 #define dprintk(level, fmt, arg...) \
50 pr_info("%s/1: " fmt, chip->dev->name, ##arg); \
52 #define dprintk_core(level, fmt, arg...) \
55 printk(KERN_DEBUG "%s/1: " fmt, chip->dev->name, ##arg); \
58 /****************************************************************************
59 Data type declarations - Can be moded to a header file later
60 ****************************************************************************/
62 static struct snd_card
*snd_cx25821_cards
[SNDRV_CARDS
];
65 struct cx25821_audio_buffer
{
67 struct btcx_riscmem risc
;
68 struct videobuf_dmabuf dma
;
71 struct cx25821_audio_dev
{
72 struct cx25821_dev
*dev
;
73 struct cx25821_dmaqueue q
;
81 struct snd_card
*card
;
87 unsigned int dma_size
;
88 unsigned int period_size
;
89 unsigned int num_periods
;
91 struct videobuf_dmabuf
*dma_risc
;
93 struct cx25821_audio_buffer
*buf
;
95 struct snd_pcm_substream
*substream
;
99 /****************************************************************************
100 Module global static vars
101 ****************************************************************************/
103 static int index
[SNDRV_CARDS
] = SNDRV_DEFAULT_IDX
; /* Index 0-MAX */
104 static char *id
[SNDRV_CARDS
] = SNDRV_DEFAULT_STR
; /* ID for this card */
105 static int enable
[SNDRV_CARDS
] = { 1, [1 ... (SNDRV_CARDS
- 1)] = 1 };
107 module_param_array(enable
, bool, NULL
, 0444);
108 MODULE_PARM_DESC(enable
, "Enable cx25821 soundcard. default enabled.");
110 module_param_array(index
, int, NULL
, 0444);
111 MODULE_PARM_DESC(index
, "Index value for cx25821 capture interface(s).");
113 /****************************************************************************
115 ****************************************************************************/
117 MODULE_DESCRIPTION("ALSA driver module for cx25821 based capture cards");
118 MODULE_AUTHOR("Hiep Huynh");
119 MODULE_LICENSE("GPL");
120 MODULE_SUPPORTED_DEVICE("{{Conexant,25821}"); /* "{{Conexant,23881}," */
122 static unsigned int debug
;
123 module_param(debug
, int, 0644);
124 MODULE_PARM_DESC(debug
, "enable debug messages");
126 /****************************************************************************
127 Module specific funtions
128 ****************************************************************************/
129 /* Constants taken from cx88-reg.h */
130 #define AUD_INT_DN_RISCI1 (1 << 0)
131 #define AUD_INT_UP_RISCI1 (1 << 1)
132 #define AUD_INT_RDS_DN_RISCI1 (1 << 2)
133 #define AUD_INT_DN_RISCI2 (1 << 4) /* yes, 3 is skipped */
134 #define AUD_INT_UP_RISCI2 (1 << 5)
135 #define AUD_INT_RDS_DN_RISCI2 (1 << 6)
136 #define AUD_INT_DN_SYNC (1 << 12)
137 #define AUD_INT_UP_SYNC (1 << 13)
138 #define AUD_INT_RDS_DN_SYNC (1 << 14)
139 #define AUD_INT_OPC_ERR (1 << 16)
140 #define AUD_INT_BER_IRQ (1 << 20)
141 #define AUD_INT_MCHG_IRQ (1 << 21)
142 #define GP_COUNT_CONTROL_RESET 0x3
144 #define PCI_MSK_AUD_EXT (1 << 4)
145 #define PCI_MSK_AUD_INT (1 << 3)
147 * BOARD Specific: Sets audio DMA
150 static int _cx25821_start_audio_dma(struct cx25821_audio_dev
*chip
)
152 struct cx25821_audio_buffer
*buf
= chip
->buf
;
153 struct cx25821_dev
*dev
= chip
->dev
;
154 struct sram_channel
*audio_ch
=
155 &cx25821_sram_channels
[AUDIO_SRAM_CHANNEL
];
158 /* enable output on the GPIO 0 for the MCLK ADC (Audio) */
159 cx25821_set_gpiopin_direction(chip
->dev
, 0, 0);
161 /* Make sure RISC/FIFO are off before changing FIFO/RISC settings */
162 cx_clear(AUD_INT_DMA_CTL
,
163 FLD_AUD_DST_A_RISC_EN
| FLD_AUD_DST_A_FIFO_EN
);
165 /* setup fifo + format - out channel */
166 cx25821_sram_channel_setup_audio(chip
->dev
, audio_ch
, buf
->bpl
,
170 cx_write(AUD_A_LNGTH
, buf
->bpl
);
173 /* GP_COUNT_CONTROL_RESET = 0x3 */
174 cx_write(AUD_A_GPCNT_CTL
, GP_COUNT_CONTROL_RESET
);
175 atomic_set(&chip
->count
, 0);
177 /* Set the input mode to 16-bit */
178 tmp
= cx_read(AUD_A_CFG
);
180 tmp
| FLD_AUD_DST_PK_MODE
| FLD_AUD_DST_ENABLE
|
184 pr_info("DEBUG: Start audio DMA, %d B/line, cmds_start(0x%x)= %d lines/FIFO, %d periods, %d byte buffer\n",
185 buf->bpl, audio_ch->cmds_start,
186 cx_read(audio_ch->cmds_start + 12)>>1,
187 chip->num_periods, buf->bpl * chip->num_periods);
190 /* Enables corresponding bits at AUD_INT_STAT */
191 cx_write(AUD_A_INT_MSK
,
192 FLD_AUD_DST_RISCI1
| FLD_AUD_DST_OF
| FLD_AUD_DST_SYNC
|
193 FLD_AUD_DST_OPC_ERR
);
195 /* Clean any pending interrupt bits already set */
196 cx_write(AUD_A_INT_STAT
, ~0);
198 /* enable audio irqs */
199 cx_set(PCI_INT_MSK
, chip
->dev
->pci_irqmask
| PCI_MSK_AUD_INT
);
201 /* Turn on audio downstream fifo and risc enable 0x101 */
202 tmp
= cx_read(AUD_INT_DMA_CTL
);
203 cx_set(AUD_INT_DMA_CTL
,
204 tmp
| (FLD_AUD_DST_A_RISC_EN
| FLD_AUD_DST_A_FIFO_EN
));
211 * BOARD Specific: Resets audio DMA
213 static int _cx25821_stop_audio_dma(struct cx25821_audio_dev
*chip
)
215 struct cx25821_dev
*dev
= chip
->dev
;
218 cx_clear(AUD_INT_DMA_CTL
,
219 FLD_AUD_DST_A_RISC_EN
| FLD_AUD_DST_A_FIFO_EN
);
222 cx_clear(PCI_INT_MSK
, PCI_MSK_AUD_INT
);
223 cx_clear(AUD_A_INT_MSK
,
224 AUD_INT_OPC_ERR
| AUD_INT_DN_SYNC
| AUD_INT_DN_RISCI2
|
230 #define MAX_IRQ_LOOP 50
233 * BOARD Specific: IRQ dma bits
235 static char *cx25821_aud_irqs
[32] = {
236 "dn_risci1", "up_risci1", "rds_dn_risc1", /* 0-2 */
238 "dn_risci2", "up_risci2", "rds_dn_risc2", /* 4-6 */
240 "dnf_of", "upf_uf", "rds_dnf_uf", /* 8-10 */
242 "dn_sync", "up_sync", "rds_dn_sync", /* 12-14 */
244 "opc_err", "par_err", "rip_err", /* 16-18 */
245 "pci_abort", "ber_irq", "mchg_irq" /* 19-21 */
249 * BOARD Specific: Threats IRQ audio specific calls
251 static void cx25821_aud_irq(struct cx25821_audio_dev
*chip
, u32 status
,
254 struct cx25821_dev
*dev
= chip
->dev
;
256 if (0 == (status
& mask
))
259 cx_write(AUD_A_INT_STAT
, status
);
260 if (debug
> 1 || (status
& mask
& ~0xff))
261 cx25821_print_irqbits(dev
->name
, "irq aud",
263 ARRAY_SIZE(cx25821_aud_irqs
), status
,
266 /* risc op code error */
267 if (status
& AUD_INT_OPC_ERR
) {
268 pr_warn("WARNING %s/1: Audio risc op code error\n", dev
->name
);
270 cx_clear(AUD_INT_DMA_CTL
,
271 FLD_AUD_DST_A_RISC_EN
| FLD_AUD_DST_A_FIFO_EN
);
272 cx25821_sram_channel_dump_audio(dev
,
273 &cx25821_sram_channels
274 [AUDIO_SRAM_CHANNEL
]);
276 if (status
& AUD_INT_DN_SYNC
) {
277 pr_warn("WARNING %s: Downstream sync error!\n", dev
->name
);
278 cx_write(AUD_A_GPCNT_CTL
, GP_COUNT_CONTROL_RESET
);
282 /* risc1 downstream */
283 if (status
& AUD_INT_DN_RISCI1
) {
284 atomic_set(&chip
->count
, cx_read(AUD_A_GPCNT
));
285 snd_pcm_period_elapsed(chip
->substream
);
290 * BOARD Specific: Handles IRQ calls
292 static irqreturn_t
cx25821_irq(int irq
, void *dev_id
)
294 struct cx25821_audio_dev
*chip
= dev_id
;
295 struct cx25821_dev
*dev
= chip
->dev
;
296 u32 status
, pci_status
;
297 u32 audint_status
, audint_mask
;
298 int loop
, handled
= 0;
299 int audint_count
= 0;
301 audint_status
= cx_read(AUD_A_INT_STAT
);
302 audint_mask
= cx_read(AUD_A_INT_MSK
);
303 audint_count
= cx_read(AUD_A_GPCNT
);
304 status
= cx_read(PCI_INT_STAT
);
306 for (loop
= 0; loop
< 1; loop
++) {
307 status
= cx_read(PCI_INT_STAT
);
309 status
= cx_read(PCI_INT_STAT
);
310 audint_status
= cx_read(AUD_A_INT_STAT
);
311 audint_mask
= cx_read(AUD_A_INT_MSK
);
315 cx_write(PCI_INT_STAT
, status
);
317 cx25821_aud_irq(chip
, audint_status
,
325 cx_write(PCI_INT_STAT
, status
);
327 cx25821_aud_irq(chip
, audint_status
, audint_mask
);
330 pci_status
= cx_read(PCI_INT_STAT
);
333 cx_write(PCI_INT_STAT
, pci_status
);
336 return IRQ_RETVAL(handled
);
339 static int dsp_buffer_free(struct cx25821_audio_dev
*chip
)
341 BUG_ON(!chip
->dma_size
);
343 dprintk(2, "Freeing buffer\n");
344 videobuf_dma_unmap(&chip
->pci
->dev
, chip
->dma_risc
);
345 videobuf_dma_free(chip
->dma_risc
);
346 btcx_riscmem_free(chip
->pci
, &chip
->buf
->risc
);
349 chip
->dma_risc
= NULL
;
355 /****************************************************************************
357 ****************************************************************************/
360 * Digital hardware definition
362 #define DEFAULT_FIFO_SIZE 384
363 static struct snd_pcm_hardware snd_cx25821_digital_hw
= {
364 .info
= SNDRV_PCM_INFO_MMAP
|
365 SNDRV_PCM_INFO_INTERLEAVED
|
366 SNDRV_PCM_INFO_BLOCK_TRANSFER
| SNDRV_PCM_INFO_MMAP_VALID
,
367 .formats
= SNDRV_PCM_FMTBIT_S16_LE
,
369 .rates
= SNDRV_PCM_RATE_48000
,
374 /* Analog audio output will be full of clicks and pops if there
375 are not exactly four lines in the SRAM FIFO buffer. */
376 .period_bytes_min
= DEFAULT_FIFO_SIZE
/ 3,
377 .period_bytes_max
= DEFAULT_FIFO_SIZE
/ 3,
379 .periods_max
= AUDIO_LINE_SIZE
,
380 /* 128 * 128 = 16384 = 1024 * 16 */
381 .buffer_bytes_max
= (AUDIO_LINE_SIZE
* AUDIO_LINE_SIZE
),
385 * audio pcm capture open callback
387 static int snd_cx25821_pcm_open(struct snd_pcm_substream
*substream
)
389 struct cx25821_audio_dev
*chip
= snd_pcm_substream_chip(substream
);
390 struct snd_pcm_runtime
*runtime
= substream
->runtime
;
392 unsigned int bpl
= 0;
395 pr_err("DEBUG: cx25821 can't find device struct. Can't proceed with open\n");
400 snd_pcm_hw_constraint_pow2(runtime
, 0, SNDRV_PCM_HW_PARAM_PERIODS
);
404 chip
->substream
= substream
;
406 runtime
->hw
= snd_cx25821_digital_hw
;
408 if (cx25821_sram_channels
[AUDIO_SRAM_CHANNEL
].fifo_size
!=
410 /* since there are 3 audio Clusters */
411 bpl
= cx25821_sram_channels
[AUDIO_SRAM_CHANNEL
].fifo_size
/ 3;
412 bpl
&= ~7; /* must be multiple of 8 */
414 if (bpl
> AUDIO_LINE_SIZE
)
415 bpl
= AUDIO_LINE_SIZE
;
417 runtime
->hw
.period_bytes_min
= bpl
;
418 runtime
->hw
.period_bytes_max
= bpl
;
423 dprintk(1, "Error opening PCM!\n");
428 * audio close callback
430 static int snd_cx25821_close(struct snd_pcm_substream
*substream
)
438 static int snd_cx25821_hw_params(struct snd_pcm_substream
*substream
,
439 struct snd_pcm_hw_params
*hw_params
)
441 struct cx25821_audio_dev
*chip
= snd_pcm_substream_chip(substream
);
442 struct videobuf_dmabuf
*dma
;
444 struct cx25821_audio_buffer
*buf
;
447 if (substream
->runtime
->dma_area
) {
448 dsp_buffer_free(chip
);
449 substream
->runtime
->dma_area
= NULL
;
452 chip
->period_size
= params_period_bytes(hw_params
);
453 chip
->num_periods
= params_periods(hw_params
);
454 chip
->dma_size
= chip
->period_size
* params_periods(hw_params
);
456 BUG_ON(!chip
->dma_size
);
457 BUG_ON(chip
->num_periods
& (chip
->num_periods
- 1));
459 buf
= kzalloc(sizeof(*buf
), GFP_KERNEL
);
463 if (chip
->period_size
> AUDIO_LINE_SIZE
)
464 chip
->period_size
= AUDIO_LINE_SIZE
;
466 buf
->bpl
= chip
->period_size
;
469 videobuf_dma_init(dma
);
470 ret
= videobuf_dma_init_kernel(dma
, PCI_DMA_FROMDEVICE
,
471 (PAGE_ALIGN(chip
->dma_size
) >>
476 ret
= videobuf_dma_map(&chip
->pci
->dev
, dma
);
481 cx25821_risc_databuffer_audio(chip
->pci
, &buf
->risc
, dma
->sglist
,
482 chip
->period_size
, chip
->num_periods
,
485 pr_info("DEBUG: ERROR after cx25821_risc_databuffer_audio()\n");
489 /* Loop back to start of program */
490 buf
->risc
.jmp
[0] = cpu_to_le32(RISC_JUMP
| RISC_IRQ1
| RISC_CNT_INC
);
491 buf
->risc
.jmp
[1] = cpu_to_le32(buf
->risc
.dma
);
492 buf
->risc
.jmp
[2] = cpu_to_le32(0); /* bits 63-32 */
495 chip
->dma_risc
= dma
;
497 substream
->runtime
->dma_area
= chip
->dma_risc
->vaddr
;
498 substream
->runtime
->dma_bytes
= chip
->dma_size
;
499 substream
->runtime
->dma_addr
= 0;
511 static int snd_cx25821_hw_free(struct snd_pcm_substream
*substream
)
513 struct cx25821_audio_dev
*chip
= snd_pcm_substream_chip(substream
);
515 if (substream
->runtime
->dma_area
) {
516 dsp_buffer_free(chip
);
517 substream
->runtime
->dma_area
= NULL
;
526 static int snd_cx25821_prepare(struct snd_pcm_substream
*substream
)
534 static int snd_cx25821_card_trigger(struct snd_pcm_substream
*substream
,
537 struct cx25821_audio_dev
*chip
= snd_pcm_substream_chip(substream
);
540 /* Local interrupts are already disabled by ALSA */
541 spin_lock(&chip
->reg_lock
);
544 case SNDRV_PCM_TRIGGER_START
:
545 err
= _cx25821_start_audio_dma(chip
);
547 case SNDRV_PCM_TRIGGER_STOP
:
548 err
= _cx25821_stop_audio_dma(chip
);
555 spin_unlock(&chip
->reg_lock
);
563 static snd_pcm_uframes_t
snd_cx25821_pointer(struct snd_pcm_substream
566 struct cx25821_audio_dev
*chip
= snd_pcm_substream_chip(substream
);
567 struct snd_pcm_runtime
*runtime
= substream
->runtime
;
570 count
= atomic_read(&chip
->count
);
572 return runtime
->period_size
* (count
& (runtime
->periods
- 1));
576 * page callback (needed for mmap)
578 static struct page
*snd_cx25821_page(struct snd_pcm_substream
*substream
,
579 unsigned long offset
)
581 void *pageptr
= substream
->runtime
->dma_area
+ offset
;
583 return vmalloc_to_page(pageptr
);
589 static struct snd_pcm_ops snd_cx25821_pcm_ops
= {
590 .open
= snd_cx25821_pcm_open
,
591 .close
= snd_cx25821_close
,
592 .ioctl
= snd_pcm_lib_ioctl
,
593 .hw_params
= snd_cx25821_hw_params
,
594 .hw_free
= snd_cx25821_hw_free
,
595 .prepare
= snd_cx25821_prepare
,
596 .trigger
= snd_cx25821_card_trigger
,
597 .pointer
= snd_cx25821_pointer
,
598 .page
= snd_cx25821_page
,
602 * ALSA create a PCM device: Called when initializing the board.
603 * Sets up the name and hooks up the callbacks
605 static int snd_cx25821_pcm(struct cx25821_audio_dev
*chip
, int device
,
611 err
= snd_pcm_new(chip
->card
, name
, device
, 0, 1, &pcm
);
613 pr_info("ERROR: FAILED snd_pcm_new() in %s\n", __func__
);
616 pcm
->private_data
= chip
;
618 strcpy(pcm
->name
, name
);
619 snd_pcm_set_ops(pcm
, SNDRV_PCM_STREAM_CAPTURE
, &snd_cx25821_pcm_ops
);
624 /****************************************************************************
625 Basic Flow for Sound Devices
626 ****************************************************************************/
629 * PCI ID Table - 14f1:8801 and 14f1:8811 means function 1: Audio
630 * Only boards with eeprom and byte 1 at eeprom=1 have it
633 static DEFINE_PCI_DEVICE_TABLE(cx25821_audio_pci_tbl
) = {
634 {0x14f1, 0x0920, PCI_ANY_ID
, PCI_ANY_ID
, 0, 0, 0},
638 MODULE_DEVICE_TABLE(pci
, cx25821_audio_pci_tbl
);
641 * Not used in the function snd_cx25821_dev_free so removing
645 static int snd_cx25821_free(struct cx25821_audio_dev *chip)
648 free_irq(chip->irq, chip);
650 cx25821_dev_unregister(chip->dev);
651 pci_disable_device(chip->pci);
658 * Component Destructor
660 static void snd_cx25821_dev_free(struct snd_card
*card
)
662 struct cx25821_audio_dev
*chip
= card
->private_data
;
664 /* snd_cx25821_free(chip); */
665 snd_card_free(chip
->card
);
669 * Alsa Constructor - Component probe
671 static int cx25821_audio_initdev(struct cx25821_dev
*dev
)
673 struct snd_card
*card
;
674 struct cx25821_audio_dev
*chip
;
677 if (devno
>= SNDRV_CARDS
) {
678 pr_info("DEBUG ERROR: devno >= SNDRV_CARDS %s\n", __func__
);
682 if (!enable
[devno
]) {
684 pr_info("DEBUG ERROR: !enable[devno] %s\n", __func__
);
688 err
= snd_card_create(index
[devno
], id
[devno
], THIS_MODULE
,
689 sizeof(struct cx25821_audio_dev
), &card
);
691 pr_info("DEBUG ERROR: cannot create snd_card_new in %s\n",
696 strcpy(card
->driver
, "cx25821");
698 /* Card "creation" */
699 card
->private_free
= snd_cx25821_dev_free
;
700 chip
= card
->private_data
;
701 spin_lock_init(&chip
->reg_lock
);
705 chip
->pci
= dev
->pci
;
706 chip
->iobase
= pci_resource_start(dev
->pci
, 0);
708 chip
->irq
= dev
->pci
->irq
;
710 err
= request_irq(dev
->pci
->irq
, cx25821_irq
,
711 IRQF_SHARED
, chip
->dev
->name
, chip
);
714 pr_err("ERROR %s: can't get IRQ %d for ALSA\n",
715 chip
->dev
->name
, dev
->pci
->irq
);
719 err
= snd_cx25821_pcm(chip
, 0, "cx25821 Digital");
721 pr_info("DEBUG ERROR: cannot create snd_cx25821_pcm %s\n",
726 snd_card_set_dev(card
, &chip
->pci
->dev
);
728 strcpy(card
->shortname
, "cx25821");
729 sprintf(card
->longname
, "%s at 0x%lx irq %d", chip
->dev
->name
,
730 chip
->iobase
, chip
->irq
);
731 strcpy(card
->mixername
, "CX25821");
733 pr_info("%s/%i: ALSA support for cx25821 boards\n",
734 card
->driver
, devno
);
736 err
= snd_card_register(card
);
738 pr_info("DEBUG ERROR: cannot register sound card %s\n",
743 snd_cx25821_cards
[devno
] = card
;
753 /****************************************************************************
755 ****************************************************************************/
756 static void cx25821_audio_fini(void)
758 snd_card_free(snd_cx25821_cards
[0]);
764 * Loops through present saa7134 cards, and assigns an ALSA device
768 static int cx25821_alsa_init(void)
770 struct cx25821_dev
*dev
= NULL
;
771 struct list_head
*list
;
773 mutex_lock(&cx25821_devlist_mutex
);
774 list_for_each(list
, &cx25821_devlist
) {
775 dev
= list_entry(list
, struct cx25821_dev
, devlist
);
776 cx25821_audio_initdev(dev
);
778 mutex_unlock(&cx25821_devlist_mutex
);
781 pr_info("ERROR ALSA: no cx25821 cards found\n");
787 late_initcall(cx25821_alsa_init
);
788 module_exit(cx25821_audio_fini
);
790 /* ----------------------------------------------------------- */