简介:
MultiButton 是一个小巧简单易用的事件驱动型按键驱动模块，可无限量扩展按键，按键事件的回调处理方式可以简化你的程序逻辑，去除冗余的按键处理硬编码，专注你的程序思路。
该模块已稳定用于公司多款量产智能硬件产品。
使用方法:
1. 先申请一个按键结构
struct Button button1;
2. 初始化按键对象，绑定按键连接的GPIO引脚，read_button_pin() 为按键的GPIO读取函数，后一个参数为设置触发电平
button_init(&button1, read_button_pin, 0);
3. 注册按键事件，共有以下5种事件:
CLICK //每次按下都会触发
PRESSED //单击触发
DOUBLE_CLICK //双击触发
LONG_RRESS_START //长按开始触发一次
LONG_PRESS_HOLD //长按过程一直触发
LONG_PRESS_STOP //长按松手触发
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();
}
}
特性:
MultiButton 使用C语言实现，基于面向对象方式设计思路，每个按键对象单独用一份数据结构管理：
struct Button {
uint16_t ticks;
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);
CallBackFunc cb[number_of_event];
struct Button* next;
};
这样每个按键使用单向链表相连，依次进入 button_handler(struct Button* handle) 状态机处理，所以每个按键的状态彼此独立。
Examples
#include "button.h"
struct Button button1;
struct Button button2;
int read_button1_pin()
{
return HAL_GPIO_ReadPin(B1_GPIO_Port, B1_Pin); //HAL GPIO read.
}
...
int main()
{
button_init(&button1, read_button1_pin, 0); //初始化，绑定按键GPIO电平读取接口
button_init(&button2, read_button2_pin, 0);
button_attach(&button1, PRESSED, BTN1_SINGLE_CLICK_Handler); //绑定 按键1 的单击事件回调
button_attach(&button1, DOUBLE_CLICK, BTN1_DOUBLE_Click_Handler); //双击事件回调
button_attach(&button2, LONG_RRESS_START, BTN2_LONG_RRESS_START_Handler); //绑定 按键2 长按开始事件回调
button_attach(&button2, LONG_PRESS_HOLD, BTN2_LONG_PRESS_HOLD_Handler);
button_attach(&button2, LONG_PRESS_STOP, BTN2_LONG_PRESS_STOP_Handler);
button_start(&button1); //启动
button_start(&button2);
//定时循环调用button_ticks() 后台处理函数，该调用方法由你的平台自行实现。
__timer_start(button_ticks, 0, 5);
while(ture)
{
...
}
}
void BTN1_SINGLE_CLICK_Handler()
{
//do something..
}
void BTN1_DOUBLE_Click_Handler()
{
//do something..
}
...
模块下载地址：
github.com/0x1abin/MultiButton
| 
楼主
标题置顶
标题高亮
