1. V4L2 框架概述

1.1 V4L2 在 Linux 多媒体子系统中的位置

Video4Linux2 (V4L2) 是 Linux 内核中为视频设备提供统一驱动框架和用户空间 API 的核心子系统。它位于内核多媒体栈的中间层，向上对接应用程序，向下抽象各类硬件设备。

V4L2 与周边子系统的协作关系如下表所示：

1.2 核心数据结构：struct video_device

struct video_device 是 V4L2 驱动中代表一个视频设备节点的核心结构体。每个注册成功的 video_device 会在 /dev 下生成对应的设备文件（如 /dev/video0）。

struct video_device {
    const struct v4l2_file_operations *fops;   // 用户空间文件操作回调
    struct device dev;                          // 内核通用设备结构
    struct cdev cdev;                           // 字符设备
    struct v4l2_device *v4l2_dev;               // 父级 V4L2 设备
    struct media_entity entity;                 // Media Controller 实体
    struct vb2_queue *queue;                    // 指向 vb2_queue 实例
    unsigned long flags;                        // 设备标志位
    int index;                                  // 设备节点编号
    // ... 其他字段
};

video_device 的注册流程通常包含以下步骤：

1. 分配： 使用 video_device_alloc() 或静态定义
2. 初始化： 设置 fops、v4l2_dev、queue、entity 等字段
3. 设置设备类型： 通过 vdev->device_caps 声明 V4L2_CAP_VIDEO_CAPTURE / V4L2_CAP_STREAMING 等能力
4. 注册： 调用 video_register_device() 或 __video_register_device()
5. 清理： 模块卸载时调用 video_unregister_device() + video_device_release()

1.3 核心数据结构：struct vb2_queue

struct vb2_queue 是 Videobuf2 框架的核心，负责视频缓冲区的分配、管理、入队出队和 DMA 操作。它是 V4L2 驱动性能优化的主战场。

struct vb2_queue {
    enum v4l2_buf_type          type;           // 缓冲类型 (V4L2_BUF_TYPE_VIDEO_CAPTURE 等)
    unsigned int                io_modes;       // 支持的 I/O 模式 (VB2_MMAP | VB2_USERPTR | VB2_DMABUF)
    const struct vb2_ops        *ops;           // 驱动回调函数集
    const struct vb2_mem_ops    *mem_ops;       // 内存操作函数集
    struct device               *dev;           // DMA 设备
    unsigned int                min_buffers_needed; // 最小缓冲数量
    unsigned int                buf_struct_size;    // 自定义 buffer 结构体大小
    // ... 内部状态字段
};

struct vb2_ops 是驱动必须实现的回调接口，定义了缓冲区的完整生命周期：

1.4 V4L2 驱动模型与注册流程

一个完整的 V4L2 驱动通常遵循以下分层模型：

• 顶层： 实现 struct video_device 和 struct v4l2_file_operations，处理用户空间 ioctl
• 中间层： 实现 struct vb2_queue 和 struct vb2_ops，管理缓冲区生命周期
• 底层： 实现硬件控制（I2C/SPI 读写 sensor 寄存器、配置 DMA 描述符、中断处理）

驱动注册的核心代码片段示例：

static int my_v4l2_probe(struct platform_device *pdev)
{
    struct video_device *vdev;
    struct vb2_queue *q;
    int ret;

    // 1. 分配 video_device
    vdev = video_device_alloc();
    if (!vdev)
        return -ENOMEM;

    // 2. 设置文件操作
    vdev->fops = &my_fops;
    vdev->v4l2_dev = &my_v4l2_dev;
    vdev->device_caps = V4L2_CAP_VIDEO_CAPTURE | V4L2_CAP_STREAMING;

    // 3. 初始化 vb2_queue
    q = devm_kzalloc(&pdev->dev, sizeof(*q), GFP_KERNEL);
    q->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
    q->io_modes = VB2_MMAP | VB2_USERPTR | VB2_DMABUF;
    q->ops = &my_vb2_ops;
    q->mem_ops = &vb2_dma_contig_memops;
    q->dev = &pdev->dev;
    q->min_buffers_needed = 2;
    ret = vb2_queue_init(q);
    vdev->queue = q;

    // 4. 注册 video_device
    ret = video_register_device(vdev, VFL_TYPE_VIDEO, -1);
    if (ret) {
        video_device_release(vdev);
        return ret;
    }

    platform_set_drvdata(pdev, vdev);
    return 0;
}

1.5 性能优化切入点

从 V4L2 框架层面看，性能优化的关键路径集中在以下三个维度：