📚 课程目录第3章 GPIO驱动与BSP板级抽象

3. GPIO驱动与BSP板级抽象

GPIO 是 STM32 与外部世界最基础的接口，但“会点灯”和“能交付稳定的 BSP”之间差距很大。本节围绕四件事展开：输入输出模式与上下拉/开漏配置、寄存器与 HAL 库两种操作方式的取舍、按键消抖的工程实现，以及把 LED 与按键封装成可复用 BSP 接口。

一、GPIO 的电气结构决定了配置方式

STM32 的每个 GPIO 引脚内部大致包含：输出驱动器（P-MOS 与 N-MOS 组成推挽对）、输入施密特触发器、可选的上拉/下拉电阻，以及复用功能选择开关。理解这条信号链，配置就不会靠背。

输出模式有四种：推挽输出由上下管互补驱动，能主动输出高、低电平，驱动能力强，适合 LED、片选、普通数字输出；开漏输出只保留下管，只能主动拉低，高电平需外部上拉电阻提供，适合 I²C 这类多设备共享总线，也常用于电平转换；复用推挽/复用开漏则把引脚控制权交给片上外设（如 USART、SPI、I²C），此时写 ODR 无效。

输入模式有：浮空输入（无内部上下拉，电平由外部决定，悬空时读数随机）、上拉输入、下拉输入、模拟输入（关闭施密特触发器，供 ADC/DAC 使用）。按键一端接引脚、另一端接 GND 时，应配上拉输入，按下读到 0，松开读到 1；若按键接 VCC，则配下拉输入，逻辑相反。这个“按下电平”的约定必须在原理图、代码和注释中保持一致，否则排障时极易误判。

开漏输出必须外接上拉电阻，阻值影响上升沿速度：I²C 标准模式（100 kHz）常用 4.7 kΩ，快速模式（400 kHz）常用 2.2 kΩ～4.7 kΩ。阻值过大上升沿变缓，过小则灌电流增大。这是参数关系，不是随意取值。

二、寄存器与 HAL 库：两种操作方式的取舍

以 PA5 推挽输出为例，寄存器方式需要依次使能时钟、配置 MODER、设置 OTYPER/OSPEEDR/PUPDR，再写 BSRR 输出电平：

RCC->AHB1ENR |= (1U << 0);          // 使能 GPIOA 时钟
GPIOA->MODER &= ~(3U << (5*2));    // 清 PA5 模式位
GPIOA->MODER |=  (1U << (5*2));    // 通用输出
GPIOA->OTYPER &= ~(1U << 5);       // 推挽
GPIOA->OSPEEDR |= (2U << (5*2));   // 中速
GPIOA->PUPDR &= ~(3U << (5*2));    // 无上下拉
GPIOA->BSRR = (1U << 5);           // 置高（原子操作）
GPIOA->BSRR = (1U << (5+16));      // 置低

HAL 方式等价写法：

__HAL_RCC_GPIOA_CLK_ENABLE();
GPIO_InitTypeDef g = {0};
g.Pin   = GPIO_PIN_5;
g.Mode  = GPIO_MODE_OUTPUT_PP;
g.Pull  = GPIO_NOPULL;
g.Speed = GPIO_SPEED_FREQ_MEDIUM;
HAL_GPIO_Init(GPIOA, &g);
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);

两者差异在于：寄存器直接、代码量小、执行快，但可读性和可移植性差；HAL 可读、跨系列移植方便，但函数调用有开销，且 HAL_GPIO_WritePin 内部是读改写，多任务下不如 BSRR 原子。工程上常见做法是初始化用 HAL，高频翻转用 BSRR 宏。注意 BSRR 低 16 位置位、高 16 位复位，写 1 有效、写 0 无影响，因此天然避免竞态。

三、按键消抖：从现象到实现

机械按键在闭合与断开瞬间会产生 5～20 ms 的抖动，表现为电平快速跳变。若直接在主循环里读 IDR，一次按下可能被识别成多次。消抖有硬件（RC 滤波、专用芯片）和软件两条路，软件更常用。

推荐做法是定时扫描 + 状态机：每 10 ms 调用一次扫描函数，连续两次读到相同电平才确认状态变化。示例参数：扫描周期 10 ms，确认次数 2 次，即约 20 ms 稳定判定；长按阈值设为 1000 ms。伪代码如下：

void Key_Scan(void) {
    uint8_t now = HAL_GPIO_ReadPin(KEY_PORT, KEY_PIN); // 上拉：按下=0
    if (now != key_last) { key_cnt = 0; key_last = now; return; }
    if (key_cnt < 2) { key_cnt++; return; }
    if (now == 0 && key_state == 1) { key_state = 0; Key_OnPress(); }
    if (now == 1 && key_state == 0) { key_state = 1; Key_OnRelease(); }
}

判断依据：按下瞬间读数为 0，松开为 1；若读数在 0/1 间抖动，说明消抖次数不足或扫描周期过短。长按与短按通过按下持续时间区分，超过阈值触发长按事件，松开时若未达阈值则触发短按。

四、LED 与按键的 BSP 接口设计

BSP 的目标是让上层业务不关心引脚号、有效电平和消抖细节。建议接口如下：

BSP_LED_Init()：完成时钟、引脚、模式配置，默认熄灭。
BSP_LED_On(uint8_t idx) / BSP_LED_Off(uint8_t idx) / BSP_LED_Toggle(uint8_t idx)：按逻辑编号操作，内部处理有效电平。
BSP_KEY_Init()：配置上拉输入，初始化状态机。
BSP_KEY_Scan()：由 10 ms 定时器或主循环周期调用。
BSP_KEY_GetEvent(uint8_t idx)：返回 NONE / SHORT / LONG，供业务层消费。

关键设计点：用宏或常量表把“逻辑编号 → 端口/引脚/有效电平”集中管理，例如 LED 低电平点亮时，BSP_LED_On 内部写 0。这样更换硬件只需改一处，业务代码不动。同时，BSP 层不应包含业务逻辑（如“按键控制 LED 闪烁模式”），只提供原子操作和事件，保持可复用性。

调试建议：先用万用表或示波器确认按键按下时引脚确实被拉到 0；若读数始终为 1，检查上拉配置与按键是否真的接地。LED 不亮时，先确认有效电平方向，再查时钟是否使能。

把以上四点串起来，GPIO 就不再是零散的函数调用，而是一条从电气特性到板级接口的完整链路：配置决定电气行为，操作方式决定性能与可维护性，消抖决定输入可靠性，BSP 接口决定工程可复用性。