📚 课程目录第3章 GPIO硬件抽象层设计（二）

第三章 GPIO硬件抽象层设计（二）：输出电平控制、输入读取与中断回调

上一章我们把GPIO的寄存器封装成了结构体，做好了最底层的“砖块”。这一章，咱们要在这堆砖块上搭出真正的“墙”——也就是给上层提供一套干净、好用的API。

说白了，就是让应用工程师写代码时，不用再翻数据手册查某个寄存器第几位是干嘛的。他只需要调用 GPIO_SetPin() 或者 GPIO_ReadPin() 就行了。

我个人习惯把GPIO的HAL层分成三大块：输出控制、输入读取、中断管理。咱们一个一个来拆。

3.1 输出电平控制：Set / Reset / Toggle

输出控制是GPIO最基础的功能。你想想看，一个LED亮灭、一个继电器通断，本质上就是往某个引脚写0或写1。

但这里有个坑——直接写寄存器和用位带操作，效果差很多。我在项目中遇到过，用普通写寄存器的方式去翻转一个IO，结果在高速PWM波形里出现了毛刺。后来查出来，是因为“读-改-写”操作被中断打断了。

注意： 多任务环境下，不要直接用 GPIOx->ODR 做“读-改-写”。如果两个任务同时操作同一个端口的不同引脚，其中一个会被覆盖。

所以，我建议输出控制API至少提供三个函数：

SetPin：只置位，不影响其他引脚
ResetPin：只清零，不影响其他引脚
TogglePin：翻转电平

代码实现上，Set和Reset可以用BSRR寄存器（如果MCU支持），这样是原子操作。Toggle则用ODR异或，但要注意加临界区保护。

// 输出控制API示例
void GPIO_SetPin(GPIO_TypeDef* GPIOx, uint16_t Pin)
{
    // 使用BSRR寄存器，原子操作
    GPIOx->BSRR = Pin;
}

void GPIO_ResetPin(GPIO_TypeDef* GPIOx, uint16_t Pin)
{
    // BSRR的高16位是复位
    GPIOx->BSRR = (uint32_t)Pin << 16;
}

void GPIO_TogglePin(GPIO_TypeDef* GPIOx, uint16_t Pin)
{
    // 注意：这里需要关中断保护
    __disable_irq();
    GPIOx->ODR ^= Pin;
    __enable_irq();
}

小技巧： 如果MCU支持位带操作（Bit-Band），Toggle可以用位带别名区实现，速度更快。但位带区的地址计算有点绕，我一般封装成宏。

3.2 输入电平读取：轮询与去抖

读取输入电平，听起来简单——直接读IDR寄存器就行。但实际项目中，机械开关的抖动会让你头疼。

我记得有一次做智能家居面板，按键检测总是误触发。示波器一看，按键按下时电平跳了十几下。后来加了20ms的软件去抖，问题才解决。

输入读取API我一般设计成两种模式：

模式	函数名	说明
原始电平	GPIO_ReadPin	直接读IDR，不处理抖动
去抖电平	GPIO_ReadPinDebounce	连续采样N次，一致才返回

去抖的实现，我习惯用状态机，而不是简单的延时。因为延时阻塞CPU，在实时系统里是灾难。

// 去抖状态机示例
typedef enum {
    DEBOUNCE_STATE_IDLE,
    DEBOUNCE_STATE_CHECK,
    DEBOUNCE_STATE_CONFIRM
} DebounceState_t;

uint8_t GPIO_ReadPinDebounce(GPIO_TypeDef* GPIOx, uint16_t Pin)
{
    static DebounceState_t state = DEBOUNCE_STATE_IDLE;
    static uint8_t sample_count = 0;
    uint8_t current_level = GPIO_ReadPin(GPIOx, Pin);
    
    switch(state) {
        case DEBOUNCE_STATE_IDLE:
            state = DEBOUNCE_STATE_CHECK;
            sample_count = 0;
            break;
            
        case DEBOUNCE_STATE_CHECK:
            if(current_level == GPIO_ReadPin(GPIOx, Pin)) {
                sample_count++;
                if(sample_count >= 5) {  // 连续5次一致
                    state = DEBOUNCE_STATE_CONFIRM;
                    return current_level;
                }
            } else {
                sample_count = 0;  // 不一致，重新计数
            }
            break;
            
        case DEBOUNCE_STATE_CONFIRM:
            state = DEBOUNCE_STATE_IDLE;
            break;
    }
    return 0xFF;  // 未确认
}

核心思想： 输入读取的HAL层，不仅要读电平，还要把“去抖”这种通用逻辑封装进去。这样应用层就不用重复造轮子了。

3.3 中断配置与回调函数注册

中断是GPIO最强大的功能，也是最容易出bug的地方。我见过太多人，中断里做延时、做打印、甚至做malloc——然后系统就挂了。

GPIO中断的HAL层，我建议做两件事：

封装中断配置：触发边沿、使能/禁止、清除标志
提供回调注册机制：让应用层注册自己的处理函数

回调函数的设计，我踩过不少坑。最早我用的是固定函数名，比如 EXTI0_IRQHandler() 里直接写死逻辑。后来项目大了，多个模块都要用同一个中断线，就傻眼了。

所以，我现在都用函数指针数组来做回调注册。

// 回调函数类型定义
typedef void (*GPIO_Callback_t)(void);

// 回调函数表，最多支持16个中断线
static GPIO_Callback_t gpio_callback_table[16] = {NULL};

// 注册回调
void GPIO_RegisterCallback(uint8_t irq_line, GPIO_Callback_t callback)
{
    if(irq_line < 16) {
        gpio_callback_table[irq_line] = callback;
    }
}

// 中断服务函数（以EXTI0为例）
void EXTI0_IRQHandler(void)
{
    // 检查中断标志
    if(EXTI->PR & (1 << 0)) {
        // 清除标志
        EXTI->PR = (1 << 0);
        
        // 调用回调
        if(gpio_callback_table[0] != NULL) {
            gpio_callback_table[0]();
        }
    }
}

中断回调的黄金法则： 回调函数里不要做耗时操作。我曾经在回调里加了个printf，结果串口波特率9600，打印一次要1ms，中断频率一高，系统直接死机。回调里只做“标记”，具体处理放到主循环或任务里。

3.4 整体架构图

下面这张图，把GPIO HAL层的三层结构画清楚了。你可以看到，最底层是寄存器操作，中间层是API封装，最上层是应用回调。

3.5 回调注册的进阶用法：多回调链

有时候，一个中断线需要触发多个动作。比如按键按下，既要点亮LED，又要发送消息，还要记录日志。如果只注册一个回调，就得把所有逻辑塞进去，耦合度太高。

我后来设计了一个回调链的机制：每个中断线可以挂多个回调函数，形成一个链表。触发时依次调用。

// 回调节点结构
typedef struct CallbackNode {
    GPIO_Callback_t func;
    struct CallbackNode* next;
} CallbackNode_t;

// 注册到回调链
void GPIO_RegisterCallbackChain(uint8_t irq_line, GPIO_Callback_t callback)
{
    CallbackNode_t* node = malloc(sizeof(CallbackNode_t));
    node->func = callback;
    node->next = callback_chain[irq_line];
    callback_chain[irq_line] = node;
}

// 中断中遍历调用
void EXTI0_IRQHandler(void)
{
    if(EXTI->PR & (1 << 0)) {
        EXTI->PR = (1 << 0);
        
        CallbackNode_t* node = callback_chain[0];
        while(node != NULL) {
            node->func();
            node = node->next;
        }
    }
}

注意： 回调链用了动态内存分配，在资源紧张的MCU上要谨慎。我一般会在初始化时静态分配好节点池，避免运行时malloc。

3.6 本章小结

这一章我们做了三件事：

输出控制：用BSRR实现原子操作，用异或实现Toggle
输入读取：区分原始电平和去抖电平，用状态机避免阻塞
中断回调：用函数指针数组实现注册机制，用回调链实现多任务触发

嗯，到这里，GPIO的HAL层骨架已经搭好了。下一层，我们要开始做更复杂的中间件了——比如用这些API去驱动一个矩阵键盘，或者模拟一个I2C时序。但那是后面的事，先把今天的内容消化掉。

记住一句话：好的HAL层，让应用工程师写代码像在写业务逻辑，而不是在调寄存器。