第一章：STM32开发环境搭建
各位同学好，我是你们的嵌入式讲师。今天咱们来聊聊STM32开发的第一步——搭环境。
说实话，我见过太多初学者卡在这一步。工具装不上、驱动不识别、代码下载失败……这些问题我当年都踩过坑。所以这一章，我会把每个细节都讲透。
1.1 开发工具概览
做STM32开发，你需要三样东西：
- Keil MDK：写代码、编译、调试的IDE
- STM32CubeMX：图形化配置外设，自动生成初始化代码
- ST-Link驱动：让电脑识别你的调试器
这三者缺一不可。我个人习惯先把Keil装好，再装CubeMX，最后装驱动。顺序其实无所谓，但别跳步骤。
核心思路：先有工具，再写代码，最后下载验证。每一步都跑通了，再往下走。
1.2 Keil MDK安装与破解
Keil MDK是ARM公司出的IDE，专门用来开发ARM内核的芯片。STM32全系列都支持。
安装步骤
- 去Keil官网下载MDK-ARM安装包（建议用5.38或更新版本）
- 双击安装，一路Next。注意安装路径不要有中文
- 安装完成后，桌面会出现Keil uVision5图标
注意：安装路径不要有空格和中文。我曾经见过有人装在“C:\Program Files (x86)\Keil_v5”下，结果编译时路径解析出错。建议直接装在“C:\Keil_v5”。
破解流程
Keil MDK是收费软件，但官方提供了评估版。评估版有代码大小限制（32KB），对于学习来说够用。但如果你想做项目，还是得破解。
破解步骤其实很简单：
- 以管理员身份运行Keil uVision5
- 点击 File → License Management
- 复制CID码
- 运行注册机（Keygen.exe），粘贴CID，生成激活码
- 把激活码粘贴回License Management窗口，点击Add License
小技巧：注册机可能会被杀毒软件误报。我建议先关掉实时防护，破解完再打开。另外，注册机要右键“以管理员身份运行”，否则可能生成失败。
1.3 STM32CubeMX安装
STM32CubeMX是ST官方出的图形化配置工具。你想想看，以前配置时钟树、GPIO、定时器，都得翻手册查寄存器。现在用CubeMX，点几下鼠标就搞定了。
安装要点
- 需要Java运行环境（JRE），CubeMX是基于Java的
- 安装时选择“Install for all users”
- 安装完成后，会自动下载芯片支持包（F1、F4、H7等系列）
我第一次用CubeMX时，觉得这东西就是个“代码生成器”。后来做项目才发现，它最大的价值是帮你理清外设之间的依赖关系。比如你要用USART，它会自动帮你配好时钟、GPIO复用、中断优先级。嗯，省了不少事。
1.4 ST-Link驱动安装
ST-Link是ST官方的调试器。买开发板时通常会送一个。驱动装不上，电脑就识别不了调试器。
驱动安装分两步：
- 插上ST-Link，看设备管理器里有没有“STMicroelectronics STLink dongle”
- 如果没有，去ST官网下载“ST-Link USB driver”手动安装
避坑指南：我曾经遇到过Win10系统下，ST-Link驱动死活装不上。后来发现是系统自动更新把驱动给覆盖了。解决办法是：在设备管理器里右键ST-Link设备，选择“更新驱动程序”→“浏览我的电脑以查找驱动程序”→“让我从计算机上的可用驱动程序列表中选取”，然后手动选择ST-Link驱动。
1.5 第一个LED工程创建与下载验证
好了，工具都装好了。咱们来写第一个程序——点亮LED。
用CubeMX生成工程
- 打开CubeMX，点击“New Project”
- 选择芯片型号（比如STM32F103C8T6）
- 在Pinout视图中，找到PC13引脚，设置为GPIO_Output
- 配置时钟：HSE选择Crystal/Ceramic Resonator，时钟树里把HCLK设为72MHz
- 点击Project → Generate Code，选择MDK-ARM V5，生成工程
编写代码
生成后的工程里，main.c中已经包含了初始化代码。我们只需要在while(1)循环里加上LED闪烁逻辑：
int main(void)
{
HAL_Init();
SystemClock_Config();
MX_GPIO_Init();
while (1)
{
HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
HAL_Delay(500); // 延时500ms
}
}这段代码很简单：每500ms翻转一次PC13的电平。LED就会一亮一灭。
下载验证
- 用USB线连接开发板和电脑
- 在Keil里点击“Options for Target”，选择Debug选项卡，调试器选“ST-Link Debugger”
- 点击Settings，确认SWD模式能识别到设备
- 点击Download按钮（或者按F8）
如果一切顺利，你会看到开发板上的LED开始闪烁。嗯，这就是你的第一个STM32程序。
个人经验：如果下载失败，先检查ST-Link的接线。SWD只需要四根线：SWDIO、SWCLK、GND、3.3V。我遇到过好几次，都是因为杜邦线接触不良导致下载失败。换个线就好了。
1.6 本章知识体系
下面这张图，帮你理清本章的核心逻辑：
这张图很直观：三个工具是串联关系。Keil负责写代码，CubeMX帮你配外设，ST-Link负责下载调试。任何一个环节出问题，LED都亮不起来。
1.7 本章小结
这一章我们做了四件事：
- 装了Keil MDK并破解
- 装了STM32CubeMX
- 装了ST-Link驱动
- 创建并下载了第一个LED工程
说实话，环境搭建是最枯燥的。但这一步走稳了，后面学外设驱动就会顺畅很多。我当年学STM32时，光装环境就折腾了两天。现在你跟着我的步骤走，半小时应该就能搞定。
如果遇到问题，别急。先检查驱动，再检查接线，最后看编译输出。90%的问题都能自己解决。