1. STM32开发环境搭建：Keil MDK安装、STM32CubeMX配置、ST-Link驱动与调试
做嵌入式开发这么多年，我见过太多新手卡在环境搭建这一步。说实话，工具链没配好，后面再牛的代码也跑不起来。这一章咱们就把STM32开发环境从头捋一遍，把坑都填平。
1.1 开发工具链全景
先看一张整体架构图，搞清楚这些工具之间的关系：
说白了，CubeMX帮你生成初始化代码，Keil负责写逻辑和编译，ST-Link把固件烧进去。这三件套缺一不可。
1.2 Keil MDK 安装与破解
Keil MDK 是ARM内核MCU最主流的IDE。我建议直接装最新版，但要注意版本兼容性。
安装步骤
- 下载安装包：去Keil官网下载MDK-ARM最新版（目前是5.38）。
- 运行安装：一路Next，路径不要有中文。
- 安装器件包：安装完成后打开Pack Installer，找到STM32F1/F4系列并安装。
- 注册：用管理员身份运行Keil，File → License Management，输入CID，用注册机生成激活码。
⚠️ 注意： 我曾经遇到过Keil 5.36以下版本对Win11兼容性不好，编译时莫名崩溃。建议用5.38及以上版本。
常见问题
| 问题 | 原因 | 解决 |
|---|---|---|
| 编译报错 "Target not created" | 器件包未安装 | Pack Installer 中安装对应系列 |
| 注册失败 | 未以管理员运行 | 右键 → 以管理员身份运行 |
| 中文注释乱码 | 编码设置不对 | Edit → Configuration → Encoding 选 GB2312 |
1.3 STM32CubeMX 配置
CubeMX是ST官方的图形化配置工具。说实话，它最大的价值就是帮你省掉写初始化代码的时间。我刚开始用的时候还觉得它多余，后来项目多了才发现——真香。
核心配置流程
- 新建工程：选择MCU型号（比如STM32F103C8T6）。
- 引脚配置：在Pinout视图中分配GPIO、USART、SPI等。
- 时钟树配置：HSE/LSE、PLL倍频，确保主频达标。
- 外设参数：设置波特率、中断优先级、DMA通道等。
- 生成代码：选择IDE为MDK-ARM，生成初始化工程。
💡 个人习惯： 我每次生成代码前都会检查一下时钟树。很多新手直接默认配置，结果HSE没使能，系统跑在HSI上，精度差一大截。
时钟树配置要点
| 时钟源 | 频率 | 用途 | 注意 |
|---|---|---|---|
| HSI | 8 MHz | 内部高速振荡器 | 精度±1%，温度影响大 |
| HSE | 4-16 MHz | 外部晶振 | 精度高，建议优先使用 |
| PLL | 最高72 MHz (F1) | 倍频输出 | 不要超频，会不稳定 |
| LSI | 40 kHz | 独立看门狗 | 精度差，只用于低功耗 |
1.4 ST-Link 驱动与调试
ST-Link是ST官方的调试器，集成在Nucleo和Discovery板上。独立版也不贵，几十块钱。我记得第一次用ST-Link调试时，驱动装了半天没反应，后来发现是USB线的问题——线太长了信号衰减。
驱动安装
- Win10/Win11：插上自动识别，系统自带驱动。
- Win7：需要手动安装ST-Link驱动包（去ST官网下载）。
- 确认方法：设备管理器里看到 "STMicroelectronics STLink dongle" 即成功。
Keil 调试配置
- 点击魔法棒图标 → Debug 选项卡。
- 选择 "ST-Link Debugger" → Settings。
- 确认SWD模式，速度选4 MHz（别选太高，容易掉线）。
- Flash Download 选项卡：勾选 "Reset and Run"。
🔑 关键点： "Reset and Run" 一定要勾上。不然每次烧完程序还得手动按复位键，调试效率低一半。
调试技巧
- 断点调试：双击行号设置断点，最多设6个（硬件限制）。
- 变量观察：Watch窗口添加变量，实时查看值变化。
- 寄存器查看：Peripherals菜单查看外设寄存器状态。
- 串口打印：用ITM/SWO输出调试信息，不占用额外引脚。
⚠️ 避坑指南： 我曾经在调试时发现程序跑飞，怎么都找不到原因。后来发现是ST-Link的SWD线太长（超过20cm），信号干扰导致调试器频繁断开。换成10cm以内的杜邦线就稳定了。
1.5 第一个工程：点亮LED
环境搭好了，咱们跑个经典的点灯程序验证一下。这是嵌入式界的"Hello World"。
CubeMX 配置
- 选择芯片：STM32F103C8T6
- 引脚：PB0 设为 GPIO_Output
- 时钟：HSE 8MHz → PLL → 72MHz
- 生成代码：MDK-ARM V5
Keil 代码
/* main.c - 主循环 */
int main(void)
{
HAL_Init();
SystemClock_Config();
MX_GPIO_Init();
while (1)
{
HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_0);
HAL_Delay(500); // 500ms 闪烁
}
}编译下载
- 按 F7 编译，0 Error 0 Warning。
- 按 F8 下载，观察下载进度条。
- 下载完成后，LED 应该以 1Hz 频率闪烁。
💡 如果灯不亮： 先检查硬件连接——LED正极接PB0，负极串220Ω电阻到GND。软件方面，确认CubeMX生成的GPIO初始化代码里引脚号对不对。
1.6 本章小结
环境搭建这件事，说白了就是一次性的体力活。但做对了，后面几十章的实战就能顺畅推进。我建议你把Keil、CubeMX、ST-Link驱动都装好，跑通点灯程序再往下走。别急着跳章节——工具链不稳，后面调FreeRTOS时你会哭的。