单片机与物联网 / 系统课时
外部事件唤醒
外部事件唤醒
本课实现 STM32 在 Stop 模式下等待按键或 RTC 定时事件,并在唤醒后识别具体原因。你将完成唤醒源配置、休眠入口、回调记录和恢复验证,避免因悬空引脚、遗留标志或时钟未恢复导致反复唤醒。
学习目标
- 配置 GPIO 外部中断和 RTC 唤醒定时器
- 按正确顺序进入 Stop 模式并恢复系统时钟
- 记录唤醒原因并处理立即唤醒等常见问题
唤醒链路
外部唤醒并不是休眠函数自动完成的。GPIO 或 RTC 先产生事件,EXTI 或 RTC 中断控制器再向 Cortex-M 内核发出中断请求,内核退出 WFI,执行中断服务函数,最后回到休眠入口后的代码。

这条链路中有三个必须满足的条件:唤醒源处于有效状态、对应中断在 NVIC 中已使能、进入休眠前没有未清除的挂起标志。任一条件错误,都可能导致无法唤醒或刚休眠就返回。
CubeMX 配置要点
按键引脚应配置为 GPIO 外部中断模式,并根据电路选择上升沿、下降沿或双边沿触发。输入不能悬空,应使用内部上拉、内部下拉或外部电阻保持稳定电平。
RTC 需要稳定的时钟源。若使用 32.768 kHz 的 LSE,唤醒定时器选择 RTCCLK/16 后计数频率为 2048 Hz,5 秒对应的计数值为 。
在 NVIC 页面启用对应的 EXTI 中断和 RTC Wake-up 中断。生成代码后,应确认 MX_GPIO_Init()、MX_RTC_Init() 和中断处理函数已经存在。
按键与 RTC 唤醒示例
下面是片段示例,假定 CubeMX 已生成 hrtc、USER_BUTTON_Pin、GPIO 初始化和 SystemClock_Config()。示例每次进入 Stop2,既允许按键唤醒,也设置 5 秒 RTC 超时唤醒。
#include "main.h"
extern RTC_HandleTypeDef hrtc;
typedef enum {
WAKE_REASON_NONE,
WAKE_REASON_BUTTON,
WAKE_REASON_RTC
} WakeReason;
static volatile WakeReason wakeReason = WAKE_REASON_NONE;
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
{
if (GPIO_Pin == USER_BUTTON_Pin) {
wakeReason = WAKE_REASON_BUTTON;
}
}
void HAL_RTCEx_WakeUpTimerEventCallback(RTC_HandleTypeDef *hrtcHandle)
{
if (hrtcHandle->Instance == RTC) {
wakeReason = WAKE_REASON_RTC;
}
}
WakeReason SleepUntilButtonOrTimeout(void)
{
wakeReason = WAKE_REASON_NONE;
// 重新配置前先关闭旧定时器,避免遗留标志造成立即唤醒
HAL_RTCEx_DeactivateWakeUpTimer(&hrtc);
__HAL_GPIO_EXTI_CLEAR_IT(USER_BUTTON_Pin);
if (HAL_RTCEx_SetWakeUpTimer_IT(
&hrtc,
10239U,
RTC_WAKEUPCLOCK_RTCCLK_DIV16) != HAL_OK) {
Error_Handler();
}
HAL_SuspendTick();
HAL_PWREx_EnterSTOP2Mode(PWR_STOPENTRY_WFI);
// 唤醒后先恢复主时钟,再访问串口等高速外设
SystemClock_Config();
HAL_ResumeTick();
HAL_RTCEx_DeactivateWakeUpTimer(&hrtc);
return wakeReason;
}预期结果
按下用户按键:函数返回 WAKE_REASON_BUTTON
5 秒内未按键:RTC 到期,函数返回 WAKE_REASON_RTC
唤醒后:系统时钟恢复,主循环继续运行主循环可以根据返回值执行不同任务。实际项目中,按键机械抖动可能连续触发中断,回调中只记录事件,消抖和业务处理应放在主循环或任务中完成。
验证方法
验证时先让 LED 或串口输出进入休眠前的状态,再分别测试按键和超时唤醒。串口日志中的时间、端口和设备路径属于动态值,实际显示可能不同。
<TIME> enter stop2
<TIME> wake reason: button
<PORT> uart ready如果需要测量真实待机电流,应停止周期性日志、关闭不使用的外设时钟,并在休眠期间避免 LED 常亮。串口打印只能放在进入休眠前或完成时钟恢复后。
典型失败处理
设备立即唤醒时,优先检查 EXTI 挂起位、RTC 唤醒标志和按键当前电平。边沿配置与静态电平不匹配、按键抖动或旧中断未清除,都会让 WFI 立即结束。
设备无法被按键唤醒时,检查 GPIO 是否配置为 EXTI 模式、NVIC 是否启用、引脚是否连接到支持的 EXTI 线,以及低功耗模式是否允许该唤醒源工作。
设备唤醒后串口乱码或定时异常,通常是 Stop 退出后没有重新执行 SystemClock_Config()。应先恢复时钟,再恢复依赖 PLL、APB 或外设内核时钟的模块。