2. 开发环境搭建
STM32外设驱动开发的第一步不是写代码，而是把“工具链—配置工具—编译环境—调试探针”这条链路搭通。很多初学者卡在“工程能编译但下载不了”“CubeMX生成的代码在Keil里报错”“ST-Link识别不到芯片”等问题上，根源往往不是代码，而是环境配置不完整。本章围绕STM32CubeMX、Keil MDK、STM32CubeIDE、OpenOCD与ST-Link五类工具，讲清它们的分工、安装要点，并完成第一个可下载运行的工程。
一、核心原理：五类工具在开发链路中的位置
STM32开发不是单一软件能完成的，而是一条从“芯片配置”到“固件烧录”的流水线。理解每个工具的角色，比死记安装步骤更重要。
- STM32CubeMX：图形化配置工具。负责引脚分配、时钟树、外设初始化、中间件选择，并生成HAL/LL库工程骨架。它不编译代码，只产出“配置结果”。
- Keil MDK：商业集成开发环境，使用ARMCC/ARMCLANG编译器，配合Pack支持包完成编译、链接、下载和调试，是国内STM32教学最常用的IDE之一。
- STM32CubeIDE：ST官方免费IDE，基于Eclipse和GCC工具链，集成CubeMX配置界面，开箱即用，适合不想额外购买Keil授权的开发者。
- OpenOCD：开源片上调试器，负责把GDB/IDE的调试命令翻译成SWD/JTAG时序，驱动ST-Link等探针，常用于命令行、VS Code或自动化烧录场景。
- ST-Link：ST官方调试探针（硬件），通过SWD接口连接STM32的SWCLK、SWDIO、GND、3.3V，实现下载、单步、断点和寄存器查看。
它们的关系可以概括为：CubeMX决定“芯片怎么配”，Keil/CubeIDE决定“代码怎么编”，OpenOCD/ST-Link决定“程序怎么进芯片”。
二、安装配置要点与流程
推荐顺序是：先装IDE，再装CubeMX，最后装ST-Link驱动与OpenOCD。这样CubeMX生成工程时能直接选择目标IDE，避免重复配置。
- 安装Keil MDK：安装MDK-ARM后，必须通过Pack Installer安装对应器件包，例如STM32F1、STM32F4系列。没有Pack，工程会提示“Device not found”。
- 安装STM32CubeMX：需要Java运行环境（新版已内置）。首次启动后，在Help → Manage embedded software packages中下载对应系列的HAL库固件包。
- 安装STM32CubeIDE：官方安装包自带GCC、GDB和CubeMX配置界面，安装后可直接新建STM32工程，无需额外配置编译器。
- 安装ST-Link驱动：Windows下安装ST-Link USB驱动后，设备管理器应出现“STMicroelectronics STLink dongle”。
- 配置OpenOCD：解压OpenOCD后，确认scripts/target目录下有对应芯片的cfg文件，例如stm32f1x.cfg、stm32f4x.cfg。
若使用Keil + ST-Link，需在Options for Target → Debug中选择“ST-Link Debugger”，并在Settings中确认SWD模式与芯片ID能被识别。若使用CubeIDE，则默认使用ST-Link GDB Server，无需手动配置OpenOCD。
三、第一个工程：从CubeMX到点灯
以STM32F103C8T6最小系统板为例，目标是在PC13上点亮LED。步骤如下：
1. CubeMX新建工程，选择STM32F103C8Tx
2. System Core → RCC → HSE选择Crystal/Ceramic Resonator
3. GPIO → PC13设置为GPIO_Output
4. Clock Configuration中配置HSE为8MHz，SYSCLK为72MHz
5. Project Manager → Toolchain选择MDK-ARM或STM32CubeIDE
6. 生成代码，打开工程，在main.c的while(1)中加入：
HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_13);
HAL_Delay(500);
7. 编译、下载、复位，观察LED闪烁如果使用OpenOCD命令行烧录，可执行：
openocd -f interface/stlink.cfg -f target/stm32f1x.cfg \
-c "program build/led.elf verify reset exit"该命令完成三件事：连接ST-Link、烧录elf、校验并复位运行。若出现“Error: open failed”，优先检查ST-Link驱动和SWD接线，而不是怀疑代码。
四、常见误区与复盘
| 现象 | 常见原因 | 处理方式 |
|---|---|---|
| Keil编译报“Device not found” | 未安装对应器件Pack | Pack Installer中安装STM32F1/F4系列包 |
| CubeMX生成后Keil打开缺文件 | Toolchain选错或路径含中文 | 重新生成，工程路径使用纯英文 |
| ST-Link无法识别芯片 | SWD接线错误、目标未供电 | 检查SWCLK/SWDIO/GND/3.3V，确认板子供电 |
| OpenOCD报“open failed” | 驱动未装或被其他软件占用 | 关闭Keil/CubeIDE，重装ST-Link驱动 |
| 下载成功但LED不亮 | 引脚定义与板子不一致 | 核对原理图，确认LED连接的是PC13还是PB13 |
不要同时打开Keil和CubeIDE占用同一个ST-Link，否则会出现“No ST-Link detected”。调试下载时只保留一个IDE连接探针。
环境搭建的本质是让“配置—编译—下载—运行”四个环节各自可验证。建议每装完一个工具就做一次最小验证：CubeMX能生成工程、IDE能编译0错误、ST-Link能被设备管理器识别、OpenOCD能打印芯片ID。四步都通过后，再开始写外设驱动，后续排障会轻松很多。