单片机与物联网 / 系统课时
用时间窗口过滤机械按键抖动
用时间窗口过滤机械按键抖动
机械按键在按下和松开瞬间会连续跳变,若直接在外部中断回调里计数,一次操作就可能触发多个事件。这里用最后一次边沿之后的 20 ms 静默窗口确认稳定电平,只在确认按下时计数,并通过板载 LED 验证。
学习目标
- 解释为何一次机械按压可能触发多次 EXTI 中断。
- 实现不阻塞主循环的 20 ms 时间窗口消抖。
- 验证每次完整按下只产生一次事件,松开后才能再次触发。
抖动为何会导致重复事件
假设按键一端接 PA0,另一端接 GND,PA0 使用内部上拉:松开为高电平,按下为低电平。接点碰撞可能让电平在 0、2、5、8 ms 多次翻转。若把每次下降沿都当成按下,用户实际只按一次,程序却可能计数多次。
直接在中断里执行 HAL_Delay(20) 并不可取:中断期间等待会妨碍其他任务,且 HAL 时基中断若无法抢占,延时甚至可能无法结束。正确做法是由 EXTI 记录边沿,主循环在时间满足后确认状态。
用静默窗口确认稳定电平
这里采用边沿重置窗口:每出现一个上升沿或下降沿,就更新 last_edge_ms。当当前时间减去最后边沿时间至少为 20 ms,才读取 PA0,并与上一次确认的状态比较。
- 初始确认状态为松开(高电平)。
- 每次 EXTI 双边沿中断只更新时间与序号,不直接产生按键事件。
- 若连续 20 ms 没有新边沿,确认当前电平;若仍与已确认状态相同,则不做事。
- 只有从已确认的高电平转为低电平才产生一次按下事件;确认回到高电平仅用于重新允许下次按下。
例如最后一次抖动发生在 8 ms,那么最早在 28 ms 确认;若 15 ms 又发生新边沿,确认时刻改为最早 35 ms。这里的 20 ms 是实验起点,不代表所有按键的最大抖动时间。

在 STM32F401RE 上实现
以下实验使用 NUCLEO-F401RE、STM32CubeF4 HAL 和板载 LD2(PA5)。另接一只常开按键:PA0 接按键一端,另一端接 GND;不要把 PA0 直接短接到 3.3 V。程序以默认 HSI 时钟和 HAL 的 1 ms 时基运行,20 ms 是可调整的消抖阈值。
在 STM32CubeIDE 新建面向 STM32F401RE 的 HAL 工程,保留自动生成的启动文件、SysTick 处理和 HAL 驱动。此独立实验由代码初始化 PA0、PA5 和 EXTI0,因此不要在 .ioc 中另行启用 PA0 的 EXTI0 中断,以免与代码中的 EXTI0_IRQHandler 重复定义。用以下完整 main.c 替换实验工程生成的同名文件:
#include "stm32f4xx_hal.h"
#define BUTTON_PIN GPIO_PIN_0
#define LED_PIN GPIO_PIN_5
#define DEBOUNCE_MS 20U
static volatile uint32_t last_edge_ms = 0U;
static volatile uint32_t edge_seq = 0U;
static uint32_t handled_seq = 0U;
static GPIO_PinState stable_state;
static volatile uint32_t press_count = 0U;
void HAL_GPIO_EXTI_Callback(uint16_t pin)
{
if (pin == BUTTON_PIN) {
// ISR 仅记录最新边沿,不在中断中等待。
last_edge_ms = HAL_GetTick();
edge_seq++;
}
}
void EXTI0_IRQHandler(void)
{
HAL_GPIO_EXTI_IRQHandler(BUTTON_PIN);
}
static void GPIO_Setup(void)
{
GPIO_InitTypeDef gpio = {0};
__HAL_RCC_GPIOA_CLK_ENABLE();
gpio.Pin = LED_PIN;
gpio.Mode = GPIO_MODE_OUTPUT_PP;
gpio.Pull = GPIO_NOPULL;
gpio.Speed = GPIO_SPEED_FREQ_LOW;
HAL_GPIO_Init(GPIOA, &gpio);
HAL_GPIO_WritePin(GPIOA, LED_PIN, GPIO_PIN_RESET);
gpio.Pin = BUTTON_PIN;
gpio.Mode = GPIO_MODE_IT_RISING_FALLING;
gpio.Pull = GPIO_PULLUP;
HAL_GPIO_Init(GPIOA, &gpio);
stable_state = HAL_GPIO_ReadPin(GPIOA, BUTTON_PIN);
HAL_NVIC_SetPriority(EXTI0_IRQn, 5U, 0U);
HAL_NVIC_EnableIRQ(EXTI0_IRQn);
}
static void Button_Update(void)
{
uint32_t seq;
uint32_t edge_time;
GPIO_PinState level;
// 成对读取中断写入的数据,避免时间和序号不对应。
__disable_irq();
seq = edge_seq;
edge_time = last_edge_ms;
__enable_irq();
if (seq == handled_seq ||
(uint32_t)(HAL_GetTick() - edge_time) < DEBOUNCE_MS) {
return;
}
__disable_irq();
if (edge_seq != seq) {
__enable_irq();
return; // 等待最新边沿重新满20 ms。
}
level = HAL_GPIO_ReadPin(GPIOA, BUTTON_PIN);
handled_seq = seq;
__enable_irq();
if (level != stable_state) {
stable_state = level;
if (level == GPIO_PIN_RESET) {
// 只在已确认的按下转换时计一次事件。
press_count++;
HAL_GPIO_TogglePin(GPIOA, LED_PIN);
}
}
}
int main(void)
{
HAL_Init();
GPIO_Setup();
while (1) {
Button_Update();
}
}预期结果:上电时 LD2 熄灭,完整按下并松开一次后 LD2 亮起,press_count 变为 1;再按一次 LD2 熄灭,计数变为 2。松开本身不会计数。程序没有串口输出,可在调试器中观察 press_count,实际 LED 亮灭取决于按压次数。
验证窗口与处理异常
按下后保持 1 秒,计数应仍只增加 1;松开后再次按下,计数再增加 1。若有逻辑分析仪,可同时观察 PA0 和 LED:PA0 可能快速翻转多次,而 LD2 只在经过静默确认后翻转一次。注意完整按下到灯变化存在约 20 ms 加主循环调度的延迟。
- 一次按下多次计数:检查是否误把
HAL_GPIO_EXTI_Callback当作有效按下事件;若实际抖动超过 20 ms,可先实测再将DEBOUNCE_MS增至 30~50。 - 按键完全无响应:核对 PA0 到 GND 的接线、上拉设置、
EXTI0_IRQn使能与SysTick_Handler是否持续调用HAL_IncTick()。 - 快速点击漏检:持续时间短于静默窗口的有效按压也会被丢弃。应按产品要求取舍延迟与过滤强度,不要盲目增大窗口。
- 长线或强干扰:若干扰产生持续边沿,软件会不断延后确认;应先改善接线、接地与硬件滤波。
时间比较使用无符号 32 位减法,即使 HAL_GetTick() 约 49.7 天回绕,在远短于回绕周期的 20 ms 窗口内仍可正确判断。实际工程还应避免主循环长期阻塞,否则可能错过短促但真实的按键操作。