1. V4L2框架概述

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

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

在完整的Linux多媒体栈中，V4L2的上下层级关系如下：

V4L2与Media Controller（media_device）和Videobuf2（vb2）共同构成现代嵌入式Camera驱动的基础设施。Media Controller负责管理设备拓扑与数据路由，Videobuf2负责缓冲区管理与内存分配。

1.2 V4L2与Camera HAL的关系

在Android或嵌入式Camera系统中，V4L2与Camera HAL（硬件抽象层）是紧密协作的上下层关系：

• Camera HAL 位于用户空间，实现camera_device_t或ICameraDevice接口，负责上层框架（如Android CameraService）与底层驱动的交互。
• V4L2 是HAL访问Camera硬件的标准途径。HAL通过open("/dev/video0")获取设备句柄，使用ioctl发送控制命令，通过mmap或dmabuf获取图像缓冲区。

HAL层对V4L2的典型操作包括：

1.3 V4L2核心数据结构

V4L2框架在内核中围绕三个核心数据结构构建：v4l2_device、v4l2_subdev和video_device。理解它们的关系是掌握V4L2驱动开发的基础。

1.3.1 v4l2_device —— 顶层设备容器

v4l2_device是V4L2驱动的顶层结构体，代表一个完整的视频设备实例。它作为容器，管理该设备下的所有子设备（subdev）和视频节点（video_device）。

struct v4l2_device {
    struct device *dev;              // 指向物理设备（platform/i2c/spi）
    struct list_head subdevs;        // 挂载所有v4l2_subdev的链表头
    spinlock_t lock;                 // 自旋锁，保护内部状态
    char name[V4L2_DEVICE_NAME_SIZE]; // 设备名称
    void (*notify)(struct v4l2_subdev *sd, unsigned int notification, void *arg);
    // 子设备通知回调
};

• 职责： 注册/注销子设备、管理设备级通知、提供调试接口。
• 注册： 驱动通过v4l2_device_register()注册，通常在probe函数中完成。

1.3.2 v4l2_subdev —— 子设备抽象

v4l2_subdev代表一个功能独立的硬件单元，如Camera Sensor、ISP模块、AF马达、闪光灯控制器等。每个subdev通常对应一个I2C/SPI从设备或平台设备。

struct v4l2_subdev {
    struct v4l2_device *v4l2_dev;    // 所属的顶层设备
    struct list_head list;           // 挂入v4l2_device的链表节点
    struct module *owner;            // 所属内核模块
    const struct v4l2_subdev_ops *ops; // 操作函数集（core/video/pad/ctrl等）
    struct v4l2_subdev_pad_config *config; // pad配置
    void *host_priv;                 // 驱动私有数据
    char name[V4L2_SUBDEV_NAME_SIZE];
};

• 操作函数集： v4l2_subdev_ops包含core、video、pad、ctrl等子集，分别处理初始化、视频流控制、pad路由、控制参数。
• 注册： 通过v4l2_device_register_subdev()挂入父设备。

1.3.3 video_device —— 用户空间接口节点

video_device是V4L2暴露给用户空间的字符设备接口，对应/dev/videoX。它封装了文件操作（file_operations），处理来自用户空间的ioctl、mmap、poll等系统调用。

struct video_device {
    const struct v4l2_file_operations *fops; // 文件操作函数集
    struct device dev;                       // 内核设备结构
    struct v4l2_device *v4l2_dev;            // 所属顶层设备
    struct v4l2_ioctl_ops *ioctl_ops;        // ioctl处理函数集
    unsigned long flags;                     // 设备标志
    int minor;                               // 次设备号
    char name[32];                           // 设备名称
};

• v4l2_file_operations： 包含open、release、read、write、mmap、poll、unlocked_ioctl等回调。
• 注册： 通过video_register_device()创建节点，指定类型（VFL_TYPE_GRABBER、VFL_TYPE_VBI等）。

1.3.4 三者关系

三个核心数据结构在驱动中的组织关系如下：

1.3.5 数据结构协作流程

在典型的Camera驱动初始化过程中，三个核心数据结构的协作顺序如下：

1. 注册v4l2_device： 在平台驱动probe中调用v4l2_device_register()，传入父设备指针。
2. 注册v4l2_subdev： 对每个子设备（Sensor、ISP等）调用v4l2_device_register_subdev()，将其挂入v4l2_device.subdevs链表。
3. 注册video_device： 分配并初始化video_device，设置v4l2_dev指针指向已注册的v4l2_device，调用video_register_device()创建/dev/videoX节点。
4. 用户空间访问： 应用通过/dev/videoX发起ioctl，video_device的ioctl_ops将请求路由到对应的v4l2_subdev或直接由主驱动处理。