4、按键输入与消抖处理：学习机械按键的工作原理，编写代码实现按键检测，使用软件延时和状态机进行消抖。

按键，是嵌入式系统里最基础、也最容易被忽视的输入方式。你想想看，一个温控面板上，用户最常干的事就是按按键——调温度、切模式、开关机。如果按键检测做不好，按一下变两下，或者按了没反应，那用户体验直接归零。

我个人习惯把按键处理分成三个层次：物理原理、检测方法、消抖策略。咱们一层一层剥开看。

4.1 机械按键的工作原理

机械按键，说白了就是两个金属片。按下去，接通；松开来，断开。ESP32的GPIO口检测到电平变化，就知道按键被按了。

但这里有个坑——机械触点不是理想开关。金属片在接触和分离的瞬间，会像乒乓球一样弹跳几次，每次持续几微秒到几十微秒。这就是所谓的「抖动」。我在项目中遇到过，用示波器一看，按键按下时电平跳了七八次，每次间隔不到1ms。如果不处理，程序会认为你按了七八次。

所以，按键检测的核心就两个问题：

• 怎么检测到按键被按下？
• 怎么区分「抖动」和「真实按下」？

4.2 硬件消抖 vs 软件消抖

消抖有两种思路。硬件上，加个RC低通滤波器，电容一充放电，毛刺就被平滑掉了。但说实话，做温控面板这种产品，每个按键都加电容电阻，成本上不划算，板子空间也紧张。

我更推荐软件消抖。零成本，改代码就行。常用的方法有两种：

方法	原理	优点	缺点
软件延时消抖	检测到电平变化后，延时10~20ms再读一次	简单，容易理解	阻塞CPU，浪费资源
状态机消抖	用状态机记录按键状态，定时采样判断	非阻塞，适合多按键	代码稍复杂

嗯，这里要注意：延时消抖虽然简单，但在RTOS或者事件驱动的系统里，delay()会卡住整个任务。我建议你至少学会状态机消抖，这才是工程级的做法。

4.3 软件延时消抖（入门级）

先来个最直接的。检测到按键按下，等20ms，再读一次。如果还是低电平，确认按下。

// 延时消抖示例
#define KEY_PIN 0  // 假设按键接在GPIO0，按下为低电平

void setup() {
  pinMode(KEY_PIN, INPUT_PULLUP);
  Serial.begin(115200);
}

void loop() {
  if (digitalRead(KEY_PIN) == LOW) {  // 检测到第一次按下
    delay(20);                         // 延时20ms，跳过抖动
    if (digitalRead(KEY_PIN) == LOW) { // 再次确认
      Serial.println("Key Pressed!");
      while (digitalRead(KEY_PIN) == LOW); // 等待松开（简单处理）
    }
  }
}

这段代码能跑，但问题很明显：delay(20) 期间CPU啥也干不了。如果系统里还要读温度、控制继电器、刷新屏幕，这20ms就是灾难。

4.4 状态机消抖（工程级）

状态机消抖，说白了就是用一个有限状态机来跟踪按键的「心理活动」。按键有几种状态？我一般分四个：

• IDLE：空闲状态，按键没被按
• PRESS_DEBOUNCE：检测到按下，正在消抖
• PRESSED：确认按下，等待松开
• RELEASE_DEBOUNCE：检测到松开，正在消抖

你想想看，这个状态机就像一个过滤器。每次采样（比如每10ms一次），根据当前状态和采样值决定下一步。抖动期间的电平跳变，会被状态机自动忽略。

// 状态机消抖示例
typedef enum {
  IDLE,
  PRESS_DEBOUNCE,
  PRESSED,
  RELEASE_DEBOUNCE
} KeyState;

KeyState state = IDLE;
uint8_t key_pin = 0;
uint32_t last_time = 0;
const uint32_t debounce_delay = 20; // 消抖时间20ms

void key_scan() {
  uint8_t level = digitalRead(key_pin);
  uint32_t now = millis();

  switch (state) {
    case IDLE:
      if (level == LOW) {
        state = PRESS_DEBOUNCE;
        last_time = now;
      }
      break;

    case PRESS_DEBOUNCE:
      if (now - last_time >= debounce_delay) {
        if (digitalRead(key_pin) == LOW) {
          state = PRESSED;
          Serial.println("Key Pressed!");
        } else {
          state = IDLE; // 抖动误判，回到空闲
        }
      }
      break;

    case PRESSED:
      if (level == HIGH) {
        state = RELEASE_DEBOUNCE;
        last_time = now;
      }
      break;

    case RELEASE_DEBOUNCE:
      if (now - last_time >= debounce_delay) {
        if (digitalRead(key_pin) == HIGH) {
          state = IDLE;
          Serial.println("Key Released!");
        } else {
          state = PRESSED; // 松开抖动，回到按下状态
        }
      }
      break;
  }
}

void setup() {
  pinMode(key_pin, INPUT_PULLUP);
  Serial.begin(115200);
}

void loop() {
  key_scan(); // 每次循环调用，非阻塞
  // 其他任务照常运行...
}

这段代码的核心思想是：不依赖延时，而是依赖时间差。每次采样只花几微秒，剩下的时间CPU可以干别的。我曾经在一个项目里同时处理8个按键，用的就是这种状态机，跑在ESP32上毫无压力。

4.5 实战建议：多按键与长按检测

温控面板上通常不止一个按键。比如温度+、温度-、模式切换、开关机。你可以把状态机封装成一个结构体，每个按键一个实例。

typedef struct {
  uint8_t pin;
  KeyState state;
  uint32_t last_time;
  void (*on_press)(void);  // 按下回调函数
} Key;

Key keys[4] = {
  {0, IDLE, 0, temp_up},
  {1, IDLE, 0, temp_down},
  {2, IDLE, 0, mode_switch},
  {3, IDLE, 0, power_toggle}
};

void key_scan_all() {
  for (int i = 0; i < 4; i++) {
    key_scan(&keys[i]); // 每个按键独立扫描
  }
}

另外，长按检测也很实用。比如长按3秒进入设置菜单。你可以在PRESSED状态里加一个计时器，如果按下时间超过阈值，触发长按事件。

case PRESSED:
  if (level == HIGH) {
    // 松开处理...
  } else if (now - last_time > 3000) { // 长按3秒
    Serial.println("Long Press!");
    state = IDLE; // 触发后回到空闲
  }
  break;

嗯，这里要注意：长按和短按的触发逻辑要分开。我习惯用回调函数区分，短按一个回调，长按另一个回调，互不干扰。

4.6 避坑指南

最后，分享几个我踩过的坑：

• 上拉电阻别忘：ESP32内部有上拉，但如果你用外部按键，记得加10kΩ上拉电阻。否则悬空时电平不确定，按键会乱跳。
• 中断里别做复杂操作：有人喜欢用外部中断检测按键，然后在ISR里调用Serial.print()。我告诉你，这会导致系统卡死。中断里只设标志位，主循环里处理。
• 消抖时间别写死：我曾经在一个项目里把消抖时间写成10ms，结果换了批按键，抖动时间变长，按键经常误触发。后来改成可配置的宏定义，方便调试。

好了，按键消抖这块就聊到这。下一章咱们会把这些按键逻辑和温控面板的界面结合起来，真正做出一个可交互的产品。