1. 改完 dts 驱动不 probe:先用代码开发工具反查板上那棵树
改完 dts、编出 dtb、烧进板子,驱动就是不 probe,dmesg 里连 compatible 都没打出来——这种场景我见过太多次。遇到这类问题,代码开发工具里最该先用的不是编辑器,而是能反查运行时状态的那几个接口。很多人第一反应是回去翻驱动代码,加打印、改 match 表,折腾半天,其实问题可能根本不在代码里。设备树从 dts 源码到板上真正生效的运行时树,中间隔着编译、打包、启动加载好几道手,任何一道对不上,你看到的和板子上跑的就不是一回事。这篇面向已经能改 dts、能编 dtb,但一遇到“写了不生效”就抓瞎的驱动开发者,下面这套反查流程,是我每次 bring-up 都会走一遍的。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具链里的设备树:dts、dtb 与运行时展开树
2.1 dts 编译成 dtb 之后,内核里到底留下了什么
dts 是给人看的文本,节点靠大括号嵌套,属性写成 属性名 = 值。dtc 把它编译成 dtb,也就是扁平设备树,一种把树结构压平成线性二进制的格式。bootloader 把 dtb 放到内存里,启动时把地址告诉内核。内核解析这份二进制,把每个节点还原成目录、每个属性还原成文件,挂到 /proc/device-tree 下;同时内核把实际拿到的原始二进制留在 /sys/firmware/fdt。这两处是理解后面所有排查的基础。
很多新手把 /proc/device-tree 当成“源码的镜像”,这是个误解。它是内核解析后的视图,bootloader 在启动时可能对某些节点做 fixup,比如 memory、chosen 这类跟板级启动参数相关的节点,运行时看到的值不一定等于你 dts 里写的值。而 /sys/firmware/fdt 是内核真正拿到的原始字节,更接近“板子上跑的那份 dtb”。两者对照,才能把“源码写了”“加载了”“生效了”这三件事拆开看。
这里有个细节常被忽略:/proc/device-tree 下每个属性都是一个文件,compatible 这种多字符串属性在二进制里是用 \0 分隔的一串,直接 cat 会把它们连成看起来像乱码的一长串。这不是数据坏了,是读法不对,后面会专门讲怎么拆。
2.2 为什么“源码里写了”不等于“板子上生效”
从你改完 dts 到板上真正生效,至少要过五道手:编译成 dtb、打包进启动镜像或独立分区、bootloader 加载、内核解析、驱动匹配。任何一道用了旧文件,结果就不是你改的那份。最常见的翻车是:dts 改了但忘了重新编译;编译了但打包脚本没把新 dtb 塞进去;塞进去了但 bootloader 从另一个分区加载了旧的;板子上有多个 dtb,启动时选错了那个。
这就是为什么反复改 dts 重启很低效——你每次都在猜是哪一环出了问题。反查的思路是把“黑匣子”打开:先从板上把运行时状态抓出来,再和本地的编译产物对照,差异落在哪,问题就在哪。比起改一版重启一次、靠现象猜原因,这套做法省下的是反复重启和烧写的时间,血泪经验就是别在没确认运行时状态之前动驱动代码。
还有一种情况是 fixup 和 overlay。bootloader 可能根据板级信息改写节点,overlay 可能在启动后被动态应用或没应用。这些都不会反映在你本地那份 dts 里,只有看运行时树才看得见。所以“源码里写了”只是起点,不是证据。
2.3 反查前要准备的三样东西
第一样是 dtc 工具,宿主机上有最好,没有的话板子上通常也能找到,反编译只需要它。第二样是运行时 dtb,从 /sys/firmware/fdt 导出,这是板上真正在用的那份。第三样是本地编译产物,把你改的那份 dts 编成 dtb,再用 dtc 反编译成 dts 备用,作为对照基准。
还要确认两个接口可访问:/proc/device-tree 存在且能读,/sys/firmware/fdt 能复制出来。前者依赖内核把设备树展开到 procfs,后者依赖内核暴露原始 blob。如果其中一个读不到,先解决挂载或内核配置问题,再谈后面的对照。
准备阶段不用写任何驱动代码,也不用改 Makefile。把这三样凑齐,后面每一步都是只读操作,不会影响正在跑的系统,这也是我推荐先反查再动手的原因——它没有副作用,却能直接把范围缩小。
3. 运行时树反查:从 /proc/device-tree 到 dtc 反编译
3.1 用 /proc/device-tree 读节点和 compatible
先看单个节点的 compatible 实际值。路径按你板子上的实际节点改,下面以某个串口节点为例:
bash复制# 查看串口节点的 compatible 实际值
# tr 把 \0 换行,否则多个字符串会连成一串
cat /proc/device-tree/soc/serial@101F0000/compatible | tr '\0' '\n'
compatible 在 dtb 里是多个以 \0 分隔的字符串,直接 cat 会连在一起,tr '\0' '\n' 拆开才看得清顺序。这个顺序不是随便排的,它就是匹配优先级:内核拿设备节点里的 compatible 列表,按顺序去和驱动 match 表里的字符串比对,第一个对上的生效。如果你发现驱动匹配到了不该匹配的项,或者排在前面的那个 compatible 根本不该出现,问题往往就出在这个顺序上。
读其他属性也是同样的道理。字符串属性直接 cat 可读,数值属性可能是大端或小端二进制,cat 出来是乱码,得用 hexdump 或 od 看。这一步的目的不是把所有属性都读一遍,而是确认你关心的那个节点在运行时确实存在、compatible 值和你以为的一致。
3.2 导出 /sys/firmware/fdt 并用 dtc 反编译
/proc/device-tree 适合看单点,要看全貌就得把原始 dtb 导出来反编译:
bash复制# 把板上运行的原始 dtb 复制出来
cp /sys/firmware/fdt /tmp/running.dtb
# 反编译成可读的 dts,-I 输入格式,-O 输出格式,-o 输出文件
dtc -I dtb -O dts -o /tmp/running.dts /tmp/running.dtb
三个参数要分清:-I dtb 告诉 dtc 输入是二进制 dtb,-O dts 指定输出是文本 dts,-o 后面跟输出文件名。这条命令做的是反编译,把二进制还原成带节点和属性的文本树。反编译出来的 dts 会带上 dtc 自己生成的 phandle 和节点顺序,格式和你手写的源码不完全一样,这是正常的。
导出的 /tmp/running.dtb 是板上真正加载的那份,不是本地编译目录里的产物。这一步的价值在于:后面所有对照都以它为准,而不是以你“以为烧进去的那份”为准。
3.3 diff 本地 dts 与运行时 dts
有了运行时 dts,再准备一份本地对照。注意不能拿手写源码 dts 直接和反编译 dts diff,两者格式不同,会比出一堆无关差异。正确做法是把本地 dts 也编成 dtb、再反编译成 dts,放在一起比:
bash复制# board_decompiled.dts 是本地 dts 编译后再反编译得到的对照文件
diff /tmp/running.dts board_decompiled.dts
读 diff 结果时重点看三类差异:节点整段缺失,说明这个节点没进运行时树,可能是 status 不对、被上层 dtsi 覆盖,或者根本没编进去;属性值不同,说明运行时被 fixup 改过,或者你对照的本地产物不是最新;顺序不同,多数是 dtc 重排,可以忽略,但如果 compatible 顺序变了就要留意,它会影响匹配优先级。
这一步能把“写了没生效”具体化成某一行差异。定位到差异之后,再去查编译和打包链路,比盲目重启有效得多。反查到这里,设备树层面的事情基本清楚了,接下来要确认设备和驱动到底绑没绑上。
4. 用代码开发工具对照绑定:/sys/bus/platform 的两侧
4.1 devices 目录里的 driver 软链接说明什么
设备树节点被内核解析后,platform 设备会出现在 /sys/bus/platform/devices/ 下。看某个设备有没有绑上驱动,最直接的是看它目录里有没有 driver 软链接:
bash复制# 列出所有 platform 设备,看哪些带 driver 软链接
ls -l /sys/bus/platform/devices/
如果某个设备目录下存在 driver 软链接,并且指向某个驱动目录,说明匹配成功、probe 已经被调用;如果没有这个软链接,说明设备存在但没绑上驱动。这一步能快速把范围分成“设备没生成”和“设备生成了但没匹配”两类,比翻 dmesg 找匹配日志更直观。
4.2 drivers 目录反查绑定了哪些设备
反过来,从驱动侧也能看它绑了哪些设备:
bash复制# 看某个驱动目录下挂了哪些设备
ls /sys/bus/platform/drivers/<driver-name>/
驱动目录里除了驱动自身的属性文件,还会以软链接形式列出它当前绑定的设备。设备侧和驱动侧两边对照,能确认是“设备找不到驱动”还是“驱动找不到设备”。如果驱动目录根本不存在,那问题在驱动没编进内核或没加载,跟设备树无关,别再往 dts 上找。
4.3 设备没生成 vs 生成了没匹配
这两种情况的处理方向完全不同,必须分清。设备没生成,表现为 /sys/bus/platform/devices/ 下找不到对应目录,原因通常在设备树侧:节点 status 是 disabled、compatible 没对上任何驱动的 match 表、节点放错了父节点导致没被枚举。设备生成了但没匹配,表现为设备目录存在但没有 driver 软链接,原因通常在驱动侧:compatible 字符串拼写不一致、驱动没编进内核、模块没加载,或者 match 表里漏了这一项。
我一般的顺序是先看 devices 下有没有,再看有没有 driver 链接,最后才去 drivers 下反查。这个顺序能把“设备树问题”和“驱动问题”切开,避免在错误的方向上改代码。确认到具体哪一侧之后,再回到第 3 章的 diff 结果里找对应节点,通常能闭环。
5. 避坑:设备树反查里最容易翻车的四件事
5.1 compatible 直接 cat 连成一串
现象:cat compatible 输出一长串没有分隔的字符,看不出有几个值、顺序是什么,误以为属性写坏了。原因:多字符串属性在 dtb 里用 \0 分隔,终端不显示这个不可见字符。解决:读的时候固定加 tr '\0' '\n',把每个字符串拆到单独一行,顺序一目了然。这个坑几乎每个刚接触设备树的人都踩过,养成读 compatible 就带 tr 的习惯能省很多困惑。
5.2 拿编译产物当运行时状态
现象:本地 dts 改了、编译也过了,dump 出来是对的,但板上行为就是不对。原因:你看的是本地编译目录里的 dtb,不是板上真正加载的那份,中间打包或加载环节可能用了旧文件。解决:一律从 /sys/firmware/fdt 导出运行时 dtb 再反编译,和本地产物 diff,差异会直接告诉你哪一环没更新。这个习惯的价值在于把“我以为”换成“板上确实是”。
5.3 多实例设备 probe 到错节点
现象:同 compatible 的节点有多个,驱动 probe 了,但操作的寄存器或资源不对,或者只有一个实例正常工作。原因:probe 拿到的 of_node 不是你以为的那个,多实例时尤其容易混。解决:在 probe 里打印节点全路径确认身份,别靠猜。下面第 6 章的日志写法就是干这个用的,多实例场景下这一步几乎必做。
5.4 改了 dts 没重新编 dtb
现象:改完 dts 重启,行为一点没变,diff 也看不出运行时树有变化。原因:dts 改了但没重新编译,或者编译了没打包进启动镜像,或者 bootloader 从另一个分区加载了旧 dtb。解决:确认编译产物的时间戳、打包脚本有没有带上新 dtb、启动介质上那份是不是最新的。这个坑最隐蔽的地方在于它看起来像“改动没生效”,实际是“改动根本没上板”。
6. probe 日志做最终确认:of_* API 与 %pOF 的用法
6.1 读 model 属性确认节点身份
反查做到驱动侧,最后一步是在 probe 里打日志,确认拿到的节点就是你预期的那个。加一段读 model 属性并打印全路径的代码:
c复制struct device_node *np = pdev->dev.of_node;
const char *model = NULL;
/* 能读到 model 就带上,读不到也不影响打印节点路径 */
if (of_property_read_string(np, "model", &model) == 0)
dev_info(&pdev->dev, "probing node %pOF, model=%s\n", np, model);
else
dev_info(&pdev->dev, "probing node %pOF\n", np);
of_property_read_string 读字符串属性,成功返回 0;%pOF 是打印 device_node 的专用格式符,会输出节点全路径,比手拼字符串靠谱,也不会因为节点名里有特殊字符而出错。多实例设备时,这行日志能直接告诉你 probe 的是哪个节点,避免“以为在操作 A、实际在操作 B”的翻车。
6.2 一套固定的验证流程
从那以后我每次改完 dts,都先把 /sys/firmware/fdt 导出来和本地编译产物 diff 一遍,再看 /sys/bus/platform/devices/ 有没有 driver 软链接,最后才去看 probe 日志里的 %pOF 输出。这套顺序固定下来之后,大部分“写了不生效”的问题在动驱动代码之前就能定位,省下的是反复重启和烧写的时间。希望帮到你。
