V4L2框架videobuf2缓冲区队列映射调优 - 第1节

1.1 V4L2 历史演进与设计哲学

Video for Linux Two（V4L2）是 Linux 内核中视频设备驱动的标准框架，自 2002 年合并入主线内核以来，经历了从模拟电视采集到高清摄像头、从单一视频流到多平面 DMA 的演进。V4L2 的设计核心是 统一设备抽象 与 零拷贝数据路径，为应用层提供与硬件无关的编程接口。

1.2 核心数据结构

V4L2 框架围绕三个核心数据结构构建：video_device、v4l2_device 和 videobuf2_queue。它们之间的关系决定了驱动与用户空间的交互路径。

1.2.1 video_device

代表一个用户空间可见的设备节点（如 /dev/video0）。它封装了文件操作函数集（v4l2_file_operations）和 IOCTL 分发逻辑。

struct video_device {
    const struct v4l2_file_operations *fops;
    struct v4l2_device *v4l2_dev;
    struct vb2_queue *queue;        /* 关联的缓冲区队列 */
    struct device *dev;             /* 内核设备 */
    unsigned long flags;
    /* ... */
};

1.2.2 v4l2_device

作为顶层父设备，管理多个子节点（如同时拥有 video 和 metadata 节点）。提供 dev 指针用于 DMA 和电源管理。

1.2.3 videobuf2_queue

缓冲区管理的核心结构，负责内存分配、入队/出队、同步和 DMA 映射。驱动通过 vb2_ops 回调与硬件交互。

struct vb2_queue {
    unsigned int            type;       /* V4L2_BUF_TYPE_VIDEO_CAPTURE 等 */
    unsigned int            io_modes;   /* VB2_MMAP | VB2_USERPTR | VB2_DMABUF */
    const struct vb2_ops    *ops;       /* 驱动回调 */
    struct vb2_buffer       *bufs[VB2_MAX_FRAME]; /* 缓冲区数组 */
    /* ... */
};

1.3 设备模型与注册流程

V4L2 设备遵循 Linux 设备模型：驱动探测（probe）时分配 video_device，设置 v4l2_device 和 vb2_queue，最后调用 video_register_device() 注册到内核。用户空间通过 open() 获取文件描述符，通过 ioctl() 查询能力和控制流。

1.4 用户空间接口

V4L2 用户空间接口以 ioctl() 系统调用为核心，分为三大类：

• 查询类： VIDIOC_QUERYCAP（能力）、VIDIOC_ENUM_FMT（格式枚举）、VIDIOC_G_PARM（参数获取）
• 控制类： VIDIOC_S_FMT（设置格式）、VIDIOC_S_PARM（设置帧率）、VIDIOC_STREAMON/OFF（流开关）
• 缓冲区类： VIDIOC_REQBUFS（申请缓冲区）、VIDIOC_QBUF（入队）、VIDIOC_DQBUF（出队）

1.4.1 标准缓冲区操作流程

/* 用户空间典型代码片段 */
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);
    /* mmap 映射 */
    buffers[i].start = mmap(NULL, buf.length,
                            PROT_READ | PROT_WRITE, MAP_SHARED,
                            fd, buf.m.offset);
    /* 入队 */
    ioctl(fd, VIDIOC_QBUF, &buf);
}
ioctl(fd, VIDIOC_STREAMON, &type);