简介:
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
| 
楼主
