ESP32外设驱动与Wi-Fi通信优化性能调优实战工程 - 第2节

输入输出模式：不只是高低电平

ESP32 的 GPIO 模式比你想的要多。除了最普通的推挽输出和浮空输入，还有开漏输出、内部上拉/下拉输入。为什么需要这么多模式？我在项目中遇到过一个问题：用 I2C 总线时，必须用开漏输出，否则总线会冲突。

模式对比

你想想看，如果 I2C 上用推挽输出，两个设备同时输出不同电平，那就短路了。开漏模式配合上拉电阻，谁拉低谁说了算，这就是「线与」逻辑。

上下拉电阻的选择

ESP32 内部有可编程的上拉和下拉电阻，阻值大约 45kΩ。我个人建议：能用内部就别用外部，省 BOM 成本。但有些场合不行——比如按键消抖需要更强的上拉，或者总线需要 10kΩ 以下的上拉，那就得外接。

// 配置按键输入，内部上拉
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);

中断处理：别让 CPU 空转

轮询读取 GPIO 电平，CPU 一直在跑循环，浪费电也浪费算力。中断才是正经做法。ESP32 的 GPIO 中断支持多种触发方式：上升沿、下降沿、任意沿、低电平、高电平。

中断配置流程

1. 配置 GPIO 为输入模式，并设置中断类型
2. 安装 GPIO 中断服务：gpio_install_isr_service()
3. 注册中断处理函数：gpio_isr_handler_add()
4. 在 ISR 中处理事件（注意：ISR 里不能阻塞）

来看一个按键中断的例子。我记得第一次写 ESP32 中断时，忘了安装 ISR 服务，结果中断死活不触发——排查了半天才发现这个坑。

#define BUTTON_GPIO  GPIO_NUM_0

static void IRAM_ATTR button_isr_handler(void* arg) {
    // ISR 中只做标记，不要做复杂操作
    uint32_t gpio_num = (uint32_t) arg;
    xQueueSendFromISR(button_evt_queue, &gpio_num, NULL);
}

void button_init(void) {
    gpio_config_t io_conf = {
        .pin_bit_mask = (1ULL << BUTTON_GPIO),
        .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);

    // 安装 ISR 服务
    gpio_install_isr_service(0);
    // 注册中断处理函数
    gpio_isr_handler_add(BUTTON_GPIO, button_isr_handler, (void*) BUTTON_GPIO);
}

消抖实战：别让按键「乱跳」

机械按键按下和松开时，触点会弹跳几次，产生多个边沿。如果不做消抖，一次按键可能触发好几次中断。我曾经在一个产品里没做消抖，结果用户按一下，设备切换了三个模式——被客户骂惨了。

硬件消抖 vs 软件消抖

我个人的习惯是：能用软件就别用硬件。ESP32 性能足够，软件消抖完全扛得住。下面是我常用的「延时采样法」：

#define DEBOUNCE_TIME_MS  20

int read_button_debounced(uint8_t gpio_num) {
    if (gpio_get_level(gpio_num) == 0) {  // 检测到按下
        vTaskDelay(pdMS_TO_TICKS(DEBOUNCE_TIME_MS));  // 延时消抖
        if (gpio_get_level(gpio_num) == 0) {  // 再次确认
            return 1;  // 确认按下
        }
    }
    return 0;
}

但延时采样有个问题：它会阻塞当前任务。如果系统里有多任务，更好的做法是用状态机消抖，不阻塞，还能同时处理多个按键。

状态机消抖（推荐）

typedef enum {
    STATE_IDLE,
    STATE_PRESS_DEBOUNCE,
    STATE_PRESSED,
    STATE_RELEASE_DEBOUNCE
} debounce_state_t;

typedef struct {
    debounce_state_t state;
    uint32_t last_tick;
    uint8_t gpio_num;
} button_t;

void button_fsm_process(button_t *btn) {
    uint8_t level = gpio_get_level(btn->gpio_num);
    uint32_t now = xTaskGetTickCount();

    switch (btn->state) {
        case STATE_IDLE:
            if (level == 0) {  // 检测到按下
                btn->state = STATE_PRESS_DEBOUNCE;
                btn->last_tick = now;
            }
            break;
        case STATE_PRESS_DEBOUNCE:
            if ((now - btn->last_tick) > pdMS_TO_TICKS(20)) {
                if (level == 0) {
                    btn->state = STATE_PRESSED;
                    // 触发按键事件
                    printf("Button %d pressed!\n", btn->gpio_num);
                } else {
                    btn->state = STATE_IDLE;  // 抖动，回到空闲
                }
            }
            break;
        case STATE_PRESSED:
            if (level == 1) {  // 检测到松开
                btn->state = STATE_RELEASE_DEBOUNCE;
                btn->last_tick = now;
            }
            break;
        case STATE_RELEASE_DEBOUNCE:
            if ((now - btn->last_tick) > pdMS_TO_TICKS(20)) {
                if (level == 1) {
                    btn->state = STATE_IDLE;
                    printf("Button %d released!\n", btn->gpio_num);
                } else {
                    btn->state = STATE_PRESSED;  // 抖动，回到按下
                }
            }
            break;
    }
}

知识体系总览

下面这张图把 GPIO 的核心知识点串起来了。从配置到中断，再到消抖，每一步都有坑，也都有技巧。

避坑指南

• 引脚冲突： GPIO6~GPIO11 默认用于 Flash，别乱用。我刚开始就踩过这个坑，程序死活跑不起来。
• 中断优先级： ESP32 的中断优先级默认够用，别乱改。改高了可能影响 Wi-Fi 和 FreeRTOS 的调度。
• ISR 里别用 printf： printf 会占用大量时间，还可能触发互斥锁——在 ISR 里用就是找死。
• 消抖时间别太短： 5ms 以下基本没用，20ms 是黄金值。如果按键手感差，可以适当加到 30ms。

GPIO 这部分看起来简单，但它是所有外设的基础。配置不对，后面 I2C、SPI、UART 全都会出问题。把 GPIO 吃透了，后面的路就好走了。