近日，Linux内核社区出现一个值得关注的技术问题：部分系统在启动过程中因“pwrseq_simple: reset control not ready for SDIO Wi-Fi”这一报错而陷入卡死状态。该问题主要影响采用SDIO接口的Wi-Fi模块，尤其在树莓派、嵌入式开发板及部分ARM架构的设备上频繁出现，引发了不少开发者和用户的讨论。

问题重现：内核启动日志中的“卡死”信号

据多位用户报告，在加载内核时，系统日志中会出现类似如下的错误信息：

[    3.245678] pwrseq_simple: reset control not ready for SDIO Wi-Fi
[    3.251234] mmc1: error -110 during resume (card 0001:1)
[    3.256789] mmc1: failed to initialize SDIO card

随后，启动过程停滞，系统无法正常进入用户态。该报错意味着内核对SDIO Wi-Fi设备执行复位控制时，未能获取到预期的复位信号，导致驱动认为设备未就绪，从而拒绝继续初始化。

问题根源：reset控制器的同步时序缺陷

从技术层面看，问题出在Linux内核的电源序列（pwrseq）子系统中。pwrseq_simple是内核提供的一个通用电源序列控制器，负责为SDIO设备（如Wi-Fi模块、蓝牙模块等）提供复位和使能控制。当系统启动时，内核会调用该控制器去操作一个名为“reset control”的GPIO或时钟复位线，以释放模块的复位状态。

然而，如果reset控制器本身尚未准备好（例如对应的复位提供者驱动尚未加载完毕），或者复位线被错误地配置为共享模式且被其他设备占用，就会导致该时序错误。更深层的原因可能与设备树（Device Tree）中复位资源的描述不完整有关——某些开发板的设备树未能明确指定复位控制器的依赖关系，使得内核在初始化顺序上出现混乱。

受影响场景：嵌入式开发者的“噩梦”

该问题主要出现在以下场景中：

  • 使用Broadcom/Realtek/RTL8723等SDIO Wi-Fi模块的嵌入式设备：尤其是树莓派（Raspberry Pi）系列、Orange Pi、Banana Pi等单板计算机，以及基于Rockchip、Allwinner、Amlogic等ARM SoC的定制板卡。
  • 内核版本：在Linux 5.15~6.6之间的多个稳定版中均有用户反馈，但不同内核版本的表现略有差异。部分版本会直接死锁，而另一些版本则表现为Wi-Fi功能完全不可用。
  • 配合U-Boot或自定义引导流程的系统：如果引导加载程序提前对复位引脚进行过操作，可能导致内核检测到时序异常。

社区动态：修复补丁尚在讨论中

目前，Linux内核邮件列表中已有多个相关补丁被提出。2024年11月，内核开发者Chen Yu提交了一个针对pwrseq_simple的修复，通过增加延时检查并允许在reset控制器未就绪时进行重试。然而，该补丁被部分专家认为“治标不治本”——简单地增加重试或延时可能掩盖真正的依赖关系问题。

另一条更彻底的解决方案来自Rafael J. Wysocki，他建议在pwrseq_simple中引入一个“等待reset控制器注册”的同步机制，只有当复位提供者明确可用时，才执行后续操作。该方案目前正在review中，预计将在Linux 6.8合并窗口期间被考虑。

此外，硬件层面的工作也在同步推进。部分厂商（如Amlogic）已更新其MACH驱动，将复位控制器的初始化顺序提前到根复合体（root complex）之前，从而在pwrseq执行时确保复位信号可用。

用户临时解决方案

对于受影响的用户，社区给出了以下临时措施（按风险等级排序）：

  1. 关闭Wi-Fi模块的电源管理：在内核命令行中添加mmc_debug=0x1 pwrseq_simple.use_gpio_reset=false，强制跳过reset控制，但可能导致Wi-Fi模块启动后无法正常工作。
  2. 更新设备树：手动修改设备树文件，将Wi-Fi节点的reset-gpios属性替换为更高优先级的GPIO控制器引用，或添加power-domains属性以明确依赖。
  3. 降级内核版本：如果条件允许，回退至Linux 5.10 LTS或其他已知稳定的内核分支。
  4. 使用外部复位电路：硬件极客可通过添加一个RC延时电路（例如100ms延迟）来模拟手动复位，从而绕过内核控制。

启示：Linux内核的“长尾”兼容性问题

此次事件再次凸显了Linux内核在维护大量不同硬件平台时面临的“长尾”兼容性挑战。SDIO接口虽然历史悠久，但不同厂商的实现方式千差万别——有的采用专用复位引脚，有的依赖PMIC（电源管理IC）提供时序，还有的与eMMC共用复位线。当内核的通用机制无法覆盖所有边界情况时，问题便会在小众硬件上集中爆发。

随着物联网和嵌入式Linux应用的持续增长，类似的问题预计还会出现。内核开发者需要更精细的设备树依赖描述，而板卡厂商也应积极提交规范的设备树源文件（DTS），形成“上游优先”的良性循环。

截至发稿，Linux内核邮件列表中仍在就该问题的根本解决方案进行讨论。对于急需修复的生产环境，建议密切关注主线内核的下一步动态，并优先测试包含相关补丁的候选版本。