📚 课程目录第1章 Camera驱动概述

Camera驱动实战：camera调试工具与DMA传输分析 - 第1节

1.1 Camera 子系统整体架构

Camera 子系统在嵌入式 Linux 系统中是一个典型的多层、多硬件模块协同工作的复杂系统。从硬件到用户空间，数据流和控制流需要经过多个层次的处理。理解整体架构是驱动开发的第一步。

  核心观点： Camera 子系统分为 硬件层（传感器、ISP、接口）、内核层（V4L2 框架、平台驱动、DMA 引擎）和 用户空间层（应用程序、库如 libcamera）。驱动开发者的主要战场在内核层。

下图展示了 Camera 子系统在嵌入式 Linux 系统中的典型分层架构：

1.2 V4L2 框架简介

V4L2（Video for Linux 2）是 Linux 内核中用于视频设备驱动的标准框架。它为摄像头、电视调谐器、视频采集卡等设备提供了统一的接口。V4L2 框架的核心目标是：

统一接口： 为应用程序提供标准化的 open()、ioctl()、mmap()、poll() 等系统调用接口。
设备抽象： 将物理摄像头抽象为 /dev/videoX 设备节点。
缓冲区管理： 提供 videobuf2 (vb2) 框架，统一管理视频缓冲区的分配、入队、出队和 DMA 传输。
子设备模型： 支持将传感器、ISP、解码器等独立硬件抽象为子设备，通过 media controller 框架进行拓扑管理。

1.2.1 V4L2 核心数据结构

V4L2 框架在内核中通过几个关键数据结构组织驱动逻辑。下表列出了最核心的结构体及其作用：

数据结构	所在头文件	核心作用
`struct video_device`	`media/v4l2-dev.h`	代表一个 V4L2 设备节点，注册后生成 `/dev/videoX`。包含 `v4l2_file_operations` 和 `v4l2_ioctl_ops`。
`struct v4l2_device`	`media/v4l2-device.h`	V4L2 设备实例的顶层容器，管理所有子设备，提供注册/注销功能。
`struct v4l2_subdev`	`media/v4l2-subdev.h`	代表一个子设备（如传感器、ISP），通过 `v4l2_subdev_ops` 提供操作回调。
`struct vb2_queue`	`media/videobuf2-core.h`	videobuf2 缓冲区队列核心，管理缓冲区的分配、入队、出队和 DMA 操作。
`struct media_device`	`media/media-device.h`	Media Controller 框架的设备实例，用于描述硬件拓扑和 pipeline 配置。

开发提示： 在编写 Camera 驱动时，struct vb2_queue 是 DMA 传输的核心。你需要实现 vb2_ops 中的 queue_setup()、buf_prepare()、start_streaming()、stop_streaming() 等回调函数。

1.2.2 V4L2 设备节点与 ioctl 流程

应用程序通过 /dev/videoX 节点与驱动交互。典型的 V4L2 应用程序调用流程如下：

打开设备： fd = open("/dev/video0", O_RDWR)
查询能力： ioctl(fd, VIDIOC_QUERYCAP, &cap) — 获取驱动能力信息。
设置格式： ioctl(fd, VIDIOC_S_FMT, &fmt) — 配置图像分辨率、像素格式。
请求缓冲区： ioctl(fd, VIDIOC_REQBUFS, &req) — 申请视频缓冲区。
查询并映射缓冲区： ioctl(fd, VIDIOC_QUERYBUF, &buf) + mmap()
入队缓冲区： ioctl(fd, VIDIOC_QBUF, &buf) — 将缓冲区放入驱动队列。
启动流： ioctl(fd, VIDIOC_STREAMON, &type)
出队缓冲区： ioctl(fd, VIDIOC_DQBUF, &buf) — 获取已填充数据的缓冲区。
停止流： ioctl(fd, VIDIOC_STREAMOFF, &type)

下图展示了 V4L2 框架中设备节点、核心模块与子设备之间的交互关系：

1.3 驱动在系统中的位置

Camera 驱动在 Linux 内核中处于 多媒体子系统 之下，与 字符设备驱动、平台驱动、I2C/SPI 总线驱动 以及 DMA 引擎驱动 紧密协作。理解驱动在系统中的位置，有助于在调试时快速定位问题模块。

1.3.1 驱动分类与职责

一个完整的 Camera 驱动通常由以下几类驱动协同构成：

驱动类型	内核路径示例	主要职责
Sensor 驱动	`drivers/media/i2c/ov5640.c`	初始化传感器寄存器、配置分辨率/帧率、控制曝光/增益、通过 I2C 与传感器通信。
CSI 主机控制器驱动	`drivers/media/platform/rockchip/`	配置 MIPI CSI-2 接收端、处理时钟/数据 Lane、解析短包/长包、触发 DMA 传输。
ISP 驱动	`drivers/media/platform/mediatek/isp/`	控制 ISP 硬件管线（去噪、AWB、AE、色彩校正等），通常通过 Media Controller 与 Sensor 联动。
DMA 引擎驱动	`drivers/dma/`	提供 DMA 传输通道，将 CSI 接收到的图像数据搬运到系统内存缓冲区。
V4L2 平台驱动	`drivers/media/platform/`	注册 video_device，实现 vb2 操作，串联 Sensor、CSI、ISP 和 DMA 引擎。

常见误区： 初学者常认为 Camera 驱动只是一个 .ko 文件。实际上，在复杂 SoC（如 Rockchip RK3588、MTK Genio 700）上，Camera 驱动通常由 3~5 个独立的内核模块组成，通过 device tree 和 media controller 进行绑定。

1.3.2 驱动在设备树中的位置

在嵌入式 Linux 中，Camera 驱动的硬件拓扑通过 设备树 (Device Tree) 描述。以下是一个简化的设备树片段，展示了 Sensor、CSI 和 DMA 之间的连接关系：

// 设备树示例：Camera 硬件拓扑描述
&i2c2 {
    status = "okay";
    camera_sensor: ov5640@3c {
        compatible = "ovti,ov5640";
        reg = <0x3c>;
        clocks = <&cru CLK_CIF_OUT>;
        clock-names = "xvclk";
        avdd-supply = <&vcc_avdd>;
        dvdd-supply = <&vcc_dvdd>;
        powerdown-gpios = <&gpio1 RK_PB6 GPIO_ACTIVE_LOW>;
        reset-gpios = <&gpio1 RK_PB7 GPIO_ACTIVE_LOW>;
        port {
            sensor_out: endpoint {
                remote-endpoint = <&csi_in>;
                data-lanes = <1 2>;
            };
        };
    };
};

&csi_host {
    status = "okay";
    ports {
        #address-cells = <1>;
        #size-cells = <0>;
        port@0 {
            reg = <0>;
            csi_in: endpoint {
                remote-endpoint = <&sensor_out>;
                data-lanes = <1 2>;
            };
        };
        port@1 {
            reg = <1>;
            csi_out: endpoint {
                remote-endpoint = <&vop_in>;
            };
        };
    };
};

&dma_controller {
    status = "okay";
    // DMA 通道配置由 CSI 驱动在运行时请求
};

调试技巧： 当 Camera 驱动无法正常工作时，首先检查设备树中 remote-endpoint 的 phandle 是否正确连接。使用 cat /sys/kernel/debug/media_summary 可以查看当前 Media Controller 的拓扑结构。

1.3.3 驱动在系统启动流程中的位置

Camera 驱动在系统启动过程中的加载顺序如下：

Bootloader 阶段： 初始化基本的时钟和电源，可能加载 Sensor 的初始配置。
内核启动阶段：
- I2C/SPI 总线驱动初始化。
- DMA 引擎驱动初始化，注册 DMA 通道。
- V4L2 核心框架初始化。
- Sensor 驱动通过 I2C 探测并注册子设备。
- CSI 主机控制器驱动探测并注册。
- 平台驱动注册 video_device，建立 Media Controller pipeline。
用户空间阶段： 应用程序打开 /dev/videoX，开始配置和采集。

下图展示了 Camera 驱动在系统启动流程中的位置和依赖关系：

1.4 本章小结

本章从三个维度建立了 Camera 驱动的整体认知：

子系统架构： 硬件层、内核层、用户空间层的分层协作关系。
V4L2 框架： 核心数据结构、设备节点、ioctl 流程以及子设备模型。
驱动位置： 驱动分类、设备树描述、系统启动流程中的加载顺序。