企业官网建设流程全解析

简介：一份基于官方标准外设库的STM32L系列例程合集，面向低功耗嵌入式应用开发者，适用于电池供电的便携设备或电源敏感场景。资源覆盖ADC模拟采集、DAC波形输出、EXTI外部中断、I2C传感器通信、GPIO控制、USART串口调试等常用外设，配合例程可快速完成初始化配置、中断处理和基本数据收发。压缩包共1443个文件，约24.25MB，以C语言源文件与头文件为主，同时含有Keil/IAR工程、HTML帮助文档、图片及文本说明，便于直接导入工程比对学习。已有2826人学习浏览。通过官方库函数与标准例程，可减少底层寄存器操作的工作量，快速梳理外设配置流程，并将已验证的驱动模块迁移到实际项目中。 我想先聊一个很多朋友拿到STM32L开发板之后都会遇到的困惑：官方例程明明编译下载成功，LED也在闪，但拿电流表一量整板电流好几毫安——说好的低功耗呢？我见过太多人卡在这一步，然后开始怀疑芯片有问题，或者Example例程写得太烂。实际上，问题往往出在看待例程的方式上：你把STM32L例程当成STM32F例程来跑了。

这篇文章不打算做那种“照着例程点灯”的流水账，而是想从“怎么读懂一个STM32L例程”出发，把L系列和普通F系列在例程写法上的底层差异、官方固件包该怎么用、低功耗例程里那些最容易坑人的细节一次讲透。无论你是刚入手NUCLEO-L053R8的初学者，还是要做电池供电产品的嵌入式工程师，这篇文章都值得你花几分钟看完。

1. 别急着跑例程：STM32L和F系列在思路上根本不是一回事

1.1 L系列的例程，从外设到时钟都带着省电基因

很多人第一次打开STM32L例程的代码，会觉得很奇怪：为什么一个简单的GPIO翻转，还要先配置什么MSI时钟、电压调节器范围、Flash等待周期？这些东西在F103的例程里根本没见过。

这里要说清楚一个核心差异：F系列的设计目标是“性能优先”，外设怎么快怎么来；L系列的设计目标是“功耗优先”，每一个外设几乎都有对应的低功耗版本。比如定时器有LPTIM（低功耗定时器），串口有LPUART（低功耗串口），ADC也有低功耗采样模式。这些外设的共性是：它们可以在CPU进入Stop模式之后继续工作，由低速时钟（LSE或LSI）驱动，功耗只有几十微安甚至几微安级别。

更关键的是时钟系统。L系列的内部RC振荡器叫MSI，频率可以从65kHz调到4MHz（部分型号更高），而不是F103那种固定8MHz的HSI。为什么这么设计？因为MCU在全速跑的时候功耗和时钟频率直接挂钩，如果只是做周期性的传感器采集，把MSI降到2MHz跑完任务再睡，比用8MHz跑完再睡省得多。所以你在L例程里看到的时钟配置，往往不是“直接上最高主频”，而是“够用就行”。

1.2 判断一个L例程是否合格：看它怎么处理这三件事

我在看例程代码的时候有一个习惯：不看它实现了什么功能，先看它处理了下面三件事没有。

第一件事是IO口的初始状态。低功耗项目的漏电流大头经常出在这里：某个GPIO既没配置成输出，也没配置成输入，处于浮空状态，结果这个引脚上的电平不定，内部保护二极管在微弱的漏电，整板功耗直接高出好几微安。正规的L例程在进入低功耗模式之前，会把所有不用的引脚统一配置成模拟输入或固定电平输出，而不是放任不管。

第二件事是Flash等待周期。L系列在低电压供电下，Flash读取需要插入等待周期，否则代码跑着跑着会HardFault。有些例程为了省事直接写死，但在电池电压跌落的时候就会出问题。好的例程会在时钟切换的同时重新计算并配置Flash等待周期。

第三件事是唤醒后的时钟恢复。从Stop模式唤醒之后，系统时钟默认回到MSI，你之前配置的PLL、HSE全部失效。如果你在唤醒后直接操作外设，会发现串口波特率乱了、定时器时间不对了。一个完整的例程必须在唤醒流程里重新把时钟切回目标配置。

明白了这三件事，你再去看官方例程，就不会觉得代码啰嗦了——每一处配置都是在为“低功耗”这个目标服务。

2. 官方例程资源地图：从下载固件包到定位目标工程

2.1 固件包怎么选、怎么装

STM32L系列有L0、L1、L4、L4+、L5等子系列，每个子系列对应不同的固件包。你在ST官网搜索STM32CubeL0或者直接从STM32CubeMX的软件包管理器里下载都行，版本号越新越好，老版本在编译器兼容性上会有一些麻烦。

安装完成之后，你得熟悉这个目录结构。以STM32CubeL0为例，根目录下有Projects、Drivers、Middlewares等文件夹。Drivers里面是HAL库和LL库源码，Projects下面才是我们真正要看的例程。

Projects目录先按开发板分，比如NUCLEO-L053R8、STM32L0538-EVAL，然后每块板子下面又分三类：

我个人的建议是：初级阶段只看Examples，别碰Demonstrations。Demonstrations里塞了太多图形界面和通信协议，代码量巨大，阅读体验很差，对理解L系列低功耗设计几乎没有帮助。

2.2 每个例程文件夹里，真正值得看的是哪几个文件

还是以Projects/NUCLEO-L053R8/Examples为例，打开PWR（电源管理）或者RTC（实时时钟）目录，里面通常有EWARM、MDK-ARM、STM32CubeIDE三个文件夹，对应不同IDE的工程文件。现在ST官方主推STM32CubeIDE，免费且跨平台，MDK-ARM工程在最新固件包里反而有时候会缺少一些支持文件。

例程源码通常分成几个文件：main.c是主逻辑，stm32l0xx_hal_msp.c是外设的底层初始化（比如引脚复用、DMA通道分配），stm32l0xx_it.c是中断服务函数。我建议你重点看main.c和stm32l0xx_hal_msp.c，前者告诉你功能怎么实现，后者告诉你外设和引脚的对应关系——这两个文件看懂，例程就能移植到你的板子上。

2.3 我建议搭一个“对照工程”来辅助学习

纯读代码的效果其实有限，我自己的方法是：用STM32CubeMX按自己的板子生成一个最小工程，然后打开官方例程，把它的关键外设配置抄到自己的工程里。这样有两个好处：第一，CubeMX帮你处理了底层时钟和引脚的配置，你不用去读那些晦涩的寄存器操作；第二，对照官方代码和生成代码的差异，你会更清楚哪些配置是真正关键的、哪些是CubeMX自动生成的冗余代码。

不要直接复制官方例程的整个工程文件夹来改，因为工程里绑定了特定的板型和链接脚本，改成自己的板子很容易出现莫名其妙的编译错误或运行异常。我在这上面吃过亏，后来一直是“CubeMX生成工程 + 官方例程抄逻辑”的路线，稳定得多。

3. 案例拆解：一个低功耗RTC唤醒例程的前前后后

3.1 为什么要拿它当第一个例程跑

我建议所有刚接触STM32L的人，第一件事就是把RTC唤醒的低功耗例程跑通。原因很简单：RTC唤醒是低功耗产品最核心的工作模式——睡一会儿、醒来干活、再睡。无论是温湿度记录仪、智能门锁、还是各种传感器节点，本质都是这个循环。

而且这个例程把前面说的“时钟配置、外设初始化、进入低功耗、唤醒恢复”完整串了起来，跑通它，你基本就理解了L系列低功耗代码的整体框架。

3.2 逐段解析：从时钟配置到唤醒处理

拿STM32L0的RTC唤醒例程来说，初始化流程大概是这样的：

第一段是RTC时钟源配置。RTC在低功耗模式下要持续走时，所以它的时钟源必须来自LSE（32.768kHz外部晶振）或LSI（约37kHz内部低速RC）。LSE精度高但需要外部晶振，LSI精度差一些但省了一个晶振和两个电容。例程默认用LSE，如果你的板子上没焊晶振，得改成LSI。

/* 启用PWR时钟，才能操作备份域寄存器 */ __HAL_RCC_PWR_CLK_ENABLE(); __HAL_RCC_RTC_ENABLE(); /* 配置RTC时钟源为LSE */ RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_LSE; RCC_OscInitStruct.PLL.PLLState = RCC_PLL_NONE; RCC_OscInitStruct.LSEState = RCC_LSE_ON; HAL_RCC_OscConfig(&RCC_OscInitStruct);

第二段是RTC唤醒定时器配置。这里有个关键点：唤醒定时器的时钟源需要先通过RTC的外部时钟分频寄存器设置，否则唤醒周期会跟你想的不一样。例程里通过HAL_RTCEx_SetWakeUpTimer_IT设置唤醒时间，这个函数最后一个参数是分频系数，对应关系可以查参考手册，别想当然地以为传多少就延时多少秒。

第三段是进入低功耗模式。L系列最常见的两种模式是Stop和Standby。Stop模式下SRAM和寄存器内容全部保持，唤醒后可以接着执行；Standby模式除了备份域，其他全部断电，唤醒后相当于复位重跑。例程通常用Standby演示RTC唤醒，因为代码最简单。进入方法如下：

HAL_PWR_EnableWakeUpPin(PWR_WAKEUP_PIN1); HAL_PWR_EnterSTANDBYMode();

注意，HAL_PWR_EnterSTANDBYMode这个函数不会返回——如果没配置唤醒源，代码就停在这里了，很多人第一次跑的时候会以为板子死机了，其实是进入了待机状态。

第四段是唤醒后的处理。在Standby模式下，唤醒等同于复位，所以main函数重新从头执行。这时候你要做的是判断是不是RTC唤醒标志导致的复位，然后重新初始化系统和外设。在Stop模式下，唤醒则从进入低功耗的下一行开始执行，你需要在唤醒后重新配置系统时钟（前面提过的MSI问题）。

3.3 例程能跑只是开始，改造成自己的逻辑才是目的

官方例程跑通之后，我建议你做两个改造练习。

第一个改造是“RTC唤醒 + 串口打印”：唤醒后通过LPUART打印一条消息再重新入睡。这个练习让你掌握唤醒后怎么快速初始化外设，以及怎么避免重复打印的问题。

第二个改造是“用RTC闹钟而不是唤醒定时器来唤醒”。唤醒定时器的精度和可配置范围有限，RTC闹钟在需要指定具体时刻唤醒的场景下更好用。这个改造会让你理解RTC闹钟的中断配置和标志清除逻辑——很多人卡在这里，因为忘了清除闹钟标志，导致中断一进来就又触发一次。

4. 实测三道坎：电流读数、时钟恢复与调试器断连

4.1 为什么你的万用表永远测不出0.3uA

这是我最常被问到的问题之一。很多人把板子进入Standby模式之后，用普通万用表的电流档去量整板电流，发现读数在几十微安到几百微安之间乱跳，跟数据手册上标的0.3uA差了两个数量级。

问题出在测量工具和测量方法上。第一，万用表的电流档在有自动量程切换时会引入额外的阻抗，量程越小越明显，这个内阻压降足以影响MCU的电源电压，导致进入低功耗模式失败。第二，你的开发板上本来就有ST-Link、LED指示灯、LDO稳压器等额外器件，这些器件的静态功耗本身就有几十到几百微安。

我实测过NUCLEO开发板，单是板载ST-Link部分就有至少1mA左右的电流。所以测低功耗电流的正确姿势是：把板子上所有跳线、LED、调试器相关的部分都断开，直接从MCU的VDD引脚供电测量。专业一点用直流电源分析仪或源表，条件有限的话，用万用表的电压档量一个已知阻值精密电阻上的压降，也能得到相对可靠的数据。

4.2 唤醒之后一切“看起来正常”，但串口波特率错了

这是Stop模式特有的坑，而且特别隐蔽。现象是这样的：唤醒后程序继续运行，逻辑完全没问题，但对外通信就是乱码，重发几次偶尔好一下，然后又乱了。

原因就是我前面反复强调的：从Stop模式唤醒后，系统时钟被重置为MSI的默认频率，而你在初始化里配置的PLL可能已经停了。如果代码里某个外设用了PLL输出的时钟，唤醒后没重新配置PLL，这个外设的实际工作频率和之前不一样了，表现就是波特率不对、定时器时间不准。

解决方法是写一个专门的SystemClock_Config函数，在唤醒后显式调用一次。这里注意不要给每个外设都重新初始化一遍，很多外设的寄存器在Stop模式下是会保持的，重新初始化反而可能把配置弄乱。只恢复时钟，然后让依赖时钟的外设重新同步。

4.3 程序跑着跑着，调试器突然连不上了

用调试器在线调试的时候，只要程序一进入Stop或Standby模式，调试器就会断连，这是正常的，不是代码写错了。因为在这些低功耗模式下，内核时钟已经停了，调试接口也跟着失去响应。

第一次遇到这个情况的人往往很慌，以为是芯片锁死了。解决办法有两个思路：一是采用串口打印的方式来调试低功耗逻辑，把关键信息通过LPUART发出来，这样即使调试器断连也能掌握程序运行状态；二是在调试代码里留一个“调试模式开关”，进入低功耗之前延时几秒钟或判断一个引脚电平，给调试器一个重新连接的窗口。

我自己的习惯是：在开发阶段先屏蔽掉真正的低功耗指令，用普通延时代替，把业务逻辑调通之后，再打开低功耗模式实测功耗。这样能把问题拆开，不会一会儿遇到断连、一会儿遇到时钟错乱，根本分不清问题出在哪。

5. 把例程送进产品前，还要补哪些课

5.1 板级漏电才是低功耗的真正敌人

MCU跑进Standby模式只是第一步。你辛辛苦苦把MCU的电流压到0.5uA，结果整板功耗还是几十微安，这时候问题基本不在芯片上，而在板级设计上。

我帮朋友排查过一个很典型的例子：一个电池供电的温度记录仪，待机电流量出来有8uA，比芯片手册标称值高了近二十倍。排查过程很痛苦，逐个断开外围器件、逐个初始化引脚测量，最后发现罪魁祸首是一颗I2C传感器的SDA引脚——代码里没把它配置成上拉输入，传感器也不在供电状态，这个引脚浮空导致整个I2C总线在漏电。

类似的问题还有：GPIO直接连到LED和限流电阻，低功耗模式下LED负极端没有拉高到VDD，形成微弱漏电路径；电源LDO的静态功耗没考虑，选了一颗静态电流几十微安的LDO；板上的分压电阻网络用来检测电池电压，但没加MOS管开关，电阻一直在耗电。

所以低功耗项目的原则是：不用的引脚全部配置成模拟输入，不用的外设全部关时钟，不用的电路全部断电。这个原则在例程里看不到，但恰恰是产品落地的关键。

5.2 从RTC唤醒例程延伸到产品级的演进路线

跑通RTC唤醒例程之后，产品级的软件框架基本就有了雏形。我提供一个我自己项目里常用的演进路线：

第一步，在RTC唤醒的基础上，加入传感器采集逻辑。唤醒后给传感器供电、等稳定、采样、存数据、断电、重新休眠。这一阶段重点关注传感器上电到数据稳定需要多长时间，这直接影响单次唤醒功耗占空比。

第二步，加入低功耗串口（LPUART）或LPTIM作为辅助唤醒源。比如在某个模式下，LPTIM可以实现更灵活的低功耗定时，不用一直跑RTC；或者通过LPUART的引脚唤醒功能，让外部主机可以随时唤醒设备。

第三步，把数据存储部分优化成批量写入。如果是外接Flash，尽量缓存多帧数据后一次写入，减少写入期间的功耗时间，而不是每采一次就写一次。

我自己的实测经验是，用这个路线做出来的传感器节点，使用CR2032纽扣电池，每10分钟采集一次温湿度并写入Flash，电池能撑一年以上。数据手册上的低功耗电流只是起点，系统级的低功耗优化才决定产品的最终续航。

另外分享一个调试小技巧：低功耗项目的电流测量，一定要养成“记录绝对数值”的习惯。你在不同环节量的电流，比如LSE使能前、使能后、RTC配置后、进入Stop前、进入Stop后，每一步的电流值都记录下来。这个数据表就是你判断哪一步引入额外功耗的直接证据。不要觉得麻烦，很多低功耗问题就是在这一步步的数值对比中定位出来的。

本文还有配套的精品资源，点击获取