4、实战：按键消抖与长按短按检测——基于状态机的实现

按键处理，看起来简单吧？

不就是读个GPIO电平嘛。但我见过太多项目，栽在这个“简单”的事情上。按键抖动导致误触发、长按短按逻辑混乱、轮询方式把CPU耗死……这些问题，说白了都是因为没有用对方法。

今天我们就来彻底解决它。用状态机，把按键消抖和长按短按检测，做成一个干净、可移植、低功耗的模块。

4.1 按键抖动的本质

机械按键按下和释放的瞬间，触点会弹跳。示波器上看，不是干净的高低电平跳变，而是一串毛刺。这个毛刺持续时间，一般在5~20ms。

如果不处理，一次按下可能被识别成几十次。我在一个工业手持设备上遇到过，操作员按一下“确认”，屏幕跳了三次菜单。用户投诉说“这机器疯了”。

4.2 状态机模型：三态按键检测

我个人习惯，把按键检测拆成三个状态：

状态	含义	触发条件
IDLE	空闲态，按键未按下	检测到高电平（释放）
DEBOUNCE	消抖态，等待电平稳定	检测到低电平（按下）
PRESSED	确认按下态，开始计时区分长短按	消抖计时结束，电平仍为低

你想想看，这个模型的好处是什么？

它把“消抖”和“长短按检测”解耦了。消抖只负责确认按下，长短按在PRESSED态里用计时器处理。逻辑清晰，不容易出bug。

4.3 代码实现：状态机核心

下面是我在实际项目中用的一段代码，去掉了硬件相关部分，保留了核心逻辑。你可以直接移植。

// 按键状态枚举
typedef enum {
    KEY_IDLE,
    KEY_DEBOUNCE,
    KEY_PRESSED
} KeyState_t;

// 按键数据结构
typedef struct {
    KeyState_t state;
    uint32_t debounce_tick;   // 消抖计时起点
    uint32_t press_tick;      // 按下计时起点
    uint8_t  pin_level;       // 当前电平
    uint8_t  last_stable;     // 上次稳定电平
} Key_t;

// 消抖时间 20ms，长按阈值 1000ms
#define DEBOUNCE_MS  20
#define LONG_PRESS_MS 1000

// 按键扫描函数，每10ms调用一次
void Key_Scan(Key_t *key, uint8_t level, uint32_t tick_ms) {
    switch (key->state) {
        case KEY_IDLE:
            if (level == 0) {  // 检测到按下
                key->state = KEY_DEBOUNCE;
                key->debounce_tick = tick_ms;
            }
            break;

        case KEY_DEBOUNCE:
            if (level == 0) {
                // 持续低电平，等待消抖时间到
                if ((tick_ms - key->debounce_tick) >= DEBOUNCE_MS) {
                    key->state = KEY_PRESSED;
                    key->press_tick = tick_ms;
                    // 触发短按事件（后续可升级）
                    Event_Post(EVENT_KEY_SHORT_PRESS);
                }
            } else {
                // 抖动回高电平，回到空闲
                key->state = KEY_IDLE;
            }
            break;

        case KEY_PRESSED:
            if (level == 0) {
                // 持续按下，检查长按
                if ((tick_ms - key->press_tick) >= LONG_PRESS_MS) {
                    // 触发长按事件
                    Event_Post(EVENT_KEY_LONG_PRESS);
                    key->state = KEY_IDLE;  // 防止重复触发
                }
            } else {
                // 释放按键
                key->state = KEY_IDLE;
            }
            break;
    }
}

4.4 状态机流程图

下面这张图，把整个按键检测的流转画清楚了。建议你保存下来，写代码时对照着看。

4.5 避坑指南：我踩过的三个坑

代码看起来简单，但实际用起来，有几个地方特别容易翻车。

• 消抖时间太短或太长。 我曾经为了“响应快”，把消抖时间设成5ms。结果在振动环境下，按键疯狂误触发。后来改成20ms，世界清净了。建议：一般5~30ms，具体看按键手册或实测。
• 长按阈值没考虑累加误差。 如果扫描周期不是精确的10ms，而是有抖动，累计误差会导致长按时间不准。我的做法：用硬件定时器或RTOS的绝对时间戳，不要用“计数++”的方式。
• 状态机里做阻塞延时。 千万别在状态机里写delay(20)。这会阻塞整个系统。状态机本身就是非阻塞的，靠时间戳判断，而不是靠死等。

4.6 扩展：支持双击和三击

状态机的好处是容易扩展。想支持双击？加一个状态就行。

// 在 PRESSED 态释放后，进入 WAIT_DOUBLE 态
// 如果在 300ms 内再次按下，触发双击事件
// 超时则触发单击事件

这个思路，我在智能家居面板上用过。一个按键，实现单击开灯、双击关灯、长按调色温。用户反馈很好，说“一个按键搞定所有”。

4.7 低功耗考量

对于电池供电的设备，按键检测不能一直跑。

• 空闲时：关闭按键扫描，让CPU进入休眠。用GPIO中断唤醒。
• 唤醒后：启动10ms定时器，进入状态机扫描。
• 按键释放后：延迟几秒，再次休眠。

这样，平均功耗可以从mA级降到μA级。我做过一个遥控器，两节AAA电池用了两年，靠的就是这套策略。