3. PCM 参数结构体详解：snd_pcm_hw_params_t、snd_pcm_sw_params_t、参数配置流程

在 ALSA 音频子系统中，PCM 设备的参数配置是驱动开发与音频调优的核心环节。应用程序通过两个关键的结构体——硬件参数（hw_params） 与 软件参数（sw_params）——来定义音频数据流的格式、缓冲区大小、延迟行为以及中断触发条件。本章将深入解析这两个结构体的字段含义、配置顺序以及典型的参数协商流程。

3.1 snd_pcm_hw_params_t：硬件参数结构体

snd_pcm_hw_params_t 是 ALSA 用户空间库中用于描述 PCM 设备硬件能力与配置的核心结构体。它封装了采样率、采样格式、通道数、缓冲区大小、周期大小等所有与硬件直接相关的参数。驱动通过该结构体与应用程序进行参数协商，最终确定一个双方都支持的配置。

3.1.1 核心字段与含义

3.1.2 参数范围查询与约束

ALSA 提供了一套完善的参数区间（interval）与掩码（mask）机制，用于描述硬件支持的范围。应用程序通过以下函数进行查询与设置：

• snd_pcm_hw_params_any()：用设备支持的完整范围填充 hw_params 结构体。
• snd_pcm_hw_params_set_rate()：设置采样率，驱动会就近选择一个支持的值。
• snd_pcm_hw_params_set_format()：设置采样格式。
• snd_pcm_hw_params_set_channels()：设置通道数。
• snd_pcm_hw_params_set_buffer_size_near()：设置最接近请求值的缓冲区大小。
• snd_pcm_hw_params_set_period_size_near()：设置最接近请求值的周期大小。

3.2 snd_pcm_sw_params_t：软件参数结构体

snd_pcm_sw_params_t 控制 PCM 流的运行时行为，包括中断触发阈值、起始阈值、停止阈值以及静音填充等。这些参数不直接涉及硬件寄存器，而是由 ALSA 内核层在软件层面进行管理。

3.2.1 核心字段与含义

3.2.2 关键参数详解

• avail_min： 这是低延迟调优中最关键的参数之一。当应用程序调用 snd_pcm_wait() 或 poll() 时，只有当环形缓冲区中的可用帧数达到 avail_min 时，内核才会唤醒应用程序。设置过小会导致频繁唤醒，设置过大会增加延迟。
• start_threshold： 决定 PCM 流何时开始传输。对于播放流，当应用程序写入的帧数达到该阈值时，DMA 开始传输。设置为 1 可实现最低延迟启动，但可能导致启动瞬间的 xrun。
• stop_threshold： 当缓冲区中的可用帧数低于该阈值时，PCM 流自动停止。通常设置为 buffer_size，表示当缓冲区完全欠载或溢出时停止。

3.3 参数配置流程

PCM 参数的配置遵循严格的顺序，任何一步出错都可能导致设备无法正常工作。下图展示了从打开设备到最终启动流的完整流程：

3.3.1 典型配置代码示例

以下代码展示了在用户空间使用 ALSA lib 进行 PCM 参数配置的标准流程：

#include <alsa/asoundlib.h>

snd_pcm_t *pcm_handle;
snd_pcm_hw_params_t *hw_params;
snd_pcm_sw_params_t *sw_params;

// 1. 打开 PCM 设备
snd_pcm_open(&pcm_handle, "hw:0,0", SND_PCM_STREAM_PLAYBACK, 0);

// 2. 分配并初始化 hw_params
snd_pcm_hw_params_alloca(&hw_params);
snd_pcm_hw_params_any(pcm_handle, hw_params);

// 3. 设置硬件参数
snd_pcm_hw_params_set_access(pcm_handle, hw_params,
                             SND_PCM_ACCESS_RW_INTERLEAVED);
snd_pcm_hw_params_set_format(pcm_handle, hw_params,
                             SND_PCM_FORMAT_S16_LE);
snd_pcm_hw_params_set_channels(pcm_handle, hw_params, 2);
unsigned int rate = 48000;
snd_pcm_hw_params_set_rate_near(pcm_handle, hw_params, &rate, 0);

snd_pcm_uframes_t buffer_size = 4096;
snd_pcm_hw_params_set_buffer_size_near(pcm_handle, hw_params,
                                       &buffer_size);
snd_pcm_uframes_t period_size = 1024;
snd_pcm_hw_params_set_period_size_near(pcm_handle, hw_params,
                                       &period_size, 0);

// 4. 应用硬件参数
snd_pcm_hw_params(pcm_handle, hw_params);

// 5. 分配并初始化 sw_params
snd_pcm_sw_params_alloca(&sw_params);
snd_pcm_sw_params_current(pcm_handle, sw_params);

// 6. 设置软件参数
snd_pcm_sw_params_set_avail_min(pcm_handle, sw_params, period_size);
snd_pcm_sw_params_set_start_threshold(pcm_handle, sw_params, 1);
snd_pcm_sw_params_set_stop_threshold(pcm_handle, sw_params,
                                     buffer_size);

// 7. 应用软件参数
snd_pcm_sw_params(pcm_handle, sw_params);

// 8. 准备 PCM 流，开始传输
snd_pcm_prepare(pcm_handle);

3.3.2 参数协商与失败处理

在实际开发中，硬件可能不支持应用程序请求的精确参数值。ALSA 提供了 _near 后缀的函数，用于获取最接近的可用值。开发者应始终检查返回值，并在必要时进行降级处理：

3.4 hw_params 与 sw_params 的协同关系

hw_params 定义了硬件能力与资源分配，而 sw_params 定义了软件行为与中断策略。两者共同决定了 PCM 流的最终性能表现。下图展示了它们之间的依赖关系：

3.5 常见配置错误与排查

• 参数设置顺序错误： 先设置缓冲区大小，再修改采样率，导致缓冲区被重新计算。应始终先设置基本参数（rate/format/channels），再设置 buffer/period。
• avail_min 设置过大： 导致应用程序唤醒不及时，出现 xrun（欠载或溢出）。对于低延迟场景，avail_min 不应超过 period_size。
• start_threshold 设置不合理： 设置过小（如 1）可能导致启动瞬间的 xrun；设置过大（如 buffer_size）会导致启动延迟过高。
• 未检查返回值： 所有 snd_pcm_hw_params_set_* 和 snd_pcm_sw_params_set_* 函数都应检查返回值，失败时进行降级处理。
• period_size 不是 buffer_size 的约数： 导致周期对齐错误，驱动可能返回 -EINVAL。应确保 buffer_size % period_size == 0。