日常用到開源組件—MultiButton

大家都知道“Stop Trying to Reinvent the Wheel”不要重復(fù)造輪子，但作為嵌入式程序猿每個項目都難免重復(fù)造些輪子。這個系(天)列(坑)會挨個介紹一些我日常用到開源組件，前人栽樹后人乘涼，縮減項目的開發(fā)周期好去摸(填)魚(坑)。

第一個組件，我重點推薦MultiButton！

按鍵！幾乎每個MCU級別的嵌入式項目都要用到，這是個天天要用的輪子，所以MultiButton這個組件就是我墻裂推薦的。感謝作者0x1abin

MultiButton 是一個小巧簡單(一個multi_button.c 一個multi_button.h)易用的事件驅(qū)動型按鍵驅(qū)動模塊，可無限量擴展按鍵，按鍵事件的回調(diào)異步處理方式可以簡化你的程序結(jié)構(gòu)，去除冗余的按鍵處理硬編碼，讓你的按鍵業(yè)務(wù)邏輯更清晰。

License也非常的友好：MIT license

可以去這里下載到

0x1abin/MultiButton: Button driver for embedded system (github.com)

https://gitee.com/mirrors_0x1abin/MultiButton

使用方法

1. 先申請一個按鍵結(jié)構(gòu)

struct Button button1

button_init(&button1, read_button_pin, 0, 0);

button_attach(&button1, SINGLE_CLICK, Callback_SINGLE_CLICK_Handler);
button_attach(&button1, DOUBLE_CLICK, Callback_DOUBLE_Click_Handler);
....

button_start(&button1);

while(1) {
    ...
    if(g_TimerTicks >= 5) {
        g_TimerTicks = 0;
        button_ticks();
    }
}

特性

MultiButton 使用C語言實現(xiàn)，基于面向?qū)ο蠓绞皆O(shè)計思路，每個按鍵對象單獨用一份數(shù)據(jù)結(jié)構(gòu)管理：

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  button_id;
     uint8_t  (*hal_button_Level)(uint8_t  button_id_);
     BtnCallback  cb[number_of_event];
     struct Button* next;
};

這樣每個按鍵使用單向鏈表相連，依次進(jìn)入 button_handler(struct Button* handle) 狀態(tài)機處理，所以每個按鍵的狀態(tài)彼此獨立。

按鍵事件

基于LPC系列的移植參考

以下代碼截圖基于NXP官方的LPC804開發(fā)板。

實際使用的時候，coder還要去看下multi_button.h里的兩個宏定義，TICKS_INTERVAL默認(rèn)是5即5mS，這個與它實例間隔5mS是對應(yīng)的。DEBOUNCE_TICKS默認(rèn)是3最大是8，用于按鍵消抖。長按和短按的時間靠LONG_TICKS和SHORT_TICKS設(shè)置或者說優(yōu)化，這兩個宏定義也在multi_button.h中。