4. 设备树基础：设备树语法回顾、节点与属性、reg与interrupts属性

4.1 设备树语法快速回顾

设备树（Device Tree）是一种描述硬件资源的数据结构，由节点（node）和属性（property）组成。在MIPI CSI驱动开发中，设备树是连接硬件物理连接与软件驱动的桥梁。其核心语法遵循以下规则：

• 节点（Node）：以 node-name@unit-address 格式定义，表示一个硬件设备或总线。
• 属性（Property）：键值对，用于描述节点的特性，如地址、中断、时钟、GPIO等。
• 标签（Label）：通过 label: node-name 方式定义，便于在其他节点中引用。
• 包含（Include）：使用 #include 导入头文件或dtsi文件。

4.2 节点与属性详解

节点是设备树的基本单元，属性则提供节点的具体信息。以下是一个典型的MIPI CSI摄像头传感器节点示例：

// 摄像头传感器节点
&i2c2 {
    status = "okay";
    clock-frequency = <400000>;

    ov5640: camera@3c {
        compatible = "ovti,ov5640";
        reg = <0x3c>;
        clocks = <&clks IMX8MM_CLK_CLKO2>;
        clock-names = "xvclk";
        pinctrl-names = "default";
        pinctrl-0 = <&pinctrl_csi_pwn>;
        reset-gpios = <&gpio1 8 GPIO_ACTIVE_LOW>;
        powerdown-gpios = <&gpio1 9 GPIO_ACTIVE_HIGH>;

        port {
            ov5640_ep: endpoint {
                remote-endpoint = <&csi_ep>;
                bus-type = <MEDIA_BUS_TYPE_CSI2_CPHY>;
                data-lanes = <1 2>;
                clock-lanes = <0>;
                clock-noncontinuous;
            };
        };
    };
};

4.3 reg属性：地址与地址空间

reg 属性用于描述设备在总线上的地址或寄存器地址范围。其格式为 reg = <address1 length1 address2 length2 ...>。在MIPI CSI场景中，reg 通常表示I2C从设备地址或CSI控制器的寄存器基址。

// I2C设备地址示例
reg = <0x3c>;  // 7位I2C地址

// 内存映射设备示例（CSI控制器）
csi: csi@32e30000 {
    compatible = "fsl,imx8mm-csi";
    reg = <0x32e30000 0x10000>;  // 基址0x32e30000，长度0x10000
    interrupts = <GIC_SPI 19 IRQ_TYPE_LEVEL_HIGH>;
};

4.4 interrupts属性：中断配置

interrupts 属性用于描述设备的中断信号。其格式依赖于中断控制器类型，常见格式为 interrupts = <中断号 触发类型>。在ARM GIC（通用中断控制器）中，格式为 <中断类型 中断号 触发类型>。

// GIC中断示例
interrupts = <GIC_SPI 19 IRQ_TYPE_LEVEL_HIGH>;

// 简单中断控制器示例
interrupts = <10 IRQ_TYPE_EDGE_RISING>;

4.5 设备树结构SVG图

4.6 实战：解析MIPI CSI设备树片段

以下是一个完整的MIPI CSI设备树配置片段，包含CSI主机控制器和摄像头传感器：

// CSI主机控制器节点
csi: csi@32e30000 {
    compatible = "fsl,imx8mm-csi";
    reg = <0x32e30000 0x10000>;
    interrupts = <GIC_SPI 19 IRQ_TYPE_LEVEL_HIGH>;
    clocks = <&clks IMX8MM_CLK_CSI>;
    clock-names = "mclk";
    status = "disabled";

    port {
        csi_ep: endpoint {
            remote-endpoint = <&ov5640_ep>;
            bus-type = <MEDIA_BUS_TYPE_CSI2_CPHY>;
            data-lanes = <1 2>;
            clock-lanes = <0>;
        };
    };
};

// I2C总线上的摄像头传感器
&i2c2 {
    status = "okay";
    clock-frequency = <400000>;

    ov5640: camera@3c {
        compatible = "ovti,ov5640";
        reg = <0x3c>;
        clocks = <&clks IMX8MM_CLK_CLKO2>;
        clock-names = "xvclk";
        pinctrl-names = "default";
        pinctrl-0 = <&pinctrl_csi_pwn>;
        reset-gpios = <&gpio1 8 GPIO_ACTIVE_LOW>;
        powerdown-gpios = <&gpio1 9 GPIO_ACTIVE_HIGH>;
        status = "okay";

        port {
            ov5640_ep: endpoint {
                remote-endpoint = <&csi_ep>;
                bus-type = <MEDIA_BUS_TYPE_CSI2_CPHY>;
                data-lanes = <1 2>;
                clock-lanes = <0>;
                clock-noncontinuous;
            };
        };
    };
};

4.7 常见错误与排查方法