3、V4L2框架初探：核心数据结构与注册流程

好，咱们今天来聊聊V4L2框架里最核心的那几个数据结构。说实话，我刚接触V4L2的时候，看着video_device、v4l2_device、v4l2_subdev这三个结构体，脑子是有点懵的。它们之间到底是什么关系？谁管着谁？注册顺序又是怎样的？

别急，咱们一个一个拆开来看。我保证，看完这一章，你心里就有谱了。

3.1 三个核心数据结构：各司其职

先打个比方。你可以把整个Camera子系统想象成一个公司：

• v4l2_device 是总公司。它负责统筹全局，管理所有资源。
• video_device 是前台/门面。用户空间（应用程序）通过它来跟内核打交道。它暴露了/dev/videoX这样的设备节点。
• v4l2_subdev 是各个部门（比如传感器部门、ISP部门）。它们干具体的活，但对外不直接暴露。

嗯，这个比喻你记住就行。下面我们看具体定义。

3.1.1 v4l2_device：顶层的“大管家”

这个结构体定义在 include/media/v4l2-device.h 里。我个人习惯把它看作是整个V4L2设备的根节点。

struct v4l2_device {
    struct device *dev;          // 指向物理设备（比如platform_device或i2c_client）
    struct list_head subdevs;    // 挂载所有v4l2_subdev的链表头
    spinlock_t lock;            // 内部锁
    char name[V4L2_DEVICE_NAME_SIZE]; // 设备名，调试时很有用
    // ... 还有一些其他成员，但上面这几个是最关键的
};

你看，它里面有一个subdevs链表。所有注册到这个设备上的子设备（subdev），都会被挂到这个链表上。说白了，它就是用来管理子设备的。

3.1.2 video_device：用户空间的“窗口”

这个结构体定义在 include/media/v4l2-dev.h 里。它是用户空间程序通过open()、ioctl()等系统调用直接操作的对象。

struct video_device {
    const struct v4l2_file_operations *fops; // 文件操作函数集（open, release, ioctl...）
    struct v4l2_ioctl_ops *ioctl_ops;        // ioctl命令处理函数集
    struct device dev;                       // 内核设备结构体
    struct v4l2_device *v4l2_dev;            // 指向所属的v4l2_device
    // ... 还有vfl_type, minor, index等
};

这里要注意的是fops和ioctl_ops。前者是标准的字符设备操作，后者是V4L2特有的ioctl命令处理。你想想看，用户空间调用VIDIOC_QUERYCAP时，最终就是通过ioctl_ops里的函数来响应的。

3.1.3 v4l2_subdev：干活的“小兵”

这个结构体定义在 include/media/v4l2-subdev.h 里。它代表一个功能独立的硬件模块，比如传感器、闪光灯、马达等。

struct v4l2_subdev {
    struct v4l2_device *v4l2_dev;    // 指向所属的v4l2_device
    struct module *owner;            // 所属模块
    const struct v4l2_subdev_ops *ops; // 子设备操作函数集（core, video, pad等）
    struct v4l2_subdev_pad_config *config; // pad配置
    char name[V4L2_SUBDEV_NAME_SIZE]; // 子设备名
    // ... 还有内部状态、电源管理等
};

它的核心是ops。这个v4l2_subdev_ops结构体里，又包含了多个子操作集，比如：

• core：核心操作，如初始化、电源管理。
• video：视频流操作，如s_stream（启动/停止流）。
• pad：pad操作，如get_fmt、set_fmt（获取/设置格式）。

说白了，上层驱动（比如video_device的ioctl处理函数）就是通过调用这些ops里的函数，来间接控制硬件子模块的。

3.2 注册流程：先有“总公司”，再有“前台”和“部门”

好，数据结构看完了。那它们是怎么注册到内核里的呢？顺序很重要。我总结了一个口诀：先有爹，后有儿，最后开门迎客。

1. 注册v4l2_device（总公司）
2. 注册v4l2_subdev（各部门）
3. 注册video_device（前台/门面）

为什么是这个顺序？你想想看，subdev需要知道它属于哪个v4l2_device，所以v4l2_device必须先存在。而video_device需要知道它管理哪些subdev，所以subdev最好先注册好。当然，技术上video_device也可以先注册，但逻辑上不推荐。

3.2.1 第一步：注册v4l2_device

这一步很简单，调用v4l2_device_register()即可。

struct v4l2_device v4l2_dev;
struct device *pdev; // 假设这是你的platform_device

v4l2_device_register(pdev, &v4l2_dev);

这个函数会初始化内部链表、设置名字、关联父设备等。嗯，这里要注意，pdev参数不能是NULL，否则内核会警告。

3.2.2 第二步：注册v4l2_subdev

对于I2C接口的传感器，通常是在I2C驱动的probe函数里注册subdev。

struct v4l2_subdev *sd;
struct i2c_client *client;

sd = v4l2_i2c_new_subdev_board(&v4l2_dev, adapter,
                                "sensor_name", 0x10, NULL);

或者，你也可以手动初始化并调用v4l2_device_register_subdev()。

struct v4l2_subdev sd;
v4l2_subdev_init(&sd, &sensor_ops);
sd.owner = THIS_MODULE;
strscpy(sd.name, "my_sensor", sizeof(sd.name));

v4l2_device_register_subdev(&v4l2_dev, &sd);

注册成功后，这个subdev就会被添加到v4l2_dev.subdevs链表中。

3.2.3 第三步：注册video_device

最后一步，创建并注册video_device。

struct video_device *vdev;
vdev = video_device_alloc(); // 分配内存
if (!vdev)
    return -ENOMEM;

vdev->fops = &my_fops;       // 设置文件操作
vdev->ioctl_ops = &my_ioctl_ops; // 设置ioctl操作
vdev->v4l2_dev = &v4l2_dev;  // 关联到v4l2_device
strscpy(vdev->name, "my_camera", sizeof(vdev->name));
vdev->release = video_device_release; // 释放回调

video_register_device(vdev, VFL_TYPE_VIDEO, -1); // 注册，-1表示自动分配节点号

注册成功后，你会在/dev目录下看到video0（或video1等）设备节点。用户空间程序就可以通过它来操作摄像头了。

3.3 总结一下

咱们用一张表来总结这三个结构体的关系：

结构体	角色	注册函数	关键成员
v4l2_device	顶层容器，管理所有subdev	v4l2_device_register()	subdevs链表
v4l2_subdev	硬件子模块，执行具体功能	v4l2_device_register_subdev()	ops操作函数集
video_device	用户空间接口，暴露/dev/videoX	video_register_device()	fops, ioctl_ops, v4l2_dev

说白了，V4L2框架就是通过这三个结构体，把复杂的硬件逻辑层层封装起来。上层应用只需要操作/dev/videoX，而底层驱动则通过subdev来精细控制每一个硬件模块。

我个人觉得，理解了这个框架，你就掌握了V4L2的“骨架”。后面再学buffer管理、流控制、格式协商这些，就会轻松很多。好，这一章就到这里。下一章，咱们聊聊如何实现一个最简单的V4L2设备驱动。