嵌入式 Linux 与 RTOS / 系统课时

定位早期启动卡点

定位早期启动卡点

早期启动失败最难的地方不是“没有日志”,而是不知道最后一条日志属于启动链的哪一段。本篇用串口末尾信息给故障分层,再借助 earlycon、日志级别和启动参数替换,把范围从整条启动链缩到一个可验证的阶段。

学习目标

  • 根据串口最后一条有效日志判断故障位于 Bootloader、内核早期启动、驱动探测还是根文件系统阶段
  • 使用 earlycon、loglevel 与 ignore_loglevel 提前暴露内核日志
  • 通过临时替换 root=、init= 等启动参数验证根文件系统与用户空间边界

先用最后一条日志定阶段

不要一上来就改设备树或重新裁剪内核。先保存完整串口输出,找到最后一条稳定重复出现的有效日志,再判断它前后应该发生什么。

常见边界可以这样读:

最后可见位置 更可能的故障范围 下一步
还在 U-Boot,未出现 Starting kernel ... 内核、DTB、地址或加载命令 检查镜像地址、大小、启动命令与 DTB
已出现 Starting kernel ...,随后完全静默 解压、早期控制台、架构初始化 先启用 earlycon 和最高日志级别
已有内核时间戳日志,卡在某个设备初始化附近 设备树、时钟、电源域、驱动 probe 根据最后一个驱动继续追踪
出现 VFS: Unable to mount root fs root=、存储驱动、文件系统驱动或根分区 检查根设备和相关驱动是否 built-in
已挂载根文件系统但启动 init 失败 init=、动态链接库或用户空间 临时改为最小 init 验证

早期启动卡点定位流程

这张图把笼统的“启动卡死”拆成多个可验证边界。只要确认代码已经越过某个阶段,就不要再把主要精力放回更早的位置。

让内核尽可能早地说话

如果串口能看到 Starting kernel ...,但之后没有任何内核输出,优先怀疑控制台还没初始化,而不是立即断定内核已经死机。可以在 U-Boot 中临时追加调试参数,不先修改永久环境。

下面命令假设原来的 bootargs 已包含正常启动参数。如果平台不能从设备树自动推导 early console,还需要把裸 earlycon 换成 SoC 对应的 earlycon 驱动和 MMIO 参数。

bash
printenv bootargs
setenv bootargs "${bootargs} earlycon loglevel=8 ignore_loglevel"
printenv bootargs
boot

预期输出

text
bootargs=<原启动参数> earlycon loglevel=8 ignore_loglevel
<启动后比原先更早出现的内核日志>

实际串口内容会随 SoC、内核版本和控制台驱动变化。这里验证的不是某一条固定日志,而是原来的静默区是否被提前打破。如果仍只看到 Starting kernel ...,应继续检查镜像格式、加载地址、入口地址以及 DTB 是否匹配。

用参数替换验证根文件系统

当日志已经推进到块设备或 VFS,排查重点就从“内核有没有运行”切换为“内核能不能找到并挂载正确的根文件系统”。

优先核对三件事:root= 指向的设备是否真实存在;存储控制器和根文件系统驱动是否直接编进内核;设备枚举较慢时是否需要 rootwait。根文件系统依赖的驱动不能只做成尚未可访问的 .ko 模块,否则会形成“为了读取模块必须先挂载根文件系统”的循环依赖。

如果怀疑根文件系统已经挂载,而正常 init 进程存在问题,可以临时把 init= 指向板上确定存在的最小入口,例如 /bin/sh。若最小 shell 能运行,说明内核、根文件系统和基本挂载链路已经越过,故障应转向用户空间初始化。

卡在驱动 probe 时怎么缩小

内核已经持续打印日志,却总停在同一个驱动附近时,不要只盯着驱动源码。很多“probe 卡死”实际来自设备树资源不完整,例如时钟未打开、复位线没有释放、电源域未就绪,或中断号、寄存器地址错误。

定位时保持单变量:先记录最后一个成功初始化的设备和第一个未完成的设备;再核对可疑节点的 status、compatible、时钟、复位、电源和中断资源;必要时临时禁用该节点,观察启动是否越过原卡点。一次只改一个条件,才能把现象变化与具体修改建立因果关系。

形成可复现的最小证据

每次调整都保留三样东西:完整串口日志、实际 bootargs、本次唯一变更。不要同时修改设备树、内核配置和根文件系统,否则即使机器恢复启动,也无法确定真正生效的是哪项修复。

最终应能明确回答三个问题:启动已经越过哪个边界、下一阶段为什么失败、哪一个最小变更让现象发生了可重复的变化。做到这一点,早期启动故障才算真正被定位,而不是碰巧绕过。

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

目录与阅读设置

阅读设置

17

记录一个想法

定位早期启动卡点

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

登录哪都通