分类： LINUX
2008-06-20 14:00:05
PCM信息运行时指针
当打开一个一个PCM子流的时候，PCM运行时实例就会分配给这个子流。这个指针可以通过substream->runtime获得。运行时指针拥有多种信息：hw_params和sw_params的配置的拷贝，缓冲区指针，mmap记录，自旋锁等等。几乎你想控制PCM的所有信息都可以在这里得到。
Struct _snd_pcm_runtime {
/*状态*/
struct snd_pcm_substream *trigger_master;
snd_timestamp_t trigger_tstamp;/*触发时间戳*/、
int overrange;
snd_pcm_uframes_t avail_max;
snd_pcm_uframes_t hw_ptr_base /*缓冲区复位时的位置*/
snd_pcm_uframes_t hw_ptr_interrupt;/*中断时的位置*/
/*硬件参数*/
snd_pcm_access_t access; /*存取模式*/
snd_pcm_format_t format; /*SNDRV_PCM_FORMAT_* */
snd_pcm_subformat_t subformat; /*子格式*/
unsigned int rate; /*rate in HZ*/
unsigned int channels; /*通道*/
snd_pcm_uframe_t period_size; /*周期大小*/
unsigned int periods /*周期数*/
snd_pcm_uframes_t buffer_size; /*缓冲区大小*/
unsigned int tick_time; /*tick time滴答时间*/
snd_pcm_uframes_t min_align; /*格式对应的最小对齐*/
size_t byte_align;
unsigned int frame_bits;
unsigned int sample_bits;
unsigned int info;
unsigned int rate_num;
unsigned int rate_den;
/*软件参数*/
struct timespec tstamp_mode; /*mmap时间戳被更新*/
unsigned int sleep_min; /*睡眠的最小节拍数*/
snd_pcm_uframes_t xfer_align; /*xfer的大小需要是成倍数的*/
snd_pcm_uframes_t start_threshold;
snd_pcm_uframes_t stop_threshold;
snd_pcm_uframes_t silence_threshold;/*silence填充阀值*/
snd_pcm_uframes_t silence_size; /*silence填充大小*/
snd_pcm_uframes_t boundary;
snd_pcm_uframes_t silenced_start;
snd_pcm_uframes_t silenced_size;
snd_pcm_sync_id_t sync; /*硬件同步ID*/
/*mmap*/
volatile struct snd_pcm_mmap_status *status;
volatile struct snd_pcm_mmap_control *control;
atomic_t mmap_count;
/*锁/调度*/
spinlock_t lock;
wait_queue_head_t sleep;
struct timer_list tick_timer;
struct fasync_struct *fasync;
/*私有段*/
void *private_data;
void (*private_free)(struct snd_pcm_runtime *runtime);
/*硬件描述*/
struct snd_pcm_hardware hw;
struct snd_pcm_hw_constraints hw_constraints;
/*中断的回调函数*/
void (*transfer_ack_begin)(struct snd_pcm_substream *substream);
void (*transfer_ack_end)(struct snd_pcm_substream *substream);
/*定时器*/
unsigned int timer_resolution; /*timer resolution*/
/*DMA*/
unsigned char *dma_area;
dma_addr_t dma_addr; /*总线物理地址*/
size_t dma_bytes; /*DMA区域大小*/
struct snd_dma_buffer *dma_buffer_p; /*分配的缓冲区*/
#if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
struct snd_pcm_oss_runtime oss;
#endif
};
snd_pcm_runtime 对于大部分的驱动程序操作集的函数来说是只读的。仅仅PCM中间层可以改变/更新这些信息。但是硬件描述，中断响应，DMA缓冲区信息和私有数据是例外的。此外，假如你采用标准的内存分配函数snd_pcm_lib_malloc_pages()，就不再需要自己设定DMA缓冲区信息了。
下面几章，会对上面记录的现实进行解释。
硬件描述
硬件描述（struct snd_pcm_hardware)包含了基本硬件配置的定义。如前面所述，你需要在open的时候对它们进行定义。注意runtime实例拥有这个描述符的拷贝而不是已经存在的描述符的指针。换句话说，在open函数中，你可以根据需要修改描述符的拷贝。例如，假如在一些声卡上最大的通道数是1，你仍然可以使用相同的硬件描述符，同时在后面你可以改变最大通道数。
Struct snd_pcm_runtime *runtime = substream->runtime;
....
runtime->hw = snd_mychip_playback_hw; /*通用定义*/
if (chip->model == VERY_OLD_ONE)
runtime->hw.channels_max = 1;
典型的硬件描述如下：
static struct snd_pcm_hardware snd_mychip_playback_hw = {
.info = (SNDRV_PCM_INFO_MMAP |
SNDRV_PCM_INFO_INTERLEAVED |
SNDRV_PCM_INFO_BLOCK_TRANSFER |
SNDRV_PCM_INFO_MMAP_VALID),
.formats = SNDRV_PCM_FORMAT_S16_LE,
.rates = SNDRV_PCM_RATE_8000_48000，
.rate_min = 8000,
.rate_max = 48000,
.channels_min = 2,
.channels_max = 2,
.buffer_bytes_max = 32768,
.period_bytes_min = 4096,
.period_bytes_max = 32768,
.periods_min = 1,
.periods_max = 1024,
};
info字段包含pcm的类型和能力。位标志在
如上面的例子，MMAP_VALID和BLOCK_TRANSFER都是针对OSS mmap模式，通常情况它们都要设定。当然，MMAP_VALID仅仅当mmap真正被支持的时候才会被设定。
其他一些标志位是SNDRV_PCM_INFO_PAUSE和SNDRV_PCM_INFO_RESUME。SNDRV_PCM_INFO_PAUSE标志位意思是pcm支持“暂停”操作，SNDRV_PCM_INFO_RESUME表示是pcm支持“挂起/恢复”操作。假如PAUSE标志位被设定，trigger函数就必须执行一个对应的（暂停 按下/释放）命令。就算没有RESUME标志位，也可以被定义挂起/恢复触发命令。
更详细的部分请参考“电源管理”一章。
当PCM子系统能被同步（如：播放流和录音流的开始/结束的同步）的时候，你可以设定SNDRV_PCM_INFO_SYNC_START标志位。在这种情况下，你必须在trigger函数中检查PCM子流链。下面的章节会想笑介绍这个部分。
formats字段包含了支持格式的标志位(SNDRV_PCM_FMTBIT_XXX)。假如硬件支持超过一个的格式，需要对位标志位进行“或”运算。上面的例子就是支持16bit有符号的小端格式。
rates字段包含了支持的采样率（SNDRV_PCM_RATE_XXX)。当声卡支持多种采样率的时候，应该附加一个CONTINUOUS标志。已经预先定义的典型的采样率，假如你的声卡支持不常用的采样率，你需要加入一个KNOT标志，同时手动的对硬件进行控制（稍后解释）。
rate_min和rate_max定义了最小和最大的采样率。应该和采样率相对应。
channel_min和channel_max定义了最大和最小的通道，以前可能你已看到。
buffer_bytes_max定义了以字节为单位的最大的缓冲区大小。这里没有buffer_bytes_min字段，因为它可以通过最小的period大小和最小的period数量计算得出。同时，period_bytes_min和定义的最小和最大的period。periods_max和periods_min定义了最大和最小的periods。
period信息和OSS中的fragment相对应。period定义了PCM中断产生的周期。这个周期非常依赖硬件。一般来说，一个更短的周期会提供更多的中断和更多的控制。如在录音中，周期大小定义了输入延迟，另外，整个缓存区大小也定义了播放的输出延迟。
字段fifo_size。这个主要是和硬件的FIFO大小有关，但是目前驱动中或alsa-lib中都没有使用。所以你可以忽略这个字段。
PCM配置
OK,让我们再次回到PCM运行时记录。最经常涉及的运行时实例中的记录就是PCM配置了。PCM可以让应用程序通过alsa-lib发送hw_params来配置。有很多字段都是从hw_params和sw_params结构中拷贝过来的。例如：format保持了应用程序选择的格式类型，这个字段包含了enum值SNDRV_PCM_FORMAT_XXX。
其中要注意的一个就是，配置的buffer和period大小被放在运行时记录的“frame”中。在ALSA里，1frame=channel*samples-size。为了在帧和字节之间转换，你可以用下面的函数，frames_to_bytes()和bytes_to_frames()。
period_bytes = frames_to_bytes(runtime,runtime->period_size);
同样，许多的软件参数(sw_params)也存放在frames字段里面。请检查这个字段的类型。snd_pcm_uframes_t是作为表示frames的无符号整数，而snd_pcm_sframes_t是作为表示frames的有符号整数。
DMA缓冲区信息
DMA缓冲区通过下面4个字段定义，dma_area,dma_addr,dma_bytes,dma_private。其中dma_area是缓冲区的指针（逻辑地址）。可以通过memcopy来向这个指针来操作数据。dma_addr是缓冲区的物理地址。这个字段仅仅当缓冲区是线性缓存的时候才要特别说明。dma_bytes是缓冲区的 大小。dma_private是被ALSA的DMA管理用到的。
如果采用ALSA的标准内存分配函数snd_pcm_lib_mallock_pages()分配内存，那些字段会被ALSA的中间层设定，你不能自己改变他们，可以读取而不能写入。而如果你想自己分配内存，你就需要在hw_params回调里面自己管理它们。当内存被mmap之后，你至少要设定dma_bytes和dma_area。但是如果你的驱动不支持mmap，这些字段就不必一定设定.dma_addr也不是强制的，你也可以根据灵活来用dma_private。
运行状态
可以通过runtime->status来获得运行状态。它是一个指向snd_pcm_mmap_status记录的指针。例如，可以通过runtime->status->hw_ptr来得到当前DMA硬件指针。
可以通过runtime->control来查看DMA程序的指针，它是指向snd_pcm_mmap_control记录。但是，不推荐直接存取这些数据。
私有数据
可以为子流分配一个记录，让它保存在runtime->private_data里面。通常可以在open函数中做。不要和pcm->private_data混搅了，pcm->private_data主要是在创建PCM的时候指向chip实例，而runtime->private_data是在PCM open的时候指向一个动态数据。
Struct int snd_xxx_open(struct snd_pcm_substream *substream)
{
struct my_pcm_data *data;
data = kmalloc(sizeof(*data),GFP_KERNEL);
substream->runtime->private_data = data;
....
}
上述分配的对象要在close函数中释放。
中断函数
transfer_ack_begin()和transfer_ack_end()将会在snd_pcm_period_elapsed()的开始和结束。
操作函数
现在让我来详细介绍每个pcm的操作函数吧（ops）。通常每个回调函数成功的话返回0，出错的话返回一个带错误码的负值，如：-EINVAL。
每个函数至少要有一个snd_pcm_substream指针变量。主要是为了从给定的子流实例中得到chip记录，你可以采用下面的宏。
Int xxx(){
struct mychip *chip = snd_pcm_substream_chip(substream);
....
}
open函数
static int snd_xxx_open(struct snd_pcm_substream *substream);
当打开一个pcm子流的时候调用。
在这里，你至少要初始化runtime->hw记录。典型应用如下：
static int snd_xxx_open(struct snd_pcm_substream *substream)
{
struct mychip *chip = snd_pcm_substream_chip(substream);
struct snd_pcm_runtime *runtime = substream->runtime;
runtime->hw = snd_mychip_playback_hw;
return 0;
}
其中snd_mychip_playback_hw是预先定义的硬件描述。
close函数
static int snd_xxx_close(struct snd_pcm_substream *substream)
显然这是在pcm子流被关闭的时候调用。
所有在open的时候被分配的pcm子流的私有的实例都应该在这里被释放。
Static int snd_xxx_close(struct snd_pcm_substream *substream)
{
...
kfree(substream->runtime->private_data);
...
}
ioctl函数
这个函数主要是完成一些pcm ioctl的特殊功能。但是通常你可以采用通用的ioctl函数snd_pcm_lib_ioctl。
hw_params函数
static int snd_xxx_hw_params(struct snd_pcm_substream *substream,
struct snd_pcm_substream *hw_params);
这个函数和hw_free函数仅仅在ALSA0.9.X版本出现。
当pcm子流中已经定义了缓冲区大小，period大小，格式等的时候，应用程序可以通过这个函数来设定硬件参数。
很多的硬件设定都要在这里完成，包括分配内存。
设定的参数可以通过params_xxx()宏得到。对于分配内存，可以采用下面一个有用的函数，
snd_pcm_lib_malloc_pages(substream,params_buffer_bytes(hw_params));
snd_pcm_lib_malloc_pages()仅仅当DMA缓冲区已经被预分配之后才可以用。参考“缓存区类型”一章获得更详细的细节。
注意这个和prepare函数会在初始化当中多次被调用。例如，OSSemulation可能在每次通过ioctl改变的时候都要调用这些函数。
因而，千万不要对一个相同的内存分配多次，可能会导致内存的漏洞！而上面的几个函数是可以被多次调用的，如果它已经被分配了，它会先自动释放之前的内存。
另外一个需要注意的是，这些函数都不是原子的（可以被调到）。这个是非常重要的，因为trigger函数是原子的（不可被调度）。因此，mutex和其他一些和调度相关的功能函数在trigger里面都不需要了。具体参看“原子操作”一节。
hw_free函数
static int snd_xxx_hw_free(struct snd_pcm_substream *substream);
这个函数可以是否通过hw_params分配的资源。例如：通过如下函数释放那些通过snd_pcm_lib_malloc_pages()申请的缓存。
snd_pcm_lib_free_pages(substream)
这个函数要在close调用之前被调用。同时，它也可以被多次调用。它也会知道资源是否已经被分配。
Prepare函数
static int snd_xxx_prepare(struct snd_pcm_substream *substream);
当pcm“准备好了”的时候调用这个函数。可以在这里设定格式类型，采样率等等。和hw_params不同的是，每次调用snd_pcm_prepare()的时候都要调用prepare函数。
注意最近的版本prepare变成了非原子操作的了。这个函数中，你要做一些调度安全性策略。
在下面的函数中，你会涉及到runtime记录的值(substream->runtime)。例如：得到当前的采样率，格式或声道，可以分别存取runtime->rate，runtime->format,runtime->channels。分配的内存的地址放到runtime->dma_area中，内存和period大小分别保存在runtime->buffer_size和runtime->period_size中。
要注意在每次设定的时候都有可能多次调用这些函数。
trigger函数
static int snd_xxx_trigger(struct snd_pcm_substream *substream, int cmd);
当pcm开始，停止或暂停的时候都会调用这个函数。
具体执行那个操作主要是根据第二个参数，在
switch(cmd){
case SNDRV_PCM_TRIGGER_START:
//启动PCM引擎
break;
case SNDRV_PCM_TRIGGER_STOP:
//停止PCM引擎
break;
default:
break;
}
当pcm支持暂停操作（在hareware表里面有这个），也必须处理PAUSE_PAUSE和PAUSE_RELEASE命令。前者是暂停命令，后者是重新播放命令。
假如pcm支持挂起/恢复操作，不管是全部或部分的挂起/恢复支持，都要处理SUSPEND和RESUME命令。这些命令主要是在电源状态改变的时候需要，通常它们和STOP，START命令放到一起。具体参看“电源管理”一章。
如前面提到的，这个操作上原子的。不要在调用这些函数的时候进入睡眠。而trigger函数要尽量小，甚至仅仅触发DMA。另外的工作如初始化hw_params和prepare应该在之前做好。
pointer函数
static snd_pcm_uframes_t snd_xxx_pointer(struct snd_pcm_substream *substream);
PCM中间层通过调用这个函数来获得缓冲区中的硬件位置。返回值需要以为frames为单位（在ALSA0.5.X是以字节为单位的），范围从0到buffer_size-1。
一般情况下，在中断程序中，调用snd_pcm_period_elapsed()的时候，在pcm中间层在在更新buffer的程序中调用它。然后，pcm中间层会更新指针位置和计算可用的空间，然后唤醒那些等待的线程。
这个函数也是原子的。
Copy和silence函数
这些函数不是必须的，同时在大部分的情况下是被忽略的。这些函数主要应用在硬件内存不在正常的内存空间的时候。一些声卡有一些没有被影射的自己的内存。在这种情况下，你必须把内存传到硬件的内存空间去。或者，缓冲区在物理内存和虚拟内存中都是不连续的时候就需要它们了。
假如定义了copy和silence，就可以做copy和set-silence的操作了。更详细的描述请参考“缓冲区和内存管理”一章。
Ack函数
这个函数也不是必须的。当在读写操作的时候更新appl_ptr的时候会调用它。一些类似于emu10k1-fx和cs46xx的驱动程序会为了内部缓存来跟踪当前的appl_ptr，这个函数仅仅对于这个情况才会被用到。
这个函数也是原子的。
page函数
这个函数也不是必须的。这个函数主要对那些不连续的缓存区 。mmap会调用这个函数得到内存页的地址。后续章节“缓冲区和内存管理”会有一些例子介绍。
中断处理
下面的pcm工作就是PCM中断处理了。声卡驱动中的PCM中断处理的作用主要是更新缓存的位置，然后在缓冲位置超过预先定义的period大小的时候通知PCM中间层。可以通过调用snd_pcm_period_elapsed()来通知。
声卡有如下几种产生中断。
period（周期）中断
这是一个很常见的类型：硬件会产生周期中断。每次中断都会调用snd_pcm_period_elapsed()。
snd_pcm_period_elapsed()的参数是substream的指针。因为，需要从chip实例中得到substream的指针。例如：在chip记录中定义一个substream字段来保持当前运行的substream指针，在open函数中要设定这个字段而在close函数中要复位这个字段。
假如在中断处理函数中获得了一个自旋锁，如果其他pcm也会调用这个锁，那你必须要在调用snd_pcm_period_elapsed()之前释放这个锁。
典型代码如下：
Example5-3.中断函数处理#1
struct irqreturn_t snd_mychip_interrupt(int irq, void *dev_id)
{
struct mychip *chip = dev_id;
spin_lock(&chip->lock);
....
if (pcm_irq_invoked(chip)){
spin_unlock(&chip->lock);
snd_pcm_period_elapsed(chip->substream);
spin_lock(&chip->lock);
//如果需要的话，可以响应中断
}
....
spin_unlock(&chip->lock);
return IRQ_HANDLED;
}
高频率时钟中断
当硬件不再产生一个period（周期）中断的时候，就需要一个固定周期的timer中断了（例如 es1968，ymfpci驱动）。这时候，在每次中断都要检查当前硬件位置，同时计算已经累积的采样的长度。当长度超过period长度时候，需要调用 snd_pcm_period_elapsed()同时复位计数值。
典型代码如下：
Example5-4.中断函数处理#2
static irqreturn_t snd_mychip_interrupt(int irq, void *dev_id)
{
struct mychip *chip = dev_id;
spin_lock(&chip->lock);
....
if (pcm_irq_invoked(chip)){
unsigned int last_ptr, size;
/*得到当前的硬件指针（帧为单位）*/
last_ptr = get_hw_ptr(chip);
/*计算自从上次更新之后又处理的帧*/
if (last_ptr < chip->last_ptr)
{
size = runtime->buffer_size + last_ptr - chip->last_ptr
}else
{
size = last_ptr – chip->chip->last_ptr;
}
//保持上次更新的位置
chip->last_ptr = last_ptr;
/*累加size计数器*/
chip->size += size;
/*超过period的边界？*/
if (chip->size >= runtime->period_size){
/*重置size计数器*/
chip->size %= runtime->period_size;
spin_unlock(&chip->lock);
snd_pcm_period_elapsed(substream);
spin_lock(&chip->lock);
}
//需要的话，要相应中断
}
....
spin_unlock(&chip->lock);
return IRQ_HANDLED;
}
在调用snd_pcm_period_elapsed()的时候
就算超过一个period的时间已经过去，你也不需要多次调用snd_pcm_period_elapsed()，因为pcm层会自己检查当前的硬件指针和上次和更新的状态。
原子操作
在内核编程的时候，一个非常重要（又很难dubug）的问题就是竞争条件。Linux内核中，一般是通过自旋锁和信号量来解决的。通常来说，假如竞争发生在中断函数中，中断函数要具有原子性，你必须采用自旋锁来包含临界资源。假如不是发生在中断部分，同时比较耗时，可以采用信号量。
如我们看到的，pcm的操作函数一些是原子的而一些不是。例如：hw_params函数不是原子的，而trigger函数是原子的。这意味着，后者调用的时候，PCM中间层已经拥有了锁。
在这些函数中申请的自旋锁和信号量要做个计算。
在这些原子的函数中，不能那些可能调用任务切换和进入睡眠的函数。其中信号量和互斥体可能会进入睡眠，因此，在原子操作的函数中（如：trigger函数）不能调用它们。如果在这种函数中调用delay，可以用udelay(),或mdelay()。
约束
假如你的声卡支持不常用的采样率，或仅仅支持固定的采样率，就需要设定一个约束条件。
例如：为了把采样率限制在一些支持的几种之中，就需要用到函数snd_pcm_hw_constraint_list()。需要在open函数中调用它。
Example5-5.硬件约束示例
static unsigned int rates[] =
{4000,10000,22050,44100};
static unsigned snd_pcm_hw_constraint_list constraints_rates = {
.count = ARRAY_SIZE(rates),
.list = rates,
.mask = 0,
};
static int snd_mychip_pcm_open(struct snd_pcm_substream *substream)
{
int err;
....
err = snd_pcm_hw_constraint_list(substream->runtime,0,
SNDRV_PCM_HW_PARAM_RATE,
&constraints_rates);
if (err < 0)
return err;
....
}
有多种不同的约束。请参考sound/pcm.h中的完整的列表。甚至可以定义自己的约束条件。例如，假如my_chip可以管理一个单通道的子流，格式是S16_LE,另外，它还支持snd_pcm_hareware中设定的格式（或其他constraint_list）。可以设定一个：
Example5-6.为通道设定一个硬件规则
static int hw_rule_format_by_channels(struct snd_pcm_hw_params *params,
struct snd_pcm_hw_rule *rule)
{
struct snd_interval *c = hw_params_interval(params,
SNDRV_PCM_HW_PARAM_CHANNELS);
struct snd_mask *f = hw_param_mask(params,SNDRV_PCM_HW_PARAM_FORMAT);
struct snd_mask fmt;
snd_mask_any(&fmt); /*初始化结构体*/
if (c->min < 2){
fmt.bits[0] &= SNDRV_PCM_FMTBIT_S16_LE;
return snd_mask_refine(f, &fmt);
}
return 0;
}
之后，需要把上述函数加入到你的规则当中去：
snd_pcm_hw_rule_add(substream->runtime, 0, SNDRV_PCM_HW_PARAM_CHANNELS,
hw_rule_channels_by_format,0, SNDRV_PCM_HW_PARAM_FORMAT,
-1);
当应用程序设定声道数量的时候会调用上面的规则函数。但是应用程序可以在设定声道数之前设定格式。所以也需要设定对应的规则。
Example5-7.为通道设定一个硬件规则
static int hw_rule_format_by_format(struct snd_pcm_hw_params *params,
struct snd_pcm_hw_rule *rule)
{
struct snd_interval *c = hw_param_interval(params,
SNDRV_PCM_HW_PARAM_CHANNELS);
struct snd_mask *f = hw_param_mask(params, SNDRV_PCM_HW_PARAM_FORMAT);
struct snd_interval ch;
snd_interval_any(&ch);
if (f->bits[0] == SNDRV_PCM_FORMAT_S16_LE){
ch.min = ch.max = 1;
ch.integer = 1;
return snd_interval_refine(c, &ch);
}
return 0;
}
在open函数中：
snd_pcm_hw_rule_add(substream->runtime, 0, SNDRV_PCM_HW_PARAM_FORMAT,
hw_rule_channels_by_format,0, SNDRV_PCM_HW_PARAM_CHANNELS,
-1);
这里我们不会更详细的描述，我仍然想说“直接看源码吧”。
