【MultiButton】并发状态事件驱动按键驱动模块,量产产品实践

2019-12-11 18:36发布

本帖最后由 半导体 于 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语言实现,基于面向对象方式设计思路,每个按键对象单独用一份数据结构管理:
  1. struct Button {
  2.     uint16_t ticks;
  3.     uint8_t  state : 3;
  4.     uint8_t  debounce_cnt : 3;
  5.     uint8_t  active_level : 1;
  6.     uint8_t  button_level : 1;
  7.     uint8_t  (*hal_button_Level)(void);
  8.     CallBackFunc  cb[number_of_event];
  9.     struct Button* next;
  10. };
复制代码
这样每个按键使用单向链表相连,依次进入 button_handler(struct Button* handle) 状态机处理,所以每个按键的状态彼此独立。


Examples
  1. #include "button.h"

  2. struct Button button1;
  3. struct Button button2;

  4. int read_button1_pin()
  5. {
  6.     return HAL_GPIO_ReadPin(B1_GPIO_Port, B1_Pin);  //HAL GPIO read.
  7. }
  8. ...

  9. int main()
  10. {
  11.     button_init(&button1, read_button1_pin, 0);  //初始化,绑定按键GPIO电平读取接口
  12.     button_init(&button2, read_button2_pin, 0);

  13.     button_attach(&button1, PRESSED, BTN1_SINGLE_CLICK_Handler);    //绑定 按键1 的单击事件回调
  14.     button_attach(&button1, DOUBLE_CLICK, BTN1_DOUBLE_Click_Handler);    //双击事件回调
  15.     button_attach(&button2, LONG_RRESS_START, BTN2_LONG_RRESS_START_Handler);  //绑定 按键2 长按开始事件回调
  16.     button_attach(&button2, LONG_PRESS_HOLD,  BTN2_LONG_PRESS_HOLD_Handler);
  17.     button_attach(&button2, LONG_PRESS_STOP,  BTN2_LONG_PRESS_STOP_Handler);

  18.     button_start(&button1);  //启动
  19.     button_start(&button2);
  20.    
  21.     //定时循环调用button_ticks() 后台处理函数,该调用方法由你的平台自行实现。
  22.     __timer_start(button_ticks, 0, 5);  
  23.    
  24.     while(ture)
  25.     {
  26.      ...
  27.     }
  28. }

  29. void BTN1_SINGLE_CLICK_Handler()
  30. {
  31.     //do something..
  32. }

  33. void BTN1_DOUBLE_Click_Handler()
  34. {
  35.     //do something..
  36. }
  37. ...
复制代码

模块下载地址:
https://github.com/0x1abin/MultiButton
友情提示: 此问题已得到解决,问题已经关闭,关闭后问题禁止继续编辑,回答。
该问题目前已经被作者或者管理员关闭, 无法添加新回复
99条回答
chenguanghua
1楼-- · 2019-12-18 22:01
请问一下支持组合按键吗?
半导体
2楼-- · 2019-12-19 01:47
chenguanghua 发表于 2016-9-10 14:41
请问一下支持组合按键吗?

支持了,在回调里查询其它按键事件就可以。
单飞
3楼-- · 2019-12-19 06:54
半导体 发表于 2016-9-11 13:43
支持了,在回调里查询其它按键事件就可以。

组合键?没找到哦(或者没看明白)
半导体
4楼-- · 2019-12-19 11:43
单飞 发表于 2016-9-12 07:58
组合键?没找到哦(或者没看明白)

比如你在按键1的回调里查询你要组合的按键情况,类似这样:
void BTN1_PRESS_DOWN_Handler(void* btn)
{
    if(get_button_event(&btn2) != NONE_PRESS) {
        //button1 & button2
    }
}
xfdr
5楼-- · 2019-12-19 16:08
 精彩回答 2  元偷偷看……
单飞
6楼-- · 2019-12-19 21:43
1、双击时,PRESS_UP(弹起事件)会比PRESS_DOWN(按下事件)多触发一次。
2、PRESS_REPEAT,测试的时候没触发过。
3、number_of_event这个也不知道干嘛的。
4、如果可以,长按的连发功能,可调连发速度。
5、如果可以,长按事件,可调的触发时长。
6、关于组合键,你提供的方案只支持组合键同时按下的情况,不支持先下基键再按另一个组合键。(必要性:①由于一些机械原因,能同时满足两个按键同时按下是一件不容易的事;②不能支持按下基键,再单击另一个组合键的连续操作)

一周热门 更多>