STM32 按键状态机:单击、双击与长按的工程实现——从消抖到事件分发的完整做法
按键是最常见的 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 定时扫描做软件消抖,不用延时阻塞;四状态状态机区分单击、双击与长按;单击延迟到双击窗口结束再发,避免抢跑;长按状态直接回空闲,堵住抬起误触发的口子。按这四条做,一颗按键就能稳定承载三种交互,代码还保持干净可扩展。
- 点赞
- 收藏
- 关注作者
评论(0)