2. 设备树语法入门：DTS文件结构、节点、属性、标签与包含文件

设备树（Device Tree）是一种描述硬件资源的数据结构，它使用树形节点来记录CPU、内存、外设、中断、GPIO等硬件信息。在嵌入式Linux中，设备树源文件（.dts）经过编译生成设备树二进制文件（.dtb），由Bootloader传递给内核，内核据此完成设备驱动与硬件资源的绑定。

2.1 DTS文件整体结构

一个典型的.dts文件由以下部分组成：

• 根节点：/，整个设备树的起点。
• 节点（node）：描述一个硬件设备或总线，可嵌套子节点。
• 属性（property）：键值对，描述节点的特性（地址、中断、时钟等）。
• 标签（label）：为节点或属性起别名，便于引用。
• 包含文件（dtsi）：通过#include引入公共硬件描述，实现复用。

2.2 节点（node）

节点是设备树的基本单元，每个节点代表一个硬件设备、总线或功能块。节点可以嵌套，形成树状层级。

/dts-v1/;

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

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

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

    &i2c0 {
        status = "okay";
        eeprom@50 {
            compatible = "atmel,24c32";
            reg = <0x50>;
        };
    };
};

2.3 属性（property）

属性是节点的数据载体，驱动通过读取属性获取硬件参数。属性值支持多种数据类型。

2.4 标签（label）

标签为节点或属性提供别名，便于在多个.dts/.dtsi文件中引用和修改节点。

// 定义标签
i2c0: i2c@4802a000 {
    compatible = "ti,omap4-i2c";
    reg = <0x4802a000 0x1000>;
    #address-cells = <1>;
    #size-cells = <0>;
    status = "disabled";
};

// 在其他文件中通过 & 引用标签，追加或修改属性
&i2c0 {
    status = "okay";
    clock-frequency = <400000>;
};

2.5 包含文件（dtsi）

.dtsi 文件是设备树的“头文件”，用于存放SoC公共硬件描述。一个SoC平台通常有一个主.dtsi，多个板级.dts通过#include引入并定制。

// am335x.dtsi (SoC公共定义)
#include <dt-bindings/gpio/gpio.h>
#include <dt-bindings/interrupt-controller/irq.h>

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

// am335x-boneblack.dts (板级定制)
/dts-v1/;
#include "am335x.dtsi"

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

    memory@80000000 {
        device_type = "memory";
        reg = <0x80000000 0x20000000>;
    };
};

&uart0 {
    status = "okay";
};

2.6 设备树语法结构总览

2.7 设备树编译与反编译