3、设备树编译与反编译：DTC工具使用、DTS到DTB的编译过程、DTB反编译为DTS

设备树源文件（.dts）是人类可读的文本描述，而内核引导时实际使用的是二进制格式的设备树 Blob（.dtb）。从 .dts 到 .dtb 的转换，以及逆向的还原操作，都依赖 DTC（Device Tree Compiler） 工具完成。本章深入讲解 DTC 的使用方法、编译与反编译的完整流程，以及常见问题的排查手段。

3.1 DTC 工具概述

DTC 是设备树编译器的标准实现，通常作为 Linux 内核源码树的一部分发布，路径为 scripts/dtc/。它支持三种文件格式的相互转换：

DTC 工具的核心命令行格式如下：

# 编译：DTS → DTB
dtc -I dts -O dtb -o output.dtb input.dts

# 反编译：DTB → DTS
dtc -I dtb -O dts -o output.dts input.dtb

# 常用调试选项
dtc -I dts -O dtb -o output.dtb -@ input.dts   # 保留符号（用于插件）
dtc -I dts -O dtb -o output.dtb -Wno-unit_address_vs_reg input.dts  # 忽略特定警告

3.2 DTS 到 DTB 的编译过程

编译过程并非简单的文本替换，而是经过词法分析、语法解析、节点合并、属性校验、二进制编码等多个阶段。下图展示了完整的编译流水线：

编译过程中，DTC 会执行以下关键步骤：

1. 预处理：调用 C 预处理器（cpp）处理 #include、#define 等指令，将 .dtsi 文件内容展开到主文件中。
2. 词法与语法分析：解析 DTS 语法，构建抽象语法树（AST）。此阶段会报告格式错误，如缺少分号、花括号不匹配等。
3. 节点合并与覆盖：根据标签（label）和路径规则，合并同名节点，处理属性覆盖。例如，多个 &uart1 引用会被合并为一个节点。
4. 属性校验：检查 reg、interrupts 等属性的格式、长度和范围，输出警告或错误。
5. 二进制编码：将校验通过的结构扁平化为 FDT（Flattened Device Tree）格式，生成 .dtb 文件。

3.3 DTB 反编译为 DTS

反编译是将二进制 DTB 还原为可读的 DTS 文本，常用于分析现有固件、验证编译结果、或从运行中的系统提取设备树。反编译过程是编译的逆过程，但会丢失部分信息：

反编译的基本命令：

# 标准反编译
dtc -I dtb -O dts -o decompiled.dts original.dtb

# 反编译并保留符号（用于调试 overlay）
dtc -I dtb -O dts -o decompiled.dts -@ original.dtb

# 从 /sys/firmware/devicetree 反编译运行中的系统
dtc -I fs -O dts -o running.dts /sys/firmware/devicetree/base

3.4 编译与反编译的典型应用场景

下表总结了 DTC 工具在不同开发阶段的具体用途：

3.5 反编译结果与原始 DTS 的差异分析

反编译得到的 DTS 与原始 DTS 并非完全一致。下图直观展示了从原始 DTS 到 DTB 再到反编译 DTS 的信息变化：

3.6 实战：完整编译与反编译示例

以下是一个完整的操作流程，从编写 DTS 到验证反编译结果：

# 1. 编写一个简单的 DTS 文件（example.dts）
/dts-v1/;

/ {
    compatible = "acme,myboard";
    #address-cells = <1>;
    #size-cells = <1>;

    uart0: serial@10000000 {
        compatible = "ns16550";
        reg = <0x10000000 0x1000>;
        interrupts = <0 33 4>;
    };
};

# 2. 编译为 DTB
dtc -I dts -O dtb -o example.dtb example.dts

# 3. 反编译回 DTS
dtc -I dtb -O dts -o example_decompiled.dts example.dtb

# 4. 对比差异（使用 diff 工具）
diff -u example.dts example_decompiled.dts

执行 diff 后，你会看到反编译版本丢失了注释（如果有），且节点顺序可能按地址重新排列，但核心属性值完全一致。