4、设备树编译与反编译：dtc工具使用、反编译查看硬件拓扑

设备树源文件（.dts / .dtsi）必须经过编译生成二进制设备树 Blob（.dtb），内核启动时才能解析。反之，从 .dtb 反编译回 .dts 是调试硬件拓扑、验证裁剪结果的关键手段。本节围绕 dtc（Device Tree Compiler）工具，系统讲解编译、反编译、查看与校验方法。

4.1 dtc 工具概述

dtc 是设备树的官方编译器，集成在 Linux 内核源码 scripts/dtc/ 目录下，也可通过系统包管理器独立安装。其核心功能包括：

• 编译（Compile）： .dts → .dtb，支持预处理（cpp）和包含文件。
• 反编译（Decompile）： .dtb → .dts，还原可读的硬件描述。
• 校验（Check）： 检查语法、节点唯一性、属性合法性。
• 输出格式控制： 支持 .dtb、.dts、.dtbo（overlay）等。

4.2 编译流程与参数详解

编译过程本质上是将文本化的设备树源文件解析为二进制结构，包含节点树、属性键值对、字符串表、内存保留映射等。以下是一个标准编译示例：

# 基本编译（无依赖）
dtc -I dts -O dtb -o myboard.dtb myboard.dts

# 带预处理（支持 #include 和宏）
cpp -nostdinc -I include -undef -x assembler-with-cpp myboard.dts myboard_preprocessed.dts
dtc -I dts -O dtb -o myboard.dtb myboard_preprocessed.dts

# 一步到位（推荐）
dtc -I dts -O dtb -o myboard.dtb -@ -W no-unit_address_vs_reg myboard.dts

常用编译选项说明：

• -I / -O： 指定输入/输出格式（dts / dtb / fs）。
• -o： 输出文件路径。
• -@： 生成 __symbols__ 节点，用于设备树 Overlay。
• -W / -E： 启用/禁用特定警告或错误检查。
• -V： 指定设备树 Blob 版本（默认 17）。
• -H： 指定 phandle 格式（legacy / epapr / both）。

4.3 反编译：还原硬件拓扑

反编译是调试和逆向分析的核心技能。通过 dtc -I dtb -O dts 可将二进制 .dtb 还原为可读的 .dts，但反编译结果与原始源文件存在差异：

反编译典型场景：

# 基本反编译
dtc -I dtb -O dts -o decompiled.dts board.dtb

# 反编译并显示 phandle 值（便于追踪引用）
dtc -I dtb -O dts -o decompiled.dts -@ board.dtb

# 反编译为“伪源文件”格式（保留更多原始信息）
dtc -I dtb -O dts -o decompiled.dts -H epapr board.dtb

4.4 设备树编译/反编译流程 SVG 图

下图展示了从源文件到二进制、再到反编译还原的完整数据流，以及各阶段的关键操作与产物：

4.5 查看硬件拓扑：从反编译结果分析节点结构

反编译后的 .dts 文件以树形缩进展示所有节点。通过分析节点层级、compatible 属性、reg 地址范围、中断连接关系，可以快速掌握硬件拓扑。以下是一个典型 SoC 反编译片段：

/dts-v1/;

/ {
    model = "TI AM335x BeagleBone Black";
    compatible = "ti,am335x-bone-black", "ti,am335x-bone", "ti,am33xx";
    
    chosen {
        stdout-path = &uart0;
    };
    
    ocp {
        compatible = "simple-bus";
        #address-cells = <1>;
        #size-cells = <1>;
        ranges;
        
        uart0: serial@44e09000 {
            compatible = "ti,am3352-uart", "ns16550a";
            reg = <0x44e09000 0x2000>;
            interrupts = <72>;
            clocks = <&clk_uart0>;
            status = "okay";
        };
        
        i2c0: i2c@44e0b000 {
            compatible = "ti,am3352-i2c", "ti,omap4-i2c";
            reg = <0x44e0b000 0x1000>;
            interrupts = <70>;
            #address-cells = <1>;
            #size-cells = <0>;
            status = "okay";
            
            eeprom@50 {
                compatible = "atmel,24c32";
                reg = <0x50>;
            };
        };
    };
};

拓扑分析要点：

• 根节点： 包含 model 和 compatible，用于内核匹配板级。
• 总线节点： ocp 作为简单总线，包含 #address-cells、#size-cells、ranges 定义地址映射。
• 外设节点： uart0、i2c0 等，通过 reg 描述基地址和大小，interrupts 描述中断号。
• 子节点： eeprom@50 挂在 I2C 总线下，通过 reg 表示从设备地址。
• 引用： &uart0 是标签引用，反编译后保留为 phandle 或路径。

4.6 设备树节点拓扑关系 SVG 图

下图以树形结构展示反编译后设备树的节点层级与连接关系，突出根节点、总线、外设和子设备之间的拓扑：

4.7 编译与反编译的常见问题与避坑

4.8 实战：裁剪验证中的编译与反编译流程

在驱动模块化裁剪实践中，编译与反编译是验证裁剪正确性的最后关卡。推荐按以下步骤操作：

1. 备份原始 .dtb： cp board.dtb board_original.dtb
2. 反编译原始 .dtb： dtc -I dtb -O dts -o board_original.dts board_original.dtb
3. 修改源文件进行裁剪： 删除或禁用不需要的节点。
4. 编译裁剪后的 .dts： dtc -I dts -O dtb -o board_trimmed.dtb board_trimmed.dts
5. 反编译裁剪后的 .dtb： dtc -I dtb -O dts -o board_trimmed.dts board_trimmed.dtb
6. 对比差异： diff -u board_original.dts board_trimmed.dts | less
7. 检查节点完整性： 确保关键外设（如串口、网卡、存储）未被误删。
8. 部署测试： 将裁剪后的 .dtb 替换到启动分区，重启验证。