4. 核心数据结构详解：v4l2_device、video_device、v4l2_subdev、vb2_queue 的关系

在 V4L2 摄像头驱动中，四个核心数据结构构成了驱动框架的骨架：v4l2_device（顶层设备）、video_device（用户态接口）、v4l2_subdev（子设备抽象）和 vb2_queue（缓冲区管理队列）。理解它们之间的关系，是编写正确、高效摄像头驱动的关键。

4.1 四者角色总览

4.2 结构体包含关系与初始化顺序

驱动中典型的包含关系如下：

struct camera_device {
    struct v4l2_device      v4l2_dev;       // 顶层设备，必须第一个初始化
    struct video_device     vdev;           // 字符设备接口
    struct v4l2_subdev      sensor_sd;      // 传感器子设备
    struct vb2_queue        vb2_q;          // 缓冲区队列
    // ... 其他硬件相关成员
};

初始化顺序必须严格遵守：

1. v4l2_device_register() — 注册顶层设备，建立与 struct device 的关联
2. v4l2_subdev_init() / v4l2_subdev_registered() — 初始化并注册子设备，挂接到 v4l2_device
3. vb2_queue_init() — 初始化缓冲区队列，设置 ops、buf_struct_size、驱动私有数据
4. video_register_device() — 最后注册 video_device，此时所有依赖已就绪

4.3 四者关系架构图

4.4 video_device 与 vb2_queue 的绑定机制

video_device 本身不直接包含 vb2_queue，而是通过 v4l2_fh（文件句柄私有数据）和 v4l2_ioctl_ops 间接关联。标准做法是在驱动中实现 v4l2_ioctl_ops 的回调，将 REQBUFS、QBUF、DQBUF 等操作委托给 vb2_queue 的核心函数。

// 在驱动 probe 函数中绑定 vb2_queue 到 video_device
static int camera_probe(struct platform_device *pdev)
{
    struct camera_device *cam;
    int ret;

    cam = devm_kzalloc(&pdev->dev, sizeof(*cam), GFP_KERNEL);

    // 1. 注册 v4l2_device
    cam->v4l2_dev.dev = &pdev->dev;
    ret = v4l2_device_register(&pdev->dev, &cam->v4l2_dev);

    // 2. 初始化 vb2_queue
    cam->vb2_q.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
    cam->vb2_q.io_modes = VB2_MMAP | VB2_USERPTR | VB2_DMABUF;
    cam->vb2_q.ops = &camera_vb2_ops;       // 驱动实现的 vb2 操作集
    cam->vb2_q.mem_ops = &vb2_dma_contig_memops;
    cam->vb2_q.drv_priv = cam;
    ret = vb2_queue_init(&cam->vb2_q);

    // 3. 初始化 video_device
    cam->vdev.v4l2_dev = &cam->v4l2_dev;
    cam->vdev.ioctl_ops = &camera_ioctl_ops; // 包含 vidioc_reqbufs 等
    cam->vdev.release = video_device_release_empty;
    video_set_drvdata(&cam->vdev, cam);

    // 4. 关键绑定：将 vb2_queue 指针存入 video_device 的 queue 字段
    cam->vdev.queue = &cam->vb2_q;

    // 5. 注册 video_device
    ret = video_register_device(&cam->vdev, VFL_TYPE_VIDEO, -1);
    return ret;
}

4.5 v4l2_subdev 与 video_device 的协作模式

在摄像头驱动中，v4l2_subdev 通常代表物理传感器或 ISP 芯片。video_device 通过 v4l2_subdev_call() 宏来调用子设备的操作，典型的调用链如下：

4.6 媒体控制器架构下的扩展关系

当启用 MEDIA_CONTROLLER 内核配置时，v4l2_device 会嵌入一个 media_device，此时四者关系进一步扩展：

• media_device 作为全局媒体拓扑管理者，通过 entity、pad、link 描述硬件数据流路径
• v4l2_subdev 注册为 media_entity，暴露 sink/source pad
• video_device 也注册为 media_entity，通常作为数据流的 sink 或 source
• vb2_queue 不直接参与媒体拓扑，但通过 video_device 的 entity 间接关联

// 媒体控制器模式下，v4l2_device 初始化包含 media_device
struct media_device mdev;
media_device_init(&mdev);
cam->v4l2_dev.mdev = &mdev;
v4l2_device_register(&pdev->dev, &cam->v4l2_dev);

// subdev 注册时自动创建 media entity
// video_device 注册时也创建 media entity
// 驱动需要手动创建 pad 之间的 link

4.7 数据结构关系总结表