本帖最后由 超导式 于 2016-9-28 11:13 编辑
简介:
MultiButton 是一个小巧简单易用的事件驱动型按键驱动模块，可无限量扩展按键，按键事件的回调处理方式可以简化你的程序逻辑，去除冗余的按键处理硬编码，专注你的程序思路。
该模块已稳定用于公司多款量产智能硬件产品。
使用方法:
1. 先申请一个按键结构
struct Button button1;
2. 初始化按键对象，绑定按键连接的GPIO引脚，read_button_pin() 为按键的GPIO读取函数，后一个参数为设置触发电平
button_init(&button1, read_button_pin, 0);
3. 注册按键事件，共有以下5种事件:
PRESS_DOWN 按键按下，每次按下都触发
PRESS_UP 按键弹起，每次松开都触发
PRESS_REPEAT 重复按下触发，变量repeat计数连击次数
SINGLE_CLICK 单击按键事件
DOUBLE_CLICK 双击按键事件
LONG_RRESS_START 达到长按时间阈值时触发一次
LONG_PRESS_HOLD 长按期间一直触发
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 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;
- };
Examples
- #include "button.h"
- struct Button btn1;
- int read_button1_GPIO()
- {
- return HAL_GPIO_ReadPin(B1_GPIO_Port, B1_Pin);
- }
- 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_RRESS_START, BTN1_LONG_RRESS_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)
- {}
- }
- void BTN1_PRESS_DOWN_Handler(void* btn)
- {
- //do something...
- }
- void BTN1_PRESS_UP_Handler(void* btn)
- {
- //do something...
- }
- ...
模块下载地址：
github.com/0x1abin/MultiButton
| 
楼主
