1 /* 2 * at91-pcm.h - ALSA PCM interface for the Atmel AT91 SoC. 3 * 4 * Copyright (C) 2005 SAN People 5 * Copyright (C) 2008 Atmel 6 * 7 * Authors: Sedji Gaouaou <sedji.gaouaou@atmel.com> 8 * 9 * Based on at91-pcm. by: 10 * Frank Mandarino <fmandarino@endrelia.com> 11 * Copyright 2006 Endrelia Technologies Inc. 12 * 13 * Based on pxa2xx-pcm.c by: 14 * 15 * Author: Nicolas Pitre 16 * Created: Nov 30, 2004 17 * Copyright: (C) 2004 MontaVista Software, Inc. 18 * 19 * This program is free software; you can redistribute it and/or modify 20 * it under the terms of the GNU General Public License as published by 21 * the Free Software Foundation; either version 2 of the License, or 22 * (at your option) any later version. 23 * 24 * This program is distributed in the hope that it will be useful, 25 * but WITHOUT ANY WARRANTY; without even the implied warranty of 26 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 27 * GNU General Public License for more details. 28 * 29 * You should have received a copy of the GNU General Public License 30 * along with this program; if not, write to the Free Software 31 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 32 */ 33 34 #ifndef _ATMEL_PCM_H 35 #define _ATMEL_PCM_H 36 37 #include <linux/atmel-ssc.h> 38 39 #define ATMEL_SSC_DMABUF_SIZE (64 * 1024) 40 41 /* 42 * Registers and status bits that are required by the PCM driver. 43 */ 44 struct atmel_pdc_regs { 45 unsigned int xpr; /* PDC recv/trans pointer */ 46 unsigned int xcr; /* PDC recv/trans counter */ 47 unsigned int xnpr; /* PDC next recv/trans pointer */ 48 unsigned int xncr; /* PDC next recv/trans counter */ 49 unsigned int ptcr; /* PDC transfer control */ 50 }; 51 52 struct atmel_ssc_mask { 53 u32 ssc_enable; /* SSC recv/trans enable */ 54 u32 ssc_disable; /* SSC recv/trans disable */ 55 u32 ssc_error; /* SSC error conditions */ 56 u32 ssc_endx; /* SSC ENDTX or ENDRX */ 57 u32 ssc_endbuf; /* SSC TXBUFE or RXBUFF */ 58 u32 pdc_enable; /* PDC recv/trans enable */ 59 u32 pdc_disable; /* PDC recv/trans disable */ 60 }; 61 62 /* 63 * This structure, shared between the PCM driver and the interface, 64 * contains all information required by the PCM driver to perform the 65 * PDC DMA operation. All fields except dma_intr_handler() are initialized 66 * by the interface. The dma_intr_handler() pointer is set by the PCM 67 * driver and called by the interface SSC interrupt handler if it is 68 * non-NULL. 69 */ 70 struct atmel_pcm_dma_params { 71 char *name; /* stream identifier */ 72 int pdc_xfer_size; /* PDC counter increment in bytes */ 73 struct ssc_device *ssc; /* SSC device for stream */ 74 struct atmel_pdc_regs *pdc; /* PDC receive or transmit registers */ 75 struct atmel_ssc_mask *mask; /* SSC & PDC status bits */ 76 struct snd_pcm_substream *substream; 77 void (*dma_intr_handler)(u32, struct snd_pcm_substream *); 78 }; 79 80 /* 81 * SSC register access (since ssc_writel() / ssc_readl() require literal name) 82 */ 83 #define ssc_readx(base, reg) (__raw_readl((base) + (reg))) 84 #define ssc_writex(base, reg, value) __raw_writel((value), (base) + (reg)) 85 86 int atmel_pcm_new(struct snd_soc_pcm_runtime *rtd); 87 void atmel_pcm_free(struct snd_pcm *pcm); 88 int atmel_pcm_mmap(struct snd_pcm_substream *substream, 89 struct vm_area_struct *vma); 90 91 #if defined(CONFIG_SND_ATMEL_SOC_PDC) || \ 92 defined(CONFIG_SND_ATMEL_SOC_PDC_MODULE) 93 int atmel_pcm_pdc_platform_register(struct device *dev); 94 void atmel_pcm_pdc_platform_unregister(struct device *dev); 95 #else 96 static inline int atmel_pcm_pdc_platform_register(struct device *dev) 97 { 98 return 0; 99 } 100 static inline void atmel_pcm_pdc_platform_unregister(struct device *dev) 101 { 102 } 103 #endif 104 105 #if defined(CONFIG_SND_ATMEL_SOC_DMA) || \ 106 defined(CONFIG_SND_ATMEL_SOC_DMA_MODULE) 107 int atmel_pcm_dma_platform_register(struct device *dev); 108 void atmel_pcm_dma_platform_unregister(struct device *dev); 109 #else 110 static inline int atmel_pcm_dma_platform_register(struct device *dev) 111 { 112 return 0; 113 } 114 static inline void atmel_pcm_dma_platform_unregister(struct device *dev) 115 { 116 } 117 #endif 118 119 #endif /* _ATMEL_PCM_H */ 120