MultiButton移植记录

使用记录

使用PA0引脚，电路图如下，使用GPIO内部下拉。

实际测试，很稳定，没有误触发，单击、双击、长按很稳定。

移植记录

1. 复制multi_button.c和multi_button.h到工程中，实现GPIO的初始化、读取。

void key_init(void)
{GPIO_InitTypeDef GPIO_InitStruct = {0};/* GPIO Ports Clock Enable */__HAL_RCC_GPIOA_CLK_ENABLE();/*Configure GPIO pin : KEY_WK_UP_Pin */GPIO_InitStruct.Pin = KEY_WK_UP_Pin;GPIO_InitStruct.Mode = GPIO_MODE_INPUT;GPIO_InitStruct.Pull = GPIO_PULLDOWN;HAL_GPIO_Init(KEY_WK_UP_GPIO_Port, &GPIO_InitStruct);
}
/// multi_button 移植接口
uint8_t read_button_gpio(uint8_t button_id)
{switch (button_id){case 1:return HAL_GPIO_ReadPin(KEY_WK_UP_GPIO_Port, KEY_WK_UP_Pin);break;default:return 0;}
}

2. 实现定时器回调，button_ticks()函数需要5ms调用一次，自己实现定时器中断，5ms中断一次。或者使用软件定时器。

void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
{if(htim->Instance == TIM6){button_ticks();}
}

调整下面参数，可以调整短按、长按的时间间隔

// Configuration constants - can be modified according to your needs
#define TICKS_INTERVAL          5    // ms - timer interrupt interval
#define DEBOUNCE_TICKS          3    // MAX 7 (0 ~ 7) - debounce filter depth
#define SHORT_TICKS             (300 / TICKS_INTERVAL)   // short press threshold
#define LONG_TICKS              (1000 / TICKS_INTERVAL)  // long press threshold
#define PRESS_REPEAT_MAX_NUM    15   // maximum repeat counter value

3. 使用MultiButton

void key_wkup_single_click_handle(Button *btn)
{static uint32_t cnt = 1;printf("key_wkup: Single Click,cnt = %d\n",cnt);cnt++;
}
void key_wkup_double_click_handle(Button *btn)
{static uint32_t cnt = 1;printf("key_wkup: Double Click,cnt = %d\n",cnt);cnt++;	
}
void key_wkup_long_press_handle(Button *btn)
{printf("key_wkup: long press\n");
}int main(void)
{//初始化按键,active_level:0:低电平有效，1:高电平有效button_init(&key_wkup,read_button_gpio,1,1);//注册单击事件回调button_attach(&key_wkup,BTN_SINGLE_CLICK,key_wkup_single_click_handle);//注册双击事件回调button_attach(&key_wkup,BTN_DOUBLE_CLICK,key_wkup_double_click_handle);//注册长按事件回调button_attach(&key_wkup,BTN_LONG_PRESS_START,key_wkup_long_press_handle);//启动按键处理button_start(&key_wkup);while(1){///process other things}}

轮询方式
裸机下的思路：
假如有四个按键，先注册好4个按键的各个回调函数，比如每个按键的单击、双击、长按等，然后在回调函数中，入队，也就是每个按键的状态入队，最后在轮询中查询队列是否为非空，如果非空，就表示有按键的事件，否则就表示没有按键事件。
需要写一个环形队列（FIFO）
RTOS下的思路：
和裸机思路一样，不过使用RTOS自带的队列，更方便的使用了。

参考资料：
开源链接: GitHub仓库