4. snd_pcm_hardware 结构体：硬件参数描述、period 的概念、buffer_size 与 period_size 的关系

在 ALSA 驱动中，snd_pcm_hardware 是连接物理音频硬件与 PCM 中间层的核心描述结构体。它定义了硬件支持的能力边界，包括采样率、数据格式、通道数以及最重要的内存传输参数——buffer_size 和 period_size。理解这两个参数及其关系，是掌握 ALSA 内存管理与中断驱动模型的关键。

4.1 snd_pcm_hardware 结构体概述

该结构体通常作为 PCM 设备运行时 runtime->hw 的静态模板，驱动在 open 回调中将其赋值给 PCM 子流。它定义了硬件能力的“最小/最大”范围，应用程序通过 hw_params 在此范围内选择具体值。

4.2 Period 的概念与中断驱动模型

Period（周期）是 ALSA 中硬件中断触发的粒度单位。当 DMA 控制器完成一个 period 的数据传输后，会触发硬件中断，驱动在中断处理中更新 appl_ptr（应用程序指针）并唤醒等待的读/写线程。

• 中断频率：period_size 越小，中断越频繁，CPU 占用越高，但延迟越低。
• 传输粒度：应用程序每次 read/write 或 mmap 提交的数据量不必等于 period_size，但硬件中断只在 period 边界触发。
• 环形缓冲区划分：整个 DMA 缓冲区被划分为 N 个 period，每个 period 是连续的物理内存块。

4.3 buffer_size 与 period_size 的关系

两者通过 periods（周期数）建立数学关系：

buffer_size = period_size * periods

其中 buffer_size 和 period_size 的单位是 帧（frame），而非字节。1 帧 = 通道数 × 采样字节数。例如：16 位立体声（2 通道），1 帧 = 2 × 2 = 4 字节。

4.4 参数约束与配置流程

应用程序通过 snd_pcm_hw_params_set_* 系列函数设置参数，ALSA 核心层会进行约束检查：

1. 设置 buffer_size：应用程序指定期望的缓冲区大小（帧数）。
2. 设置 period_size：应用程序指定 period 大小，或通过 period_time 间接指定。
3. 自动计算 periods：核心层计算 periods = buffer_size / period_size，并检查是否在 periods_min ~ periods_max 范围内。
4. 对齐约束：部分硬件要求 period_size 是 2 的幂次或特定对齐值，核心层通过 snd_pcm_hw_constraint_* 函数进行规整。

// 典型配置代码片段（用户空间）
snd_pcm_hw_params_t *params;
snd_pcm_uframes_t buffer_size = 4096;
snd_pcm_uframes_t period_size = 1024;

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);
snd_pcm_hw_params_set_rate_near(handle, params, &rate, 0);
snd_pcm_hw_params_set_buffer_size_near(handle, params, &buffer_size);
snd_pcm_hw_params_set_period_size_near(handle, params, &period_size, 0);
snd_pcm_hw_params(handle, params);

4.5 内存布局与指针关系

DMA 环形缓冲区中，hw_ptr（硬件指针）和 appl_ptr（应用程序指针）共同维护数据流状态：

• hw_ptr：由 DMA 控制器在每次 period 完成后更新，指向硬件即将读取/写入的位置。
• appl_ptr：由应用程序在 write/mmap 提交后更新，指向应用程序可写入/读取的位置。
• avail_min：应用程序等待的最小可用帧数，通常设置为 period_size，确保每次唤醒都能处理一个完整 period。

4.6 实际应用中的参数选择策略

不同场景对 buffer_size 和 period_size 的权衡不同，以下为常见配置参考：

4.7 内核驱动中的约束实现

驱动开发者通过 snd_pcm_hw_constraint_* 系列函数在 open 回调中注册约束：

static const struct snd_pcm_hardware my_hw = {
    .info = SNDRV_PCM_INFO_MMAP | SNDRV_PCM_INFO_INTERLEAVED,
    .formats = SNDRV_PCM_FMTBIT_S16_LE,
    .rates = SNDRV_PCM_RATE_48000,
    .rate_min = 48000,
    .rate_max = 48000,
    .channels_min = 2,
    .channels_max = 2,
    .buffer_bytes_max = 32768,   // 最大 32KB 缓冲区
    .period_bytes_min = 256,     // 最小 period 256 字节
    .period_bytes_max = 8192,    // 最大 period 8KB
    .periods_min = 2,            // 至少 2 个 period
    .periods_max = 16,           // 最多 16 个 period
};

static int my_pcm_open(struct snd_pcm_substream *substream)
{
    struct snd_pcm_runtime *runtime = substream->runtime;
    runtime->hw = my_hw;

    // 额外约束：period_size 必须是 64 字节的倍数
    snd_pcm_hw_constraint_step(runtime, 0,
        SNDRV_PCM_HW_PARAM_PERIOD_BYTES, 64);

    // 约束：buffer_size 必须是 period_size 的整数倍
    snd_pcm_hw_constraint_integer(runtime,
        SNDRV_PCM_HW_PARAM_PERIODS);

    return 0;
}