基于硬汉的F1按键教程基础上添加双击

夜乄歌 · 发表于 2019-9-18 12:04:14

本帖最后由夜乄歌于 2019-9-19 09:31 编辑

工作中一直借鉴使用的安富莱的代码，感觉相当好用，思路也明确移植也方便，正好最近新搞了个STC8A的设备控制板，就将部分代码移植上去，跑的也比较顺畅，看了论坛几个关于按键的帖子，想着能不能再去添加点按键的功能，就在原F1按键的基础上修改，过滤掉了长按之后的短按事件（延时发送键值或者说松手发送键值），添加了双击使能功能（依旧要延时判断短按），所以在此献丑了，代码如下

#include "bsp.h"
sbit KEY1 = P5 ^ 5;
sbit KEY2 = P2 ^ 0;
//sbit KEY3 = P2 ^ 1;
//sbit KEY4 = P2 ^ 2;
//sbit KEY5 = P2 ^ 3;
//sbit KEY6 = P2 ^ 4;
//sbit KEY7 = P2 ^ 5;
//sbit KEY8 = P2 ^ 6;
//sbit KEY9 = P2 ^ 7;
static KEY_T s_tBtn[KEY_COUNT];
static KEY_FIFO_T s_tKey; /* 按键FIFO变量,结构体 */
static void bsp_InitKeyVar(void);
static void bsp_InitKeyHard(void);
/*
*********************************************************************************************************
* 函数名: IsKeyDownX
* 功能说明: 判断按键是否按下
* 形参: 无
* 返回值: 返回值1 表示按下，0表示未按下
*********************************************************************************************************
*/
static uint8_t IsKeyDown1(void)
{
if (KEY1 == 0)
return 1;
else
return 0;
}
static uint8_t IsKeyDown2(void)
{
if (KEY2 == 0)
return 1;
else
return 0;
}
//static uint8_t IsKeyDown3(void)
//{
// if (KEY3 == 0)
// return 1;
// else
// return 0;
//}
//static uint8_t IsKeyDown4(void)
//{
// if (KEY4 == 0)
// return 1;
// else
// return 0;
//}
//static uint8_t IsKeyDown5(void)
//{
// if (KEY5 == 0)
// return 1;
// else
// return 0;
//}
//static uint8_t IsKeyDown6(void)
//{
// if (KEY6 == 0)
// return 1;
// else
// return 0;
//}
//static uint8_t IsKeyDown7(void)
//{
// if (KEY7 == 0)
// return 1;
// else
// return 0;
//}
//static uint8_t IsKeyDown8(void)
//{
// if (KEY8 == 0)
// return 1;
// else
// return 0;
//}
//static uint8_t IsKeyDown9(void)
//{
// if (KEY9 == 0)
// return 1;
// else
// return 0;
//}
/*
*********************************************************************************************************
* 函数名: bsp_InitKey
* 功能说明: 初始化按键. 该函数被 bsp_Init() 调用。
* 形参: 无
* 返回值: 无
*********************************************************************************************************
*/
void bsp_InitKey(void)
{
bsp_InitKeyVar(); /* 初始化按键变量 */
bsp_InitKeyHard(); /* 初始化按键硬件 */
}
/*
*********************************************************************************************************
* 函数名: bsp_PutKey
* 功能说明: 将1个键值压入按键FIFO缓冲区。可用于模拟一个按键。
* 形参: _KeyCode : 按键代码
* 返回值: 无
*********************************************************************************************************
*/
void bsp_PutKey(uint8_t _KeyCode)
{
s_tKey.Buf[s_tKey.Write] = _KeyCode;
if (++s_tKey.Write >= KEY_FIFO_SIZE)
{
s_tKey.Write = 0;
}
}
/*
*********************************************************************************************************
* 函数名: bsp_GetKey
* 功能说明: 从按键FIFO缓冲区读取一个键值。
* 形参: 无
* 返回值: 按键代码
*********************************************************************************************************
*/
uint8_t bsp_GetKey(void)
{
uint8_t ret;
if (s_tKey.Read == s_tKey.Write)
{
return KEY_NONE;
}
else
{
ret = s_tKey.Buf[s_tKey.Read];
if (++s_tKey.Read >= KEY_FIFO_SIZE)
{
s_tKey.Read = 0;
}
return ret;
}
}
/*
*********************************************************************************************************
* 函数名: bsp_GetKey2
* 功能说明: 从按键FIFO缓冲区读取一个键值。独立的读指针。
* 形参: 无
* 返回值: 按键代码
*********************************************************************************************************
*/
uint8_t bsp_GetKey2(void)
{
uint8_t ret;
if (s_tKey.Read2 == s_tKey.Write)
{
return KEY_NONE;
}
else
{
ret = s_tKey.Buf[s_tKey.Read2];
if (++s_tKey.Read2 >= KEY_FIFO_SIZE)
{
s_tKey.Read2 = 0;
}
return ret;
}
}
/*
*********************************************************************************************************
* 函数名: bsp_GetKeyState
* 功能说明: 读取按键的状态
* 形参: _ucKeyID : 按键ID，从0开始
* 返回值: 1 表示按下， 0 表示未按下
*********************************************************************************************************
*/
uint8_t bsp_GetKeyState(KEY_ID_E _ucKeyID)
{
return s_tBtn[_ucKeyID].State;
}
/*
*********************************************************************************************************
* 函数名: bsp_SetKeyParam
* 功能说明: 设置按键参数
* 形参：_ucKeyID : 按键ID，从0开始
* _LongTime : 长按事件时间
* _RepeatSpeed : 连发速度
* 返回值: 无
*********************************************************************************************************
*/
void bsp_SetKeyParam(uint8_t _ucKeyID, uint16_t _LongTime, uint8_t _RepeatSpeed)
{
s_tBtn[_ucKeyID].LongTime = _LongTime; /* 长按时间 0 表示不检测长按键事件 */
s_tBtn[_ucKeyID].RepeatSpeed = _RepeatSpeed; /* 按键连发的速度，0表示不支持连发 */
s_tBtn[_ucKeyID].RepeatCount = 0; /* 连发计数器 */
}
/*
*********************************************************************************************************
* 函数名: bsp_ClearKey
* 功能说明: 清空按键FIFO缓冲区
* 形参：无
* 返回值: 按键代码
*********************************************************************************************************
*/
void bsp_ClearKey(void)
{
s_tKey.Read = s_tKey.Write;
}
/*
*********************************************************************************************************
* 函数名: bsp_InitKeyVar
* 功能说明: 初始化按键变量
* 形参: 无
* 返回值: 无
*********************************************************************************************************
*/
static void bsp_InitKeyVar(void)
{
uint8_t i;
/* 对按键FIFO读写指针清零 */
s_tKey.Read = 0;
s_tKey.Write = 0;
s_tKey.Read2 = 0;
/* 给每个按键结构体成员变量赋一组缺省值 */
for (i = 0; i < KEY_COUNT; i++)
{
s_tBtn[i].LongTime = KEY_LONG_TIME; /* 长按时间 0 表示不检测长按键事件 */
s_tBtn[i].Count = KEY_FILTER_TIME / 2; /* 计数器设置为滤波时间的一半 */
s_tBtn[i].State = 0; /* 按键缺省状态，0为未按下 */
s_tBtn[i].RepeatSpeed = 0; /* 按键连发的速度，0表示不支持连发 */
s_tBtn[i].RepeatCount = 0; /* 连发计数器 */
s_tBtn[i].DoubleClickLongTime = KEY_DOUBLE_CLICK_TIME;/* 双击间隔时间，0表示不支持双击 */
s_tBtn[i].DoubleClickCount = 0; /* 双击计数器 */
}
/* 判断按键按下的函数 */
s_tBtn[0].IsKeyDownFunc = IsKeyDown1;
s_tBtn[1].IsKeyDownFunc = IsKeyDown2;
// s_tBtn[2].IsKeyDownFunc = IsKeyDown3;
// s_tBtn[3].IsKeyDownFunc = IsKeyDown4;
// s_tBtn[4].IsKeyDownFunc = IsKeyDown5;
// s_tBtn[5].IsKeyDownFunc = IsKeyDown6;
// s_tBtn[6].IsKeyDownFunc = IsKeyDown7;
// s_tBtn[7].IsKeyDownFunc = IsKeyDown8;
// s_tBtn[8].IsKeyDownFunc = IsKeyDown9;
}
/*
*********************************************************************************************************
* 函数名: bsp_InitKeyHard
* 功能说明: 配置按键对应的GPIO
* 形参: 无
* 返回值: 无
*********************************************************************************************************
*/
static void bsp_InitKeyHard(void)
{
P5M0 &= ~(1<<5);
P5M1 &= ~(1<<5);
}
/*
*********************************************************************************************************
* 函数名: bsp_DetectKey
* 功能说明: 检测一个按键。非阻塞状态，必须被周期性的调用。
* 形参: 按键结构变量指针
* 返回值: 无
*********************************************************************************************************
*/
static void bsp_DetectKey(uint8_t i)
{
KEY_T *pBtn;
/*
如果没有初始化按键函数，则报错
if (s_tBtn[i].IsKeyDownFunc == 0)
{
printf("Fault : DetectButton(), s_tBtn[i].IsKeyDownFunc undefine");
}
*/
pBtn = &s_tBtn[i];
if (pBtn->IsKeyDownFunc())
{
if (pBtn->Count < KEY_FILTER_TIME)
{
pBtn->Count = KEY_FILTER_TIME;
}
else if(pBtn->Count < 2 * KEY_FILTER_TIME)
{
pBtn->Count++;
}
else
{
/*
无按键按下状态，设置按键状态为短按，因短按比较特殊，
之后需要判断长按以及双击，所以延时发送键值
*/
if (pBtn->State == 0)
{
pBtn->State = SMALL_CLICK;/* 状态为1时代表的是短按 */
} /* 如果之前有个短按状态，并且允许了双击功能，且计数值不为0(有过段时间松手)，标记按键状态为双击 */
else if(pBtn->State == SMALL_CLICK && (pBtn->DoubleClickLongTime != 0 && pBtn->DoubleClickCount > 0))
{
pBtn->State = DOUBLE_CLICK;
}
/* 只有允许长按时才可以进行连发 */
if (pBtn->LongTime > 0)
{
/* 先触发长按之后进行连发的触发 */
if (pBtn->LongCount < pBtn->LongTime)
{
/* 发送按钮持续按下的消息 */
if (++pBtn->LongCount == pBtn->LongTime)
{
/* 键值放入按键FIFO */
bsp_PutKey((uint8_t)(4 * i + 3));
pBtn->State = LONG_CLICK;/* 触发长按改变按键状态 */
}
}
else
{
if (pBtn->RepeatSpeed > 0)
{
if (++pBtn->RepeatCount >= pBtn->RepeatSpeed)
{
pBtn->RepeatCount = 0;
/* 常按键后，每隔10ms发送1个按键 */
bsp_PutKey((uint8_t)(4 * i + 1));
}
}
}
}
}
}
else
{
if(pBtn->Count > KEY_FILTER_TIME)
{
pBtn->Count = KEY_FILTER_TIME;
}
else if(pBtn->Count != 0)
{
pBtn->Count--;
}
else
{ /* 按键松手之后的一些处理 */
switch(pBtn->State)
{
case SMALL_CLICK:/* 短按 */
if(pBtn->DoubleClickLongTime == 0)/* 不支持双击立即发送键值 */
{
pBtn->State = 0;
/* 短按键值存入FIFO */
bsp_PutKey((uint8_t)(4 * i + 1));
/* 发送按钮弹起的消息 */
bsp_PutKey((uint8_t)(4 * i + 2));
}
else /* 支持双击延时发送键值 */
{
if(++pBtn->DoubleClickCount == pBtn->DoubleClickLongTime)
{
pBtn->DoubleClickCount = 0;
pBtn->State = 0;
/* 短按键值存入FIFO */
bsp_PutKey((uint8_t)(4 * i + 1));
/* 发送按钮弹起的消息 */
bsp_PutKey((uint8_t)(4 * i + 2));
}
}
break;
case LONG_CLICK: /* 长按 */
pBtn->State = 0;
bsp_PutKey((uint8_t)(4 * i + 2));
break;
case DOUBLE_CLICK: /* 双击 */
pBtn->State = 0;
bsp_PutKey((uint8_t)(4 * i + 4));
bsp_PutKey((uint8_t)(4 * i + 2));
pBtn->DoubleClickCount = 0;//计时赋值
break;
default:
break;
}
}
pBtn->LongCount = 0;
pBtn->RepeatCount = 0;
}
}
/*
*********************************************************************************************************
* 函数名: bsp_KeyScan
* 功能说明: 扫描所有按键。非阻塞，被systick中断周期性的调用
* 形参: 无
* 返回值: 无
*********************************************************************************************************
*/
void bsp_KeyScan(void)
{
uint8_t idata i;
for (i = 0; i < KEY_COUNT; i++)
{
bsp_DetectKey(i);
}
}

复制代码

头文件如下

#ifndef __KEY_H__
#define __KEY_H__
#define KEY_COUNT 2 /* 按键个数, 按键增加需要修改 */
/* 按键ID, 主要用于bsp_KeyState()函数的入口参数 */
typedef enum
{
KID_K1 = 0,
}KEY_ID_E;
#define SMALL_CLICK 1
#define LONG_CLICK 2
#define DOUBLE_CLICK 3
/*
按键滤波时间50ms, 单位10ms。
只有连续检测到50ms状态不变才认为有效，包括弹起和按下两种事件
即使按键电路不做硬件滤波，该滤波机制也可以保证可靠地检测到按键事件
*/
#define KEY_FILTER_TIME 5
#define KEY_LONG_TIME 200 /* 单位10ms，持续2秒，认为长按事件 */
#define KEY_DOUBLE_CLICK_TIME 20
typedef struct
{
/* 下面是一个函数指针，指向判断按键手否按下的函数 */
uint8_t (*IsKeyDownFunc)(void); /* 按键按下的判断函数,1表示按下 */
uint8_t Count; /* 滤波器计数器 */
uint16_t LongCount; /* 长按计数器 */
uint16_t LongTime; /* 按键按下持续时间, 0表示不检测长按 */
uint8_t State; /* 按键当前状态（按下还是弹起） */
uint8_t RepeatSpeed; /* 连续按键周期 */
uint8_t RepeatCount; /* 连续按键计数器 */
uint8_t DoubleClickLongTime; /* 双击使能 */
uint8_t DoubleClickCount;/* 双击计数 */
}KEY_T;
/*
定义键值代码, 必须按如下次序定时每个键的按下、弹起和长按事件
推荐使用enum, 不用#define，原因：
(1) 便于新增键值,方便调整顺序，使代码看起来舒服点
(2) 编译器可帮我们避免键值重复。
*/
typedef enum //按键状态列表，添加按键需要对应进行添加
{
KEY_NONE = 0, /* 0 表示按键事件 */
KEY_1_DOWN, /* 1键按下 */
KEY_1_UP, /* 1键弹起 */
KEY_1_LONG, /* 1键长按 */
KEY_1_DOUBLE, /* 1键长按 */
KEY_2_DOWN, /* 2键按下 */
KEY_2_UP, /* 2键弹起 */
KEY_2_LONG, /* 2键长按 */
KEY_2_DOUBLE,
KEY_3_DOWN, /* 3键按下 */
KEY_3_UP, /* 3键弹起 */
KEY_3_LONG, /* 3键长按 */
KEY_3_DOUBLE,
KEY_4_DOWN, /* 4键按下 */
KEY_4_UP, /* 4键弹起 */
KEY_4_LONG, /* 4键长按 */
KEY_4_DOUBLE,
KEY_5_DOWN, /* 4键按下 */
KEY_5_UP, /* 4键弹起 */
KEY_5_LONG, /* 4键长按 */
KEY_5_DOUBLE,
KEY_6_DOWN, /* 4键按下 */
KEY_6_UP, /* 4键弹起 */
KEY_6_LONG, /* 4键长按 */
KEY_6_DOUBLE,
KEY_7_DOWN, /* 4键按下 */
KEY_7_UP, /* 4键弹起 */
KEY_7_LONG, /* 4键长按 */
KEY_7_DOUBLE,
KEY_8_DOWN, /* 4键按下 */
KEY_8_UP, /* 4键弹起 */
KEY_8_LONG, /* 4键长按 */
KEY_8_DOUBLE,
KEY_9_DOWN, /* 4键按下 */
KEY_9_UP, /* 4键弹起 */
KEY_9_LONG, /* 4键长按 */
KEY_9_DOUBLE,
KEY_K1K2_DOWN, /* k1k2组合键键按下 */
KEY_K1K2_UP, /* k1k2键弹起 */
KEY_K1K2_LONG, /* k1k2键长按 */
KEY_K1K2_DOUBLE,
KEY_K2K3_DOWN, /* K2K3组合键键按下 */
KEY_K2K3_UP, /* K2K3键弹起 */
KEY_K2K3_LONG, /* K2K3键长按 */
KEY_K2K3_DOUBLE,
}KEY_ENUM;
/* FIFO缓存事件大小 */
#define KEY_FIFO_SIZE 10
typedef struct
{
uint8_t Buf[KEY_FIFO_SIZE]; /* 键值缓冲区 */
uint8_t Read; /* 缓冲区读指针1 */
uint8_t Write; /* 缓冲区写指针 */
uint8_t Read2; /* 缓冲区读指针2 */
}KEY_FIFO_T;
/* 供外部调用的函数声明 */
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);
#endif

复制代码

脑仁比较小，暂时想到只有这么多，有更好的方法也希望大家多多分享讨论

sanit · 发表于 2019-9-18 13:26:29

谢谢分享

西点钟灵毓秀 · 发表于 2019-9-18 17:46:13

能否上传.C和.H文件

eric2013 · 发表于 2019-9-18 18:54:30

谢谢分享，其实可以不用改，直接在应用程序里面实现也比较方便。

夜乄歌 · 发表于 2019-9-19 08:42:50

eric2013 发表于 2019-9-18 18:54
谢谢分享，其实可以不用改，直接在应用程序里面实现也比较方便。

当时有想过应用中实现

，结果感觉没有直接驱动上再加个使能方便就放弃了

夜乄歌 · 发表于 2019-9-19 09:32:02

西点钟灵毓秀发表于 2019-9-18 17:46
能否上传.C和.H文件

已经上传了

eric2013 · 发表于 2019-9-19 11:16:26

夜乄歌发表于 2019-9-19 08:42
当时有想过应用中实现，结果感觉没有直接驱动上再加个使能方便就放弃了

我们这个是标准的PC键盘驱动，其它的方式可以直接在这个上面实现。

夜乄歌 · 发表于 2019-9-19 12:06:20

eric2013 发表于 2019-9-19 11:16
我们这个是标准的PC键盘驱动，其它的方式可以直接在这个上面实现。

这个知道，很好用，第一次看到的时候当即感叹道，还有这种好方法

eric2013 · 发表于 2019-9-21 01:55:16

忘了给楼主一个赞，已经加上。

czm_hyt@163.com · 发表于 2019-12-27 09:43:53

喜欢跟你交流一下按键检测，本人小白，刚刚学习STM32，多指教

对于本程序的疑问：
1：如果不支持长按，也不支持双击的话，按键按下时刻，需要立刻触发一个短按按下的消息，最好是按键按下，立刻产生这个消息。长按和双击这两个选项不冲突，双击之后的长按也可以根据需要自己定义按键码。
2：本程序不支持双击的长按以及三连击四连击（没必要支持的，哈哈），所以第二次按键按下，如果满足双击，就需要立刻产生双击的消息，不应该在第二次按键弹起之后判断，用户体验不好，这个跟对双击的定义，理解有关。
交流：
1：对于双击个人理解：
定义：双击的判断，很多人都有不同的方法，本程序是判断第一次按键弹出后到第二次按键按下，这段时间的间隔，也有朋友增加判断第一次按键按下的时间，感觉这样定义，都不够准确，或者容易乱。哈哈。
我觉得从用户角度来看，双击就是两次按键按下的时间间隔，只要这个时间间隔满足我们设置的阈值，就是双击，这样判断更加准确。
何时生产双击这个消息：很多朋友是在第二次按键弹起之后，判断是否是双击，这个也不够准确，应该在第二按键按下之后，立刻产生双击消息（如果你不支持3连击及以上）。
双击之后，如果用户按键不松开，可以根据具体需求，是否增加双击的长按，或者双击的连发。
关于组合按键，我理解双击就是一种最简单的组合按键，同一个按键的组合，如果是不同的按键组合，不建议用这种软件架构，因为会产生一个我们不希望看到的一个按键按下（或弹起），这个按键其实是组合按键中的一个。
说的不对的地方，忘交流指正，共同进步，多谢。

夜歌 · 发表于 2019-12-30 19:53:21

czm_hyt@163.com 发表于 2019-12-27 09:43
喜欢跟你交流一下按键检测，本人小白，刚刚学习STM32，多指教
对于本程序的疑问：
1：如果不支持长按 ...

可以的，主要当时项目用的时候临时的一个想法，可能有很多不足，但是满足项目需求了，就没再改（脑仁小，懒得在思考！！！），你说的双击的判断，也是一种方法，后续有时间了优化下试试，其实51的控制板一直都是用的状态机的方式，感觉可能那种结构实现起来会好很多，不过也正如硬汉说的，这些其实可以自己根据键值在二次处理下，具体的还真没试过

czm_hyt@163.com · 发表于 2020-3-22 11:33:53

夜歌发表于 2019-12-30 19:53
可以的，主要当时项目用的时候临时的一个想法，可能有很多不足，但是满足项目需求了，就没再改（脑仁 ...

我把按键检测做完了，非常高大上，哈哈，可以看我发帖子，

wdliming · 发表于 2020-3-22 13:25:12

谢谢分享

哈哈哈哈嘻嘻 · 发表于 2020-7-18 00:35:23

eric2013 发表于 2019-9-19 11:16
我们这个是标准的PC键盘驱动，其它的方式可以直接在这个上面实现。

感觉处理起来也不太方便，有可以参考的应用代码吗？PC是这么处理按键值的呢？

eric2013 · 发表于 2020-7-18 00:40:07

哈哈哈哈嘻嘻发表于 2020-7-18 00:35
感觉处理起来也不太方便，有可以参考的应用代码吗？PC是这么处理按键值的呢？

H7-TOOL添加了双击支持，是修改驱动代码做的，或者直接复制粘贴楼主做的即可。

H7-TOOL开源项目的GitHub地址，当前版本V1.21，含论坛方式下载原理图，上位机，固件等（2020-06-12）
http://www.armbbs.cn/forum.php?mod=viewthread&tid=95468

哈哈哈哈嘻嘻 · 发表于 2020-7-19 20:22:38

eric2013 发表于 2020-7-18 00:40
H7-TOOL添加了双击支持，是修改驱动代码做的，或者直接复制粘贴楼主做的即可。

H7-TOOL开源项目的Gi ...

谢谢，硬汉哥

tianqi911 · 发表于 2020-8-7 10:43:42

MARK 按键双击

		自动登录	找回密码
密码			立即注册

[技术讨论] 基于硬汉的F1按键教程基础上添加双击