2. DTS 文件结构：标准节点写法详解

设备树源文件（.dts）以树形结构描述硬件拓扑。本章逐一拆解 /dts-v1/ 头部、根节点、别名节点、chosen、memory 和 cpus 节点的标准写法与工程约束。

2.1 /dts-v1/ 版本标识

每个 .dts 文件的第一行必须是版本声明，告诉编译器使用设备树 v1 规范。

/dts-v1/;

该行之后可紧跟 /include/ 或 #include 导入头文件。若省略此声明，dtc 编译器会报错或默认使用旧版格式，导致节点解析异常。

2.2 根节点（Root Node）

根节点是设备树的顶层容器，使用 / 表示。所有外设、总线、CPU、内存等节点都挂在根节点下。

/ {
    model = "TI AM335x BeagleBone Black";
    compatible = "ti,am335x-bone-black", "ti,am335x-bone", "ti,am33xx";
    #address-cells = <1>;
    #size-cells = <1>;

    /* 子节点 */
    chosen { ... };
    memory { ... };
    cpus { ... };
    ocp { ... };
};

2.3 别名节点（aliases）

别名节点为其他节点提供简短、固定的符号名称，常用于 bootloader 或早期启动代码快速查找设备。

aliases {
    serial0 = &uart0;
    serial1 = &uart1;
    mmc0 = &mmc1;
    i2c0 = &i2c0;
    ethernet0 = &cpsw_emac0;
};

2.4 chosen 节点

chosen 节点不描述硬件，而是传递系统运行时参数给内核，由 bootloader 动态填充。

chosen {
    bootargs = "console=ttyO0,115200 root=/dev/mmcblk0p2 rw rootfstype=ext4";
    stdout-path = &uart0;
    linux,initrd-start = <0x82000000>;
    linux,initrd-end   = <0x82800000>;
};

2.5 memory 节点

memory 节点描述系统物理内存的起始地址和大小。U-Boot 通常会在启动时动态更新此节点。

memory {
    device_type = "memory";
    reg = <0x80000000 0x20000000>;  /* 起始 0x80000000，大小 512 MB */
};

2.6 cpus 节点

cpus 节点是 CPU 核心的容器，每个 CPU 核心作为一个子节点，必须包含 #address-cells 和 #size-cells。

cpus {
    #address-cells = <1>;
    #size-cells = <0>;

    cpu@0 {
        compatible = "arm,cortex-a8";
        device_type = "cpu";
        reg = <0>;
        clocks = <&dpll_mpu_ck>;
        clock-latency = <300000>;  /* 纳秒 */
    };

    cpu@1 {
        compatible = "arm,cortex-a8";
        device_type = "cpu";
        reg = <1>;
        clocks = <&dpll_mpu_ck>;
        clock-latency = <300000>;
    };
};

2.7 节点标准写法总结