分享一個(gè)很好用的按鍵組件
[導(dǎo)讀]在嵌入式系統(tǒng)或單片機(jī)程序開(kāi)發(fā)過(guò)程中，經(jīng)常會(huì)遇到各種按鍵的需求，比如按鍵短按、按鍵長(zhǎng)按、按鍵雙擊，這些功能雖然不難，但想要完全寫(xiě)好這些功能并不簡(jiǎn)單。網(wǎng)上已經(jīng)有大神實(shí)現(xiàn)了這樣的組件，該組件的特性如下： 使用時(shí)系統(tǒng)不阻塞 低耦合性 同一個(gè)按鍵可實(shí)現(xiàn)
在嵌入式系統(tǒng)或單片機(jī)程序開(kāi)發(fā)過(guò)程中，經(jīng)常會(huì)遇到各種按鍵的需求，比如按鍵短按、按鍵長(zhǎng)按、按鍵雙擊，這些功能雖然不難，但想要完全寫(xiě)好這些功能并不簡(jiǎn)單。網(wǎng)上已經(jīng)有大神實(shí)現(xiàn)了這樣的組件，該組件的特性如下：
-
使用時(shí)系統(tǒng)不阻塞 -
低耦合性 -
同一個(gè)按鍵可實(shí)現(xiàn)單擊、雙擊、長(zhǎng)按 -
可根據(jù)按鍵線序更改，比如高電平觸發(fā)或低電平觸發(fā)
按鍵檢測(cè)組件函數(shù)接口如下:
一、初始化按鍵
/**
* @name Init_Key_Struct
* @brief 初始化按鍵
* @param Update_Key_CallBack：更新按鍵狀態(tài)
* @param Debug_CallBack：打印按鍵調(diào)試信息
* @retval 0：成功；
* 1：Update_Key_CallBack == NULL；
*/
char Init_Key_Struct(void (*Update_Key_CallBack)(void), void (*Debug_CallBack)(unsigned char *debug_mess));
-
參數(shù)Update_Key_CallBack用于更新按鍵狀態(tài)，即按下或者釋放，是一個(gè)函數(shù)指針，該值一定不能為NULL。 -
參數(shù)Debug_CallBack用于打印按鍵組件的異常信息，也是一個(gè)函數(shù)指針，如果不需要時(shí)候可以將該參數(shù)寫(xiě)NULL。
二、注冊(cè)按鍵
/**
* @name Reg_Key
* @brief 添加注冊(cè)按鍵（注：如果按鍵已經(jīng)注冊(cè)過(guò)，那么再次注冊(cè)會(huì)覆蓋之前注冊(cè)過(guò)的相同的按鍵）
* @param key_s：按鍵狀態(tài)
* @param count：按鍵計(jì)數(shù)
* @param Trig_Mode_E：按鍵觸發(fā)模式
* @param Key_Mode_E：按鍵模式
* @param Key_Click_CallBack：按鍵觸發(fā)回調(diào)
* @retval 0：成功；
* 1：Key_Click_CallBack == NULL；
* 2：Key.Reg_Key_Num > Key_Num_Max；
*/
char Reg_Key(unsigned char *key_s, const unsigned short count,
Trig_Mode_TypeDef Trig_Mode_E, Key_Mode_TypeDef Key_Mode_E, void (*Key_Click_CallBack)(void));
-
參數(shù)key_s為按鍵狀態(tài)，即是按鍵按下或者釋放，可以與"一"中的Update_Key_CallBack回調(diào)函數(shù)關(guān)聯(lián)起來(lái)。 -
參數(shù)count為按鍵計(jì)數(shù)，意思是當(dāng)按鍵按下多少次后出發(fā)對(duì)應(yīng)的回調(diào)，這個(gè)回調(diào)就是參數(shù)Key_Click_CallBack -
參數(shù)Trig_Mode_E，指的是按鍵的出發(fā)方式，該組件用一個(gè)枚舉來(lái)進(jìn)行描述：
/**
* @brief 按鍵觸發(fā)模式狀態(tài)枚舉
*/
typedef enum
{
N_Trig = 0, /*!< 0 空 */
L_Trig , /*!< 1 低電平觸發(fā) */
H_Trig, /*!< 2 高電平觸發(fā) */
}Trig_Mode_TypeDef;
-
參數(shù)Key_Mode_E為按鍵模式，有單擊，雙擊，長(zhǎng)按三種，該組件也是用一個(gè)枚舉來(lái)進(jìn)行描述:
/**
* @brief 按鍵模式狀態(tài)枚舉
*/
typedef enum
{
N_Click = 0, /*!< 0 空 */
S_Click , /*!< 1 單擊 */
D_Click, /*!< 2 雙擊 */
L_Press, /*!< 3 長(zhǎng)按 */
}Key_Mode_TypeDef;
-
參數(shù)Key_Click_CallBack，也就是相應(yīng)模式下出發(fā)的回調(diào)函數(shù)了，這是一個(gè)函數(shù)指針。
三、按鍵檢測(cè)
/**
* @name Key_Detect
* @brief 按鍵檢測(cè)
* @param 無(wú)
* @retval 0：成功；
* 1：Key.Update_Key_CallBack == NULL；
*/
char Key_Detect(void);
該接口是用來(lái)檢測(cè)按鍵狀態(tài)的，使用該函數(shù)時(shí)，需要周期性的進(jìn)行調(diào)用，當(dāng)函數(shù)返回0時(shí)，表示函數(shù)一直在運(yùn)行，如果返回1，則表示更新按鍵電平狀態(tài)的回調(diào)函數(shù)Update_Key_CallBack為空。
四、打印組件版本信息
/**
* @name Get_Version_Mess
* @brief 打印Key_Detect組件版本信息
* @param 無(wú)
* @retval 返Key_Detect組件版本信息
*/
char *Get_Version_Mess(void)
其中一、二、三是就是我們使用這個(gè)按鍵組件的核心函數(shù)，我們來(lái)看看這個(gè)組件的使用方法，以下是我使用野火霸道F103開(kāi)發(fā)板實(shí)現(xiàn)的例程，代碼只貼出一部分核心的：
五、部分例程實(shí)現(xiàn)與講解
//按鍵單擊時(shí)發(fā)出時(shí)的事件值
#define KEY_SIGNAL 0
//按鍵長(zhǎng)按時(shí)發(fā)出時(shí)的事件值
#define KEY_LONG 1
//按鍵沒(méi)有發(fā)出時(shí)的事件值
#define KEY_NULL -1
/*按鍵狀態(tài)==>按下or釋放*/
uint8_t Key_Status = 0 ;
/*按鍵事件==>對(duì)應(yīng)單擊、雙擊、長(zhǎng)按*/
int Key_Event = KEY_NULL;
/*按鍵發(fā)生單擊時(shí)回調(diào)*/
void key_S_CallBack(void)
{
Key_Event = KEY_SIGNAL ;
}
/*按鍵發(fā)生長(zhǎng)按時(shí)回調(diào)*/
void key_L_CallBack(void)
{
Key_Event = KEY_LONG ;
}
/*獲取按鍵狀態(tài)*/
void Get_Key_Status(void)
{
Key_Status = HAL_GPIO_ReadPin(KEY1_GPIO_Port, KEY1_Pin);
}
/*打印調(diào)試信息*/
void Print_Debug_mess(unsigned char *debug_Mess)
{
printf("%s\n",debug_Mess);
}
/**
* @brief The application entry point.
* @retval int
*/
int main(void)
{
/* USER CODE BEGIN 1 */
uint8_t Register_Status = 1 ;
int Count = 0 ;
/* USER CODE END 1 */
/* MCU Configuration--------------------------------------------------------*/
/* Reset of all peripherals, Initializes the Flash interface and the Systick. */
HAL_Init();
/* USER CODE BEGIN Init */
/* USER CODE END Init */
/* Configure the system clock */
SystemClock_Config();
/* USER CODE BEGIN SysInit */
/* USER CODE END SysInit */
/* Initialize all configured peripherals */
MX_GPIO_Init();
MX_USART2_UART_Init();
/* USER CODE BEGIN 2 */
printf("按鍵組件demo初始化\n");
//HAL_GPIO_WritePin(GPIOB, LED_G_Pin|LED_B_Pin|LED_R_Pin, GPIO_PIN_SET);
/*顯示綠燈*/
HAL_GPIO_WritePin(GPIOB, LED_R_Pin, GPIO_PIN_RESET);
/*初始化結(jié)構(gòu)體*/
Register_Status = Init_Key_Struct(Get_Key_Status, Print_Debug_mess);
if(Register_Status)
{
printf("初始化按鍵失敗\n");
return -1 ;
}
/*注冊(cè)事件發(fā)生回調(diào)*/
Reg_Key(&Key_Status, 10, H_Trig, S_Click, key_S_CallBack);//單擊
Reg_Key(&Key_Status, 200, H_Trig, L_Press, key_L_CallBack);//長(zhǎng)按
/* USER CODE END 2 */
/* Infinite loop */
/* USER CODE BEGIN WHILE */
while (1)
{
/* USER CODE END WHILE */
/* USER CODE BEGIN 3 */
Key_Detect();
if(KEY_SIGNAL == Key_Event)
{
HAL_GPIO_WritePin(GPIOB, LED_G_Pin|LED_B_Pin|LED_R_Pin, GPIO_PIN_SET);
HAL_GPIO_WritePin(GPIOB, LED_G_Pin, GPIO_PIN_RESET);
}
if(KEY_LONG == Key_Event)
{
HAL_GPIO_WritePin(GPIOB, LED_G_Pin|LED_B_Pin|LED_R_Pin, GPIO_PIN_SET);
HAL_GPIO_WritePin(GPIOB, LED_B_Pin, GPIO_PIN_RESET);
}
HAL_Delay(5);
}
/* USER CODE END 3 */
}
該例程的實(shí)現(xiàn)非常簡(jiǎn)單，即當(dāng)沒(méi)有發(fā)生任何按鍵的時(shí)候，顯示紅燈，當(dāng)發(fā)生單擊時(shí)，顯示綠燈，當(dāng)發(fā)生長(zhǎng)按時(shí)，顯示藍(lán)燈。
六、例程及組件文檔分享
鏈接：https://pan.baidu.com/s/1jV2dCE_wGGZSPBIUhMfUgQ
提取碼：89zf
鏈接：https://pan.baidu.com/s/1Wg2jBfihFn-SKh0JmytIZA
提取碼：o61v往期精彩分享
讓C語(yǔ)言的調(diào)試更加高大上
分享一個(gè)好用的C語(yǔ)言.ini文件的解析庫(kù)
分享一個(gè)非常有用且簡(jiǎn)單C語(yǔ)言測(cè)試框架
分享一個(gè)自己量產(chǎn)項(xiàng)目上的集成測(cè)試軟件MTTEST
免責(zé)聲明：本文內(nèi)容由21ic獲得授權(quán)后發(fā)布，版權(quán)歸原作者所有，本平臺(tái)僅提供信息存儲(chǔ)服務(wù)。文章僅代表作者個(gè)人觀點(diǎn)，不代表本平臺(tái)立場(chǎng)，如有問(wèn)題，請(qǐng)聯(lián)系我們，謝謝！
下載文檔
