3. Camera 子系统架构：V4L2 框架简介、video_device、vb2_buffer 核心数据结构

Camera 子系统是嵌入式 Linux 中最为复杂的驱动子系统之一，它需要同时处理硬件控制、数据流管理、内存管理以及用户空间交互。V4L2（Video for Linux 2）框架为这一复杂性提供了标准化的抽象层。本章将深入剖析 V4L2 的核心组件：video_device 作为设备节点抽象，以及 vb2_buffer 作为 DMA Buffer 管理的基石。

3.1 V4L2 框架概述与分层架构

V4L2 框架采用分层设计，将硬件控制与数据流解耦。其核心思想是：驱动开发者只需实现底层的硬件操作回调，而框架负责处理设备节点、系统调用、内存管理以及 Buffer 队列等通用逻辑。

V4L2 框架的软件架构可分为以下四个层次：

3.2 video_device：设备节点抽象

video_device 是 V4L2 框架中代表一个视频设备节点的核心结构体。它封装了字符设备的所有属性，并为上层提供统一的接口。

3.2.1 核心结构体定义

struct video_device {
    const struct v4l2_file_operations *fops;  // 文件操作回调
    struct device dev;                        // 内核设备结构
    struct cdev *cdev;                        // 字符设备
    struct v4l2_device *v4l2_dev;             // 父 V4L2 设备
    struct vb2_queue *queue;                  // 关联的 vb2 队列
    unsigned int index;                       // 设备节点索引
    int minor;                                // 次设备号
    // ... 其他字段
};

3.2.2 注册流程

1. 分配 video_device：使用 video_device_alloc() 或静态定义。
2. 设置回调：填充 v4l2_file_operations 中的 open/release/ioctl/mmap/poll。
3. 关联 vb2_queue：将 queue 指针指向已初始化的 vb2_queue。
4. 注册设备：调用 video_register_device()，指定 VFL_TYPE_VIDEO 等类型。

3.2.3 与用户空间的交互路径

当用户空间执行 open("/dev/video0") 时，内核通过 video_device 的 cdev 找到对应的 fops，进而调用驱动实现的回调函数。这一路径是 V4L2 框架与用户空间交互的唯一通道。

3.3 vb2_buffer：Buffer 管理的基石

vb2_buffer 是 Videobuf2 框架中描述单个 Buffer 的核心数据结构。它封装了 Buffer 的状态、内存信息、DMA 地址以及队列指针，是 DMA Buffer 共享机制的直接操作对象。

3.3.1 核心结构体定义

struct vb2_buffer {
    struct vb2_queue      *vb2_queue;   // 所属队列
    unsigned int          index;        // Buffer 索引
    unsigned int          type;         // Buffer 类型 (V4L2_BUF_TYPE_VIDEO_CAPTURE)
    unsigned int          memory;       // 内存类型 (V4L2_MEMORY_MMAP / DMABUF / USERPTR)
    struct vb2_plane      planes[VB2_MAX_PLANES]; // 平面数组
    enum vb2_buffer_state state;        // 当前状态
    // ... 其他字段
};

struct vb2_plane {
    void                  *mem_priv;    // 内存私有数据
    struct dma_buf        *dbuf;        // dma_buf 对象 (DMABUF 模式)
    unsigned int          dbuf_fd;      // dma_buf 文件描述符
    dma_addr_t            dma_addr;     // DMA 地址
    unsigned long         size;         // 平面大小
};

3.3.2 Buffer 状态机

每个 vb2_buffer 在生命周期中会经历以下状态转换：

3.3.3 三种内存模式对比

Videobuf2 支持三种内存管理模式，它们直接决定了 DMA Buffer 的共享方式：

3.4 vb2_queue：队列管理与回调机制

vb2_queue 是 Videobuf2 框架中管理 Buffer 队列的核心结构。驱动通过实现 vb2_ops 回调来与框架交互。

3.4.1 核心回调函数

struct vb2_ops {
    int (*queue_setup)(struct vb2_queue *q,
                       unsigned int *num_buffers,
                       unsigned int *num_planes,
                       unsigned int sizes[],
                       struct device *alloc_devs[]);
    void (*buf_queue)(struct vb2_buffer *vb);
    int (*start_streaming)(struct vb2_queue *q, unsigned int count);
    void (*stop_streaming)(struct vb2_queue *q);
    // ... 其他回调
};

3.4.2 初始化流程示例

static struct vb2_ops sensor_vb2_ops = {
    .queue_setup     = sensor_queue_setup,
    .buf_queue       = sensor_buf_queue,
    .start_streaming = sensor_start_streaming,
    .stop_streaming  = sensor_stop_streaming,
};

static int sensor_probe(struct platform_device *pdev) {
    struct sensor_dev *sensor = devm_kzalloc(&pdev->dev, sizeof(*sensor), GFP_KERNEL);
    struct vb2_queue *q = &sensor->vb2_vidq;

    q->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
    q->io_modes = VB2_MMAP | VB2_DMABUF;  // 支持 MMAP 和 DMABUF
    q->ops = &sensor_vb2_ops;
    q->mem_ops = &vb2_dma_contig_memops;  // 使用连续 DMA 内存
    q->drv_priv = sensor;
    q->buf_struct_size = sizeof(struct sensor_buffer);
    q->timestamp_flags = V4L2_BUF_FLAG_TIMESTAMP_MONOTONIC;

    vb2_queue_init(q);
    // ... 注册 video_device
}

3.5 本章小结

• V4L2 框架 通过分层架构将硬件控制与数据流管理解耦，Videobuf2 层是 DMA Buffer 共享的核心。
• video_device 是设备节点的抽象，负责与用户空间的交互，其 queue 指针关联了底层的 Buffer 管理。
• vb2_buffer 是 Buffer 管理的基石，其 vb2_plane 中的 dbuf 和 dbuf_fd 是实现跨设备零拷贝共享的关键字段。
• DMABUF 模式 是摄像头驱动优化的核心方向，它允许 Buffer 在 ISP、GPU、显示控制器之间直接传递，无需 CPU 介入。