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

各位同学好，我是你们这门课的老周。做了十几年嵌入式，从51到ARM，从汇编到C++，踩过的坑比吃过的盐还多。今天咱们开始第一讲，先把地基打牢。

这门课的目标很明确：让你学会怎么把STM32的驱动写得像模像样，而不是满屏的while(1)和delay。说白了，就是教你一套可复用、可调试的驱动封装套路。我当年带团队的时候，最头疼的就是新人写的驱动——功能能跑，但换个项目就得重写。这课就是帮你避免这种尴尬。

1.1 课程目标与定位

学完这门课，你能做到三件事：

• 第一，拿到任何一款STM32，能快速搭建裸机工程模板，而不是每次从零开始点灯。
• 第二，掌握驱动封装的核心思想——分层、抽象、接口化。你写的GPIO驱动，换个芯片型号，改几行宏定义就能用。
• 第三，学会调试接口的设计。我见过太多人只会用串口打印，遇到复杂问题就抓瞎。咱们会讲SEGGER RTT、硬件断点、逻辑分析仪配合调试的方法。

1.2 STM32选型建议

很多新手问我：“老周，学这个该用哪款芯片？”我的建议很直接——别用最新的，用最成熟的。

我个人习惯把STM32分成三个梯队：

梯队	代表型号	适用场景	我的建议
入门级	STM32F103C8T6	学习、简单控制	首选，资料最多，价格便宜
主流级	STM32F407VGT6	带屏、带网络、复杂外设	性价比高，适合进阶
高性能	STM32H743	音视频、高速采集	新手慎入，坑多

我建议你从F103开始。为什么？因为它的参考手册只有1000多页，而H7的有3000多页。你想想看，学个驱动还要先啃3000页手册，谁受得了？

1.3 开发环境安装

咱们用两样东西：Keil MDK和STM32CubeMX。一个写代码，一个生成初始化代码。配合起来，效率翻倍。

1.3.1 Keil MDK安装要点

• 版本选择：MDK 5.38或以上，别用太老的版本。我见过有人还在用MDK 4，那界面看着就像上个世纪的产物。
• 安装路径：不要有中文，不要有空格。C:\Keil_v5 就挺好。
• 器件包：安装完后记得用Pack Installer下载STM32F1系列的DFP包。不然你新建工程会发现找不到芯片。

1.3.2 STM32CubeMX安装

这个简单，去ST官网下载最新版就行。安装时注意：

• 它会自动安装Java运行环境，别取消。
• 安装路径同样不要有中文。
• 首次启动会提示更新固件包，建议全选下载。虽然慢，但省得以后用到某个外设时才发现没装。

1.4 第一个裸机工程模板

好，环境装完了，咱们动手建第一个工程。这个模板会贯穿整个课程，所以每一步都别偷懒。

1.4.1 用CubeMX生成初始化代码

1. 打开CubeMX，新建工程，选择STM32F103C8。
2. 配置RCC：HSE选择Crystal/Ceramic Resonator。
3. 配置SYS：Debug选择Serial Wire。这一步很多人忘，导致第一次下载程序后芯片就锁死了。
4. 配置时钟树：HCLK设为72MHz。F103的最高主频就是72M，别超频。
5. 配置GPIO：选一个引脚，比如PC13，设为Output。
6. Project Manager里：Project Name填“stm32_template”，Toolchain/IDE选MDK-ARM。
7. 点击GENERATE CODE，生成工程。

1.4.2 工程目录结构

生成好的工程，我会重新整理目录。这是我多年总结的模板结构：

stm32_template/
├── Core/               # 主程序
│   ├── Inc/            # 头文件
│   └── Src/            # 源文件
├── Drivers/            # 官方驱动
│   ├── CMSIS/
│   └── STM32F1xx_HAL_Driver/
├── User/               # 用户代码（我们自己写的）
│   ├── bsp/            # 板级支持包
│   ├── driver/         # 驱动封装
│   └── app/            # 应用逻辑
└── MDK-ARM/            # Keil工程文件

你可能会问：“老周，为什么还要建个User目录？”因为官方生成的代码我们尽量不动，自己的代码放在User里，这样以后升级HAL库时，不会把你的代码覆盖掉。这个坑我踩过不止一次。

1.4.3 点亮LED的完整代码

好，咱们写个点灯程序，验证模板能不能用。

/* main.c */
#include "main.h"

int main(void)
{
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();

    while (1)
    {
        HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
        HAL_Delay(500);
    }
}

这段代码很简单，但有个细节：LED_GPIO_Port和LED_Pin是CubeMX自动生成的宏定义。你可以在main.h里找到它们。这就是封装的第一步——用宏定义把硬件细节藏起来。

1.5 知识体系总览

为了让你对整门课有个全局认识，我画了张图。这张图会一直陪着你学完30章。

这张图就是咱们30章课程的骨架。从环境搭建开始，到GPIO、UART、SPI这些基础外设的驱动封装，再到定时器、ADC、DMA这些进阶内容，最后用调试接口设计收尾。每一章都会遵循“原理→代码→调试→避坑”这个循环。

1.6 本章小结

这一章咱们做了三件事：

• 明确了课程目标——学会驱动封装和调试接口设计。
• 选好了学习平台——STM32F103 + Keil + CubeMX。
• 建好了第一个工程模板——带目录结构、能点灯。

嗯，到这里，你的开发环境应该已经跑起来了。如果点灯程序没亮，别急着往下走。检查一下：LED引脚对不对？时钟配没配？Debug模式选没选Serial Wire？这三个问题解决了，99%的点灯问题都能搞定。