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

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

3天内不再提示

基于non-OS和RT-Thread的按键库源码及应用

GReq_mcu168 来源:嵌入式大杂烩 作者:嵌入式大杂烩 2022-05-23 09:39 次阅读

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

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

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需要的一些按键信息,就可以起到相同效果。

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("<<<<<<<<<<<<<<<<<<<<<<<;
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("<<<<<<<<<<<<<<<<<<<<<<<;
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("<<<<<<<<<<<<<<<<<<<<<<<;
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("<<<<<<<<<<<<<<<<<<<<<<<;
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);
}
}

编译、下载运行:

6a6bdba2-d8a3-11ec-ba43-dac502259ad0.png6ace98fa-d8a3-11ec-ba43-dac502259ad0.png6af02b6e-d8a3-11ec-ba43-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,再放开。则打印的信息如:

6b12705c-d8a3-11ec-ba43-dac502259ad0.png

2、基于RT-Thread

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

RT-Thread menuconfig 方式:

RT-Threadonlinepackages--->
miscellaneouspackages--->
[*]FlexibleButton:Smallandflexiblebuttondriver--->
[*]Enableflexiblebuttondemo
version(latest)--->
6b43d98a-d8a3-11ec-ba43-dac502259ad0.png

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

6b98b75c-d8a3-11ec-ba43-dac502259ad0.png

运行测试:

6be9877c-d8a3-11ec-ba43-dac502259ad0.png


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

审核编辑 :李倩


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

    关注

    23

    文章

    4608

    浏览量

    92855
  • C语言
    +关注

    关注

    180

    文章

    7604

    浏览量

    136748
  • 源码
    +关注

    关注

    8

    文章

    640

    浏览量

    29193
  • RT-Thread
    +关注

    关注

    31

    文章

    1286

    浏览量

    40103

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

文章出处:【微信号:mcu168,微信公众号:硬件攻城狮】欢迎添加关注!文章转载请注明出处。

收藏 人收藏

    评论

    相关推荐

    RT-Thread上CAN实践

    开箱测试RT-Thread官方已完成了对英飞凌XMC7200EVK的移植,通过shell可以看到做好了uart3的console。本文将介绍如何进行RT-ThreadCan移植。接下来我们要完成CAN_FD的驱动移植,并正常启动RT-T
    的头像 发表于 11-13 01:03 1166次阅读
    <b class='flag-5'>RT-Thread</b>上CAN实践

    开源共生 商业共赢 | RT-Thread 2024开发者大会报名启动!

    亲爱的RT-Thread开发者我们很高兴地宣布,一年一度的RDC(RT-ThreadDeveloperConference,RT-Thread开发者大会)正式启动报名!2024RT-Threa
    的头像 发表于 10-29 08:06 385次阅读
    开源共生 商业共赢 | <b class='flag-5'>RT-Thread</b> 2024开发者大会报名启动!

    2024 RT-Thread全球巡回 线下培训火热来袭!

    亲爱的RT-Thread社区成员们:我们非常高兴地宣布,2024年RT-Thread全球开发者线下培训即将拉开帷幕!24年全球巡回培训将覆盖超10座城市及国家,为开发者提供一个深入学习RT-Thread嵌入式开发的绝佳机会。
    的头像 发表于 08-07 08:35 1202次阅读
    2024 <b class='flag-5'>RT-Thread</b>全球巡回 线下培训火热来袭!

    请问如何在NodeMcu上设置NON-OS SDK?

    如何在 NodeMcu 上设置 NON-OS SDK?
    发表于 07-19 14:51

    请问NON-OS SDK 2.0.0是否附带mbedTLS或axTLS?

    NON-OS SDK 2.0.0 是否附带 mbedTLS 或 axTLS? 我看到 mbedTLS 可作为单独的模块使用,但不确定 id SDK 2.0.0 使用 axTLS 与 mbed TLS 谢谢
    发表于 07-12 06:11

    RT-Thread 新里程碑达成——GitHub Star 破万!

    RT-Thread实时操作系统开源项目在GitHub上的star数量突破一万!截止发文,RT-Thread作为实时操作系统在业界Star数量排名第一!仓库地址:https://github.com
    的头像 发表于 07-04 08:35 475次阅读
    <b class='flag-5'>RT-Thread</b> 新里程碑达成——GitHub Star 破万!

    6月6日杭州站RT-Thread线下workshop,探索RT-Thread混合部署新模式!

    6月6日下午我们将在杭州举办RT-Thread混合部署线下workshop,在瑞芯微RK3568平台上实现同时运行RT-Thread和linux,本次workshop邀请到RT-Thread资深
    的头像 发表于 05-28 08:35 444次阅读
    6月6日杭州站<b class='flag-5'>RT-Thread</b>线下workshop,探索<b class='flag-5'>RT-Thread</b>混合部署新模式!

    2024 RT-Thread 全球技术大会演讲议程发布!

    RT-ThreadGlobalTechConference(RT-ThreadGTC,RT-Thread全球技术大会)致力于围绕RT-Thread基础软件技术发展、实践创新、开发者能力
    的头像 发表于 05-16 08:34 547次阅读
    2024 <b class='flag-5'>RT-Thread</b> 全球技术大会演讲议程发布!

    5月16日南京站RT-Thread线下workshop,探索RT-Thread混合部署新模式!

    5月16日下午我们将在南京举办RT-Thread混合部署线下workshop,在瑞芯微RK3568平台上实现同时运行RT-Thread和linux,本次workshop邀请到RT-Thread资深
    的头像 发表于 05-01 08:35 362次阅读
    5月16日南京站<b class='flag-5'>RT-Thread</b>线下workshop,探索<b class='flag-5'>RT-Thread</b>混合部署新模式!

    RT-Thread混合部署Workshop北京站来啦!

    4月25日,下午我们将在北京举办RT-Thread混合部署线下workshop,在瑞芯微RK3568平台上实现同时运行RT-Thread和linux,本次workshop邀请到RT-Thread资深
    的头像 发表于 04-19 08:34 438次阅读
    <b class='flag-5'>RT-Thread</b>混合部署Workshop北京站来啦!

    4月25日北京站RT-Thread线下workshop,探索RT-Thread混合部署新模式

    4月25日,下午我们将在北京举办RT-Thread混合部署线下workshop,在瑞芯微RK3568平台上实现同时运行RT-Thread和linux,本次workshop邀请到RT-Thread资深
    的头像 发表于 04-16 08:35 418次阅读
    4月25日北京站<b class='flag-5'>RT-Thread</b>线下workshop,探索<b class='flag-5'>RT-Thread</b>混合部署新模式

    RT-Thread荣获“最具影响力IoT操作系统奖”

    2024年3月30日,第十一届开源操作系统年度技术会议(OS2ATC)在西郊宾馆举办!RT-Thread作为国内领先的开源操作系统斩获了“最具影响力IoT操作系统奖”。该奖项是对RT-Thread
    的头像 发表于 04-12 08:37 432次阅读
    <b class='flag-5'>RT-Thread</b>荣获“最具影响力IoT操作系统奖”

    4月10日深圳场RT-Thread线下workshop,探索RT-Thread混合部署新模式!

    4月10日我们将在深圳福田举办RT-Thread混合部署线下workshop,在瑞芯微RK3568平台上实现同时运行RT-Thread和linux,本次workshop邀请到RT-Thread资深嵌入式软件工程师农晓明老师为您讲
    的头像 发表于 03-27 11:36 819次阅读
    4月10日深圳场<b class='flag-5'>RT-Thread</b>线下workshop,探索<b class='flag-5'>RT-Thread</b>混合部署新模式!

    4月10日深圳场RT-Thread线下workshop,探索RT-Thread混合部署新模式!

    4月10日我们将在深圳福田举办RT-Thread混合部署线下workshop,在瑞芯微RK3568平台上实现同时运行RT-Thread和linux,本次workshop邀请到RT-Thread资深
    的头像 发表于 03-27 08:34 532次阅读
    4月10日深圳场<b class='flag-5'>RT-Thread</b>线下workshop,探索<b class='flag-5'>RT-Thread</b>混合部署新模式!

    恩智浦半导体正式加入RT-Thread全球合作伙伴计划!

    前不久,恩智浦半导体正式加入RT-Thread全球合作伙伴计划,成为RT-Thread高级会员合作伙伴。同时,RT-Thread现已成为恩智浦注册合作伙伴(RT-Thread| 简介合
    的头像 发表于 03-14 10:40 619次阅读
    恩智浦半导体正式加入<b class='flag-5'>RT-Thread</b>全球合作伙伴计划!