4. ALSA PCM DMA驱动框架

ALSA PCM 中间层通过 snd_pcm_ops 结构体将底层 DMA 硬件操作抽象为一组标准回调函数。驱动开发者只需填充该结构体并注册到 PCM 设备，即可完成音频数据流的硬件控制。本章深入解析 snd_pcm_ops 的每个成员、三个关键回调（hw_params、prepare、trigger）的执行语义，以及 DMA 缓冲区的管理策略。

4.1 snd_pcm_ops 结构体全景

snd_pcm_ops 定义在 include/sound/pcm.h 中，是 PCM 设备驱动的核心接口。下表列出所有回调函数及其典型用途：

4.2 hw_params 回调：硬件资源契约

hw_params 是驱动与 ALSA 核心协商硬件参数的唯一入口。ALSA 核心通过 snd_pcm_hw_params 结构体传递用户空间请求的参数集，驱动必须从中提取有效配置并分配 DMA 缓冲区。

static int my_pcm_hw_params(struct snd_pcm_substream *substream,
                             struct snd_pcm_hw_params *params)
{
    struct my_runtime *runtime = substream->runtime;
    struct snd_dma_buffer *dma_buf = &runtime->dma_buffer;
    size_t buffer_bytes, period_bytes;
    int err;

    /* 1. 提取参数 */
    buffer_bytes = params_buffer_bytes(params);
    period_bytes = params_period_bytes(params);

    /* 2. 分配 DMA 缓冲区（一致性内存） */
    err = snd_dma_alloc_pages(SNDRV_DMA_TYPE_DEV,
                              substream->dma_device,
                              buffer_bytes, dma_buf);
    if (err < 0)
        return err;

    /* 3. 配置 DMA 控制器：地址、大小、传输方向 */
    runtime->dma_addr = dma_buf->addr;
    runtime->dma_area = dma_buf->area;
    runtime->dma_bytes = buffer_bytes;
    runtime->period_size = period_bytes / frames_to_bytes(runtime, 1);

    /* 4. 设置硬件 FIFO 阈值、采样率分频器等 */
    my_set_samplerate(substream, params_rate(params));
    my_set_format(substream, params_format(params));

    return 0;
}

4.3 prepare 回调：传输前状态重置

prepare 在每次 trigger(START) 之前被调用，用于将 DMA 硬件恢复到初始就绪状态。典型操作包括：

• 重置 DMA 描述符链表：将 DMA 通道的当前描述符指针指向缓冲区起始位置。
• 清零硬件指针：将 DMA 控制器的传输计数器复位到 0。
• 配置中断阈值：设置 DMA 完成中断触发的周期边界（period boundary）。
• 预填充静音数据：对于 playback 方向，在缓冲区中写入初始静音帧，避免启动时的爆音。

static int my_pcm_prepare(struct snd_pcm_substream *substream)
{
    struct my_runtime *runtime = substream->runtime;

    /* 1. 重置 DMA 描述符环 */
    my_dma_reset_descriptors(substream);

    /* 2. 设置 DMA 传输参数：源/目的地址、传输宽度、突发长度 */
    my_dma_config(substream,
                  runtime->dma_addr,
                  runtime->dma_bytes,
                  runtime->period_size);

    /* 3. 使能周期中断 */
    my_dma_enable_period_irq(substream, runtime->period_size);

    /* 4. 对于 playback，填充静音 */
    if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK)
        my_fill_silence(runtime->dma_area, runtime->dma_bytes);

    return 0;
}

4.4 trigger 回调：DMA 启停控制

trigger 是唯一允许操作 DMA 硬件传输状态的回调。ALSA 核心通过 cmd 参数传递控制命令，驱动必须在原子上下文（atomic context）中执行，不能睡眠。

static int my_pcm_trigger(struct snd_pcm_substream *substream, int cmd)
{
    switch (cmd) {
    case SNDRV_PCM_TRIGGER_START:
        /* 使能 DMA 通道，启动传输 */
        my_dma_channel_enable(substream);
        my_dma_start(substream);
        break;
    case SNDRV_PCM_TRIGGER_STOP:
        /* 立即停止 DMA，等待当前传输完成 */
        my_dma_stop(substream);
        my_dma_channel_disable(substream);
        break;
    case SNDRV_PCM_TRIGGER_PAUSE_PUSH:
        my_dma_pause(substream);
        break;
    case SNDRV_PCM_TRIGGER_PAUSE_RELEASE:
        my_dma_resume(substream);
        break;
    default:
        return -EINVAL;
    }
    return 0;
}

4.5 DMA 缓冲区管理策略

DMA 缓冲区是音频数据在内存与硬件之间的传输载体。ALSA 提供 snd_dma_buffer 结构体统一管理，驱动需根据硬件特性选择合适的分配策略。

4.5.1 缓冲区分配方式

4.5.2 周期（Period）与缓冲区大小关系

DMA 缓冲区被划分为多个周期（period），每个周期传输完成触发一次中断。周期大小直接影响中断频率和延迟：

• 小周期（如 64 帧）：中断频率高，延迟低（适合低延迟录音/播放），但 CPU 占用率上升。
• 大周期（如 1024 帧）：中断频率低，CPU 开销小，但延迟增大（适合音乐播放）。
• 典型配置：缓冲区大小 = 周期大小 × 周期数（通常 2~4 个周期）。

4.6 回调执行流程与 DMA 中断关系

下图展示了从用户空间调用 snd_pcm_prepare 到 DMA 中断处理的完整回调链：

4.7 典型 DMA 缓冲区布局与指针管理

ALSA 使用两个指针管理 DMA 传输：

• hw_ptr（硬件指针）：由 DMA 控制器自动更新，表示当前传输到缓冲区的哪个位置。
• appl_ptr（应用指针）：由用户空间通过 snd_pcm_mmap_commit 更新，表示应用程序已写入/读取的位置。

驱动通过 pointer 回调返回当前 hw_ptr 值，ALSA 核心据此计算延迟和可用帧数：

static snd_pcm_uframes_t my_pcm_pointer(struct snd_pcm_substream *substream)
{
    struct my_runtime *runtime = substream->runtime;
    u32 dma_pos;

    /* 读取 DMA 控制器的当前传输位置（字节偏移） */
    dma_pos = my_dma_get_current_position(substream);

    /* 转换为帧数并返回 */
    return bytes_to_frames(runtime, dma_pos) % runtime->buffer_size;
}

4.8 本章小结