关于按钮多按钮的开源软件模块

钥匙在我们的生活中无处不在。买个开发板。按键是必要的功能。有些人肯定会说：按键就一个检测IO状态，有什么难度？,你真的很难简单地检测到一把钥匙。但是如果像单击、双击、三击，长按、短按这样的行动被发现了呢？如果它嵌入到一个复杂的项目中呢？有些功能看似简单，但在实际项目中并不简单。就像“LED亮灯””一样，如果能在各种项目中使用“LED照明”，就能超越很多人。今天，让我们分享一个关于按钮的开源软件模块：MultiButton（事件驱动型按键驱动模块）.简介

MultiButton是一个小巧易用的事件驱动按键驱动模块，可以无限扩展按键。关键事件的异步回调处理方法可以简化你的程序结构，去掉关键处理的冗余硬编码，让你的关键业务逻辑更加清晰。

开放源代码地址：

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

1.特性

多按钮由C语言实现，基于面向对象的设计思想，每个按钮对象分别由一个数据结构管理：

struct Button { uint16 _ t刻度；uint 8 _ t repeat : 4；uint8_t事件： 4；uint8_t状态： 3；uint8_t去抖_ CNT : 3；uint8_t有效_电平： 1；uint 8 _ t button _ level : 1；uint8_t (*hal_button_Level)(无效)；BtnCallback CB[number _ of _ event]；结构按钮*下一步；};

这样，每个按钮通过单向链表连接，然后依次进入button _ handler(struct button * handle)状态机，这样每个按钮的状态就相互独立了。

2.按键事件

事件描述：按下PRESS_DOWN按钮，每次按下都会触发PRESS_UP按钮弹出，每次释放都会触发PRESS_REPEAT。变量repeat计算连续点击的次数单击按钮事件双击按钮事件长按时间达到长按时间阈值时触发一次。

r style="border-top:1px solid;">LONG_PRESS_HOLD长按期间一直触发

使用方法

1.先申请一个按键结构

struct Button button1;2.初始化按键对象，绑定按键的GPIO电平读取接口read_button_pin() ，后一个参数设置有效触发电平。

button_init(&button1, read_button_pin, 0);3.注册按键事件

button_attach(&button1, SINGLE_CLICK, Callback_SINGLE_CLICK_Handler);button_attach(&button1, DOUBLE_CLICK, Callback_DOUBLE_Click_Handler);...4.启动按键

button_start(&button1);5.设置一个5ms间隔的定时器循环调用后台处理函数

while(1) { ... if(timer_ticks == 5) { timer_ticks = 0; button_ticks(); }}

实例

参考实例

#include "button.h"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) { }}

责任