|
本帖最后由 半导体 于 2016-9-2 14:18 编辑
简介:
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..
- }
- ...
复制代码
模块下载地址:
https://github.com/0x1abin/MultiButton
|
阿莫论坛20周年了!感谢大家的支持与爱护!!
曾经有一段真挚的爱情摆在我的面前,我没有珍惜,现在想起来,还好我没有珍惜……
|