3. DTC 编译器介绍

DTC（Device Tree Compiler）是设备树源文件（.dts / .dtsi）到二进制设备树（.dtb）的核心转换工具，也是反向反编译（.dtb → .dts）的唯一官方工具。理解 DTC 的作用、安装与命令行选项，是掌握设备树编译流程的第一步。

3.1 DTC 工具的作用

DTC 在嵌入式 Linux 开发中承担三项关键职责：

3.2 DTC 的安装方法

DTC 的安装方式取决于开发环境。以下列出三种主流途径：

1. 发行版包管理器（推荐）

   # Debian / Ubuntu
   sudo apt-get install device-tree-compiler
   
   # Fedora / RHEL
   sudo dnf install dtc
   
   # Arch Linux
   sudo pacman -S dtc

2. 从内核源码编译

   # 进入内核源码树的 scripts/dtc 目录
   cd linux/scripts/dtc
   make
   sudo make install

   此方式保证 DTC 版本与当前内核完全匹配，适合内核开发场景。

3. 从 GitHub 仓库编译最新版

   git clone https://git.kernel.org/pub/scm/utils/dtc/dtc.git
   cd dtc
   make
   sudo make install

   适用于需要最新特性（如 YAML 输出、新绑定检查）的开发者。

3.3 基本命令行选项

DTC 的命令行结构为：

dtc [选项] [输入文件]

下表列出最常用的选项及其用途：

3.4 典型编译流程示例

以下 SVG 展示了从 .dts 源文件到 .dtb 二进制文件的完整编译链路，包含预处理、编译和反编译三种路径：

3.5 常用命令速查

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

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

# 3. 仅预处理（展开 #include 和宏）
dtc -E -I dts -o preprocessed.dts input.dts

# 4. 编译时启用所有警告
dtc -I dts -O dtb -o output.dtb -W all input.dts

# 5. 生成支持叠加层的 DTB（含 __symbols__）
dtc -I dts -O dtb -o output.dtb -@ input.dts

# 6. 从 /proc/device-tree 目录重建 DTB（嵌入式调试）
dtc -I fs -O dtb -o recovered.dtb /proc/device-tree

3.6 常见编译错误与排查方向