单片机与物联网 / 系统课时
配置 GPIO 输出点亮板载 LED
配置 GPIO 输出点亮板载 LED
本课以搭载 STM32F401RE 的 NUCLEO-F401RE 开发板为例,不依赖 HAL 库,直接操作 RCC 和 GPIO 寄存器点亮板载绿色 LED。你将完成从查阅芯片手册、开启外设时钟、配置引脚输出模式到通过 BSRR 设置电平的全过程,并使用调试器验证寄存器配置。
学习目标
- 根据芯片参考手册定位 RCC、GPIO 模式寄存器和 BSRR 的地址与位字段。
- 使用 C 语言直接操作寄存器,将 PA5 配置为通用推挽输出并点亮 LED。
- 通过寄存器读回、断点和实际 LED 状态验证配置结果,定位常见错误。
确认开发板与寄存器地址
本课使用 STM32 NUCLEO-F401RE 开发板,主控为 STM32F401RE,属于 ARM Cortex-M4 系列。板载绿色用户 LED 标记为 LD2,连接到 PA5,对应 Arduino D13 引脚。PA5 输出高电平时 LED 点亮,输出低电平时熄灭。
请先核对开发板丝印。不同开发板的 LED 引脚和有效电平可能不同,不能直接套用 PA5。尤其要区分绿色用户 LED LD2 和用于显示 ST-LINK 通信状态的 LD1。
根据 STM32F401 的参考手册 RM0368,本课需要以下寄存器:
| 寄存器 | 地址 | 作用 |
|---|---|---|
| RCC_AHB1ENR | 0x40023830 | 开启 GPIOA 外设时钟 |
| GPIOA_MODER | 0x40020000 | 设置 PA5 工作模式 |
| GPIOA_OTYPER | 0x40020004 | 设置输出类型 |
| GPIOA_PUPDR | 0x4002000C | 设置上下拉 |
| GPIOA_BSRR | 0x40020018 | 原子设置或复位输出电平 |
| GPIOA_ODR | 0x40020014 | 读取输出数据锁存值 |
地址并非随意指定。STM32F401 的 RCC 基地址为 0x40023800,AHB1ENR 偏移量为 0x30,因此实际地址为 0x40023830。GPIOA 基地址为 0x40020000,BSRR 偏移量为 0x18。
可以在 RM0368 中查找 RCC_AHB1ENR、GPIO port mode register 和 GPIO port bit set/reset register,核实地址、位字段及访问属性。
理解 RCC 与 GPIO 的配置关系
GPIO 并非只要知道地址就能直接工作。STM32F401 在复位后默认没有开启 GPIOA 的外设时钟,因此必须先使能时钟,再配置 GPIOA 的相关寄存器。

具体需要设置以下位字段:
| 位字段 | 位置 | 目标值 | 含义 |
|---|---|---|---|
| GPIOAEN | AHB1ENR bit 0 | 1 | 开启 GPIOA 时钟 |
| MODER5 | MODER bits 11:10 | 01 | 通用输出模式 |
| OT5 | OTYPER bit 5 | 0 | 推挽输出 |
| PUPDR5 | PUPDR bits 11:10 | 00 | 无上下拉 |
| BS5 | BSRR bit 5 | 写入 1 | PA5 输出高电平 |
| BR5 | BSRR bit 21 | 写入 1 | PA5 输出低电平 |
一个 GPIO 引脚在 MODER 中占据连续两个位。PA5 对应 bit 10 和 bit 11,而不是 bit 5。
模式编码为 00 输入、01 通用输出、10 复用功能、11 模拟模式。配置时应先用位掩码清除原有两个位,再写入目标编码,避免保留不期望的旧配置。
GPIOA_OTYPER 的 OT5 为 0 表示推挽输出。推挽模式能够主动驱动高、低电平,适合本课的板载 LED。PUPDR5 设为 00 表示不启用内部上拉或下拉。
编写裸机寄存器控制程序
下面的程序可作为 main.c 使用。它直接访问内存映射寄存器,不使用 HAL、LL 或标准外设库,适用于已具备 STM32F401RE 启动文件、链接脚本及基本运行环境的裸机工程。
#include <stdint.h>
#define REG32(addr) (*(volatile uint32_t *)(uintptr_t)(addr))
#define RCC_AHB1ENR REG32(0x40023830UL)
#define GPIOA_MODER REG32(0x40020000UL)
#define GPIOA_OTYPER REG32(0x40020004UL)
#define GPIOA_PUPDR REG32(0x4002000CUL)
#define GPIOA_BSRR REG32(0x40020018UL)
#define LED_PIN 5U
int main(void)
{
/* 先使能 GPIOA 时钟,读回保证后续访问的顺序 */
RCC_AHB1ENR |= (1UL << 0);
(void)RCC_AHB1ENR;
/* PA5 对应 MODER 的 bit 11:10,01 表示输出 */
GPIOA_MODER &= ~(3UL << (LED_PIN * 2U));
GPIOA_MODER |= (1UL << (LED_PIN * 2U));
/* 推挽输出,且不使用内部上下拉 */
GPIOA_OTYPER &= ~(1UL << LED_PIN);
GPIOA_PUPDR &= ~(3UL << (LED_PIN * 2U));
/* 写入 BSRR 的 BS5,置位输出数据锁存器 */
GPIOA_BSRR = (1UL << LED_PIN);
while (1) {
/* 保持 LED 点亮,等待调试器观察 */
}
}这里的 volatile 告诉编译器,每次寄存器访问都可能具有外部可见的效果,不能把它当作普通内存变量随意优化掉。它并不意味着线程安全,也不自动提供任意多步操作的原子性。
程序先使能 GPIOA 时钟,随后读取 AHB1ENR,确保时钟使能写操作在后续 GPIO 访问前完成。接着设置 PA5 的工作模式和输出类型,最后写入 BSRR。
BSRR 与 ODR 的区别值得注意:
- 向 BSRR 的 bit 0~15 写入 1,设置对应引脚的输出锁存位。
- 向 BSRR 的 bit 16~31 写入 1,复位对应引脚的输出锁存位。
- 写入 0 不改变对应输出锁存位,BSRR 不需要先读再改。
例如,1UL << 5 对应 0x00000020,使 PA5 输出高电平;1UL << 21 对应 0x00200000,使 PA5 输出低电平。
使用 BSRR 可以在单次寄存器写入中修改指定引脚的输出锁存位,不会像对 ODR 进行读改写那样在中断并发修改其他引脚时产生覆盖风险。它不代表多个独立的 BSRR 写操作构成一个不可分割的事务。
烧录固件并验证 LED 状态
本示例没有调用操作系统接口,也不需要外设驱动库。但必须具备适用于 STM32F401RE 的启动代码、向量表、链接脚本和 Flash 下载方式。单独把 main.c 交给编译器不能自动生成可启动固件。
如果已有 STM32F401RE 裸机工程,按以下顺序验证:
- 将上面的程序保存为工程中的
main.c,确保入口符号为main。 - 确认启动代码完成堆栈初始化、必要的数据段初始化,并最终调用
main。 - 使用工程现有的 ARM GCC 构建配置编译并链接,检查生成 ELF 文件。
- 通过板载 ST-LINK 下载固件,复位后观察 LD2。
- 在
GPIOA_BSRR写入语句处设置断点,单步执行并查看相关寄存器。
预期结果:执行 BSRR 置位写操作后,板载绿色用户 LED LD2 持续点亮。由于程序没有发送串口消息,因此不会产生约定的控制台输出。
如果使用 GDB 调试,可在程序停住时执行下面的寄存器读取命令:
x/1wx 0x40023830
x/1wx 0x40020000
x/1wx 0x40020014预期结果:AHB1ENR 的 bit 0 为 1,MODER 的 bits 11:10 为二进制 01,ODR 的 bit 5 在执行 BSRR 置位后为 1。其他位可能受到复位值或工程初始化代码影响,不应要求整字寄存器值完全一致。
特别注意,BSRR 是写入控制寄存器,不适合通过读取它来判断当前 LED 输出状态。应读取 ODR 的 bit 5,或者使用调试器观察引脚输出及 LED 状态。
验证熄灭操作与排查错误
为了验证 BSRR 的复位功能,可将主程序末尾的点亮操作临时改为熄灭操作。以下是片段示例,依赖前面已经完成 RCC 和 GPIO 初始化的 main.c。
/* BSRR 高半字的 bit 21 用于复位 PA5 */
GPIOA_BSRR = (1UL << (LED_PIN + 16U));预期结果:LD2 熄灭,GPIOA_ODR 的 bit 5 变为 0。再次写入 BSRR 的 bit 5 后,LD2 应重新点亮。无需改变 MODER,也无需关闭 GPIOA 时钟。
常见故障可以按下面的顺序排查:
| 故障现象 | 可能原因 | 检查或修复方式 |
|---|---|---|
| LED 始终不亮 | GPIOA 时钟未开启 | 检查 AHB1ENR bit 0 是否为 1 |
| ODR bit 5 改变但 LED 不亮 | 引脚模式错误或板级连接不符 | 检查 MODER5、OT5 和开发板引脚映射 |
| LED 状态与代码相反 | 目标开发板采用低电平点亮 | 按实际原理图确认有效电平 |
| PA5 无法正常驱动 | 被初始化为复用功能或模拟模式 | 检查 MODER bits 11:10 是否为 01 |
| 程序没有执行到主函数 | 启动文件、链接脚本或烧录有误 | 在 main 入口设置断点并检查向量表 |
还可以使用一个简单的验证清单检查最终状态:GPIOA 时钟已开启、PA5 已配置为输出、输出类型为推挽、内部上下拉关闭、BSRR 写入后 ODR bit 5 与期望电平一致、板载 LD2 能正确响应。
当这些检查均通过时,就完成了一条真实的寄存器驱动路径:由 RCC 提供外设时钟,GPIO 模式寄存器确定引脚行为,BSRR 控制输出锁存位,最后由 PA5 驱动板载 LED。这套方法也能用于继电器控制信号、片选引脚和其他简单数字输出,但需要按目标硬件重新核对引脚映射与电气要求。