📚 课程目录第4章采样率配置

4. 采样率配置：支持的采样率范围、采样率设置函数与匹配策略

采样率（Sample Rate）是 PCM 音频流最基本的时序参数，决定了每秒采集或回放的样本数量。ALSA 驱动与应用程序通过 snd_pcm_hw_params_set_rate 系列函数完成采样率的协商与配置。本章深入分析采样率的硬件约束、设置接口以及内核采用的匹配策略。

4.1 支持的采样率范围

每个音频控制器硬件支持的采样率并非连续无限，而是受限于晶振分频、PLL 锁定范围以及编解码器（CODEC）的时钟树设计。ALSA 使用 速率约束（Rate Constraint） 来描述硬件能力，常见形式包括：

单一固定值：如仅支持 48000 Hz。
离散值列表：如 8000, 11025, 16000, 22050, 44100, 48000, 96000 Hz。
连续范围：如 8000 ~ 192000 Hz，步进为 1 Hz。
连续范围 + 步进：如 8000 ~ 48000 Hz，步进为 1000 Hz。

硬件约束来源： 采样率上限通常受限于 DMA 带宽和系统时钟频率；下限受限于编解码器内部滤波器的截止频率。嵌入式平台中，I2S 总线位时钟（BCLK）与采样率的关系为：BCLK = sample_rate × channels × sample_bits，因此采样率配置必须与通道数、位宽联合约束。

常见音频硬件采样率支持模式
硬件类型	采样率范围	约束类型	典型应用
低功耗编解码器（如 WM8960）	8000 ~ 48000 Hz	离散值列表	智能音箱、对讲设备
高性能音频 DAC（如 PCM5242）	8000 ~ 192000 Hz	连续范围	Hi-Fi 播放器、专业声卡
USB Audio Class 2.0	8000 ~ 384000 Hz	离散值列表 + 连续范围混合	USB 麦克风、外置声卡
SoC 内置 I2S 控制器	8000 ~ 96000 Hz	连续范围（受 MCLK 分频限制）	嵌入式 Linux 音频设备

4.2 采样率设置函数：snd_pcm_hw_params_set_rate

ALSA 用户空间库提供 snd_pcm_hw_params_set_rate 函数用于设置采样率。该函数原型如下：

int snd_pcm_hw_params_set_rate(
    snd_pcm_t *pcm,
    snd_pcm_hw_params_t *params,
    unsigned int val,
    int dir
);

参数说明：

pcm：PCM 句柄，由 snd_pcm_open 获得。
params：硬件参数对象，通常先由 snd_pcm_hw_params_any 初始化。
val：期望的采样率值，单位为 Hz。
dir：方向指示符，用于指定采样率的舍入方向：
- 0：精确匹配，若硬件不支持则返回错误。
- -1：向下舍入，选择不超过 val 的最大支持值。
- 1：向上舍入，选择不小于 val 的最小支持值。

  返回值： 成功返回 0；失败返回负数错误码（如 -EINVAL 表示参数无效，-EIO 表示硬件不支持）。调用后可通过 snd_pcm_hw_params_get_rate 获取实际匹配到的采样率。

4.2.1 典型调用流程

snd_pcm_hw_params_t *hw_params;
unsigned int rate = 44100;
int dir = 0;  // 精确匹配

snd_pcm_hw_params_alloca(&hw_params);
snd_pcm_hw_params_any(pcm, hw_params);

// 设置采样率
if (snd_pcm_hw_params_set_rate(pcm, hw_params, rate, dir) < 0) {
    // 精确匹配失败，尝试向下舍入
    dir = -1;
    if (snd_pcm_hw_params_set_rate(pcm, hw_params, rate, dir) < 0) {
        printf("采样率设置失败\n");
        return -1;
    }
}

// 获取实际匹配的采样率
unsigned int actual_rate;
snd_pcm_hw_params_get_rate(hw_params, &actual_rate, &dir);
printf("请求采样率: %u Hz, 实际采样率: %u Hz\n", rate, actual_rate);

4.3 采样率匹配策略

ALSA 内核子系统在 pcm_native.c 中实现了采样率匹配算法。当用户空间调用 snd_pcm_hw_params_set_rate 时，内核按照以下优先级进行匹配：

精确匹配：检查请求值是否在硬件支持的离散值列表或连续范围内。若在范围内且步进满足，直接返回该值。
方向舍入：若精确匹配失败，根据 dir 参数进行向下或向上舍入：
- 对于离散值列表：选择最接近的离散值。
- 对于连续范围：在范围内取边界值（下限或上限）。
约束交叉验证：匹配后的采样率必须通过所有已注册约束的验证，包括与通道数、位宽、DMA 突发长度的联合约束。
最终确认：将匹配结果写入 hw_params 结构体，并更新相关的时钟分频系数。

4.4 采样率配置的常见陷阱与调优建议

陷阱 1：忽略 dir 参数导致配置失败
许多开发者将 dir 固定为 0（精确匹配），当硬件不支持请求值时直接返回错误。正确的做法是采用降级策略：先尝试精确匹配，失败后使用 dir = -1 或 dir = 1 进行舍入，并读取实际匹配值。

陷阱 2：采样率与时钟分频不匹配
在嵌入式平台中，采样率设置会触发时钟树重新计算。若 MCLK 无法整除目标采样率 × 通道数 × 位宽，可能导致时钟抖动或音频失真。建议使用硬件支持的“标准采样率”（如 8000 的整数倍）以避免分频误差。

4.4.1 采样率配置检查清单

检查项	说明	验证方法
硬件约束范围	确认编解码器和控制器支持的采样率列表	读取 `/proc/asound/card0/pcm0p/sub0/hw_params`
时钟分频可行性	MCLK / (rate × channels × bits) 是否为整数	计算分频系数，检查驱动日志
DMA 带宽余量	采样率 × 通道数 × 位宽 × 2（双缓冲）< DMA 最大带宽	使用 `perf stat` 监控 DMA 传输
应用层降级策略	是否实现了 dir 参数的回退逻辑	代码审查，测试非标准采样率
多设备同步	多个 PCM 设备是否使用同一时钟源	检查时钟树配置，使用同一 MCLK

4.5 内核态采样率约束注册

驱动开发者通过 snd_pcm_hw_constraint_list、snd_pcm_hw_constraint_range 等接口向 PCM 子系统注册采样率约束。以下是一个典型的驱动约束注册示例：

static const unsigned int sample_rates[] = {
    8000, 11025, 16000, 22050, 44100, 48000, 96000
};

static struct snd_pcm_hw_constraint_list constraints_rates = {
    .count = ARRAY_SIZE(sample_rates),
    .list = sample_rates,
    .mask = 0,
};

static int my_pcm_open(struct snd_pcm_substream *substream) {
    struct snd_pcm_runtime *runtime = substream->runtime;
    
    // 注册离散采样率约束
    snd_pcm_hw_constraint_list(runtime, 0,
        SNDRV_PCM_HW_PARAM_RATE, &constraints_rates);
    
    // 注册连续范围约束（备选）
    // snd_pcm_hw_constraint_minmax(runtime,
    //     SNDRV_PCM_HW_PARAM_RATE, 8000, 96000);
    
    return 0;
}

调优建议： 对于需要低功耗的场景，优先选择 48000 Hz 或 44100 Hz 等标准采样率，因为这些采样率通常对应优化的 PLL 分频比，能降低时钟抖动和功耗。对于语音应用，16000 Hz 或 8000 Hz 可显著减少 DMA 带宽占用。

4.6 本章小结

采样率配置是 PCM 参数协商的核心环节，受硬件约束列表或范围限制。
snd_pcm_hw_params_set_rate 通过 dir 参数支持精确匹配、向上/向下舍入三种策略。
内核匹配算法遵循“精确匹配 → 方向舍入 → 约束验证 → 写入参数”的流程。
实际开发中应实现降级策略，并关注时钟分频和 DMA 带宽的联合约束。