3. 设备树语法基础：节点、属性、标签、路径的语法规则

设备树（Device Tree）是一种描述硬件资源的树形数据结构，其语法简洁、层次分明。掌握节点（node）、属性（property）、标签（label）和路径（path）的语法规则，是编写和解析设备树源文件（.dts）的基础。本章将逐一拆解这四个核心要素，并通过对比表格和可视化 SVG 图帮助理解。

3.1 节点（Node）—— 树形结构的骨架

节点是设备树的基本组成单元，代表一个硬件设备或总线。每个节点可以包含子节点，形成从根到叶的层次关系。

3.1.1 节点定义语法

node-name {
    property1 = <value>;
    property2 = "string";
    child-node {
        ...
    };
};

• 节点名称：由字母、数字、连字符（-）、下划线（_）组成，必须以字母开头。
• 节点体：用花括号 { } 包裹，内部包含属性和子节点。
• 结束符：每个节点定义后必须加分号 ;。

3.1.2 根节点与特殊节点

3.2 属性（Property）—— 节点的数据载体

属性是节点内部用于描述硬件特性的键值对。属性值可以是整数、字符串、字节数组或它们的组合。

3.2.1 属性值类型与语法

3.2.2 标准属性速查

• compatible：驱动匹配的关键，格式为 "厂商,设备型号"。
• reg：描述设备地址空间，格式为 <地址 长度>。
• interrupts：描述中断号、触发类型。
• clocks：引用时钟源。
• status：设备状态，可选 "okay"、"disabled"、"reserved"。

3.3 标签（Label）—— 节点的引用别名

标签是附加在节点名称前面的标识符，用于在其他位置引用或覆盖该节点。标签可以显著提高设备树的可维护性。

3.3.1 标签定义语法

uart0: serial@44e09000 {
    compatible = "ti,am3352-uart";
    reg = <0x44e09000 0x2000>;
    interrupts = <72>;
};

在上例中，uart0 就是标签。通过标签，可以在其他 .dtsi 或 .dts 文件中直接引用该节点：

&uart0 {
    status = "okay";
    pinctrl-0 = <&uart0_pins>;
};

3.3.2 标签的三大用途

3.4 路径（Path）—— 节点的唯一地址

路径是从根节点到目标节点的完整字符串表示，类似于文件系统中的绝对路径。路径用于在设备树中唯一标识一个节点。

3.4.1 路径语法规则

• 以根节点 / 开头。
• 各级节点名称用斜杠 / 分隔。
• 节点名称可以包含 @ 后的地址部分（如 serial@44e09000）。
• 路径末尾不加斜杠。

示例路径：

/soc/serial@44e09000
/cpus/cpu@0
/aliases
/chosen

3.4.2 路径与标签的对比

3.5 四要素关系 SVG 图

下图展示了节点、属性、标签、路径在设备树中的组织关系：

3.6 综合语法示例

以下是一个完整的设备树片段，综合展示了节点、属性、标签和路径的用法：

/dts-v1/;

/ {
    model = "TI AM335x BeagleBone Black";
    compatible = "ti,am335x-bone-black", "ti,am335x-bone", "ti,am33xx";

    cpus {
        cpu@0 {
            compatible = "arm,cortex-a8";
            device_type = "cpu";
            reg = <0x0>;
        };
    };

    memory@80000000 {
        device_type = "memory";
        reg = <0x80000000 0x10000000>;  /* 256 MB */
    };

    chosen {
        bootargs = "console=ttyO0,115200 root=/dev/mmcblk0p2 rw";
    };

    aliases {
        serial0 = &uart0;
        i2c0 = &i2c0;
    };

    soc {
        uart0: serial@44e09000 {
            compatible = "ti,am3352-uart";
            reg = <0x44e09000 0x2000>;
            interrupts = <72>;
            status = "okay";
        };

        i2c0: i2c@48020000 {
            compatible = "ti,omap4-i2c";
            reg = <0x48020000 0x1000>;
            interrupts = <70>;
            status = "okay";
            clock-frequency = <400000>;
        };
    };
};

3.7 常见语法错误与避坑指南

3.8 本章小结

• 节点是设备树的骨架，通过嵌套结构描述硬件层次。
• 属性是节点的数据内容，支持整数、字符串、字节数组等多种类型。
• 标签是节点的引用别名，用于跨文件覆盖和扩展节点。
• 路径是节点的唯一地址，从根节点开始逐级定位。
• 四要素协同工作，构成了设备树描述硬件的基础语法体系。