4. videobuf2 内存模型：连续内存、分散内存、用户态指针、dma-contig、dma-sg

videobuf2（vb2）是 V4L2 框架中负责缓冲区管理的核心层，它向上对接应用层的缓冲区请求，向下对接驱动层的硬件 DMA 操作。理解 vb2 的内存模型，是编写高效、稳定摄像头驱动的关键。本章将深入剖析 vb2 支持的四种主要内存模型，并重点讲解与硬件 DMA 协同工作的两种核心模式：dma-contig 和 dma-sg。

4.1 四种内存模型概览

vb2 框架抽象了四种标准的内存模型，每种模型对应不同的内存分配和映射策略。下表从分配器、物理连续性、适用场景等维度进行了对比。

4.2 连续内存模型 (dma-contig)

dma-contig 模型分配的是物理上连续的内存块，并通过 dma_alloc_coherent 或 dma_alloc_attrs 接口获得。这种模型最大的优点是：DMA 引擎无需处理复杂的地址转换表，只需提供一个起始地址和传输长度即可开始传输。

4.2.1 工作原理

1. 分配： 驱动调用 vb2_dma_contig_memops->alloc()，内部调用 dma_alloc_coherent(dev, size, &dma_handle, GFP_KERNEL)。该函数返回一个 CPU 可访问的虚拟地址 vaddr，并通过 dma_handle 返回 DMA 总线地址。
2. 映射： 由于内存是物理连续的，且 dma_alloc_coherent 已经保证了 CPU 和 DMA 视角的一致性，驱动可以直接将 dma_handle 编程到 DMA 控制器的源/目的地址寄存器中。
3. 队列： 驱动将缓冲区加入硬件队列时，只需传递 dma_handle 和 size。

4.2.2 适用场景与限制

• 优点： DMA 编程简单，硬件要求低，适合大多数嵌入式 SoC 内置的摄像头接口。
• 缺点： 在系统长时间运行后，分配大块物理连续内存可能失败（内存碎片化）。分配大小受限于系统 CMA 区域大小。

4.2.3 dma-contig 内存模型 SVG 图

4.3 分散内存模型 (dma-sg)

dma-sg 模型允许缓冲区由多个物理上不连续的页面组成。DMA 引擎通过一个“分散/聚集表”（Scatter-Gather List）来访问这些分散的内存块。这种模型极大地缓解了内存碎片化问题，并允许分配非常大的缓冲区。

4.3.1 工作原理

1. 分配： 驱动调用 vb2_dma_sg_memops->alloc()，内部分配一组页面（通常通过 alloc_pages 或从 CMA 区域获取），并构建一个 struct sg_table。
2. 映射： 驱动调用 dma_map_sg(dev, sg_table->sgl, sg_table->nents, direction)。这个函数为每个 SG 条目填充 DMA 总线地址和长度，并返回有效的 DMA 条目数。
3. 队列： 驱动将 sg_table 的 DMA 地址和长度列表编程到支持 SG 模式的 DMA 控制器中。DMA 控制器会自动遍历 SG 表，完成整个缓冲区的传输。

4.3.2 适用场景与限制

• 优点： 内存分配成功率更高，支持大缓冲区，适合高性能设备。
• 缺点： 需要 DMA 控制器硬件支持 SG 模式；驱动编程更复杂；DMA 映射和取消映射有开销。

4.3.3 dma-sg 内存模型 SVG 图

4.4 用户态指针模型 (User Pointer)

用户态指针模型允许应用程序直接提供用户空间的内存地址作为视频缓冲区。vb2 框架通过 get_user_pages 将这些用户页锁定在内存中，并获取其物理页，然后进行 DMA 映射。

• 优点： 实现真正的零拷贝，应用程序可以直接处理视频数据，无需额外的内核缓冲区拷贝。
• 缺点： 内存锁定开销大；用户提供的地址必须满足 DMA 对齐要求；安全性较低（用户可能提供无效地址）。
• 典型用例： 软件编码器、图像处理库（如 OpenCV）直接操作摄像头数据。

4.5 如何选择：dma-contig vs dma-sg

在驱动开发中，选择哪种模型通常取决于硬件能力。下表提供了一个决策参考：

4.6 关键代码模式：初始化内存操作符

在 vb2 驱动的 queue_setup 回调中，需要指定使用的内存模型。这是驱动与 vb2 框架约定的第一步。

// 示例：在驱动中使用 dma-contig 模型
static int my_v4l2_queue_setup(struct vb2_queue *vq,
                                unsigned int *nbuffers,
                                unsigned int *nplanes,
                                unsigned int sizes[],
                                struct device *alloc_devs[])
{
    // 指定分配设备（用于 DMA API）
    alloc_devs[0] = my_dev->dev;
    // 指定缓冲区数量
    *nbuffers = 4;
    // 指定单平面大小（例如 1920x1080 YUYV）
    sizes[0] = 1920 * 1080 * 2;
    *nplanes = 1;
    return 0;
}

// 在初始化 vb2_queue 时设置内存操作符
static struct vb2_queue my_video_q = {
    .type           = V4L2_BUF_TYPE_VIDEO_CAPTURE,
    .io_modes       = VB2_MMAP | VB2_DMABUF,
    .buf_struct_size = sizeof(struct my_buffer),
    .ops            = &my_v4l2_ops,
    .mem_ops        = &vb2_dma_contig_memops, // <-- 选择 dma-contig
    .drv_priv       = &my_dev,
    .timestamp_flags = V4L2_BUF_FLAG_TIMESTAMP_MONOTONIC,
};

如果选择 dma-sg 模型，只需将 .mem_ops 替换为 &vb2_dma_sg_memops。vb2 框架会自动处理后续的分配、映射和队列管理。