4. V4L2 核心数据结构：video_device、v4l2_device、v4l2_subdev 关系解析

在 V4L2 框架中，video_device、v4l2_device 和 v4l2_subdev 是构成 Camera 驱动的三大核心数据结构。理解它们之间的层次关系、生命周期和交互方式，是编写稳定、可扩展驱动的基础。本节将从结构定义、注册流程和协作模式三个维度进行深度解析。

4.1 三大结构体职责与定位

每个结构体在 V4L2 框架中扮演着不同的角色，它们共同构成了从硬件控制到用户空间接口的完整链路。

结构体	核心职责	所属层次	典型实例
video_device	用户空间接口，提供 /dev/videoX 设备节点	V4L2 核心层	主摄像头节点、ISP 输出节点
v4l2_device	顶层管理容器，协调所有子设备和 video_device	V4L2 设备层	Camera 传感器 + ISP 整体实例
v4l2_subdev	硬件子模块抽象，封装传感器、ISP、DMA 引擎等	V4L2 子设备层	IMX335 传感器、OV5640 传感器

4.2 层次关系与包含结构

这三个结构体并非平级关系，而是通过指针形成树形拓扑。下面通过 SVG 图展示其核心包含关系。

4.3 核心字段与关键指针

每个结构体内部都包含指向其他结构体的指针，这些指针构成了驱动框架的“骨架”。

4.3.1 video_device 关键字段

struct video_device {
    // 指向顶层 v4l2_device
    struct v4l2_device *v4l2_dev;
    
    // 设备节点编号和名称
    int minor;
    char name[32];
    
    // 文件操作回调（用户空间 ioctl 入口）
    const struct v4l2_file_operations *fops;
    
    // 媒体实体（用于 media controller 框架）
    struct media_entity *entity;
    
    // 设备私有数据指针
    void *priv;
    
    // 引用计数
    struct kref ref;
    
    // 释放回调
    void (*release)(struct video_device *vdev);
};

4.3.2 v4l2_device 关键字段

struct v4l2_device {
    // 子设备链表头
    struct list_head subdevs;
    
    // 指向父设备（platform_device 或 i2c_client）
    struct device *dev;
    
    // 锁保护
    struct mutex *lock;
    
    // 通知回调（子设备向父设备发送事件）
    void (*notify)(struct v4l2_subdev *sd,
                   unsigned int notification, void *arg);
    
    // 媒体设备（media controller 顶层）
    struct media_device *mdev;
};

4.3.3 v4l2_subdev 关键字段

struct v4l2_subdev {
    // 指向所属 v4l2_device
    struct v4l2_device *v4l2_dev;
    
    // 子设备名称
    char name[V4L2_SUBDEV_NAME_SIZE];
    
    // 操作函数集（核心回调）
    const struct v4l2_subdev_ops *ops;
    
    // 内部 pad 和链接描述
    struct media_entity entity;
    
    // 控制处理器
    struct v4l2_ctrl_handler *ctrl_handler;
    
    // 私有数据
    void *priv;
    
    // 设备节点（可选，用于单独访问子设备）
    struct video_device *devnode;
};

4.4 注册流程与生命周期

三个结构体的注册顺序有严格依赖：必须先注册 v4l2_device，再注册 v4l2_subdev 和 video_device。下面通过流程图展示标准注册路径。

4.5 协作模式：数据流与控制流

在实际 Camera 驱动中，三个结构体通过两种路径协作：控制流（ioctl 下发）和 数据流（DMA 传输）。

4.5.1 控制流路径

1. 用户空间 调用 ioctl(fd, VIDIOC_S_FMT, ...)
2. video_device.fops 中的 v4l2_ioctl 回调被触发
3. 回调内部通过 v4l2_dev 指针找到 v4l2_device
4. v4l2_device 遍历 subdevs 链表，调用对应 v4l2_subdev_ops 中的 s_fmt 回调
5. v4l2_subdev 最终操作硬件寄存器完成配置

4.5.2 数据流路径

1. v4l2_subdev（传感器）通过 CSI 接口输出图像数据
2. 数据经过 media_entity 定义的 pad 链接到达 video_device 对应的 DMA 引擎
3. DMA 引擎将数据写入预先分配的 videobuf2 缓冲区
4. 用户空间通过 DQBUF 获取填充好的缓冲区

4.6 实战：如何通过 sysfs 验证结构体关系

在开发板上，可以通过 sysfs 和 debugfs 直接验证三个结构体的绑定关系。

# 查看所有 video_device 及其所属 v4l2_device
ls -l /sys/class/video4linux/
# 输出示例：
# video0 -> ../../devices/platform/soc/fe4b0000.csi/video4linux/video0

# 查看 video_device 的 v4l2_dev 信息
cat /sys/class/video4linux/video0/device/name
# 输出：v4l2_device_name

# 查看 v4l2_subdev 注册列表
ls /sys/kernel/debug/v4l2/
# 输出：subdevs 目录，包含所有已注册子设备

# 查看特定 subdev 的 v4l2_dev 绑定
cat /sys/kernel/debug/v4l2/subdevs/0-0010/name
# 输出：imx335 1-0010

4.7 总结：三者的协作矩阵

场景	video_device 角色	v4l2_device 角色	v4l2_subdev 角色
用户打开设备	提供 /dev/videoX	验证设备状态	初始化硬件
设置格式	接收 ioctl	路由到子设备	配置传感器/ISP
启动流	管理缓冲区队列	协调流状态	启动硬件输出
停止流	回收缓冲区	通知所有子设备	停止硬件
关闭设备	释放资源	清理子设备链表	断电/休眠