0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
会员中心
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

按键原理及应用(附开源代码)

Q4MP_gh_c472c21 来源:嵌入式大杂烩 作者:嵌入式大杂烩 2022-04-08 09:41 次阅读

按键在电子产品中很常见,今天给大家分享一套按键库源码及应用。

https://gitee.com/zhengnianli/EmbedSummary

FlexibleButton介绍

FlexibleButton 是一个基于标准 C 语言的小巧灵活的按键处理库,支持单击、连击、短按、长按、自动消抖,可以自由设置组合按键,可用于中断和低功耗场景。

该按键库解耦了具体的按键硬件结构,理论上支持轻触按键与自锁按键,并可以无限扩展按键数量。

另外,FlexibleButton 使用扫描的方式一次性读取所有所有的按键状态,然后通过事件回调机制上报按键事件。

核心的按键扫描代码仅有三行,没错,就是经典的 三行按键扫描算法。使用 C 语言标准库 API 编写,也使得该按键库可以无缝兼容任意的处理器平台,并且支持任意 OS 和 non-OS(裸机编程)。

仓库链接:

https://github.com/murphyzhao/FlexibleButton

license:Apache-2.0。

关于开源软件协议相关文章:常用的开源协议有哪些?

同类型的按键处理库还有MultiButton:

https://github.com/0x1abin/MultiButton

FlexibleButton的使用

FlexibleButton 包含有两个文件:

flexible_button.c、flexible_button.h

使用起来很简单,作者在README中也很详细地介绍了FlexibleButton 的使用。

下面,我们基于小熊派IOT开发板来简单实践实践:基于裸机及基于RT-Thread

f834266c-b6b9-11ec-aa7f-dac502259ad0.png

1、基于non-OS(裸机编程)

板子上有两个用户按键及一个用户LED

我们实现如下操作:

  • 单击button0(即F1按键),点亮led。
  • 单机button1(即F2按键),熄灭led。
  • 双击button0(即F1按键),点亮led。
  • 双击button1(即F2按键),熄灭led。
  • 同时按下button0及button1,点亮led。

FlexibleButton 给我们提供了很多按键事件给我们使用,基本涵盖了我们日常使用按键的各种场景。FlexibleButton支持的按键事件如:

左右滑动查看全部代码>>>

typedefenum
{
FLEX_BTN_PRESS_DOWN=0,//按下事件
FLEX_BTN_PRESS_CLICK,//单击事件
FLEX_BTN_PRESS_DOUBLE_CLICK,//双击事件
FLEX_BTN_PRESS_REPEAT_CLICK,//连击事件,使用flex_button_t中的click_cnt断定连击次数
FLEX_BTN_PRESS_SHORT_START,//短按开始事件
FLEX_BTN_PRESS_SHORT_UP,//短按抬起事件
FLEX_BTN_PRESS_LONG_START,//长按开始事件
FLEX_BTN_PRESS_LONG_UP,//长按抬起事件
FLEX_BTN_PRESS_LONG_HOLD,//长按保持事件
FLEX_BTN_PRESS_LONG_HOLD_UP,//长按保持的抬起事件
FLEX_BTN_PRESS_MAX,
FLEX_BTN_PRESS_NONE,
}flex_button_event_t;
这些按键事件就是FlexibleButton返回给我们应用层的,我们只要在应用层做相关的按键处理就可以。比如单击按键时,我们要做什么逻辑控制;按键双击时,又要做怎样的逻辑控制等等。

所以,哪怕我们的板子只有一两个按键,也可以做很多按键控制。

下面来一起实操一下:

首先,准备一个按键相关工程,把flexible_button.c、flexible_button.h添加到工程里。

flexible_button.h对外提供了如下几个接口

左右滑动查看全部代码>>>

int32_tflex_button_register(flex_button_t*button);//按键注册
flex_button_event_tflex_button_event_read(flex_button_t*button);//按键事件读取
uint8_tflex_button_scan(void);//按键扫描
flex_button_register用于按键注册,需要用户至少提供如下按键信息
  • 按键ID
  • 按键引脚电平读取函数
  • 事件回调函数
  • 设置按键按下的逻辑电平
  • 设置短按事件触发的起始 tick
  • 设置长按事件触发的起始 tick
  • 设置长按保持事件触发的起始 tick

flex_button_register在初始化时进行调用,如:

左右滑动查看全部代码>>>

staticvoiduser_button_init(void)
{
inti;

memset(&user_button[0],0x0,sizeof(user_button));

for(i=0;i< USER_BUTTON_MAX; i ++)
    {
        user_button[i].id = i;   //按键的ID号
user_button[i].usr_button_read=common_btn_read;//按键引脚电平读取函数
user_button[i].cb=common_btn_evt_cb;//事件回调函数
user_button[i].pressed_logic_level=0;//设置按键按下的逻辑电平
user_button[i].short_press_start_tick=FLEX_MS_TO_SCAN_CNT(1500);//设置短按事件触发的起始tick
user_button[i].long_press_start_tick=FLEX_MS_TO_SCAN_CNT(3000);//设置长按事件触发的起始tick
user_button[i].long_hold_start_tick=FLEX_MS_TO_SCAN_CNT(4500);//设置长按保持事件触发的起始tick

flex_button_register(&user_button[i]);//按键注册
}
}
这种机制很常用。

比如,一些美食教程,常常提供一些制作巧克力的方法,而不是每种口味的巧克力都教一遍,因为方法基本都差不多。不同的人喜欢不同的巧克力口味,根据自己需要,准备做巧克力的原料,再套用制作方法就可以。

FlexibleButton提供一个管理按键的框架,我们根据不同的的芯片或者不同的环境提供FlexibleButton需要的一些按键信息,就可以起到相同效果。

咱们公众号之前的推文中也有不少相关的内容:

一个300多行代码实现的多任务管理的OS

一个最简单的log模块

FlexibleButton数据结构:

左右滑动查看全部代码>>>

typedefstructflex_button
{
structflex_button*next;//按键库使用单向链表串起所有的按键

uint8_t(*usr_button_read)(void*);//用户设备的按键引脚电平读取函数,重要
flex_button_response_callbackcb;//设置按键事件回调,用于应用层对按键事件的分类处理

uint16_tscan_cnt;//用于记录扫描次数,按键按下是开始从零计数
uint16_tclick_cnt;//记录单击次数,用于判定单击、连击
uint16_tmax_multiple_clicks_interval;//连击间隙,用于判定是否结束连击计数,有默认值

uint16_tdebounce_tick;//消抖时间,暂未使用,依靠扫描间隙进行消抖
uint16_tshort_press_start_tick;//设置短按事件触发的起始tick
uint16_tlong_press_start_tick;//设置长按事件触发的起始tick
uint16_tlong_hold_start_tick;//设置长按保持事件触发的起始tick

uint8_tid;//当多个按键使用同一个回调函数时,用于断定属于哪个按键
uint8_tpressed_logic_level:1;//设置按键按下的逻辑电平
uint8_tevent:4;//用于记录当前按键事件
uint8_tstatus:3;//用于记录当前按键的状态,用于内部状态机
}flex_button_t;
按键引脚电平读取函数如:

左右滑动查看全部代码>>>

staticuint8_tcommon_btn_read(void*arg)
{
uint8_tvalue=0;

flex_button_t*btn=(flex_button_t*)arg;

switch(btn->id)
{
caseUSER_BUTTON_0:
value=HAL_GPIO_ReadPin(USER_BUTTON_0_PORT,USER_BUTTON_0_PIN);
break;
caseUSER_BUTTON_1:
value=HAL_GPIO_ReadPin(USER_BUTTON_1_PORT,USER_BUTTON_1_PIN);
break;
default:
assert_param(0);
}

returnvalue;
}
按键事件回调函数如:

左右滑动查看全部代码>>>

//按键事件回调函数
staticvoidcommon_btn_evt_cb(void*arg)
{
flex_button_t*btn=(flex_button_t*)arg;

//非组合按键事件处理
non_combination_btn_event(btn);

//组合按键事件处理
if((flex_button_event_read(&user_button[USER_BUTTON_0])==FLEX_BTN_PRESS_CLICK)&&
(flex_button_event_read(&user_button[USER_BUTTON_1])==FLEX_BTN_PRESS_CLICK))
{
printf("[combination]:button0andbutton1,LEDON>>>>>>>>>>>>>>>>>>>>>>>
");
HAL_GPIO_WritePin(LED_GPIO_Port,LED_Pin,GPIO_PIN_SET);//亮
}
}

//非组合按键事件处理
staticvoidnon_combination_btn_event(flex_button_t*btn)
{
switch(btn->id)
{
caseUSER_BUTTON_0:
{
switch(btn->event)
{
caseFLEX_BTN_PRESS_DOWN:
printf("%s:%s
",enum_btn_id_string[btn->id],enum_event_string[btn->event]);
break;
caseFLEX_BTN_PRESS_CLICK:
HAL_GPIO_WritePin(LED_GPIO_Port,LED_Pin,GPIO_PIN_SET);//亮
printf("%s:%s
",enum_btn_id_string[btn->id],enum_event_string[btn->event]);
printf("<<<<<<<<<<<<<<<<<<<<<<<);
break;
caseFLEX_BTN_PRESS_DOUBLE_CLICK:
HAL_GPIO_WritePin(LED_GPIO_Port,LED_Pin,GPIO_PIN_SET);//亮
printf("%s:%s
",enum_btn_id_string[btn->id],enum_event_string[btn->event]);
printf("<<<<<<<<<<<<<<<<<<<<<<<);
break;
default:
break;
}
break;
}

caseUSER_BUTTON_1:
{
switch(btn->event)
{
caseFLEX_BTN_PRESS_DOWN:
printf("%s:%s
",enum_btn_id_string[btn->id],enum_event_string[btn->event]);
break;
caseFLEX_BTN_PRESS_CLICK:
HAL_GPIO_WritePin(LED_GPIO_Port,LED_Pin,GPIO_PIN_RESET);//灭
printf("%s:%s
",enum_btn_id_string[btn->id],enum_event_string[btn->event]);
printf("<<<<<<<<<<<<<<<<<<<<<<<);
break;
caseFLEX_BTN_PRESS_DOUBLE_CLICK:
HAL_GPIO_WritePin(LED_GPIO_Port,LED_Pin,GPIO_PIN_RESET);//灭
printf("%s:%s
",enum_btn_id_string[btn->id],enum_event_string[btn->event]);
printf("<<<<<<<<<<<<<<<<<<<<<<<);
break;
default:
break;
}
break;
}

default:
break;
}
}

主函数中需要调用flex_button_scan进行按键扫描,主函数如:

左右滑动查看全部代码>>>

intmain(void)
{
HAL_Init();
SystemClock_Config();
MX_GPIO_Init();
MX_USART1_Init();
printf("微信公众号:嵌入式大杂烩
");
user_button_init();

while(1)
{
flex_button_scan();
HAL_Delay(20);
}
}

编译、下载运行:

f8578f62-b6b9-11ec-aa7f-dac502259ad0.pngf867ea1a-b6b9-11ec-aa7f-dac502259ad0.pngf8775bbc-b6b9-11ec-aa7f-dac502259ad0.png

其中,每次按键的按下都会触发FLEX_BTN_PRESS_DOWN事件。

在对按键进行注册时有设置短按、长按、长按保持的tick:

左右滑动查看全部代码>>>

user_button[i].short_press_start_tick=FLEX_MS_TO_SCAN_CNT(1500);//设置短按事件触发的起始tick
user_button[i].long_press_start_tick=FLEX_MS_TO_SCAN_CNT(3000);//设置长按事件触发的起始tick
user_button[i].long_hold_start_tick=FLEX_MS_TO_SCAN_CNT(4500);//设置长按保持事件触发的起始tick

我们应用比较敏感的是1500、3000、4500,这对应的就是按键按下的时间(单位是ms),即:

  • 按键保持1500ms按下状态时,flexible_button会向应用上报FLEX_BTN_PRESS_SHORT_START事件。
  • 按键保持3000ms按下状态时,flexible_button会向应用上报FLEX_BTN_PRESS_LONG_START事件。
  • 按键保45000ms按下状态时,flexible_button会向应用上报FLEX_BTN_PRESS_LONG_HOLD事件。

下面我们修改代码,按键事件回调函数加入所有事件的处理,触发则打印相应信息。

我们做一个实验,按住button0超过5m,再放开。则打印的信息如:

f88f1a36-b6b9-11ec-aa7f-dac502259ad0.png

2、基于RT-Thread

FlexibleButton已经有作为一个软件包贡献到RT-Thread中,我们只需要简单的配置,就可以使用了。

RT-Thread menuconfig 方式:

RT-Threadonlinepackages--->
miscellaneouspackages--->
[*]FlexibleButton:Smallandflexiblebuttondriver--->
[*]Enableflexiblebuttondemo
version(latest)--->
f8a96814-b6b9-11ec-aa7f-dac502259ad0.png

配置完成后,输入 pkgs --update 下载软件包:

f8bd6cec-b6b9-11ec-aa7f-dac502259ad0.png

运行测试:

f8d4f5c4-b6b9-11ec-aa7f-dac502259ad0.png


以上就是本次的分享,希望大家喜欢!文章如有错误,欢迎指出!

审核编辑 :李倩


声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • 算法
    +关注

    关注

    23

    文章

    4600

    浏览量

    92646
  • 开源
    +关注

    关注

    3

    文章

    3252

    浏览量

    42407
  • C语音
    +关注

    关注

    0

    文章

    12

    浏览量

    12638

原文标题:超实用!按键原理及应用(附开源代码)

文章出处:【微信号:gh_c472c2199c88,微信公众号:嵌入式微处理器】欢迎添加关注!文章转载请注明出处。

收藏 人收藏

    评论

    相关推荐

    Gmapping源代码

    Gmapping源代码.docx
    发表于 11-16 13:42 0次下载

    科技云报到:假开源真噱头?开源大模型和你想的不一样!

    科技云报到原创。 25年前,著名的计算机程序员、开源软件运动旗手Eric S·Raymond出版了《大教堂与集市》一书,首次提出了开放源代码(Open Source)的概念,提倡软件源代码能被任何人
    的头像 发表于 11-03 10:46 172次阅读

    “小满”V24.10源代码在AtomGit开源

    近日,由中国汽车工业协会指导,普华基础软件股份有限公司主办的“小满”安全车控操作系统开源发布会暨共建计划说明会成功举行。普华基础软件宣布将安全车控操作系统“小满”(简称“小满”)V24.10源代码
    的头像 发表于 10-27 14:41 304次阅读

    hex可以转成源代码

    Hex文件可以转换成源代码的近似形式,但无法直接还原为原始的、完全相同的源代码 。这是因为Hex文件是二进制文件,包含了程序编译后的机器码,这些机器码与原始的源代码在结构和表达上存在显著的差异。不过
    的头像 发表于 09-02 10:41 795次阅读

    企业如何保护源代码安全?做好源代码防泄密工作

    企业源代码作为公司的核心资产,对于很多初创团队和中小型企业来说,具有不可估量的价值。然而,有些团队在投入大量人力、物力和财力进行产品开发的过程中,却发现自己辛苦研发的成果在还未上线之前,市面上已经
    的头像 发表于 05-22 16:01 428次阅读

    最新开源代码证实!“鸿蒙原生版”微信正在积极开发中

    开放源代码项目等代码, **仅支持鸿蒙内核和鸿蒙系统的应用 ** —— 不再兼容 Android 应用。 既然不再兼容 Android 端 APP,那各大 APP 开发商的适配进度也要提上日程。 近
    发表于 05-08 17:08

    开源鸿蒙】下载OpenHarmony 4.1 Release源代码

    本文介绍了如何下载开源鸿蒙(OpenHarmony)操作系统 4.1 Release版本的源代码,该方法同样可以用于下载OpenHarmony最新开发版本(master分支)或者4.0 Release、3.2 Release等发布版本的
    的头像 发表于 04-27 23:16 831次阅读
    【<b class='flag-5'>开源</b>鸿蒙】下载OpenHarmony 4.1 Release<b class='flag-5'>源代码</b>

    工厂生产管理MES系统,开源代码+维护

    商业开源的一套超有价值的JAVA制造执行MES系统源码 亲测 带本地部署搭建教程 教你如何在本地运行运行起来。
    的头像 发表于 01-29 11:53 2085次阅读
    工厂生产管理MES系统,<b class='flag-5'>开源代码</b>+维护

    源代码审计怎么做?有哪些常用工具

    。 3、CodeQL:在 CodeQL 中,代码被视为数据,安全漏洞则被建模为可以对数据库执行的查询语句。 4、SonarQube:是一个用于代码质量管理的开源平台,用于管理源代码的质
    发表于 01-17 09:35

    [开源]万界星空开源MES系统,支持低代码大屏设计

    万界星空科技免费MES、开源MES、商业开源MES、商业开源代码MES、市面上最好的开源MES、MES
    的头像 发表于 01-12 13:43 729次阅读
    [<b class='flag-5'>开源</b>]万界星空<b class='flag-5'>开源</b>MES系统,支持低<b class='flag-5'>代码</b>大屏设计

    智能制造行业--客户现场调试源代码如何防泄密

    我国近几年传统制造向智能制造的转变,很多制造企业不仅有自己公司的图纸文件需要保密,企业的有很多源代码也需要保密,但是对于源代码采用图纸防泄密的方式是不可取的,源代码防泄密比图纸文件防泄密做起来更加
    的头像 发表于 01-11 16:27 455次阅读
    智能制造行业--客户现场调试<b class='flag-5'>源代码</b>如何防泄密

    Nuttx RTOS入门知识简介及开源代码运行

    NuttX是一个成熟的实时操作系统,于07年由Gregory Nutt先生正式开源,2016年被三星选为TizenRT操作系统的内核
    的头像 发表于 01-10 18:14 5326次阅读
    Nuttx RTOS入门知识简介及<b class='flag-5'>开源代码</b>运行

    当一名高职生成为开源代码顶级贡献者

    3万行代码,和华为的5名开发者一起登上由开放原子开源基金会OpenHarmony社区官方发布的顶级贡献者榜单,在数千位代码贡献者中位列前10名。这是鸿蒙操作系统开
    的头像 发表于 12-13 08:14 580次阅读
    当一名高职生成为<b class='flag-5'>开源代码</b>顶级贡献者

    为什么安秉信息的源代码防泄密软件这么稳定?

    现在很多研发性企业都会意识到企业的源代码文件需要防泄密保护,现在很多企业对于源代码只是用了git或svn版本管理服务器进行了简单的代码统一管控。虽然现在对于源代码防泄密,有专业的
    的头像 发表于 12-05 10:21 513次阅读
    为什么安秉信息的<b class='flag-5'>源代码</b>防泄密软件这么稳定?

    安秉信息源代码图纸防泄密方案,电路图纸,源代码文件

    安秉信息源代码图纸防泄密方案,电路图纸,源代码文件
    发表于 12-01 16:56 0次下载