2. V4L2框架基础：V4L2设备节点、ioctl命令集、videobuf2核心数据结构

V4L2（Video for Linux 2）是 Linux 内核中视频设备驱动的标准框架，也是 Camera HAL 与底层硬件交互的核心桥梁。理解 V4L2 的设备节点模型、ioctl 命令体系以及 videobuf2 缓冲区管理机制，是进行 Camera HAL Buffer 管理调试的前提。

2.1 V4L2 设备节点模型

在 Linux 系统中，V4L2 设备以字符设备的形式暴露给用户空间，设备节点通常位于 /dev 目录下。Camera HAL 通过打开这些节点来与驱动进行通信。

2.2 V4L2 ioctl 命令集

V4L2 通过 ioctl() 系统调用实现用户空间与内核驱动的交互。ioctl 命令按照功能分为查询、设置、流控制、缓冲区管理四大类。Camera HAL 中最常用的 ioctl 命令如下：

2.3 videobuf2 核心数据结构

videobuf2（vb2）是 V4L2 框架中负责缓冲区管理的核心模块。它抽象了不同内存类型（MMAP、USERPTR、DMA_BUF）的缓冲区分配、映射、入队出队和同步操作。理解 vb2 的数据结构是分析 Buffer 问题的关键。

2.3.1 核心结构体关系

2.3.2 缓冲区状态机

videobuf2 使用严格的状态机管理每个 buffer 的生命周期。理解状态转换对于调试 buffer 卡死、丢帧问题至关重要。

2.3.3 内存类型与操作回调

videobuf2 支持三种内存模型，每种模型对应不同的分配和映射策略。驱动通过 vb2_queue 中的 io_modes 字段声明支持的模式。

2.3.4 驱动侧回调函数接口

驱动开发者需要实现 vb2_ops 结构体中的回调函数，videobuf2 核心会在合适的时机调用这些回调：

struct vb2_ops {
    int (*queue_setup)(struct vb2_queue *q,
                       unsigned int *nbuffers,
                       unsigned int *nplanes,
                       unsigned int sizes[],
                       struct device *alloc_devs[]);
    void (*wait_prepare)(struct vb2_queue *q);
    void (*wait_finish)(struct vb2_queue *q);
    int (*buf_prepare)(struct vb2_buffer *vb);
    void (*buf_queue)(struct vb2_buffer *vb);
    int (*start_streaming)(struct vb2_queue *q, unsigned int count);
    void (*stop_streaming)(struct vb2_queue *q);
};