4、GPIO HAL设计：从基础到实战

GPIO，说白了就是芯片最基础的“手脚”。

我做了这么多年嵌入式，接触的第一个外设几乎都是GPIO。点亮一个LED，读一个按键状态，这些看似简单的操作，背后其实藏着不少设计哲学。今天我们就来聊聊，怎么把GPIO的HAL层设计得既通用又高效。

4.1 GPIO基础概念

先理清几个核心概念。GPIO是通用输入输出端口，每个引脚可以独立配置为输入、输出，或者复用为其他功能。

输入模式：读取引脚电平。高电平是1，低电平是0。

输出模式：驱动引脚电平。可以推挽输出，也可以开漏输出。

复用功能：比如把引脚配置成UART的TX、I2C的SCL。

嗯，这里要注意一个细节——上下拉电阻。我在项目中遇到过，某个按键电路没加外部上拉，结果引脚浮空，读到的电平乱跳。后来我习惯在初始化时，把输入引脚内部上拉打开，省掉一个电阻。

4.2 GPIO HAL接口定义

接口设计，我建议遵循“最小完备”原则。别搞太多花哨的函数，够用就好。

下面是我常用的接口定义：

/* GPIO引脚编号枚举 */
typedef enum {
    GPIO_PIN_0  = 0,
    GPIO_PIN_1  = 1,
    GPIO_PIN_2  = 2,
    /* ... 省略中间引脚 ... */
    GPIO_PIN_15 = 15
} 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_t;

/* 上下拉配置 */
typedef enum {
    GPIO_PULL_NONE  = 0x00,
    GPIO_PULL_UP    = 0x01,
    GPIO_PULL_DOWN  = 0x02
} GPIO_Pull_t;

/* 初始化结构体 */
typedef struct {
    GPIO_Pin_t   pin;
    GPIO_Mode_t  mode;
    GPIO_Pull_t  pull;
    uint8_t      speed;  /* 输出速度，0~3 */
} GPIO_Config_t;

/* HAL接口函数 */
void GPIO_Init(GPIO_Config_t *config);
void GPIO_DeInit(GPIO_Pin_t pin);
void GPIO_WritePin(GPIO_Pin_t pin, uint8_t state);
uint8_t GPIO_ReadPin(GPIO_Pin_t pin);
void GPIO_TogglePin(GPIO_Pin_t pin);

你想想看，这6个函数基本覆盖了所有GPIO操作场景。为什么没有中断配置？因为中断属于EXTI（外部中断）模块，我习惯单独设计，不混在GPIO里。

4.3 GPIO驱动实现

驱动实现，说白了就是操作寄存器。不同芯片的寄存器布局不同，但HAL层要屏蔽这些差异。

以STM32为例，GPIO寄存器组包括：

实现GPIO_WritePin时，我推荐用BSRR寄存器。为什么？因为BSRR是原子操作，写ODR需要读-改-写，在多任务环境下可能出问题。

void GPIO_WritePin(GPIO_Pin_t pin, uint8_t state)
{
    if (state) {
        /* 设置引脚为高电平 */
        GPIOA->BSRR = (1 << pin);
    } else {
        /* 设置引脚为低电平 */
        GPIOA->BSRR = (1 << (pin + 16));
    }
}

读引脚更简单：

uint8_t GPIO_ReadPin(GPIO_Pin_t pin)
{
    return (GPIOA->IDR >> pin) & 0x01;
}

4.4 GPIO测试用例设计

测试，是HAL设计里最容易忽视的一环。我见过太多人写完驱动就扔那了，结果联调时发现引脚配置错了。

我的习惯是，每个HAL接口都要有对应的测试用例。下面是我常用的测试方案：

测试1：基本输出测试

• 配置一个引脚为推挽输出
• 循环写高、写低、翻转
• 用示波器或万用表验证波形

测试2：基本输入测试

• 配置一个引脚为输入，带上拉
• 外部接地时读0，悬空时读1
• 验证上下拉配置是否生效

测试3：回环测试

• 把两个引脚短接
• 一个配置为输出，一个配置为输入
• 输出写1，输入读1；输出写0，输入读0
• 验证读写一致性

测试4：边界测试

• 测试所有引脚（0~15）
• 测试所有模式组合
• 测试高速翻转（比如1MHz）

void GPIO_Test_AllPins(void)
{
    GPIO_Config_t config;
    uint8_t i, read_val;
    
    /* 测试所有引脚输出 */
    for (i = 0; i < 16; i++) {
        config.pin   = i;
        config.mode  = GPIO_MODE_OUTPUT_PP;
        config.pull  = GPIO_PULL_NONE;
        config.speed = 2;
        GPIO_Init(&config);
        
        GPIO_WritePin(i, 1);
        delay_ms(10);
        GPIO_WritePin(i, 0);
        delay_ms(10);
        GPIO_TogglePin(i);
        delay_ms(10);
    }
    
    /* 测试所有引脚输入 */
    for (i = 0; i < 16; i++) {
        config.pin   = i;
        config.mode  = GPIO_MODE_INPUT;
        config.pull  = GPIO_PULL_UP;
        GPIO_Init(&config);
        
        read_val = GPIO_ReadPin(i);
        /* 悬空时应该读到1 */
        if (read_val != 1) {
            /* 测试失败，记录错误 */
        }
    }
}

你可能会问，测试用例写这么详细有必要吗？

有。我记得有一次，芯片换批次后，某个引脚的上下拉配置失效了。就是因为测试用例第一时间发现了问题，才没让bug流到产线。否则，几千块板子全废了。

好了，GPIO的HAL设计就聊到这。下一章我们讲UART，那个坑更多，到时候再细说。