1. 课程导学与开发环境搭建
各位同学好，我是你们这趟迁移之旅的向导。说实话，我接触STM32快十年了，从最早的StdPeriph_Lib一路用到现在的HAL/LL库。这期间踩过的坑、翻过的车，说多了都是泪。所以这门课，我打算把那些血泪教训直接摊开给你们看。
这一章咱们先不急着写代码。先把地基打牢——搞清楚标准库和HAL库到底差在哪，选哪块开发板最顺手，再把MDK5和CubeMX装好，最后跑通第一个工程。嗯，磨刀不误砍柴工嘛。
1.1 标准库 vs HAL库：到底选哪个？
很多新手一上来就纠结这个问题。我个人的看法是：小孩子才做选择，成年人两个都要会。但如果你非要二选一，得先明白它们各自的脾气。
| 对比项 | 标准库 (StdPeriph_Lib) | HAL库 (Hardware Abstraction Layer) |
|---|---|---|
| 官方状态 | 已停止更新（F1/F4系列最后版本） | 主力维护，持续更新 |
| 代码风格 | 寄存器操作封装，函数名长但直接 | 分层抽象，回调机制，面向对象思想 |
| 配置方式 | 手动写代码，逐项配置寄存器 | CubeMX图形化生成，自动初始化 |
| 学习曲线 | 陡峭，需要理解底层寄存器 | 平缓，但调试时黑盒感强 |
| 代码体积 | 较小，适合资源受限场景 | 较大，但可通过LL库裁剪 |
| 移植性 | 同一系列内尚可，跨系列重写 | 跨系列只需改芯片型号，重生成即可 |
| 调试难度 | 容易追踪寄存器值变化 | 回调嵌套多，断点有时不好定位 |
我的建议：如果你手头有标准库的老项目，别急着全盘推翻。先把HAL库学透，然后逐步迁移外设驱动。我在一个工业控制项目里就是这么干的——先拿UART和GPIO练手，稳定了再动TIM和DMA。一口吃不成胖子。
1.2 开发板怎么选？
我个人习惯用STM32F103C8T6（蓝色 pill板）做入门，便宜耐造，烧了不心疼。但咱们这门课要兼顾标准库和HAL库的对比，所以我建议你准备两块板：
- 主战板：STM32F407VET6（探索者或野火）—— 资源丰富，外设齐全，跑HAL库游刃有余
- 备用板：STM32F103C8T6（最小系统板）—— 验证标准库遗留代码，或者做低功耗测试
为什么选F4？因为它的FPU、DSP指令、更大的Flash/RAM，能让你充分体验HAL库的复杂外设配置。而且F4的HAL库生态最成熟，网上踩坑记录也多，真遇到问题好搜。
避坑指南：买开发板时注意晶振频率。很多便宜的F103板子配的是8MHz晶振，但F4系列有些板子用25MHz。这个在CubeMX里要选对，否则串口波特率会偏得一塌糊涂。我曾经因为这个排查了整整两天……
1.3 开发工具链安装
咱们这门课需要装两个核心工具：MDK5（Keil uVision5）和STM32CubeMX。顺序有讲究——先装MDK5，再装CubeMX。
1.3.1 MDK5安装要点
- 版本选择：我建议用5.38或更高版本。太老的版本对HAL库支持不好，编译报错能让你怀疑人生。
- 安装路径：不要有中文！不要有空格！我见过有人装在“D:\程序\Keil_v5”里，结果编译时路径解析出错。
- 器件包：安装完后记得用Pack Installer下载对应芯片的DFP（Device Family Pack）。F4系列选
Keil.STM32F4xx_DFP.2.17.1或更新版本。 - 破解：这个……嗯，大家懂的都懂。但如果你公司有预算，建议买正版，毕竟代码无价。
注意：MDK5安装过程中会提示安装ULINK驱动。如果你用J-Link或ST-Link，这个驱动可以跳过。但如果你以后想用ULINK调试，就得重新装，所以建议勾上。
1.3.2 STM32CubeMX安装
CubeMX是ST官方出的图形化配置工具。说白了，它就是帮你自动生成初始化代码的。你点点鼠标，它就把GPIO、时钟树、外设参数全配好了，然后生成HAL库工程。
- 下载：去ST官网搜“STM32CubeMX”，下载最新版（目前是6.12）。需要注册账号，但免费。
- 安装：一路Next就行。注意它会自动安装Java Runtime，别手欠取消。
- 固件包：第一次打开时，它会提示下载固件包。选
STM32Cube_FW_F4_V1.28.0（或更新版本）。这个包很大（几百MB），建议用手机热点+迅雷下载，公司网络经常限速。
我的习惯：CubeMX生成的代码我从来不改。我会在User Code Begin和User Code End注释之间写自己的逻辑。这样下次重新生成时，我写的代码不会被覆盖。这个习惯帮我省了无数重写的时间。
1.4 第一个工程模板创建
好，工具装完了，咱们来建第一个工程。我带你走一遍标准流程，后面每章都会基于这个模板。
1.4.1 用CubeMX生成HAL库工程
- 打开CubeMX，点击“New Project”。
- 在“Part Number Search”里输入
STM32F407VET6，双击选中。 - 进入Pinout & Configuration视图。先配RCC：HSE选
Crystal/Ceramic Resonator。 - 配SYS：Debug选
Serial Wire（如果你用ST-Link）。 - 配时钟树：HSE选8MHz（根据你板子实际晶振），PLL倍频到168MHz。这个频率是F407的极限，稳定运行没问题。
- 随便配一个GPIO：比如PA5设为
GPIO_Output，用来点LED。 - 点击“Project Manager”标签：
- Project Name：
STM32_HAL_Template - Location：选一个纯英文路径
- Toolchain / IDE：选
MDK-ARM V5 - Firmware Package：选你刚才下载的版本
- Project Name：
- 点击“GENERATE CODE”，等它生成完成。
1.4.2 在MDK5中编译验证
- 打开生成的
MDK-ARM文件夹，双击.uvprojx文件。 - 在MDK5里，点击“Build”按钮（或按F7）。
- 如果一切顺利，你会看到
0 Error(s), 0 Warning(s)。 - 如果报错，99%是器件包版本不匹配。去Pack Installer里更新一下DFP。
验证LED闪烁：在main.c的while(1)循环里加上：
HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
HAL_Delay(500);下载到板子，如果LED以1秒周期闪烁，恭喜你——环境搭建成功！
1.5 本章知识体系
下面这张图帮你理清本章的核心脉络。我画图时习惯把工具链和知识体系分开，这样脑子不乱。
1.6 常见问题与避坑
最后，我把自己这些年遇到过的、以及学员问得最多的几个问题列出来。你如果遇到了，直接对照排查。
问题1：CubeMX生成代码后，MDK5打开报错“device not found”
原因：MDK5的器件包版本太老，或者没装对应系列的DFP。
解决：打开Pack Installer，找到STM32F4xx_DFP，更新到最新版。然后重新生成代码。
问题2：编译通过，但下载后LED不亮
原因：多半是时钟配置错了。比如你板子用的是25MHz晶振，但CubeMX里配成了8MHz。这样系统时钟跑飞，外设都不工作。
解决：核对板子原理图上的晶振频率，在CubeMX的Clock Configuration里改过来。然后重新生成代码。
问题3：HAL_Delay()不准确，闪烁周期明显不对
原因：HAL_Delay依赖SysTick中断。如果你在中断里调用了HAL_Delay，或者SysTick优先级被改过，就会出问题。
解决：不要在中断服务函数里调用HAL_Delay。如果非要用，改用HAL_GetTick()做非阻塞延时。