让开源按键组件MultiButton支持菜单操做(事件驱动型)

看到以前一个老友写的MultiButton开源按键组件的剖析讲解，它的设计思想简洁且高效，如下是他的博客介绍的MultiButton这个教程：
MultiButton | 一个小巧简单易用的事件驱动型按键驱动模块
至于介绍和使用在这里我就很少说了，相信看上面这篇文章你应该就懂了，但我想，能不能跟菜单操做绑定在一块呢？这样我不就能够利用起来，实现一个高效稳定的菜单+按键结合状态机框架？web

纵观网上不少写菜单框架的，要不写得太死板，要不太冗长了，超级麻烦，也很差维护和升级，个人项目设计原则：简单看得懂，实用，稳定。框架

一般一些手持式设备都会有各类各样的按键，好比左、中、右、肯定、返回、电源键等等，以我目前公司的产品，通常就这几个按键。svg

但公司的产品主要的业务逻辑仍是应用，应用逻辑其实就是利用按键+页面的形式来体现，这就少不了须要实现一套简单、高效、稳定、可拓展、可维护的菜单+按键的软件框架，有了这么一套好用的框架，后面随便换一个产品，就不用从新再去开发了，咱们就能够专一于应用实现，把精力放在更有意义的软件业务逻辑上来。函数

接下来咱们在MultiButton的.h文件中添加菜单框架相关的结构体以及一些枚举：测试

/*菜单，具体是哪一个页面，这个留给用户本身去添加*/
typedef enum
{
    MAIN_PAGE = 0,
    LOG_PAGE,
} MENU;

/*事件值，能够留给用户本身去定义，这里我定义了一些我须要的事件*/
typedef enum
{
	/*第一个事件为-1用来定义一个防止重复触发的值*/
    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;

/*菜单操做结构体*/
typedef struct Menu
{
    /*当前正在执行的页面*/
    uint8_t Current_Page ;
    /*当前触发的事件*/
    int KeyEvent ;
} Menu ;


/*菜单初始化*/
void menu_init(struct Menu *handle, uint8_t Page, int EVENT_CODE);
/*获取当前菜单*/
uint8_t Get_Menu(struct Menu *handle);
/*菜单跳转*/
void Set_Menu(struct Menu *handle, uint8_t Page);
/*获取当前发生的事件值*/
int Get_Event_Code(struct Menu *handle);
/*设置当前发生的事件值*/
void Set_Event_Code(struct Menu *handle, int Event_Code);

再来看看.c文件相关函数的实现：ui

/*菜单初始化*/
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 ;
}

/*菜单跳转*/
void Set_Menu(struct Menu *handle, uint8_t Page)
{
    handle->Current_Page = Page  ;
}

/*获取当前菜单*/
uint8_t Get_Menu(struct Menu *handle)
{
    return handle->Current_Page ;
}

/*设置当前发生的事件值*/
void Set_Event_Code(struct Menu *handle, int Event_Code)
{
    handle->KeyEvent = Event_Code ;
}

/*获取当前发生的事件值*/
int Get_Event_Code(struct Menu *handle)
{
    return handle->KeyEvent ;
}

很是简单，菜单的操做就在MutilButton的两个文件中添加完成了，接下来看看怎么来使用吧？
一、常规的MultiButton的使用方法.net

//这里我
Button button ;
/*读取按键状态*/
uint8_t read_button_pin_status(void)
{
    return HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin); ;
}

初始化multi_button并注册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);

当前我注册的这个按键的回调函数是同一个函数，而同一个函数作不一样的处理：code

void button_callback(void *event)
{
    uint8_t button_event = get_button_event(&button) ;
	
    switch(button_event)
    {
        case SINGLE_CLICK:
            /*当按键发生单击时，注册为ENTER_KEY_SHORT*/
            Set_Event_Code(&menu, ENTER_KEY_SHORT);
            break ;

        case LONG_RRESS_START:
            /*当按键发生长按时，注册为ENTER_KEY_LONG*/
            Set_Event_Code(&menu, ENTER_KEY_LONG);
            break ;

        default:
            break ;
    }
}

二、初始化菜单以及初始化触发事件xml

Menu   menu ;
//初始化页面为主页面，初始事件为NULL_KEY_EVENT
menu_init(&menu, MAIN_PAGE, NULL_KEY_EVENT);

三、循环调用菜单处理函数(用户自行实现)

while(1)
{
    /*用户代码*/
    /*......*/
	Menu_Handler(&menu);
	 /*......*/
	 /*用户代码*/
}

注意，这里还须要一个5ms的定时器来调用button_ticks();这样MultiButton才能真正工做起来，我采用的事另一套开源的软件定时器框架MultiTimer来实现的，这里就不贴出来了，后面直接分享工程实践测试源代码。

菜单处理函数的实现：

/*菜单处理*/
void Menu_Handler(struct Menu *handle)
{
	/*当前是菜单的哪一个页面*/
    switch(handle->Current_Page)
    {
        case MAIN_PAGE :
        	/*针对注册的键值作相应的处理*/
            main_page_process(handle->KeyEvent);
            break ;

        case LOG_PAGE:
            /*针对注册的键值作相应的处理*/
            log_page_process(handle->KeyEvent);
            break ;

        default:
            break ;
    }

    /*及时将事件清除，防止重复触发*/
    Set_Event_Code(handle, NULL_KEY_EVENT);
}

相应的菜单处理函数：

void main_page_process(uint8_t Event_Code)
{
    switch(Event_Code)
    {
    	/*当发生事件时，须要的时候作状态切换*/
        case ENTER_KEY_SHORT:
            printf("发生单击，进入页面1\n");
            Set_Menu(&menu, LOG_PAGE);
            break ;

        case ENTER_KEY_LONG:
            printf("在页面0发生长按\n");
            break ;
    }
}

void log_page_process(uint8_t Event_Code)
{
    switch(Event_Code)
    {
        case ENTER_KEY_SHORT:
            printf("在页面1发生单击\n");
            break ;
		/*当发生事件时，须要的时候作状态切换*/
        case ENTER_KEY_LONG:
            printf("发生长按，返回页面0\n");
            Set_Menu(&menu, MAIN_PAGE);
            break ;
    }
}

测试运行结果：

测试平台：stm32f103c8t6

测试工程：

连接：https://pan.baidu.com/s/124jks9I9uVXmKN3SXHQXvg 
提取码：hv3g 
复制这段内容后打开百度网盘手机App，操做更方便哦

本文同步分享在博客“Engineer-Bruce_Yang”（CSDN）。
若有侵权，请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”，欢迎正在阅读的你也加入，一块儿分享。