📚 课程目录第2章电源管理基础

2、电源管理基础：ACPI、DT、UEFI等电源管理规范与Linux电源管理框架概览

Linux 的电源管理并非一套孤立的代码逻辑，而是建立在多种硬件描述规范与操作系统策略之上的分层协作体系。在嵌入式 ARM 平台中，设备树（Device Tree, DT）承担了硬件拓扑与电源域的描述职责；而在 x86/服务器平台中，ACPI（高级配置与电源管理接口）与 UEFI（统一可扩展固件接口）则通过固件与操作系统之间的标准化接口，实现了处理器、内存、外设的精细功耗控制。理解这些规范如何与 Linux 内核的 PM 框架（包括 PM Core、Runtime PM、Suspend/Resume 流程、CPUIdle/CPUFreq、PM QoS 等）衔接，是深入剖析休眠唤醒机制的前提。本章将梳理这些基础规范的核心作用，并勾勒出 Linux 电源管理框架的整体视图。

上图展示了 Linux 电源管理框架与硬件描述规范之间的协作关系。左侧是硬件描述规范层，它们负责向操作系统“告知”硬件平台的电源管理能力；中间是 Linux PM 核心框架，负责策略制定与状态机管理；右侧是具体的实现机制，最终作用于底层的电源管理域。下面我们逐一剖析这些组成部分。

2.1 核心原理：三大规范的分工与定位

ACPI、DT、UEFI 三者并非竞争关系，而是从不同维度为 Linux 电源管理提供支撑。理解它们的边界至关重要。

ACPI（高级配置与电源管理接口）：主要面向 x86 和 ARM64 服务器平台。它由固件（BIOS/UEFI）提供一系列表（如 DSDT、FADT、MADT），描述了处理器状态（C-states）、设备电源状态（D-states）、系统睡眠状态（S0-S5）以及热管理策略。Linux 通过 acpi_* 驱动解析这些表，并调用 ACPI 方法（如 _PS0、_PS3）来控制设备电源。
Device Tree（设备树）：主要面向 ARM 嵌入式平台。DT 通过 DTS（设备树源文件）描述硬件拓扑，包括电源域（power-domain）、供电电压（regulator）、时钟（clock）、复位（reset）等属性。内核中的 drivers/base/power/ 代码会解析 DT 中的 power-domains 属性，并创建对应的通用电源域（genpd）。
UEFI（统一可扩展固件接口）：它更多是作为系统启动和运行时固件接口。在电源管理方面，UEFI 定义了 ResetSystem、SetVariable 等运行时服务，同时通过 ACPI 表向 OS 传递电源管理信息。UEFI 还定义了 Capsule 更新机制，用于固件级别的功耗优化。

经验提醒：在嵌入式 ARM 平台中，如果设备树中缺少 power-domains 属性，内核将无法为该设备关联正确的电源域，导致休眠时设备无法完全断电，或者唤醒时设备无法正常复位。这是最常见的休眠唤醒异常根因之一。

2.2 判断方法：如何识别平台使用的电源管理规范

在调试电源管理问题时，首先需要确认当前平台依赖哪种规范。以下是快速判断方法：

查看内核启动日志：执行 dmesg | grep -i acpi，如果输出大量 ACPI 表信息，则平台使用 ACPI；如果输出 OF: fdt 或 Device Tree 相关字样，则使用 DT。
检查内核配置：CONFIG_ACPI 和 CONFIG_OF 是否开启。ARM64 服务器可能同时开启两者，但 ACPI 优先。
查看设备模型：在 /sys/firmware/ 目录下，如果存在 acpi 子目录，则说明 ACPI 生效；如果存在 devicetree 子目录，则说明 DT 生效。
电源域检查：通过 ls /sys/kernel/debug/pm_genpd/ 查看注册的电源域。如果电源域名称与 DTS 中的节点名一致，则说明 DT 驱动了电源域。

特性	ACPI	Device Tree	UEFI
主要平台	x86, ARM64 Server	ARM 嵌入式, RISC-V	所有支持 UEFI 启动的平台
描述方式	AML 字节码 + 表	DTS 源文件编译为 DTB	C 语言编写的固件驱动
电源域描述	ACPI 电源资源 (`_PR0`)	`power-domains` 属性	通过 ACPI 间接提供
休眠状态定义	S0-S5, S3 (STR)	内核态 `suspend-to-ram`	提供休眠前固件准备
运行时 PM	设备 `_PR0/_PR3` 方法	Runtime PM 框架 + genpd	固件运行时服务

2.3 案例拆解：ARM 平台设备树电源域配置实战

以一个典型的 i.MX8M Plus 平台为例，该平台包含多个电源域：pgc_mipi、pgc_gpu、pgc_vpu 等。在 DTS 中，电源域控制器节点通常如下：

pgc: power-domain@0 {
    compatible = "fsl,imx8mp-pgc";
    #power-domain-cells = <1>;
    reg = <0x0 0x0 0x0 0x100>;
    
    pgc_mipi: power-domain@1 {
        #power-domain-cells = <0>;
        reg = <1>;
        clocks = <&clk IMX8MP_CLK_MIPI_DSI_ROOT>;
        assigned-clocks = <&clk IMX8MP_CLK_MIPI_DSI_ROOT>;
        assigned-clock-parents = <&clk IMX8MP_SYS_PLL1_800M>;
    };
    
    pgc_gpu: power-domain@2 {
        #power-domain-cells = <0>;
        reg = <2>;
        clocks = <&clk IMX8MP_CLK_GPU_ROOT>;
    };
};

而某个 MIPI DSI 设备节点则通过 power-domains 属性关联到该电源域：

&mipi_dsi {
    power-domains = <&pgc pgc_mipi>;
    status = "okay";
};

当系统进入休眠时，内核的 genpd 框架会按照依赖顺序关闭电源域。具体流程如下：

设备暂停：MIPI DSI 驱动的 suspend 回调被调用，停止数据传输。
电源域关闭：genpd 检查该电源域的引用计数，若为 0，则调用 power_off 回调，该回调会操作 PGC 寄存器，切断 MIPI 电源。
时钟关闭：与电源域关联的时钟（如 IMX8MP_CLK_MIPI_DSI_ROOT）被关闭，进一步降低功耗。

风险提示：如果 DTS 中电源域与设备关联错误，例如将 GPU 设备关联到 MIPI 电源域，会导致休眠时 GPU 未断电，而 MIPI 电源被错误切断，唤醒后 GPU 可能工作异常，甚至损坏硬件。务必核对 power-domains 索引与 reg 值的一致性。

2.4 常见误区与总结复盘

在理解这些规范时，工程师常陷入以下误区：

误区一：认为 ACPI 只用于 x86。实际上，ARM64 服务器（如鲲鹏、Ampere）也广泛使用 ACPI，用于支持标准化的热插拔和电源管理。
误区二：忽略 UEFI 在休眠中的作用。UEFI 的 SetVariable 功能可用于保存休眠标志，确保系统从休眠恢复时能正确判断唤醒源。
误区三：混淆 Runtime PM 与系统休眠。Runtime PM 是设备在系统运行时动态开关电源，而系统休眠是整体进入低功耗状态。两者在 Linux 中由不同的回调管理，但共享电源域资源。

总结复盘：Linux 电源管理框架的健壮性依赖于硬件描述规范的准确性。在嵌入式平台，设备树是电源域配置的核心；在服务器平台，ACPI 表是电源策略的依据。掌握这些规范与内核 PM 框架的交互方式，是后续分析休眠唤醒问题的基石。建议读者在实战中，首先通过 /sys/kernel/debug/pm_genpd/ 和 dmesg 确认电源域状态，再深入排查具体设备的 PM 回调行为。