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

按键，是嵌入式系统里最基础、也最容易出问题的输入方式。你想想看，一个简单的开关动作，背后却藏着电平确认、机械抖动、实时响应等一系列坑。我做了这么多年硬件，见过太多因为按键处理不当导致的“幽灵触发”问题——设备莫名其妙地开关、参数乱跳，最后查出来就是消抖没做好或者中断配置错了。

这一章，我们就彻底把按键这件事讲透。从最底层的数字输入原理，到上拉/下拉电阻的选择，再到软件消抖和外部中断的实战配置。学完这一章，你写的按键程序会像瑞士钟表一样可靠。

3.1 数字输入的本质：GPIO 读到的到底是什么？

ESP32 的 GPIO 引脚，在输入模式下，读到的就是一个数字电平：高电平（1） 或 低电平（0）。但问题是，这个电平从哪来？

当按键按下时，我们希望引脚电平明确变化。可如果引脚悬空（什么都没接），它读到的值是不确定的——可能受周围电磁干扰乱跳。这就是为什么我们需要上拉电阻或下拉电阻。

3.2 上拉/下拉电阻的选型：10kΩ 为什么是黄金值？

电阻值选大了还是选小了？这个问题我在项目里被问过无数次。

• 电阻太小（如 1kΩ）：按键按下时电流过大，浪费功耗，还可能超过 GPIO 的驱动能力。
• 电阻太大（如 100kΩ）：引脚输入阻抗高，容易耦合噪声，导致误触发。
• 10kΩ 是行业惯例：功耗与抗干扰的平衡点。在 3.3V 供电下，按键按下时电流仅 0.33mA，安全且稳定。

3.3 软件消抖：别让机械特性毁了你的逻辑

机械按键有个物理特性：按下和释放的瞬间，触点会弹跳几次，持续约 5-20ms。如果不做处理，一次按键会被单片机误认为多次触发。

软件消抖的原理很简单：检测到电平变化后，等一段时间再确认。常用的方法有两种：

3.3.1 延时消抖法（简单粗暴）

// 延时消抖示例
int button_state = digitalRead(BUTTON_PIN);
if (button_state == LOW) {  // 检测到按下
    delay(20);               // 等待 20ms 跳过抖动
    if (digitalRead(BUTTON_PIN) == LOW) {  // 再次确认
        // 按键有效，执行动作
    }
}

这种方法简单，但 delay() 会阻塞程序。在复杂系统中，20ms 的阻塞可能让其他任务错过时机。

3.3.2 状态机消抖法（推荐）

// 状态机消抖——不阻塞，适合实时系统
#define DEBOUNCE_TIME 20  // 消抖时间 20ms

static int last_stable_state = HIGH;
static unsigned long last_debounce_time = 0;

void debounce_loop() {
    int reading = digitalRead(BUTTON_PIN);
    if (reading != last_stable_state) {
        last_debounce_time = millis();  // 记录变化时间
    }
    if ((millis() - last_debounce_time) > DEBOUNCE_TIME) {
        if (reading != last_stable_state) {
            last_stable_state = reading;
            if (last_stable_state == LOW) {
                // 按键按下，执行动作
            }
        }
    }
}

3.4 外部中断：让 CPU 从轮询中解放出来

轮询（Polling）是不断读取 GPIO 状态，浪费 CPU 资源。外部中断（External Interrupt）则是在引脚电平变化时，硬件自动通知 CPU，CPU 暂停当前任务去处理中断服务函数（ISR）。

ESP32 的大部分 GPIO 都支持外部中断，触发方式有四种：

3.5 中断服务函数（ISR）：短、平、快

写 ISR 有一条铁律：越快越好，越短越好。因为 ISR 执行期间，主程序被挂起，其他中断也被屏蔽（取决于优先级）。

ISR 里不能做的事：

• 不能调用 delay()——它会阻塞中断系统
• 不能做串口打印（Serial.print()）——耗时且可能死锁
• 不能动态分配内存（malloc()）——非线程安全

ISR 里应该做的事：

• 设置一个全局标志位（volatile 修饰）
• 记录时间戳
• 递增计数器

// 正确的 ISR 写法
volatile bool button_pressed = false;
volatile unsigned long press_time = 0;

void IRAM_ATTR button_isr() {
    button_pressed = true;
    press_time = millis();  // 记录按下时刻
}

void setup() {
    pinMode(BUTTON_PIN, INPUT_PULLUP);
    attachInterrupt(digitalPinToInterrupt(BUTTON_PIN), button_isr, FALLING);
}

void loop() {
    if (button_pressed) {
        button_pressed = false;  // 清除标志
        // 在主循环中处理消抖和动作
        if ((millis() - press_time) > 20) {
            // 确认按键有效
        }
    }
}

3.6 本章知识体系：按键输入与中断全景图

下面这张图，把按键输入到中断响应的完整链路画了出来。你可以把它当作调试时的检查清单。

3.7 实战建议：从原理图到代码的检查清单

每次我做按键相关的设计，都会过一遍这个清单，你可以直接拿去用：

1. 原理图检查：按键是否接在 GND 和 GPIO 之间？上拉电阻是否 10kΩ 到 VCC？
2. GPIO 初始化：pinMode(pin, INPUT_PULLUP) 是否启用内部上拉？如果外部已有上拉，用 INPUT 即可。
3. 消抖逻辑：是否用了非阻塞的状态机？消抖时间是否在 15-25ms 之间？
4. 中断配置：触发沿是否正确（按下用 FALLING，释放用 RISING）？ISR 是否足够短？
5. 变量修饰：ISR 和主循环共享的变量是否加了 volatile？