產品級的按鍵輸入系統設計：去抖、識別與狀態機實踐
加入技術交流群
在嵌入式產品開發中，按鍵輸入看似簡單，但要實現產品級的穩定性和交互體驗，需要考慮多個細節：硬件抖動、長按/短按/連擊的識別、響應延遲、誤觸容錯等。尤其在一些工業控制或消費電子產品中，按鍵響應的準確性與用戶體驗直接相關。
本文將結合實際經驗，圍繞產品級按鍵系統的核心問題展開，包括：軟件去抖動、按鍵事件識別（單擊、雙擊、長按）、基于狀態機的設計思路，并輔以清晰的代碼示例。
一、按鍵抖動的本質與去抖方法
機械式按鍵在觸發時會產生數十毫秒的抖動信號，如圖所示：
高電平 ——┐ ┌────┐ ┌───┐
└────┘ └───┘
↑抖動階段約5~20ms
若不處理這些抖動，將誤觸發多次按鍵事件。典型的軟件去抖方法有兩種：
1.1 延時法（簡單粗暴）
#define KEY_PIN HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0)bool read_key(){ static bool key_last = false; bool key_now = KEY_PIN; if (key_now != key_last)
{
HAL_Delay(20); // 固定延時20ms
key_now = KEY_PIN;
}
key_last = key_now; return key_now;
}
適用于輕量任務，但阻塞式HAL_Delay()在多任務或RTOS下不推薦。
1.2 定時器采樣 + 滑動窗口法（推薦）
#define KEY_FILTER_TIME 5typedef struct {
uint8_t filter_cnt; uint8_t stable_state; uint8_t last_state;
} KeyFilter_t;
KeyFilter_t key1 = {0};void key_filter_task() // 每10ms調用一次{ uint8_t cur = HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0);
if (cur == key1.last_state)
{ if (key1.filter_cnt < KEY_FILTER_TIME)
key1.filter_cnt++; else
key1.stable_state = cur; // 過濾成功，狀態更新
} else
{
key1.filter_cnt = 0;
}
key1.last_state = cur;
}
該方案適用于RTOS或主循環中周期性調用，無阻塞，去抖效果穩定。
二、按鍵事件識別（單擊、雙擊、長按）
產品級系統往往需支持復雜交互。例如：
短按：執行基本操作
長按：進入配置/復位模式
雙擊/多擊：執行特殊功能
關鍵是精確識別不同的按鍵時序。常用方法是記錄按下/釋放的時間戳，并在定時任務中分析事件。
2.1 實用結構體定義
typedef enum {
KEY_IDLE,
KEY_PRESS,
KEY_RELEASE,
KEY_LONG,
KEY_DOUBLE
} KeyEvent_t;typedef struct {
uint8_t stable_state; uint8_t last_state; uint8_t press_flag; uint32_t press_time; uint32_t release_time; uint8_t click_count;
KeyEvent_t event;
} KeyCtrl_t;
2.2 狀態控制邏輯（每10ms調用）
#define KEY_DOWN_LEVEL 0#define LONG_PRESS_TIME 100 // 100 * 10ms = 1s#define DOUBLE_CLICK_TIME 30 // 300msvoid key_scan(KeyCtrl_t *key, uint8_t read_level)
{ // 狀態變化檢測
if (read_level != key->last_state)
{
key->last_state = read_level; if (read_level == KEY_DOWN_LEVEL)
{
key->press_time = 0;
key->press_flag = 1;
} else
{
key->release_time = 0; if (key->press_time < LONG_PRESS_TIME)
key->click_count++; // 累積點擊次數
key->press_flag = 0;
}
} // 長按識別
if (key->press_flag)
{
key->press_time++; if (key->press_time == LONG_PRESS_TIME)
key->event = KEY_LONG;
} // 點擊識別（釋放后計時）
if (!key->press_flag && key->click_count > 0)
{
key->release_time++; if (key->release_time > DOUBLE_CLICK_TIME)
{ if (key->click_count == 1)
key->event = KEY_PRESS; else if (key->click_count == 2)
key->event = KEY_DOUBLE;
key->click_count = 0;
key->release_time = 0;
}
}
}
調用方式：
KeyCtrl_t key1;void SysTick_Handler() // 每10ms調用{ uint8_t key_level = HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0);
key_scan(&key1, key_level);
}
2.3 事件處理
在主循環中讀取：
switch (key1.event)
{ case KEY_PRESS: // 短按操作
do_action(); break; case KEY_LONG: // 長按復位
system_reset(); break; case KEY_DOUBLE: // 雙擊切換模式
toggle_mode(); break; default: break;
}
key1.event = KEY_IDLE; // 清除事件
三、引入狀態機的設計優勢
在產品級設計中，代碼清晰度和可維護性極其重要。直接用變量堆疊判斷邏輯容易混亂。狀態機設計是一種簡潔的思路：每種按鍵狀態對應一個具體行為轉換條件。
3.1 狀態枚舉
typedef enum {
ST_IDLE,
ST_WAIT_RELEASE,
ST_WAIT_SECOND_PRESS,
ST_LONG_PRESS
} KeyState_t;
3.2 狀態切換實現
void key_state_machine(KeyCtrl_t *key)
{ static KeyState_t state = ST_IDLE; switch (state)
{ case ST_IDLE: if (key->stable_state == KEY_DOWN_LEVEL)
{
key->press_time = 0;
state = ST_WAIT_RELEASE;
} break; case ST_WAIT_RELEASE: if (key->stable_state != KEY_DOWN_LEVEL)
{ if (key->press_time < LONG_PRESS_TIME)
state = ST_WAIT_SECOND_PRESS; else
key->event = KEY_LONG, state = ST_IDLE;
} else
{
key->press_time++; if (key->press_time >= LONG_PRESS_TIME)
key->event = KEY_LONG, state = ST_IDLE;
} break; case ST_WAIT_SECOND_PRESS:
key->release_time++; if (key->stable_state == KEY_DOWN_LEVEL)
{
key->event = KEY_DOUBLE;
state = ST_IDLE;
} else if (key->release_time > DOUBLE_CLICK_TIME)
{
key->event = KEY_PRESS;
state = ST_IDLE;
} break; default:
state = ST_IDLE; break;
}
}
四、總結與建議
去抖是基礎：推薦使用定時采樣 + 滑動濾波方式，兼顧實時性和準確性。
事件識別需明確時序：長按、雙擊等需合理時間窗口與狀態標記。
狀態機利于擴展：可讀性好，便于多鍵支持、增加按鍵組合等高級功能。
避免阻塞邏輯：無論是delay或while等待，都應盡量避免使用在中斷或主循環中。
按鍵雖然是最基礎的輸入方式之一，但在產品級別的設計中，它體現的是系統響應能力、用戶體驗和設計規范的綜合考量。
當然也參考一個開源按鍵網站：
https://github.com/murphyzhao/FlexibleButton
評論