单片机与物联网 / 系统课时

配置 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 的相关寄存器。

GPIOA 时钟使能与 PA5 输出控制结构图

具体需要设置以下位字段:

位字段 位置 目标值 含义
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 启动文件、链接脚本及基本运行环境的裸机工程。

c
#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 裸机工程,按以下顺序验证:

  1. 将上面的程序保存为工程中的 main.c,确保入口符号为 main。
  2. 确认启动代码完成堆栈初始化、必要的数据段初始化,并最终调用 main。
  3. 使用工程现有的 ARM GCC 构建配置编译并链接,检查生成 ELF 文件。
  4. 通过板载 ST-LINK 下载固件,复位后观察 LD2。
  5. 在 GPIOA_BSRR 写入语句处设置断点,单步执行并查看相关寄存器。

预期结果:执行 BSRR 置位写操作后,板载绿色用户 LED LD2 持续点亮。由于程序没有发送串口消息,因此不会产生约定的控制台输出。

如果使用 GDB 调试,可在程序停住时执行下面的寄存器读取命令:

text
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。

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。这套方法也能用于继电器控制信号、片选引脚和其他简单数字输出,但需要按目标硬件重新核对引脚映射与电气要求。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置 GPIO 输出点亮板载 LED

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通