【STM32 HAL库】01 - LED闪烁实验（GPIO输出）
一、实验目的
熟悉 STM32CubeMX 图形化配置工具的基本使用流程
掌握 GPIO 引脚配置为输出模式的方法
理解 HAL 库中 GPIO 相关函数的使用
实现 LED 周期性闪烁，验证开发板下载、运行链路正常
二、硬件平台
|
项目
|
说明
|
| --- | --- |
|
开发板
|
野火霸天虎 STM32F407ZG
|
|
主控芯片
|
STM32F407ZGT6（LQFP144）
|
|
LED 引脚
|
PF6（红色 LED，开漏输出，低电平点亮）
|
|
外部晶振
|
HSE = 25 MHz
|
|
系统时钟
|
SYSCLK = 168 MHz
|
野火 LED 电路说明：霸天虎板上的 LED 采用共阳极接法，GPIO 配置为开漏输出（Open Drain），当引脚输出低电平时 LED 点亮，输出高电平时 LED 熄灭。
三、软件环境
|
软件
|
版本/说明
|
| --- | --- |
|
STM32CubeMX
|
v6.x（生成初始化代码）
|
|
Keil MDK-ARM
|
v5（编译+下载）
|
|
固件包
|
STM32Cube FW_F4
|
|
下载器
|
ST-LINK / CMSIS-DAP
|
四、CubeMX 配置步骤
4.1 选择芯片
打开 STM32CubeMX → ACCESS TO MCU SELECTOR → 搜索 STM32F407ZG → 选择 STM32F407ZGTx → Start Project。
4.2 配置 RCC（外部晶振）
左侧 System Core → RCC：
- High Speed Clock (HSE) 选择
Crystal/Ceramic Resonator（外部晶振）
4.3 配置时钟树
切换到 Clock Configuration 标签页：
|
配置项
|
值
|
| --- | --- |
|
HSE 输入频率
|
25 MHz
|
|
PLL 来源
|
HSE
|
|
/M (PLLM)
|
25
|
|
*N (PLLN)
|
336
|
|
/P (PLLP)
|
2
|
|
系统时钟来源
|
PLLCLK
|
|
AHB 预分频
|
/1
|
|
APB1 预分频
|
/4
|
|
APB2 预分频
|
/2
|
最终 SYSCLK = 168 MHz，APB1 = 42 MHz，APB2 = 84 MHz。
4.4 配置 LED 引脚 PF6
在芯片引脚图上找到 PF6，左键选择 GPIO_Output。
点击左侧 System Core → GPIO，找到 PF6 进行配置：
|
配置项
|
值
|
| --- | --- |
|
GPIO output level
|
Low（初始低电平，LED 亮）
|
|
GPIO mode
|
Output Open Drain（开漏输出）
|
|
GPIO Pull-up/Pull-down
|
No pull-up and no pull-down
|
|
Maximum output speed
|
Low
|
|
User Label
|
LED_R
|
⚠️ 关键：GPIO mode 必须选择开漏输出（Open Drain），不能选推挽（Push Pull），否则与野火板的硬件电路不匹配。
4.5 配置调试接口
左侧 System Core → SYS：
- Debug 选择
Serial Wire（SWD 调试接口）
⚠️ 必须配置：如果不选 Serial Wire，下载一次后 PA13/PA14 会被复用，仿真器将无法再次连接芯片，只能用串口 ISP 救砖。
4.6 工程设置并生成代码
切换到 Project Manager 标签页：
|
配置项
|
值
|
| --- | --- |
|
Project Name
|01_LED_Blink
|
|
Project Location
|
自定义工程目录
|
|
Toolchain / IDE
|
MDK-ARM V5
|
Code Generator 标签页勾选：
✅ Generate peripheral initialization as a pair of '.c/.h' files per peripheral
✅ Copy all used libraries into the project folder
点击右上角 GENERATE CODE 生成代码。
五、代码实现
生成代码后，打开 Core/Src/main.c，在 while(1) 循环的 USER CODE BEGIN 3 区域添加 LED 翻转代码：
/* Infinite loop */
/* USER CODE BEGIN WHILE */
while (1)
{
/* USER CODE END WHILE */
/* USER CODE BEGIN 3 */
HAL_GPIO_TogglePin(LED_R_GPIO_Port, LED_R_Pin); /* 翻转 LED 电平 */
HAL_Delay(1000); /* 延时 1 秒 */
}
/* USER CODE END 3 */
核心函数说明
|
函数
|
作用
|
| --- | --- |
|HAL_GPIO_TogglePin(GPIOx, GPIO_Pin)
|
翻转指定 GPIO 引脚的输出电平
|
|HAL_Delay(uint32_t Delay)
|
毫秒级延时（基于 SysTick）
|
LED_R_GPIO_Port和LED_R_Pin宏定义在Core/Inc/main.h中，由 CubeMX 根据 User Label 自动生成：#define LED_R_Pin GPIO_PIN_6 #define LED_R_GPIO_Port GPIOF
GPIO 初始化代码（gpio.c，CubeMX 自动生成）
void MX_GPIO_Init(void)
{
GPIO_InitTypeDef GPIO_InitStruct = {
0};
__HAL_RCC_GPIOF_CLK_ENABLE(); /* 使能 GPIOF 时钟 */
__HAL_RCC_GPIOH_CLK_ENABLE();
__HAL_RCC_GPIOA_CLK_ENABLE();
HAL_GPIO_WritePin(GPIOF, GPIO_PIN_6, GPIO_PIN_RESET); /* 初始低电平 */
GPIO_InitStruct.Pin = GPIO_PIN_6;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_OD; /* 开漏输出 */
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
HAL_GPIO_Init(GPIOF, &GPIO_InitStruct);
}
六、编译与下载
编译：Keil 中按
F7或点击 Build 按钮，确认 0 Error(s)。配置下载器：魔术棒 →
Debug选择ST-Link Debugger或CMSIS-DAP Debugger→ Settings 确认识别到芯片。下载：按
F8或点击 Load 按钮。验证：下载成功后，LED_R 以 1 秒为周期闪烁。
七、实验现象
板载红色 LED（LED_R）每秒亮灭一次，循环闪烁。
八、常见问题
|
问题
|
原因
|
解决方法
|
| --- | --- | --- |
|
LED 不亮
|
下载后未自动运行
|
勾选 Reset and Run，或按复位键
|
|
LED 微亮但不闪烁
|
GPIO 配成推挽输出
|
改为开漏输出（Open Drain）
|
|
编译报错找不到头文件
|
Include 路径未配置
|
检查 Keil 工程 Include Paths
|
|
仿真器无法连接
|
SYS Debug 未配置 Serial Wire
|
用串口 ISP 重新下载，或检查接线
|
|
延时不准
|
HSE 频率配错
|
确认 HSE = 25 MHz（野火板不是 8 MHz）
|
九、工程目录结构
01_LED_Blink/
├── Core/
│ ├── Inc/
│ │ ├── main.h ← LED_R_Pin 等宏定义
│ │ ├── gpio.h
│ │ ├── stm32f4xx_hal_conf.h
│ │ └── stm32f4xx_it.h
│ └── Src/
│ ├── main.c ← 主循环（LED 翻转逻辑）
│ ├── gpio.c ← GPIO 初始化（CubeMX 生成）
│ ├── stm32f4xx_hal_msp.c
│ ├── stm32f4xx_it.c ← 中断服务函数
│ └── system_stm32f4xx.c ← 系统时钟
├── Drivers/ ← STM32 HAL 库源码
├── MDK-ARM/ ← Keil 工程文件
└── 01_LED_Blink.ioc ← CubeMX 配置文件
提示：修改代码时务必写在
/* USER CODE BEGIN */和/* USER CODE END */之间，否则重新用 CubeMX 生成代码时会被覆盖。
