3. 设备树编译与反编译：DTC工具使用、DTS编译为DTB、DTB反编译为DTS、设备树覆盖(overlay)

设备树源文件（.dts）是文本格式的硬件描述，但内核引导加载程序（如U-Boot）和内核本身无法直接解析文本。必须通过设备树编译器（DTC）将其转换为二进制设备树Blob（.dtb）。本章深入讲解DTC工具链、编译/反编译流程以及设备树覆盖（Overlay）机制，这是实现Platform驱动与设备树匹配的工程基础。

3.1 DTC工具与编译流程

DTC（Device Tree Compiler）是设备树生态的核心工具，通常集成在Linux内核源码的 scripts/dtc/ 目录下。系统安装后可通过 dtc 命令直接调用。

3.1.1 DTC工具安装与版本确认

3.1.2 DTS → DTB 编译命令

将设备树源文件编译为二进制DTB，是设备树使用的最基本操作。标准命令格式如下：

# 基本编译：输出 DTB 文件
dtc -I dts -O dtb -o my_board.dtb my_board.dts

# 添加调试信息（保留符号）
dtc -I dts -O dtb -@ -o my_board.dtb my_board.dts

# 指定输出格式为 DTB，并显示编译进度
dtc -I dts -O dtb -o my_board.dtb -V 17 my_board.dts

3.1.3 DTS 编译为 DTB 的流程示意图

3.2 DTB 反编译为 DTS

反编译（Decompilation）是将二进制 DTB 还原为可读的 DTS 文本，常用于调试、逆向分析或验证编译结果。反编译后的 DTS 会丢失原始注释和部分格式，但节点结构和属性值完全保留。

3.2.1 反编译命令

# 基本反编译：DTB → DTS
dtc -I dtb -O dts -o my_board_decompiled.dts my_board.dtb

# 反编译并保留符号（用于 Overlay 分析）
dtc -I dtb -O dts -@ -o my_board_decompiled.dts my_board.dtb

# 直接输出到终端查看
dtc -I dtb -O dts my_board.dtb

3.2.2 反编译前后对比

3.2.3 DTB 反编译为 DTS 流程示意图

3.3 设备树覆盖（Device Tree Overlay）

设备树覆盖允许在不修改主设备树（Base DTB）的情况下，动态添加或修改硬件节点。这在可插拔硬件（如FPGA加速器、扩展板）、模块化系统以及快速原型开发中极为重要。Platform 驱动可以通过 Overlay 机制实现运行时设备匹配。

3.3.1 Overlay 文件结构

Overlay 文件使用 /plugin/ 标识，通过 &{label} 引用主设备树中的节点进行修改或追加。

// my_overlay.dts
/dts-v1/;
/plugin/;

/ {
    fragment@0 {
        target = &i2c0;          // 引用主设备树中的 i2c0 节点
        __overlay__ {
            status = "okay";
            my_sensor: sensor@48 {
                compatible = "myvendor,my-sensor";
                reg = <0x48>;
                interrupt-parent = <&gpio1>;
                interrupts = <5 IRQ_TYPE_EDGE_RISING>;
            };
        };
    };
};

3.3.2 Overlay 编译与加载

3.3.3 Overlay 工作原理示意图

3.4 常见编译错误与调试技巧

3.4.1 典型错误对照表

3.4.2 调试技巧

• 使用 -W 和 -E 参数：dtc -W all -E all 启用所有警告和错误检查，提前发现问题。
• 反编译验证：编译后立即反编译，对比关键节点是否与预期一致。
• 查看 DTB 内容：使用 fdtdump my_board.dtb 快速查看 DTB 的原始结构。
• 内核日志：加载 Overlay 后执行 dmesg | tail -20，查看内核是否成功创建 platform_device。
• 设备树目录检查：ls -l /sys/firmware/devicetree/base/ 查看当前生效的设备树节点。