2. 低功耗模式配置：HAL库低功耗配置API详解、时钟源选择、电压调节器配置

各位好，欢迎来到第二章。上一章我们聊了低功耗的基本概念，这一章直接上手——怎么用HAL库把STM32的几种低功耗模式配出来。

说实话，HAL库的API封装得挺厚，但如果你不清楚底层在干什么，很容易配出一个“看似睡了、实际还在耗电”的尴尬状态。我调试过好几个项目，都是因为API调用顺序不对，或者时钟源没切干净，导致功耗比预期高了十几倍。

咱们今天就把这三块核心内容拆开揉碎：HAL库的配置API、时钟源怎么选、电压调节器怎么调。

2.1 HAL库低功耗配置API全景

先看一张总图，把STM32进入和退出低功耗模式的流程理清楚。

这张图是我自己画项目流程图时常用的结构。你注意看，配置唤醒源和电压调节器这两步，很多人会搞反顺序。我踩过这个坑——先进了Stop模式才发现唤醒引脚没使能，结果芯片叫不醒，只能按复位。

2.2 核心API详解

HAL库把低功耗相关的API都放在 stm32l4xx_hal_pwr.c 和 stm32l4xx_hal_pwr_ex.c 里。咱们挑几个最常用的，一个一个说。

2.2.1 HAL_PWR_EnterSLEEPMode()

这个函数最简单，说白了就是让CPU暂停，但外设和时钟都还跑着。

void HAL_PWR_EnterSLEEPMode(uint32_t Regulator, uint8_t SLEEPEntry);

参数说明：

我个人习惯用WFI，因为大部分场景都是等中断来了再干活。WFE适合那种需要事件触发、不依赖中断向量的场景，比如外设间直接握手。

2.2.2 HAL_PWR_EnterSTOPMode()

这个才是真正的低功耗主力。Stop模式下，内核时钟停了，但SRAM和寄存器内容保留。

void HAL_PWR_EnterSTOPMode(uint32_t Regulator, uint8_t STOPEntry);

参数里有个坑——Regulator 这里可以选 PWR_REGULATOR_ON 或 PWR_REGULATOR_LOWPOWER。选LowPower模式能再省30%~50%的电流，但唤醒时间会变长。我做过一个表计项目，电池供电，必须用LowPower模式，否则一年就得换电池。

2.2.3 HAL_PWR_EnterSTANDBYMode()

Standby模式最狠——除了备份域和RTC，其他全部断电。唤醒后相当于复位重跑。

void HAL_PWR_EnterSTANDBYMode(void);

这个函数没有参数，调用前必须做好两件事：

• 使能唤醒引脚：HAL_PWR_EnableWakeUpPin(PWR_WAKEUP_PIN1)
• 清除Standby标志：__HAL_PWR_CLEAR_FLAG(PWR_FLAG_SB)

我记得第一次用Standby模式时，忘了清标志位，结果一进Standby立马又醒了，功耗根本测不出来。后来查勘误手册才发现这个坑。

2.3 时钟源选择——低功耗的关键

时钟源选不对，功耗降不下来。我见过有人用Stop模式，但HSI没关，电流硬是多出200μA。

STM32的时钟源分几类：

在Stop模式下，你可以选择让哪个时钟继续跑。比如RTC要用LSE，那就得在进入Stop前把LSE配置好，并且调用 HAL_RTCEx_DisableBypass() 之类的函数确保它不掉。

2.4 电压调节器配置

电压调节器（Regulator）是STM32内部给核心逻辑供电的模块。它有两种模式：

• MR（Main Regulator）：全速运行模式，输出1.2V左右，响应快
• LPR（Low Power Regulator）：低功耗模式，输出1.0V左右，响应慢

配置API是：

HAL_StatusTypeDef HAL_PWR_ConfigRegulator(uint32_t Regulator);
// 参数可选：
//   PWR_REGULATOR_ON        -> 使用MR
//   PWR_REGULATOR_LOWPOWER  -> 使用LPR

这个函数必须在进入Stop模式之前调用。我习惯在系统初始化时就配好，然后根据当前工作状态动态切换。

举个例子，一个传感器采集节点的工作流程：

1. 上电：MR模式，全速采集数据（耗时2 ms）
2. 数据处理：MR模式，计算和打包（耗时5 ms）
3. 无线发送：MR模式，LoRa发射（耗时100 ms）
4. 进入休眠：切换到LPR模式，然后调用 HAL_PWR_EnterSTOPMode()

这里有个细节——从LPR切回MR需要时间，大约10~20 μs。如果你的应用对唤醒时间要求苛刻，比如1 μs内必须响应，那就别用LPR，老老实实保持MR。

2.5 一个完整的配置示例

下面是我在一个温湿度采集节点里实际用过的代码，跑在STM32L051上，目标功耗低于2 μA。

// 进入Stop模式（LPR + RTC唤醒）
void EnterStopMode(void)
{
    // 1. 确保RTC时钟源已稳定
    while(__HAL_RTC_IS_CLOCK_DISABLED(&hrtc));

    // 2. 配置唤醒引脚（如果使用外部唤醒）
    HAL_PWR_EnableWakeUpPin(PWR_WAKEUP_PIN1);

    // 3. 清除Standby标志（防止误唤醒）
    __HAL_PWR_CLEAR_FLAG(PWR_FLAG_SB);

    // 4. 配置电压调节器为低功耗模式
    HAL_PWR_ConfigRegulator(PWR_REGULATOR_LOWPOWER);

    // 5. 进入Stop模式，使用WFI
    HAL_PWR_EnterSTOPMode(PWR_REGULATOR_LOWPOWER, PWR_STOPENTRY_WFI);

    // 6. 唤醒后第一件事：重新配置系统时钟
    SystemClock_Config();  // 恢复MSI或HSI

    // 7. 关闭唤醒引脚（可选）
    HAL_PWR_DisableWakeUpPin(PWR_WAKEUP_PIN1);
}

这段代码我用了两年多，没出过问题。注意第6步——很多人醒来后直接跑业务代码，忘了重新配时钟，结果外设跑在错误的频率上，数据全错。

2.6 常见故障与定位

最后聊几个我实际遇到过的故障，你调试时大概率也会碰到。