STM32 低功耗模式下的 RTC 唤醒源失效排查与修复

引言

在物联网设备、可穿戴设备等电池供电的应用中，低功耗模式（如Stop、Standby）是延长续航的核心手段。STM32的RTC（实时时钟）通常被配置为定时唤醒源，让系统周期性醒来执行任务。但很多开发者（包括我）都曾遇到过这样的问题：代码在正常模式下RTC中断正常，一旦进入Stop模式，RTC就“罢工”了，系统无法唤醒。本文将基于STM32L4系列（但原理适用于大多数STM32），分享一次完整的排查与修复过程。

一、RTC唤醒的工作原理

1. RTC唤醒源的本质

RTC唤醒通常使用RTC的唤醒定时器（WakeUp Timer） 或闹钟（Alarm）。在低功耗模式下，RTC时钟（通常为LSE或LSI）继续运行，当计数达到设定值时，产生一个唤醒事件，将MCU从低功耗模式唤醒。

唤醒定时器：基于可配置的时钟源（如1Hz、2Hz等）进行递减计数，计数到0时触发中断。
闹钟：比较RTC时间与预设闹钟时间，匹配时触发中断。

2. 低功耗模式下的中断路径

在Stop模式下，大部分外设时钟被关闭，但RTC由于使用独立的低速时钟（LSE/LSI），仍然可以工作。唤醒信号通过RTC的WKUP引脚或内部事件连接到电源控制单元（PWR），从而唤醒系统。关键点在于：唤醒事件必须被正确使能，且中断标志必须被清除。

二、失效原因分析

根据我的实战经验，RTC唤醒失效通常由以下几个原因导致：

1. 时钟源配置错误

LSE未就绪：如果使用LSE（外部32.768kHz晶振），但晶振未起振或配置了错误的驱动能力，RTC将无法计时。
LSI精度问题：LSI（内部低速时钟）精度较低，可能导致唤醒时间偏差，但不会导致完全失效。

2. 中断优先级或NVIC配置不当

在进入低功耗模式前，RTC中断的NVIC使能位可能被意外关闭。
中断优先级设置过高，导致被其他中断屏蔽（但通常不会完全失效）。

3. 唤醒事件未正确配置

对于唤醒定时器，需要设置RTC_WAKEUPCLOCK_CK_SPRE_16BITS等时钟分频，并计算重载值。
对于闹钟，需要确保闹钟匹配格式（如掩码）正确。

4. 进入低功耗模式的方式错误

使用HAL_PWR_EnterSTOPMode时，第二个参数PWR_STOPENTRY_WFI或WFE的选择会影响唤醒行为。WFI（等待中断）需要中断触发，而WFE（等待事件）需要事件触发。如果配置为WFI但唤醒源是事件，则无法唤醒。

5. 未清除RTC中断标志

唤醒后，如果没有清除RTC的中断标志，再次进入低功耗模式时，唤醒信号可能被忽略。

6. 调试器影响

在调试时，内核可能被暂停，导致低功耗模式行为异常。

三、排查步骤

步骤1：检查RTC时钟源

首先，确保RTC时钟源已就绪。在初始化代码中，检查LSE是否起振：

// 等待LSE就绪
while (__HAL_RCC_GET_FLAG(RCC_FLAG_LSERDY) == RESET) {
    // 超时处理
}

如果使用LSI，确保其已使能。

步骤2：验证RTC唤醒配置

以唤醒定时器为例，配置代码如下：

void RTC_WakeUp_Init(void) {
    RTC_WakeUpTypeDef wakeup_param;
    wakeup_param.WakeUpClock = RTC_WAKEUPCLOCK_CK_SPRE_16BITS; // 1Hz时钟
    wakeup_param.WakeUpCounter = 10; // 10秒唤醒
    wakeup_param.AutoWakeUp = ENABLE;
    HAL_RTCEx_SetWakeUpTimer(&hrtc, &wakeup_param, HAL_RTC_WAKEUP_IRQn);
}

注意：AutoWakeUp必须使能，否则唤醒后不会自动重新加载计数器。

步骤3：检查中断优先级和使能

在进入低功耗模式前，确保RTC中断已使能：

HAL_NVIC_SetPriority(RTC_WKUP_IRQn, 0, 0);
HAL_NVIC_EnableIRQ(RTC_WKUP_IRQn);

步骤4：正确进入低功耗模式

使用HAL_PWR_EnterSTOPMode时，注意WFI/WFE的选择：

// 使用WFI，等待中断唤醒
HAL_PWR_EnterSTOPMode(PWR_LOWPOWERREGULATOR_ON, PWR_STOPENTRY_WFI);

如果使用WFE，需要确保唤醒源是事件。

步骤5：清除中断标志

在RTC唤醒中断服务函数中，清除标志：

void RTC_WKUP_IRQHandler(void) {
    HAL_RTCEx_WakeUpTimerIRQHandler(&hrtc);
}

void HAL_RTCEx_WakeUpTimerEventCallback(RTC_HandleTypeDef *hrtc) {
    // 用户代码
    __HAL_RTC_WAKEUPTIMER_EXTI_CLEAR_FLAG(); // 清除EXTI标志
}

四、完整代码示例

以下是一个完整的低功耗+RTC唤醒示例（基于STM32L4，使用HAL库）：

#include "stm32l4xx_hal.h"

RTC_HandleTypeDef hrtc;

void SystemClock_Config(void);
void RTC_Init(void);
void Enter_LowPower(void);

int main(void) {
    HAL_Init();
    SystemClock_Config();
    RTC_Init();

    while (1) {
        // 执行任务
        HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
        HAL_Delay(100);

        // 进入低功耗模式
        Enter_LowPower();
        // 唤醒后继续执行
    }
}

void RTC_Init(void) {
    __HAL_RCC_RTC_ENABLE();
    hrtc.Instance = RTC;
    hrtc.Init.HourFormat = RTC_HOURFORMAT_24;
    hrtc.Init.AsynchPrediv = 127;
    hrtc.Init.SynchPrediv = 255;
    hrtc.Init.OutPut = RTC_OUTPUT_DISABLE;
    hrtc.Init.OutPutPolarity = RTC_OUTPUT_POLARITY_HIGH;
    hrtc.Init.OutPutType = RTC_OUTPUT_TYPE_OPENDRAIN;
    HAL_RTC_Init(&hrtc);

    // 配置唤醒定时器，10秒唤醒
    RTC_WakeUpTypeDef wakeup_param;
    wakeup_param.WakeUpClock = RTC_WAKEUPCLOCK_CK_SPRE_16BITS; // 1Hz
    wakeup_param.WakeUpCounter = 10;
    wakeup_param.AutoWakeUp = ENABLE;
    HAL_RTCEx_SetWakeUpTimer(&hrtc, &wakeup_param, HAL_RTC_WAKEUP_IRQn);

    // 使能NVIC中断
    HAL_NVIC_SetPriority(RTC_WKUP_IRQn, 0, 0);
    HAL_NVIC_EnableIRQ(RTC_WKUP_IRQn);
}

void Enter_LowPower(void) {
    // 确保RTC唤醒中断已使能
    HAL_NVIC_EnableIRQ(RTC_WKUP_IRQn);
    // 进入Stop模式，使用WFI
    HAL_PWR_EnterSTOPMode(PWR_LOWPOWERREGULATOR_ON, PWR_STOPENTRY_WFI);
    // 唤醒后重新配置系统时钟（因为Stop模式会关闭HSE/HSI）
    SystemClock_Config();
}

void RTC_WKUP_IRQHandler(void) {
    HAL_RTCEx_WakeUpTimerIRQHandler(&hrtc);
}

void HAL_RTCEx_WakeUpTimerEventCallback(RTC_HandleTypeDef *hrtc) {
    // 清除EXTI标志（关键！）
    __HAL_RTC_WAKEUPTIMER_EXTI_CLEAR_FLAG();
    // 用户代码，例如记录唤醒次数
}

void SystemClock_Config(void) {
    // 标准时钟配置，使用HSE或HSI，略
}

五、注意事项

时钟源选择：优先使用LSE，因为LSI在低功耗下精度差且可能受温度影响。
电源稳压器：在Stop模式下，可以选择低功耗稳压器（PWR_LOWPOWERREGULATOR_ON），但唤醒时间会变长。
调试模式：如果使用ST-Link调试，建议在进入低功耗前断开调试器，或使用DBGMCU配置保持调试功能。
多次唤醒：如果唤醒后需要再次进入低功耗，务必在每次唤醒后清除所有标志，并重新配置唤醒定时器（如果AutoWakeUp未使能）。
中断服务函数：在中断中不要执行耗时操作，只设置标志，在主循环中处理。

六、总结

RTC唤醒失效往往不是单一原因，而是多个配置细节的叠加。通过系统性地检查时钟源、唤醒配置、中断使能、低功耗模式进入方式以及标志清除，可以快速定位问题。希望本文的排查思路和代码示例能帮助你在嵌入式开发中少走弯路。如果你也遇到过类似问题，欢迎在评论区分享你的经验！

STM32 低功耗模式下的 RTC 唤醒源失效排查与修复：一个嵌入式工程师的实战记录