按键在我们生活中无处不在,买一块开发板,按键是必备的一个功能。 肯定有人会说:按键就一个检测IO状态,有什么难度? 你单纯的检测一个按键,确实难度很低。但如果检测单击、双击、三击,长按、短按等操作呢?如果再将其嵌入到复杂的项目中呢? 有些功能看似很简单,实际项目中其实不简单。就好比“LED亮灯”,如果能将“LED点灯”运用在各种不同的项目中,你就能超越很多人了。 今天就来分享一个关于按键的开源软件模块:MultiButton(事件驱动型按键驱动模块)。
简介
MultiButton 是一个小巧简单易用的事件驱动型按键驱动模块,可无限量扩展按键,按键事件的回调异步处理方式可以简化你的程序结构,去除冗余的按键处理硬编码,让你的按键业务逻辑更清晰。
开源地址:
https://github.com/0x1abin/MultiButton
1.特性
MultiButton 使用C语言实现,基于面向对象方式设计思路,每个按键对象单独用一份数据结构管理:
struct Button {
uint16_t ticks;
uint8_t repeat: 4;
uint8_t event : 4;
uint8_t state : 3;
uint8_t debounce_cnt : 3;
uint8_t active_level : 1;
uint8_t button_level : 1;
uint8_t (*hal_button_Level)(void);
BtnCallback cb[number_of_event];
struct Button* next;
};
这样每个按键使用单向链表相连,依次进入 button_handler(struct Button* handle) 状态机处理,所以每个按键的状态彼此独立。
2.按键事件
事件 | 说明 |
---|---|
PRESS_DOWN | 按键按下,每次按下都触发 |
PRESS_UP | 按键弹起,每次松开都触发 |
PRESS_REPEAT | 重复按下触发,变量repeat计数连击次数 |
SINGLE_CLICK | 单击按键事件 |
DOUBLE_CLICK | 双击按键事件 |
LONG_PRESS_START | 达到长按时间阈值时触发一次 |
LONG_PRESS_HOLD | 长按期间一直触发 |
使用方法
1.先申请一个按键结构
struct Button button1;
2.初始化按键对象,绑定按键的GPIO电平读取接口read_button_pin() ,后一个参数设置有效触发电平。
button_init(&button1, read_button_pin, 0);
3.注册按键事件4.启动按键button_attach(&button1, SINGLE_CLICK, Callback_SINGLE_CLICK_Handler);
button_attach(&button1, DOUBLE_CLICK, Callback_DOUBLE_Click_Handler);
...
button_start(&button1);
5.设置一个5ms间隔的定时器循环调用后台处理函数while(1) {
...
if(timer_ticks == 5) {
timer_ticks = 0;
button_ticks();
}
}
实例
参考实例
struct Button btn1;
uint8_t read_button1_GPIO()
{
return HAL_GPIO_ReadPin(B1_GPIO_Port, B1_Pin);
}
void BTN1_PRESS_DOWN_Handler(void* btn)
{
//do something...
}
void BTN1_PRESS_UP_Handler(void* btn)
{
//do something...
}
int main()
{
button_init(&btn1, read_button1_GPIO, 0);
button_attach(&btn1, PRESS_DOWN, BTN1_PRESS_DOWN_Handler);
button_attach(&btn1, PRESS_UP, BTN1_PRESS_UP_Handler);
button_attach(&btn1, PRESS_REPEAT, BTN1_PRESS_REPEAT_Handler);
button_attach(&btn1, SINGLE_CLICK, BTN1_SINGLE_Click_Handler);
button_attach(&btn1, DOUBLE_CLICK, BTN1_DOUBLE_Click_Handler);
button_attach(&btn1, LONG_PRESS_START, BTN1_LONG_PRESS_START_Handler);
button_attach(&btn2, LONG_PRESS_HOLD, BTN1_LONG_PRESS_HOLD_Handler);
button_start(&btn1);
//make the timer invoking the button_ticks() interval 5ms.
//This function is implemented by yourself.
__timer_start(button_ticks, 0, 5);
while(1)
{
}
}
声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。
举报投诉
-
模块
+关注
关注
7文章
2473浏览量
46478 -
驱动
+关注
关注
11文章
1716浏览量
84330
原文标题:开源模块 | 事件驱动型按键驱动模块:MultiButton
文章出处:【微信号:strongerHuang,微信公众号:strongerHuang】欢迎添加关注!文章转载请注明出处。
发布评论请先 登录
相关推荐
按键消抖/开关量信号监测实现方案
关于按键消抖或者开关量信号监测,可以参考本公众号的另外一篇原创文章:按键消抖常用的软硬件方法。在该文章中介绍了两种软件延时的方式。但也都各有缺点。
汇聚开源力量,赋能软件发展,开放原子开源基金会携开源展区亮相软博会,开源展区现场引关注!
开源已成为全球软件技术和产业创新的主导模式,是技术应用和行业数字化发展的基石,开源在推动软件创新、促进技术发展与构建企业开放合作中发挥着重要作用。第二十五届中国国际
【开源之夏2023】聊⼀聊开源之夏以及项目的进展(rt-thread上用CI来验证软件包的编译情况)
前言 开源之夏是什么 ⾸先来简单介绍⼀下开源之夏。 开源之夏是开源软件供应链点亮计划下的⼀个暑期活动,由中国科学院
5点关于嵌入式开源软件的使用建议
开源软件许可可能很复杂。有十几种不同的许可方案,对用户提出了不同的要求。 在某些情况下,开发人员可以使用他们认为合适的开源软件。
发表于 07-17 16:19
•177次阅读
开源赋能 工业铸魂|2023开放原子全球开源峰会开源工业软件分论坛圆满举行
6 月 12 日,由开放原子开源基金会主办,开源工业软件工作委员会(以下简称“工委会”)承办,工业和信息化部电子第五研究所、哈尔滨工程大学青岛创新发展基地协办的 2023 开放原子全球开源
开源赋能 工业铸魂|2023开放原子全球开源峰会开源工业软件分论坛圆满举行
6月12日,由开放原子开源基金会主办,开源工业软件工作委员会(以下简称“工委会”)承办,工业和信息化部电子第五研究所、哈尔滨工程大学青岛创新发展基地协办的2023开放原子全球开源峰会
开源赋能 工业铸魂 | 2023开放原子全球开源峰会开源工业软件分论坛即将启幕
为进一步贯彻落实《“十四五”软件和信息技术服务业发展规划》等国家软件发展战略,由开放原子开源基金会主办、开源工业软件委员会(OpenAtom
评论