轻量级按键动作识别模块（C语言）

1、前言

        继嵌入式（单片机）裸机 C 语言开发 + 按键扫描（模块分层/非阻塞式）文章后，原来的按键识别基本能满足大部分需求，但是对于双击和多击等多样化的功能需求并不能满足，因此对整个按键动作识别模块进行了架构调整，此次调整后接口使用更加便捷。

---

2、介绍

重构后的按键动作识别模块特点：

• 移植方便，只需要实现硬件 IO 初始化和 IO 状态读取即可
• 支持多种按键（有些按键不一定是一个 IO 对应按键, 如矩形按键、红外远程遥控按键等）的输入
• 丰富的接口实现，通过这些接口能及时处理按键操作，同时可以实现单击、双击、多击、短按和长按等多种要求的功能
• 代码量少，且代码注释丰富，风格统一，便于阅读和使用

相对于之前的实现方式有以下变化：

1. 移除每个按键的配置信息设置，简化代码
2. 移除按键异步读取（读取之前保存起来各个状态，读取时依次i返回）的功能
3. 移除多个按键状态的变化，只留下三种状态：无按下、按下和松开
4. 增加获取按键按下和松开的时间获取、按键一定时间内的触发次数，根据上述三种状态可实现单击、双击、多击、短按和长按等多种要求的功能

整体来说，使得按键动作识别的各种要求更快速的实现。

---

3、示例代码

源文件部分代码：

/**
  * @brief      获取按键单击次数
  * 
  * @note       调用该函数时不能有关于按键动作的限制条件
  * @param[in]  eKey 指定按键, 取值为 @reg IoKeyType_e
  * @param[in]  time 每次单击的间隔时间
  * @retval     单击次数.
  */
uint8_t KEY_GetClickCnt(IoKeyType_e eKey, uint16_t time)
{
    if (eKey >= IO_KEY_MAX_NUM)
    {
        return 0;
    }

    /* 连续单击后等间隔时间再进行回调通知, 目的在松开按键后再次触发得到单击次数 */
    if (sg_tKeyManage[eKey].eKeyAction == KEY_ACTION_LOSSEN)
    {
        sg_tKeyManage[eKey].refreshNotifyTic = time;
    }
    
    if (sg_tKeyManage[eKey].eKeyActionBak != KEY_ACTION_PRESS && sg_tKeyManage[eKey].eKeyAction == KEY_ACTION_PRESS)
    {
        sg_tKeyManage[eKey].refreshNotifyTic = 0;

        if (sg_tKeyManage[eKey].clickCnt < 0xFF)
        {
            sg_tKeyManage[eKey].clickCnt++;
        }
    }

    if (sg_tKeyManage[eKey].eKeyAction == KEY_ACTION_NO_PRESS && sg_tKeyManage[eKey].uiLossenTic >= time)
    {
        uint8_t cnt = sg_tKeyManage[eKey].clickCnt;
        
        sg_tKeyManage[eKey].clickCnt = 0;
        return cnt;
    }
    
    return 0;
}

头文件部分代码：

/* Exported types ----------------------------------------------------------------------------------------------------*/
typedef enum
{
    KEY_ACTION_NO_PRESS = 0,            /*!< 没有按下 */
    KEY_ACTION_PRESS,                   /*!< 持续按下 */
    KEY_ACTION_LOSSEN                   /*!< 按下松开 */
} KeyAction_e;

typedef void (*KeyFunCB)(IoKeyType_e, KeyAction_e);


/* Exported constants ------------------------------------------------------------------------------------------------*/
/* Exported macro ----------------------------------------------------------------------------------------------------*/
/* Exported functions ------------------------------------------------------------------------------------------------*/

extern void KEY_Init(void);

extern void KEY_Register(IoKeyType_e eKey, KeyFunCB pfnKeyFun);
extern void KEY_UnRegister(IoKeyType_e eKey);

extern void KEY_SetNotifyTime(IoKeyType_e eKey, uint16_t time);

extern uint8_t KEY_GetClickCnt(IoKeyType_e eKey, uint16_t time);
extern uint16_t KEY_GetPressTime(IoKeyType_e eKey);
extern uint16_t KEY_GetLossenTime(IoKeyType_e eKey);

extern void KEY_Scan(uint16_t cycleTime);

---

4、代码获取

下载链接点击：MCU 按键动作识别模块