#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include "s3c24xx-pcm.h"
#define S3C24XX_PCM_DEBUG 0
#if S3C24XX_PCM_DEBUG
#define DBG(x...) printk(KERN_DEBUG "s3c24xx-pcm: " x)
#else
#define DBG(x...)
#endif
//定義了一些緩沖區(qū)信息，在函數s3c24xx_pcm_open中用于初始化結構體substream->runtime->hw
static const struct snd_pcm_hardware s3c24xx_pcm_hardware = {
.info= SNDRV_PCM_INFO_INTERLEAVED |
SNDRV_PCM_INFO_BLOCK_TRANSFER |
SNDRV_PCM_INFO_MMAP |
SNDRV_PCM_INFO_MMAP_VALID |
SNDRV_PCM_INFO_PAUSE |
SNDRV_PCM_INFO_RESUME,
.formats= SNDRV_PCM_FMTBIT_S16_LE |
SNDRV_PCM_FMTBIT_U16_LE |
SNDRV_PCM_FMTBIT_U8 |
SNDRV_PCM_FMTBIT_S8,
.channels_min= 2,
.channels_max= 2,
.buffer_bytes_max= 128*1024,
.period_bytes_min= PAGE_SIZE,
.period_bytes_max= PAGE_SIZE*2,
.periods_min= 2,
.periods_max= 128,
.fifo_size= 32,
};
//緩存管理結構體在函數s3c24xx_pcm_open中掛到runtime->private_data上
//該結構體在函數s3c24xx_pcm_hw_params中被初始化
//所管理的緩存區(qū)域的分配在函數s3c24xx_pcm_preallocate_dma_buffer中
struct s3c24xx_runtime_data {
spinlock_t lock;
int state;
unsigned int dma_loaded;//已插入DMA備用存儲鏈的存儲段數
unsigned int dma_limit;//緩存段的最大數字
unsigned int dma_period;//每段緩存的最大存儲數據量
dma_addr_t dma_start;//緩存區(qū)的開始地址
dma_addr_t dma_pos;//第一個未被插入DMA備用緩存鏈的存儲段地址
dma_addr_t dma_end;//緩存區(qū)的尾地址
//結構params在函數s3c24xx_pcm_hw_params中被初始化prtd->params = dma;
struct s3c24xx_pcm_dma_params *params;
};
/* s3c24xx_pcm_enqueue
*
* place a dma buffer onto the queue for the dma system
* to handle.
*/
static void s3c24xx_pcm_enqueue(struct snd_pcm_substream *substream)
{
struct s3c24xx_runtime_data *prtd = substream->runtime->private_data;
dma_addr_t pos = prtd->dma_pos;
int ret;
DBG("Entered %sn", __func__);
while (prtd->dma_loaded < prtd->dma_limit) {
unsigned long len = prtd->dma_period;
DBG("dma_loaded: %dn", prtd->dma_loaded);
if ((pos + len) > prtd->dma_end) {
len = prtd->dma_end - pos;
DBG(KERN_DEBUG "%s: corrected dma len %ldn",
__func__, len);
}
//將緩存插入DMA備用緩存鏈，pos必須是物理地址，它將被寫入DMA的初始化目的或源寄存器
ret = s3c2410_dma_enqueue(prtd->params->channel,
substream, pos, len);
if (ret == 0) {
prtd->dma_loaded++;
pos += prtd->dma_period;
if (pos >= prtd->dma_end)
pos = prtd->dma_start;
} else
break;
}
prtd->dma_pos = pos;
}
//當一段緩存用完時該函數將在中斷處理函數中被調用
static void s3c24xx_audio_buffdone(struct s3c2410_dma_chan *channel,
void *dev_id, int size,
enum s3c2410_dma_buffresult result)
{
struct snd_pcm_substream *substream = dev_id;
struct s3c24xx_runtime_data *prtd;
DBG("Entered %sn", __func__);
if (result == S3C2410_RES_ABORT || result == S3C2410_RES_ERR)
return;
prtd = substream->runtime->private_data;
if (substream)
snd_pcm_period_elapsed(substream);
spin_lock(&prtd->lock);
if (prtd->state & ST_RUNNING) {
prtd->dma_loaded--;//用完一段緩存，將該緩存插入DMA備用鏈表尾。整個緩存區(qū)為一環(huán)形緩存區(qū)
s3c24xx_pcm_enqueue(substream);
}
spin_unlock(&prtd->lock);
}
static int s3c24xx_pcm_hw_params(struct snd_pcm_substream *substream,
struct snd_pcm_hw_params *params)
{
struct snd_pcm_runtime *runtime = substream->runtime;
struct s3c24xx_runtime_data *prtd = runtime->private_data;
struct snd_soc_pcm_runtime *rtd = substream->private_data;
struct s3c24xx_pcm_dma_params *dma = rtd->dai->cpu_dai->dma_data;
//從結構體params->intervals中獲取緩沖區(qū)大小
unsigned long totbytes = params_buffer_bytes(params);
int ret = 0;
DBG("Entered %sn", __func__);
/* return if this is a bufferless transfer e.g.
* codec <--> BT codec or GSM modem -- lg FIXME */
if (!dma)
return 0;
/* this may get called several times by oss emulation
* with different params -HW */
if (prtd->params == NULL) {
/* prepare DMA */
//結構體dma為s3c24xx_i2s_pcm_stereo_out或s3c24xx_i2s_pcm_stereo_in
//在文件s3c24xx-i2s.c中定義
//結構體params為s3c24xx_runtime_data
prtd->params = dma;
DBG("params %p, client %p, channel %dn", prtd->params,
prtd->params->client, prtd->params->channel);
//申請一DMA通道
ret = s3c2410_dma_request(prtd->params->channel,
prtd->params->client, NULL);
if (ret < 0) {
DBG(KERN_ERR "failed to get dma channeln");
return ret;
}
}
//該函數主要實現(xiàn)chan->callback_fn = rtn;即讓chan->callback_fn指向函數s3c24xx_audio_buffdone
s3c2410_dma_set_buffdone_fn(prtd->params->channel,
s3c24xx_audio_buffdone);
//用已分配的緩存區(qū)substream->dma_buffer區(qū)初始化substream->runtime的一些變量
snd_pcm_set_runtime_buffer(substream, &substream->dma_buffer);
runtime->dma_bytes = totbytes;
spin_lock_irq(&prtd->lock);
prtd->dma_loaded = 0;
prtd->dma_limit = runtime->hw.periods_min;
prtd->dma_period = params_period_bytes(params);//獲取一段緩存的大小
prtd->dma_start = runtime->dma_addr;
prtd->dma_pos = prtd->dma_start;
prtd->dma_end = prtd->dma_start + totbytes;
spin_unlock_irq(&prtd->lock);
return 0;
}
static int s3c24xx_pcm_hw_free(struct snd_pcm_substream *substream)
{
struct s3c24xx_runtime_data *prtd = substream->runtime->private_data;
DBG("Entered %sn", __func__);
/* TODO - do we need to ensure DMA flushed */
snd_pcm_set_runtime_buffer(substream, NULL);
if (prtd->params) {
s3c2410_dma_free(prtd->params->channel, prtd->params->client);
prtd->params = NULL;
}
return 0;
}
static int s3c24xx_pcm_prepare(struct snd_pcm_substream *substream)
{
struct s3c24xx_runtime_data *prtd = substream->runtime->private_data;
int ret = 0;
DBG("Entered %sn", __func__);
/* return if this is a bufferless transfer e.g.
* codec <--> BT codec or GSM modem -- lg FIXME */
if (!prtd->params)
return 0;
/* channel needs configuring for mem=>device, increment memory addr,
* sync to pclk, half-word transfers to the IIS-FIFO. */
if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK) {//如果為放音
s3c2410_dma_devconfig(prtd->params->channel,//配置初始化目的寄存器和相應控制寄存器
S3C2410_DMASRC_MEM, S3C2410_DISRCC_INC |
S3C2410_DISRCC_APB, prtd->params->dma_addr);
s3c2410_dma_config(prtd->params->channel,
prtd->params->dma_size,//配置DMA控制寄存器，將配置值存于chan->dcon = dcon;
S3C2410_DCON_SYNC_PCLK |
S3C2410_DCON_HANDSHAKE);
} else {//錄音，
s3c2410_dma_config(prtd->params->channel,
prtd->params->dma_size,//配置初始化源寄存器和相應控制寄存器
S3C2410_DCON_HANDSHAKE |
S3C2410_DCON_SYNC_PCLK);
s3c2410_dma_devconfig(prtd->params->channel,
S3C2410_DMASRC_HW, 0x3,
prtd->params->dma_addr);
}
/* flush the DMA channel */
s3c2410_dma_ctrl(prtd->params->channel, S3C2410_DMAOP_FLUSH);
prtd->dma_loaded = 0;
prtd->dma_pos = prtd->dma_start;
/* enqueue dma buffers */
s3c24xx_pcm_enqueue(substream);//將緩存鏈插入DMA備用緩存鏈
return ret;
}
static int s3c24xx_pcm_trigger(struct snd_pcm_substream *substream, int cmd)
{
struct s3c24xx_runtime_data *prtd = substream->runtime->private_data;
int ret = 0;
DBG("Entered %sn", __func__);
spin_lock(&prtd->lock);
switch (cmd) {
case SNDRV_PCM_TRIGGER_START:
case SNDRV_PCM_TRIGGER_RESUME:
case SNDRV_PCM_TRIGGER_PAUSE_RELEASE:
prtd->state |= ST_RUNNING;//裝載DMA緩存，開始DMA數據傳輸
s3c2410_dma_ctrl(prtd->params->channel, S3C2410_DMAOP_START);
s3c2410_dma_ctrl(prtd->params->channel, S3C2410_DMAOP_STARTED);
break;
下載文檔
