2. 开发环境搭建与工程模板：STM32CubeMX配置、Keil/IAR工程建立、HAL库与LL库选择策略、基础时钟与GPIO配置
做低功耗嵌入式开发，环境搭建是第一道坎。很多人觉得装个IDE、点几下鼠标就完事了，结果后面调试时各种莫名其妙的问题——时钟不准、外设不工作、功耗下不去。说白了，这一步没走稳，后面全是坑。
我个人习惯，拿到一个新项目，先花半天时间把工程模板搭扎实。模板就像房子的地基，地基歪了，后面装修得再好也白搭。这一章，我就带你一步步把STM32L4的开发环境搭起来，顺便聊聊我这些年踩过的坑。
2.1 STM32CubeMX配置：从芯片选型到引脚分配
STM32CubeMX是ST官方出的图形化配置工具。它的好处是，你不用对着数据手册一行行翻寄存器，直接在界面上勾勾选选，就能生成初始化代码。对于L4这种外设复杂的芯片，这工具能省下大量时间。
第一步：新建项目，选芯片
打开CubeMX，点击"New Project"。在"Part Number"搜索框里输入你用的具体型号，比如我常用的STM32L431RCT6。双击选中，项目就建好了。
第二步：配置引脚功能
在"Pinout & Configuration"视图里，你可以看到芯片的引脚图。点击任意引脚，就能选择它的功能。比如我要用USART1，就在PA9和PA10上分别选"USART1_TX"和"USART1_RX"。
这里有个容易忽略的点：引脚冲突。L4的很多引脚是复用的，你选了USART1，可能就把某个定时器的PWM输出给占了。CubeMX会在右下角的"Pin Conflicts"窗口里提示你。我刚开始用的时候，经常忽略这个提示，结果板子焊好了才发现引脚打架，只能飞线解决。
第三步：配置外设参数
在左侧的"Categories"列表里，展开你要用的外设。比如配置USART1，点击"USART1"，然后在右侧的"Parameter Settings"里设置波特率、数据位、停止位等。对于L4的低功耗应用，我一般会把波特率设在9600或115200，再高的话，在低功耗模式下容易丢数据。
2.2 Keil/IAR工程建立：从CubeMX到IDE的完整流程
CubeMX配置好之后，下一步就是生成工程代码。我个人偏爱Keil，但IAR也有它的优势。下面我分别说说。
Keil MDK工程生成
- 在CubeMX里，点击"Project Manager"标签。
- "Project Name"填你的项目名，"Project Location"选一个路径（注意：路径不要有中文！）。
- "Toolchain / IDE"选"MDK-ARM V5"。
- 点击右上角的"GENERATE CODE"，CubeMX就会生成一个.uvprojx文件。
- 用Keil打开这个文件，就能看到完整的工程结构了。
IAR EWARM工程生成
步骤和Keil类似，只是在"Toolchain / IDE"里选"IAR Embedded Workbench"。IAR生成的工程文件是.eww和.ewp。我个人觉得IAR的编译优化做得更好，代码密度比Keil高一些，对于Flash紧张的L4项目，IAR是更好的选择。
| 对比项 | Keil MDK | IAR EWARM |
|---|---|---|
| 上手难度 | 低，界面友好 | 中等，快捷键多 |
| 编译优化 | 良好 | 优秀，代码密度高 |
| 调试体验 | 好，支持J-Link/ST-Link | 好，但需要配置 |
| License费用 | 较高 | 更高 |
| 社区资源 | 丰富 | 较少 |
2.3 HAL库与LL库选择策略：什么时候用哪个？
STM32L4支持两套库：HAL库（硬件抽象层）和LL库（底层库）。很多新手会纠结选哪个。我的建议是：别纠结，两个都用。
HAL库的特点
- 封装层次高，API函数名长但语义清晰，比如
HAL_UART_Transmit()。 - 支持超时机制和中断回调，适合快速开发。
- 代码量大，执行效率相对低一些。
LL库的特点
- 直接操作寄存器，API函数名短，比如
LL_USART_TransmitData8()。 - 代码量小，执行效率高，适合对功耗和实时性要求高的场景。
- 没有超时机制，需要自己处理状态机。
我的选择策略
在低功耗项目中，我一般这样用：
- 初始化部分用HAL：比如时钟配置、GPIO初始化、外设参数设置。这些代码只执行一次，用HAL省事。
- 运行时部分用LL：比如在低功耗循环里，需要频繁读写寄存器的地方，用LL库直接操作，减少CPU开销。
HAL_UART_Init()来初始化。但在发送数据时，我用LL库的LL_USART_TransmitData8()，配合LL_USART_IsActiveFlag_TXE()轮询发送完成。这样既保证了初始化简单，又保证了发送效率。
2.4 基础时钟与GPIO配置：让芯片先跑起来
时钟是芯片的心脏。L4的时钟树比较复杂，有多个时钟源：HSI（内部高速）、MSI（多速内部）、HSE（外部高速）、LSE（外部低速）等。对于低功耗应用，时钟配置直接影响功耗。
时钟配置要点
- 系统时钟源选择：默认是MSI，频率可调（100kHz到48MHz）。我一般用HSE（外部晶振）作为主时钟源，精度高，适合需要稳定通信的场景。
- AHB/APB分频：外设总线频率不要超过数据手册上限。L4的APB1最高50MHz，APB2最高80MHz。
- 低功耗模式下的时钟：进入Stop模式时，系统时钟会关闭，但RTC和LPTIM可以用LSE（32.768kHz）继续运行。
GPIO配置要点
GPIO看似简单，但配置不对，功耗会高得离谱。我见过一个项目，GPIO没配置成模拟模式，结果漏电流导致整机功耗多了200μA。
- 未使用的引脚：必须配置为模拟模式（GPIO_MODE_ANALOG）。这是L4低功耗的黄金法则。
- 输出引脚：设置合适的驱动能力（Low/Medium/High）。对于LED这种低速信号，用Low就够了，别用High。
- 输入引脚：如果外部没有强上拉/下拉，内部要启用上拉或下拉，防止引脚浮空。
HAL_GPIO_TogglePin()，用示波器看波形。如果波形不对，说明时钟或GPIO配置有问题。这比看代码找bug快多了。
2.5 本章知识体系：一张图看懂开发环境搭建
下面这张图，我把本章的核心逻辑画出来了。从CubeMX配置开始，到IDE工程建立，再到库选择和时钟GPIO配置，每一步都环环相扣。
2.6 避坑指南：我这些年踩过的雷
最后，分享几个我实际项目中遇到的坑，希望能帮你少走弯路。
- CubeMX生成的代码不要手动改：如果你在CubeMX里重新生成代码，手动修改的部分会被覆盖。我的做法是，把用户代码写在CubeMX预留的
/* USER CODE BEGIN */和/* USER CODE END */之间，这样重新生成时不会被覆盖。 - 时钟配置后一定要验证：用
HAL_RCC_GetSysClockFreq()读一下实际频率，和预期对比。我曾经因为外部晶振没起振，系统自动切回了HSI，结果串口波特率全乱了。 - GPIO初始化顺序：先配置时钟，再配置GPIO。如果顺序反了，GPIO配置可能会失败，而且没有任何报错。
- 调试器选择：L4支持SWD和JTAG。我建议用SWD，只占用PA13和PA14两个引脚，省下的引脚可以用于其他功能。