简介这是一份面向STM32L431低功耗应用的完整工程资源围绕Stop模式休眠与LPUARTRTC双唤醒机制实现经作者实际测试休眠与唤醒均正常适用于物联网终端、电池供电传感器等需要长时间待机又需定时或串口触发响应的场景。压缩包共1377个文件以C源码和头文件为主体692个.c、306个.h另有汇编文件、文本说明、ICF链接脚本以及编译生成的库文件与调试文件整体大小约31.23MB目录结构清晰便于按模块检索。目前已有5097人学习下载。资源不仅包含初始化RTC闹钟、配置LPUART低功耗接收唤醒、进入Stop模式及唤醒后恢复的完整代码还保留了编译中间文件与链接脚本可帮助开发者快速理解低功耗流程设计并可作为模板迁移到其他STM32L4系列项目中。1. 项目背景与需求分析一块采集板的待机功耗从哪里来某块使用 STM32L431 的采集板需要把大部分时间放在 Stop 休眠中然后用 LPUART 和 RTC 两种方式唤醒这个需求乍看很简单实际做起来却比想象中要绕。设备要挂在电池端平时整机电流必须压在微安级不能跑一个空转的 while 循环等中断但外部主机可能在任何时刻通过串口下发指令本地传感器也可能需要定时巡检两者都不能漏。最初我也考虑直接用 Standby 模式毕竟它的功耗更低可采集板里要保存滤波参数、校准值和最近一次采集数据这些 RAM 内容一掉电就没了醒来还要重新初始化外设业务上是不可接受的。最后定的方案就是 STM32L431 的 Stop 模式加双唤醒源RTC 负责定时巡检LPUART 负责外部串口指令实测休眠正常。这套思路适合正在做低功耗仪表、环境监测节点或者任何需要“平时睡、有事叫醒”的毕设和产品预研项目。2. 总体架构设计Stop 模式、外设时钟与两条唤醒链路2.1 低功耗模式选型为什么最终确定用 Stop 而不是 Standby低功耗项目的首要决策不是怎么写代码而是选哪个功耗模式。STM32L431 属于超低功耗系列提供了从 Sleep 到 Shutdown 的多级模式但每个模式对 RAM、外设和唤醒源的限制完全不同。整理成一张对比表就很清楚模式RAM 内容典型唤醒源功耗量级适合的场景Sleep保留几乎所有中断毫安级只有短暂等待不需要长期待机Stop保留RTC、LPUART、EXTI、LPTIM微安级长时间休眠且需要事件唤醒Standby丢失RTC、复位、唤醒引脚更低允许掉电重新初始化的设备Shutdown丢失RTC、复位最低完全重新上电也可以的设备这个项目里“RAM 必须保留”是一条硬需求因为它直接影响数据完整性。进入 Standby 后 RAM 断电唤醒后哪怕重新采集数据也会丢掉之前的一段记录主机那边如果刚好下发查询指令返回的内容就是残缺的。Stop 模式在这张表里是唯一同时满足“RAM 保留、功耗微安级、支持串口唤醒”的选项所以它成了平衡点。实际工程中还有一个细节L431 的 Stop 模式内部还可以选择不同的电源配置比如低功耗稳压器模式不同配置下的唤醒时间和电流略有差异本项目选用低功耗稳压器取其电流更低的优势。2.2 唤醒链路设计谁把 STM32L431 从停止状态“拽”出来所谓唤醒链路其实就是一条从外设事件到 CPU 运行的事件传递路线。RTC 这条路线比较简单RTC 的 WakeUpTimer 递减到 0产生一个唤醒事件事件连到 EXTI再由 NVIC 把 CPU 从 WFI 状态拉起随后进入 RTC_WKUP_IRQHandler。LPUART 这条路线需要单独设计因为普通 USART 在 Stop 模式下时钟往往被切断没法识别外部进来的数据帧而 LPUART 的内核时钟可以配置成 LSE 或 LSI这两个低频时钟在 Stop 模式下依然运行所以它能在系统时钟停掉的情况下检测到起始位或地址匹配帧。两条链路在设计上是互补的。RTC 唤醒适合周期性的活比如每 30 秒读一次传感器、上报一次状态LPUART 唤醒适合外部事件驱动的活比如主机发来一条配置指令设备要立刻醒来处理。如果只做 RTC 周期唤醒外部指令最多要等一个完整周期才能被响应如果只做 LPUART 唤醒定时采集就只能靠别的方式实现或者干脆漏掉。双唤醒源的设计思路就是把“定时”和“突发”两类业务分开让它们在中断处理函数里通过唤醒标志区分然后各自走各自的恢复流程。2.3 时钟树进入休眠前要把哪些时钟交给低功耗模式低功耗项目里时钟树规划往往决定了设备能不能被叫醒。这套方案里最关键的资源不是高速主时钟而是 32.768kHz 的 LSE。RTC 要拿它做日历和唤醒计时LPUART 要拿它做停态下的接收识别两个外设都依赖低频时钟所以在 CubeMX 里必须先把 LSE 打开并且把 RTC 时钟源和 LPUART 时钟源都指向 LSE。如果 LSE 没有起振或者没接晶振RTC 唤醒定时器根本不会走LPUART 也无法在停态下检测起始位这是很多板子“进得去、出不来”的根源。高速时钟在进入 Stop 之前可以不管因为 Stop 模式会停掉系统时钟但要在唤醒后明确恢复策略。通常的做法是让唤醒后的系统时钟先回到 MSI再在主程序里重新调 SystemClock_Config 把 PLL 和 80MHz 主频恢复回来/* 选择 Stop 唤醒后的系统时钟源为 MSI保证快速起步 */ __HAL_RCC_WAKEUPSTOP_CLK_CONFIG(RCC_STOP_WAKEUPCLOCK_MSI);这段配置的意思是硬件从 Stop 唤醒的一瞬间CPU 先跑在 MSI 上而不是立刻切到 PLL这样可以避免唤醒过程中 PLL 还没锁定就执行复杂指令导致 HardFault。开发者只需要在唤醒后重新执行时钟初始化把主频拉回 80MHz 再去处理业务逻辑上更稳。设计中还要注意 SysTick进入 Stop 前挂起它防止进出低功耗模式时 tick 中断抖动。3. 核心实现外设配置、中断处理和进入 Stop 的完整流程3.1 先配置外设LPUART 与 RTC 共用 LSE 低频时钟在 CubeMX 里的操作顺序一般是打开 LSE把 RTC 时钟源选为 LSE把 LPUART1 时钟源也选为 LSE然后配置 LPUART1 的波特率和 GPIO 复用。这里的 GPIO 复用很容易被忽略因为 L431 的 LPUART 引脚不止一组如果选错复用功能串口在正常运行模式下收发正常但进了 Stop 就再也醒不过来。引脚配置层面LPUART1_TX 和 LPUART1_RX 都选择 AF 复用注意器件封装的引脚分配即可。波特率在停态唤醒场景下建议用 115200因为在相同波特率下115200 的每一位时间更短起始位脉冲更窄这对功耗没有影响但对接线质量的容忍度更低所以很多开发者实际用 9600 或 57600。这里没有绝对标准关键是进 Stop 之前先通过正常的串口收发验证链路再进入低功耗测试否则外部主机发的唤醒帧到底是波形问题还是配置问题很难一次定位。RTC 的配置要单独设置。LSE 不光是 RTC 的时钟源还是唤醒定时器的计数基准初始化完成后 RTC 日历会自动运行WakeUpTimer 则在需要的时候加载。3.2 LPUART 唤醒配置起始位唤醒与地址匹配唤醒LPUART 在 Stop 模式下支持两种唤醒方式一种是起始位唤醒一种是地址匹配唤醒。起始位唤醒实现最简单外部主机随便发一个字节只要线上出现下降沿LPUART 就能把系统拉起来地址匹配唤醒需要双方约定一个地址字节设备只有收到和自己匹配的地址才醒抗干扰能力更好代价是主机发送前要额外的握手逻辑。本项目用的是起始位唤醒因为它对主机的软件改动最小。配置代码通常分两步第一步是允许 LPUART 在 Stop 模式下保留接收路径第二步是指定唤醒条件/* 允许 LPUART 在 Stop 模式下工作 */ HAL_UARTEx_EnableStopMode(hlpuart1); /* 选择起始位作为唤醒条件 */ HAL_LPUART_EnableWakeUp(hlpuart1, LPUART_WAKEUP_START_BIT);这段代码在进入休眠前调用顺序不能反。先使能 StopMode再使能唤醒外设才清楚“我现在允许被低功耗事件打断但我只在特定条件到来时叫醒 CPU”。如果先使能了唤醒功能却没有使能 StopMode 支持外设寄存器状态可能就不完整。要注意 API 名称在不同版本 Cube 库里可能略有差异有些版本写作 HAL_LPUARTEx_EnableWakeUp功能一致。唤醒后进入 LPUART 中断处理程序把接收到的数据寄存器读走这个动作不能省否则 RXNE 标志一直挂着后续数据就进不来了。3.3 RTC 唤醒定时配置把周期算到寄存器RTC 唤醒定时器是一个递减计数器配置时最重要的不是随便填一个数而是理解它的时钟源和单位。以常见的 16 位 WakeUpCounter 为例使用 CK_SPRE 作为计数时钟时频率为 1Hz也就是每秒减一计数器减到 0 触发唤醒事件。要注意的是这个触发发生在计数到 0 的时刻所以实际唤醒周期等于“计数器初值 1”秒这一点非常容易踩坑。RTC_WakeUpTypeDef wakeup_cfg {0}; wakeup_cfg.WakeUpClock RTC_WAKEUPCLOCK_CK_SPRE_16BITS; wakeup_cfg.WakeUpCounter 30; /* 实际唤醒周期 31 秒 */ HAL_RTCEx_SetWakeUpTimer_IT(hrtc, wakeup_cfg);如果业务上要求严格的 30 秒计数器应该填 29。如果要求更精细的时间粒度和选择性可以把 WakeUpClock 换成 2Hz、4Hz、8Hz 等档位再把唤醒周期换算成对应的计数值。实际调试时我会先在配置后面加一个相邻 GPIO 翻转用示波器看两次唤醒之间的间隔确认计数器逻辑再进入最终功耗测试。这样做的好处是如果周期差了 1 秒现象很明显不至于怀疑到代码之外的地方。3.4 进入 Stop 模式与中断处理的完整流程进入 Stop 的流程看起来只有一行 HAL 调用但前面的准备和后面的恢复决定了整个项目的稳定性。一个典型完整序列如下void enter_stop_sleep(void) { HAL_SuspendTick(); /* 挂起 SysTick防止睡眠期间 tick 抖动 */ __disable_irq(); /* 关闭全局中断防止进入过程被打断 */ /* 每次进入前重新加载唤醒定时器 */ RTC_WakeUpTypeDef wakeup_cfg; wakeup_cfg.WakeUpClock RTC_WAKEUPCLOCK_CK_SPRE_16BITS; wakeup_cfg.WakeUpCounter 29; /* 期望 30 秒唤醒 */ HAL_RTCEx_SetWakeUpTimer_IT(hrtc, wakeup_cfg); /* 再次使能 LPUART 唤醒 */ HAL_UARTEx_EnableStopMode(hlpuart1); HAL_LPUART_EnableWakeUp(hlpuart1, LPUART_WAKEUP_START_BIT); /* 进入停止模式稳压器切到低功耗档 */ HAL_PWR_EnterSTOPMode(PWR_LOWPOWERREGULATOR_ON, PWR_STOPENTRY_WFI); /* 以下代码在唤醒后继续执行 */ SystemClock_Config(); /* 先恢复 80MHz 主频 */ __enable_irq(); HAL_ResumeTick(); }这段代码里有几个细节值得说明。HAL_SuspendTick 要先于 __disable_irq因为 SysTick 的中断优先级如果比 disable 之后的临界区更高可能在进入停止模式前产生一次多余的 tick。进入停止模式后CPU 停在 WFI直到 RTC 或 LPUART 事件把 NVIC 唤醒唤醒后代码从 HAL_PWR_EnterSTOPMode 的下一行继续执行这和复位不是一回事所以不能指望 main 函数从头再跑一遍。SystemClock_Config 放在第一个是因为后面所有外设的波特率、定时器预分频都依赖系统时钟不先把主频恢复串口就会乱码。中断处理函数也很关键。两个唤醒源分别对应两个中断向量在中断里要把唤醒原因记录下来uint8_t wake_reason 0; void RTC_WKUP_IRQHandler(void) { wake_reason | 0x01; /* RTC 定时唤醒 */ HAL_RTCEx_WakeUpTimerIRQHandler(hrtc); } void LPUART1_IRQHandler(void) { wake_reason | 0x02; /* LPUART 串口唤醒 */ HAL_LPUART_IRQHandler(hlpuart1); }wake_reason 这个变量在唤醒后的主流程里判断决定是去采集传感器还是去解析指令。两个唤醒源同时到达时两个中断都会进只需按优先级顺序处理完再统一恢复时钟即可。这里最容易出现的问题是中断处理函数里没有在末尾调用对应的 HAL 中断回调导致中断标志没清干净唤醒后立刻又进入一次中断看起来像系统没睡踏实。3.5 唤醒后的恢复先时钟、再外设、最后业务唤醒后的恢复顺序如果搞错整个系统会出现“能醒但醒后不稳定”的尴尬状态。推荐的做法是严格分三步第一步恢复系统时钟把 PLL 拉回 80MHz第二步重新初始化需要重新配置的外设比如 LPUART、定时器第三步再执行具体的业务逻辑比如读传感器或者解析串口帧。这里的第二次初始化不是把所有外设都重新初始化一遍而是只处理那些时钟域可能丢失配置的模块。一个常见误区是唤醒后直接读串口数据忽略了串口外设的状态。Stop 模式下串口的接收路径可能保留也可能因为时钟切换而复位必须根据当前状态重新设置一遍波特率和中断。通常我会在唤醒后写一个 app_wakeup_restore 函数里面只放时钟恢复、串口重新初始化和状态机恢复这三件事业务逻辑全部放到这个函数之后。这样做的结果是不管从哪个唤醒源醒来恢复路径都一致调试时只需要关注这一个函数。4. 常见问题与排查Stop 低功耗项目中容易翻车的五个点4.1 坑一一进 Stop 就复位现象代码执行到 HAL_PWR_EnterSTOPMode 之后没有停留在休眠状态而是直接复位程序从启动文件重新跑或者过几百毫秒后自己重启。原因最常见的是引脚复位或独立看门狗没有关闭。IWDG 一旦开启就无法用软件关闭它在睡眠时继续计数若唤醒周期大于看门狗溢出时间系统就会在进入 Stop 后很快被看门狗复位。另一种情况是调试器通过 SWD 接口接入时复位引脚被调试器拉低或者外部有复位按键电路。解决先把 IWDG 溢出时间调整到大于唤醒周期或者直接忘了“测试时关看门狗量产时开看门狗”的做法再查看复位标志RCC 里的复位标志能告诉你到底是硬复位还是看门狗复位。确认方法是在代码启动初期读一次复位标志寄存器把值记录到备份寄存器里然后清标志复位原因一目了然。如果是外部复位引脚干扰检查滤威电路和调试器连接。4.2 坑二LPUART 接收不到唤醒字节现象外部主机用串口发数据示波器能看到 RX 引脚上有波乱但 MCU 没反应整机电流纹丝不动。原因多半是 LPUART 内核时钟没有选成 LSE 或 LSI而是挂在 APB1 上。Stop 模式下 APB1 时钟已经停了LPUART 就算使能了唤醒功能也没有时基去检测起始位。另一个原因是 GPIO 的复用配置不对RX 引脚没有连到 LPUART1 外设上数据信号根本没有进入串口模块。解决回到时钟树检查 LPUART1 的时钟源选择选 LSE再检查 GPIO 的 AF 配置是否与数据手册一致。调试时用循环抓一下主机发数据的波特率确认外部设备的位时序正确不要拿了一个 9600 的帧去唤醒配置成 115200 的设备起始位宽度不匹配也会导致识别失败。4.3 坑三RTC 周期唤醒差了一秒时间总对不上现象配置 30 秒唤醒一次实际测量却是 31 秒甚至随着计数器变大误差越来越明显。原因WakeUpTimer 是递减计数器计数器从配置值减到 0 才触发中断所以事件周期是“配置值 1”个时钟周期。如果直接用配置值当周期算就会稳定地少算 1 秒。解决把计数值按 T (WakeUpCounter 1) / f 来换算f 是所选时钟源频率。多人习惯在代码里写注释把换算过程留在旁边免得将来改配置时再踩一次。如果项目里要求精确到秒建议用 1Hz 的 CK_SPRE 时钟把计算关系简化到“计数器值 1 秒数”便于维护。4.4 坑四唤醒后串口乱码或波特率对不上现象唤醒后设备能跑但和主机通信的第一帧数据是乱的过一会儿又正常或者始终乱码。原因唤醒后系统时钟还在 MSI 上主频从 80MHz 掉到几 MHz串口波特率是按旧时钟算出来的当然和主机对不上。如果业务代码在 SystemClock_Config 之前就处理了串口数据第一帧几乎必然出错。解决把 SystemClock_Config 放到进入 Stop 唤醒后的第一条执行语句然后再初始化串口。实际项目中我会在唤醒恢复函数里加一个串口 reinit确保波特率寄存器按当前系统时钟重新计算。还有一个小技巧恢复后不要立刻按帧解析数据先等一个字节时间再读因为这个时间窗口内可能收到唤醒帧本身的一部分。4.5 坑五实测功耗比理论值高一个数量级现象数据手册上写微安级自己板子实测却没有变化或者电流在几百微安怎么都降不下来。原因板子上的漏电路径比 MCU 本身的功耗还大。常见的有外部上拉电阻、LED 指示灯、稳压器静态电流、未配置的 GPIO 悬空输入以及调试器通过 SWD 引脚给板子供电。这些因素单独看都很小叠加起来就完全掩盖了 MCU 的低功耗特性。解决休眠前把全部 GPIO 设成模拟输入模式尤其注意 ADC 引脚和复用引脚拔掉调试器只用稳压电源供电测量时把万用表串在电源和板子之间用较长积分时间读数。如果板上有 LDO还要把 LDO 自身的静态电流计入预算否则芯片再省电也没意义。通常我会先测一次“MCU 最小系统板”的电流再对比整机差值就是外部电路的漏电。5. 验收与答辩用一张实测表把整套方案钉死5.1 验收前必须准备的四样东西验收低功耗方案不能只在 Keil 里看变量要有一组可复现的数据。我会准备可调稳压电源、万用表、示波器和串口调试助手。电源电压稳定在 3.3V万用表用来测休眠电流示波器用来抓唤醒时间串口调试助手用来模拟外部主机发指令。示波器探头放到一个 GPIO 上进入 Stop 前拉高、唤醒后拉低这样两次翻转的时间差就是唤醒时间。5.2 验收清单与测量记录验收分成功能项和功耗项。功能项只看“能不能正常唤醒、唤醒后业务对不对”功耗项只看“休眠电流是否在预算内”。表格按下面这种方式记录每一轮测试都留档测试项操作预期结果实测RTC 周期唤醒配置 30 秒唤醒观察 GPIO 翻转30 秒 ± 1 秒准点唤醒30 秒正常LPUART 唤醒串口助手发送 1 字节数据设备立即唤醒并返回响应立即响应唤醒后时钟恢复唤醒后读取系统主频80MHz 正常80MHz 正常连续休眠稳定性循环进出 Stop 100 次无复位、无死机100 次通过休眠电流万用表串入电源回路指标 ≤ 10µA实测值记录留档这张表既是验收依据也是答辩时的演示材料。功耗测量建议取三次数据的平均值并且在表格里注明室温、供电电压和是否接通调试器因为这三项都会影响最终读数。5.3 答辩时容易被追问的三个点答辩中最高频的问题有三个为什么不用 Standby两个唤醒源同时唤醒怎么办以及功耗数据准不准。回答不用 Standby 时拿 RAM 数据保留和串口唤醒需求说事回答同时唤醒时讲清楚中断挂起标志和 wake_reason 的区分机制回答功耗准不准时直接出示测量条件、仪器和三次平均值。低功耗项目最忌讳只讲功能不讲数据只要功耗表记录完整方案就已经成功了一半。从那以后我每次做低功耗项目都强制自己把唤醒源、时钟和功耗记录绑成一张表先画清楚时钟树再写 WFI。这套方案对应一份可直接参考的工程模板里面包括 CubeMX 配置、HAL 初始化代码、中断处理和验收记录表拿到后改引脚、唤醒周期和波特率就能用在你自己板子上。希望帮到你。本文还有配套的精品资源点击获取
