2. DTS文件结构：DTS、DTSI、DTB、DTC的关系与编译流程

设备树（Device Tree）在Linux内核驱动开发中扮演着硬件描述的核心角色。理解DTS、DTSI、DTB、DTC这四个关键概念及其转换流程，是掌握设备树编程的第一步。本章将系统梳理这些文件类型的功能定位、语法差异以及从源文件到二进制文件的完整编译链路。

2.1 核心概念与文件类型

设备树体系包含四种主要文件形态，它们分别处于开发、编译、分发和运行的不同阶段：

2.2 文件关系与包含机制

一个典型的板级设备树项目，通常由一个主 .dts 文件通过 #include 预处理器指令引入多个 .dtsi 文件，形成层次化的描述结构：

// 主文件：imx6ull-myboard.dts
#include "imx6ull.dtsi"          // SoC 级定义
#include "imx6ull-pinfunc.h"     // 引脚复用宏定义
#include "myboard-lcd.dtsi"      // 板级外设模块

/ {
    model = "MyBoard i.MX6ULL";
    compatible = "myboard,imx6ull", "fsl,imx6ull";

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

    &uart1 {
        pinctrl-names = "default";
        pinctrl-0 = <&pinctrl_uart1>;
        status = "okay";
    };
};

2.3 编译流程：从源文件到二进制文件

DTC 编译器将可读的 .dts 源文件转换为紧凑的 .dtb 二进制文件，整个过程分为三个阶段：

1. 预处理阶段： C预处理器（cpp）处理 #include、#define、#ifdef 等指令，展开所有宏和头文件，生成一个完整的、无依赖的临时 .dts 文件。
2. 解析与语法检查阶段： DTC 解析器读取预处理后的 .dts，构建内部节点树，检查语法错误、属性合法性、节点唯一性等。
3. 二进制输出阶段： DTC 将验证通过的设备树结构序列化为 FDT（Flattened Device Tree）格式的 .dtb 文件，包含节点、属性、字符串表、内存保留区等。

2.4 编译与反编译命令

DTC 工具支持正向编译和反向反编译，方便开发者调试和验证设备树内容：

# 正向编译：.dts → .dtb
dtc -I dts -O dtb -o myboard.dtb myboard.dts

# 反编译：.dtb → .dts（还原为可读文本）
dtc -I dtb -O dts -o myboard.dts myboard.dtb

# 查看 .dtb 内部结构（不生成文件）
dtc -I dtb -O dts /sys/firmware/devicetree/base | head -100

# 编译时指定头文件搜索路径
dtc -I dts -O dtb -o myboard.dtb -I /path/to/include myboard.dts

2.5 编译流程SVG架构图

下图展示了从 .dts/.dtsi 源文件到 .dtb 二进制文件的完整编译链路，以及反编译和运行时访问的路径：

2.6 编译产物与内核加载

编译生成的 .dtb 文件在系统启动过程中由 Bootloader（如 U-Boot）加载到内存，并将起始地址传递给内核。内核在启动早期解析 FDT 格式，构建设备树结构，驱动框架据此完成设备枚举和资源分配：

# U-Boot 中加载设备树的典型命令序列
load mmc 0:1 ${fdt_addr_r} imx6ull-myboard.dtb
load mmc 0:1 ${kernel_addr_r} zImage
bootz ${kernel_addr_r} - ${fdt_addr_r}

2.7 常见问题与避坑指南

• 头文件路径错误： 编译时未指定 -I 参数导致 #include 找不到 .dtsi 文件。解决方案：确保包含路径指向内核源码的 arch/arm/boot/dts/ 目录。
• 节点标签重复： 多个 .dtsi 中定义了相同名称的标签（label），导致编译冲突。解决方案：使用 &label 引用时确保标签唯一，或通过 /delete-node/ 删除冲突节点。
• 属性值类型不匹配： 如 reg 属性中地址长度与 #address-cells 不一致。解决方案：严格遵循 #address-cells 和 #size-cells 的定义。
• 反编译后无法重新编译： 反编译生成的 .dts 可能包含 __symbols__ 等内部节点，直接编译会报错。解决方案：使用 -f 强制编译，或手动清理无关节点。