1. V4L2 框架概述

V4L2（Video for Linux 2）是 Linux 内核中负责视频设备驱动的标准框架，位于多媒体子系统的核心层。它为摄像头、电视调谐器、编解码器等设备提供统一的用户空间接口（/dev/videoX），并管理从采集到输出的整个数据流。理解 V4L2 在多媒体子系统中的位置及其核心数据结构的关系，是开发图像裁剪、YUV 转换与 DMA 传输功能的基础。

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

Linux 多媒体子系统采用分层架构，V4L2 位于中间层，向上对接应用层，向下抽象硬件驱动。下表展示了各层的主要职责与典型组件：

下图展示了 V4L2 在多媒体子系统中的分层关系与数据流向：

1.2 核心数据结构关系图

V4L2 驱动中三个最核心的数据结构是 video_device、v4l2_device 和 vb2_queue。它们分别负责设备节点管理、顶层设备抽象和视频缓冲队列控制。理解三者之间的组合与引用关系，是编写正确驱动的前提。

1.2.1 数据结构职责对比

1.2.2 数据结构关系图

下图展示了 video_device、v4l2_device 和 vb2_queue 之间的组合与引用关系：

1.3 数据结构组合的典型代码模式

在实际驱动中，这三个数据结构通常通过一个自定义的“驱动私有结构体”组合在一起。以下是一个典型的摄像头驱动初始化片段：

// 驱动私有结构体
struct my_camera_dev {
    struct v4l2_device      v4l2_dev;      // 顶层设备
    struct video_device     vdev;           // 视频节点
    struct vb2_queue        queue;          // 缓冲队列
    struct mutex            lock;
    // ... 其他硬件相关成员
};

static int my_camera_probe(struct platform_device *pdev)
{
    struct my_camera_dev *cam;
    int ret;

    // 1. 分配驱动私有结构体
    cam = devm_kzalloc(&pdev->dev, sizeof(*cam), GFP_KERNEL);

    // 2. 初始化 v4l2_device
    cam->v4l2_dev.dev = &pdev->dev;
    ret = v4l2_device_register(&pdev->dev, &cam->v4l2_dev);

    // 3. 初始化 vb2_queue
    cam->queue.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
    cam->queue.io_modes = VB2_MMAP | VB2_USERPTR | VB2_DMABUF;
    cam->queue.ops = &my_camera_queue_ops;
    cam->queue.mem_ops = &vb2_dma_contig_memops;
    cam->queue.drv_priv = cam;
    ret = vb2_queue_init(&cam->queue);

    // 4. 初始化 video_device
    cam->vdev.v4l2_dev = &cam->v4l2_dev;
    cam->vdev.queue = &cam->queue;
    cam->vdev.fops = &my_camera_fops;
    cam->vdev.ioctl_ops = &my_camera_ioctl_ops;
    strscpy(cam->vdev.name, "my_camera", sizeof(cam->vdev.name));
    ret = video_register_device(&cam->vdev, VFL_TYPE_VIDEO, -1);

    return 0;
}

1.4 数据流与结构体协作流程

当用户空间通过 ioctl 请求一帧图像时，三个核心结构体按以下流程协作：

1. 用户调用 ioctl(fd, VIDIOC_QBUF, ...) → 进入 video_device 的 fops->unlocked_ioctl 回调。
2. V4L2 核心分发 ioctl → 调用 video_device->ioctl_ops->vidioc_qbuf，内部调用 vb2_core_qbuf。
3. vb2_queue 接管缓冲区 → 将缓冲区加入 DMA 队列，调用 vb2_queue->ops->buf_queue 回调，驱动在此启动 DMA 传输。
4. DMA 完成中断 → 驱动调用 vb2_buffer_done 通知 vb2_queue 缓冲区已填满。
5. 用户调用 ioctl(fd, VIDIOC_DQBUF, ...) → 从 vb2_queue 的 done_list 中取出缓冲区，返回用户空间。