3. GPIO外设抽象：GPIO标准接口定义、寄存器操作封装、中断回调机制

GPIO 这玩意儿，说简单是真简单——不就是拉高拉低、读个电平吗？但说复杂也真复杂。我见过太多项目，前期 GPIO 接口写得随意，到了后期移植或者调试中断的时候，改得想哭。说白了，GPIO 是 MCU 和外界打交道的「手」，这双手要是没抽象好，整个系统都别扭。

这一章，我们就来聊聊怎么把这双手「包装」得既好用又通用。

3.1 GPIO标准接口定义：让上层代码「忘记」芯片型号

我刚开始做 HAL 层的时候，犯过一个错：把某个芯片的 GPIO 寄存器结构体直接暴露给了应用层。结果换芯片的时候，应用层代码几乎重写。后来我学乖了——接口必须抽象。

一个合格的 GPIO 抽象层，至少得提供这几类操作：

• 初始化/反初始化：配置引脚方向、上下拉、驱动能力
• 电平读写：设置输出高/低，读取输入电平
• 中断配置：触发边沿、使能/屏蔽、清除标志
• 回调注册：把中断服务函数和具体引脚绑定

我个人习惯用结构体封装这些接口，像这样：

/* gpio_hal.h */
typedef struct {
    void (*init)(gpio_pin_t pin, gpio_cfg_t *cfg);
    void (*deinit)(gpio_pin_t pin);
    void (*write)(gpio_pin_t pin, uint8_t level);
    uint8_t (*read)(gpio_pin_t pin);
    void (*toggle)(gpio_pin_t pin);
    void (*irq_enable)(gpio_pin_t pin, gpio_irq_trigger_t trigger);
    void (*irq_disable)(gpio_pin_t pin);
    void (*irq_clear)(gpio_pin_t pin);
    void (*irq_register)(gpio_pin_t pin, gpio_irq_callback_t cb);
} gpio_hal_t;

你看，上层代码只需要知道 gpio_hal_t 这个结构体，根本不用关心底层寄存器长什么样。换芯片？换个实现文件就行。

3.2 寄存器操作封装：从「裸写」到「安全」

寄存器操作是 HAL 层最底层的活。我见过有人直接在应用层写 *(volatile uint32_t *)0x40020C14 |= (1 << 5);——嗯，这种代码我称之为「定时炸弹」。可读性差、容易写错、还不好调试。

我的做法是：用宏或内联函数封装寄存器访问。

/* gpio_reg.h */
#define GPIO_BASE(port)         (GPIOA_BASE + (port) * 0x400)

#define GPIO_MODER(port)        (*(volatile uint32_t *)(GPIO_BASE(port) + 0x00))
#define GPIO_OTYPER(port)       (*(volatile uint32_t *)(GPIO_BASE(port) + 0x04))
#define GPIO_OSPEEDR(port)      (*(volatile uint32_t *)(GPIO_BASE(port) + 0x08))
#define GPIO_PUPDR(port)        (*(volatile uint32_t *)(GPIO_BASE(port) + 0x0C))
#define GPIO_IDR(port)          (*(volatile uint32_t *)(GPIO_BASE(port) + 0x10))
#define GPIO_ODR(port)          (*(volatile uint32_t *)(GPIO_BASE(port) + 0x14))
#define GPIO_BSRR(port)         (*(volatile uint32_t *)(GPIO_BASE(port) + 0x18))
#define GPIO_AFRL(port)         (*(volatile uint32_t *)(GPIO_BASE(port) + 0x20))
#define GPIO_AFRH(port)         (*(volatile uint32_t *)(GPIO_BASE(port) + 0x24))

然后写操作函数时，用位操作宏来修改：

static inline void gpio_set_output(gpio_pin_t pin) {
    uint8_t port = (pin >> 8) & 0xFF;
    uint8_t num  = pin & 0xFF;
    uint32_t reg = GPIO_MODER(port);
    reg &= ~(0x3 << (num * 2));
    reg |=  (0x1 << (num * 2));  // 设置为输出模式
    GPIO_MODER(port) = reg;
}

为什么要这么麻烦？因为：

• 可读性：一看就知道是在操作 MODER 寄存器
• 可移植性：换芯片只需要改宏定义
• 安全性：用内联函数可以加参数检查

3.3 中断回调机制：让中断处理「优雅」起来

中断回调是 GPIO 抽象里最容易出幺蛾子的地方。为什么？因为中断服务函数（ISR）里不能做太多事，但应用层又希望能在中断里执行复杂逻辑。

我的方案是：注册回调函数 + 中断下半部处理。

先定义一个回调函数指针类型：

typedef void (*gpio_irq_callback_t)(void *arg);

然后在 HAL 层维护一个回调表：

typedef struct {
    gpio_irq_callback_t callback;
    void *arg;
    uint8_t enabled;
} gpio_irq_entry_t;

static gpio_irq_entry_t irq_table[GPIO_IRQ_MAX];

用户注册回调：

void gpio_irq_register(gpio_pin_t pin, gpio_irq_callback_t cb, void *arg) {
    uint8_t idx = pin_to_irq_index(pin);
    irq_table[idx].callback = cb;
    irq_table[idx].arg = arg;
    irq_table[idx].enabled = 1;
}

中断服务函数里只做一件事——查表调用：

void GPIO_IRQHandler(void) {
    uint32_t pending = GPIO_GetPending();
    for (int i = 0; i < GPIO_IRQ_MAX; i++) {
        if (pending & (1 << i)) {
            if (irq_table[i].enabled && irq_table[i].callback) {
                irq_table[i].callback(irq_table[i].arg);
            }
            GPIO_ClearPending(i);
        }
    }
}

这样做的好处很明显：

• 解耦：ISR 不关心具体业务逻辑
• 灵活：运行时可以动态注册/注销回调
• 可测试：回调函数可以单独单元测试

3.4 整体架构：一张图看懂 GPIO 抽象层

说了这么多，我们来画一张架构图，把 GPIO 抽象层的层次关系理清楚。

3.5 接口对比：不同抽象层次的「颗粒度」

你可能要问：抽象到什么程度才算「够」？我整理了一个对比表，帮你快速判断：

我个人推荐大多数项目用「函数接口」或「结构体虚表」层次。前者性能好，后者灵活度高。至于裸寄存器——嗯，除非你是在写汇编级别的代码，否则别碰。

3.6 实战经验：中断回调的「坑」与「填」

最后分享几个我在项目中踩过的坑：

• 回调函数重入问题：如果同一个引脚的中断在回调执行期间再次触发，怎么办？我的做法是在回调执行前屏蔽该引脚中断，执行完再恢复。
• 回调表大小：不要用动态分配。我一般根据芯片最大中断引脚数，在编译时静态分配数组。
• 中断优先级：GPIO 中断优先级不要设得太高，否则会阻塞其他关键中断。我通常设为中等优先级。

好了，GPIO 抽象层的内容就聊到这儿。记住：好的抽象，是让上层代码「感觉不到」底层变化。你做到了这一点，GPIO 这块就算真正拿下了。