`struct dev_pm_ops` 数据结构,是理清内核电源管理核心在挂起、恢复阶段执行逻辑的关键,完整电源管理链路:
prepare→suspend→suspend_late→suspend_noirq,唤醒后依次执行 resume_noirq→resume_early→resume→complete,全部流程在 include/linux/suspend.h 的 `enum suspend_stat_step` 中做了完整定义。内核实现系统休眠的核心函数为 enter_state(),以此为入口拆解挂起与恢复全流程。
1 挂起阶段执行流程
系统进入休眠时,enter_state() 遵循固定顺序逐层执行。未开启 `CONFIG_SUSPEND_SKIP_SYNC` 配置时,优先执行文件系统同步操作,调用 ksys_sync 保障数据落盘;随后触发挂起通知程序,此时用户空间依旧存活,对应通过 register_pm_notifier 注册的辅助逻辑。
同步与通知完成后,系统冻结全部用户空间与内核线程,调用 suspend_freeze_processes 完成任务冻结,若内核未配置 `CONFIG_SUSPEND_freezer`,该步骤直接跳过。任务冻结结束后,进入设备挂起第一阶段,遍历调用驱动注册的 suspend 回调,对应 suspend_devices_and_enter 流程;为避免设备触发中断干扰流程,随即调用 suspend_device_irqs 禁用设备中断,阻断驱动接收外部中断。
中断禁用后,进入设备挂起第二阶段,执行 suspend_noirq 回调,该阶段统称 noirq 阶段。设备挂起全部完成后,借助 CPU 热插拔机制下线非启动 CPU,提前告知调度器禁止向这类 CPU 分配任务,对应 disable_nonboot_cpus 实现。后续关闭全局中断,执行系统核心回调 syscore_suspend,最终让系统进入休眠状态,不同休眠模式对应的部分操作存在细微差异。
2 恢复阶段执行流程
系统休眠期间,一旦产生唤醒事件,电源管理核心将按固定流程唤醒系统。首先接收唤醒触发信号,运行 CPU 唤醒代码;随即执行系统核心回调 syscore_resume,并恢复全局中断;再通过 CPU 热插拔重新启用非引导 CPU,让全部核心回归可用。
系统底层恢复完成后,开始恢复设备,第一阶段调用 resume_noirq 回调;随后重新开放设备中断,进入设备恢复第二阶段,调用 resume 回调;设备恢复结束后,解冻先前冻结的任务;待用户空间完全恢复后,依次调用对应通知程序,系统完成完整唤醒流程。
对驱动开发者而言,恢复全流程属于内核黑盒,无需干预内部调度,只需根据自身需要,用对应回调填充 `struct dev_pm_ops` 即可适配系统休眠。
3 系统休眠功能实现
系统休眠和运行时电源管理关联密切但不可相互替代,二者操作方式不同,即便能让系统进入相同物理状态,替换使用极易引发异常。驱动若要适配系统休眠,需依据休眠模式,在 `struct dev_pm_ops` 中填充适配回调,通用回调包含 suspend、resume、freeze、thaw、poweroff、restore 六大类。
suspend 回调在系统休眠前执行,会完整保留主内存数据;resume 回调在系统唤醒后调用,同样保留内存内容,设备运行状态由对应平台与子系统决定。freeze 专属特定休眠模式,在生成休眠镜像前执行,逻辑类似 suspend,但禁止设备产生唤醒信号、变更电源状态,多数驱动仅负责把设备配置存入内存,为后续唤醒做准备。
thaw 同样适配特定休眠模式,在休眠镜像生成完成、生成失败、内存恢复失败三种场景下触发,作用是撤销 freeze 阶段的全部改动,让设备回归冻结前状态。poweroff 在休眠镜像保存后执行,逻辑接近 suspend,无需额外保存设备配置;restore 在内存从休眠镜像恢复完成后执行,逻辑与 resume 相似,多数回调功能趋同,为简化开发,内核提供多款宏自动填充结构体。
`SET_SYSTEM_SLEEP_PM_OPS` 仅需传入 suspend、resume 两个函数,即可自动填充 suspend、resume、freeze、thaw、poweroff、restore 全部常规回调。`SET_NOIRQ_SYSTEM_SLEEP_PM_OPS` 专为 noirq 阶段设计,传入两个回调后,自动填充 suspend_noirq、resume_noirq、freeze_noirq、thaw_noirq、poweroff_noirq、restore_noirq,所有 noirq 回调均在中断禁用环境下运行,严禁休眠操作。
`SET_LATE_SYSTEM_SLEEP_PM_OPS` 可将 suspend_late、freeze_late、poweroff_late 指向同一 suspend 函数,resume_early、thaw_early、restore_early 指向同一 resume 函数,大幅减少重复代码。
上述宏均依赖 `CONFIG_PM_SLEEP` 内核配置,未开启电源管理功能时不会参与编译。若设备需要同时兼容挂起到内存、休眠两种模式,可直接使用 `SIMPLE_DEV_PM_OPS`,传入结构体名称与 suspend、resume 回调即可一键完成结构体初始化。
结合实践,常见问题与排查
1. 系统挂起中途卡顿
遇到挂起停滞,优先借助 `/sys/power/pm_test` 做分层测试,依次写入 freezer、devices、platform、processors、core 参数发起挂起,内核会在对应阶段停留5秒后自动恢复,可精准定位故障发生在任务冻结、设备挂起、平台适配或CPU下线环节。
同时查看 `/sys/kernel/debug/suspend_stats` 获取历史挂起成功、失败记录与失败步骤;内核启动参数追加 no_console_suspend、pm_debug_messages,可开启详细调试日志,快速定位卡顿根源。
2. 单个设备导致挂起失败
内核日志出现 “PM: Some devices failed to suspend” 提示,基本可判定为设备回调异常。重点排查设备 suspend、suspend_noirq 回调返回值,noirq 阶段中断处于禁用状态,回调内绝对不能调用可休眠接口,一旦出现睡眠操作必然挂起失败。可在回调内部添加 dev_dbg 打印,通过 dmesg 过滤 PM 关键字,确认回调是否进入、是否正常返回。
3. 唤醒后设备运行异常
设备休眠与恢复回调必须严格配对,suspend 与 resume、suspend_noirq 与 resume_noirq、freeze 与 thaw、poweroff 与 restore 缺一不可。若 suspend 中关闭了时钟、电源域,resume 阶段必须按反向顺序完成恢复。使用 `SET_SYSTEM_SLEEP_PM_OPS` 时需留意,该宏会将 suspend、freeze、poweroff 绑定同一函数,若三类场景业务逻辑不同,切勿使用该宏,需单独实现对应回调。
4. noirq 回调休眠引发卡死
所有带 noirq 后缀的回调,全程处于中断禁用环境,严禁任何休眠、阻塞操作,需要睡眠的流程必须迁移至 suspend、resume、suspend_late、resume_early 中执行,使用 `SET_NOIRQ_SYSTEM_SLEEP_PM_OPS` 生成的回调也受此规则约束。
5. 唤醒失败或无法唤醒
先用 pm_test 区分故障阶段,若 devices 模式可正常唤醒,platform、core 模式异常,故障多来自平台固件或系统深层状态。通过 `/sys/kernel/debug/wakeup_sources` 查看各唤醒源运行状态与锁信息,排查设备是否未开启唤醒能力、是否存在异常唤醒事件。
6. 系统休眠与运行时电源管理冲突
设备同时适配系统休眠与运行时电源管理时,两种机制容易产生状态冲突,推荐使用 pm_runtime_force_suspend、pm_runtime_force_resume 协调二者关系,避免设备被重复挂起、重复恢复。驱动需要保证两套机制对设备状态的判定标准一致,可在 suspend 中先调用 pm_runtime_get_sync 再执行挂起,resume 中完成恢复后再调用 pm_runtime_put_autosuspend,规避状态错乱。
调试与落地技巧
日常调试可依托系统电源节点完成,`/sys/power/state、/sys/power/mem_sleep、/sys/power/disk` 用于切换休眠模式与执行动作;`/sys/power/pm_test` 实现分层测试;`/sys/kernel/debug/suspend_stats` 统计挂起数据;`/sys/kernel/debug/wakeup_sources` 监控唤醒源;配合 dmesg 过滤 suspend、resume、PM 关键字,回调内添加调试日志,是定位休眠问题最直接的方式。
系统休眠的核心在于固定流程与回调约束,挂起遵循 prepare、suspend、suspend_late、suspend_noirq 顺序,恢复遵循 resume_noirq、resume_early、resume、complete 顺序,全程穿插任务冻结、中断管控、CPU 调度与核心回调。驱动开发时按需填充回调、善用内核宏简化开发,严格遵守各阶段上下文限制,才能保障休眠与唤醒功能稳定运行。