4. V4L2框架核心数据结构：struct video_device、struct v4l2_device、struct vb2_queue

V4L2（Video for Linux 2）框架是Linux内核中视频设备驱动的标准抽象层。理解其三大核心数据结构——struct video_device、struct v4l2_device和struct vb2_queue——是编写任何视频驱动（包括JPEG编码器和MIPI CSI接收器）的基础。这三者分别负责设备节点管理、顶层设备实例化以及缓冲区队列管理，构成了驱动程序的骨架。

4.1 核心数据结构关系总览

下图展示了三个核心数据结构在V4L2驱动中的协作关系：v4l2_device作为顶层容器，包含video_device用于注册字符设备节点，而vb2_queue则挂载在video_device中，负责视频帧缓冲区的分配与流转。

4.2 struct v4l2_device — 顶层设备实例

struct v4l2_device是V4L2驱动的根结构体，代表一个物理设备实例。它负责管理该设备下的所有子设备（subdev）和视频节点，并提供设备级别的初始化与注销接口。

4.2.1 核心字段解析

4.2.2 初始化与注销流程

// 初始化 v4l2_device
struct v4l2_device v4l2_dev;
v4l2_device_register(parent_dev, &v4l2_dev);

// 注册子设备或 video_device
// ...

// 注销时释放资源
v4l2_device_unregister(&v4l2_dev);

4.3 struct video_device — 字符设备节点

struct video_device是用户空间与内核驱动交互的桥梁。它注册为/dev/videoX字符设备，用户程序通过open()、ioctl()、mmap()等系统调用与驱动通信。

4.3.1 关键字段与用途

4.3.2 注册与注销示例

struct video_device vdev;

// 设置文件操作和ioctl操作
vdev.fops = &my_fops;
vdev.ioctl_ops = &my_ioctl_ops;
vdev.v4l2_dev = &v4l2_dev;
vdev.queue = &vb2_q;
vdev.device_caps = V4L2_CAP_VIDEO_CAPTURE | V4L2_CAP_STREAMING;

// 注册video_device
video_register_device(&vdev, VFL_TYPE_VIDEO, -1);

// 注销
video_unregister_device(&vdev);

4.4 struct vb2_queue — 缓冲区队列管理

struct vb2_queue是V4L2框架中视频缓冲区管理的核心，它实现了从用户空间申请缓冲区、内核态填充数据、再返还给用户空间的完整生命周期管理。对于JPEG编码器，vb2_queue负责管理输入原始帧和输出编码数据的缓冲区。

4.4.1 核心字段与回调函数

4.4.2 struct vb2_ops 回调函数集

驱动必须实现以下回调，vb2框架会在合适的时机调用它们：

4.4.3 vb2_queue 初始化示例

struct vb2_queue vb2_q;

vb2_q.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
vb2_q.io_modes = VB2_MMAP | VB2_DMABUF;
vb2_q.ops = &my_vb2_ops;
vb2_q.mem_ops = &vb2_dma_contig_memops;
vb2_q.buf_struct_size = sizeof(struct my_buffer_private);
vb2_q.min_buffers_needed = 2;
vb2_q.dev = &pdev->dev;  // DMA设备

vb2_queue_init(&vb2_q);

4.5 三者协作流程：从设备注册到缓冲区流转

下图展示了从驱动初始化到用户空间获取一帧数据的完整协作流程：

4.6 三者在JPEG编码与MIPI CSI场景中的角色

4.7 本章小结

• struct v4l2_device：顶层容器，管理设备生命周期和子设备链表，是驱动的“根”。
• struct video_device：用户空间接口，注册为字符设备节点，承载ioctl_ops和fops。
• struct vb2_queue：缓冲区管理引擎，通过回调函数集与硬件交互，实现高效的流式I/O。
• 三者通过指针相互关联，形成“设备 → 节点 → 队列”的层次化架构，是V4L2驱动设计的基石。