分享一個很好用的按鍵組件

在嵌入式系統(tǒng)或單片機程序開發(fā)過程中，經常會遇到各種按鍵的需求，比如按鍵短按、按鍵長按、按鍵雙擊，這些功能雖然不難，但想要完全寫好這些功能并不簡單。網上已經有大神實現(xiàn)了這樣的組件，該組件的特性如下：

• 使用時系統(tǒng)不阻塞
• 低耦合性
• 同一個按鍵可實現(xiàn)單擊、雙擊、長按
• 可根據(jù)按鍵線序更改，比如高電平觸發(fā)或低電平觸發(fā)

按鍵檢測組件函數(shù)接口如下:

一、初始化按鍵

/**
  * @name   Init_Key_Struct
  * @brief  初始化按鍵
  * @param  Update_Key_CallBack：更新按鍵狀態(tài)
  * @param  Debug_CallBack：打印按鍵調試信息
  * @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)，即按下或者釋放，是一個函數(shù)指針，該值一定不能為NULL。
• 參數(shù)Debug_CallBack用于打印按鍵組件的異常信息，也是一個函數(shù)指針，如果不需要時候可以將該參數(shù)寫NULL。

二、注冊按鍵

/**
  * @name   Reg_Key
  * @brief  添加注冊按鍵（注：如果按鍵已經注冊過，那么再次注冊會覆蓋之前注冊過的相同的按鍵）
  * @param  key_s：按鍵狀態(tài)
  * @param  count：按鍵計數(shù)
  * @param  Trig_Mode_E：按鍵觸發(fā)模式
  * @param  Key_Mode_E：按鍵模式
  * @param  Key_Click_CallBack：按鍵觸發(fā)回調
  * @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回調函數(shù)關聯(lián)起來。
• 參數(shù)count為按鍵計數(shù)，意思是當按鍵按下多少次后出發(fā)對應的回調，這個回調就是參數(shù)Key_Click_CallBack
• 參數(shù)Trig_Mode_E，指的是按鍵的出發(fā)方式，該組件用一個枚舉來進行描述：

/**
  * @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為按鍵模式，有單擊，雙擊，長按三種，該組件也是用一個枚舉來進行描述:

/**
  * @brief 按鍵模式狀態(tài)枚舉
  */
typedef enum
{
	N_Click = 0,																				/*!< 0 空 */	
	S_Click ,																						/*!< 1 單擊 */			
	D_Click,																						/*!< 2 雙擊 */
	L_Press,																						/*!< 3 長按 */
}Key_Mode_TypeDef;

• 參數(shù)Key_Click_CallBack，也就是相應模式下出發(fā)的回調函數(shù)了，這是一個函數(shù)指針。

三、按鍵檢測

/**
  * @name   Key_Detect
  * @brief  按鍵檢測
  * @param  無
  * @retval 0：成功；
	*					1：Key.Update_Key_CallBack == NULL；
  */
char Key_Detect(void);

該接口是用來檢測按鍵狀態(tài)的，使用該函數(shù)時，需要周期性的進行調用，當函數(shù)返回0時，表示函數(shù)一直在運行，如果返回1，則表示更新按鍵電平狀態(tài)的回調函數(shù)Update_Key_CallBack為空。

四、打印組件版本信息

/**
  * @name   Get_Version_Mess
  * @brief  打印Key_Detect組件版本信息
  * @param  無
  * @retval 返Key_Detect組件版本信息
  */
char *Get_Version_Mess(void)

其中一、二、三是就是我們使用這個按鍵組件的核心函數(shù)，我們來看看這個組件的使用方法，以下是我使用野火霸道F103開發(fā)板實現(xiàn)的例程，代碼只貼出一部分核心的：

五、部分例程實現(xiàn)與講解

//按鍵單擊時發(fā)出時的事件值
#define KEY_SIGNAL 0
//按鍵長按時發(fā)出時的事件值
#define KEY_LONG   1
//按鍵沒有發(fā)出時的事件值
#define KEY_NULL   -1

/*按鍵狀態(tài)==>按下or釋放*/
uint8_t Key_Status = 0 ;
/*按鍵事件==>對應單擊、雙擊、長按*/
int Key_Event = KEY_NULL;

/*按鍵發(fā)生單擊時回調*/
void key_S_CallBack(void)	
{
	Key_Event = KEY_SIGNAL ;
}

/*按鍵發(fā)生長按時回調*/
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);
}

/*打印調試信息*/
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);
  /*初始化結構體*/
  Register_Status = Init_Key_Struct(Get_Key_Status, Print_Debug_mess);
  if(Register_Status)
  {
	  printf("初始化按鍵失敗\n");
	  return -1 ;
  }
  /*注冊事件發(fā)生回調*/
  Reg_Key(&Key_Status, 10,  H_Trig, S_Click, key_S_CallBack);//單擊
  Reg_Key(&Key_Status, 200,  H_Trig, L_Press, key_L_CallBack);//長按
  /* 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 */
}

該例程的實現(xiàn)非常簡單，即當沒有發(fā)生任何按鍵的時候，顯示紅燈，當發(fā)生單擊時，顯示綠燈，當發(fā)生長按時，顯示藍燈。

六、例程及組件文檔分享

鏈接：https://pan.baidu.com/s/1jV2dCE_wGGZSPBIUhMfUgQ
提取碼：89zf

鏈接：https://pan.baidu.com/s/1Wg2jBfihFn-SKh0JmytIZA
提取碼：o61v

往期精彩分享

讓C語言的調試更加高大上

分享一個好用的C語言.ini文件的解析庫

分享一個非常有用且簡單C語言測試框架

分享一個自己量產項目上的集成測試軟件MTTEST