嵌入式 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。

bash
# 先导出运行中内核实际使用的设备树,避免只检查源码。
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

预期输出

text
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 符号链接是否建立;最后从日志里找匹配与资源错误。

bash
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

预期输出

text
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 替换为驱动真正支持的绑定字符串。

dts
&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 还没发生时浪费时间检查驱动内部逻辑。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定位设备树绑定失败

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通