2. 开发环境搭建：工欲善其事，必先利其器

做低功耗开发，跟普通嵌入式开发最大的区别在哪？我个人觉得，是「看不见的东西太多了」。普通代码跑没跑对，看个GPIO电平翻转就行。但微安级的电流波动、纳秒级的唤醒延迟，你靠肉眼和万用表根本抓不住。所以这一章，咱们先把家伙事儿备齐。

我不会让你装一堆用不上的软件。咱们的目标很明确：能编译、能下载、能测电流、能看波形。四样齐了，后面30章的实战才有底气。

2.1 STM32CubeIDE 配置——别用老版本

我刚开始用CubeIDE时踩过一个坑：公司电脑装的是1.8.0，结果L4系列的功耗配置界面死活打不开。后来才发现，低功耗相关的图形化配置是从1.9.0才开始完善的。所以，请直接去ST官网下载最新版（写这章时是1.16.0）。

安装过程没什么好说的，一路Next。但有几个关键配置点，我建议你装完后立刻检查：

工程创建时，选好芯片型号（比如STM32L476RG），然后在Pinout & Configuration界面里，你会看到一个叫「Low Power」的选项卡。嗯，这里就是咱们的主战场。

2.2 低功耗调试工具——电流是核心指标

写低功耗代码，最怕什么？怕你以为睡了，其实没睡。我早期做的一个物联网项目，电池续航设计是两年，结果三个月就没电了。查到最后，是一个GPIO在休眠时没配置成模拟模式，漏了十几微安。

所以，工具必须到位。咱们主要用两样：

2.2.1 功耗分析仪

这东西说白了就是高精度电流表。普通万用表测静态电流还行，但测动态电流（比如从休眠到唤醒的瞬态）就抓瞎了。功耗分析仪能实时采样电流波形，精度到纳安级。

我个人推荐几款：

工具型号	量程	采样率	适用场景
Keysight N6781A	±8A / ±20mA	200 kSa/s	专业实验室，精度极高
Qoitech Otii Arc	0~5V / 0~5A	1 kSa/s	团队开发，性价比高
Joulescope	0~15V / 0~10A	2 kSa/s	个人开发者，开源软件
STM32 Power Shield	100 nA ~ 50 mA	10 kSa/s	ST官方，与CubeIDE集成

如果你刚开始做低功耗，我建议先搞个STM32 Power Shield。它直接插在Nucleo板上，CubeIDE里就能看到实时电流曲线，省去一堆接线麻烦。

2.2.2 J-Scope——看波形，不只看电流

J-Scope是SEGGER家的工具，配合J-Link使用。它能干什么？说白了，就是用SWD接口实时输出变量波形。你不需要串口，不需要额外引脚，直接在代码里标记一个变量，J-Scope就能画出它的变化曲线。

这对低功耗调试太有用了。比如你想看RTC唤醒后，系统从Stop模式恢复到正常运行花了多少时间——用J-Scope抓一个GPIO翻转的波形，一目了然。

2.3 工程模板建立——一次配置，重复使用

我不喜欢每次新建工程都从头配一遍时钟、GPIO、RTC。所以，我习惯做一个「低功耗基础模板」。后面每章的新实验，都从这个模板复制出来。

模板包含什么？

• 时钟树：MSI 2MHz作为系统时钟，LSE 32.768kHz给RTC。这样进Stop模式时，MSI可以快速关闭，唤醒后再快速启动。
• GPIO配置：所有未使用的引脚，统一设为模拟模式（ANALOG）。这是最省电的配置，没有之一。
• RTC配置：使能唤醒定时器，默认1秒中断一次。方便后续测试。
• 调试接口：SWD保留，但休眠前要确保SWD时钟不产生额外功耗。

代码结构上，我习惯这样组织：

Core/
├── Inc/
│   ├── main.h
│   ├── lowpower.h      // 低功耗相关函数声明
│   └── wakeup_sources.h // 唤醒源配置
├── Src/
│   ├── main.c
│   ├── lowpower.c      // 进入/退出休眠函数
│   └── wakeup_sources.c // 各唤醒源初始化与回调
└── Startup/
    └── startup_stm32l476xx.s

main.c里，我习惯只放一个超级循环：

int main(void)
{
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_RTC_Init();
    MX_LowPower_Init();

    while (1)
    {
        // 进入Stop模式，等待唤醒
        Enter_StopMode();
        // 唤醒后处理
        Process_Wakeup();
    }
}

你看，结构清晰，每个模块各司其职。后面加新的唤醒源，只需要在wakeup_sources.c里加一个初始化函数和回调函数就行。

2.4 本章知识体系

下面这张图，把咱们这章的核心脉络串起来了。你可以把它当成一张「工具地图」：

这张图你看懂了吗？从上到下，其实就是一条线：目标 → 工具 → 配置 → 验证。后面每一章，咱们都会在这个模板上做加法。所以，花点时间把模板搭扎实了，后面会省很多事。