4. GPIO驱动封装（下）：中断回调封装、外部中断配置、使用函数指针实现灵活的中件服务注册

上一讲我们把GPIO的基本读写封装好了。这一讲咱们来啃硬骨头——中断。说实话，中断回调的封装是很多初学者觉得“玄学”的地方。我刚开始做项目时，也在这上面栽过跟头。

中断回调封装，说白了就是让硬件中断发生时，能自动调用你写好的处理函数。但怎么封装得灵活、可移植、又不容易出bug？这就是今天要聊的核心。

4.1 外部中断配置：从寄存器到HAL

先看外部中断的硬件基础。STM32的每个GPIO引脚都可以作为外部中断源，但同一时刻，同一组（比如PA0~PG0）只能有一个引脚使能外部中断。这是硬件限制，绕不开。

配置项 说明 典型值
中断线 EXTI0~EXTI15，对应GPIOx的Pin0~Pin15 EXTI0
触发方式 上升沿、下降沿、双边沿 GPIO_MODE_IT_RISING
中断优先级 NVIC分组后的抢占优先级和子优先级 2, 1
中断服务函数 EXTI0_IRQHandler等 由启动文件定义

用HAL库配置外部中断，其实就三步：

  1. 配置GPIO为中断模式——调用HAL_GPIO_Init()，Mode参数选GPIO_MODE_IT_RISING之类的。
  2. 配置NVIC——HAL_NVIC_SetPriority()和HAL_NVIC_EnableIRQ()。
  3. 实现回调函数——重写HAL_GPIO_EXTI_Callback()。

嗯，这里要注意：HAL库的中断处理流程是固定的。它会在EXTI0_IRQHandler里调用HAL_GPIO_EXTI_IRQHandler()，这个函数会清除中断标志位，然后调用HAL_GPIO_EXTI_Callback()。你只需要在回调里写业务逻辑。

核心思路：HAL库把中断的“脏活累活”（清标志位、判断中断源）都干了，留给你的就是一个干净的回调接口。但问题是——这个回调是全局的、弱定义的，一个项目里只能有一个。

4.2 函数指针：中断回调的“灵魂”

为什么说函数指针是灵魂？你想想看，一个项目里可能有按键中断、传感器中断、通信唤醒中断……如果所有中断都挤在同一个HAL_GPIO_EXTI_Callback()里用switch-case判断引脚号，代码会变成什么样？

我曾经维护过一个老项目，那个回调函数写了300多行，里面嵌套了5层if-else。每次加一个新中断，都要小心翼翼地在正确的位置插入代码，生怕破坏了别人的逻辑。

函数指针能解决这个问题。它的本质是：把“要调用的函数”当作一个变量来传递和存储。

// 定义函数指针类型
typedef void (*gpio_irq_handler_t)(void *arg);

// 定义回调注册结构体
typedef struct {
    uint16_t            pin;
    gpio_irq_handler_t  handler;
    void               *arg;
    uint8_t             active;
} gpio_irq_cb_t;

这样，每个外部中断引脚都可以注册自己的处理函数。中断发生时，框架遍历注册表，找到对应的引脚，调用它的处理函数。

小技巧：函数指针的arg参数用void *，可以传入任意类型的数据指针。比如按键中断可以传入按键编号，传感器中断可以传入传感器实例指针。这样回调函数就能拿到上下文信息，不用依赖全局变量。

4.3 中断服务注册：让代码“活”起来

有了函数指针，我们就可以设计一个中断服务注册机制。说白了，就是提供一个API，让用户能把“某个引脚的中断处理函数”登记到系统里。

// 中断回调注册表（最多支持16个外部中断）
static gpio_irq_cb_t irq_cb_table[16] = {0};

// 注册中断回调
int gpio_irq_register(uint16_t pin, gpio_irq_handler_t handler, void *arg) {
    for (int i = 0; i < 16; i++) {
        if (!irq_cb_table[i].active) {
            irq_cb_table[i].pin     = pin;
            irq_cb_table[i].handler = handler;
            irq_cb_table[i].arg     = arg;
            irq_cb_table[i].active  = 1;
            return 0;  // 注册成功
        }
    }
    return -1;  // 注册表已满
}

// 注销中断回调
int gpio_irq_unregister(uint16_t pin) {
    for (int i = 0; i < 16; i++) {
        if (irq_cb_table[i].active && irq_cb_table[i].pin == pin) {
            irq_cb_table[i].active = 0;
            return 0;
        }
    }
    return -1;
}

这个设计的好处是：注册和注销都是O(n)复杂度，但n最大只有16，实际项目中完全够用。而且用户代码和中断处理逻辑完全解耦——用户只需要在初始化时调用gpio_irq_register()，剩下的框架自动处理。

注意：中断回调函数里不要做耗时操作！我曾经见过有人在回调里调用printf()、delay()甚至malloc()，结果系统动不动就死机。回调里应该只做“标记事件”或“设置标志位”这类轻量操作，真正的处理放到主循环或任务里。

4.4 完整的中断回调封装实现

把上面的思路整合起来，就是一个完整的中断回调封装层。下面是我在实际项目中使用的代码骨架：

// gpio_irq.h
#ifndef _GPIO_IRQ_H_
#define _GPIO_IRQ_H_

#include "stm32f1xx_hal.h"

typedef void (*gpio_irq_handler_t)(void *arg);

int gpio_irq_register(uint16_t pin, gpio_irq_handler_t handler, void *arg);
int gpio_irq_unregister(uint16_t pin);
void gpio_irq_dispatch(uint16_t pin);

#endif

// gpio_irq.c
#include "gpio_irq.h"

static gpio_irq_cb_t irq_cb_table[16] = {0};

int gpio_irq_register(uint16_t pin, gpio_irq_handler_t handler, void *arg) {
    // ... 实现同上 ...
}

int gpio_irq_unregister(uint16_t pin) {
    // ... 实现同上 ...
}

void gpio_irq_dispatch(uint16_t pin) {
    for (int i = 0; i < 16; i++) {
        if (irq_cb_table[i].active && irq_cb_table[i].pin == pin) {
            if (irq_cb_table[i].handler) {
                irq_cb_table[i].handler(irq_cb_table[i].arg);
            }
            break;
        }
    }
}

// 在HAL库的中断回调中调用
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) {
    gpio_irq_dispatch(GPIO_Pin);
}

用户代码就变得非常清爽：

// 按键中断处理函数
void key_irq_handler(void *arg) {
    uint8_t key_id = *(uint8_t *)arg;
    // 处理按键事件...
}

void main(void) {
    // ... 初始化 ...
    uint8_t key1_id = 1;
    gpio_irq_register(GPIO_PIN_0, key_irq_handler, &key1_id);
    
    while (1) {
        // 主循环处理其他事情
    }
}

封装的价值：用户不需要知道中断标志位怎么清、NVIC怎么配、HAL库的回调机制是什么。他只需要注册一个函数，中断来了自动执行。这就是驱动层封装的意义——把复杂性藏起来，把简单留给用户。

4.5 知识结构图：中断回调封装体系

下面这张图展示了整个中断回调封装的核心逻辑。我习惯在画这种图时把“注册-分发-执行”这条主线标清楚，这样团队新成员一看就懂。

GPIO中断回调封装体系 GPIO中断回调封装体系 用户层 调用 gpio_irq_register() 注册回调函数 封装层（中断回调框架） 维护注册表 irq_cb_table[16] 提供 gpio_irq_dispatch() 分发中断 HAL库层 HAL_GPIO_EXTI_IRQHandler() → HAL_GPIO_EXTI_Callback() 硬件层（EXTI + NVIC） 中断触发 用户回调执行

从这张图能看出来，整个体系是分层的。用户层只关心注册和回调函数；封装层负责管理注册表和分发；HAL库层处理硬件细节；硬件层负责响应中断信号。每一层各司其职，互不干扰。

4.6 避坑指南：我踩过的那些坑

讲几个实际项目中容易翻车的地方：

  • 中断优先级配置不当导致死锁：我曾经在一个项目里，把两个中断的优先级设成了相同，而且它们之间共享了一个资源。结果高优先级中断还没退出，低优先级中断又来了，直接死锁。解决办法是：明确中断优先级分组，共享资源的访问加临界区保护。
  • 回调函数里调用了阻塞函数：有人在按键中断回调里加了HAL_Delay(50)做消抖，结果系统响应变得奇慢无比。正确的做法是：中断里只设标志位，消抖放在主循环里做。
  • 注册表溢出：如果项目里用了很多外部中断（比如矩阵键盘），16个槽位可能不够。我习惯把注册表大小做成可配置的宏，或者用动态链表（但中断里不能用malloc，所以链表要在初始化时建好）。
  • 忘记注销回调：在动态切换中断处理函数时，如果先注册新的、再注销旧的，中间会有一段“双注册”的时间窗口。我建议先注销再注册，或者用“更新”接口替代“注册+注销”两步操作。

个人习惯：我一般在gpio_irq_register()里加一个断言，检查传入的handler是否为NULL。如果传入NULL，直接返回错误。这样能避免很多“中断来了但回调是空指针”的诡异问题。

4.7 小结

这一讲的核心就三件事：外部中断怎么配、函数指针怎么用、回调注册表怎么设计。掌握了这些，你就能写出灵活、可移植的中断回调封装层。下次不管换什么芯片，只要把HAL库那层适配一下，上层的注册逻辑完全不用动。

嗯，中断回调封装就聊到这里。代码我已经放在课程配套的示例工程里了，建议你打开IDE实际跑一遍，看看注册、触发、分发整个流程是怎么走的。动手试过，才算真正学会。

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