4. DTS到DTB的编译流程：从DTS源文件到DTB二进制文件的完整编译过程

设备树从可读的文本格式（DTS）转换为二进制格式（DTB）的过程，由设备树编译器（Device Tree Compiler，简称 dtc）完成。这个编译过程并非简单的文本到二进制的转换，而是包含了预处理、语法解析、符号展开、二进制打包等多个阶段。理解这一流程，是定位设备树相关编译错误的基础。

4.1 编译流程全景图

下图展示了从 .dts 源文件到 .dtb 二进制文件的完整编译流水线，以及中间生成的关键文件类型。

4.2 各阶段详细解析

4.2.1 阶段一：C 预处理器（CPP）展开

设备树源文件通常使用 #include 指令引用 SoC 级 .dtsi 文件或头文件。dtc 在编译前会调用 C 预处理器（cpp）对这些宏和包含文件进行展开。

• 输入：.dts 源文件 + 所有被 #include 的 .dtsi 文件
• 处理内容：#include、#define、#ifdef、#if 等预处理指令
• 输出：一个完全展开的 .dts.pre 中间文件（或直接通过管道传递给下一阶段）

4.2.2 阶段二：词法分析与语法分析

dtc 对预处理后的文本进行词法扫描（lex）和语法解析（yacc）。此阶段将文本流转换为抽象语法树（AST）。

• 词法分析：识别关键字（/dts-v1/、/memreserve/）、节点名、属性名、字符串、数字、标点符号等 token。
• 语法分析：根据设备树语法规则（节点嵌套、属性赋值、标签定义）构建 AST 节点。
• 输出：内存中的 AST 结构，此时所有节点和属性已被识别，但引用（&label）尚未解析。

4.2.3 阶段三：符号与引用展开

设备树支持通过标签（label）进行节点引用，例如 &uart1 { status = "okay"; };。此阶段负责将引用解析为实际节点的路径。

• 标签注册：遍历 AST，将所有 label: node-name 形式的标签注册到符号表。
• 引用替换：将 &label 替换为对应节点的绝对路径（如 /soc/serial@.../）。
• 合并操作：将引用节点中的属性与原始节点进行合并（覆盖或追加）。
• 输出：完全展开且无引用的 AST。

4.2.4 阶段四：DTB 二进制打包

最后阶段将展开后的 AST 序列化为扁平设备树（Flattened Device Tree, FDT）二进制格式。这是最终被 Bootloader 和内核解析的格式。

打包过程中，dtc 会进行以下关键操作：

• 对齐填充：每个节点和属性数据按 4 字节对齐，不足补零。
• 字符串去重：相同的属性名（如 compatible、reg）在 Strings Block 中只存储一次。
• 大小计算：计算总大小并写入 Header，确保 Bootloader 可以一次性加载完整 DTB。

4.3 编译命令与参数

标准编译命令格式如下：

# 基本编译：将 .dts 编译为 .dtb
dtc -I dts -O dtb -o output.dtb input.dts

# 常用参数组合（带预处理和路径指定）
cpp -nostdinc -I include -undef -x assembler-with-cpp input.dts \
  | dtc -I dts -O dtb -o output.dtb -

# 生成依赖文件（用于 Makefile 增量编译）
dtc -I dts -O dtb -o output.dtb -d output.dtb.dep input.dts

# 反编译：将 .dtb 还原为 .dts（调试用）
dtc -I dtb -O dts -o output.dts input.dtb

4.4 编译过程中的常见错误与排查

4.5 编译流程总结

从 DTS 到 DTB 的编译是一个严谨的多阶段过程：

1. 预处理：展开 #include 和宏定义，生成单一文本流。
2. 解析：将文本转换为 AST，检查语法正确性。
3. 展开：解析标签引用，合并节点，消除所有符号依赖。
4. 打包：将 AST 序列化为 FDT 二进制格式，包含 Header、保留块、结构块和字符串块。