3. Subdev 注册流程：v4l2_device_register、v4l2_subdev_init、v4l2_device_register_subdev 函数调用链

Subdev 的注册是 V4L2 框架中连接主设备（video device）与子设备（subdev）的核心步骤。本章深入分析 v4l2_device_register、v4l2_subdev_init 和 v4l2_device_register_subdev 三个关键函数的调用链，揭示从设备节点创建到 subdev 挂载的完整过程。

3.1 整体调用链概览

下图展示了 subdev 注册的完整调用链，包含三个主要阶段：

3.2 v4l2_device_register：主设备容器初始化

该函数是注册流程的起点，负责创建 V4L2 设备实例并初始化内部数据结构。其原型如下：

int v4l2_device_register(struct device *dev, struct v4l2_device *v4l2_dev);

参数说明：

内部执行步骤：

1. 清零与赋值： 将 v4l2_dev 结构体清零，设置 dev 指针指向父设备。
2. 初始化锁： 初始化 spin_lock 用于保护 subdev 链表操作。
3. 初始化链表头： 初始化 subdevs 链表头，后续所有 subdev 将挂载到此链表上。
4. 设置私有数据： 如果驱动需要，可通过 v4l2_dev->priv 存储私有数据指针。

3.3 v4l2_subdev_init：子设备软件初始化

该函数完成 subdev 结构体的软件初始化，不涉及硬件寄存器操作。其原型为：

void v4l2_subdev_init(struct v4l2_subdev *sd, const struct v4l2_subdev_ops *ops);

初始化内容清单：

3.4 v4l2_device_register_subdev：挂载与通知

这是注册流程的最后一步，将已初始化的 subdev 挂载到主设备上。其原型为：

int v4l2_device_register_subdev(struct v4l2_device *v4l2_dev, struct v4l2_subdev *sd);

执行流程：

1. 有效性检查： 检查 sd 是否为 NULL，sd->ops 是否已设置。
2. 关联主设备： 设置 sd->v4l2_dev = v4l2_dev，建立双向引用。
3. 链表操作： 调用 list_add_tail(&sd->list, &v4l2_dev->subdevs) 将 subdev 加入链表尾部。
4. 通知回调： 如果 v4l2_dev->notify 回调已注册，则调用 notify(sd, V4L2_DEVICE_NOTIFY_SUBDEV_REGISTER) 通知上层驱动。
5. 返回结果： 成功返回 0，失败返回负错误码。

// 典型注册代码片段
struct v4l2_device v4l2_dev;
struct v4l2_subdev sd;

// 步骤1：注册主设备
v4l2_device_register(&pdev->dev, &v4l2_dev);

// 步骤2：初始化 subdev
v4l2_subdev_init(&sd, &sensor_ops);
snprintf(sd.name, sizeof(sd.name), "sensor-%s", dev_name(&pdev->dev));

// 步骤3：挂载 subdev
ret = v4l2_device_register_subdev(&v4l2_dev, &sd);
if (ret < 0) {
    dev_err(&pdev->dev, "failed to register subdev: %d\n", ret);
    goto err_unregister;
}

3.5 注册流程状态机

下图以状态机形式展示 subdev 注册过程中各阶段的状态转换：

3.6 注册流程对比表

下表对比三个核心函数的作用域、调用时机和关键行为：

3.7 常见问题与调试方法

问题1：注册后 subdev 不可见

• 原因： v4l2_device_register_subdev 返回成功，但 sd->v4l2_dev 为 NULL。
• 排查： 检查是否在 v4l2_subdev_init 之后错误地清零了 sd 结构体。

问题2：多次注册导致链表损坏

• 原因： 同一个 sd 实例被多次调用 v4l2_device_register_subdev。
• 排查： 在注册前检查 sd->v4l2_dev 是否为 NULL，非 NULL 表示已注册。

问题3：注销时内存泄漏

• 原因： 只调用了 v4l2_device_unregister，未先调用 v4l2_device_unregister_subdev 从链表中移除 subdev。
• 排查： 使用 list_for_each_entry_safe 遍历 subdevs 链表，逐个注销。