1. V4L2 框架概述

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

Video4Linux2 (V4L2) 是 Linux 内核中视频设备驱动的标准框架，位于多媒体子系统的核心层。它向上提供统一的字符设备接口（/dev/videoX），向下对接各类硬件设备（摄像头、采集卡、编解码器）。

1.2 三大核心数据结构的关系

V4L2 驱动的实现围绕三个核心数据结构展开：video_device、v4l2_device 和 vb2_queue。理解它们之间的关系是编写 V4L2 驱动的基础。

1.3 video_device 详解

video_device 是 V4L2 框架对外暴露的接口，每个 /dev/videoX 节点对应一个 video_device 实例。其核心成员包括：

struct video_device {
    const struct v4l2_file_operations *fops;  // 字符设备操作函数
    struct v4l2_device *v4l2_dev;             // 指向所属顶层设备
    struct vb2_queue *queue;                  // 指向缓冲区队列
    struct device *dev;                       // 内核设备结构体
    v4l2_std_id tvnorms;                      // 支持的电视制式
    unsigned int device_caps;                 // 设备能力标志
    struct media_entity entity;               // 媒体实体（用于 MC 框架）
    // ... 其他成员
};

1.4 v4l2_device 详解

v4l2_device 是 V4L2 驱动的顶层容器，负责管理所有子设备（subdev）和共享资源。在复杂摄像头系统中，一个 v4l2_device 可能包含多个 video_device（如主视频流、元数据流）和多个子设备（如 sensor、ISP、AF 控制器）。

struct v4l2_device {
    struct device *dev;                       // 父设备
    struct list_head subdevs;                 // 子设备链表
    spinlock_t lock;                          // 内部锁
    char name[V4L2_DEVICE_NAME_SIZE];         // 设备名称
    struct v4l2_ctrl_handler *ctrl_handler;   // 控制处理器
    // ... 其他成员
};

1.5 vb2_queue 详解

vb2_queue 是 V4L2 缓冲区管理的核心，负责 DMA 缓冲区的分配、入队、出队和回收。它是本课程后续章节的重点，这里先给出其基本结构：

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 设备
    struct mutex lock;                        // 队列锁
    unsigned int min_buffers_needed;          // 最小缓冲区数量
    // ... 其他成员
};

1.6 三者的协作流程

从驱动加载到视频流启动，三大数据结构的协作流程如下：

1. 驱动加载阶段： 在 probe() 中依次完成：
   • 调用 v4l2_device_register() 注册顶层设备
   • 初始化 vb2_queue，设置 ops 和 mem_ops
   • 初始化 video_device，关联 v4l2_dev 和 queue
   • 调用 video_register_device() 创建 /dev/videoX
2. 应用打开阶段： 应用 open("/dev/videoX") 触发 video_device->fops->open()
3. 缓冲区申请阶段： 应用调用 VIDIOC_REQBUFS，内核通过 video_device->queue 找到 vb2_queue，调用 vb2_core_reqbufs() 分配 DMA 缓冲区
4. 流控制阶段： 应用调用 VIDIOC_STREAMON，vb2_queue 调用驱动回调 start_streaming() 启动硬件传输

1.7 本章小结