【国民技术N32G457评测】五、移植小型嵌入式多按键库 MultiButton

yang377156216

【国民技术N32G457评测】五、移植小型嵌入式多按键库 MultiButton [复制链接]

本帖最后由 yang377156216 于 2022-2-22 15:25 编辑

【前言】

在嵌入式软件开发中，通常需要独立按键支持多种功能，如：支持连击、双击、长按、组合连击、任意连击等等。之前使用过硬汉的按键检测程序，如果直接使用的话是没有问题，但是考虑到需要扩展多种按键组合以及多种功能还是有诸多不方便之处，到处搜罗了一遍网上的 FIFO Button ，最后找到个开源好用的 “MultiButton” 库，打算移植到测评开发板上来。

【MultiButton】

MultiButton 是一个小巧简单易用的事件驱动型按键驱动模块，可无限量扩展按键，按键事件的回调异步处理方式可以简化你的程序结构，去除冗余的按键处理硬编码，让你的按键业务逻辑更清晰。

【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 特性】

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) 状态机处理，所以每个按键的状态彼此独立。

【MultiButton 按键事件】

事件	说明
PRESS_DOWN	按键按下，每次按下都触发
PRESS_UP	按键弹起，每次松开都触发
PRESS_REPEAT	重复按下触发，变量repeat计数连击次数
SINGLE_CLICK	单击按键事件
DOUBLE_CLICK	双击按键事件
LONG_PRESS_START	达到长按时间阈值时触发一次
LONG_PRESS_HOLD	长按期间一直触发

【MultiButton 移植】

Step 1. 获取到

链接已隐藏，如需查看请登录或者注册

，往之前的模板工程中添加源码，且添加头文件路径：

Step 2. 添加 bsp 文件 key.c 和 key.h ，主要实现板载按键的初始化以及multi button 库的初始化，另外注册各个事件以及其实现，demo中实现了 SW1 的单击、 SW2 的双击、 SW3和Wakeup组合按键的长按3个事件，通过不同的 LED闪烁来直观感受各种按键功能。

struct Button btn1;
struct Button btn2;
struct Button btn3_wakeup;


/**
 * [url=home.php?mod=space&uid=159083]@brief[/url]  read wakeup pin value.
 * @param
 * @param
 */
uint8_t Read_ButtonWakeup_GPIO(void)
{
    return GPIO_ReadInputDataBit(KEY_WAKEUP_PORT, KEY_WAKEUP_INPUT_PIN);
}

/**
 * @brief  read key1 pin value.
 * @param
 * @param
 */
uint8_t Read_ButtonSW1_GPIO(void)
{
    return GPIO_ReadInputDataBit(KEY_SW1_PORT, KEY_SW1_PIN);
}

/**
 * @brief  read key2 pin value.
 * @param
 * @param
 */
uint8_t Read_ButtonSW2_GPIO(void)
{
    return GPIO_ReadInputDataBit(KEY_SW2_PORT, KEY_SW2_PIN);
}

/**
 * @brief  read key3&wakeup pin value.
 * @param
 * @param
 */
uint8_t Read_ButtonSW3_Wakeup_GPIO(void)
{
    if (!GPIO_ReadInputDataBit(KEY_SW3_PORT, KEY_SW3_PIN))
    {
        if (GPIO_ReadInputDataBit(KEY_WAKEUP_PORT, KEY_WAKEUP_INPUT_PIN))
            return 0;//active level is 0
    }
    return 1;//inactive level is 1
}

/**
 * @brief  SW1 btn single click event handler.
 * @param  btn
 * @param
 */
void BTN1_SINGLE_Click_Handler(void *btn)
{
    //do something...
    LedBlink(PORT_GROUP1, LED1_PIN);
}

/**
 * @brief  SW2 btn double click event handler.
 * @param  btn
 * @param
 */
void BTN2_DOUBLE_Click_Handler(void *btn)
{
    //do something...
    LedBlink(PORT_GROUP2, LED2_PIN);
}

/**
 * @brief  SW3 btn & Wakeup btn long press event handler.
 * @param  btn
 * @param
 */
void BTN3_WAKEUP_LONG_PRESS_START_Handler(void *btn)
{
    //do something...
    LedBlink(PORT_GROUP2, LED3_PIN);
}

/**
 * @brief  Configures key port.
 * @param GPIOx x can be A to G to select the GPIO port.
 * @param Pin This parameter can be GPIO_PIN_0~GPIO_PIN_15.
 */
void KeyInputInit(void)
{
    GPIO_InitType GPIO_InitStructure;

    RCC_EnableAPB2PeriphClk(RCC_APB2_PERIPH_GPIOA, ENABLE);

    /*Configure the GPIO pin as input floating*/
    GPIO_InitStructure.Pin        = KEY_SW1_PIN | KEY_SW2_PIN | KEY_SW3_PIN;
    GPIO_InitStructure.GPIO_Mode  = GPIO_Mode_IPU;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_InitPeripheral(KEY_SW1_PORT, &GPIO_InitStructure);

    GPIO_InitStructure.Pin        = KEY_WAKEUP_INPUT_PIN;
    GPIO_InitStructure.GPIO_Mode  = GPIO_Mode_IPD;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_InitPeripheral(KEY_WAKEUP_PORT, &GPIO_InitStructure);

    /* MultiButton init */
    button_init(&btn1, Read_ButtonSW1_GPIO, 0);
    button_init(&btn2, Read_ButtonSW2_GPIO, 0);
    button_init(&btn3_wakeup, Read_ButtonSW3_Wakeup_GPIO, 0);//btn3 & wakeup 组合键

    button_attach(&btn1, SINGLE_CLICK,     BTN1_SINGLE_Click_Handler);
    button_attach(&btn2, DOUBLE_CLICK,     BTN2_DOUBLE_Click_Handler);
    button_attach(&btn3_wakeup, LONG_PRESS_START, BTN3_WAKEUP_LONG_PRESS_START_Handler);

    button_start(&btn1);
    button_start(&btn2);
    button_start(&btn3_wakeup);
}

Step 3. 在main初始化时，调用按键初始化函数，并且注册按键轮询任务

/* Initialize sw1~sw3 and wakeup button */
    KeyInputInit();

mtmMain.Register(button_ticks,5);//每5ms轮询button tick一次

Step 4. 编译下载到开发板上，验证功能正常，可以实现单击、双击以及组合按键的长按功能，该小型软件库也非常方便地可以移植到其它平台。

【评测后序】

除了成功地完成了前面几篇测评任务，还验证了 USB和bxCAN 功能，这2大外设国民技术采用的策略非常明显，与 STM32 做得一样，且usbfs device 库也是使用的ST 的，所以比较稳定，上手也较为简单。本次开发板测评内容已全部结束，期待后续国民技术能带来更多优质国产MCU。

4. N32G45x_MultiButton_MillisTaskManager.zip (1.23 MB, 下载次数: 23)

【国民技术N32G457评测】五、移植小型嵌入式多按键库 MultiButton [复制链接]

浏览过的版块