開源按鍵組件MultiButton支持菜單操作(事件驅(qū)動(dòng)型)
之前一個(gè)老友寫的MultiButton開源按鍵組件的剖析講解，它的設(shè)計(jì)思想簡(jiǎn)潔且高效，這篇文章我上周也分享出來給大家共同來學(xué)習(xí)了。
第1期 | MultiButton，一個(gè)小巧簡(jiǎn)單易用的事件驅(qū)動(dòng)型按鍵驅(qū)動(dòng)模塊
至于介紹和使用在這里我就不多說了，相信看上面這篇文章你應(yīng)該就懂了，但我想，能不能跟菜單操作綁定在一塊呢？這樣我不就可以利用起來，實(shí)現(xiàn)一個(gè)高效穩(wěn)定的菜單+按鍵結(jié)合的狀態(tài)機(jī)框架？縱觀網(wǎng)上很多寫菜單框架的，要不寫得太死板，要不寫得太冗長(zhǎng)了，還有的寫的還很難看得懂，超級(jí)麻煩，雖然各有各的方法去實(shí)現(xiàn)，都對(duì)，但有些真的不好維護(hù)和升級(jí)，比如下面這個(gè)，這應(yīng)該是網(wǎng)上廣泛流傳的一個(gè)菜單框架的版本。但我覺得我實(shí)在看不下去了。
還有一些年代久遠(yuǎn)的論文：
https://wenku.baidu.com/view/576bae38ee06eff9aef807b9.html
https://blog.csdn.net/embedded_guzi/article/details/35835755
https://blog.csdn.net/cjqqschoolqq/article/details/8701387我的項(xiàng)目設(shè)計(jì)原則：簡(jiǎn)單看得懂，實(shí)用，穩(wěn)定，高效可拓展。
通常一些手持式設(shè)備都會(huì)有各種各樣的按鍵，比如左、中、右、確定、返回、電源鍵等等(非矩陣鍵盤)，以我目前公司的產(chǎn)品，一般就這幾個(gè)按鍵。
我們公司的產(chǎn)品主要的業(yè)務(wù)邏輯還是應(yīng)用，應(yīng)用邏輯最大的工作量其實(shí)就是利用按鍵+頁(yè)面的形式來體現(xiàn)，這就少不了需要實(shí)現(xiàn)一套簡(jiǎn)單、高效、穩(wěn)定、可拓展、可維護(hù)的菜單+按鍵的軟件框架，有了這么一套好用的框架，后面隨便換一個(gè)產(chǎn)品，就不用重新再去開發(fā)了，我們就可以專注于應(yīng)用實(shí)現(xiàn)，把精力放在更有意義的軟件業(yè)務(wù)邏輯上來。接下來我們?cè)贛ultiButton的.h文件中添加菜單框架相關(guān)的結(jié)構(gòu)體以及一些枚舉：
/*菜單，具體是哪個(gè)頁(yè)面，這個(gè)留給用戶自己去添加*/
typedef enum
{
MAIN_PAGE = 0,
LOG_PAGE,
} MENU;
/*事件值，可以留給用戶自己去定義，這里我定義了一些我需要的事件*/
typedef enum
{
/*第一個(gè)事件為-1用來定義一個(gè)防止重復(fù)觸發(fā)的值*/
NULL_KEY_EVENT = -1,
LEFT_KEY_SHORT = 0,
LEFT_KEY_LONG = 1,
ENTER_KEY_SHORT = 2,
ENTER_KEY_LONG = 3,
RIGHT_LEY_SHORT = 4,
RIGHT_KEY_LONG = 5,
UP_KEY_SHORT = 6,
UP_KEY_LONG = 7,
DOWN_KEY_SHORT = 6,
DOWN_KEY_LONG = 7,
RETRUN_KEY_SHORT = 8,
RETRUN_KEY_LONG = 9,
POWER_KEY_SHORT = 10,
POWER_KEY_LONG = 11,
} EVENT_CODE;
/*菜單操作結(jié)構(gòu)體*/
typedef struct Menu
{
/*當(dāng)前正在執(zhí)行的頁(yè)面*/
uint8_t Current_Page ;
/*當(dāng)前觸發(fā)的事件*/
int KeyEvent ;
} Menu ;
/*菜單初始化*/
void menu_init(struct Menu *handle, uint8_t Page, int EVENT_CODE);
/*獲取當(dāng)前菜單*/
uint8_t Get_Menu(struct Menu *handle);
/*菜單跳轉(zhuǎn)*/
void Set_Menu(struct Menu *handle, uint8_t Page);
/*獲取當(dāng)前發(fā)生的事件值*/
int Get_Event_Code(struct Menu *handle);
/*設(shè)置當(dāng)前發(fā)生的事件值*/
void Set_Event_Code(struct Menu *handle, int Event_Code);
再來看看.c文件相關(guān)函數(shù)的實(shí)現(xiàn)：
/*菜單初始化*/
void menu_init(struct Menu *handle, uint8_t Page, int EVENT_CODE)
{
memset(handle, 0, sizeof(struct Menu));
handle->Current_Page = Page ;
handle->KeyEvent = EVENT_CODE ;
}
/*菜單跳轉(zhuǎn)*/
void Set_Menu(struct Menu *handle, uint8_t Page)
{
handle->Current_Page = Page ;
}
/*獲取當(dāng)前菜單*/
uint8_t Get_Menu(struct Menu *handle)
{
return handle->Current_Page ;
}
/*設(shè)置當(dāng)前發(fā)生的事件值*/
void Set_Event_Code(struct Menu *handle, int Event_Code)
{
handle->KeyEvent = Event_Code ;
}
/*獲取當(dāng)前發(fā)生的事件值*/
int Get_Event_Code(struct Menu *handle)
{
return handle->KeyEvent ;
}
非常簡(jiǎn)單，菜單的操作就在MutilButton的兩個(gè)文件中添加完成了，接下來看看怎么來使用吧？
1、常規(guī)的MultiButton的使用方法
Button button ;
/*讀取按鍵狀態(tài)*/
uint8_t read_button_pin_status(void)
{
return HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin); ;
}
初始化multi_button并注冊(cè)button event
button_init(&button, read_button_pin_status, 0);
button_attach(&button, SINGLE_CLICK, button_callback);
button_attach(&button, LONG_RRESS_START, button_callback);
button_start(&button);
當(dāng)前我注冊(cè)的這個(gè)按鍵的回調(diào)函數(shù)是同一個(gè)函數(shù)，而同一個(gè)函數(shù)做不同的處理：
void button_callback(void *event)
{
uint8_t button_event = get_button_event(&button) ;
switch(button_event)
{
case SINGLE_CLICK:
/*當(dāng)按鍵發(fā)生單擊時(shí)，注冊(cè)為ENTER_KEY_SHORT*/
Set_Event_Code(&menu, ENTER_KEY_SHORT);
break ;
case LONG_RRESS_START:
/*當(dāng)按鍵發(fā)生長(zhǎng)按時(shí)，注冊(cè)為ENTER_KEY_LONG*/
Set_Event_Code(&menu, ENTER_KEY_LONG);
break ;
default:
break ;
}
}
2、初始化菜單以及初始化觸發(fā)事件
Menu menu ;
//初始化頁(yè)面為主頁(yè)面，初始事件為NULL_KEY_EVENT
menu_init(&menu, MAIN_PAGE, NULL_KEY_EVENT);
3、循環(huán)調(diào)用菜單處理函數(shù)
while(1)
{
/*用戶代碼*/
/*......*/
Menu_Handler(&menu);
/*......*/
timer_loop();
/*用戶代碼*/
}
注意，這里還需要一個(gè)5ms的定時(shí)器來調(diào)用button_ticks();這樣MultiButton才能真正工作起來，我采用的是另外一套開源的軟件定時(shí)器框架MultiTimer來實(shí)現(xiàn)的，這里就不貼出來了，后面直接分享工程實(shí)踐測(cè)試源代碼。
菜單處理函數(shù)的實(shí)現(xiàn)：
/*菜單處理*/
void Menu_Handler(struct Menu *handle)
{
/*當(dāng)前是菜單的哪個(gè)頁(yè)面*/
switch(handle->Current_Page)
{
case MAIN_PAGE :
/*針對(duì)注冊(cè)的鍵值做相應(yīng)的處理*/
main_page_process(handle->KeyEvent);
break ;
case LOG_PAGE:
/*針對(duì)注冊(cè)的鍵值做相應(yīng)的處理*/
log_page_process(handle->KeyEvent);
break ;
default:
break ;
}
/*及時(shí)將事件清除，防止重復(fù)觸發(fā)*/
Set_Event_Code(handle, NULL_KEY_EVENT);
}
菜單對(duì)應(yīng)的頁(yè)面處理函數(shù)：
void main_page_process(uint8_t Event_Code)
{
switch(Event_Code)
{
/*當(dāng)發(fā)生事件時(shí)，需要的時(shí)候做狀態(tài)切換*/
case ENTER_KEY_SHORT:
printf("發(fā)生單擊，進(jìn)入頁(yè)面1\n");
Set_Menu(&menu, LOG_PAGE);
break ;
case ENTER_KEY_LONG:
printf("在頁(yè)面0發(fā)生長(zhǎng)按\n");
break ;
}
}
void log_page_process(uint8_t Event_Code)
{
switch(Event_Code)
{
case ENTER_KEY_SHORT:
printf("在頁(yè)面1發(fā)生單擊\n");
break ;
/*當(dāng)發(fā)生事件時(shí)，需要的時(shí)候做狀態(tài)切換*/
case ENTER_KEY_LONG:
printf("發(fā)生長(zhǎng)按，返回頁(yè)面0\n");
Set_Menu(&menu, MAIN_PAGE);
break ;
}
}
測(cè)試運(yùn)行結(jié)果：
測(cè)試平臺(tái)：stm32f103c8t6
測(cè)試工程下載：
鏈接：https://pan.baidu.com/s/124jks9I9uVXmKN3SXHQXvg
提取碼：hv3g
復(fù)制這段內(nèi)容后打開百度網(wǎng)盤手機(jī)App，操作更方便哦或者公眾號(hào)后臺(tái)回復(fù)：菜單 即可輕松獲得！
若覺得本次分享的文章對(duì)您有幫助，隨手點(diǎn)[在看]并轉(zhuǎn)發(fā)分享，也是對(duì)我的支持。
免責(zé)聲明：本文內(nèi)容由21ic獲得授權(quán)后發(fā)布，版權(quán)歸原作者所有，本平臺(tái)僅提供信息存儲(chǔ)服務(wù)。文章僅代表作者個(gè)人觀點(diǎn)，不代表本平臺(tái)立場(chǎng)，如有問題，請(qǐng)聯(lián)系我們，謝謝！
下載文檔
