3. DTS 语法基础：节点、属性、标签的定义与格式

设备树源文件（.dts）是一种结构化的文本描述语言，其核心由节点（Node）、属性（Property）和标签（Label）三大要素构成。理解这三者的定义与格式，是编写和解析设备树的基础。

3.1 节点（Node）的定义与格式

节点是设备树的基本组成单元，用于表示一个硬件设备、总线、控制器或功能模块。每个节点在树形结构中都有一个唯一的路径。

3.1.1 节点定义语法

[label:] node-name [@unit-address] {
    [property-list]
    [child-node-list]
};

• node-name：节点名称，通常为通用名称（如 uart、i2c、gpio），长度 1-31 个字符。
• @unit-address：可选，用于区分同一层级中相同名称的节点，通常为寄存器基地址或设备编号。
• label：可选，为节点定义一个标签，便于引用。
• property-list：零个或多个属性定义。
• child-node-list：零个或多个子节点定义。

3.1.2 节点示例

/ {
    #address-cells = <1>;
    #size-cells = <1>;

    uart0: serial@101f0000 {
        compatible = "ns16550";
        reg = <0x101f0000 0x1000>;
        interrupts = <5>;
        clock-frequency = <1843200>;
    };

    i2c@101f2000 {
        compatible = "snps,designware-i2c";
        reg = <0x101f2000 0x1000>;
        #address-cells = <1>;
        #size-cells = <0>;

        eeprom@50 {
            compatible = "atmel,24c02";
            reg = <0x50>;
        };
    };
};

3.2 属性（Property）的定义与格式

属性用于描述节点的特征和配置信息，如硬件地址、中断号、时钟频率、兼容性等。属性由键（Key）和值（Value）组成。

3.2.1 属性值类型

3.2.2 常用标准属性

3.3 标签（Label）的定义与使用

标签是设备树中的引用机制，允许为节点或属性定义一个别名，便于在 .dtsi 文件或同一文件的其他位置进行引用和覆盖。

3.3.1 标签定义语法

label: node-name {
    // 节点内容
};

标签位于节点名称之前，以冒号分隔。标签名必须唯一，遵循 C 语言标识符命名规则（字母、数字、下划线，不能以数字开头）。

3.3.2 标签引用方式

3.3.3 标签使用示例

// 定义标签
uart0: serial@101f0000 {
    compatible = "ns16550";
    reg = <0x101f0000 0x1000>;
    status = "disabled";
};

// 在另一个文件中通过标签引用并修改
&uart0 {
    status = "okay";
    clock-frequency = <1843200>;
};

3.4 节点、属性、标签的完整示例

以下是一个综合示例，展示三者在实际设备树中的协作关系：

// 根节点
/ {
    model = "TI AM335x Board";
    compatible = "ti,am335x-evm", "ti,am335x";
    #address-cells = <1>;
    #size-cells = <1>;

    // 带标签的 UART 节点
    uart0: serial@44e09000 {
        compatible = "ti,am335x-uart", "ns16550";
        reg = <0x44e09000 0x2000>;
        interrupts = <72>;
        status = "disabled";
    };

    // 带标签的 GPIO 控制器
    gpio0: gpio@44e07000 {
        compatible = "ti,am335x-gpio";
        reg = <0x44e07000 0x1000>;
        interrupts = <96>;
        #gpio-cells = <2>;
        gpio-controller;
    };
};

// 通过标签引用并启用 UART
&uart0 {
    status = "okay";
    pinctrl-names = "default";
    pinctrl-0 = <&uart0_pins>;
};

// 通过标签引用 GPIO 并定义引脚
&gpio0 {
    uart0_pins: pinmux_uart0_pins {
        pinctrl-single,pins = <
            0x10 0x30  // P1_0: uart0_rxd
            0x14 0x10  // P1_1: uart0_txd
        >;
    };
};

3.5 常见错误与避坑指南