开源模块 | 事件驱动型按键驱动模块：MultiButton

时间：2021-11-16 14:15:16

关键字：事件驱动驱动模块按键驱动

[导读]关注星标公众号，不错过精彩内容作者 | 0x1abin编排|strongerHuang按键在我们生活中无处不在，买一块开发板，按键是必备的一个功能。肯定有人会说：按键就一个检测IO状态，有什么难度？你单纯的检测一个按键，确实难度很低。但如果检测单击、双击、三击，长按、短按等操作呢...

作者 | 0x1abin

编排 | strongerHuang

按键在我们生活中无处不在，买一块开发板，按键是必备的一个功能。
肯定有人会说：按键就一个检测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	长按期间一直触发