📚 课程目录第1章 V4L2框架概述

1. V4L2框架概述

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

Video4Linux2（V4L2）是 Linux 内核中为视频设备提供统一访问接口的框架，位于多媒体子系统的核心层。它向上对接用户空间的应用（如 GStreamer、FFmpeg、VLC），向下抽象各类硬件设备（摄像头、采集卡、编解码器）。

  关键定位： V4L2 是 Linux 多媒体栈中唯一同时管理视频数据流和控制路径的内核框架，与 ALSA（音频）、DRM（显示）、Media Controller（媒体拓扑）共同构成完整的多媒体处理管道。

1.2 V4L2 核心数据结构

V4L2 框架围绕一组精心设计的内核数据结构组织，驱动开发者必须理解这些结构的职责与关联关系。下表列出最核心的五个结构体及其在驱动中的角色：

数据结构	头文件	核心职责	与 videobuf2 的关系
`v4l2_device`	media/v4l2-device.h	顶层设备实例，管理子设备、控制处理器和通知链	作为父设备注册 videobuf2 队列
`video_device`	media/v4l2-dev.h	字符设备节点（/dev/videoX），实现 file_operations	持有 vb2_queue 指针，分发 ioctl 到 videobuf2
`v4l2_ctrl_handler`	media/v4l2-ctrls.h	管理曝光、增益、白平衡等控制参数	独立于数据路径，但影响 DMA 传输参数
`vb2_queue`	media/videobuf2-core.h	缓冲区队列核心，管理 buffer 生命周期和 DMA 映射	本课程核心，与 DMA 引擎直接交互
`media_entity`	media/media-entity.h	媒体拓扑中的节点，描述硬件数据流路径	通过 link 连接 videobuf2 队列与 DMA 引擎

驱动开发要点： 在 probe 函数中，初始化顺序为 v4l2_device → vb2_queue → video_device。videobuf2 队列必须在 video_device 注册之前完成初始化，因为 open/ioctl 可能立即触发缓冲区操作。

1.3 V4L2 核心接口与 ioctl 命令

V4L2 通过标准 ioctl 命令实现用户空间与内核驱动的交互。以下是最常用的接口分类：

查询与能力发现：
- VIDIOC_QUERYCAP — 查询设备能力（是否支持 streaming、读写模式）
- VIDIOC_ENUM_FMT — 枚举支持的像素格式（YUYV、NV12、MJPEG 等）
- VIDIOC_ENUM_FRAMESIZES — 枚举分辨率范围
格式与参数协商：
- VIDIOC_S_FMT / VIDIOC_G_FMT — 设置/获取当前数据格式
- VIDIOC_S_PARM / VIDIOC_G_PARM — 设置/获取帧率参数
- VIDIOC_REQBUFS — 请求分配缓冲区（videobuf2 入口）
缓冲区操作（videobuf2 核心）：
- VIDIOC_QBUF — 将缓冲区放入驱动队列（等待硬件填充）
- VIDIOC_DQBUF — 从驱动队列取出已填充的缓冲区
- VIDIOC_STREAMON / VIDIOC_STREAMOFF — 启动/停止视频流

1.4 videobuf2 在 V4L2 中的角色

videobuf2（vb2）是 V4L2 框架中负责缓冲区管理的子系统，它抽象了从用户空间到硬件 DMA 的完整缓冲区生命周期。vb2 的核心价值在于：

内存类型透明化： 支持 V4L2_MEMORY_MMAP、V4L2_MEMORY_USERPTR、V4L2_MEMORY_DMABUF 三种内存模型，驱动无需关心用户空间选择哪种分配方式。
DMA 映射自动化： 在 buffer 入队时自动完成 dma_map_sg，出队时自动 dma_unmap_sg，驱动只需在 start_streaming 回调中配置 DMA 描述符。
队列状态机管理： 维护 buffer 在 QUEUED、ACTIVE、DONE、ERROR 等状态之间的转换，防止竞态条件。
缓存同步： 在需要时调用 dma_sync_single_for_cpu/device，保证 CPU 与 DMA 引擎看到一致的数据。

常见误区： 新手驱动开发者常试图在 videobuf2 回调中直接操作硬件寄存器，这是错误的。vb2 回调（如 buffer_queue）运行在原子上下文或持有自旋锁，应仅做描述符链表操作，硬件启动/停止应在 start_streaming/stop_streaming 中完成。

1.5 V4L2 设备注册流程示例

以下代码展示一个典型 V4L2 摄像头驱动在 probe 函数中注册核心结构的顺序：

static int mycam_probe(struct platform_device *pdev)
{
    struct mycam_dev *dev;
    int ret;

    dev = devm_kzalloc(&pdev->dev, sizeof(*dev), GFP_KERNEL);
    if (!dev)
        return -ENOMEM;

    /* 1. 初始化 v4l2_device */
    dev->v4l2_dev = &dev->v4l2_dev_struct;
    ret = v4l2_device_register(&pdev->dev, dev->v4l2_dev);
    if (ret < 0)
        return ret;

    /* 2. 初始化 videobuf2 队列 */
    dev->vb2_q = &dev->vb2_q_struct;
    ret = vb2_queue_init(dev->vb2_q);
    if (ret)
        goto err_v4l2;

    /* 3. 初始化 video_device */
    dev->vdev = &dev->vdev_struct;
    strscpy(dev->vdev->name, "MyCam", sizeof(dev->vdev->name));
    dev->vdev->v4l2_dev = dev->v4l2_dev;
    dev->vdev->queue = dev->vb2_q;
    dev->vdev->fops = &mycam_fops;
    dev->vdev->ioctl_ops = &mycam_ioctl_ops;
    video_set_drvdata(dev->vdev, dev);

    ret = video_register_device(dev->vdev, VFL_TYPE_VIDEO, -1);
    if (ret)
        goto err_vb2;

    return 0;

err_vb2:
    vb2_queue_release(dev->vb2_q);
err_v4l2:
    v4l2_device_unregister(dev->v4l2_dev);
    return ret;
}

  初始化顺序约束： v4l2_device_register → vb2_queue_init → video_register_device。若颠倒 vb2 与 video_device 的初始化顺序，用户空间在 /dev/videoX 出现后立即调用 QBUF 将导致空指针异常。

1.6 本章小结

V4L2 框架是 Linux 视频驱动开发的基石，理解其分层架构、核心数据结构以及 videobuf2 的定位，是后续深入学习 DMA 协同的前提。本章重点：

V4L2 位于用户空间应用与硬件驱动之间，通过 ioctl 接口实现控制与数据流分离。
五个核心数据结构（v4l2_device、video_device、v4l2_ctrl_handler、vb2_queue、media_entity）各司其职，初始化顺序有严格约束。
videobuf2 是缓冲区管理的核心引擎，负责内存模型抽象、DMA 映射、状态机和缓存同步，驱动开发者应遵循其回调契约。