4. GPIO HAL 层封装：从寄存器到接口的实战蜕变

GPIO，说白了就是芯片的「手脚」。你要让灯亮、要检测按键按下、要跟外设做简单的握手，都得靠它。我做了这么多年驱动，GPIO 是打交道最多的外设，没有之一。

这一章，我们就把 GPIO 的 HAL 层封装彻底讲透。从基础概念到接口设计，再到典型应用，一条线串下来。

4.1 GPIO 基础概念回顾

在动手封装之前，有些东西得先理清楚。GPIO 的基本操作无非就是：输入、输出、中断。但每个模式底下还有细分。

模式 说明 典型场景
推挽输出 可以输出高/低电平，驱动能力强 LED 控制、蜂鸣器
开漏输出 只能拉低，高电平靠外部上拉 I2C 总线、多设备共享线
浮空输入 电平由外部决定，内部无上下拉 外部中断检测
上拉/下拉输入 内部有弱上拉或弱下拉 按键检测（防抖动辅助）
模拟模式 GPIO 作为 ADC 输入 模拟信号采集
复用功能 GPIO 交给片上外设控制 UART、SPI、PWM

嗯，这里要注意：复用功能虽然也走 GPIO 引脚，但控制权已经不在 GPIO 模块手里了。HAL 层封装时，我们通常只封装纯 GPIO 操作，复用功能留给具体外设的 HAL 去管。

核心原则：HAL 层只做「通用抽象」，不做「功能耦合」。GPIO 的 HAL 接口，只关心引脚的电平读写、方向配置、中断回调。至于这个引脚接了 LED 还是按键，那是应用层的事。

4.2 HAL_GPIO_Init / HAL_GPIO_DeInit 接口设计

这两个接口是 GPIO 的「开关」。Init 负责配置，DeInit 负责恢复。

我个人习惯把配置参数打包成一个结构体，这样扩展性好，也方便移植。

/* GPIO 配置结构体 */
typedef struct {
    uint32_t Pin;           /* 引脚号，支持按位或 */
    uint32_t Mode;          /* 输入/输出/复用/模拟 */
    uint32_t Pull;          /* 上拉/下拉/无 */
    uint32_t Speed;         /* 输出速度：低速/中速/高速 */
    uint32_t Alternate;     /* 复用功能编号 */
} GPIO_InitTypeDef;

/* 初始化接口 */
HAL_StatusTypeDef HAL_GPIO_Init(GPIO_TypeDef *GPIOx, GPIO_InitTypeDef *Init)
{
    /* 1. 参数校验 */
    if (GPIOx == NULL || Init == NULL) return HAL_ERROR;

    /* 2. 锁定 GPIO 端口时钟（不同 MCU 实现不同） */
    __HAL_RCC_GPIO_CLK_ENABLE(GPIOx);

    /* 3. 配置模式、上下拉、速度、复用功能 */
    /* 这里操作寄存器，不同芯片寄存器布局不同 */
    /* 以 STM32 为例：MODER, PUPDR, OSPEEDR, AFR 等 */

    /* 4. 如果是输出模式，设置初始电平（可选） */
    if (Init->Mode == GPIO_MODE_OUTPUT_PP) {
        HAL_GPIO_WritePin(GPIOx, Init->Pin, GPIO_PIN_RESET);
    }

    return HAL_OK;
}

/* 反初始化接口 */
HAL_StatusTypeDef HAL_GPIO_DeInit(GPIO_TypeDef *GPIOx, uint32_t Pin)
{
    /* 1. 将指定引脚恢复为默认状态（通常是模拟输入） */
    /* 2. 关闭中断（如果有） */
    /* 3. 清除挂起标志 */
    return HAL_OK;
}

避坑指南：我曾经在一个项目里，DeInit 只清了寄存器，忘了关中断。结果引脚电平变了，中断标志还挂着，一使能又触发一次。后来我养成了习惯：DeInit 里一定要 NVIC_DisableIRQ + NVIC_ClearPendingIRQ 一起做。

4.3 HAL_GPIO_WritePin / HAL_GPIO_ReadPin 接口设计

这两个接口最基础，也最容易踩坑。写引脚要保证原子操作，读引脚要注意电平稳定。

/* 写引脚 */
void HAL_GPIO_WritePin(GPIO_TypeDef *GPIOx, uint16_t Pin, GPIO_PinState PinState)
{
    if (PinState == GPIO_PIN_SET) {
        GPIOx->BSRR = Pin;   /* 置位寄存器，只写 1 有效 */
    } else {
        GPIOx->BRR  = Pin;   /* 复位寄存器，只写 1 有效 */
    }
}

/* 读引脚 */
GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef *GPIOx, uint16_t Pin)
{
    return (GPIO_PinState)((GPIOx->IDR & Pin) ? GPIO_PIN_SET : GPIO_PIN_RESET);
}

你想想看，为什么写引脚要用 BSRR/BRR 而不是直接写 ODR？因为直接写 ODR 不是原子操作，在多任务或中断环境下可能出问题。BSRR 和 BRR 是硬件级别的原子操作，一次写入只影响指定引脚。

注意：有些低端 MCU 没有 BSRR/BRR 寄存器，只能用 ODR 加读-改-写。这时候就要关中断保护临界区。移植 HAL 层时，这个差异必须处理。

4.4 HAL_GPIO_TogglePin / HAL_GPIO_EXTI_Callback 接口设计

Toggle 接口很简单，但很实用。EXTI 回调是中断处理的核心。

/* 翻转引脚 */
void HAL_GPIO_TogglePin(GPIO_TypeDef *GPIOx, uint16_t Pin)
{
    GPIOx->ODR ^= Pin;
}

/* 外部中断回调（弱定义，用户可重写） */
__weak void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
{
    /* 默认空实现，用户在自己的代码里重写 */
}

Toggle 用异或操作，一行搞定。但要注意：如果多个线程或中断同时操作同一个引脚，异或也可能出问题。不过 GPIO 翻转通常只在单一上下文里用，问题不大。

EXTI 回调的设计，我习惯用 __weak 修饰。这样用户不需要改 HAL 源码，直接在自己的 C 文件里定义同名函数就能覆盖。这是 HAL 层「可扩展性」的典型手法。

中断处理流程：

  1. 硬件检测到引脚电平变化，触发 EXTI 中断
  2. 中断服务函数（ISR）调用 HAL_GPIO_EXTI_IRQHandler
  3. 该函数清除中断标志位，然后调用 HAL_GPIO_EXTI_Callback
  4. 用户在自己的回调函数里处理具体业务

4.5 典型应用场景：LED 控制与按键检测

理论讲完了，来两个实战例子。这两个场景几乎每个嵌入式项目都会用到。

4.5.1 LED 控制

/* 初始化 LED 引脚 */
void LED_Init(void)
{
    GPIO_InitTypeDef gpio_init = {0};
    gpio_init.Pin   = GPIO_PIN_5;      /* PA5 */
    gpio_init.Mode  = GPIO_MODE_OUTPUT_PP;
    gpio_init.Pull  = GPIO_NOPULL;
    gpio_init.Speed = GPIO_SPEED_FREQ_LOW;
    HAL_GPIO_Init(GPIOA, &gpio_init);

    /* 初始状态：灭 */
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET);
}

/* LED 闪烁 */
void LED_Blink(void)
{
    HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
    HAL_Delay(500);  /* 延时 500ms */
}

LED 控制没什么难度，但要注意：高电平点亮还是低电平点亮？这取决于硬件电路。如果 LED 接在 VCC 和 GPIO 之间，那就是低电平点亮。HAL 层不关心这个，应用层自己决定。

4.5.2 按键检测

/* 按键初始化（使用外部中断） */
void Key_Init(void)
{
    GPIO_InitTypeDef gpio_init = {0};
    gpio_init.Pin   = GPIO_PIN_0;      /* PA0 */
    gpio_init.Mode  = GPIO_MODE_IT_FALLING;  /* 下降沿触发 */
    gpio_init.Pull  = GPIO_PULLUP;           /* 内部上拉 */
    HAL_GPIO_Init(GPIOA, &gpio_init);

    /* 使能中断（NVIC 配置） */
    HAL_NVIC_SetPriority(EXTI0_IRQn, 2, 0);
    HAL_NVIC_EnableIRQ(EXTI0_IRQn);
}

/* 中断回调 */
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
{
    if (GPIO_Pin == GPIO_PIN_0) {
        /* 按键按下，执行动作 */
        /* 注意：这里不能做耗时操作，建议只设标志位 */
        g_key_pressed = 1;
    }
}

按键抖动：机械按键按下时会有 5-20ms 的抖动。硬件上可以加 RC 滤波，软件上可以做延时消抖。我建议在回调里只设标志，在主循环里做延时消抖判断。不要在中断里直接 delay，那是大忌。

4.6 GPIO HAL 层知识体系

下面这张图，把 GPIO HAL 层的核心脉络画出来了。从配置到读写，再到中断回调，一条线走通。

GPIO HAL 层知识体系 GPIO HAL 层核心接口与流程 HAL_GPIO_Init HAL_GPIO_DeInit GPIO_InitTypeDef HAL_GPIO_WritePin HAL_GPIO_ReadPin HAL_GPIO_TogglePin HAL_GPIO_EXTI_IRQHandler HAL_GPIO_EXTI_Callback 应用层：LED 控制 / 按键检测 / 外部事件 HAL 层只做通用抽象，具体业务逻辑交给应用层

4.7 小结

GPIO 的 HAL 层封装，说难不难，说简单也不简单。关键在于：接口要通用，实现要健壮，移植要方便。我见过很多项目，GPIO 封装得乱七八糟，一个 LED 控制写了三个不同的函数。其实只要把 Init/WritePin/ReadPin/TogglePin/Callback 这五个接口设计好，90% 的场景都能覆盖。

← 上一章 📖 返回目录 下一章 →