第3章：GPIO驱动框架设计——标准API定义、输入输出模式、中断配置

GPIO，说白了就是单片机的“手脚”。你让它高它就高，让它低它就低。但真正做产品时，你会发现事情没那么简单。我见过太多项目，GPIO驱动写得乱七八糟——有的直接操作寄存器，有的用宏定义绕来绕去，换一个芯片型号就得重写大半。

这一章，我们就来聊聊怎么设计一套通用的GPIO驱动框架。这套框架我在三个不同架构的MCU上验证过，效果还不错。

3.1 标准API定义——让驱动“长一个样”

先问一个问题：你手上有STM32、GD32、AT32三个板子，GPIO初始化代码能共用吗？答案是不能。但如果我们定义一套标准API，底层实现各自封装，上层应用代码就可以完全不变。

我个人习惯把GPIO驱动分成三层：

• 硬件抽象层（HAL）：直接操作寄存器，与MCU强相关
• 驱动接口层（DAL）：定义标准函数原型，与MCU无关
• 应用调用层（APL）：业务逻辑，只调用DAL接口

下面是我常用的标准API定义：

/* gpio_interface.h */
#ifndef __GPIO_INTERFACE_H__
#define __GPIO_INTERFACE_H__

#include <stdint.h>

/* GPIO引脚号枚举 */
typedef enum {
    GPIO_PIN_0  = 0,
    GPIO_PIN_1  = 1,
    /* ... 省略中间引脚 ... */
    GPIO_PIN_15 = 15,
    GPIO_PIN_ALL = 16
} gpio_pin_t;

/* GPIO模式枚举 */
typedef enum {
    GPIO_MODE_INPUT         = 0x00,
    GPIO_MODE_OUTPUT_PP     = 0x01,  /* 推挽输出 */
    GPIO_MODE_OUTPUT_OD     = 0x02,  /* 开漏输出 */
    GPIO_MODE_AF_PP         = 0x03,  /* 复用推挽 */
    GPIO_MODE_AF_OD         = 0x04,  /* 复用开漏 */
    GPIO_MODE_ANALOG        = 0x05,  /* 模拟模式 */
    GPIO_MODE_IT_RISING     = 0x06,  /* 上升沿中断 */
    GPIO_MODE_IT_FALLING    = 0x07,  /* 下降沿中断 */
    GPIO_MODE_IT_BOTH       = 0x08   /* 双边沿中断 */
} gpio_mode_t;

/* 上下拉配置 */
typedef enum {
    GPIO_PULL_NONE  = 0,
    GPIO_PULL_UP    = 1,
    GPIO_PULL_DOWN  = 2
} gpio_pull_t;

/* 输出速度 */
typedef enum {
    GPIO_SPEED_LOW    = 0,
    GPIO_SPEED_MEDIUM = 1,
    GPIO_SPEED_HIGH   = 2,
    GPIO_SPEED_VERY_HIGH = 3
} gpio_speed_t;

/* GPIO配置结构体 */
typedef struct {
    gpio_pin_t      pin;
    gpio_mode_t     mode;
    gpio_pull_t     pull;
    gpio_speed_t    speed;
    uint8_t         alternate;  /* 复用功能编号 */
} gpio_config_t;

/* 标准API函数声明 */
void        gpio_init(gpio_config_t *config);
void        gpio_deinit(gpio_config_t *config);
void        gpio_write_pin(gpio_pin_t pin, uint8_t level);
uint8_t     gpio_read_pin(gpio_pin_t pin);
void        gpio_toggle_pin(gpio_pin_t pin);
void        gpio_set_interrupt(gpio_pin_t pin, gpio_mode_t trigger, void (*callback)(void));
void        gpio_clear_interrupt(gpio_pin_t pin);

#endif /* __GPIO_INTERFACE_H__ */

3.2 输入输出模式——不只是“读”和“写”

GPIO输入输出，听起来简单。但我在项目中遇到过一个问题：按键检测时，引脚悬空导致电平乱跳。后来加了内部上拉才解决。这就是输入模式配置的重要性。

3.2.1 输入模式配置

输入模式有几种变体，我整理了一个表格：

输入模式	典型应用	注意事项
浮空输入	外部信号由强驱动源驱动	引脚悬空时电平不确定，慎用
上拉输入	按键、机械开关	默认高电平，按下拉低
下拉输入	光敏传感器、霍尔元件	默认低电平，触发拉高
模拟输入	ADC采样	关闭数字功能，降低功耗

实际写代码时，我习惯这样初始化输入引脚：

/* 按键初始化示例 */
void key_init(void)
{
    gpio_config_t cfg;
    
    cfg.pin     = GPIO_PIN_0;
    cfg.mode    = GPIO_MODE_INPUT;
    cfg.pull    = GPIO_PULL_UP;    /* 内部上拉，省外部电阻 */
    cfg.speed   = GPIO_SPEED_LOW;  /* 输入不需要高速 */
    cfg.alternate = 0;
    
    gpio_init(&cfg);
}

/* 读取按键状态 */
uint8_t key_get_state(void)
{
    /* 低电平表示按下 */
    return (gpio_read_pin(GPIO_PIN_0) == 0) ? 1 : 0;
}

3.2.2 输出模式配置

输出模式也有讲究。推挽输出和开漏输出，很多人搞混。我简单解释一下：

• 推挽输出：可以主动输出高电平和低电平。驱动能力强，适合LED、蜂鸣器。
• 开漏输出：只能主动输出低电平，高电平要靠外部上拉。适合I2C总线、多设备共享线路。

举个例子，驱动一个LED：

/* LED初始化 */
void led_init(void)
{
    gpio_config_t cfg;
    
    cfg.pin     = GPIO_PIN_1;
    cfg.mode    = GPIO_MODE_OUTPUT_PP;  /* 推挽输出 */
    cfg.pull    = GPIO_PULL_NONE;       /* 输出不需要上拉 */
    cfg.speed   = GPIO_SPEED_LOW;       /* LED不需要高速 */
    cfg.alternate = 0;
    
    gpio_init(&cfg);
    gpio_write_pin(GPIO_PIN_1, 0);      /* 初始关闭 */
}

/* 点亮LED */
void led_on(void)
{
    gpio_write_pin(GPIO_PIN_1, 1);
}

/* 熄灭LED */
void led_off(void)
{
    gpio_write_pin(GPIO_PIN_1, 0);
}

/* 翻转LED */
void led_toggle(void)
{
    gpio_toggle_pin(GPIO_PIN_1);
}

3.3 中断配置——别让CPU“空转”

轮询方式读取GPIO，CPU一直在空转。中断方式才是正经做法。但中断配置有几个坑，我一个个说。

3.3.1 中断触发方式选择

触发方式	适用场景	潜在问题
上升沿触发	信号从低到高跳变	信号抖动可能误触发
下降沿触发	信号从高到低跳变	同上，需硬件去抖或软件滤波
双边沿触发	编码器、脉冲计数	中断频率可能过高
低电平触发	紧急停止、报警信号	电平持续会反复触发
高电平触发	唤醒信号	同上

3.3.2 中断服务函数设计

中断服务函数（ISR）有个铁律：快进快出。不要在ISR里做复杂运算，更不要调用延时函数。我见过有人在ISR里用delay_ms(100)，结果整个系统卡死。

正确的做法是：ISR里只设置标志位，主循环里处理业务。

/* 中断回调函数注册 */
void gpio_set_interrupt(GPIO_PIN_0, GPIO_MODE_IT_FALLING, key_isr_callback);

/* 中断服务函数（由底层HAL在中断向量表中调用） */
static volatile uint8_t key_pressed_flag = 0;

void key_isr_callback(void)
{
    /* 只设置标志，不做任何耗时操作 */
    key_pressed_flag = 1;
    
    /* 如果需要，可以在这里清中断标志 */
    gpio_clear_interrupt(GPIO_PIN_0);
}

/* 主循环中处理 */
void main_loop(void)
{
    while(1)
    {
        if(key_pressed_flag)
        {
            key_pressed_flag = 0;
            /* 在这里处理按键业务，可以放心延时 */
            handle_key_press();
        }
        
        /* 其他任务... */
    }
}

3.4 GPIO驱动框架整体结构

说了这么多，我们来看一下完整的框架结构。下面这张SVG图展示了各层之间的关系：

3.5 多MCU移植实战

最后，我分享一下这套框架在不同MCU上的移植经验。以初始化函数为例：

MCU平台	HAL层实现差异	DAL层代码
STM32F4	操作GPIOx->MODER, PUPDR, OTYPER等寄存器	完全一致，无需修改
GD32F3	操作GPIOx_CTL, GPIOx_PUD等寄存器（命名不同）
AT32F4	操作GPIOx->MODE, GPIOx->PULL等寄存器（位偏移不同）

你看，只要DAL接口定义得好，换MCU只需要重写HAL层。我上次从STM32F4换到GD32F3，只花了半天就完成了移植。上层应用代码一行没改。

嗯，GPIO驱动框架的核心内容就这些。记住：好的框架设计，不是为了炫技，而是为了让你在下一个项目中少掉头发。