4. 设备树(Device Tree)基础：DTS语法、节点、属性、reg、compatible、status等关键属性

在车载Linux系统中，设备树(Device Tree)是描述硬件拓扑结构的核心机制。它替代了传统板级文件中的大量硬件编码，将硬件配置信息从内核源码中剥离，形成独立的数据结构。对于I2C设备挂载而言，设备树是驱动与硬件之间的“桥梁”——驱动通过解析设备树节点获取设备地址、中断号、时序参数等关键信息。

4.1 设备树源文件(DTS)语法基础

设备树源文件(.dts)采用树形层级结构，以节点(node)为基本单元，每个节点包含若干属性(property)。其语法简洁，类似C语言风格，但无执行逻辑，仅描述硬件。

// 最小设备树示例
/dts-v1/;

/ {
    model = "TI AM62x Automotive EVM";
    compatible = "ti,am62x-evm", "ti,am62x";

    #address-cells = <2>;
    #size-cells = <2>;

    soc {
        #address-cells = <2>;
        #size-cells = <2>;
        ranges;

        i2c@2000000 {
            compatible = "ti,am62-i2c", "simple-bus";
            reg = <0x00 0x02000000 0x00 0x100>;
            #address-cells = <1>;
            #size-cells = <0>;
            status = "okay";
            clock-frequency = <400000>;

            temp-sensor@48 {
                compatible = "ti,tmp102";
                reg = <0x48>;
                status = "okay";
            };
        };
    };
};

4.2 节点与属性详解

设备树中每个节点代表一个硬件设备或总线控制器，属性则描述设备的配置参数。下表列出车载I2C场景中最关键的属性及其含义：

4.3 关键属性深度解析

4.3.1 compatible —— 驱动匹配的“身份证”

compatible 是设备树中最核心的匹配属性。内核通过该属性将设备节点与驱动绑定。其值通常为 "厂商,型号" 格式，支持多个备选值，内核按优先级依次尝试匹配。

4.3.2 reg —— 地址与地址空间

reg 属性描述设备的地址信息。对于I2C设备，它表示从设备地址(7位或10位)；对于I2C控制器，它表示寄存器基址和长度。其格式由父节点的 #address-cells 和 #size-cells 决定。

// I2C控制器节点：reg = <基址高32位 基址低32位 长度高32位 长度低32位>
// 当 #address-cells=<2>, #size-cells=<2> 时
reg = <0x00 0x02000000 0x00 0x100>;

// I2C从设备节点：reg = <从设备地址>
// 当 #address-cells=<1>, #size-cells=<0> 时
reg = <0x48>;  // 7位地址0x48

4.3.3 status —— 设备启用控制

status 属性控制设备是否被内核枚举。在车载开发中，常利用该属性在调试阶段临时禁用设备，或在产品变体中通过设备树覆盖(overlay)启用/禁用特定外设。

4.4 I2C设备树节点结构图

下图展示车载I2C子系统中，从SoC级总线到具体传感器设备的完整设备树层级关系：

4.5 设备树覆盖(Overlay)与车载调试

在车载开发中，设备树覆盖机制允许在不重新编译整个设备树的情况下，动态添加或修改I2C设备节点。这对于调试阶段频繁更换传感器型号、调整I2C地址非常实用。

// I2C设备树覆盖示例：添加一个调试用的温度传感器
// 文件：tmp102-overlay.dts

/dts-v1/;
/plugin/;

/ {
    fragment@0 {
        target = &i2c0;  // 引用I2C控制器
        __overlay__ {
            #address-cells = <1>;
            #size-cells = <0>;

            tmp102@48 {
                compatible = "ti,tmp102";
                reg = <0x48>;
                status = "okay";
            };
        };
    };
};

4.6 常见I2C设备树配置错误与排查

4.7 设备树编译与反编译

设备树源文件(.dts)需要编译为二进制设备树(.dtb)才能被内核加载。车载开发中常用的操作命令：

# 编译设备树
dtc -I dts -O dtb -o am62x-evm.dtb am62x-evm.dts

# 反编译设备树（调试用）
dtc -I dtb -O dts -o am62x-evm-decompiled.dts am62x-evm.dtb

# 查看设备树中I2C节点
dtc -I dtb -O dts am62x-evm.dtb | grep -A 20 "i2c@"

# 验证设备树语法
dtc -I dts -O dtb -o /dev/null am62x-evm.dts 2>&1

4.8 本章小结