3. 软件环境搭建：STM32CubeIDE安装、STM32CubeMX配置、LL库与HAL库选择、工程模板建立
做嵌入式开发，工具链就是你的武器。武器不称手，后面调试功耗的时候会非常痛苦。这一章我们就把环境彻底搭好，顺便聊聊库的选择——这步走对了，后面能省一半的力气。
3.1 STM32CubeIDE 安装：别小看这一步
STM32CubeIDE 是 ST 官方基于 Eclipse 打造的免费 IDE。它集成了编译器、调试器，还绑定了 CubeMX 的图形化配置功能。说白了，一个软件搞定所有事。
安装过程其实没什么难度，但有三个坑我得提醒你：
- 路径不要有中文。我见过有人把工程放在“桌面/项目/低功耗”这种路径下，编译报错找半天，最后发现是中文空格惹的祸。
- 安装时勾选所有系列支持。默认只装几个主流系列，记得把 STM32L4 勾上。不然新建工程时找不到芯片，还得回头补装。
- JRE 环境。新版安装包自带 JRE，但如果你电脑上之前装过其他版本的 Java，可能会冲突。我建议安装前先把旧版 Java 卸干净。
3.2 STM32CubeMX 配置：图形化到底香不香？
CubeMX 的作用是帮你生成初始化代码。你点点鼠标，它就把 GPIO、时钟、外设的配置代码写好了。对于低功耗开发来说，它的价值在于——能让你一眼看到所有外设的功耗状态。
打开 CubeMX，新建工程，选芯片型号。以 STM32L431 为例，操作流程如下：
- 选芯片：在 Part Number 里输入 STM32L431RCT6，双击选中。
- 配置时钟：进入 Clock Configuration 页面，把 HSI 设为 16MHz，关闭 PLL。低功耗场景下，PLL 是耗电大户，能不用就不用。
- 配置 GPIO：把不用的引脚全部设为 Analog模式。为什么？因为 Analog 模式下引脚输入输出缓冲器都关闭了，漏电最小。
- 配置调试接口：SWD 保留，JTAG 关掉。JTAG 占用 5 个引脚，每个引脚在低功耗模式下都会产生额外漏电流。
- 生成代码：Project → Generate Code，选好路径，搞定。
3.3 HAL 库 vs LL 库：到底选哪个？
这是新手最容易纠结的问题。我直接给你结论：
| 对比项 | HAL 库 | LL 库 |
|---|---|---|
| 代码量 | 大，封装层次多 | 小，接近寄存器操作 |
| 执行效率 | 中等，有额外函数调用开销 | 高，几乎没有冗余 |
| 易用性 | 高，回调机制完善 | 低，需要自己管理状态 |
| 低功耗场景 | 一般，进入/退出低功耗模式时延迟较大 | 优秀，可以精确控制每个寄存器的状态 |
| 调试难度 | 低，出错容易定位 | 高，需要熟悉寄存器手册 |
我的建议很明确：做低功耗开发，优先选 LL 库。
为什么？我给你讲个真实案例。之前我做一款智能门锁，用 HAL 库的 HAL_PWR_EnterSTOPMode() 进入 STOP 模式，结果发现唤醒后 GPIO 状态恢复异常。查了两天，最后发现是 HAL 库在进入低功耗前自动保存了一堆寄存器，但恢复时顺序不对。换成 LL 库后，我自己控制寄存器保存和恢复的顺序，问题立刻解决。
说白了，低功耗开发就是跟每一个微安（μA）较劲。HAL 库帮你做了很多事，但也隐藏了很多细节。LL 库让你直接面对寄存器，虽然累一点，但心里踏实。
3.4 工程模板建立：一次搭建，重复使用
每次新建工程都从头配置一遍，太浪费时间了。我习惯做一个低功耗工程模板，以后所有低功耗项目都基于这个模板修改。
模板的核心结构如下：
Project_Template/
├── Core/
│ ├── Inc/
│ │ ├── main.h
│ │ ├── lowpower.h // 低功耗模式管理
│ │ ├── gpio_config.h // GPIO 低功耗配置
│ │ └── clock_config.h // 时钟切换
│ └── Src/
│ ├── main.c
│ ├── lowpower.c
│ ├── gpio_config.c
│ └── clock_config.c
├── Drivers/
│ ├── STM32L4xx_HAL_Driver/
│ └── STM32L4xx_LL_Driver/
├── Middlewares/ // 可选，RTOS 或协议栈
└── .cproject
模板里我固定做三件事：
- 时钟初始化：默认使用 MSI 振荡器，频率 2.097 MHz。这个频率下功耗最低，且能满足大部分低功耗场景的运算需求。
- GPIO 初始化：所有未使用的引脚配置为 Analog 模式，输出引脚初始化为低电平，输入引脚使能内部上拉（防止浮空导致额外漏电）。
- 低功耗模式封装：写一个
EnterStopMode()函数，里面调用 LL 库的LL_PWR_EnterSTOPMode()，并处理好唤醒后的时钟恢复。
3.5 知识结构总览
下面这张图把本章的核心逻辑串起来了。你可以把它当作搭建环境的检查清单：
3.6 关于库选择的最后一点建议
我知道有些工程师喜欢混用 HAL 和 LL。比如用 HAL 初始化外设，用 LL 控制低功耗模式。这种做法理论上可行，但我不推荐。
原因很简单：HAL 库内部有自己的状态机。你用 LL 库直接操作寄存器后，HAL 的状态机就不知道外设当前处于什么状态了。下次调用 HAL 函数时，可能会产生意想不到的行为。
我自己的做法是：全盘 LL。虽然写代码时累一点，但每个寄存器的值我都心里有数。调试低功耗问题时，能直接看寄存器值判断状态，不用去猜 HAL 内部做了什么。