基于HAL库的按键（KEY）库函数

key.c

/**
  ********************************************************************************
  * @file      key.c
  * @brief     按键操作源文件
  * @author    Jia Yasen
  * @date      2022-6-20
  * @version   V0.0.1
  * @copyright @Etherealize
  ********************************************************************************
  */
/*-----------------------------Includes---------------------------------------*/
#include "key.h"
/*-----------------------------Function---------------------------------------*/

/**
  * @brief      按键扫描（持续触发）
  * @param[in]  None
  * @return     uint8_t 对应按键值
  * @retval     0       默认值,无操作
  *             1       KEY0对应值,表示KEY0按下,可在循环中查询是否为1来进行对应操作
  *             2       KEY1对应值
  * @details    持续触发，则确认按下后的那部分会在按下的时间里执行很多次，因为按下
  *             的时间有零点几秒，但是程序每几毫秒循环一次。所以在按下的时间里会执行多次
  */
uint8_t KEY_Scan1(void)
{
  if(KEY0 == KEY_ON || KEY1 == KEY_ON)
  {
    HAL_Delay(10);//延时10-20ms，软件消抖
    if(KEY0 == KEY_ON) 
    {
      return KEY0_PRES;//此处的操作会多次执行
    }
    else if(KEY1 == KEY_ON) 
    {
      return KEY1_PRES;//此处的操作会多次执行
    }
    //一般是按下触发事件,松开返回正常状态，不触发
    else 
      return 0;
  }
  return 0;//没有按下默认返回0
}

/**
  * @brief      按键扫描（单次触发）
  * @param[in]  None
  * @return     uint8_t 对应按键值
  * @retval     0       默认值,无操作
  *             1       KEY0对应值,表示KEY0按下,可在循环中查询是否为1来进行对应操作
  *             2       KEY1对应值
  * @details    单次触发:用key_up作为制约,按下后只会触发一次操作,直到松开才会使下一次按下发挥作用
  */
uint8_t KEY_Scan2(void)
{
  //静态变量存储在静态存储区,只会在程序一开始的时候初始化一次，将局部变量静态化可以使变量独立于函数，而不是每次调用函数时重新初始化一次
  static uint8_t key_up = 1; //按键松开标志
  //用key_up作为约束,在第一次检测到按键按下并执行操作之后key_up变为0，在持续按住按键的之后几次扫描中都不会触发
  if(key_up && (KEY0 == KEY_ON || KEY1 == KEY_ON))
  {
    HAL_Delay(10);
    key_up = 0;
    if(KEY0 == KEY_ON)
    {
      return KEY0_PRES;//
    }
    else if(KEY1 == KEY_ON)
    {
      return KEY1_PRES;//操作只会触发一次
    }
    else
      return 0;
  }
  else if(KEY0 == KEY_OFF && KEY1 == KEY_OFF) key_up = 1;//按键松开时key_up重置，下次再按下才会触发
  return 0;
}

/**
  * @brief      按键扫描
  * @param[in]  mode 模式转换. 0:单次触发 1:持续触发
  * @return     uint8_t 对应按键值
  * @retval     0       默认值,无操作
  *             1       KEY0对应值,表示KEY0按下,可在循环中查询是否为1来进行对应操作
  *             2       KEY1对应值
  * @details    若持续触发，则确认按下后的那部分会在按下的时间里执行很多次,因为按下
  *             的时间有零点几秒,但是程序每几毫秒循环一次,所以在按下的时间里会执行多次.
  *             若单次触发:用key_up作为制约,按下后只会触发一次操作,直到松开才会
  *             使下一次按下发挥作用.
  */
uint8_t KEY_Scan(uint8_t mode)
{
  static uint8_t key_up = 1; //按键松开标志
  if(mode) key_up = 1; //mode为1时,每次扫描都会重置key_up,操作就可以不断触发,持续触发
  if(key_up == 1 && (KEY0 == KEY_ON || KEY1 == KEY_ON))
  {
    HAL_Delay(10); // 软件消抖
    key_up = 0;
    if(KEY0 == KEY_ON)
    {
      return KEY0_PRES;
    }
    else if(KEY1 == KEY_ON)
    {
      return KEY1_PRES;
    }
    else
      return 0;
  }
  else if(KEY0 == KEY_OFF && KEY1 == KEY_OFF) key_up = 1;//松开则刷新key_up
  return 0;
}
 
/************************ (C) COPYRIGHT Etherealize*****END OF FILE***********/

key.h

/**
  ********************************************************************************
  * @file      key.h
  * @brief     按键操作头文件
  * @author    Jia Yasen
  * @date      2022-6-20
  * @version   V0.0.1
  * @copyright @Etherealize
  ********************************************************************************
  * @attention 1.本文件的函数均基于HAL库,按键KEY的初始化基于GPIO的初始化,GPIO对应引脚
  *            初始化为输入模式即可
  *            2.由于不同板子的对应引脚不同，使用前需先对照原理图修改KEY对应的引脚
  ********************************************************************************
  */
#ifndef __KEY_H__
#define __KEY_H__
/*-----------------------------Includes---------------------------------------*/
//根据使用的芯片型号进行修改
#include "stm32f1xx_hal.h" 
/*-----------------------------Define-----------------------------------------*/
//将KEYx定义为对应引脚的读取值
#define KEY0 HAL_GPIO_ReadPin(GPIOx,GPIO_PIN_x)
#define KEY1 HAL_GPIO_ReadPin(GPIOx,GPIO_PIN_x)
//给不同的KEY设定不同的对应数字，表示对应KEY按下;也表示不同的优先级,数字越小优先级越高;不用0，因为0是函数的默认返回值
#define KEY0_PRES 1
#define KEY1_PRES 2
//KEY_ON表示按键按下，KEY_OFF表示按键松开;使用前先根据原理图修改对应关系
#define KEY_ON GPIO_PIN_RESET
#define KEY_OFF GPIO_PIN_SET
/*-----------------------------Function---------------------------------------*/
uint8_t KEY_Scan1(void);
uint8_t KEY_Scan2(void);
uint8_t KEY_Scan(uint8_t mode);

#endif
/************************ (C) COPYRIGHT Etherealize*****END OF FILE***********/