单片机与物联网 / 系统课时
按键消抖
按键消抖
机械按键闭合或断开时,触点会在几毫秒内反复跳变,程序若直接读取 GPIO,可能把一次操作识别成多次。本课将分别用阻塞式延时和非阻塞状态机过滤抖动,并说明两种方案的适用边界。
学习目标
- 解释机械触点抖动为何会造成重复触发
- 实现延时消抖和基于系统节拍的状态机消抖
- 根据任务实时性选择合适的消抖方案
按键为什么会抖动
按键内部的金属触点并不会瞬间稳定接触。按下和释放时,弹片会发生机械振动,使 GPIO 电平在高、低之间快速切换。抖动通常只持续数毫秒,但主循环执行速度远高于人工按键速度,因此可能连续读到多个边沿。

消抖的本质不是简单“延迟一下”,而是要求输入电平持续稳定一段时间后,才接受这次状态变化。常用稳定时间可从 10~30 ms 起步,再根据实际按键和示波器波形调整。
延时消抖:简单但会阻塞
最直接的方法是在检测到按下后等待一小段时间,再读取一次。两次读取都为按下状态,才确认事件;随后等待按键释放,避免长按期间重复触发。
下面是片段示例,依赖 STM32 HAL、已完成 GPIO 输入配置,并假设按下时引脚为低电平。
#include <stdbool.h>
#include "stm32f1xx_hal.h"
#define KEY_PORT GPIOA
#define KEY_PIN GPIO_PIN_0
bool Key_GetPressEvent_Blocking(void)
{
if (HAL_GPIO_ReadPin(KEY_PORT, KEY_PIN) != GPIO_PIN_RESET) {
return false;
}
HAL_Delay(20); // 等待触点进入稳定区
if (HAL_GPIO_ReadPin(KEY_PORT, KEY_PIN) != GPIO_PIN_RESET) {
return false;
}
while (HAL_GPIO_ReadPin(KEY_PORT, KEY_PIN) == GPIO_PIN_RESET) {
// 阻塞等待释放,保证一次按压只产生一次事件
}
HAL_Delay(20);
return true;
}预期结果
一次完整按下并释放只返回一次 true;按下和释放阶段的短暂抖动不会产生额外事件。这种方法代码少,适合早期验证或没有实时任务的简单程序。缺点是 HAL_Delay() 和等待释放都会占用 CPU 时间,期间无法及时处理通信、刷新或其他按键。
状态机消抖:非阻塞处理
非阻塞方案持续采样原始电平。当原始值变化时,只记录候选状态和变化时刻;候选状态保持满 20 ms 后,才更新稳定状态。主循环无需停顿,可以同时处理其他任务。
下面是片段示例,依赖 STM32 HAL,并要求初始化时把 stable 和 candidate 设为当前 GPIO 电平。
#include <stdbool.h>
#include <stdint.h>
#include "stm32f1xx_hal.h"
typedef struct {
GPIO_PinState stable;
GPIO_PinState candidate;
uint32_t changedAt;
} KeyDebouncer;
bool Key_Update(KeyDebouncer *key, uint32_t nowMs)
{
GPIO_PinState raw = HAL_GPIO_ReadPin(KEY_PORT, KEY_PIN);
if (raw != key->candidate) {
key->candidate = raw;
key->changedAt = nowMs;
}
if (key->candidate != key->stable &&
nowMs - key->changedAt >= 20U) {
key->stable = key->candidate;
return key->stable == GPIO_PIN_RESET;
}
return false;
}预期结果
主循环持续运行;只有低电平连续稳定至少 20 ms 时返回一次 true,抖动期间始终返回 false。调用时可把 HAL_GetTick() 作为 nowMs,并在每轮主循环执行一次 Key_Update()。使用无符号减法计算时间差,可正确处理系统节拍回绕。
两种方案怎么选
| 方案 | 优点 | 主要限制 | 适用场景 |
|---|---|---|---|
| 延时消抖 | 逻辑直观,代码少 | 阻塞 CPU,扩展多个按键困难 | 单任务演示、快速验证 |
| 状态机消抖 | 非阻塞,易扩展多个按键 | 需要保存状态和时间戳 | 正式项目、通信或实时任务 |
验证时不要只观察 LED 是否变化,还应统计一次按压产生的事件数。连续快速按压、长按和缓慢释放都只应产生预期次数;若仍重复触发,可适当增加稳定时间,而不是无限增加采样频率。