4. ALSA库编程入门：libasound安装、snd_pcm_open、snd_pcm_hw_params配置、PCM句柄管理

好，咱们正式开始动手写代码了。前面几章我们把音频的物理世界和Linux内核的ALSA框架捋了一遍，现在该轮到真正的编程环节了。这一章，我带你从零搭建一个ALSA应用的基础骨架——说白了，就是学会怎么让我们的程序跟ALSA驱动“对上话”。

我个人习惯把ALSA库编程分成三步走：安装环境 → 打开设备 → 配置参数。这三步走通了，音频数据流才能在你的应用和硬件之间跑起来。嗯，咱们一个一个来。

4.1 安装libasound开发库

在嵌入式Linux上做ALSA开发，第一件事就是把开发库装好。你可能会问：“我系统里不是已经有alsa-utils了吗？aplay都能用，为啥还要装库？”

这里有个小坑：运行时库和开发库是两回事。aplay能跑，说明你有libasound.so.2这个动态库，但编译程序需要的头文件和静态链接信息，得靠libasound2-dev这个包来提供。

sudo apt-get update
sudo apt-get install libasound2-dev

装完之后，你可以用下面这条命令验证一下头文件是否到位：

dpkg -L libasound2-dev | grep alsa/asoundlib.h

如果看到了路径，恭喜你，环境准备好了。

4.2 PCM句柄：打开音频设备的第一步

ALSA把音频设备抽象成一个“PCM句柄”，类型是snd_pcm_t *。你可以把它理解成文件描述符的“音频版”——所有后续的读写操作，都得通过这个句柄来完成。

打开设备的API长这样：

#include <alsa/asoundlib.h>

snd_pcm_t *pcm_handle;
int rc;

rc = snd_pcm_open(&pcm_handle, "default", 
                   SND_PCM_STREAM_PLAYBACK, 0);
if (rc < 0) {
    fprintf(stderr, "打开PCM设备失败: %s\n", 
            snd_strerror(rc));
    return -1;
}

这里有几个参数我得跟你解释一下：

• 第一个参数：二级指针，函数内部会分配并初始化PCM句柄。
• 第二个参数：设备名称。传"default"最省事，系统会自动选一个可用的声卡。如果你想指定具体设备，可以用"hw:0,0"（第一张声卡第一个设备）或"plughw:0,0"（带自动格式转换的版本）。
• 第三个参数：流方向。SND_PCM_STREAM_PLAYBACK是播放，SND_PCM_STREAM_CAPTURE是录音。
• 第四个参数：阻塞模式标志。传0表示阻塞模式，传SND_PCM_NONBLOCK表示非阻塞。

4.3 硬件参数配置：让驱动知道你要什么

句柄打开了，但驱动还不知道你想要什么格式的数据。是16位还是32位？采样率48kHz还是44.1kHz？单声道还是立体声？这些都得通过snd_pcm_hw_params_t来告诉驱动。

配置流程我总结为“五步法”，你照着这个顺序来，基本不会出错：

1. 分配参数对象：snd_pcm_hw_params_alloca(&params)
2. 初始化默认值：snd_pcm_hw_params_any(pcm_handle, params)
3. 设置访问类型：交错模式还是非交错模式
4. 设置格式、通道数、采样率
5. 应用配置：snd_pcm_hw_params(pcm_handle, params)

来看一段完整的配置代码：

snd_pcm_hw_params_t *params;
unsigned int sample_rate = 44100;
int channels = 2;

// 1. 分配参数对象（栈上分配，无需free）
snd_pcm_hw_params_alloca(&params);

// 2. 用当前驱动的默认值填充
snd_pcm_hw_params_any(pcm_handle, params);

// 3. 设置访问类型：交错模式
snd_pcm_hw_params_set_access(pcm_handle, params,
    SND_PCM_ACCESS_RW_INTERLEAVED);

// 4. 设置采样格式：16位有符号小端
snd_pcm_hw_params_set_format(pcm_handle, params,
    SND_PCM_FORMAT_S16_LE);

// 5. 设置通道数
snd_pcm_hw_params_set_channels(pcm_handle, params,
    channels);

// 6. 设置采样率（驱动可能微调，所以传指针）
snd_pcm_hw_params_set_rate_near(pcm_handle, params,
    &sample_rate, 0);

// 7. 应用配置到驱动
rc = snd_pcm_hw_params(pcm_handle, params);
if (rc < 0) {
    fprintf(stderr, "配置硬件参数失败: %s\n",
            snd_strerror(rc));
    snd_pcm_close(pcm_handle);
    return -1;
}

4.4 参数配置的“必填项”清单

你可能会问：“这么多参数，哪些是必须配的？”我整理了一张表，你照着配就行：

前四个参数是“硬性要求”，不配的话snd_pcm_hw_params会直接报错。周期和缓冲区大小如果不配，驱动会用默认值，但延迟表现可能不理想。我一般会在产品开发阶段把这两个也配好，做到心里有数。

4.5 PCM句柄的生命周期管理

句柄用完了要释放，这个道理大家都懂。但ALSA的句柄管理有几个细节，不注意就会出问题：

• 正常关闭：snd_pcm_close(pcm_handle)，会释放所有内部资源。
• 异常恢复：如果设备被其他进程抢占或发生EPIPE（欠载/过载），需要先snd_pcm_recover()再继续使用，而不是直接close。
• 不要重复close：close之后把句柄置为NULL，防止double-free。

我习惯的写法是这样的：

void cleanup_pcm(snd_pcm_t **handle) {
    if (handle && *handle) {
        snd_pcm_drain(*handle);  // 先排空剩余数据
        snd_pcm_close(*handle);
        *handle = NULL;
    }
}

4.6 知识体系总览

这一章的内容，我用一张图帮你串起来：

这张图把整个流程分成了五个阶段。你写代码的时候，就按这个顺序一步步来，思路会非常清晰。

4.7 完整示例：打开并配置一个播放设备

最后，我把这一章的知识点整合成一个完整的示例。这个程序只做一件事：打开默认播放设备，配置成44.1kHz、16位、立体声，然后打印配置信息，最后关闭。你可以把它当成后续章节的“脚手架”。

#include <stdio.h>
#include <alsa/asoundlib.h>

int main() {
    snd_pcm_t *handle = NULL;
    snd_pcm_hw_params_t *params;
    unsigned int rate = 44100;
    int dir;
    int rc;

    // 1. 打开PCM设备
    rc = snd_pcm_open(&handle, "default",
                      SND_PCM_STREAM_PLAYBACK, 0);
    if (rc < 0) {
        printf("打开失败: %s\n", snd_strerror(rc));
        return -1;
    }
    printf("PCM设备打开成功\n");

    // 2. 分配并初始化硬件参数
    snd_pcm_hw_params_alloca(&params);
    snd_pcm_hw_params_any(handle, params);

    // 3. 配置参数
    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);
    snd_pcm_hw_params_set_rate_near(handle, params,
        &rate, &dir);

    // 4. 应用配置
    rc = snd_pcm_hw_params(handle, params);
    if (rc < 0) {
        printf("配置失败: %s\n", snd_strerror(rc));
        snd_pcm_close(handle);
        return -1;
    }
    printf("配置成功: %u Hz, 16位, 立体声\n", rate);

    // 5. 清理
    snd_pcm_drain(handle);
    snd_pcm_close(handle);
    printf("PCM设备已关闭\n");

    return 0;
}

gcc -o alsa_init alsa_init.c -lasound