4. GPIO HAL层设计：从基础到中断回调

GPIO，说白了就是芯片的“手脚”。你要让LED亮，要读按键状态，要输出一个控制信号——全得靠它。我刚开始做嵌入式那会儿，觉得GPIO太简单了，不就是置1清0嘛。直到有一次，一个项目因为GPIO模式没配好，整块板子在上电瞬间就短路了……嗯，从那以后，我对GPIO的敬畏心就上来了。

这一章，我们就把GPIO的HAL层设计讲透。从最基础的概念，到接口定义，再到中断回调的实现，一条线串下来。

4.1 GPIO基础概念

GPIO是General-Purpose Input/Output的缩写。每个引脚可以独立配置成输入、输出，或者复用为其他外设功能。但HAL层要做的，是把这些硬件细节封装好，让上层应用不用关心寄存器地址。

我个人习惯把GPIO的关键属性归纳为四类：

属性	说明	典型值
方向	输入还是输出	INPUT / OUTPUT
电平	引脚当前电压状态	HIGH / LOW
模式	推挽、开漏、上拉、下拉等	PUSH_PULL / OPEN_DRAIN
中断	是否触发中断、触发方式	RISING / FALLING / BOTH

你想想看，如果HAL层把这四样东西封装好了，上层应用写起来是不是就清爽多了？

4.2 HAL_GPIO接口定义

接口设计是HAL层的灵魂。我见过太多项目，GPIO接口定义得五花八门，最后维护起来简直要命。我的原则是：接口要少，语义要清。

下面是我在多个项目中沉淀下来的一套GPIO HAL接口：

/* 初始化结构体 */
typedef struct {
    uint32_t        pin;        /* 引脚号，支持按位或 */
    uint8_t         mode;       /* 输入/输出/复用/模拟 */
    uint8_t         pull;       /* 上拉/下拉/浮空 */
    uint8_t         speed;      /* 低速/中速/高速 */
    uint8_t         alternate;  /* 复用功能编号 */
} HAL_GPIO_InitTypeDef;

/* 核心接口 */
void        HAL_GPIO_Init(GPIO_TypeDef* port, HAL_GPIO_InitTypeDef* init);
void        HAL_GPIO_DeInit(GPIO_TypeDef* port, uint32_t pin);
HAL_Status  HAL_GPIO_WritePin(GPIO_TypeDef* port, uint32_t pin, uint8_t state);
uint8_t     HAL_GPIO_ReadPin(GPIO_TypeDef* port, uint32_t pin);
void        HAL_GPIO_TogglePin(GPIO_TypeDef* port, uint32_t pin);

/* 中断相关 */
HAL_Status  HAL_GPIO_EnableInterrupt(GPIO_TypeDef* port, uint32_t pin, uint8_t trigger);
HAL_Status  HAL_GPIO_DisableInterrupt(GPIO_TypeDef* port, uint32_t pin);
void        HAL_GPIO_IRQHandler(uint16_t pin);

4.3 输入输出模式配置

模式配置是GPIO HAL层里最容易出坑的地方。我记得有一次，一个同事把推挽输出配成了开漏输出，结果I2C总线死活拉不低。排查了一整天，最后发现是模式配错了。

常见的GPIO模式有这些：

模式	典型用途	注意事项
推挽输出	驱动LED、普通数字信号	高电平由VDD提供，低电平由GND吸收
开漏输出	I2C、多设备共享总线	必须外接上拉电阻
浮空输入	外部有明确驱动源的信号	引脚悬空时电平不确定
上拉输入	按键检测（按下为低）	内部上拉电阻约40kΩ
下拉输入	按键检测（按下为高）	内部下拉电阻约40kΩ

在HAL层实现时，我建议把模式配置做成一个统一的入口。比如这样：

void HAL_GPIO_Init(GPIO_TypeDef* port, HAL_GPIO_InitTypeDef* init) {
    uint32_t position = 0;
    uint32_t iopos = 0;

    for (position = 0; position < 16; position++) {
        iopos = 0x01 << position;
        if (init->pin & iopos) {
            /* 配置模式寄存器 */
            MODIFY_REG(port->MODER, 
                       (0x03 << (position * 2)),
                       (init->mode << (position * 2)));

            /* 配置上下拉寄存器 */
            MODIFY_REG(port->PUPDR,
                       (0x03 << (position * 2)),
                       (init->pull << (position * 2)));

            /* 配置输出速度 */
            MODIFY_REG(port->OSPEEDR,
                       (0x03 << (position * 2)),
                       (init->speed << (position * 2)));
        }
    }
}

4.4 中断与回调实现

GPIO中断是嵌入式系统里最常用的异步事件处理方式。但HAL层怎么设计中断，直接决定了上层代码的优雅程度。

我见过最糟糕的做法：在中断服务函数里直接写业务逻辑。结果中断里调了printf，系统直接卡死。正确的做法是：中断只做标记，回调里做处理。

下面是我常用的中断回调框架：

/* 回调函数指针数组 */
static void (*gpio_callback[16])(void) = {NULL};

/* 注册回调 */
HAL_Status HAL_GPIO_RegisterCallback(uint32_t pin, void (*callback)(void)) {
    uint32_t index = 0;
    while (pin >> index) {
        index++;
    }
    gpio_callback[index] = callback;
    return HAL_OK;
}

/* 中断服务函数（在启动文件中调用） */
void HAL_GPIO_IRQHandler(uint16_t pin) {
    uint32_t index = 0;

    /* 清除中断标志 */
    EXTI->PR = (1 << pin);

    /* 查找并执行回调 */
    while (pin >> index) {
        index++;
    }
    if (gpio_callback[index] != NULL) {
        gpio_callback[index]();
    }
}

中断触发方式的选择也很关键：

• 上升沿触发： 适合检测信号从低到高的跳变，比如按键松开
• 下降沿触发： 适合检测信号从高到低的跳变，比如按键按下
• 双边沿触发： 适合编码器信号，两个方向都要检测
• 低电平触发： 适合外部唤醒，只要引脚为低就触发

我个人习惯在HAL层提供一个统一的配置接口，把触发方式作为参数传进去。这样上层应用不用关心底层寄存器怎么配。

4.5 知识结构总览

下面这张图，把GPIO HAL层的核心脉络画出来了。你可以把它当作本章的“地图”。

这张图把GPIO HAL层的四个核心模块和它们的子项都列出来了。你可以看到，每个模块之间是独立的，但通过统一的接口串联在一起。这就是HAL层的精髓——高内聚、低耦合。