3. V4L2设备注册：video_device结构体、v4l2_device注册流程、设备节点创建

在V4L2框架中，设备注册是驱动与用户空间建立通信通道的核心步骤。本章深入剖析video_device结构体的设计、v4l2_device的注册流程以及设备节点（/dev/videoX）的创建机制，帮助开发者理解从内核对象到用户空间文件节点的完整链路。

3.1 video_device结构体深度解析

struct video_device是V4L2驱动中最核心的数据结构之一，它抽象了一个视频设备节点在内核中的表示。该结构体不仅包含设备属性、操作函数集，还负责与V4L2核心框架交互。

以下是一个典型的video_device初始化代码片段，展示了如何填充关键字段：

static struct video_device vdev_template = {
    .name = "MIPI Camera",
    .vfl_dir = VFL_DIR_RX,          // 接收方向（摄像头）
    .fops = &camera_fops,           // 文件操作函数集
    .ioctl_ops = &camera_ioctl_ops, // V4L2 ioctl操作集
    .release = video_device_release,
    .device_caps = V4L2_CAP_VIDEO_CAPTURE |
                   V4L2_CAP_STREAMING |
                   V4L2_CAP_READWRITE,
};

3.2 v4l2_device注册流程

v4l2_device是V4L2驱动的顶层容器，它管理一个或多个video_device子设备。注册流程遵循“先父后子”的原则，即先注册v4l2_device，再注册其下的video_device。

3.2.1 注册步骤清单

1. 分配并初始化v4l2_device：调用v4l2_device_alloc()或静态初始化，设置名称、父设备指针。
2. 注册v4l2_device：调用v4l2_device_register(struct device *parent, struct v4l2_device *v4l2_dev)，将设备注册到内核设备模型。
3. 初始化video_device：填充video_device结构体，关联v4l2_dev指针。
4. 注册video_device：调用video_register_device(struct video_device *vdev, int type, int nr)，创建设备节点。
5. 错误处理与清理：注册失败时依次释放已分配的资源。

struct v4l2_device *v4l2_dev;
struct video_device *vdev;
int ret;

// 1. 分配v4l2_device
v4l2_dev = kzalloc(sizeof(*v4l2_dev), GFP_KERNEL);
if (!v4l2_dev)
    return -ENOMEM;

// 2. 注册v4l2_device
ret = v4l2_device_register(&client->dev, v4l2_dev);
if (ret < 0) {
    dev_err(&client->dev, "Failed to register v4l2_device\n");
    goto err_free_v4l2;
}

// 3. 分配并初始化video_device
vdev = video_device_alloc();
if (!vdev) {
    ret = -ENOMEM;
    goto err_unregister_v4l2;
}
*vdev = vdev_template;
vdev->v4l2_dev = v4l2_dev;
vdev->queue = &queue;  // 关联vb2队列

// 4. 注册video_device
ret = video_register_device(vdev, VFL_TYPE_VIDEO, -1);
if (ret < 0) {
    dev_err(&client->dev, "Failed to register video device\n");
    goto err_free_vdev;
}

// 保存私有数据引用
video_set_drvdata(vdev, sensor);

3.2.2 注册流程图

3.3 设备节点创建机制

当调用video_register_device()时，V4L2核心框架自动完成以下工作：

• 分配次设备号：从V4L2动态次设备号池中分配一个空闲的minor号。
• 创建设备文件：通过device_create()在/dev目录下创建videoX节点，主设备号为VIDEO_MAJOR（81）。
• 关联file_operations：将video_device->fops注册到内核VFS层。
• 添加到设备列表：将设备加入video_device_list全局链表，便于查找。

3.3.1 设备节点命名规则

3.3.2 设备节点创建内部流程

3.4 注册与注销的对称性

V4L2驱动必须保证注册与注销操作的对称性，否则会导致资源泄漏或内核崩溃。标准的注销流程如下：

static void camera_remove(struct i2c_client *client)
{
    struct camera_sensor *sensor = i2c_get_clientdata(client);

    // 1. 注销video_device（先注销子设备）
    video_unregister_device(sensor->vdev);

    // 2. 释放video_device
    video_device_release(sensor->vdev);

    // 3. 注销v4l2_device（后注销父设备）
    v4l2_device_unregister(sensor->v4l2_dev);

    // 4. 释放v4l2_device
    kfree(sensor->v4l2_dev);
}

3.5 多实例设备注册

对于支持多路摄像头的驱动，通常使用video_register_device()的nr参数控制设备编号：

• nr = -1：由V4L2核心自动分配下一个可用编号。
• nr >= 0：指定固定编号，若被占用则注册失败。
• nr = V4L2_VIDEO_NR_AUTO：与-1行为相同，自动分配。

多实例注册示例：

for (i = 0; i < num_cameras; i++) {
    vdev = video_device_alloc();
    *vdev = vdev_template;
    vdev->v4l2_dev = v4l2_dev;
    vdev->queue = &cameras[i]->queue;
    vdev->index = i;  // 记录实例编号

    ret = video_register_device(vdev, VFL_TYPE_VIDEO, -1);
    if (ret < 0) {
        dev_err(dev, "Failed to register camera %d\n", i);
        goto err_rollback;
    }
    cameras[i]->vdev = vdev;
}

3.6 本章小结