GPIO抽象层：从基础到实战

各位同学好，我是老张。今天咱们聊聊GPIO抽象层。说实话，GPIO这东西看起来简单，但我在项目里见过太多人在这上面栽跟头。你想想看，一个嵌入式系统里，GPIO可能是用得最多的外设了——点灯、按键、中断、模拟协议...几乎每个项目都离不开它。

但问题来了：不同芯片的GPIO操作方式天差地别。Linux下有/sys/class/gpio，STM32有HAL库，有些RTOS还得自己操作寄存器。怎么让上层代码不依赖具体硬件？这就是抽象层要干的事。

GPIO基础概念

先过一遍基础。GPIO就是通用输入输出引脚。每个引脚可以配置成输入、输出，或者复用功能。嗯，这里要注意——不是所有引脚都能随便配，有些引脚有特殊功能。

我个人习惯把GPIO属性分成三类：

• 方向：输入还是输出
• 电平：高还是低（3.3V还是0V，具体看芯片）
• 模式：推挽、开漏、上拉、下拉、浮空

我在项目中遇到过最坑的事：某次调试I2C总线，死活通信不上。查了两天，最后发现是GPIO配置成了推挽输出，而不是开漏。你说冤不冤？

模式	典型用途	注意事项
推挽输出	驱动LED、普通信号	不能直接连总线
开漏输出	I2C、多设备共享线	需要外部上拉电阻
浮空输入	按键检测	电平不确定，建议加上拉
上拉/下拉输入	防抖动、默认电平	注意电阻值影响功耗

标准接口定义

好了，基础说完了。现在咱们来定义抽象层接口。我建议用C语言，因为C是嵌入式世界的通用语言。接口要足够简单，但又不能太简陋。

这是我常用的接口定义：

/* gpio_hal.h */
#ifndef __GPIO_HAL_H__
#define __GPIO_HAL_H__

#include <stdint.h>

/* GPIO方向 */
typedef enum {
    GPIO_DIR_INPUT  = 0,
    GPIO_DIR_OUTPUT = 1
} gpio_dir_t;

/* GPIO电平 */
typedef enum {
    GPIO_LOW  = 0,
    GPIO_HIGH = 1
} gpio_level_t;

/* GPIO配置结构体 */
typedef struct {
    uint32_t    pin;        /* 引脚号 */
    gpio_dir_t  direction;  /* 方向 */
    uint8_t     pull;       /* 上拉/下拉：0-无，1-上拉，2-下拉 */
} gpio_config_t;

/* 标准接口 */
int gpio_init(gpio_config_t *cfg);
int gpio_set_level(uint32_t pin, gpio_level_t level);
gpio_level_t gpio_get_level(uint32_t pin);
int gpio_toggle(uint32_t pin);
int gpio_deinit(uint32_t pin);

#endif /* __GPIO_HAL_H__ */

你可能会问：为什么不用更复杂的接口？我的经验是——接口越简单，移植越容易。你想想看，如果接口里塞了一堆平台相关的参数，那还叫抽象层吗？

Linux GPIO操作

Linux下操作GPIO，主要有两种方式：sysfs和libgpiod。sysfs是老方法，简单但慢；libgpiod是新方法，性能好，但需要额外库。

我个人更推荐libgpiod，尤其是做产品的时候。为什么？因为sysfs已经被标记为废弃了，迟早要淘汰。

先看sysfs的实现：

/* gpio_hal_linux_sysfs.c */
#include "gpio_hal.h"
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <fcntl.h>

#define SYSFS_GPIO_PATH "/sys/class/gpio"

static int gpio_export(uint32_t pin) {
    int fd = open(SYSFS_GPIO_PATH "/export", O_WRONLY);
    if (fd < 0) return -1;
    char buf[8];
    int len = snprintf(buf, sizeof(buf), "%u", pin);
    write(fd, buf, len);
    close(fd);
    return 0;
}

int gpio_init(gpio_config_t *cfg) {
    if (!cfg) return -1;
    
    /* 导出GPIO */
    if (gpio_export(cfg->pin) < 0) return -1;
    
    /* 设置方向 */
    char path[64];
    snprintf(path, sizeof(path), SYSFS_GPIO_PATH "/gpio%u/direction", cfg->pin);
    int fd = open(path, O_WRONLY);
    if (fd < 0) return -1;
    
    const char *dir = (cfg->direction == GPIO_DIR_OUTPUT) ? "out" : "in";
    write(fd, dir, strlen(dir));
    close(fd);
    
    return 0;
}

int gpio_set_level(uint32_t pin, gpio_level_t level) {
    char path[64];
    snprintf(path, sizeof(path), SYSFS_GPIO_PATH "/gpio%u/value", pin);
    int fd = open(path, O_WRONLY);
    if (fd < 0) return -1;
    
    write(fd, level ? "1" : "0", 1);
    close(fd);
    return 0;
}

我曾经在一个项目里用sysfs控制几十个GPIO，结果发现每次操作都要open/close文件，性能惨不忍睹。后来换成libgpiod，速度提升了10倍不止。

STM32 GPIO实现

STM32这边就简单多了。HAL库已经封装好了，我们只需要做个适配层。

/* gpio_hal_stm32.c */
#include "gpio_hal.h"
#include "stm32f4xx_hal.h"

/* 引脚映射表 - 实际项目中需要根据芯片调整 */
typedef struct {
    GPIO_TypeDef *port;
    uint16_t      pin;
} stm32_gpio_map_t;

static stm32_gpio_map_t gpio_map[] = {
    {GPIOA, GPIO_PIN_0},   /* pin 0 -> PA0 */
    {GPIOA, GPIO_PIN_1},   /* pin 1 -> PA1 */
    /* ... 省略中间映射 ... */
    {GPIOB, GPIO_PIN_15},  /* pin 47 -> PB15 */
};

int gpio_init(gpio_config_t *cfg) {
    if (!cfg || cfg->pin >= 48) return -1;
    
    GPIO_InitTypeDef gpio_init = {0};
    gpio_init.Pin = gpio_map[cfg->pin].pin;
    gpio_init.Mode = (cfg->direction == GPIO_DIR_OUTPUT) ? 
                     GPIO_MODE_OUTPUT_PP : GPIO_MODE_INPUT;
    gpio_init.Pull = cfg->pull;
    gpio_init.Speed = GPIO_SPEED_FREQ_HIGH;
    
    HAL_GPIO_Init(gpio_map[cfg->pin].port, &gpio_init);
    return 0;
}

int gpio_set_level(uint32_t pin, gpio_level_t level) {
    if (pin >= 48) return -1;
    HAL_GPIO_WritePin(gpio_map[pin].port, gpio_map[pin].pin, 
                      level ? GPIO_PIN_SET : GPIO_PIN_RESET);
    return 0;
}

gpio_level_t gpio_get_level(uint32_t pin) {
    if (pin >= 48) return GPIO_LOW;
    return (HAL_GPIO_ReadPin(gpio_map[pin].port, gpio_map[pin].pin) == 
            GPIO_PIN_SET) ? GPIO_HIGH : GPIO_LOW;
}

这里有个关键点：引脚映射表。我建议用数组而不是switch-case，因为数组查找是O(1)，switch-case是O(n)。虽然GPIO数量不多，但养成好习惯总没错。

抽象层设计总结

说了这么多，咱们来画个图，把整个思路理清楚：

这张图很直观：上层应用只跟标准接口打交道，底层实现可以随意切换。这就是抽象层的价值所在。

最后说几句心里话。做抽象层设计，最忌讳的就是过度设计。我见过有人把GPIO抽象层写得比业务代码还复杂，结果项目延期了。记住：抽象是为了简化，不是为了炫技。

嗯，这一章就到这。代码都在上面了，建议你动手试试——先在Linux上跑通sysfs版本，再移植到STM32上。只有亲手写过，才能真正理解抽象层的精髓。