3. GPIO 外设驱动开发：从初始化到按键消抖实战

GPIO 是嵌入式开发里最基础、也最常用的外设。说白了，它就是芯片和外界打交道的最简单方式——要么输出高低电平，要么检测外部电平变化。但越是基础的东西，坑往往越多。我刚开始用 ESP-IDF 做项目时，就因为在 GPIO 配置上少写了一个参数，导致整块板子在上电瞬间误触发，差点把电机驱动烧了。

这一章，我会带你从头梳理 ESP32 GPIO 的完整用法。包括初始化配置、四种工作模式、中断机制，最后用一个按键消抖的实战案例把知识点串起来。

3.1 GPIO 初始化与配置

在 ESP-IDF 里，操作 GPIO 的第一步永远是调用 gpio_config() 函数。这个函数接受一个 gpio_config_t 结构体，里面包含了你要配置的所有信息。

我个人习惯把 GPIO 配置拆成四步走：

1. 选定引脚：用 pin_bit_mask 指定要操作的 GPIO 编号
2. 设定模式：通过 mode 字段选择输入还是输出
3. 配置上下拉：用 pull_up_en / pull_down_en 决定内部电阻状态
4. 配置中断：如果需要中断功能，设置 intr_type

// 标准 GPIO 初始化示例
gpio_config_t io_conf = {
    .pin_bit_mask = (1ULL << GPIO_NUM_2),  // 选中 GPIO2
    .mode = GPIO_MODE_OUTPUT,                // 输出模式
    .pull_up_en = GPIO_PULLUP_DISABLE,       // 不上拉
    .pull_down_en = GPIO_PULLDOWN_DISABLE,   // 不下拉
    .intr_type = GPIO_INTR_DISABLE           // 不使能中断
};
gpio_config(&io_conf);

3.2 输出模式：推挽与开漏

输出模式有两种，很多人一开始分不清。我简单解释一下：

推挽输出 是最常用的模式。输出 1 时引脚直接接 VCC，输出 0 时直接接 GND。驱动能力强，响应快。我做过一个 LED 灯带项目，就是用推挽输出直接驱动，完全没问题。

开漏输出 则比较特殊。它只能输出低电平，或者高阻态。要输出高电平，必须在外部加一个上拉电阻到 VCC。你想想看，为什么 I²C 总线要用开漏？因为多个设备可以共用一条线，任何一个设备都能把总线拉低，不会发生短路。

3.3 输入模式：上拉、下拉与中断

输入模式相对简单，但细节不少。ESP32 的 GPIO 输入可以配置内部上拉或下拉电阻，也可以使能中断功能。

3.3.1 上拉与下拉

内部上拉电阻把引脚默认拉到高电平，下拉则拉到低电平。这样做的好处是：当外部没有信号驱动时，引脚状态是确定的，不会浮空。

// 输入模式配置示例：使能内部上拉
gpio_config_t io_conf = {
    .pin_bit_mask = (1ULL << GPIO_NUM_0),
    .mode = GPIO_MODE_INPUT,
    .pull_up_en = GPIO_PULLUP_ENABLE,    // 使能上拉
    .pull_down_en = GPIO_PULLDOWN_DISABLE,
    .intr_type = GPIO_INTR_DISABLE
};
gpio_config(&io_conf);

这里有个经验：按键检测通常用上拉输入。按键一端接 GPIO，另一端接 GND。按下时引脚被拉低，松开时上拉电阻把引脚拉高。这样逻辑清晰，代码也好写。

3.3.2 中断触发

ESP32 的 GPIO 支持四种中断触发方式：

// 配置下降沿中断
gpio_config_t io_conf = {
    .pin_bit_mask = (1ULL << GPIO_NUM_4),
    .mode = GPIO_MODE_INPUT,
    .pull_up_en = GPIO_PULLUP_ENABLE,
    .pull_down_en = GPIO_PULLDOWN_DISABLE,
    .intr_type = GPIO_INTR_NEGEDGE    // 下降沿触发
};
gpio_config(&io_conf);

// 安装 GPIO 中断服务
gpio_install_isr_service(0);
// 注册中断处理函数
gpio_isr_handler_add(GPIO_NUM_4, button_isr_handler, NULL);

3.4 按键消抖实战

按键消抖是 GPIO 输入最经典的实战场景。为什么需要消抖？因为机械按键在按下和松开的瞬间，触点会弹跳几次，产生多个电平跳变。如果不处理，一次按键可能会被误判成多次。

消抖有两种方式：硬件消抖和软件消抖。

3.4.1 硬件消抖

硬件消抖是在按键两端并联一个电容（通常 0.1μF），利用电容的充放电特性滤除毛刺。优点是简单可靠，不占用 CPU。缺点是增加 BOM 成本，而且电容值需要根据按键特性调整。

3.4.2 软件消抖

软件消抖更灵活，也是我推荐的方式。核心思路很简单：检测到电平变化后，延时一段时间再读取一次，确认状态是否稳定。

// 软件消抖实现
#define DEBOUNCE_TIME_MS 20  // 消抖延时 20ms

int read_debounced_button(gpio_num_t gpio) {
    // 第一次读取
    int state1 = gpio_get_level(gpio);
    // 延时消抖
    vTaskDelay(pdMS_TO_TICKS(DEBOUNCE_TIME_MS));
    // 第二次读取
    int state2 = gpio_get_level(gpio);
    // 两次一致才返回有效值
    return (state1 == state2) ? state1 : -1;
}

但上面的代码有个问题：vTaskDelay 会阻塞当前任务。如果用在主循环里，会影响其他任务的响应。更好的做法是用定时器或状态机来实现非阻塞消抖。

// 非阻塞消抖状态机
typedef enum {
    BTN_IDLE,
    BTN_PRESS_DEBOUNCE,
    BTN_PRESSED,
    BTN_RELEASE_DEBOUNCE
} button_state_t;

button_state_t btn_state = BTN_IDLE;
uint32_t last_tick = 0;

void button_task(void *arg) {
    while (1) {
        int level = gpio_get_level(GPIO_NUM_0);
        uint32_t now = xTaskGetTickCount();

        switch (btn_state) {
            case BTN_IDLE:
                if (level == 0) {  // 检测到按下
                    btn_state = BTN_PRESS_DEBOUNCE;
                    last_tick = now;
                }
                break;

            case BTN_PRESS_DEBOUNCE:
                if ((now - last_tick) > pdMS_TO_TICKS(20)) {
                    if (gpio_get_level(GPIO_NUM_0) == 0) {
                        btn_state = BTN_PRESSED;
                        // 执行按键按下处理
                        printf("Button pressed!\n");
                    } else {
                        btn_state = BTN_IDLE;  // 抖动，回到空闲
                    }
                }
                break;

            case BTN_PRESSED:
                if (level == 1) {  // 检测到松开
                    btn_state = BTN_RELEASE_DEBOUNCE;
                    last_tick = now;
                }
                break;

            case BTN_RELEASE_DEBOUNCE:
                if ((now - last_tick) > pdMS_TO_TICKS(20)) {
                    if (gpio_get_level(GPIO_NUM_0) == 1) {
                        btn_state = BTN_IDLE;
                        // 执行按键松开处理
                        printf("Button released!\n");
                    } else {
                        btn_state = BTN_PRESSED;  // 抖动，回到按下
                    }
                }
                break;
        }
        vTaskDelay(pdMS_TO_TICKS(5));  // 每 5ms 轮询一次
    }
}

3.5 本章小结

GPIO 看似简单，但配置不当会引发各种奇怪问题。推挽输出驱动能力强，适合普通负载；开漏输出用于多设备共享总线。输入模式记得配置上拉或下拉，避免引脚浮空。中断处理函数要轻量，只设标志不做事。按键消抖用状态机实现非阻塞方案，既可靠又不影响系统实时性。