【MultiButton】并发状态事件驱动按键驱动模块

只看该作者 · 2016-9-28 11:06

本帖最后由超导式于 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