ALSA(Advanced Linux Sound Architecture)声卡编程介绍
xiliangxiaoke 2011-02-27
http://hi.baidu.com/zmjdx/blog/item/7bd181515330f711367abe9a.html
英文原文：http://www.linuxjournal.com/article/6735
period(周期):硬件中中断间的间隔时间。它表示输入延时。
声卡接口中有一个指针来指示声卡硬件缓存区中当前的读写位置。只要接口在运行，这个指针将循环地指向缓存区中的某个位置。
framesize=sizeof(onesample)*nChannels
alsa中配置的缓存(buffer)和周期(size)大小在runtime中是以帧(frames)形式存储的。
period_bytes=frames_to_bytes(runtime,runtime->period_size);
bytes_to_frames()
Theperiodandbuffersizesarenotdependentonthesampleformatbecausetheyaremeasuredinframes;youdonotneedtochangethem.
ALSA声音编程介绍
ALSA表示高级Linux声音体系结构(AdvancedLinuxSoundArchitecture)。它由一系列内核驱动，应用程序编译接口(API)以及支持Linux下声音的实用程序组成。这篇文章里，我将简单介绍ALSA项目的基本框架以及它的软件组成。主要集中介绍PCM接口编程，包括您可以自动实践的程序示例。
您使用ALSA的原因可能就是因为它很新，但它并不是唯一可用的声音API。如果您想完成低级的声音操作，以便能够最大化地控制声音并最大化地提高性能，或者如果您使用其它声音API没有的特性，那么ALSA是很好的选择。如果您已经写了一个音频程序，你可能想要为ALSA声卡驱动添加本地支持。如果您对音频不感兴趣，只是想播放音频文件，那么高级的API将是更好的选择，比如SDL,OpenAL以及那些桌面环境提供的工具集。另外，您只能在有ALSA支持的Linux环境中使用ALSA。
ALSA历史
ALSA项目发起的起因是Linux下的声卡驱动(OSS/Freedrivers)没有得到积极的维护。并且落后于新的声卡技术。JaroslavKysela早先写了一个声卡驱动，并由此开始了ALSA项目，随便，更多的开发者加入到开发队伍中，更多的声卡得到支持，API的结构也得到了重组。
Linux内核2.5在开发过程中，ALSA被合并到了官方的源码树中。在发布内核2.6后，ALSA已经内建在稳定的内核版本中并将广泛地使用。
数字音频基础
声音由变化的气压组成。它被麦克风这样的转换器转换成电子形式。模/数(ADC)转换器将模拟电压转换成离散的样本值。声音以固定的时间间隔被采样，采样的速率称为采样率。把样本输出到数/模(DAC)转换器，比如扩音器，最后转换成原来的模拟信号。
样本大小以位来表示。样本大小是影响声音被转换成数字信号的精确程度的因素之一。另一个主要的因素是采样率。奈奎斯特(Nyquist)理论中，只要离散系统的奈奎斯特频率高于采样信号的最高频率或带宽，就可以避免混叠现象。
ALSA基础
ALSA由许多声卡的声卡驱动程序组成，同时它也提供一个称为libasound的API库。应用程序开发者应该使用libasound而不是内核中的ALSA接口。因为libasound提供最高级并且编程方便的编程接口。并且提供一个设备逻辑命名功能，这样开发者甚至不需要知道类似设备文件这样的低层接口。相反，OSS/Free驱动是在内核系统调用级上编程，它要求开发者提供设备文件名并且利用ioctrl来实现相应的功能。为了向后兼容，ALSA提供内核模块来模拟OSS，这样之前的许多在OSS基础上开发的应用程序不需要任何改动就可以在ALSA上运行。另外，libaoss库也可以模拟OSS，而它不需要内核模块。
ALSA包含插件功能，使用插件可以扩展新的声卡驱动，包括完全用软件实现的虚拟声卡。ALSA提供一系列基于命令行的工具集，比如混音器(mixer)，音频文件播放器(aplay)，以及控制特定声卡特定属性的工具。
ALSA体系结构
ALSAAPI可以分解成以下几个主要的接口：
1控制接口：提供管理声卡注册和请求可用设备的通用功能
2PCM接口：管理数字音频回放(playback)和录音(capture)的接口。本文后续总结重点放在这个接口上，因为它是开发数字音频程序最常用到的接口。
3RawMIDI接口:支持MIDI(MusicalInstrumentDigitalInterface),标准的电子乐器。这些API提供对声卡上MIDI总线的访问。这个原始接口基于MIDI事件工作，由程序员负责管理协议以及时间处理。
4定时器(Timer)接口：为同步音频事件提供对声卡上时间处理硬件的访问。
5时序器(Sequencer)接口
6混音器(Mixer)接口
设备命名
API库使用逻辑设备名而不是设备文件。设备名字可以是真实的硬件名字也可以是插件名字。硬件名字使用hw:i,j这样的格式。其中i是卡号，j是这块声卡上的设备号。第一个声音设备是hw:0,0.这个别名默认引用第一块声音设备并且在本文示例中一真会被用到。插件使用另外的唯一名字。比如plughw:,表示一个插件，这个插件不提供对硬件设备的访问，而是提供像采样率转换这样的软件特性，硬件本身并不支持这样的特性。
声音缓存和数据传输
每个声卡都有一个硬件缓存区来保存记录下来的样本。当缓存区足够满时，声卡将产生一个中断。内核声卡驱动然后使用直接内存(DMA)访问通道将样本传送到内存中的应用程序缓存区。类似地，对于回放，任何应用程序使用DMA将自己的缓存区数据传送到声卡的硬件缓存区中。
这样硬件缓存区是环缓存。也就是说当数据到达缓存区末尾时将重新回到缓存区的起始位置。ALSA维护一个指针来指向硬件缓存以及应用程序缓存区中数据操作的当前位置。从内核外部看，我们只对应用程序的缓存区感兴趣，所以本文只讨论应用程序缓存区。
应用程序缓存区的大小可以通过ALSA库函数调用来控制。缓存区可以很大，一次传输操作可能会导致不可接受的延迟，我们把它称为延时(latency)。为了解决这个问题，ALSA将缓存区拆分成一系列周期(period)(OSS/Free中叫片断fragments).ALSA以period为单元来传送数据。
一个周期(period)存储一些帧(frames)。每一帧包含时间上一个点所抓取的样本。对于立体声设备，一个帧会包含两个信道上的样本。图1展示了分解过程：一个缓存区分解成周期，然后是帧，然后是样本。图中包含一些假定的数值。图中左右信道信息被交替地存储在一个帧内。这称为交错(interleaved)模式。在非交错模式中，一个信道的所有样本数据存储在另外一个信道的数据之后。
OverandUnderRun
当一个声卡活动时，数据总是连续地在硬件缓存区和应用程序缓存区间传输。但是也有例外。在录音例子中，如果应用程序读取数据不够快，循环缓存区将会被新的数据覆盖。这种数据的丢失被称为overrun.在回放例子中，如果应用程序写入数据到缓存区中的速度不够快，缓存区将会"饿死"。这样的错误被称为"underrun"。在ALSA文档中，有时将这两种情形统称为"XRUN"。适当地设计应用程序可以最小化XRUN并且可以从中恢复过来。
一个典型的声音程序
使用PCM的程序通常类似下面的伪代码：
打开回放或录音接口
设置硬件参数(访问模式，数据格式，信道数，采样率，等等)
while有数据要被处理：
读PCM数据(录音)
或写PCM数据(回放)
关闭接口
我们将在下文中看到一些可以工作的代码。我建议您在你的Linux系统上测试运行这些代码。查看输出并尝试修改推荐的代码。和本文相关的所有实例清单可以从FTP中获取：ftp.ssc.com/pub/lj/listings/issue126/6735.tgz。
Listing1.DisplaySomePCMTypesandFormats
#include<alsa/asoundlib.h>
intmain(){
intval;
printf("ALSAlibraryversion:%s\n",
SND_LIB_VERSION_STR);
printf("\nPCMstreamtypes:\n");
for(val=0;val<=SND_PCM_STREAM_LAST;val++)
printf("%s\n",
snd_pcm_stream_name((snd_pcm_stream_t)val));
printf("\nPCMaccesstypes:\n");
for(val=0;val<=SND_PCM_ACCESS_LAST;val++)
printf("%s\n",
snd_pcm_access_name((snd_pcm_access_t)val));
printf("\nPCMformats:\n");
for(val=0;val<=SND_PCM_FORMAT_LAST;val++)
if(snd_pcm_format_name((snd_pcm_format_t)val)
!=NULL)
printf("%s(%s)\n",
snd_pcm_format_name((snd_pcm_format_t)val),
snd_pcm_format_description(
(snd_pcm_format_t)val));
printf("\nPCMsubformats:\n");
for(val=0;val<=SND_PCM_SUBFORMAT_LAST;
val++)
printf("%s(%s)\n",
snd_pcm_subformat_name((
snd_pcm_subformat_t)val),
snd_pcm_subformat_description((
snd_pcm_subformat_t)val));
printf("\nPCMstates:\n");
for(val=0;val<=SND_PCM_STATE_LAST;val++)
printf("%s\n",
snd_pcm_state_name((snd_pcm_state_t)val));
return0;
}
清单一显示了一些ALSA使用的PCM数据类型和参数。首先需要做的是包括头文件。这些头文件包含了所有库函数的声明。其中之一就是显示ALSA库的版本。
这个程序剩下的部分的迭代一些PCM数据类型，以流类型开始。ALSA为每次迭代的最后值提供符号常量名，并且提供功能函数以显示某个特定值的描述字符串。你将会看到，ALSA支持许多格式，在我的1.0.15版本里，支持多达36种格式。
这个程序必须链接到alsalib库，通过在编译时需要加上-lasound选项。有些alsa库函数使用dlopen函数以及浮点操作，所以您可能还需要加上-ldl,-lm选项。
下面是该程序的Makefile:
CC=gcc
TARGET=test
SRC=$(wildcard*.c)
OBJECT=${SRC:.c=.o}
INCLUDES=-I/usr/include/alsa
LDFLAGS=-lasound
all:$(TARGET)
$(OBJECT):$(SRC)
$(CC)-c$(INCLUDES)$<
$(TARGET):$(OBJECT)
$(CC)-o$@$<$(LDFLAGS)
.PHONY:clean
clean:
@rm-rf$(OBJECT)$(TARGET)*~
Listing2.OpeningPCMDeviceandSettingParameters
/*
ThisexampleopensthedefaultPCMdevice,sets
someparameters,andthendisplaysthevalue
ofmostofthehardwareparameters.Itdoesnot
performanysoundplaybackorrecording.
*/
/*UsethenewerALSAAPI*/
#defineALSA_PCM_NEW_HW_PARAMS_API
/*AlloftheALSAlibraryAPIisdefined
*inthisheader*/
#include<alsa/asoundlib.h>
intmain(){
intrc;
snd_pcm_t*handle;
snd_pcm_hw_params_t*params;
unsignedintval,val2;
intdir;
snd_pcm_uframes_tframes;
/*OpenPCMdeviceforplayback.*/
rc=snd_pcm_open(&handle,"default",
SND_PCM_STREAM_PLAYBACK,0);
if(rc<0){
fprintf(stderr,
"unabletoopenpcmdevice:%s\n",
snd_strerror(rc));
exit(1);
}
/*Allocateahardwareparametersobject.*/
snd_pcm_hw_params_alloca(¶ms);
/*Fillitinwithdefaultvalues.*/
snd_pcm_hw_params_any(handle,params);
/*Setthedesiredhardwareparameters.*/
/*Interleavedmode*/
snd_pcm_hw_params_set_access(handle,params,
SND_PCM_ACCESS_RW_INTERLEAVED);
/*Signed16-bitlittle-endianformat*/
snd_pcm_hw_params_set_format(handle,params,
SND_PCM_FORMAT_S16_LE);
/*Twochannels(stereo)*/
snd_pcm_hw_params_set_channels(handle,params,2);
/*44100bits/secondsamplingrate(CDquality)*/
val=44100;
snd_pcm_hw_params_set_rate_near(handle,
params,&val,&dir);
/*Writetheparameterstothedriver*/
rc=snd_pcm_hw_params(handle,params);
if(rc<0){
fprintf(stderr,
"unabletosethwparameters:%s\n",
snd_strerror(rc));
exit(1);
}
/*DisplayinformationaboutthePCMinterface*/
printf("PCMhandlename='%s'\n",
snd_pcm_name(handle));
printf("PCMstate=%s\n",
snd_pcm_state_name(snd_pcm_state(handle)));
snd_pcm_hw_params_get_access(params,
(snd_pcm_access_t*)&val);
printf("accesstype=%s\n",
snd_pcm_access_name((snd_pcm_access_t)val));
snd_pcm_hw_params_get_format(params,&val);
printf("format='%s'(%s)\n",
snd_pcm_format_name((snd_pcm_format_t)val),
snd_pcm_format_description(
(snd_pcm_format_t)val));
snd_pcm_hw_params_get_subformat(params,
(snd_pcm_subformat_t*)&val);
printf("subformat='%s'(%s)\n",
snd_pcm_subformat_name((snd_pcm_subformat_t)val),
snd_pcm_subformat_description(
(snd_pcm_subformat_t)val));
snd_pcm_hw_params_get_channels(params,&val);
printf("channels=%d\n",val);
snd_pcm_hw_params_get_rate(params,&val,&dir);
printf("rate=%dbps\n",val);
snd_pcm_hw_params_get_period_time(params,
&val,&dir);
printf("periodtime=%dus\n",val);
snd_pcm_hw_params_get_period_size(params,
&frames,&dir);
printf("periodsize=%dframes\n",(int)frames);
snd_pcm_hw_params_get_buffer_time(params,
&val,&dir);
printf("buffertime=%dus\n",val);
snd_pcm_hw_params_get_buffer_size(params,
(snd_pcm_uframes_t*)&val);
printf("buffersize=%dframes\n",val);
snd_pcm_hw_params_get_periods(params,&val,&dir);
printf("periodsperbuffer=%dframes\n",val);
snd_pcm_hw_params_get_rate_numden(params,
&val,&val2);
printf("exactrate=%d/%dbps\n",val,val2);
val=snd_pcm_hw_params_get_sbits(params);
printf("significantbits=%d\n",val);
snd_pcm_hw_params_get_tick_time(params,
&val,&dir);
printf("ticktime=%dus\n",val);
val=snd_pcm_hw_params_is_batch(params);
printf("isbatch=%d\n",val);
val=snd_pcm_hw_params_is_block_transfer(params);
printf("isblocktransfer=%d\n",val);
val=snd_pcm_hw_params_is_double(params);
printf("isdouble=%d\n",val);
val=snd_pcm_hw_params_is_half_duplex(params);
printf("ishalfduplex=%d\n",val);
val=snd_pcm_hw_params_is_joint_duplex(params);
printf("isjointduplex=%d\n",val);
val=snd_pcm_hw_params_can_overrange(params);
printf("canoverrange=%d\n",val);
val=snd_pcm_hw_params_can_mmap_sample_resolution(params);
printf("canmmap=%d\n",val);
val=snd_pcm_hw_params_can_pause(params);
printf("canpause=%d\n",val);
val=snd_pcm_hw_params_can_resume(params);
printf("canresume=%d\n",val);
val=snd_pcm_hw_params_can_sync_start(params);
printf("cansyncstart=%d\n",val);
snd_pcm_close(handle);
return0;
}
清单2打开默认的PCM设备，设置一些硬件参数并且打印出最常用的硬件参数值。它并不做任何回放或录音的操作。snd_pcm_open打开默认的PCM设备并设置访问模式为PLAYBACK。这个函数返回一个句柄，这个句柄保存在第一个函数参数中。该句柄会在随后的函数中用到。像其它函数一样，这个函数返回一个整数。如果返回值小于0,则代码函数调用出错。如果出错，我们用snd_errstr打开错误信息并退出。
为了设置音频流的硬件参数，我们需要分配一个类型为snd_pcm_hw_param的变量。分配用到函数宏snd_pcm_hw_params_alloca。下一步，我们使用函数snd_pcm_hw_params_any来初始化这个变量，传递先前打开的PCM流句柄。
接下来，我们调用API来设置我们所需的硬件参数。这些函数需要三个参数：PCM流句柄，参数类型，参数值。我们设置流为交错模式，16位的样本大小，2个信道，44100bps的采样率。对于采样率而言，声音硬件并不一定就精确地支持我们所定的采样率，但是我们可以使用函数snd_pcm_hw_params_set_rate_near来设置最接近我们指定的采样率的采样率。其实只有当我们调用函数snd_pcm_hw_params后，硬件参数才会起作用。
程序的剩余部分获得并打印一些PCM流参数，包括周期和缓冲区大小。结果可能会因为声音硬件的不同而不同。
运行该程序后，做实验，改动一些代码。把设备名字改成hw：0,0,然后看结果是否会有变化。设置不同的硬件参数然后观察结果的变化。
随机数据会产生5秒钟的白色噪声。
然后，尝试把标准输入重定向到设备/dev/null和/dev/zero上，并比较结果。改变一些参数，例如采样率和数据格式，然后查看结果的变化。
Listing4.SimpleSoundRecording
/*
ThisexamplereadsfromthedefaultPCMdevice
andwritestostandardoutputfor5secondsofdata.
*/
/*UsethenewerALSAAPI*/
#defineALSA_PCM_NEW_HW_PARAMS_API
#include<alsa/asoundlib.h>
intmain(){
longloops;
intrc;
intsize;
snd_pcm_t*handle;
snd_pcm_hw_params_t*params;
unsignedintval;
intdir;
snd_pcm_uframes_tframes;
char*buffer;
/*OpenPCMdeviceforrecording(capture).*/
rc=snd_pcm_open(&handle,"default",
SND_PCM_STREAM_CAPTURE,0);
if(rc<0){
fprintf(stderr,
"unabletoopenpcmdevice:%s\n",
snd_strerror(rc));
exit(1);
}
/*Allocateahardwareparametersobject.*/
snd_pcm_hw_params_alloca(¶ms);
/*Fillitinwithdefaultvalues.*/
snd_pcm_hw_params_any(handle,params);
/*Setthedesiredhardwareparameters.*/
/*Interleavedmode*/
snd_pcm_hw_params_set_access(handle,params,
SND_PCM_ACCESS_RW_INTERLEAVED);
/*Signed16-bitlittle-endianformat*/
snd_pcm_hw_params_set_format(handle,params,
SND_PCM_FORMAT_S16_LE);
/*Twochannels(stereo)*/
snd_pcm_hw_params_set_channels(handle,params,2);
/*44100bits/secondsamplingrate(CDquality)*/
val=44100;
snd_pcm_hw_params_set_rate_near(handle,params,
&val,&dir);
/*Setperiodsizeto32frames.*/
frames=32;
snd_pcm_hw_params_set_period_size_near(handle,
params,&frames,&dir);
/*Writetheparameterstothedriver*/
rc=snd_pcm_hw_params(handle,params);
if(rc<0){
fprintf(stderr,
"unabletosethwparameters:%s\n",
snd_strerror(rc));
exit(1);
}
/*Useabufferlargeenoughtoholdoneperiod*/
snd_pcm_hw_params_get_period_size(params,
&frames,&dir);
size=frames*4;/*2bytes/sample,2channels*/
buffer=(char*)malloc(size);
/*Wewanttoloopfor5seconds*/
snd_pcm_hw_params_get_period_time(params,
&val,&dir);
loops=5000000/val;
while(loops>0){
loops--;
rc=snd_pcm_readi(handle,buffer,frames);
if(rc==-EPIPE){
/*EPIPEmeansoverrun*/
fprintf(stderr,"overrunoccurred\n");
snd_pcm_prepare(handle);
}elseif(rc<0){
fprintf(stderr,
"errorfromread:%s\n",
snd_strerror(rc));
}elseif(rc!=(int)frames){
fprintf(stderr,"shortread,read%dframes\n",rc);
}
rc=write(1,buffer,size);
if(rc!=size)
fprintf(stderr,
"shortwrite:wrote%dbytes\n",rc);
}
snd_pcm_drain(handle);
snd_pcm_close(handle);
free(buffer);
return0;
}
清单4类似于清单3中的程序，除了这里的程序时做声音的抓取(录音)。当打开PCM设备时我们指定打开模式为SND_PCM_STREAM_CPATURE。在主循环中，我们调用snd_pcm_readi从声卡中读取数据，并把它们写入到标准输出。同样地，我们检查是否有overrun，如果存在，用与前例中相同的方式处理。
运行清单4的程序将录制将近5秒钟的声音数据，并把它们发送到标准输出。你也可以重定向到某个文件。如果你有一个麦克风连接到你的声卡，可以使用某个混音程序(mixer)设置录音源和级别。同样地，你也可以运行一个CD播放器程序并把录音源设成CD。尝试运行程序4并把输出定向到某个文件，然后运行程序3播放该文件里的声音数据：
./listing4>sound.raw
./listing3<sound.raw
如果你的声卡支持全双工，你可以通过管道把两个程序连接起来，这样就可以从声卡中听到录制的声音：
./listing4|./listing3
同样地，您可以做实验，看看采样率和样本格式的变化会产生什么影响。
高级特性
在前面的例子中，PCM流是以阻塞模式操作的，也就是说，直到数据已经传送完，PCM接口调用才会返回。在事件驱动的交互式程序中，这样会长时间阻塞应用程序，通常是不能接受的。ALSA支持以非阻塞模式打开音频流，这样读写函数调用后立即返回。如果数据传输被挂起，调用不能被处理，ALSA就是返回一个EBUSY的错误码。
许多图形应用程序使用回调来处理事件。ALSA支持以异步的方式打开一个PCM音频流。这使得当某个周期的样本数据被传输完后，某个已注册的回调函数将会调用。
这里用到的snd_pcm_readi和snd_pcm_writei调用和Linux下的读写系统调用类似。字母i表示处理的帧是交错式(interleaved)的。ALSA中存在非交互模式的对应的函数。Linux下的许多设备也支持mmap系统调用，这个调用将设备内存映射到主内存，这样数据就可以用指针来维护。ALSA也运行以mmap模式打开一个PCM信道，这允许有效的零拷贝(zerocopy)方式访问声音数据。
总结
我希望这篇文章能够激励你尝试编写某些ALSA程序。伴随着2.6内核在Linux发布版本(distributions)中被广泛地使用，ALSA也将被广泛地采用。它的高级特征将帮助Linux音频程序更好地向前发展。
JaroslavKysela和Takashilwai帮助查阅了本文的草稿并提出了宝贵的意见，在此表示感谢。
