STM32 按键状态机:单击、双击与长按的工程实现——从消抖到事件分发的完整做法

举报
yd_223794387 发表于 2026/11/13 00:24:23 2026/11/13
【摘要】 按键是最常见的 STM32 人机交互入口,需求却远不止"按下亮灯":单击切换模式、双击恢复默认、长按进入设置,三种事件要在一颗按键上共存。新手常写一堆 if 加延时,跑起来单击误判成双击、长按先触发一次单击、消抖还丢键。更稳的做法是把按键抽象成状态机:定时扫描采样,用状态迁移区分三种事件。 一、为什么不用延时消抖按键是机械触点,闭合瞬间会在几毫秒内反复通断,产生一串毛刺。最简单的消抖是检测到...

按键是最常见的 STM32 人机交互入口,需求却远不止"按下亮灯":单击切换模式、双击恢复默认、长按进入设置,三种事件要在一颗按键上共存。新手常写一堆 if 加延时,跑起来单击误判成双击、长按先触发一次单击、消抖还丢键。更稳的做法是把按键抽象成状态机:定时扫描采样,用状态迁移区分三种事件。

一、为什么不用延时消抖

按键是机械触点,闭合瞬间会在几毫秒内反复通断,产生一串毛刺。最简单的消抖是检测到电平变化后延时 10~20ms 再确认,但延时阻塞了主循环,别的任务全被拖住。多任务系统里正确的做法是定时扫描:每 10ms 采样一次电平,连续两次采样一致才认为状态稳定,抖动期间的毛刺自然被滤掉。

#define KEY_DEBOUNCE_MS 10

static uint8_t key_stable = 1;    /* 消抖后的稳定电平,1 表示松开 */
static uint8_t key_last_raw = 1;  /* 上一次原始采样 */

/* 每 10ms 调用一次 */
void Key_Scan_10ms(void)
{
    uint8_t raw = HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_GPIO_Pin);
    if (raw == key_last_raw) {
        key_stable = raw;   /* 连续两次采样一致,采纳为稳定状态 */
    }
    key_last_raw = raw;
}

这个 10ms 扫描可以放在 SysTick 回调或一个 10ms 定时器中断里,成本极低。消抖后得到的 key_stable 就是干净的按键状态,状态机只跟它打交道。

二、四状态的状态机

按键的完整生命周期是四个状态:空闲、按下确认、等待双击、长按触发。按下后先不急着发单击事件——要等一小段时间,看后面有没有第二次按下。

typedef enum {
    KEY_IDLE = 0,     /* 空闲 */
    KEY_PRESS,        /* 按下确认 */
    KEY_WAIT_DOUBLE,  /* 等待双击 */
    KEY_LONG          /* 长按触发 */
} key_state_t;

#define DOUBLE_CLICK_MS 300   /* 双击窗口 */
#define LONG_PRESS_MS   800   /* 长按阈值 */

/* 每 10ms 调用一次 */
void Key_FSM_10ms(void)
{
    static key_state_t state = KEY_IDLE;
    static uint32_t press_tick = 0;

    switch (state) {
    case KEY_IDLE:
        if (key_stable == 0) {
            state = KEY_PRESS;
            press_tick = HAL_GetTick();
        }
        break;
    case KEY_PRESS:
        if (key_stable == 1) {
            state = KEY_WAIT_DOUBLE;
            press_tick = HAL_GetTick();
        } else if (HAL_GetTick() - press_tick >= LONG_PRESS_MS) {
            Key_Event(KEY_LONG_PRESS);
            state = KEY_LONG;
        }
        break;
    case KEY_WAIT_DOUBLE:
        if (key_stable == 0) {
            Key_Event(KEY_DOUBLE_CLICK);
            state = KEY_PRESS;
            press_tick = HAL_GetTick();
        } else if (HAL_GetTick() - press_tick >= DOUBLE_CLICK_MS) {
            Key_Event(KEY_SINGLE_CLICK);
            state = KEY_IDLE;
        }
        break;
    case KEY_LONG:
        if (key_stable == 1) {
            state = KEY_IDLE;
        }
        break;
    default:
        state = KEY_IDLE;
        break;
    }
}

关键点是单击事件要延迟 300ms 才发出:双击的第一次按下抬起后,状态机先进入等待双击状态,只有 300ms 内没等到第二击才补发单击。这样单击永远不会抢在双击前面,代价是单击响应慢 300ms,绝大多数应用都能接受。

三、三个时间常数的取舍

消抖 10ms、双击窗口 300ms、长按阈值 800ms,这三个数不是拍脑袋定的。

消抖窗口取决于按键机械特性,一般 5~20ms;手感偏软的按键抖动更久,取 20ms 更稳,但会吃掉 20ms 的响应速度。

双击窗口是体验参数:300ms 是大多数人连续点两下的自然间隔;窗口太短,慢速双击被拆成两次单击;窗口太长,单击事件延迟太久,用户觉得按键"迟钝"。做产品时这个值最好能按用户习惯微调。

长按阈值要和双击窗口拉开:800ms 明显长于一次点击的持续时间,不会把犹豫的单击误判成长按;但阈值太长,用户按住等反馈会觉得"没反应",可以在 500ms 时先给一个震动或蜂鸣提示,告诉用户"长按已识别,继续按住将触发"。

四、两个常见故障

一是长按后抬起又触发一次单击。原因是在长按状态回空闲时,等待双击的逻辑误把抬起当作一次点击。上面的状态机里长按分支直接回空闲,不经过等待双击状态,就是为了堵这个口子。

二是多按键同时按下一颗丢键。如果每颗按键各写一套状态机变量,代码会迅速膨胀。正确做法是把状态机写成通用函数,按键状态、定时、事件回调都放进一个结构体数组,扫描函数循环处理每一颗键。新增按键只加一行配置,不改逻辑。

typedef struct {
    GPIO_TypeDef *port;   /* 按键 GPIO 端口 */
    uint16_t pin;         /* 按键引脚 */
    key_state_t state;    /* 状态机当前状态 */
    uint32_t tick;        /* 状态计时起点 */
    uint8_t stable;       /* 消抖后稳定电平 */
    uint8_t last_raw;     /* 上一次原始采样 */
    void (*on_event)(key_event_t event); /* 事件回调 */
} key_t;

五、小结

按键多事件的工程做法可以归纳为四条:10ms 定时扫描做软件消抖,不用延时阻塞;四状态状态机区分单击、双击与长按;单击延迟到双击窗口结束再发,避免抢跑;长按状态直接回空闲,堵住抬起误触发的口子。按这四条做,一颗按键就能稳定承载三种交互,代码还保持干净可扩展。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。