最近看了安富萊的按鍵檢測(cè)程序，支持短按，長按，連續(xù)觸發(fā)和組合按鍵。內(nèi)部采用 FIFO 來保存觸發(fā)的按鍵，保證按鍵觸發(fā)不丟失，安富萊的程序穩(wěn)定，可擴(kuò)展性強(qiáng)，可以在實(shí)際工程中使用。以下記錄一些使用上要注意的方面。
在 bsp_key.h 里：

#define KEY_COUNT    2                  /* 按鍵個(gè)數(shù), 2個(gè)獨(dú)立建*/

KEY_COUNT 代表 '實(shí)際按鍵數(shù) + 組合按鍵數(shù)'。

/*

   按鍵濾波時(shí)間50ms, 單位10ms。

   只有連續(xù)檢測(cè)到50ms狀態(tài)不變才認(rèn)為有效，包括彈起和按下兩種事件

   即使按鍵電路不做硬件濾波，該濾波機(jī)制也可以保證可靠地檢測(cè)到按鍵事件

*/

#define KEY_FILTER_TIME   5

#define KEY_LONG_TIME     100           /* 單位10ms， 持續(xù)1秒，認(rèn)為長按事件 */

因?yàn)榘存I檢測(cè)目前是以 10ms 為一周期，所以上述值的單位都為 10ms 。其中 KEY_FILTER_TIME 為濾波的時(shí)間，按下濾波時(shí)間和彈起濾波時(shí)間一致。KEY_LONG_TIME 為按下按鍵之后觸發(fā)“長按”的時(shí)間，只有觸發(fā)長按之后才可以進(jìn)行“連續(xù)觸發(fā)'。

每個(gè)按鍵的數(shù)據(jù)結(jié)構(gòu)如下：

typedef struct{
    /* 下面是一個(gè)函數(shù)指針，指向判斷按鍵手否按下的函數(shù) */
    uint8_t (*IsKeyDownFunc)(void); /* 按鍵按下的判斷函數(shù),1表示按下 */

    uint8_t  Count;         /* 濾波器計(jì)數(shù)器 */
    uint16_t LongCount;     /* 長按計(jì)數(shù)器 */
    uint16_t LongTime;      /* 按鍵按下持續(xù)時(shí)間, 0表示不檢測(cè)長按 */
    uint8_t  State;         /* 按鍵當(dāng)前狀態(tài)（按下還是彈起） */
    uint8_t  RepeatSpeed;   /* 連續(xù)按鍵周期 */
    uint8_t  RepeatCount;   /* 連續(xù)按鍵計(jì)數(shù)器 */}KEY_T;

函數(shù)指針 IsKeyDownFunc 根據(jù)實(shí)際硬件環(huán)境調(diào)整，內(nèi)部實(shí)現(xiàn)需保證按下按鈕后返回 1 。
Count 是一個(gè)濾波計(jì)數(shù)器，用來判斷濾波時(shí)間是否到達(dá)，供內(nèi)部使用。
LongCount 是一個(gè)長按計(jì)數(shù)器，用來判斷觸發(fā)”長按“的時(shí)間是否到達(dá)，供內(nèi)部使用。
LongTime 即按下按鍵后觸發(fā)”長按“的時(shí)間，默認(rèn)為 KEY_LONG_TIME 。為 0 則代表不支持長按。
State 為按鍵當(dāng)前狀態(tài)，1 為按下，0 為未按下。
RepeatSpeed 為”連續(xù)觸發(fā)“按鍵的周期，以 10ms 為單位，原因同上。
RepeatCount 為”連續(xù)觸發(fā)'的計(jì)數(shù)器，供內(nèi)部使用。

使用的 FIFO 數(shù)據(jù)結(jié)構(gòu)如下：

/* 按鍵FIFO用到變量 */

#define KEY_FIFO_SIZE   10

typedef struct

{

    uint8_t Buf[KEY_FIFO_SIZE];     /* 鍵值緩沖區(qū) */

    uint8_t Read;                   /* 緩沖區(qū)讀指針1 */

    uint8_t Write;                  /* 緩沖區(qū)寫指針 */

    uint8_t Read2;                  /* 緩沖區(qū)讀指針2 */

}KEY_FIFO_T;

這就是一個(gè)簡(jiǎn)單的 FIFO 隊(duì)列，其中 Read2 的作用還理解的不是很清楚。

以下為提供 API :

/* 供外部調(diào)用的函數(shù)聲明 */

void bsp_InitKey(void);

void bsp_KeyScan(void);

void bsp_PutKey(uint8_t _KeyCode);

uint8_t bsp_GetKey(void);

uint8_t bsp_GetKey2(void);

uint8_t bsp_GetKeyState(KEY_ID_E _ucKeyID);

void bsp_SetKeyParam(uint8_t _ucKeyID, uint16_t _LongTime, uint8_t  _RepeatSpeed);

void bsp_ClearKey(void);

void bsp_InitKey(void) 需要在最開始調(diào)用。

void bsp_KeyScan(void) 需要周期性調(diào)用，一般放在 SysTick 中斷函數(shù)里每 10ms 調(diào)用一次。

void bsp_PutKey(uint8_t _KeyCode) 為向 FIFO 里存入當(dāng)前的鍵值（即哪一個(gè)按鍵的哪一個(gè)狀態(tài)）。

uint8_t bsp_GetKey(void) 為從 FIFO 里讀取下一個(gè)鍵值并返回。

uint8_t bsp_GetKey2(void) 也是從 FIFO 里讀取下一個(gè)鍵值并返回，不過它的指針是 Read2 ，具體用處還不知，一般可以不用。

uint8_t bsp_GetKeyState(KEY_ID_E _ucKeyID) 得到指定按鍵當(dāng)前的狀態(tài)，1 表按下，0 表為按下。

void bsp_SetKeyParam(uint8_t _ucKeyID, uint16_t _LongTime, uint8_t  _RepeatSpeed) 為修改指定按鍵的一些參數(shù)， _LongTime 為按下后觸發(fā)”長按“的時(shí)間， _RepeatSpeed 為”連續(xù)按鍵“的周期。

void bsp_ClearKey(void) 清除 FIFO 里的所有鍵值。

該代碼需要根據(jù)具體的硬件環(huán)境移植，不過難度不大，安富萊提供了 STM32F103 標(biāo)準(zhǔn)庫的版本和 STM32F407 HAL庫的 bsp 版本，使用起來差不多，不過移植不一樣。

當(dāng)然，該代碼里有一個(gè)隱藏的 BUG，如果你一直往 FIFO 里面填充數(shù)據(jù)，而不讀出來的話，考慮以下情況：
若大小為 10 的 FIFO 緩存空間，Read 指向 0，Write 指向 9，若此時(shí)再填充一個(gè)數(shù)據(jù)，則 Write 為 0。而判斷 FIFO 內(nèi)是否有數(shù)據(jù)使用的是 Read != Write，所以有一點(diǎn)小問題。只要保證及時(shí)把數(shù)據(jù)讀出來就問題不大。