1. 代码开发工具 dtc 的第一道坎:dtb 编译成功不等于启动成功
设备树编译这条链路上,dtc 是绕不开的代码开发工具。很多人第一次改 dts,看到命令没报错、目录里生成了 dtb,就默认板子能起来;真正翻车往往发生在串口日志里:内核没有 unflatten 设备树,或者 padding 不够直接 panic。dtc 把可读的 dts/dtsi 编译成扁平化二进制 dtb,编译只是第一段路,加载和校验是第二段路。这篇操作笔记就围绕 dtc 的编译命令、-p 与 -Wno 参数、fdtdump 检查和串口日志验证,把从 dts 到 dtb 的可照做流程讲透,适合正在调设备树、被“编译通过但启动失败”卡住的人。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具 dtc 的输入输出:dts、dtsi 与 dtb 的边界
2.1 dts 与 dtsi:编译前先确认可读源文件的结构
dtc 的输入是设备树源文件,常见后缀是 .dts,公共片段会拆到 .dtsi 里。材料里提到“现代 dtsi 中普遍存在”某些 unit-address 与 reg 的警告,这说明 dtsi 不是装饰文件,它会参与编译展开。实际做法通常是把公共节点放在 dtsi,把板级差异留在 dts,dtc 按输入文件把可见结构编译成 dtb。编译前第一件事不是急着加 -Wno,而是确认你改的是不是最后参与编译的那个 dts,以及 dtsi 的包含关系有没有把旧节点带进来。源文件是可读的,dtb 是不可直接阅读的扁平化二进制,这个边界先立住,后面才不会把 dtb 当文本改。
可执行检查可以先用一条最小命令试跑,不带 -Wno,让警告先暴露出来。示例文件名用虚构的 demo-board.dts 和 demo-board.dtb,实际按手头文件替换。
bash复制# 先做一次不带 -Wno 的最小试编译,观察 warning 和 error
dtc -I dts -O dtb -o demo-board.check.dtb demo-board.dts
这条命令只做一件事:把 demo-board.dts 按 dts 输入、dtb 输出编译到 demo-board.check.dtb。-I dts 指定输入格式,-O dtb 指定输出格式,-o 指定产物名。此时不要急着把 demo-board.check.dtb 当成最终产物,它只是编译前哨。命令输出里如果出现 unit-address 或 simple-bus 相关警告,先判断来源是 dtsi 公共片段还是自己新加的节点;如果出现语法错误,先修源文件,不要用 -Wno 把 error 盖过去。这个最小试跑的价值在于把“源文件能不能被 dtc 读懂”和“最终产物参数怎么配”分开,避免后面一上来就复制一长串参数,出了问题不知道是哪一项造成的。
2.2 dtb 的扁平化边界:为什么不能直接改二进制
dtb 是扁平化二进制,材料写得很明确:输出 .dtb 文件不可直接阅读。这意味着两件事:第一,不能用文本编辑器打开 dtb 改节点,改坏了 dtc 和内核都不认;第二,现场排错时要看的是 dts/dtsi 源文件和编译日志,dtb 只作为加载对象。很多人图快,直接在目标板上替换 dtb,结果下一次重新编译又把问题带回来,因为源文件没变。正确路径是改 dts/dtsi,重新走 dtc,生成新的 dtb,再用 fdtdump 和内核日志验证。dtb 的边界还体现在加载侧:编译成功只说明 dtc 能生成文件,不说明启动流程会读取这个文件,也不说明内核能成功 unflatten。材料里把“内核是否能成功 unflatten”单列为关键检查,这个检查不在 dtc 命令里,而在目标板串口启动日志里。
2.3 编译前最小试跑:让警告先暴露出来
最小试跑之后,先看三样东西:命令退出状态、输出文件是否生成、警告里有没有你认识的来源。命令退出状态正常但警告很多,并不等于可以直接进入最终编译;警告里如果有 unit-address 与 reg 不一致、simple-bus 相关问题,要判断是 dtsi 旧写法带来的非致命警告,还是新节点写错了。材料给的标准命令里用了 -Wno-unit_address_vs_reg 和 -Wno-simple-bus-reg,这两个参数是关闭非致命警告,不是关闭所有检查。我的习惯是先用不带 -Wno 的命令跑一次,把警告看一遍,再决定最终命令里保留哪几个 -Wno。如果一上来就全关,后面出现真实结构问题时,编译日志会安静得让人误以为一切正常。
这一步还可以固定产物名。最小试跑用 demo-board.check.dtb,最终编译用 demo-board.dtb,两个名字分开,避免检查产物和最终产物互相覆盖。文件名不是重点,重点是让“试跑”和“发布”在命令层面可区分。编译前的最小检查清单可以压成三步:确认 dts 路径和 dtsi 包含关系;用不带 -Wno 的命令试跑;看警告来源并决定最终参数。三步都过了,再进入标准编译命令,后面 -p 和 -Wno 才有讨论基础。
3. 代码开发工具 dtc 的编译命令:四个参数决定 dtb 能不能被内核接住
3.1 标准编译命令:-I、-O、-o、-Wno、-p 各管什么
标准命令来自材料里的 dtc 调用方式,文件名替换成虚构演示名,参数保留原样:
bash复制dtc -I dts -O dtb -o demo-board.dtb \
-Wno-unit_address_vs_reg \
-Wno-simple-bus-reg \
-p 2048 \
demo-board.dts
这条命令里,-I dts -O dtb 指定输入输出格式,-o demo-board.dtb 指定最终产物,-Wno-unit_address_vs_reg 和 -Wno-simple-bus-reg 关闭两类非致命警告,-p 2048 设置预留 padding 字节数,最后的 demo-board.dts 是输入源文件。命令顺序不必死记,但每个参数的作用要能对应到失败现象。-I 写错,dtc 会把源文件当另一种格式读,直接报解析错误;-O 写错,产物不是 dtb,后面 fdtdump 和内核加载都对不上;-o 写错,产物名字和启动流程读取的名字不一致,现场就会出现“明明编译了却没生效”;-Wno 用得太顺,真实结构问题被盖住;-p 省掉或给得太小,内核解析时可能触发 OF: fdt: Memory limit exceeded 错误并 panic。材料里这句话是血泪经验,不是理论风险。
编译命令执行完,先不要只看“没有报错”。看输出文件是否生成、文件大小是否合理、命令日志里有没有被 -Wno 关掉的警告以外的信息。dtc 的警告和错误是两类东西:error 必须修源文件,warning 要判断来源。-Wno-unit_address_vs_reg 对应的是 unit-address 与 reg 的常见不一致警告,材料说它在现代 dtsi 中普遍存在,关闭可避免干扰;-Wno-simple-bus-reg 对应 simple-bus 相关警告。两个参数只适合“已经知道来源、确认非致命”的场景。新加的节点如果也触发同类警告,先别沿用关闭参数,回到不带 -Wno 的试跑命令看具体位置,否则就是拿旧经验盖新问题。
3.2 参数表:改 -p 还是改 -Wno,先看失败点
参数调整不要凭感觉。下面这张表把材料里出现的参数和检查点对齐,方便排错时先定位再改命令。
| 参数 | 作用 | 常见误用 | 先看什么 |
|---|---|---|---|
-I dts |
指定输入格式为 dts | 输入文件不是 dts 却照抄 | dtc 是否报解析错误 |
-O dtb |
指定输出格式为 dtb | 输出成其他格式还拿去加载 | 产物能否被 fdtdump 识别 |
-o demo-board.dtb |
指定输出文件名 | 编译名和启动读取名不一致 | 目标板实际加载的是哪个文件 |
-Wno-unit_address_vs_reg |
关闭 unit-address 与 reg 的非致命警告 | 新节点写错也一起关掉 | 不带 -Wno 时警告指向哪里 |
-Wno-simple-bus-reg |
关闭 simple-bus 相关非致命警告 | 把所有警告当成噪音 | 警告是否来自已知 dtsi 旧写法 |
-p 2048 |
预留 padding 字节数 | 省略 -p 或给得过小 |
启动日志有无 Memory limit exceeded |
-p 2048 是这张表里最容易被忽略的一项。材料明确说,padding 不足时内核解析可能触发 OF: fdt: Memory limit exceeded 并 panic。这个失败不是 dtc 编译时报出来的,而是启动阶段才出现,所以“编译成功”在这里完全没有说服力。我的做法是保留 -p 2048 作为基线,不轻易删;如果启动日志真的出现 Memory limit exceeded,再评估加大 padding,而不是把 -p 直接拿掉。-Wno 的调整逻辑相反:先不带 -Wno 看警告,确认是已知非致命来源后再加;新增警告先查源文件,不要为了日志干净把新警告一起关掉。参数表不是让你一次背完,而是失败时按“输入输出格式、产物名、警告、padding”四项逐个排除。
3.3 编译产物验证:fdtdump 看 magic,串口日志看 unflatten
dtb 生成后,第一道验证是 fdtdump。材料给的做法是:
bash复制fdtdump -s demo-board.dtb | head -20
# 输出应包含:magic: 0xd00dfeed, totalsize: 0xXXXX, off_dt_struct: 0xXX...
fdtdump 是 dtc 工具集自带的检查工具,-s 输出摘要信息,head -20 只看开头。这里的关键不是把整段输出读完,而是确认 magic: 0xd00dfeed 是否存在,totalsize 和 off_dt_struct 是否有值。magic 不对,说明产物可能不是有效 dtb,或者文件名指错了;magic 对但 totalsize 异常,要回头检查编译命令和输入文件。fdtdump 能读,只证明 dtb 结构可被工具识别,不证明内核加载成功。材料把这一点分得很清楚:更关键的是检查内核是否能成功 unflatten。
第二道验证在目标板串口启动日志里。搜索这一行:
bash复制# 在目标板串口启动日志中搜索:
# [ 0.000000] OF: fdt: Unflattened device tree, memory at ...
# 若无此行,说明 dtb 未被加载或校验失败
这行日志是加载侧的证据。没有它,不要继续在 dtc 命令里打转,先查 dtb 是否被启动流程实际读取、文件名是否一致、产物是否放到了正确位置。fdtdump 和串口日志是两条独立证据:前者看 dtb 文件本身,后者看内核有没有接住这个 dtb。两条都过,才算从 dts 到 dtb 的编译链路真正闭环。只跑 fdtdump 就收工,是后面“现场没生效”的常见伏笔。
4. 避坑与排查:dtb 编译通过却启动失败的五个现场
4.1 现象一:启动日志出现 OF: fdt: Memory limit exceeded 并 panic
现象:dtc 命令没有报错,demo-board.dtb 也生成了,fdtdump 还能看到 magic,但目标板启动到设备树解析阶段直接打印 OF: fdt: Memory limit exceeded,随后 panic。
原因:-p 2048 设置的预留 padding 不够,内核运行时需要扩展设备树节点时没有足够空间。材料明确把 padding 不足和这个报错、panic 连在一起,所以这不是玄学,是编译参数在加载阶段结账。
解决:先确认最终命令里确实带了 -p 2048,没有在复制命令时漏掉;如果仍然出现该报错,再评估加大 padding。不要用“删除 -p”来处理,删除只会让预留空间更不可控。改完参数后重新编译,先用 fdtdump 确认产物有效,再看串口日志是否还出现同一报错。这个坑的特点是编译阶段安静,启动阶段剧烈,排错时要把 dtc 命令和内核日志放在一张时间线上看。
4.2 现象二:fdtdump 正常,串口没有 Unflattened 日志
现象:fdtdump -s demo-board.dtb | head -20 能看到 magic: 0xd00dfeed,但目标板串口日志里搜不到 OF: fdt: Unflattened device tree, memory at ...。
原因:材料给的解释很直接:若无此行,说明 dtb 未被加载或校验失败。常见情况是编译产物名字和启动流程读取的名字不一致,或者产物没有进入实际加载路径。fdtdump 只证明文件结构可读,不证明启动流程读的是这个文件。
解决:先对齐文件名,确认 -o 生成的 dtb 就是启动流程读取的那个名字;再确认产物被放到了实际加载位置,而不是留在编译目录里;最后看启动日志有没有其他 dtb 相关报错。不要因为 fdtdump 正常就继续改 dts 节点,先证明“这个 dtb 被内核接住了”。这一步不做,后面改多少节点都可能是空转。
4.3 现象三:-Wno 关得太顺手,真实结构问题被盖住
现象:命令里带了 -Wno-unit_address_vs_reg 和 -Wno-simple-bus-reg,编译日志很干净,但新加的节点在启动时行为不对,甚至内核没有按预期解析。
原因:这两个参数关闭的是非致命警告,材料说它们在现代 dtsi 中普遍存在,关闭可避免干扰。但“已知旧写法带来的警告”和“新节点写错带来的同类警告”在日志里长得像,一起关掉就把新问题盖住了。
解决:回到不带 -Wno 的最小试跑命令,让警告暴露出来,逐条看警告指向的源文件位置;只对确认来自旧 dtsi 公共片段、且不影响当前改动的警告保留 -Wno。新增节点第一次编译时,我一般不加 -Wno,等确认警告来源后再决定是否沿用。日志干净不等于结构正确,这个边界要守住。
4.4 现象四:把 dtb 当文本改,下一次编译又回退
现象:现场为了快点验证,直接用编辑器打开 dtb 改了几处,目标板短暂恢复;下一次重新编译 dts 后,问题原样复现。
原因:dtb 是扁平化二进制,材料明确说不可直接阅读。直接改二进制既容易破坏结构,也不会回写到 dts/dtsi,下一次 dtc 编译自然把旧问题带回来。
解决:所有修改回到 dts/dtsi 源文件,改完重新走 dtc 编译,生成新的 dtb,再用 fdtdump 和串口日志验证。dtb 只作为加载产物,不作为编辑对象。这个坑的血泪点在于“现场看起来修好了”,但版本库里没有留下任何可复现的修改,下一次构建就翻车。
4.5 现象五:只跑编译不跑加载验证,现场才发现没生效
现象:本地 dtc 编译通过,fdtdump 也正常,交付后目标板启动日志没有 unflatten 行,设备树改动完全没生效。
原因:验证链只走到“文件生成”,没有走到“内核加载”。材料把 fdtdump 和内核 unflatten 日志分成两步,前者看文件,后者看加载,缺一步就会把编译成功误当成运行成功。
解决:把验证固定成两条证据:fdtdump 看 magic: 0xd00dfeed、totalsize、off_dt_struct;串口日志搜 OF: fdt: Unflattened device tree, memory at ...。两条都过再交付。只跑编译不跑加载验证,是设备树调试里最像“应该没问题”的坑,也是最容易在答辩或现场演示时被打脸的坑。
5. 代码开发工具链的收尾验证:把 dtc 编译固定成可重复检查
5.1 编译前后检查清单
设备树改动最怕“这次好了,下次又忘了参数”。我的习惯是把 dtc 命令和检查动作固定成一个小脚本,参数不靠手敲。下面这段只做编译和 fdtdump 摘要,串口日志仍需在目标板侧看:
bash复制#!/usr/bin/env bash
set -euo pipefail
# 固定输入输出名,避免检查产物和最终产物互相覆盖
dtc -I dts -O dtb -o demo-board.dtb \
-Wno-unit_address_vs_reg \
-Wno-simple-bus-reg \
-p 2048 \
demo-board.dts
# 看 magic、totalsize、off_dt_struct,确认 dtb 结构可识别
fdtdump -s demo-board.dtb | head -20
脚本里的 set -euo pipefail 让 dtc 失败时立即停下,不会继续拿旧产物做检查;-p 2048 固定保留,避免复制命令时漏掉;-Wno 只保留材料里这两项已知非致命警告;fdtdump -s 加 head -20 只看关键头部。每次改完 dts/dtsi,先跑脚本,再去目标板串口搜 unflatten 日志。检查清单可以压成三行:编译命令是否带 -p 2048;fdtdump 是否有 magic: 0xd00dfeed;串口是否有 OF: fdt: Unflattened device tree, memory at ...。三行都过,才把 dtb 交给下一步。
| 检查点 | 看什么 | 不通过先查 |
|---|---|---|
| dtc 编译 | 命令退出状态、输出文件 | 输入文件、-I/-O/-o |
| dtb 结构 | magic: 0xd00dfeed、totalsize、off_dt_struct |
产物名、编译参数 |
| 内核加载 | OF: fdt: Unflattened device tree, memory at ... |
dtb 是否被启动流程读取 |
| padding | 有无 Memory limit exceeded |
-p 2048 是否保留 |
5.2 把参数和证据一起留档
从那以后我每次改完 dts,都先跑固定命令,再截两张图:一张 fdtdump 头部,一张串口 unflatten 日志。不是为了留痕好看,而是为了下次出现“编译通过但没生效”时,能立刻判断是 dtb 结构问题、加载路径问题,还是 padding 问题。dtc 这个代码开发工具本身不复杂,复杂的是人总想跳过验证。把 -p 2048、-Wno 的边界和两条证据固定下来,设备树编译就不再靠运气。希望帮到你。
