本帖最后由 半导体 于 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. 
   
3. struct Button button1;
   
4. struct Button button2;
   
5. 
   
6. int read_button1_pin()
   
7. {
   
8.     return HAL_GPIO_ReadPin(B1_GPIO_Port, B1_Pin);  //HAL GPIO read.
   
9. }
   
10. ...
    
11. 
    
12. int main()
    
13. {
    
14.     button_init(&button1, read_button1_pin, 0);  //初始化，绑定按键GPIO电平读取接口
    
15.     button_init(&button2, read_button2_pin, 0);
    
16. 
    
17.     button_attach(&button1, PRESSED, BTN1_SINGLE_CLICK_Handler);    //绑定 按键1 的单击事件回调
    
18.     button_attach(&button1, DOUBLE_CLICK, BTN1_DOUBLE_Click_Handler);    //双击事件回调
    
19.     button_attach(&button2, LONG_RRESS_START, BTN2_LONG_RRESS_START_Handler);  //绑定 按键2 长按开始事件回调
    
20.     button_attach(&button2, LONG_PRESS_HOLD,  BTN2_LONG_PRESS_HOLD_Handler);
    
21.     button_attach(&button2, LONG_PRESS_STOP,  BTN2_LONG_PRESS_STOP_Handler);
    
22. 
    
23.     button_start(&button1);  //启动
    
24.     button_start(&button2);
    
25.    
    
26.     //定时循环调用button_ticks() 后台处理函数，该调用方法由你的平台自行实现。
    
27.     __timer_start(button_ticks, 0, 5);  
    
28.    
    
29.     while(ture)
    
30.     {
    
31.      ...
    
32.     }
    
33. }
    
34. 
    
35. void BTN1_SINGLE_CLICK_Handler()
    
36. {
    
37.     //do something..
    
38. }
    
39. 
    
40. void BTN1_DOUBLE_Click_Handler()
    
41. {
    
42.     //do something..
    
43. }
    
44. ...

复制代码

模块下载地址：
https://github.com/0x1abin/MultiButton