2、开发环境搭建：Keil MDK安装与破解、STM32CubeMX安装、ST-Link驱动安装、第一个工程创建与下载验证

开发环境是嵌入式工程师的“第一把武器”。对于STM32零基础入门者而言，如果环境搭建环节出现版本不匹配、驱动冲突或下载器识别失败等问题，后续所有代码调试都将寸步难行。本章将围绕四个核心任务展开：Keil MDK（微控制器开发套件）的安装与授权、STM32CubeMX图形化配置工具的安装、ST-Link调试下载器的驱动安装，以及从零创建第一个工程并完成下载验证。通过本章学习，你将建立起一套完整的“编写—编译—下载—调试”闭环工具链，为后续所有实验打下坚实基础。

2.1 核心工具链认知：四件套缺一不可

在动手安装之前，必须先理解这套工具链中每个角色的职责。STM32开发不是单靠一个软件就能完成的，而是由“集成开发环境（IDE）+ 图形化配置工具 + 硬件调试器驱动 + 固件库支持包”协同工作。四者关系如下：

• Keil MDK（μVision5）：负责代码编辑、编译、链接、调试的IDE。它本身不包含STM32芯片支持，需要额外安装对应的Device Family Pack（如Keil.STM32F1xx_DFP）。
• STM32CubeMX：意法半导体官方图形化配置工具。通过图形界面完成引脚分配、时钟树设置、外设初始化代码生成，大幅减少手写底层配置的工作量。
• ST-Link驱动：ST-Link是ST官方调试下载器，通过SWD（串行线调试）接口连接目标板。驱动安装后，Keil才能识别到调试器并执行烧录与在线调试。
• 固件包（DFP/Pack）：在Keil中通过Pack Installer安装，包含芯片寄存器定义、启动文件、Flash算法等，是编译和下载的底层支撑。

2.2 Keil MDK安装与授权：从下载到破解的完整流程

Keil MDK的安装过程本身并不复杂，但授权（破解）环节是初学者最容易踩坑的地方。以下操作流程基于Windows 10/11 64位系统，以MDK 5.38a版本为例。

2.2.1 安装步骤

1. 获取安装包：从Keil官网（www.keil.com/download/product/）下载MDK-ARM安装包，或使用国内镜像。注意区分MDK-ARM（用于ARM芯片）与C51（用于8051），切勿装错。
2. 以管理员身份运行：右键安装包选择“以管理员身份运行”，否则后续驱动安装可能失败。
3. 安装路径：默认路径为C:\Keil_v5，建议保持默认。若修改路径，请确保路径中不包含中文或空格，否则部分插件会报错。
4. 安装Pack：安装完成后首次启动，会弹出Pack Installer。在“Packs”选项卡中展开STMicroelectronics，勾选STM32F1 Series Device Support（若使用F103）或对应系列，点击Install。若网络较慢，可手动下载离线Pack包。

2.2.2 授权（破解）操作

Keil MDK是商业软件，未授权时编译代码大小限制在32KB以内，且无法使用调试功能。学习阶段可使用注册机生成License，但请尊重知识产权，仅限个人学习。

操作步骤：
1. 以管理员身份运行Keil μVision5
2. 菜单栏 File → License Management
3. 复制CID码（如：ABCDE-FGHIJ-KLMNO）
4. 打开注册机（如keygen.exe），将CID粘贴到CID输入框
5. Target选择ARM，点击Generate生成License
6. 将生成的License复制回Keil的LIC文本框
7. 点击Add LIC，看到“Adding License ... OK”即成功
8. 确认License Management界面显示有效期至2032年

2.3 STM32CubeMX安装与工程生成

STM32CubeMX是图形化配置工具，它生成的初始化代码基于HAL库（硬件抽象层），代码结构清晰、易于移植。安装过程如下：

1. 安装Java环境：CubeMX 6.10+依赖Java 17。访问Oracle官网下载JDK 17并安装，配置JAVA_HOME环境变量。
2. 安装CubeMX：从ST官网下载安装包，双击运行，选择安装路径（建议默认C:\ST\STM32CubeMX）。
3. 首次启动配置：启动后需同意许可协议，并设置固件包下载路径（建议C:\STM32Cube\Repository）。
4. 下载固件包：在Help → Manage Embedded Software Packages中，选择STM32F1系列，下载最新版本（如1.8.5）。若下载缓慢，可手动从ST官网下载zip包后导入。

2.3.1 使用CubeMX生成MDK工程

以最常见的STM32F103C8T6最小系统板为例，生成一个点亮板载LED（PA5）的工程：

操作流程：
1. 打开CubeMX → New Project → 搜索“STM32F103C8” → 选中芯片 → Start Project
2. 在Pinout & Configuration视图：
   - 左侧Categories → SYS → Debug 选择 Serial Wire（启用SWD调试）
   - RCC → HSE 选择 Crystal/Ceramic Resonator（外部晶振）
   - 在芯片图上点击PA5引脚，选择GPIO_Output（LED控制）
3. Clock Configuration视图：HCLK输入72，回车自动分配时钟树
4. Project Manager视图：
   - Project Name: LED_Test
   - Project Location: D:\STM32_Projects
   - Toolchain/IDE: MDK-ARM V5
   - Minimum Heap/Stack: 0x200
5. 点击右上角GENERATE CODE，生成工程
6. 点击Open Project，自动打开Keil MDK

2.4 ST-Link驱动安装与验证

ST-Link V2是性价比极高的调试下载器，支持SWD和JTAG接口。驱动安装看似简单，但“设备管理器中出现感叹号”是高频问题。

2.4.1 驱动安装步骤

1. 安装Keil后自动安装：Keil MDK安装包内已包含ST-Link驱动，通常在安装过程中自动完成。若未成功，可手动安装。
2. 手动安装驱动：将ST-Link插入USB口，打开设备管理器，若看到“ST-Link”带黄色感叹号，右键选择“更新驱动程序” → “浏览我的电脑” → 路径指向C:\Keil_v5\ARM\STLink\USBDriver，点击安装。
3. 验证驱动：安装成功后，设备管理器中应显示“STMicroelectronics STLink dongle”且无感叹号。在Keil中点击魔术棒 → Debug → 右侧下拉框选择“ST-Link Debugger” → 点击Settings，若能识别到SW Device，说明连接正常。

2.5 第一个工程创建与下载验证：LED闪烁实战

现在进入本章最激动人心的环节——让板子“活”起来。我们将基于2.3节生成的LED_Test工程，编写闪烁逻辑并下载到开发板。

2.5.1 编写用户代码

在Keil中打开生成的工程，展开Application/User/Core/main.c，在while(1)循环中添加LED翻转代码：

/* Infinite loop */
while (1)
{
  HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);  // 翻转PA5电平
  HAL_Delay(500);                          // 延时500ms
}

同时，在main.c的/* USER CODE BEGIN 2 */处可添加初始化提示：

/* USER CODE BEGIN 2 */
printf("STM32 LED Test Start!\r\n");
/* USER CODE END 2 */

若需要使用printf重定向，需在usart.c中添加fputc函数重写，此处暂不展开，后续章节详解。

2.5.2 编译与下载

1. 编译设置：点击魔术棒 → Target页，确认晶振频率为72MHz（与CubeMX配置一致）。点击编译按钮（或F7），观察Build Output窗口。
2. 下载设置：点击魔术棒 → Debug → 选择“ST-Link Debugger” → 点击Settings → Flash Download页，勾选“Reset and Run”（下载后自动复位运行），Programming Algorithm中确认已添加STM32F10x Med-density Flash。
3. 下载程序：点击LOAD按钮（或F8），看到“Flash Load finished”即下载成功。此时开发板上的LED应以1Hz频率闪烁。

2.5.3 案例拆解：一次完整的下载失败排查

以下是一个真实教学场景中的排障案例，帮助你理解问题定位方法。

2.6 常见误区与总结复盘

根据多年教学经验，初学者在环境搭建阶段最容易犯以下错误，务必引以为戒：

• 误区一：安装路径带中文。如D:\开发\Keil，会导致部分插件无法加载。正确做法是使用纯英文路径。
• 误区二：忽略管理员权限。Keil、CubeMX、驱动安装均需右键“以管理员身份运行”，否则注册表写入失败。
• 误区三：CubeMX生成代码后直接修改HAL库文件。正确做法是只在USER CODE区域内修改，否则重新生成时所有改动丢失。
• 误区四：ST-Link接线错误。SWD接口只需4根线：SWDIO、SWCLK、GND、3.3V（可选）。不要将SWDIO和SWCLK接反，这是最常见的硬件错误。
• 误区五：忽视电源稳定性。部分USB口供电不足，导致下载时电压跌落。建议使用带屏蔽的USB线，或外接5V适配器。

本章从工具链认知出发，详细讲解了Keil MDK、STM32CubeMX、ST-Link驱动的安装与配置，并通过LED闪烁实验完成了第一个工程的创建与下载验证。这套流程是后续所有STM32实验的“标准动作”，建议你重复操作2-3遍，直到能够不看教程独立完成。当你能熟练地在10分钟内从零搭建好环境并点亮LED时，就已经迈过了嵌入式开发的第一道门槛。