2. videobuf2 核心概念

videobuf2（vb2）是 V4L2 框架中负责缓冲区管理的核心模块，它抽象了从驱动到用户空间的数据传递路径。理解 vb2 的三大核心概念——队列结构、缓冲区状态机和内存模型——是进行缓冲区映射调优的前提。

2.1 vb2_queue 结构体

struct vb2_queue 是 videobuf2 框架中最核心的数据结构，它代表一个缓冲区队列实例。每个视频设备节点（如 /dev/video0）通常对应一个或多个 vb2_queue，用于管理输入（capture）或输出（output）方向的缓冲区。

// 驱动中初始化 vb2_queue 的典型代码片段
struct vb2_queue q;

q.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
q.io_modes = VB2_MMAP | VB2_USERPTR | VB2_DMABUF;
q.buf_struct_size = sizeof(struct my_driver_buffer);
q.min_buffers_needed = 2;
q.ops = &my_vb2_ops;
q.mem_ops = &vb2_dma_contig_memops;

ret = vb2_queue_init(&q);
if (ret)
    dev_err(dev, "vb2_queue_init failed: %d\n", ret);

2.2 Buffer 状态机

vb2 中的每个缓冲区都遵循严格的状态机转换。理解状态转换是调试缓冲区问题的基础。状态机确保缓冲区在用户空间和内核空间之间安全传递。

2.3 内存模型

vb2 支持三种内存模型，分别对应不同的数据传递场景。选择合适的内存模型直接影响系统吞吐量和 CPU 占用。

2.3.1 MMAP 模型

MMAP 是最常用的模型。内核在驱动初始化时分配 DMA 缓冲区，用户空间通过 mmap() 将缓冲区映射到自己的地址空间。该模型在大多数 SoC 平台上实现了从硬件到用户空间的零拷贝。

// 用户空间 MMAP 流程（伪代码）
struct v4l2_requestbuffers req = {0};
req.count = 4;
req.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
req.memory = V4L2_MEMORY_MMAP;
ioctl(fd, VIDIOC_REQBUFS, &req);

for (i = 0; i < req.count; i++) {
    struct v4l2_buffer buf = {0};
    buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
    buf.memory = V4L2_MEMORY_MMAP;
    buf.index = i;
    ioctl(fd, VIDIOC_QUERYBUF, &buf);
    // 通过 buf.m.offset 进行 mmap
    buffers[i].addr = mmap(NULL, buf.length,
                           PROT_READ | PROT_WRITE, MAP_SHARED,
                           fd, buf.m.offset);
}

2.3.2 USERPTR 模型

USERPTR 允许用户空间分配内存，然后将指针传递给内核。内核需要将这些用户页 pin 住（防止被换出），并建立硬件可访问的 DMA 映射。该模型在用户需要管理自己的内存池时非常有用。

2.3.3 DMABUF 模型

DMABUF 是最高级的内存模型，它通过 DMA-BUF 文件描述符在不同设备驱动之间共享缓冲区。例如，ISP 输出的图像可以直接传递给 GPU 或编码器，而无需经过 CPU 拷贝。

// DMABUF 导入示例（驱动侧）
static int my_buf_prepare(struct vb2_buffer *vb)
{
    struct vb2_v4l2_buffer *vbuf = to_vb2_v4l2_buffer(vb);
    struct my_driver *dev = vb2_get_drv_priv(vb->vb2_queue);

    // 从 DMABUF 文件描述符获取 DMA 地址
    dma_buf = dma_buf_get(vbuf->dmabuf_fd);
    if (IS_ERR(dma_buf))
        return PTR_ERR(dma_buf);

    // 将 dma_buf 映射到设备地址空间
    sg_table = dma_buf_map_attachment(dev->attach, DMA_FROM_DEVICE);
    if (IS_ERR(sg_table)) {
        dma_buf_put(dma_buf);
        return PTR_ERR(sg_table);
    }

    // 设置硬件描述符指向 sg_table
    // ...
    return 0;
}