4、GPIO抽象层：GPIO的通用接口设计，输入输出模式配置，中断注册与管理

好，咱们今天聊聊GPIO抽象层。说实话，这是嵌入式系统里最基础、也最容易出幺蛾子的部分。你想想看，一个POS机主板上，少说几十个GPIO，多的上百个。按键、指示灯、读卡器状态、打印机检测……全得靠它们。要是每个外设都直接操作寄存器，那代码基本就废了——换个芯片平台，全得重写。

我个人的习惯是，从一开始就把GPIO抽象成一个独立的层。说白了，就是给上层应用一个统一的接口，底层怎么实现，那是我的事。这样，上层工程师写代码时，根本不用关心这个引脚是挂在STM32上还是全志芯片上。

4.1 GPIO通用接口设计

先说说接口长什么样。我见过很多团队，GPIO接口定义得五花八门。有的用枚举，有的用宏，有的直接传数字。我的建议是：统一用结构体，把引脚号、端口、属性全包进去。

/* GPIO抽象接口结构体 */
typedef struct {
    uint8_t port;      /* 端口号，如GPIOA=0, GPIOB=1 */
    uint8_t pin;       /* 引脚号，0~15 */
    uint8_t mode;      /* 模式：输入、输出、复用、模拟 */
    uint8_t pull;      /* 上下拉：无、上拉、下拉 */
    uint8_t speed;     /* 速度：低速、中速、高速 */
    uint8_t alt_func;  /* 复用功能编号 */
} gpio_cfg_t;

/* 通用接口函数 */
int gpio_init(gpio_cfg_t *cfg);
int gpio_set_level(uint8_t port, uint8_t pin, uint8_t level);
int gpio_get_level(uint8_t port, uint8_t pin);
int gpio_toggle(uint8_t port, uint8_t pin);

嗯，这里要注意。返回值一定要统一。我习惯用0表示成功，负数表示错误码。别搞什么返回布尔值，那样调试起来太痛苦。我在项目中遇到过，有人把返回0当成失败，结果排查了整整一下午。

4.2 输入输出模式配置

输入输出模式，听起来简单吧？其实坑不少。我见过最典型的错误，就是配置输出模式时忘了设置初始电平。结果一上电，引脚先拉高再拉低，外设直接误动作。

我的做法是：配置输出模式时，强制要求传入初始电平。代码里这样写：

int gpio_set_output(gpio_cfg_t *cfg, uint8_t init_level) {
    /* 先设置输出数据寄存器 */
    gpio_set_level(cfg->port, cfg->pin, init_level);
    /* 再配置模式寄存器 */
    gpio_set_mode(cfg->port, cfg->pin, GPIO_MODE_OUTPUT);
    return 0;
}

顺序很重要。先写数据，再改模式。这样引脚切换时不会产生毛刺。我曾经在一个POS机的电源控制引脚上吃过这个亏——每次开机瞬间，读卡器都会异常复位。后来发现就是配置顺序反了。

输入模式也有讲究。尤其是按键检测，一定要配置上拉或下拉。你想想看，引脚悬空时电平是浮动的，读出来的数据完全随机。我建议：

• 按键接GND的，配置内部上拉
• 按键接VCC的，配置内部下拉
• 实在搞不清的，外部加10k电阻最稳妥

4.3 中断注册与管理

中断这块，是GPIO抽象层的重头戏。POS机里很多操作都依赖中断——按键按下、刷卡触发、打印机状态变化……中断处理不好，整个系统就卡死了。

我设计的抽象层，中断接口长这样：

/* 中断回调函数类型 */
typedef void (*gpio_isr_cb_t)(void *arg);

/* 中断配置结构体 */
typedef struct {
    uint8_t port;
    uint8_t pin;
    uint8_t trigger;   /* 触发方式：上升沿、下降沿、双边沿、低电平、高电平 */
    gpio_isr_cb_t callback;
    void *arg;
    uint8_t priority;  /* 中断优先级 */
} gpio_irq_cfg_t;

/* 中断接口 */
int gpio_irq_register(gpio_irq_cfg_t *irq_cfg);
int gpio_irq_unregister(uint8_t port, uint8_t pin);
int gpio_irq_enable(uint8_t port, uint8_t pin);
int gpio_irq_disable(uint8_t port, uint8_t pin);

这里有个关键点：中断回调函数里不能做耗时操作。我见过有人直接在中断里调用printf，结果系统直接崩溃。为什么？因为printf可能涉及互斥锁，而中断里不能加锁。

我的建议是：中断回调只做两件事——设置标志位，或者唤醒一个任务。具体处理逻辑放到任务上下文里做。比如：

/* 按键中断回调 */
void key_isr_handler(void *arg) {
    /* 只设置标志位，不做具体处理 */
    g_key_pressed = 1;
    /* 唤醒按键处理任务 */
    os_task_wakeup(&g_key_task);
}

另外，中断优先级也要小心。POS机里，一般把读卡器中断设成最高优先级，按键中断次之，其他外设再低一些。优先级设置不当，会导致高优先级中断被低优先级中断阻塞，这在实时系统中是致命的。

我习惯用一个表格来管理所有中断资源：

引脚	功能	触发方式	优先级	回调函数
PA0	按键1	下降沿	2	key1_isr
PB3	读卡器	上升沿	1	card_isr
PC7	打印机	电平触发	3	printer_isr

这个表格我建议放在代码注释里，或者做成一个配置文件。每次新增中断，先查表，避免冲突。我曾经因为两个中断共用一个引脚，排查了整整两天——后来发现是硬件设计时没注意引脚复用。

最后说一句，GPIO抽象层不是一蹴而就的。你刚开始可能只写了几个基本接口，随着项目推进，慢慢会发现需要加批量操作、需要加去抖处理、需要加电源管理。没关系，接口设计时留好扩展点就行。我现在的GPIO抽象层，已经迭代了十几个版本，但核心接口从来没变过——这就是抽象的魅力。