嵌入式 Linux 与 RTOS / 系统课时
定位设备树绑定失败
定位设备树绑定失败
设备树节点写进 DTS 后驱动仍未工作时,先确认运行中的设备树是否真有该节点,再判断设备是否生成、驱动是否匹配,最后检查资源解析。按这条证据链排查,可以快速区分旧 DTB、匹配失败和 probe 失败。
学习目标
- 用
dtc与/proc/device-tree核对内核运行时实际看到的节点内容。 - 通过 sysfs 与内核日志区分“节点未生成、驱动未匹配、资源解析失败”三类故障。
- 修正
compatible、reg、status和 phandle 引用后完成绑定验证。
先确认运行中的节点
源码里的 DTS 正确,不代表启动后的设备树就是这一版。Bootloader 可能加载了旧 DTB,也可能在启动时修改节点,因此排障第一步应检查运行时视图,而不是只看源码。
下面把 /proc/device-tree 反编译成可读 DTS,并搜索 I2C 地址 0x48 的示例传感器节点。实际设备名称不同,只需替换 temperature-sensor@48。
# 先导出运行中内核实际使用的设备树,避免只检查源码。
sudo dtc -I fs -O dts -o /tmp/live.dts /proc/device-tree
NODE="$(find -L /proc/device-tree -type d -name 'temperature-sensor@48' -print -quit)"
test -n "$NODE" || { echo "node-not-found"; exit 1; }
printf 'compatible='; tr -d '\0' < "$NODE/compatible"; echo
# status 属性缺省也表示节点可用。
if test -f "$NODE/status"; then printf 'status='; tr -d '\0' < "$NODE/status"; echo; else echo 'status=okay (default)'; fi
grep -n -A6 -B1 'temperature-sensor@48' /tmp/live.dts预期输出
compatible=<VENDOR>,<DEVICE>
status=okay
<LINE>: temperature-sensor@48 {
<LINE>- compatible = "<VENDOR>,<DEVICE>";
<LINE>- reg = <0x48>;如果得到 node-not-found,说明内核当前设备树里没有该节点,应优先检查 DTB 是否重新编译、是否被正确打包,以及 Bootloader 实际加载的是哪个文件。若输出 status=okay (default),表示节点没有显式 status 属性,但按设备树规则仍视为可用。
沿绑定链逐层定位
设备树平台设备或总线设备能否最终进入驱动,大致要经过“节点有效 → 设备创建 → 驱动匹配 → probe 解析资源”这条链。任何一层失败,后面的现象都会不同。

以 I2C 设备为例,假设运行后设备目录是 <BUS>-0048。把 <BUS> 换成实际总线号后,先看设备是否存在,再看 driver 符号链接是否建立;最后从日志里找匹配与资源错误。
DEV="/sys/bus/i2c/devices/<BUS>-0048"
test -d "$DEV" && echo "device-created"
# driver 链接存在,才表示设备已经绑定到某个驱动。
if test -L "$DEV/driver"; then readlink -f "$DEV/driver"; else echo "driver-not-bound"; fi
# probe defer、资源解析和驱动报错通常都会进入内核日志。
dmesg | grep -Ei 'temperature|<DRIVER>|probe|defer|error|fail' | tail -n 30预期输出
device-created
/sys/bus/i2c/drivers/<DRIVER>
<匹配到的相关内核日志;具体时间戳和内容因驱动而异>若只看到 device-created 和 driver-not-bound,说明设备已经由总线创建,但还没有驱动接管,应重点核对驱动是否加载、of_match_table 是否包含同一个 compatible。若连设备目录都没有,则回到控制器状态、子节点地址和总线枚举条件继续检查。
核对四类高频属性
compatible 必须与驱动的 OF 匹配表逐字一致,不能把芯片营销名称当成绑定字符串。status 通常写为 okay;父控制器若是 disabled,子节点写得再正确也不会正常工作。
reg 的编码由父节点的 #address-cells 和 #size-cells 决定。I2C/SPI 子设备的 reg 常表示从地址或片选号,而 MMIO 设备通常表示地址范围。这里最容易出现“值看似正确,实际 cell 数不匹配”的问题。
时钟、GPIO、中断、复位等属性通常通过 phandle 引用其他节点。引用目标不存在、参数 cell 数错误,或 provider 驱动尚未准备好时,probe 可能直接失败,也可能返回 -EPROBE_DEFER 延后重试。
下面是修正后的 DTS 片段示例,依赖上下文中已经存在 &i2c1 控制器标签,并把 vendor,device 替换为驱动真正支持的绑定字符串。
&i2c1 {
status = "okay";
temperature-sensor@48 {
compatible = "vendor,device";
reg = <0x48>;
status = "okay";
};
};该配置生效后,应重新编译并部署 DTB,再重复检查 /proc/device-tree 与 sysfs;只有运行时节点、设备目录和 driver 链接同时符合预期,才算修复真正进入了正在运行的系统。
用现象判断根因
| 现象 | 优先检查 |
|---|---|
/proc/device-tree 没有目标节点 |
DTB 是否更新、Bootloader 加载路径、overlay 是否生效 |
| 节点存在但 sysfs 没有设备 | 父总线状态、status、reg、总线枚举条件 |
设备存在但没有 driver 链接 |
驱动是否加载、compatible、OF 匹配表 |
已进入 probe 但返回错误 |
reg、IRQ、clock、GPIO、reset、pinctrl 等资源 |
日志出现 EPROBE_DEFER |
被引用的 provider 是否稍后注册、依赖关系是否完整 |
排障时始终以运行中的设备树和 sysfs 状态为证据。先证明节点存在,再证明设备创建,再证明驱动匹配,最后才分析资源;这样能避免把“旧 DTB”误判成驱动 bug,也能避免在 probe 还没发生时浪费时间检查驱动内部逻辑。