1. 课程导学与开发环境搭建

大家好，欢迎来到这门课。我是你们的老朋友，一个在嵌入式圈子里摸爬滚打了十几年的工程师。

说实话，每次带新人或者做技术分享，我都能感受到大家面对 STM32 时的那种复杂心情——库函数那么多，项目结构怎么搭？出了问题从哪查？

这门课，就是来解决这些问题的。我们不只讲怎么调通一个外设，更会讲清楚背后的设计思路和软件架构。

1.1 课程目标与适用人群

先说说这门课到底要带你达到什么水平。

什么人适合学？

• 刚转 STM32 的开发者：会点灯，但项目一复杂就不知道怎么组织了。
• 想提升代码质量的工程师：不想再写“屎山”代码，想学点架构思想。
• 准备做产品级项目的朋友：需要一套经得起量产考验的开发套路。

1.2 学习路径与章节地图

整个课程 30 章，我把它分成了四个阶段。你想想看，就像盖房子一样，得先打地基，再搭框架，然后装修，最后验收。

1.3 开发工具安装指南

工欲善其事，必先利其器。我个人习惯把工具链分成两部分：IDE 和 配置工具。

1.3.1 Keil MDK 安装

Keil MDK 是我们写代码、编译、调试的主战场。我建议安装 5.38 或更新的版本，对 Cortex-M4/M7 支持更好。

1. 从 ARM 官网下载 MDK-ARM 安装包。
2. 运行安装程序，一路 Next。注意安装路径不要有中文。
3. 安装完成后，打开 Keil，通过 Pack Installer 安装你所用芯片的 Device Pack（比如 STM32F4xx_DFP）。
4. 破解（懂的都懂，正版用户请忽略这一步）。

1.3.2 STM32CubeMX 安装

CubeMX 是 ST 官方的图形化配置工具。它能帮你生成初始化代码，省去手动配时钟树的痛苦。

1. 去 ST 官网下载 STM32CubeMX，需要注册账号。
2. 安装时需要 Java 运行环境（JRE），如果电脑没有，安装包会提示你下载。
3. 安装后打开，在 Help → Manage embedded software packages 里更新你需要的固件包。

1.4 第一个 HAL 库工程：点灯

好了，工具装好了，我们来干点实际的。点灯，是嵌入式界的“Hello World”。

打开 CubeMX，新建工程，选择你的芯片型号（我用的是 STM32F407VET6）。

配置一个 GPIO 引脚作为输出：

• 在 Pinout 视图中，点击 PC13 引脚，选择 GPIO_Output。
• 在 Configuration 中，将 GPIO 输出等级设为 High，初始电平设为 Low。
• 时钟配置：HSE 8MHz，PLL 倍频到 168MHz。

点击 Generate Code，生成 MDK-ARM 工程。然后用 Keil 打开。

在 main.c 的 while(1) 循环里，加入以下代码：

while (1)
{
  HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
  HAL_Delay(500);
}

编译、下载。如果看到板子上的 LED 以 0.5 秒间隔闪烁，恭喜你，第一个 HAL 库工程跑起来了。

1.5 工程结构解析

点完灯，我们来看看 CubeMX 到底生成了什么。很多人拿到工程直接开写，从来不关心文件夹结构——这其实是个坏习惯。

你想想看，如果连这些文件各自管什么都不知道，出了问题你怎么定位？

我个人习惯是：永远不要修改 HAL 库源码。所有定制化的配置，都放在 msp.c 或者用户自己的 bsp_xxx.c 里。这样以后升级库版本时，直接替换 Drivers 文件夹就行，不用重写代码。

1.6 本章小结

这一章我们做了三件事：明确了课程目标、装好了开发环境、跑通了第一个点灯工程。

嗯，看起来简单，但这是后面所有复杂架构的基础。从下一章开始，我们会深入 HAL 库的骨髓，看看它到底是怎么封装寄存器的。