4. 硬件参数配置：snd_pcm_hw_params_t、访问模式、采样率、通道数、格式设置

硬件参数配置是音频设备从“可用”走向“可用且正确”的关键步骤。在 ALSA 框架中，snd_pcm_hw_params_t 结构体承载了所有硬件相关的配置信息，包括访问模式、采样率、通道数和样本格式。只有将这些参数与硬件实际能力对齐，DMA 传输才能高效、无差错地运行。

4.1 snd_pcm_hw_params_t 结构体与生命周期

snd_pcm_hw_params_t 是一个不透明结构体，用户空间通过指针操作，内核空间则将其映射为 struct snd_pcm_hw_params。它本质上是一个“参数掩码容器”，记录了设备支持的所有可能值以及当前选定的值。

4.2 访问模式：interleaved 与 non-interleaved

访问模式决定了多通道音频数据在内存中的排列方式。这是 DMA 传输布局的基础，必须在配置硬件参数时明确指定。

// 设置交错访问模式
snd_pcm_hw_params_t *params;
snd_pcm_hw_params_malloc(&params);
snd_pcm_hw_params_any(pcm, params);

// 关键：先设置访问模式，再设置其他参数
int err = snd_pcm_hw_params_set_access(pcm, params,
                                       SND_PCM_ACCESS_RW_INTERLEAVED);
if (err < 0) {
    fprintf(stderr, "无法设置访问模式: %s\n", snd_strerror(err));
    return err;
}

4.3 采样率、通道数与格式设置

这三个参数直接决定了 PCM 数据流的带宽和 DMA 传输的粒度。设置时通常使用“近似”函数，因为硬件可能不支持精确值，驱动会返回最接近的可用值。

4.3.1 采样率设置

unsigned int rate = 44100;
int dir = 0;  // dir: -1 向下近似, 0 最接近, 1 向上近似

err = snd_pcm_hw_params_set_rate_near(pcm, params, &rate, &dir);
if (err < 0) {
    fprintf(stderr, "设置采样率失败: %s\n", snd_strerror(err));
    return err;
}
printf("实际采样率: %u Hz\n", rate);

4.3.2 通道数设置

unsigned int channels = 2;
err = snd_pcm_hw_params_set_channels_near(pcm, params, &channels);
if (err < 0) {
    fprintf(stderr, "设置通道数失败: %s\n", snd_strerror(err));
    return err;
}
printf("实际通道数: %u\n", channels);

4.3.3 样本格式设置

snd_pcm_format_t format = SND_PCM_FORMAT_S16_LE;
err = snd_pcm_hw_params_set_format(pcm, params, format);
if (err < 0) {
    fprintf(stderr, "设置格式失败: %s\n", snd_strerror(err));
    return err;
}

4.4 完整配置示例与参数校验

以下代码展示了完整的硬件参数配置流程，包含必要的错误检查和实际值回读。

int configure_hw_params(snd_pcm_t *pcm) {
    snd_pcm_hw_params_t *params;
    int err;

    // 1. 分配并初始化
    snd_pcm_hw_params_malloc(&params);
    snd_pcm_hw_params_any(pcm, params);

    // 2. 设置访问模式
    err = snd_pcm_hw_params_set_access(pcm, params,
                                       SND_PCM_ACCESS_RW_INTERLEAVED);
    if (err < 0) goto error;

    // 3. 设置格式
    err = snd_pcm_hw_params_set_format(pcm, params,
                                       SND_PCM_FORMAT_S16_LE);
    if (err < 0) goto error;

    // 4. 设置采样率（近似）
    unsigned int rate = 48000;
    int dir = 0;
    err = snd_pcm_hw_params_set_rate_near(pcm, params, &rate, &dir);
    if (err < 0) goto error;

    // 5. 设置通道数（近似）
    unsigned int channels = 2;
    err = snd_pcm_hw_params_set_channels_near(pcm, params, &channels);
    if (err < 0) goto error;

    // 6. 提交配置
    err = snd_pcm_hw_params(pcm, params);
    if (err < 0) goto error;

    // 7. 校验实际值
    snd_pcm_uframes_t period_size, buffer_size;
    snd_pcm_hw_params_get_period_size(params, &period_size, &dir);
    snd_pcm_hw_params_get_buffer_size(params, &buffer_size);

    printf("配置完成: %u Hz, %u ch, period=%lu, buffer=%lu\n",
           rate, channels, period_size, buffer_size);

    snd_pcm_hw_params_free(params);
    return 0;

error:
    fprintf(stderr, "硬件参数配置失败: %s\n", snd_strerror(err));
    snd_pcm_hw_params_free(params);
    return err;
}

4.5 参数配置与 DMA 传输的协同关系

硬件参数配置直接影响 DMA 控制器的传输参数：

• 传输宽度： 由样本格式决定，DMA 必须配置为对应的字节宽度（如 16 位格式对应 2 字节传输）。
• 突发传输大小： 通常与 period_size 对齐，DMA 每次中断传输一个 period 的数据量。
• 地址递增模式： 交错模式下 DMA 地址递增步长为 通道数 × 样本字节数；非交错模式下每个通道的缓冲区独立递增。
• 循环缓冲： buffer_size 决定了 DMA 循环缓冲区的总大小，必须与 DMA 控制器的地址回绕能力匹配。