sound/soc/atmel/atmel-pcm.h

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