📚 课程目录第3章按键输入与中断

3. 按键输入与中断：数字输入、上拉/下拉电阻、软件消抖、外部中断

按键，是嵌入式系统里最基础、也最容易出问题的输入方式。你想想看，一个简单的开关动作，背后却藏着电平抖动、引脚浮空、响应延迟这些坑。我刚开始用 ESP32 做项目时，就因为在按键处理上偷了懒，结果产品在客户现场频繁误触发，差点被退货。

这一章，我们就彻底把按键这件事讲透。从硬件原理到软件消抖，再到中断机制，一步步搭建一个可靠、高效的按键输入系统。

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

ESP32 的 GPIO 引脚，在数字输入模式下，只能读到两个值：高电平（1） 和 低电平（0）。按键按下或松开，本质上就是改变引脚上的电平状态。

但这里有个关键问题：引脚悬空时，电平是不确定的。你读到的可能是 0，也可能是 1，甚至会在两者之间随机跳变。这就是为什么我们需要上拉或下拉电阻。

3.2 上拉与下拉电阻：给引脚一个“默认状态”

上拉电阻把引脚默认拉到高电平，下拉电阻则拉到低电平。按键按下时，引脚被强行拉到相反的电平。这样，电平状态就变得可预测了。

电路类型	默认电平	按下时电平	适用场景
上拉电阻（接 VCC）	高（1）	低（0）	按键一端接地
下拉电阻（接 GND）	低（0）	高（1）	按键一端接 VCC

我的习惯： 优先使用上拉电阻 + 按键接地。因为大多数 MCU 的 GPIO 内部自带可配置的上拉电阻，省一个外部元件。而且接地按键在电磁干扰环境下更稳定。

ESP32 内部有可编程的上拉/下拉电阻。你可以通过 gpio_set_pull_mode() 函数来配置，省去外部电阻。但要注意，内部上拉电阻的阻值通常在 45kΩ 左右，对于长线缆或高噪声环境，外部 10kΩ 上拉会更可靠。

3.3 软件消抖：别让按键“抖”个不停

机械按键在按下和松开的瞬间，金属触点会弹跳几次，产生一连串的脉冲信号。这个过程通常持续 5-20ms。如果不做处理，一次按键会被误认为多次触发。

我见过最典型的案例：一个同事用轮询方式读按键，没加消抖，结果按一次，串口打印出七八条消息。用户反馈说“这设备反应太快了，我按一下它执行好几遍”。

软件消抖的常用方法有两种：

延时消抖： 检测到电平变化后，等待 10-20ms，再次读取确认。
连续采样消抖： 在短时间内多次采样，如果连续 N 次结果一致，才认为状态稳定。

我个人更推荐第二种，因为它不会阻塞程序执行。下面是一个简单的连续采样消抖代码：

#define DEBOUNCE_TIME_MS  20
#define SAMPLE_COUNT      5

uint8_t debounce_read(gpio_num_t pin) {
    uint8_t stable_count = 0;
    uint8_t last_level = gpio_get_level(pin);
    
    for (int i = 0; i < SAMPLE_COUNT; i++) {
        vTaskDelay(pdMS_TO_TICKS(DEBOUNCE_TIME_MS / SAMPLE_COUNT));
        uint8_t current_level = gpio_get_level(pin);
        if (current_level == last_level) {
            stable_count++;
        } else {
            stable_count = 0;
            last_level = current_level;
        }
    }
    
    return (stable_count >= (SAMPLE_COUNT - 1)) ? last_level : !last_level;
}

注意： 延时消抖中的 vTaskDelay() 会让出 CPU，适合在 FreeRTOS 任务中使用。如果你在裸机循环里用 delay() 消抖，整个系统都会被卡住。

3.4 外部中断：让 CPU 不再“空转”

轮询方式读按键，CPU 要不停地检查引脚电平，浪费大量算力。外部中断则不同：只有电平变化时，CPU 才响应。平时该干嘛干嘛，效率高得多。

ESP32 的每个 GPIO 都可以配置为外部中断源。支持以下触发方式：

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

配置中断的步骤很简单：

设置 GPIO 为输入模式
配置中断触发类型
注册中断服务函数（ISR）
使能中断

下面是一个完整的按键中断示例：

#include "driver/gpio.h"

#define BUTTON_PIN   GPIO_NUM_0   // 开发板上的 BOOT 按键

// 中断服务函数
static void IRAM_ATTR button_isr_handler(void* arg) {
    // 注意：ISR 中不能调用 printf 等阻塞函数
    // 通常只设置一个标志位，让主循环处理
    uint32_t gpio_num = (uint32_t) arg;
    xQueueSendFromISR(button_evt_queue, &gpio_num, NULL);
}

void button_init(void) {
    // 1. 配置 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_PIN);
    io_conf.pull_up_en = GPIO_PULLUP_ENABLE;  // 启用内部上拉
    io_conf.pull_down_en = GPIO_PULLDOWN_DISABLE;
    gpio_config(&io_conf);

    // 2. 创建队列（用于 ISR 和主任务通信）
    button_evt_queue = xQueueCreate(10, sizeof(uint32_t));

    // 3. 安装 GPIO 中断服务
    gpio_install_isr_service(0);

    // 4. 注册 ISR
    gpio_isr_handler_add(BUTTON_PIN, button_isr_handler, (void*) BUTTON_PIN);
}

  关键点： ISR 中要避免长时间操作。我通常只在 ISR 里设置一个标志位或发送一个队列消息，真正的按键处理（包括消抖）放在主循环或任务中完成。

3.5 知识体系总览

下面这张图总结了按键输入与中断的完整知识结构：

3.6 避坑指南：我踩过的那些雷

做按键处理这么多年，我总结了几条血泪教训：

内部上拉不够强： 有一次在强电磁干扰环境下测试，内部上拉电阻扛不住噪声，按键频繁误触发。后来换成外部 4.7kΩ 上拉，问题解决。
ISR 里别做复杂操作： 我曾经在 ISR 里直接调用 printf() 打印调试信息，结果系统死机。因为 printf 本身是阻塞的，而且可能触发中断嵌套。
消抖时间不是固定的： 不同按键的弹跳时间不一样。我建议在调试阶段用逻辑分析仪抓一下波形，根据实际波形设置消抖参数。
中断优先级要合理： ESP32 的中断优先级从 0 到 31，数值越大优先级越高。按键中断一般设中等优先级就行，别跟定时器等高优先级中断抢资源。

我的调试小技巧： 在按键 ISR 里翻转一个 GPIO 输出，用示波器或逻辑分析仪抓这个引脚。如果看到连续多个脉冲，说明消抖没做好。如果只有干净的一个脉冲，说明消抖参数合适。

好了，按键输入与中断的核心内容就这些。从硬件上拉/下拉，到软件消抖，再到中断机制，每一步都关系到系统的稳定性和响应速度。把这些基础打牢，后面的项目才能跑得稳。