ALSA是Advanced Linux Sound Architecture简称。它包含一组kernel 驱动，一个应用编程接口(API)库以及一组工具函数。本文中，我们会向读者展示ALSA项目和组成部件的概况。后面会重点介绍ALSA PCM接口的编程。
ALSA不仅仅是sound API。选择ALSA可以让你最大程度的控制和执行执行低级的audio函数，或者使用其它sound API不支持的特定功能。如果你已经写了一个audio应用程序，那么你可能希望为它增加ALSA sound驱动支持。如果你的主要兴趣不是audio，仅仅是想播放声音，那么你最好使用高级的sound toolkits，比如SDL，OpenAL或者桌面环境提供的其他开发包。如果你想使用ALSA，那么要确保你的Linux系统支持ALSA。
History of ALSA
ALSA项目的出现是因为Linux kernel sound driver OSS/Free drivers不能得到很好的维护，而导致驱动无法支持新的sound技术。Jaroslav Kysela最初为一个sound card写了一个驱动，启动了这个项目，随着时间的推移越来越多的开发者加入进来，重新定义了API以支持更多的声卡。
在Linux kernel 2.5的开发过程中，ALSA被merged到官方内核中。随着kernel2.6的发布，ALSA成为稳定版内核的一部分，并且得到了广泛使用。
Digital Audio Basics
声音由空气压力变化的波形组成，被转换器（如麦克风）转换为电信号。一个模数转换器（ADC）把模拟电压信号转换为离散值，称为采样，采样是按照固定时间间隔进行的，称为采样率。发送这些采样到数模转换器（DAC），再输出到loudspeaker，原始的声音就被重现了。
采样的位数大小，是决定声音数字精度的一个因素，另外一个主要因素是采样率。奈奎斯特理论指出当信号带宽小于1/2采样率时，可通过采样信号还原出原始信号。
ALSA Basics
ALSA包括支持各种声卡的Kernel设备驱动，API库libasound。应用开发者应该使用API而不是kernel系统调用接口。API库函数提供了高层次，编程友好的接口，开发者使用逻辑设备名而不需要考虑低级细节（如设备文件）。
与ALSA相反，OSS/Free要求应用在kernel系统调用级进行编程，这就需要开发者指定设备文件名并且使用ioctl来完成功能。为了兼容OSS，ALSA提供了内核模块来模拟OSS/Free声音驱动，所以大部分现存的audio应用都无须修。libaoss是模拟包装库，可以用来模拟OSS/Free API而不需要内核模块的模拟。
ALSA还提供了plugins能力，允许扩展一个新设备，甚至包括完全用软件实现的虚拟设备。ALSA提供了一组命令行工具，包括mixer，声音文件播放，以及对特定声卡特定功能的控制。
ALSA Architecture
ALSA API可以分为以下几个主要部分：
- Control接口：一个通用的功能，用来管理声卡的寄存器以及查询可用设备。
- PCM 接口：管理数字audio capture和playback的接口，本文的其余部分将主要介绍着个接口，因为这是audio应用最常用的接口
- Raw MIDI接口：支持MIDI(Musical Instrument DIgital Interface，电子音乐设备的标准)。这个API提供了对声卡MIDI bus的访问。Raw接口由MIDI events驱动，程序负责管理协议和计时
- Timer 接口：提供对声卡上计时硬件的访问，用于同步声音事件。
- Sequencer interface：一个MIPI编程和声音同步接口，比raw MIDI接口级别更高，它管理大部分MIDI协议和计时。
- Mixer接口：控制声卡上的信号路由和音量调节的设备。它是建立在control接口之上的。
Device Naming
API操作的是逻辑设备名而不是设备文件，设备名可以是真正的硬件设备或者插件。硬件设备使用hw:i,j这种格式，i是卡号而j是在这个卡上的设备。第一个声音设备是hw:0,0。第一个sound设备的别名为defalut，本文后面的例子都使用default。Plugins使用另外一种命名模式：例如plughw:是一个插件除了提供对硬件设备的访问还提供某种功能，比如软件实现采样率转换，因为硬件不支持这种操作。dmix插件允许合成几路数据 dshare插件允许把单路数据动态分配到不同的应用中。
Sound Buffers and Data Transfer
声卡有一个硬件buffer。在录音时(capture)存储录音的采样值，当buffer填满后声卡生成一个中断，kernel sound驱动使用DMA传输采样数据到内存buffer。类似的在playback时，应用buffer数据通过DMA传输给sound card的硬件buffer
这个硬件buffer是一个ring buffers，意味着当到达buffer末端后，就会重新回到起始端。一个指针用来维护硬件buffer和应用buffer的当前位置。在内核外部，仅能访问application buffer，所以在这里我们主要讨论application buffer。
buffer的尺寸可以通过ALSA库函数调用指定。buffer可以非常的大，一次传输完整个buffer的数据可能导致无法接收的延迟，所以，ALSA把这个buffer分割为一系列periods，以period做为传输数据的单位。
Period由多个frames组成，每一个frames包含在一个时间点的采样值，对于立体声设备来说，一个frames包含两个channels的采用，图1演示了一个buffer， period，sample之间的关系，在这里，左右声道的数据存储在一帧中，这种模式称为interleaved。对于non-interleaved 模式，所有的左声道数据存放在一起，然后所有的右声道保存在一起。
Over and Under Run
当一个声音设备被激活，数据持续的在硬件和应用buffer间传送。在录音情况下（capture），如果应用没有快速的从buffer中读取数据，环状buffer将被新到的数据覆盖，导致数据丢失，我们称之为overrun。在playback情况下，如果应用无法快速传送数据到buffer中，那么导致hardware无数据可播放，这种情况我们称之为underrun。ALSA文档有时把这两种情况统称为XRUN。正确设计的应用最小化XRUN的发生并且在XRUN发生后能够恢复操作。
A typical Sound Application
通常可以用下面伪代码表示PCM接口编程模式：
open interface for capture or playback
set hardware parameters(access mode, data format, channels, rate, etc.)
while there is data to be processed:
read PCM data(capture) or write PCM data(playback)
close interface
我们先看看一些示例代码。我推荐你在linux系统编译运行它们，观察输出然后尝试一些修改。这些测试代码的完整列表可以从以下地址下载：ftp.linuxjournal.com/pub/lj/listings/issue126/6735.tgz
Listing 1. Display Some PCM Types and Formats
#include <alsa/asoundlib.h>
int main() {
int val;
printf("ALSA library version: %s\n", SND_LIB_VERSION_STR);
printf("PCM stream types:\n");
for (val = 0; val <= SND_PCM_STREAM_LAST; val++) {
printf(" %s\n", snd_pcm_stream_name((snd_pcm_stream_t)val));
}
printf("PCM access types:\n");
for (val = 0; val <= SND_PCM_ACCESS_LAST; val++) {
printf(" %s\n", snd_pcm_access_name((snd_pcm_access_t)val));
}
printf("PCM formats:\n");
for (val = 0; val <= SND_PCM_STREAM_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("\nPCM subformats:\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));
}
return 0;
}
gcc -o test test.c -lasound
编译为可执行文件，程序必须链接ALSA库，libasound。有些ALSA库函数需要使用dlopen功能和浮点运算，所以有时需要增加-ldl和-lmgcc -o listing1 listing1.c -lasound在我的机器上，运行结果如下
ALSA library version: 1.0.22 PCM stream types: PLAYBACK CAPTURE PCM access types: MMAP_INTERLEAVED MMAP_NONINTERLEAVED MMAP_COMPLEX RW_INTERLEAVED RW_NONINTERLEAVED PCM formats: S8 (Signed 8 bit) U8 (Unsigned 8 bit) PCM subformats: STD (Standard)
listing1 展示了一些ALSA使用的PCM数据类型和参数。需要包含头文件alsa/asoundlib.h，ALSA库函数以及常用宏都在这个文件中定义。这个程序的其余部分重复的打印了PCM数据类型。
Listing 2. Opening PCM Device and Setting Parameters
/*
This example opens the default PCM device, sets some parameters,
and then displays the value of most of the hardware parameters. It does
not perform any sound playback or recording.
*/
/* Use the newer ALSA API */
#define ALSA_PCM_NEW_HW_PARAMS_API
/* All of the ALSA library API is defined in this header */
#include <alsa/asoundlib.h>
int main()
{
int rc;
snd_pcm_t *handle;
snd_pcm_hw_params_t *params;
unsigned int val, val2;
int dir;
snd_pcm_uframes_t frames;
/* Open PCM device for playback */
rc = snd_pcm_open(&handle, "default", SND_PCM_STREAM_PLAYBACK, 0);
if (rc < 0) {
printf("unable to open pcm device\n");
}
/* Allocate a hardware parameters object */
snd_pcm_hw_params_alloca(¶ms);
/* Fill it in with default values. */
snd_pcm_hw_params_any(handle, params);
/*Set the desired hardware parameters. */
/* Interleaved mode */
snd_pcm_hw_params_set_access(handle, params, SND_PCM_ACCESS_RW_INTERLEAVED);
/* Signed 16-bit little-endian format */
snd_pcm_hw_params_set_format(handle, params, SND_PCM_FORMAT_S16_LE);
/* Two channels (stero) */
snd_pcm_hw_params_set_channels(handle, params, 2);
/* 44100 bits/second sampling rate */
val = 44100;
snd_pcm_hw_params_set_rate_near(handle, params, &val, &dir);
/* Write the parameters to the dirver */
rc = snd_pcm_hw_params(handle, params);
if (rc < 0) {
printf("unable to set hw parameters: %s\n", snd_strerror(rc));
exit(1);
}
/* Display information about the PCM interface */
printf("PCM handle name = '%s'\n", snd_pcm_name(handle));
printf("PCM state = %s\n", snd_pcm_state_name(snd_pcm_state(handle)));
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 = %d bps\n", val);
snd_pcm_hw_params_get_period_time(params, &val, &dir);
printf("period time = %d us\n", val);
snd_pcm_hw_params_get_period_size(params, &frames, &dir);
printf("period size = %d frames\n", (int)frames);
snd_pcm_hw_params_get_buffer_time(params, &val, &dir);
printf("buffer time = %d us\n", val);
snd_pcm_hw_params_get_buffer_size(params, (snd_pcm_uframes_t *) &val);
printf("buffer size = %d frames\n", val);
snd_pcm_hw_params_get_periods(params, &val, &dir);
printf("periods per buffer = %d frames\n", val);
snd_pcm_hw_params_get_rate_numden(params, &val, &val2);
printf("exact rate=%d/%d bps\n", val, val2);
val = snd_pcm_hw_params_get_sbits(params);
printf("significant bits = %d\n", val);
snd_pcm_hw_params_get_tick_time(params, &val, &dir);
printf("tick time = %d us\n", val);
val = snd_pcm_hw_params_is_batch(params);
printf("is batch = %d\n", val);
val = snd_pcm_hw_params_is_block_transfer(params);
printf("is block transfer = %d\n", val);
val = snd_pcm_hw_params_is_double(params);
printf("is double = %d\n", val);
val = snd_pcm_hw_params_is_half_duplex(params);
printf("is half duplex = %d\n", val);
val = snd_pcm_hw_params_is_joint_duplex(params);
printf("is joint duplex = %d\n", val);
val = snd_pcm_hw_params_can_overrange(params);
printf("can overrange = %d\n", val);
val = snd_pcm_hw_params_can_mmap_sample_resolution(params);
printf("can mmap = %d\n", val);
val = snd_pcm_hw_params_can_pause(params);
printf("can overrange = %d\n", val);
val = snd_pcm_hw_params_can_sync_start(params);
printf("can sync start = %d\n", val);
snd_pcm_close(handle);
return 0;
}
执行结果为
PCM handle name = 'default' PCM state = PREPARED format = 'S16_LE'(Signed 16 bit Little Endian) subformat = 'STD' (Standard) channels=2 rate = 44100 bps period time = 23219 us period size = 1024 frames buffer time = 23219 us buffer size = 1048576 frames periods per buffer = 1024 frames exact rate=44100/1 bps significant bits = 16 tick time = 0 us is batch = 0 is block transfer = 1 is double = 0 is half duplex = 0 is joint duplex = 0 can overrange = 0 can mmap = 0 can overrange = 1 can sync start = 0
List2打开缺省的PCM设备，设置一些参数，然后显示大部分的硬件参数。这个测试程序不会执行playback和recording。调用snd_pcm_open打开缺省的PCM设备，打开模式为PLAYBACK。这个函数通过第一个参数返回一个句柄，后续的操作使用这个句柄操作这个PCM设备。像大部分ALSA库函数调用，snd_pcm_open返回一个整数表示调用状态，负数指明出错原因。为了使测试代码更简洁，我忽略了大部分的函数返回值。在产品级应用中，开发者应该检查每一个API调用，以便提供相应的出错处理。
为了设置流的硬件参数，我们需要分配一个snd_pcm_hw_param_t变量，首先调用macro snd_pcm_hw_params_alloca，接下来使用snd_pcm_hw_params_any来初始化这个变量。接下来使用ALSA提供的API设置PCM 流的硬件参数，这些API的参数形式为(PCM handle, snd_pcm_hw_param_t *, val)。我们设置流为interleaved mode，16 bit sample size，2 channels和44100Hz采样率。对于采样率，声卡硬件不一定支持指定的采样率。我们使用函数snd_pcm_hw_params_set_rate_near请求设置指定值附近的采样率。在调用snd_pcm_hw_params函数之前，所有设置的硬件参数并不会被激活。
这个程序的其他部分获得并显示PCM 流的参数，包括周期和buffer sizes。显示结果依赖于测试机器的硬件。
在你的机器上运行这个程序，并尝试做一些修改。比如把device名从defalut改为hw:0,0或者plughw：查看结果是否改变。修改硬件参数的值，查看显示部分的变化。
Listing 3. SImple Sound Playback
/*
* This example reads standard from input and writes to
* the default PCM device for 5 seconds of data.
*/
/* Use the newer ALSA API */
#define ALSA_PCM_NEW_HW_PARAMS_API
#include <alsa/asoundlib.h>
int main()
{
long loops;
int rc;
int size;
snd_pcm_t *handle;
snd_pcm_hw_params_t *params;
unsigned int val;
int dir;
snd_pcm_uframes_t frames;
char *buffer;
/* Open PCM device for playback */
rc = snd_pcm_open(&handle, "default", SND_PCM_STREAM_PLAYBACK, 0);
if (rc < 0) {
printf("unable to open pcm device: %s\n", snd_strerror(rc));
exit(1);
}
snd_pcm_hw_params_alloca(¶ms);
snd_pcm_hw_params_any(handle, params);
snd_pcm_hw_params_set_access(handle, params, SND_PCM_ACCESS_RW_INTERLEAVED);
snd_pcm_hw_params_set_format(handle, params, SND_PCM_FORMAT_S16_LE);
snd_pcm_hw_params_set_channels(handle, params, 2);
val = 44100;
snd_pcm_hw_params_set_rate_near(handle, params, &val, &dir);
frames = 32;
snd_pcm_hw_params_set_period_size_near(handle, params, &frames, &dir);
rc = snd_pcm_hw_params(handle, params);
if (rc < 0) {
printf("unable to set hw parameters: %s\n", snd_strerror(rc));
exit(1);
}
snd_pcm_hw_params_get_period_size(params, &frames, &dir);
size = frames * 4;
buffer = (char *)malloc(size);
snd_pcm_hw_params_get_period_time(params, &val, &dir);
loops = 5000000 / val;
while (loops > 0) {
loops--;
rc = read(0, buffer, size);
rc = snd_pcm_writei(handle, buffer, frames);
if (rc == -EPIPE) {
printf("underrun occured\n");
}
else if (rc < 0) {
printf("error from writei: %s\n", snd_strerror(rc));
}
}
snd_pcm_drain(handle);
snd_pcm_close(handle);
free(buffer);
return 0;
}
Listing 3扩展了前面的例子，写了一些随机的采样数据到声卡的playback。在这个例子中，我们从标准输入获取数据，当获取的数据达到一个period时，就把采样数据写入声卡。
这个程序的开始部分和前面的例子一样：打开PCM设备并设置硬件参数。我们使用ALSA选择的period size作为储存采样数据buffer的大小。通过这个period time我们就可以计算出5秒钟大概需要多少个periods。
在循环中我们从标准输入读取数据填充一个period的采样数据到buffer。我们检查并处理文件结束以及读取字节数和期望数不一致的情况。
使用snd_pcm_write函数发送数据到PCM设备。这个操作很像内核的write系统调用，除了size的单位是frames。检查返回的错误码，错误码EPIPE表示underrun错误发生，这会导致PCM 流进入了XRUN状态，停止处理数据。从这种状态恢复的标准方法是调用snd_pcm_prepare，使得流进入PREPARED状态，这样我们就可以再次向流中写入数据了，如果接收的是其他的错误码，那么我们显示错误码，并且继续执行。
这个程序循环执行5秒或者到达输入文件的结束符。我们调用snd_pcm_drain使得所有pending的采样数据被传输，然后关闭这个流。释放分配的buffer并退出。
执行这个程序，并使用/dev/urandom作为输入
./example < /dev/urandom
Listing 4. Simple Sound Recording
/*
This example reads from the default PCM device
and writes to standard output for 5 seconds of data.
*/
/* Use the newer ALSA ALI */
#define ALSA_PCM_NEW_HW_PARAMS_API
#include <alsa/asoundlib.h>
int main()
{
long loops;
int rc;
int size;
snd_pcm_t *handle;
snd_pcm_hw_params_t *params;
unsigned int val;
int dir;
snd_pcm_uframes_t frames;
char *buffer;
rc = snd_pcm_open(&handle, "default", SND_PCM_STREAM_CAPTURE, 0);
<pre name="code" class="programlisting"> if (rc < 0) {
fprintf(stderr,
"unable to open pcm device: %s\n",
snd_strerror(rc));
exit(1);
}
/* Allocate a hardware parameters object. */
snd_pcm_hw_params_alloca(¶ms);
/* Fill it in with default values. */
snd_pcm_hw_params_any(handle, params);
/* Set the desired hardware parameters. */
/* Interleaved mode */
snd_pcm_hw_params_set_access(handle, params,
SND_PCM_ACCESS_RW_INTERLEAVED);
/* Signed 16-bit little-endian format */
snd_pcm_hw_params_set_format(handle, params,
SND_PCM_FORMAT_S16_LE);
/* Two channels (stereo) */
snd_pcm_hw_params_set_channels(handle, params, 2);
/* 44100 bits/second sampling rate (CD quality) */
val = 44100;
snd_pcm_hw_params_set_rate_near(handle, params,
&val, &dir);
/* Set period size to 32 frames. */
frames = 32;
snd_pcm_hw_params_set_period_size_near(handle,
params, &frames, &dir);
/* Write the parameters to the driver */
rc = snd_pcm_hw_params(handle, params);
if (rc < 0) {
fprintf(stderr,
"unable to set hw parameters: %s\n",
snd_strerror(rc));
exit(1);
}
/* Use a buffer large enough to hold one period */
snd_pcm_hw_params_get_period_size(params,
&frames, &dir);
size = frames * 4; /* 2 bytes/sample, 2 channels */
buffer = (char *) malloc(size);
/* We want to loop for 5 seconds */
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) {
/* EPIPE means overrun */
fprintf(stderr, "overrun occurred\n");
snd_pcm_prepare(handle);
} else if (rc < 0) {
fprintf(stderr,
"error from read: %s\n",
snd_strerror(rc));
} else if (rc != (int)frames) {
fprintf(stderr, "short read, read %d frames\n", rc);
}
rc = write(1, buffer, size);
if (rc != size)
fprintf(stderr,
"short write: wrote %d bytes\n", rc);
}
snd_pcm_drain(handle);
snd_pcm_close(handle);
free(buffer);
return 0;
}
Listing 4和Listing3很相像，除了执行了PCM capture。在我们打开PCM流时，我们指定了操作模式为SND_PCM_STREAM_CAPTURE。主循环中，使用snd_pcm_readi从本地声音硬件读取samples，然后把采样输出到标准输出。如果你有一个microphone连接到声卡，使用mixer程序设置录音源和级别。相应的，你可以运行一个CD player程序然后设置录音源为CD。如果你把listing4的输出重定向到一个文件，那么你可以用listing3来播放listing4的录音数据：
./listing4 > sound.raw ./listing3 < sound.raw
如果你的声卡支持全双工，那么你可以通过管道把这个执行命令连接起来，可以播放录音数据
./listing4 | ./listing3
通过修改PCM参数，你可以体验采样率和格式变化的效果。
Advanced Features
在前面的例子中，PCM流工作在阻塞模式，也就是说，在数据传输结束完之前不会函数不会返回。在一个交互式为主导的应用中，这种情况将使得应用长时间无响应。ALSA允许非阻塞模式操纵流，这种方式下read/write操作立刻返回，如果数据传输无法立刻进行，那么read/write立刻返回一个EBUSY错误码。
有些图形界面应用使用事件callback机制。ALSA支持异步PCM stream，当一个period的采样数据完成以后，注册的callback被调用。
snd_pcm_readi和snd_pcm_writei调用类似于linux的read/write系统调用。字母i表示帧是interleaved；相对的是non-interleaved模式。Linux下的一些设备也支持mmap系统调用，ALSA支持mmap模式打开PCM channel，应用层不需要数据copy就可以有效访问声音数据。
Conclusion
我希望这篇文章能够成为你使用ALSA的动力。当2.6 kernel被大部分发行版使用后，ALSA的使用更加广泛，它的高级features应该能帮助linux audio应用开发者。
感谢Jaroslav Kysela和Takashi Iwai reviewing本文的初稿并提供了有用的反馈。