MultiButton 是一個小巧簡單易用的事件驅動型按鍵驅動模塊，可無限量擴展按鍵，按鍵事件的回調異步處理方式可以簡化你的程序結構，去除冗余的按鍵處理硬編碼，讓你的按鍵業務邏輯更清晰。

【使用方法】

1.先申請一個按鍵結構

	

		
		

			struct Button button1;
		

	

2.初始化按鍵對象，綁定按鍵的GPIO電平讀取接口read_button_pin() ，后一個參數設置有效觸發電平

	

		
		

			button_init(&button1, read_button_pin, 0);
		

	

3.注冊按鍵事件

	

		
		

			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;
		

		

			};
		

	

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

按鍵事件

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...
		

		

			}
		

		

			
		

		

			...