3、GPIO驱动封装：输入输出模式配置、上下拉设置、中断触发方式、寄存器级封装

好，咱们今天聊GPIO驱动封装。说实话，GPIO是嵌入式开发里最基础、也最容易被轻视的模块。很多人觉得不就是点个灯、读个按键嘛，有什么好封装的？但我在项目里吃过不少亏——有一次因为上下拉配置没处理好，整批板子在高温下按键误触发，差点导致项目延期。从那以后，我对GPIO驱动封装就特别较真。

3.1 输入输出模式配置：别小看这个“方向”

GPIO最核心的属性就是方向——输入还是输出。但实际芯片里，配置方式五花八门。有些芯片用方向寄存器，有些用模式寄存器，还有些把功能复用和方向混在一起。我个人的习惯是，在驱动层统一抽象成三种模式：输入模式、推挽输出、开漏输出。

下面是我常用的枚举定义：

typedef enum {
    GPIO_MODE_INPUT,        // 输入模式
    GPIO_MODE_OUTPUT_PP,    // 推挽输出
    GPIO_MODE_OUTPUT_OD,    // 开漏输出
    GPIO_MODE_AF_PP,        // 复用推挽
    GPIO_MODE_AF_OD         // 复用开漏
} GPIO_Mode_t;

嗯，这里要注意：有些芯片还有模拟模式，比如ADC输入。我一般单独处理，不混在GPIO模式里。为什么？因为模拟模式通常需要关闭数字输入缓冲，省电且避免干扰。

3.2 上下拉设置：看似简单，坑却不少

上下拉电阻，说白了就是给引脚一个确定的电平状态。但我在项目中遇到过一个问题：某款MCU的内部上拉电阻只有30kΩ左右，而外部电路已经接了10kΩ下拉。结果呢？内部上拉根本拉不起来，电平一直处于不确定状态。

所以我的建议是：驱动封装里，上下拉配置一定要和外部电路设计配合考虑。代码层面，我通常这样封装：

typedef enum {
    GPIO_PULL_NONE,     // 浮空
    GPIO_PULL_UP,       // 上拉
    GPIO_PULL_DOWN      // 下拉
} GPIO_Pull_t;

void GPIO_SetPull(GPIO_TypeDef* GPIOx, uint16_t Pin, GPIO_Pull_t Pull) {
    // 寄存器级操作，不同芯片实现不同
    // 但对外接口保持一致
}

3.3 中断触发方式：边缘触发还是电平触发？

GPIO中断的触发方式，常见的有上升沿、下降沿、双边沿、高电平、低电平。这里有个容易忽略的点：电平触发在中断服务函数里必须清除触发条件，否则会一直进中断。边缘触发则没有这个问题。

我记得有一次调试一个红外遥控接收项目，用的就是电平触发。结果中断服务函数里忘了读数据寄存器，导致CPU一直在处理中断，主循环根本跑不起来。排查了半天才发现是这个问题。

中断配置的封装，我建议把触发方式和中断使能分开：

typedef enum {
    GPIO_INT_RISING,        // 上升沿触发
    GPIO_INT_FALLING,       // 下降沿触发
    GPIO_INT_BOTH,          // 双边沿触发
    GPIO_INT_LOW_LEVEL,     // 低电平触发
    GPIO_INT_HIGH_LEVEL     // 高电平触发
} GPIO_IntTrigger_t;

void GPIO_EnableInterrupt(GPIO_TypeDef* GPIOx, uint16_t Pin, GPIO_IntTrigger_t Trigger);
void GPIO_DisableInterrupt(GPIO_TypeDef* GPIOx, uint16_t Pin);

3.4 寄存器级封装：从底层做起

寄存器级封装，说白了就是直接操作硬件寄存器。这是驱动层最底层的代码，也是移植时需要修改最多的部分。我的做法是：把寄存器操作全部封装成宏或内联函数，上层代码只调用这些接口。

举个例子，设置输出电平：

// 寄存器级宏定义
#define GPIO_SET_PIN(GPIOx, Pin)    ((GPIOx)->BSRR = (Pin))
#define GPIO_RESET_PIN(GPIOx, Pin)  ((GPIOx)->BRR  = (Pin))
#define GPIO_READ_PIN(GPIOx, Pin)   (((GPIOx)->IDR) & (Pin))

// 封装后的接口
void GPIO_WritePin(GPIO_TypeDef* GPIOx, uint16_t Pin, uint8_t State) {
    if (State) {
        GPIO_SET_PIN(GPIOx, Pin);
    } else {
        GPIO_RESET_PIN(GPIOx, Pin);
    }
}

你看，这样封装后，应用层根本不需要知道BSRR和BRR是什么。移植到其他芯片时，只需要修改底层的宏定义就行。我做过一个项目，从STM32F1移植到GD32F1，改的就是这几行宏定义，上层代码一行没动。

3.5 完整的GPIO初始化流程

最后，我总结一下GPIO初始化的标准流程。这也是我在多个项目中沉淀下来的：

1. 使能时钟：GPIO模块的时钟必须先打开，否则写寄存器没用
2. 配置模式：输入、输出、复用等
3. 配置上下拉：根据电路设计选择
4. 配置输出类型和速度：推挽/开漏，以及输出速率
5. 配置中断：如果需要中断功能，配置触发方式和优先级
6. 初始化默认状态：输出引脚设置初始电平，输入引脚读取一次清除毛刺

好了，GPIO驱动封装就聊到这里。下一章咱们会讲定时器驱动的封装，那个更复杂一些，但思路是一样的——抽象、封装、解耦。到时候再细聊。