2. DTS语法入门

设备树源文件（.dts）是一种结构化的、人类可读的硬件描述语言。其核心语法围绕四个基本元素展开：节点（Node）、属性（Property）、标签（Label） 和 包含文件（#include）。掌握这些基础语法是编写和调试 DTS 文件的起点。

2.1 节点（Node）：硬件拓扑的骨架

节点是设备树的基本组成单元，用于描述一个硬件设备或总线。每个节点代表一个设备，节点内部可以包含子节点，形成树状结构。根节点 / 是整个设备树的起点。

/ {
    // 根节点，代表整个 SoC 板级系统
    model = "Embedded Linux Board v1.0";
    compatible = "vendor,board-name";

    // 子节点：CPU 描述
    cpus {
        #address-cells = <1>;
        #size-cells = <0>;
        cpu@0 {
            compatible = "arm,cortex-a7";
            reg = <0x0>;
        };
    };

    // 子节点：内存描述
    memory@80000000 {
        device_type = "memory";
        reg = <0x80000000 0x20000000>;  // 起始地址 0x80000000，大小 512MB
    };

    // 子节点：串口设备
    uart0: serial@10000000 {
        compatible = "ns16550a";
        reg = <0x10000000 0x1000>;
        interrupts = <0 33 4>;
    };
};

2.2 属性（Property）：描述设备的元数据

属性是附着在节点上的键值对，用于描述设备的特性、地址、中断、时钟等信息。属性值可以是空、整数、字符串、字节数组或这些类型的组合。

2.3 标签（Label）：节点的引用别名

标签是给节点起的一个别名，用于在 DTS 文件的其他位置引用该节点。标签定义在节点名前，使用冒号 : 分隔。引用时使用 &label 语法。

// 定义标签
uart0: serial@10000000 {
    compatible = "ns16550a";
    reg = <0x10000000 0x1000>;
    interrupts = <0 33 4>;
};

// 在其他地方引用标签，追加或修改属性
&uart0 {
    pinctrl-0 = <&uart0_pins>;
    status = "okay";
};

2.4 包含文件（#include）：模块化与复用

DTS 支持 C 预处理器指令 #include，用于引入头文件（.h）或其他设备树源文件（.dtsi）。这是实现设备树模块化和复用的关键机制。

// 包含 SoC 级设备树头文件，定义宏和通用节点
#include "am335x.dtsi"

// 包含板级特定配置
#include "am335x-bone-common.dtsi"

// 包含 GPIO 编号宏定义
#include <dt-bindings/gpio/gpio.h>

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

    // 使用宏定义 GPIO 引脚
    led0 {
        compatible = "gpio-leds";
        pinctrl-0 = <&user_led_pins>;
        led@0 {
            label = "usr0";
            gpios = <&gpio1 21 GPIO_ACTIVE_HIGH>;  // GPIO1_21
            default-state = "on";
        };
    };
};

2.5 实战要点与常见错误