分类导航

黄金 阶段 04 · 黄金进阶

【黄金篇】STM32 HAL 库与现代开发工作流

白银篇已经练过外设与标准库,这一站把重点放在配置、编辑、构建和调试的工作流程上:用 STM32CubeMX 配置引脚和时钟,在 VS Code 中写代码,通过 CMake 组织构建,再对照熟悉的例程学习 HAL 库。

工具变了,之前积累的接线和排查经验仍然有用。先让一个最小工程完成编译、下载和运行,再逐步迁移自己的小项目;AI 助手可以在旁边帮你解释代码与报错。

第一部分:准备开发工具

先准备下面 3 个工具,再按安装视频补齐 GCC 工具链、OpenOCD 和所需插件。每装好一项就验证一次,后面出了问题会更容易定位。

CubeMX

CubeMX

ST 官方配置工具

用图形界面选择芯片、配置引脚、时钟树和外设,并生成初始化代码。配置完成后仍要核对参数是否符合你的接线和实验目标。

官网下载
VS Code

VS Code

代码编辑与插件工作区

用来编辑代码、查看工程和运行终端命令。代码跳转、补全与调试功能需要配合课程中的插件和工具链配置。

官网下载
CMake

CMake

项目构建系统

负责组织工程的构建流程。入门时先跟着教程完成配置和一次编译,暂时不用把所有构建脚本语法学完;需要调整工程时再逐项查阅。

官网下载
安装 CMake 后,先确认终端能找到它

可以使用默认安装路径(如 C:\Program Files\CMake),并选择将 CMake 加入 PATH。安装后重新打开 VS Code 和终端,运行 cmake --version;看到版本号后再继续配置工程。
默认路径本身就带空格,不必因此修改安装位置。如果命令无法找到,先检查 PATH;若脚本报路径错误,再核对路径引用与教程中的配置。CMake 命令说明

安装与配置视频

第一次把 VS Code、CubeMX、GCC 和 OpenOCD 接起来,步骤会比安装一个编辑器多一些。可以跟着下面的实操视频完成配置;先用一个简单工程验证编译、下载和调试,再搬进自己的项目。

用 VS Code 开发 STM32:安装与配置实操

跟着视频配置工具链,前往 B 站观看 ↗

前往学习

第二部分:用 AI 助手辅助理解与排查

Copilot

AI 编程助手可以帮你做什么?

解释代码 · 梳理报错 · 提出排查思路

开发环境跑通后,可以再尝试 GitHub Copilot 等 AI 编程助手。看不懂一段回调函数、无法理解编译信息时,带上相关代码、完整报错和芯片型号提问,通常比只问“为什么不能运行”更有帮助。
是否使用、选择哪种服务,可以按你的网络、预算和习惯决定。先把编译与调试流程掌握好,助手再慢慢加入。

也可以尝试 DeepSeek

如果你使用的 VS Code 插件支持 DeepSeek API,可以按照插件与服务商的官方文档配置;也可以先在网页端提问,不必急着把所有工具都接进编辑器。接入前核对费用、接口与数据设置,不要把 API 密钥放进公开工程。
让“蓝色大肥鱼”帮你解释 HAL 回调、分析报错,或者列出需要查阅的手册章节就好。它给出的宏、引脚和修改建议仍要与官方资料核对,再通过编译和实际运行确认 ( •̀ ω •́ )✧。

AI编程助手实战

第三部分:对照标准库学习 HAL 库

HAL 库改变了哪些写法?

HAL 是硬件抽象层。对于同一块 STM32,GPIO 电平、定时器计数和串口时序这些硬件原理不会因为换了库而改变,白银篇的基础可以继续用。

但迁移不只是给函数加上 HAL_ 前缀。例如,标准库里设置 GPIO 的 GPIO_WriteBit,在 HAL 中可以对照 HAL_GPIO_WritePin 学习;其他外设还会涉及句柄、状态、回调,以及轮询、中断或 DMA 等不同工作方式。对照一份熟悉的例程,逐项查看初始化、启动和数据处理流程,比只记函数名更有用。STM32F1 HAL 官方手册

参考课程:江协 STM32 教程 HAL 库重制版

下面的重制视频可以用于对照标准库例程与 HAL 实现。选择自己已经完成的实验,看看两种写法如何完成同一件事:

【江协STM32 HAL库重制】6.oled显示屏(全套重制视频)

对照 OLED 实验学习 HAL 写法,前往 B 站观看 ↗

前往学习
把原理视频与 HAL 例程放在一起看

忘记外设原理时,回看江协科技的标准库课程;不熟悉 HAL 写法时,再对照重制例程。配置时钟树时,可以把 CubeMX 的界面与原理图一起看,核对时钟来源、分频和最终频率。一次只迁移一个外设,调通后再组合。

第四部分:用一个小项目检查工作流

这一阶段不增加大型考核,可以选白银篇中做过的一个小项目,尝试用 HAL 重新实现。检查自己能否完成配置、生成代码、编译、下载和调试,并说明关键参数为什么这样设置。

学习 HAL 库主要是为了:
1. 少写重复的初始化代码:CubeMX 生成外设初始化代码,让你把更多精力放在项目行为、算法和交互上。生成结果仍要读懂并验证;
2. 更方便地在 STM32 系列间迁移:HAL 提供通用接口,也有面向具体芯片的扩展接口。换到 F4/H7 等型号时,仍需要检查时钟、引脚、外设能力与驱动配置,不能假定改几个宏就能直接运行。

当这个小项目能够稳定运行,你就有了一套可复用的开发流程。接下来可以进入白金篇,继续学习 FreeRTOS 实时系统或 ESP32 联网开发 (ง •_•)ง。

通关黄金篇