1. 课程导入与工程环境搭建
《STM32外设驱动与BSP工程》这门课的目标，不是把STM32的寄存器手册从头念一遍，而是建立一条从“芯片外设”到“可复用板级支持包”的工程化路径。学完这门课，你应当能够独立完成三件事：第一，看懂一个外设从时钟使能、引脚复用、寄存器配置到中断/DMA工作的完整链路；第二，把裸机驱动整理成有清晰接口、可移植、可复用的BSP模块；第三，用一套稳定的工具链把代码从工程创建、编译、下载到板上验证跑通。本章作为导入，先把学习地图、核心概念、工具链选型和最小系统板点亮LED的完整流程串起来，为后续章节建立统一的工程基线。
1.1 先建立“外设—驱动—BSP”的三层认知
很多初学者写STM32代码时，习惯把所有初始化都堆在main.c里：先开GPIO时钟，再配引脚，再写延时循环，最后点灯。这种写法在第一个实验里能跑通，但一旦要加串口、加定时器、加OLED，代码就会迅速失控。原因在于缺少分层。
本课程采用的三层结构是：外设层对应芯片内部的GPIO、USART、TIM、SPI、I2C、ADC等硬件资源；驱动层负责把某个外设的初始化、读写、中断处理封装成函数，例如bsp_led_init()、bsp_uart_send()；BSP层则面向具体开发板，把板上的LED、按键、串口、屏幕等对象组织成统一接口，让上层应用不必关心引脚号和寄存器名。这样做的直接好处是：换一块板子时，主要改BSP，驱动逻辑可以大量复用。
需要特别说明的是，本课程后续所有“点亮LED”“串口回显”“定时器闪烁”等实验，都会尽量按这个分层来组织，而不是只追求“能亮就行”。
1.2 工具链选型：CubeMX + IDE + 下载器
STM32的开发工具链可以粗略分成三类：一类是ST官方生态，包括STM32CubeMX、STM32CubeIDE、STM32CubeProgrammer；一类是第三方IDE，如Keil MDK、IAR EWARM；还有一类是开源工具链，如GCC + Makefile + OpenOCD。本课程推荐以STM32CubeMX + STM32CubeIDE为主线，原因是它们免费、跨平台、与HAL库配合紧密，且CubeMX能自动生成时钟树、引脚分配和初始化代码，非常适合把精力集中在驱动与BSP设计上。
如果你已经习惯Keil，也完全可以继续使用：用CubeMX生成.ioc配置和初始化代码，再导入Keil工程即可。关键不是工具本身，而是理解CubeMX生成的代码结构：Core/Src/main.c里的MX_GPIO_Init()、MX_USART2_UART_Init()等函数，以及stm32f1xx_hal_msp.c中的底层初始化，都是后续写BSP时要对接的位置。
下载与调试方面，最小系统板通常板载ST-Link或CH340串口。若使用ST-Link，可在CubeIDE中直接点击“Run”下载；若只有串口，则需要用STM32CubeProgrammer通过UART bootloader下载，并注意BOOT0跳线。调试接口建议保留SWD，只占用PA13/PA14两个引脚，方便后续单步调试。
1.3 用CubeMX创建第一个工程
下面以常见的STM32F103C8T6最小系统板为例，说明从零创建工程的关键操作。假设目标是用PC13引脚上的LED实现1Hz闪烁。
- 打开STM32CubeMX，选择“New Project”，在芯片搜索框中输入
STM32F103C8，选中LQFP48封装，创建工程。 - 在Pinout视图中找到PC13，将其设置为
GPIO_Output。注意：最小系统板上的LED通常是低电平点亮，即输出0时亮、输出1时灭，这一点在写代码时要保持一致。 - 进入Clock Configuration，选择HSE为外部晶振（若板上有8MHz晶振），将系统时钟配置为72MHz。若板子没有晶振，也可先用HSI 8MHz，后续再调整。
- 在Project Manager中设置工程名称、保存路径、工具链为STM32CubeIDE，并勾选“Generate peripheral initialization as a pair of .c/.h files”。
- 点击“Generate Code”，CubeMX会生成完整工程，其中
main.c已经包含SystemClock_Config()和MX_GPIO_Init()。
生成后的main.c中，while (1)循环是空的。我们需要在/* USER CODE BEGIN 3 */和/* USER CODE END 3 */之间加入闪烁逻辑。注意，所有用户代码都应写在USER CODE保护区内，否则下次CubeMX重新生成代码时会被覆盖。
while (1)
{
HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_RESET); // 低电平点亮
HAL_Delay(500);
HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_SET); // 高电平熄灭
HAL_Delay(500);
}这段代码的逻辑非常直白：每500ms翻转一次PC13电平，形成1Hz闪烁。其中HAL_Delay()依赖SysTick中断，默认1ms节拍，因此延时精度在毫秒级，足够LED观察。
1.4 从“点灯”到“可复用BSP”的第一步
如果只写上面这段代码，它确实能亮，但还不算BSP。更工程化的做法是新建bsp_led.c和bsp_led.h，把LED的初始化、开、关、翻转封装成函数。例如：
// bsp_led.h
#ifndef __BSP_LED_H
#define __BSP_LED_H
#include "main.h"
void bsp_led_init(void);
void bsp_led_on(void);
void bsp_led_off(void);
void bsp_led_toggle(void);
#endif// bsp_led.c
#include "bsp_led.h"
void bsp_led_init(void) {
HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_SET); // 默认熄灭
}
void bsp_led_on(void) { HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_RESET); }
void bsp_led_off(void) { HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_SET); }
void bsp_led_toggle(void){ HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13); }然后在main.c中调用bsp_led_init()，循环里用bsp_led_toggle()加HAL_Delay(500)。这样，LED的引脚信息只出现在BSP里，应用层不再直接碰GPIOC和GPIO_PIN_13。后续如果换到PB0，只改BSP即可。
1.5 下载、运行与结果判断
代码编译通过后，用ST-Link连接最小系统板的SWD接口，在CubeIDE中点击Run。若下载成功，板上PC13对应的LED应以约1秒周期闪烁。判断依据可以分三层：第一，IDE的Console没有报错，且提示“Download verified successfully”；第二，用示波器或逻辑分析仪测PC13，能看到约1Hz方波；第三，肉眼观察LED亮灭交替。若LED常亮或常灭，优先检查三点：PC13是否确实配置为输出、LED极性是否判断反了、HAL_Delay()是否因为时钟配置错误而异常。
下面这张图把本节的核心关系整理为“工具链—工程结构—BSP分层—板上结果”的对应关系，便于你在动手前先建立整体印象。