第三章 开发环境搭建：Keil/IAR环境配置、STM32CubeMX初始化、交叉编译工具链安装、调试器连接
好，咱们直接进入正题。开发环境搭建这事儿，说难不难，说简单吧，我第一次带新人时，光装个Keil就折腾了一下午。你想想看，工具链没配好，后面写再多代码也跑不起来。所以这一章，我带你一步步把环境整利索。
3.1 选择你的IDE：Keil还是IAR？
我个人习惯用Keil MDK，主要是因为它对STM32的支持最成熟，社区资源也多。但IAR的编译优化确实更狠，代码密度能小15%左右。怎么选？
- Keil MDK：上手快，调试方便，适合中小型项目。我做过一个楼宇能耗采集节点，用Keil开发，从建工程到跑通只花了半天。
- IAR EWARM：编译优化强，适合对代码尺寸有严格要求的场景。比如电池供电的传感器，Flash就64KB，IAR能帮你多挤出点空间放算法。
嗯，这里要注意：不管你选哪个，后面讲的STM32CubeMX生成的代码，两个IDE都能直接导入。所以不用太纠结。
3.2 Keil MDK环境配置
先讲Keil。安装包去官网下，版本建议5.38或更新。装完后第一件事——装器件包。没有器件包，你连STM32L0系列都找不到。
关键步骤：
- 打开Keil，点击
Pack Installer图标 - 搜索你的芯片型号，比如
STM32L071 - 点击
Install，等进度条跑完
我在项目中遇到过一个问题：装完Keil后死活找不到STM32L0系列。后来发现是Pack Installer没联网。你如果也遇到，手动去Keil官网下载对应的 .pack 文件，双击安装就行。
接下来配置编译工具链。Keil自带ARMCC编译器，一般不用额外装。但如果你要用GCC，那就得单独装交叉编译工具链了，这个后面讲。
3.3 IAR EWARM环境配置
IAR的安装相对简单。下载安装包，一路Next。装完后打开，它会自动检测你电脑上的调试器驱动。
有一点要注意：IAR的License管理比较严格。我建议你用浮动License，这样换电脑也能用。别问我怎么知道的——我曾经因为License过期，在客户现场干瞪眼了一下午。
小技巧：IAR的工程文件后缀是 .ewp，而Keil是 .uvprojx。如果你团队里有人用Keil有人用IAR，可以用STM32CubeMX生成两种格式的工程，省得来回转换。
3.4 STM32CubeMX初始化——这才是核心
说实话，现在谁还手写寄存器啊？STM32CubeMX就是我们的救星。它能帮你生成初始化代码，包括时钟树、GPIO、外设配置等等。
咱们能耗监测传感器用到的外设不多，但有几个关键点：
- ADC：采集电流/电压信号，需要配置采样时间和分辨率
- I2C：连接温湿度传感器，比如SHT30
- UART：与上位机通信，打印调试信息
- SPI：如果用了外部Flash存储数据
打开CubeMX，新建工程，选好芯片型号。然后按下面的步骤来：
- 配置时钟树：我一般用内部HSI，省一个外部晶振。功耗也低。把HCLK设到16MHz就够用了。
- 配置GPIO：把用到的引脚设好。比如ADC输入引脚、I2C的SCL/SDA、UART的TX/RX。
- 配置ADC：连续转换模式，12位分辨率，采样周期设长一点，信号更稳。
- 配置I2C：标准模式100kHz，别用快速模式，省得信号干扰。
- 生成代码：选好IDE类型（MDK或IAR），点
GENERATE CODE。
注意：生成代码后，不要手动修改CubeMX生成的 main.c 中的初始化部分。否则下次重新生成时，你的修改会被覆盖。我习惯把用户代码写在 /* USER CODE BEGIN */ 和 /* USER CODE END */ 之间，这样CubeMX会保留。
3.5 交叉编译工具链安装
如果你用Keil或IAR自带的编译器，这步可以跳过。但如果你像我一样，偶尔想用GCC试试，那就得装交叉编译工具链。
ARM官方的GCC工具链叫 gcc-arm-none-eabi。下载地址在ARM官网，选最新稳定版就行。
安装步骤：
- Windows：下载
.exe安装包，一路Next。装完后把bin目录加到系统PATH里。 - Linux：用包管理器装，比如
sudo apt install gcc-arm-none-eabi - macOS：用Homebrew，
brew install arm-none-eabi-gcc
装完后打开终端，输入 arm-none-eabi-gcc --version，能看到版本号就说明装好了。
我曾经在Linux下装完GCC后，编译一直报错，说找不到头文件。后来发现是没装 libnewlib-arm-none-eabi 这个库。你如果也遇到，记得装上。
3.6 调试器连接：J-Link vs ST-Link
调试器就是你的眼睛。没有它，代码跑没跑对全靠猜。
| 调试器 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| ST-Link | 便宜，STM32开发板自带 | 速度慢，功能少 | 原型验证、学习 |
| J-Link | 速度快，支持断点多，稳定 | 贵，正版要上千 | 产品开发、量产调试 |
我个人建议：如果只是做课程实验，用ST-Link就够了。但如果是做产品，尤其是要调试低功耗模式，J-Link的RTT功能能帮你省不少事。
连接方式很简单：
- SWD接口：只用4根线——VCC、GND、SWDIO、SWCLK。我一般还会接上SWO，用来输出调试信息。
- 接线顺序：先接地线，再接电源，最后接信号线。别问我为什么——我曾经因为先接信号线，把调试器烧了。
避坑指南：如果你用ST-Link调试低功耗模式，记得把ST-Link的 NRST 引脚也连上。否则芯片进入Stop模式后，调试器可能连不上。我曾经因为这个排查了整整两天。
3.7 验证环境是否搭好
环境搭完，总得跑个程序验证一下吧？我习惯写一个最简单的LED闪烁程序：
// main.c
#include "main.h"
int main(void)
{
HAL_Init();
SystemClock_Config();
MX_GPIO_Init();
while (1)
{
HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
HAL_Delay(500);
}
}编译下载，如果LED以0.5秒间隔闪烁，说明你的开发环境、工具链、调试器全部正常工作。
嗯，到这里，环境搭建就告一段落了。下一章咱们开始写真正的驱动代码——让传感器把数据吐出来。