1. V4L2框架概述

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

Video4Linux2（V4L2）是Linux内核中视频设备驱动的标准框架，位于多媒体子系统的核心层。它向上提供统一的字符设备接口（/dev/videoX），向下抽象各类视频硬件（摄像头、采集卡、编解码器）。

1.2 核心数据结构全景

V4L2框架围绕三个核心数据结构构建：video_device、v4l2_device 和 v4l2_fh。它们分别对应设备节点、顶层设备和文件句柄上下文，形成清晰的层次关系。

1.3 video_device 深度解析

video_device 是V4L2框架中最贴近用户空间的结构体。它负责将内核驱动能力暴露为字符设备节点，并处理所有 open/close/ioctl/mmap/poll 系统调用。

struct video_device {
    /* 设备节点管理 */
    struct device dev;              // 内核通用设备结构
    struct cdev *cdev;              // 字符设备描述符
    int minor;                      // 次设备号

    /* 操作函数集 */
    const struct v4l2_file_operations *fops;  // 文件操作回调

    /* 所属顶层设备 */
    struct v4l2_device *v4l2_dev;   // 指向父设备

    /* 文件句柄链表 */
    struct list_head fh_list;       // 所有打开的 v4l2_fh 链表头

    /* 设备能力 */
    u32 device_caps;                // 设备能力标志位
    enum v4l2_device_type dev_type; // 设备类型（capture/output/m2m）

    /* 索引与名称 */
    int index;                      // 设备索引号
    char name[32];                  // 设备名称

    /* 锁与引用计数 */
    struct mutex *lock;             // 设备锁
    spinlock_t fh_lock;             // fh_list 自旋锁
};

1.4 v4l2_device 顶层设备管理

v4l2_device 是V4L2驱动的顶层容器，通常对应一个物理芯片或一个完整的视频采集子系统。它负责协调多个子设备（如 sensor、ISP、DMA引擎）的协作。

struct v4l2_device {
    /* 设备注册 */
    struct device *dev;             // 指向物理设备结构
    struct list_head subdevs;       // 子设备链表

    /* 调试与通知 */
    void (*notify)(struct v4l2_subdev *sd,
                   unsigned int notification, void *arg);

    /* 时间与电源管理 */
    struct v4l2_ctrl_handler *ctrl_handler; // 控制处理器

    /* 内部状态 */
    char name[V4L2_DEVICE_NAME_SIZE];       // 设备名称
    int registered;                 // 注册标志
    spinlock_t lock;                // 内部自旋锁
};

1.5 v4l2_fh 文件句柄上下文

v4l2_fh 是每个 open() 调用创建的上下文结构体。它存储了当前文件描述符的私有状态，包括事件订阅、优先级和当前操作模式。

struct v4l2_fh {
    struct list_head list;          // 挂入 video_device.fh_list
    struct video_device *vdev;      // 所属 video_device
    struct v4l2_events events;      // 事件队列
    enum v4l2_priority priority;    // 访问优先级
    unsigned int flags;             // 状态标志
};

1.6 三大数据结构关系图

1.7 数据结构初始化流程

驱动加载时，三大数据结构的初始化遵循严格的顺序：先注册顶层设备，再注册视频设备节点，最后在 open() 时创建文件句柄上下文。

1. 步骤1： 调用 v4l2_device_register() 注册顶层设备，初始化 v4l2_device 结构。
2. 步骤2： 调用 video_register_device() 注册 video_device，指定 v4l2_dev 父设备指针。
3. 步骤3： 用户空间 open() 设备时，驱动回调中调用 v4l2_fh_init() 初始化 v4l2_fh。
4. 步骤4： 调用 v4l2_fh_add() 将句柄加入 video_device.fh_list 链表。
5. 步骤5： close() 时调用 v4l2_fh_del() 和 v4l2_fh_exit() 清理句柄。

// 驱动 probe 函数中的典型初始化流程
static int mydriver_probe(struct platform_device *pdev)
{
    struct mydriver *mydrv = container_of(pdev, struct mydriver, pdev);

    // 1. 注册顶层 v4l2_device
    v4l2_device_register(&pdev->dev, &mydrv->v4l2_dev);

    // 2. 初始化 video_device
    mydrv->vdev.v4l2_dev = &mydrv->v4l2_dev;
    mydrv->vdev.fops = &my_fops;
    mydrv->vdev.device_caps = V4L2_CAP_VIDEO_CAPTURE;

    // 3. 注册 video_device
    video_register_device(&mydrv->vdev, VFL_TYPE_VIDEO, -1);

    return 0;
}

// open 回调中的 v4l2_fh 初始化
static int my_open(struct file *file)
{
    struct video_device *vdev = video_devdata(file);
    struct v4l2_fh *fh = kzalloc(sizeof(*fh), GFP_KERNEL);

    v4l2_fh_init(fh, vdev);
    v4l2_fh_add(fh);
    file->private_data = fh;

    return 0;
}

1.8 本章小结

V4L2框架通过 v4l2_device、video_device 和 v4l2_fh 三个核心数据结构，构建了从物理设备到用户空间文件句柄的完整链路。理解这三者的层次关系和生命周期管理，是后续学习V4L2缓冲管理、DMA协同设计和帧缓冲调度的基础。