4. 根节点与模型：根节点(/)定义、model属性、compatible属性、版本信息

设备树的根节点是整个硬件描述树的起点，使用斜杠 / 表示。所有其他节点（如 CPU、内存、外设总线）都是根节点的子节点或后代节点。根节点本身也包含若干关键属性，用于描述整个设备的模型、兼容性以及设备树版本信息。

4.1 根节点的定义与结构

在 DTS 文件中，根节点通常位于文件的最顶层，其定义方式如下：

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

    chosen { };
    memory@80000000 { };
    cpus { };
    ocp { };
};

根节点必须包含 model 和 compatible 属性，这是设备树规范的基本要求。此外，#address-cells 和 #size-cells 用于定义子节点中地址和长度字段的宽度（以 32 位字为单位）。

4.2 model 属性：设备型号标识

model 属性是一个字符串，用于精确标识硬件平台的型号名称。它通常包含制造商名称和产品型号，格式为 "制造商,产品型号"。

model 属性的主要用途：

• 调试与日志：内核启动时打印 model 字符串，帮助开发者确认当前运行的硬件平台。
• 用户空间识别：通过 /proc/device-tree/model 文件读取，用户态程序可据此判断硬件类型。
• 固件与引导加载程序：U-Boot 等引导程序可根据 model 选择不同的设备树覆盖或配置。

4.3 compatible 属性：操作系统匹配的核心

compatible 属性是设备树中最重要的属性之一，它定义了设备与操作系统驱动之间的匹配关系。该属性是一个字符串列表，每个字符串代表一个兼容的设备型号，按从最具体到最通用的顺序排列。

compatible = "ti,am335x-bone-black", "ti,am335x-bone", "ti,am33xx";

匹配规则：

1. 操作系统（如 Linux 内核）在启动时读取根节点的 compatible 属性。
2. 内核遍历字符串列表，依次尝试与注册的 DT_MACHINE 或 of_device_id 匹配。
3. 匹配成功则加载对应的板级初始化代码或设备驱动。
4. 如果所有字符串都匹配失败，内核可能无法正确初始化该平台。

4.4 版本信息与设备树版本

设备树本身也有版本概念，主要通过以下方式体现：

在 DTB 文件头部，设备树编译器会写入以下版本相关字段：

• boot_param_header 版本：标识 DTB 头部结构的版本号，目前通常为 17。
• totalsize：DTB 文件总大小，用于解析器分配内存。
• off_dt_struct 和 off_dt_strings：指向设备树结构和字符串块的偏移量。

4.5 根节点结构图

下图展示了根节点及其核心属性的层次关系，以及它们如何与操作系统交互：

4.6 根节点属性对比表

下表总结了根节点中常见属性的用途、格式和注意事项：

4.7 实践案例：编写根节点

假设我们要为一块基于 NXP i.MX6ULL 的工控板编写根节点，硬件信息如下：

• 板级型号：MYD-Y6ULL-14x14
• SoC 系列：fsl,imx6ull
• 内存地址空间：32 位
• 引导控制台：串口 1

对应的根节点定义如下：

/ {
    model = "MYiR MYD-Y6ULL-14x14 Board";
    compatible = "myir,myd-y6ull-14x14", "fsl,imx6ull";
    #address-cells = <1>;
    #size-cells = <1>;

    chosen {
        stdout-path = &uart1;
        bootargs = "console=ttymxc0,115200 root=/dev/mmcblk0p2 rootwait";
    };

    aliases {
        mmc0 = &usdhc1;
        mmc1 = &usdhc2;
        serial0 = &uart1;
    };

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

4.8 常见错误与排查