4. 平台适配第一步：Kernel侧Camera驱动与设备树配置

高通Camera平台适配的起点在Kernel侧。设备树（Device Tree）是描述硬件拓扑与资源分配的核心数据结构，Camera子系统中Sensor、EEPROM、Actuator、Flash四大外设的节点配置正确与否，直接决定HAL层能否成功枚举设备、加载驱动并建立数据通路。本节将逐一解析各节点的标准结构、关键属性及常见配置错误。

4.1 Camera子系统设备树整体架构

在高通平台Kernel中，Camera相关设备树通常位于 arch/arm64/boot/dts/qcom/ 目录下，通过 #include 机制分层组织。一个典型的Camera设备树包含以下层级：

4.2 Sensor设备树节点解析

Sensor节点是Camera设备树中最核心的部分，它描述了图像传感器的硬件连接、电源时序、时钟频率、分辨率等关键信息。以下是一个标准的高通平台Sensor节点示例：

// 文件路径：arch/arm64/boot/dts/qcom/camera/xxx-camera.dtsi
&cci_i2c_0 {
    #address-cells = <1>;
    #size-cells = <0>;

    qcom,camera@0x10 {
        compatible = "qcom,camera";
        reg = <0x10>;
        qcom,csiphy-sd-index = <0>;
        qcom,csid-sd-index = <0>;
        qcom,mount-angle = <90>;
        qcom,actuator-src = <&actuator_0>;
        qcom,eeprom-src = <&eeprom_0>;
        qcom,led-flash-src = <&flash_0>;

        // 电源配置
        qcom,cam-vreg-name = "cam_vdig", "cam_vio", "cam_vana";
        qcom,cam-vreg-min-voltage = <1050000 1800000 2800000>;
        qcom,cam-vreg-max-voltage = <1050000 1800000 2800000>;
        qcom,cam-vreg-op-mode = <105000 100000 105000>;

        // GPIO配置
        gpios = <&tlmm 102 0>,  // RESET
                <&tlmm 103 0>;  // PWDN
        qcom,gpio-reset = <0>;
        qcom,gpio-standby = <1>;
        qcom,gpio-req-tbl-num = <0 1>;
        qcom,gpio-req-tbl-flags = <0 0>;
        qcom,gpio-req-tbl-label = "CAMIF_MCLK0", "CAM_RESET0";

        // 时钟配置
        clocks = <&clock_camcc CAM_CC_MCLK0_CLK>;
        clock-names = "cam_clk";
        qcom,clock-rates = <24000000>;

        // 物理信息
        qcom,sensor-position = <0>;  // 0:后置, 1:前置
        qcom,sensor-mode = <0>;
        qcom,cci-master = <0>;
        status = "ok";
    };
};

4.3 关键属性对照表

4.4 EEPROM设备树节点

EEPROM用于存储Sensor的校准数据（如AWB、AF、LSC参数）。节点通常挂在与Sensor相同的I2C总线下：

&cci_i2c_0 {
    eeprom_0: qcom,eeprom@0x50 {
        compatible = "qcom,eeprom";
        reg = <0x50>;
        qcom,slave-addr = <0xA0>;  // 8位地址
        qcom,i2c-freq-mode = <1>;   // 1:标准模式, 2:快速模式

        // 电源配置（通常与Sensor共用）
        qcom,cam-vreg-name = "cam_vio";
        qcom,cam-vreg-min-voltage = <1800000>;
        qcom,cam-vreg-max-voltage = <1800000>;
        qcom,cam-vreg-op-mode = <100000>;

        // 读取参数
        qcom,num-blocks = <1>;
        qcom,page0 = <0 0x00 1 0x00 1 0>;
        qcom,poll0 = <0 0x00 1 0x00 1 0>;
        qcom,mem0 = <0x100 0x00 2 0x00 1 0>;

        status = "ok";
    };
};

4.5 Actuator设备树节点

Actuator（马达驱动）用于控制镜头对焦。高通平台支持VCM（音圈马达）和Piezo（压电）两种类型：

&cci_i2c_0 {
    actuator_0: qcom,actuator@0x0c {
        compatible = "qcom,actuator";
        reg = <0x0c>;
        qcom,slave-addr = <0x18>;

        // 马达类型
        qcom,actuator-type = <1>;  // 0:VCM, 1:Piezo

        // 电源
        qcom,cam-vreg-name = "cam_vaf";
        qcom,cam-vreg-min-voltage = <2800000>;
        qcom,cam-vreg-max-voltage = <2800000>;
        qcom,cam-vreg-op-mode = <100000>;

        // 行程参数
        qcom,actuator-macro-step = <0x100>;
        qcom,actuator-macro-time = <100>;
        qcom,actuator-init-delay = <2>;

        status = "ok";
    };
};

4.6 Flash设备树节点

Flash节点控制闪光灯（LED或氙气灯），通常挂在I2C总线或作为独立GPIO设备：

&cci_i2c_1 {
    flash_0: qcom,led-flash@0x63 {
        compatible = "qcom,led-flash";
        reg = <0x63>;
        qcom,slave-addr = <0xC6>;

        // 闪光灯电流参数
        qcom,flash-max-current = <1000>;  // mA
        qcom,torch-max-current = <200>;   // mA
        qcom,flash-max-time = <1200>;     // ms

        // GPIO使能
        gpios = <&tlmm 104 0>;
        qcom,gpio-flash-en = <0>;
        qcom,gpio-flash-now = <1>;

        status = "ok";
    };
};

4.7 常见配置错误与定位方法

以下是在实际项目适配中最高频出现的设备树配置错误，按影响程度排序：

4.8 设备树配置检查流程

在提交代码前，建议按以下步骤逐项验证设备树配置的正确性：

1. 语法检查：使用 dtc -I dts -O dtb xxx.dts 编译，确保无语法错误。
2. 地址验证：对照Sensor datasheet确认所有I2C地址（reg + slave-addr）正确。
3. GPIO核对：逐项比对原理图中的GPIO编号与dts中的gpios属性。
4. 电源完整性：检查所有cam-vreg-name对应的regulator节点是否存在且电压范围正确。
5. 引用关系：确认actuator-src、eeprom-src、led-flash-src的phandle指向正确的节点。
6. 总线归属：确保Sensor和其附属设备挂在同一个CCI I2C总线节点下。
7. 状态使能：确认所有Camera相关节点status = "ok"。

4.9 设备树与HAL层的接口约定

设备树中的配置最终通过Kernel驱动解析，并通过V4L2子设备接口暴露给HAL层。以下SVG图展示了从设备树到HAL层的数据流：

HAL层通过 /dev/video* 节点与Kernel驱动交互，设备树中配置的电源、GPIO、时钟等参数在驱动probe阶段被解析并应用到硬件上。如果设备树配置错误，HAL层将无法正确枚举设备或控制硬件。