摄像头驱动数据接口开发 图像采集与DMA传输 - 第2节

2. V4L2框架入门

Video for Linux Two (V4L2) 是 Linux 内核中为视频设备提供统一访问接口的框架。它位于用户空间应用程序与底层摄像头硬件之间，定义了标准的数据结构和 ioctl 命令集，使得开发者无需关心具体硬件差异即可完成图像采集、参数控制、数据流管理等工作。

V4L2 的核心设计思想是 分层 与 抽象：

• 用户空间层：通过 /dev/videoX 设备节点，使用 open()、ioctl()、mmap()、poll() 等标准 POSIX 接口操作摄像头。
• 内核框架层：V4L2 核心模块提供设备注册、文件操作、缓冲区管理、事件通知等通用机制。
• 硬件驱动层：驱动开发者只需实现具体的硬件初始化、图像采集、DMA 传输等底层操作，并填充 V4L2 定义的回调函数。

2.2 核心数据结构

V4L2 框架围绕几个关键数据结构构建，驱动开发者必须理解它们的角色与关系。

2.2.1 struct video_device

这是 V4L2 框架中最核心的数据结构，代表一个视频设备节点（如 /dev/video0）。它负责将用户空间的文件操作（open、ioctl、mmap 等）映射到驱动实现的回调函数。

2.2.2 struct v4l2_device

这是 V4L2 框架的顶层设备结构，代表一个物理摄像头设备。它可以包含多个 video_device 子节点（例如主视频流 + 元数据流），并提供设备级别的管理与同步机制。

2.2.3 数据结构关系图

2.3 设备注册流程

V4L2 设备的注册遵循一套标准步骤，驱动开发者按顺序执行即可将摄像头设备正确接入内核框架。

1. 分配并初始化 v4l2_device：调用 v4l2_device_register()，传入父设备指针和名称。
2. 初始化子设备（可选）：对于 Sensor 或桥接芯片，使用 v4l2_subdev_init() 初始化并添加到父设备。
3. 分配并初始化 video_device：使用 video_device_alloc() 分配实例，填充 fops、v4l2_dev、queue 等成员。
4. 设置缓冲区队列：初始化 vb2_queue，实现 queue_setup、buf_prepare、buf_queue 等回调。
5. 注册 video_device：调用 video_register_device()，指定设备类型（如 VFL_TYPE_VIDEO）和次设备号。
6. 注册控制句柄（可选）：使用 v4l2_ctrl_handler_setup() 添加亮度、对比度等标准控制。

2.3.1 注册流程时序图

2.3.2 注册代码示例

以下代码片段展示了典型的 V4L2 设备注册过程，省略了错误处理以突出核心逻辑：

static int my_camera_probe(struct platform_device *pdev)
{
    struct v4l2_device *v4l2_dev;
    struct video_device *vdev;
    struct vb2_queue *q;
    int ret;

    // 1. 注册顶层 v4l2_device
    v4l2_dev = devm_kzalloc(&pdev->dev, sizeof(*v4l2_dev), GFP_KERNEL);
    ret = v4l2_device_register(&pdev->dev, v4l2_dev);

    // 2. 分配 video_device
    vdev = video_device_alloc();
    vdev->v4l2_dev = v4l2_dev;
    vdev->fops = &my_camera_fops;
    vdev->ioctl_ops = &my_camera_ioctl_ops;
    vdev->release = my_camera_release;
    vdev->device_caps = V4L2_CAP_VIDEO_CAPTURE | V4L2_CAP_STREAMING;

    // 3. 初始化 vb2_queue
    q = devm_kzalloc(&pdev->dev, sizeof(*q), GFP_KERNEL);
    q->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
    q->io_modes = VB2_MMAP | VB2_USERPTR | VB2_DMABUF;
    q->ops = &my_camera_queue_ops;
    q->mem_ops = &vb2_dma_contig_memops;
    q->drv_priv = my_priv;
    vb2_queue_init(q);
    vdev->queue = q;

    // 4. 注册 video_device
    ret = video_register_device(vdev, VFL_TYPE_VIDEO, -1);

    platform_set_drvdata(pdev, vdev);
    return 0;
}