当前位置：首页 > news >正文

嵌入式Linux调试：在U-Boot里用fdt命令找回丢失的设备树文件（DTS/DTB）

news 2026/5/4 12:33:45

嵌入式Linux调试实战：从U-Boot内存中逆向恢复设备树文件

在嵌入式Linux开发中，设备树（Device Tree）作为硬件描述的核心载体，其重要性不言而喻。然而在实际开发过程中，我们常常会遇到设备树源文件（.dts）丢失或损坏的情况——可能是版本管理疏忽、供应商未提供完整资料，或是接手遗留项目时文档缺失。面对这种"硬件黑盒"困境，掌握从U-Boot运行时环境中直接提取设备树信息的技能，就成为嵌入式开发者的必备生存技巧。

本文将深入探讨如何利用U-Boot内置的fdt命令集，从内存中完整导出设备树信息，并通过标准工具链重建可用的.dts和.dtb文件。不同于常规的设备树使用教程，我们聚焦于"数据恢复"这一特殊场景，特别适合那些需要维护老旧设备或文档不全硬件平台的工程师。通过本文介绍的技术路线，即使在没有原始dts文件的情况下，也能逆向构建出完整的设备树描述，为后续的驱动开发和系统移植奠定基础。

1. 设备树基础与恢复原理

设备树（Device Tree）是嵌入式Linux系统中描述硬件配置的数据结构，它采用树状节点形式定义处理器、内存、总线以及各种外设的寄存器地址、中断号等关键参数。完整的设备树工作流程包括：

DTS：人类可读的文本源文件（Device Tree Source）
DTC：设备树编译器（Device Tree Compiler）将.dts转换为.dtb
DTB：二进制格式的设备树 blob（Device Tree Blob），由bootloader加载到内存

当开发板启动时，U-Boot会将dtb文件加载到特定内存地址，然后传递给Linux内核。这个内存中的dtb正是我们可以挖掘的"数据金矿"。通过U-Boot的fdt命令，我们能够：

定位dtb在内存中的准确位置
以可读形式导出完整的设备树结构
重建符合标准的dts源文件
重新编译生成可用的dtb文件

这种逆向恢复技术的核心价值在于：即使没有任何原始文档，也能通过运行时分析还原出硬件配置真相。对于维护十年前的旧设备或是破解第三方封闭系统尤其有用。

注意：从内存恢复的设备树可能包含一些运行时动态修改的属性，与原始dts文件会有细微差异，建议在获得基础版本后与硬件手册交叉验证。

2. 定位内存中的设备树

2.1 确定设备树加载地址

在U-Boot命令行界面，首先需要确认设备树blob（dtb）在内存中的加载位置。有几种典型方法可以获取这个关键地址：

# 方法1：查看U-Boot环境变量 printenv fdt_addr fdtaddr fdt_addr_r # 方法2：检查启动日志 U-Boot# bdinfo boot_params = 0x80000100 DRAM bank = 0x00000000 -> start = 0x80000000 -> size = 0x20000000 fdt_blob = 0x83000000 # 设备树地址

常见情况分析：

场景	可能地址	备注
ARM32传统启动	0x10000000-0x13000000	通常在DRAM前端
ARM64标准启动	0x40000000-0x50000000	与内核地址相邻
MIPS平台	0x81000000-0x83000000	常见于Broadcom方案
自定义配置	需查看bootcmd	可能通过环境变量指定

如果上述方法都无法确定地址，可以尝试内存扫描法：

# 搜索设备树魔数（0xd00dfeed） U-Boot# md 0x80000000 10000000

2.2 验证设备树有效性

获取到疑似地址后，需要验证是否为有效的设备树blob：

# 设置fdt地址 U-Boot# fdt addr 0x83000000 # 检查头部信息 U-Boot# fdt header magic: 0xd00dfeed totalsize: 0x1a4d (6733) off_dt_struct: 0x38 off_dt_strings: 0x1288 off_mem_rsvmap: 0x28 version: 17 last_comp_version: 16

关键验证点：

magic必须为0xd00dfeed
version建议≥17（对应设备树v3）
totalsize应与内存区域匹配

3. 设备树信息提取技术

3.1 基础信息导出

设置正确的设备树地址后，可以开始提取信息：

# 查看根节点概要 U-Boot# fdt list / / { #address-cells = <0x00000001>; #size-cells = <0x00000001>; model = "MyBoard Rev 2.3"; compatible = "vendor,myboard", "vendor,myfamily"; serial-number = "B203XZ0042"; };

对于大型设备树，建议分层导出：

# 导出内存节点信息 U-Boot# fdt print /memory@80000000 memory@80000000 { device_type = "memory"; reg = <0x80000000 0x20000000>; }; # 导出特定总线节点 U-Boot# fdt print /soc/i2c@4000000 i2c@4000000 { #address-cells = <0x00000001>; #size-cells = <0x00000000>; compatible = "vendor,i2c-controller"; reg = <0x40000000 0x00001000>; interrupts = <0x0000000a>; clock-frequency = <0x000f4240>; };

3.2 完整设备树导出

要重建完整的dts文件，需要导出全部节点：

# 完整打印设备树（输出可能很长） U-Boot# fdt print > dt_dump.txt

典型输出结构示例：

/dts-v1/; / { #address-cells = <1>; #size-cells = <1>; model = "MyBoard"; compatible = "vendor,myboard"; memory@80000000 { device_type = "memory"; reg = <0x80000000 0x20000000>; }; cpus { #address-cells = <1>; #size-cells = <0>; cpu@0 { device_type = "cpu"; compatible = "arm,cortex-a9"; reg = <0>; clock-frequency = <800000000>; }; }; ... };

3.3 高级导出技巧

对于复杂系统，可以结合多种命令提高效率：

# 导出所有节点路径 U-Boot# fdt list / > nodes.txt # 批量导出关键节点 for node in $(cat nodes.txt | awk '{print $1}'); do fdt print $node >> full_dts.txt done # 导出所有属性名 U-Boot# fdt list / -p | grep -oP '[a-z-]+(?= =)' | sort -u

4. 设备树重建与验证

4.1 从导出数据构建dts

将U-Boot导出的文本整理为标准dts文件时需注意：

添加版本头：/dts-v1/;
确保节点使用正确的大括号嵌套
补全可能缺失的标准属性（如#address-cells）
处理特殊值格式：
- 十六进制：<0x12345678>
- 字符串："text"
- 字节数组：[00 11 22]

示例修复过程：

- / { + /dts-v1/; + + / { model = MyBoard; + #address-cells = <1>; + #size-cells = <1>; memory@80000000 { - reg = 80000000 20000000; + reg = <0x80000000 0x20000000>; }; };

4.2 使用dtc编译验证

在Linux主机上使用设备树编译器验证：

# 将整理的dts编译为dtb dtc -I dts -O dtb -o recovered.dtb recovered.dts # 反编译验证 dtc -I dtb -O dts -o check.dts recovered.dtb # 检查差异 diff -u recovered.dts check.dts

常见编译问题处理：

错误类型	解决方案
Syntax error	检查节点大括号匹配
Missing #address-cells	在父节点添加标准属性
Invalid phandle format	确保引用格式为`<&phandle>`
Undefined label	补全`/plugin/;`或标签定义

4.3 设备树实用处理技巧

批量属性修改：

# 使用sed处理导出的设备树 sed -i 's/old-compatible/new-compatible/g' recovered.dts

合并补丁片段：

# 应用补丁到恢复的dts fdtoverlay -o final.dts -i recovered.dts patch.dtso

尺寸优化：

# 压缩设备树（移除注释、优化格式） dtc -I dts -O dts -o compact.dts -@ recovered.dts

5. 实战案例与疑难解析

5.1 旧工业控制器恢复案例

某2008年的ARM9工控板需移植新内核，但原厂仅提供：

残缺的dts片段
过时的二进制dtb

恢复步骤：

从旧内核镜像中提取dtb：

dd if=old_zImage bs=1 skip=$(grep -obaP '\xd0\x0d\xfe\xed' old_zImage | cut -d: -f1) of=extracted.dtb

在U-Boot中二次验证：

U-Boot# fdt addr 0x81000000 U-Boot# fdt print /soc/serial@9000

发现并修复时钟配置错误：

serial@9000 { compatible = "ns16550"; reg = <0x9000 0x100>; - clocks = <&clk 3>; + clocks = <&clk 12>; interrupt-parent = <&intc>; interrupts = <5>; };

5.2 内存保留区域处理

某些平台会动态修改设备树的内存保留区域（memreserve）：

# 查看当前保留区域 U-Boot# fdt rsvmem print Address Size 0x8f000000 0x01000000 # 安全引擎专用 0x9e000000 0x00200000 # DSP共享内存

这些信息必须包含在重建的dts中：

/dts-v1/; /memreserve/ 0x8f000000 0x01000000; /memreserve/ 0x9e000000 0x00200000; / { ... };

5.3 动态节点重建技巧

对于U-Boot运行时添加的节点（如chosen），需特殊处理：

识别动态节点：
```
U-Boot# fdt list /chosen
```

在dts中添加条件标记：

/ { chosen { linux,initrd-start = <0x82000000>; linux,initrd-end = <0x82800000>; /delete-property/ local-mac-address; // 可能由bootloader填充 }; };

使用预处理指令：

#ifdef UBOOT /include/ "uboot-addons.dtsi" #endif

6. 自动化工具链集成

为提高效率，可以建立自动化恢复流程：

6.1 脚本化导出

创建U-Boot脚本dump_dts.scr：

setenv output '' fdt addr ${fdtaddr} for node in $(fdt list / | awk '{print $1}'); do setenv output "${output}\n$(fdt print ${node})" done saveenv echo "${output}" > dts_dump.txt

6.2 主机端处理脚本

Python后处理示例：

import re def clean_dts_dump(text): # 移除U-Boot提示符 text = re.sub(r'^U-Boot#.*$', '', text, flags=re.M) # 转换缩进 text = text.replace('\t', ' ') # 修复属性格式 text = re.sub(r'([a-z-]+) = ([^;]+);', r'\1 = <\2>;', text) return '/dts-v1/;\n\n' + text.strip() with open('dts_dump.txt') as f: print(clean_dts_dump(f.read()))

6.3 持续集成集成

GitLab CI示例配置：

recover_dts: stage: build script: - dtc -I dts -O dtb -o ${BOARD}.dtb ${BOARD}.dts - mkimage -A arm -O linux -T firmware -C none -a 0x80000000 -e 0x80000000 -n "Recovered DTB" -d ${BOARD}.dtb dtb.img artifacts: paths: - ${BOARD}.dts - dtb.img

7. 进阶调试技巧

7.1 设备树实时修改

在U-Boot中直接调试设备树：

# 修改节点属性 U-Boot# fdt set /soc/usb@48000000 status "disabled" # 添加新节点 U-Boot# fdt mknode /soc new-device U-Boot# fdt set /soc/new-device compatible "vendor,new-device" # 删除错误节点 U-Boot# fdt rm /obsolete-node

7.2 设备树差异比较

使用fdtdiff工具分析变化：

# 生成变化报告 fdtdiff original.dtb recovered.dtb > changes.txt # 可视化比较 dtc -I dtb -O dts original.dtb > original.dts dtc -I dtb -O dts recovered.dtb > recovered.dts diff -y --color original.dts recovered.dts | less -R

7.3 设备树性能分析

检查设备树对启动时间的影响：

# 测量解析耗时 U-Boot# setenv preboot "time fdt addr ${fdtaddr}; time fdt boardsetup" # 分析设备树大小影响 ls -lh *.dtb dtc -I dtb -O dts -o - my.dtb | wc -l

8. 安全与可靠性考量

8.1 完整性验证

确保恢复的设备树安全可靠：

校验和检查：

U-Boot# crc32 ${fdtaddr} ${filesize} dtc -I dtb -O dtb -p 0x1000 -o verified.dtb recovered.dtb

签名验证（如有）：

U-Boot# fdt checksign openssl dgst -verify pubkey.pem -signature dtb.sig recovered.dtb

8.2 版本控制策略

对恢复的设备树实施版本管理：

# 生成唯一标识 dtc -I dtb -O dts -o - my.dtb | sha1sum # Git管理示例 git init git add recovered_v1.dts git commit -m "Initial recovery from board rev2.3" git tag -a v1.0 -m "First working version"

8.3 容灾备份方案

建立设备树备份体系：

多介质存储：

# U-Boot环境变量备份 U-Boot# saveenv # 导出到TFTP U-Boot# tftpput ${fdtaddr} ${filesize} 192.168.1.100:backup.dtb

自动化备份脚本：

#!/bin/sh dtc -I fs /proc/device-tree -O dts -o /backup/$(cat /proc/device-tree/model)-$(date +%Y%m%d).dts gzip /backup/*.dts

在实际项目中，我曾遇到过一款已经停产的老旧网关设备，原厂提供的设备树文件与新内核完全不兼容。通过本文介绍的技术，最终从U-Boot中成功提取出完整的硬件描述，并在此基础上开发出了支持主线内核的移植版本。整个过程最大的收获是：设备树的运行时信息往往比文档更真实可靠，特别是在处理那些年代久远或文档缺失的嵌入式设备时，直接从U-Boot挖掘硬件真相可能是最高效的解决方案。

查看全文

http://www.jsqmd.com/news/750762/