3. 按键输入与中断：数字输入、内部上拉/下拉电阻、外部中断配置、消抖处理

按键，是嵌入式系统里最基础、也最容易被轻视的输入方式。你想想看，一个简单的开关动作，背后却牵扯到电平检测、电阻配置、中断响应、信号抖动——任何一个环节没处理好，你的设备就可能出现“按一下跳三下”的尴尬局面。这一章，我们就来把这些坑一个个填平。

3.1 数字输入的本质：读GPIO电平

ESP32的GPIO作为数字输入时，核心任务就一个：读取引脚上的电压是高（3.3V）还是低（0V）。硬件上，内部有一个施密特触发器，能把模拟信号整形成干净的0/1逻辑电平。

我个人习惯，在配置输入引脚时，一定会先确认两件事：

• 引脚默认电平是什么？——浮空时是高还是低？
• 按键按下时，电平怎么变？——按下拉低还是拉高？

这两个问题直接决定了你的电路设计和代码逻辑。举个例子，按键一端接GND、另一端接GPIO，按下时GPIO读到低电平，这叫低电平有效；反过来接VCC就是高电平有效。我个人偏爱低电平有效，因为大多数MCU内部默认有上拉电阻，省一个外部元件。

3.2 内部上拉/下拉电阻：省掉外部元件的秘诀

ESP32的GPIO内部集成了可编程的上拉和下拉电阻，阻值大约在45kΩ左右。这意味着，很多场景下你不需要在PCB上额外焊接电阻。

3.3 外部中断配置：让CPU不再“傻等”

轮询方式读取按键，CPU得一直盯着GPIO，浪费算力。中断方式则是在电平变化时主动通知CPU，效率高得多。ESP32的每个GPIO都可以配置为外部中断源，支持以下触发模式：

• 上升沿触发：电平从低变高时触发
• 下降沿触发：电平从高变低时触发
• 任意沿触发：电平变化时都触发
• 低电平触发：电平为低时持续触发
• 高电平触发：电平为高时持续触发

按键场景下，我通常用下降沿触发（低电平有效）或上升沿触发（高电平有效）。电平触发模式容易产生连续中断，需要额外处理，一般不建议用在按键上。

配置中断的步骤大致如下：

1. 初始化GPIO为输入模式，设置上拉/下拉
2. 调用gpio_set_intr_type()设置中断触发类型
3. 安装GPIO中断服务：gpio_install_isr_service(0)
4. 添加中断处理函数：gpio_isr_handler_add()
5. 在ISR中处理按键逻辑（注意：ISR内不能做耗时操作）

// 按键中断配置示例
#define BUTTON_GPIO  0   // BOOT按键通常接GPIO0

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 = {};
    io_conf.intr_type = GPIO_INTR_NEGEDGE;    // 下降沿触发
    io_conf.mode = GPIO_MODE_INPUT;
    io_conf.pin_bit_mask = (1ULL << BUTTON_GPIO);
    io_conf.pull_up_en = 1;                   // 内部上拉
    gpio_config(&io_conf);

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

3.4 消抖处理：别让按键“抖”成连发

机械按键在按下和释放的瞬间，触点会物理弹跳，产生多个脉冲。如果不做消抖，一次按键可能被误判为多次。示波器上看，这个抖动过程通常持续5~20ms。

消抖方法主要有两种：

软件消抖里，我个人最常用的是延时采样法：检测到电平变化后，等待10~20ms再读一次，如果电平状态一致，就确认是有效按键。另一种是连续多次采样法，在短时间内连续读取N次，如果结果一致才判定有效。

// 延时消抖示例
#define DEBOUNCE_MS  20

int read_button_debounced(int gpio_num) {
    if (gpio_get_level(gpio_num) == 0) {          // 检测到按下
        vTaskDelay(pdMS_TO_TICKS(DEBOUNCE_MS));   // 等待20ms
        if (gpio_get_level(gpio_num) == 0) {      // 再次确认
            return 1;  // 有效按下
        }
    }
    return 0;
}

3.5 知识体系总览

下面这张图，把按键输入与中断的完整链路画了出来。从物理按键到CPU响应，每一步都有对应的配置和注意事项。

3.6 完整示例：带消抖的中断按键

把上面所有知识点串起来，一个完整的按键驱动应该是这样的：

#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "freertos/queue.h"
#include "driver/gpio.h"

#define BUTTON_GPIO  0
#define DEBOUNCE_MS  20

static QueueHandle_t button_evt_queue = NULL;

// 中断处理函数（ISR上下文）
static void IRAM_ATTR button_isr_handler(void* arg) {
    uint32_t gpio_num = (uint32_t) arg;
    xQueueSendFromISR(button_evt_queue, &gpio_num, NULL);
}

// 按键处理任务（任务上下文）
void button_task(void* arg) {
    uint32_t io_num;
    while (1) {
        if (xQueueReceive(button_evt_queue, &io_num, portMAX_DELAY)) {
            // 延时消抖
            vTaskDelay(pdMS_TO_TICKS(DEBOUNCE_MS));
            if (gpio_get_level(io_num) == 0) {
                printf("按键按下！GPIO:%d\n", io_num);
                // 在这里处理你的业务逻辑
            }
        }
    }
}

void app_main(void) {
    // 初始化按键GPIO
    gpio_config_t io_conf = {};
    io_conf.intr_type = GPIO_INTR_NEGEDGE;
    io_conf.mode = GPIO_MODE_INPUT;
    io_conf.pin_bit_mask = (1ULL << BUTTON_GPIO);
    io_conf.pull_up_en = 1;
    gpio_config(&io_conf);

    // 创建事件队列
    button_evt_queue = xQueueCreate(10, sizeof(uint32_t));

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

    // 创建按键处理任务
    xTaskCreate(button_task, "button_task", 2048, NULL, 10, NULL);
}

嗯，到这里，按键输入与中断的核心内容就讲完了。从硬件配置到软件消抖，再到中断服务的设计模式，每一步都有它的道理。你写代码的时候，不妨多想想：这个按键按下后，系统到底经历了什么？