MM32F3273G8P火龙果开发板MindSDK开发教程8 - MutilButton的移植

1、MutilButton简介

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

下载地址

2、MutilButton移植

a、将multi_button.c multi_button.h放到我们的工程里，并在Makefile里添加编译选项。
b、火龙果开发版只有一个用户案件，所以我们在main.c里面申请一个按键。

struct Button btn1;

c、初始化按键对象，绑定按键的GPIO电平读取接口read_button_pin() ，后一个参数设置有效触发电平

uint8_t read_button_GPIO(uint8_t button_id)
{
	// you can share the GPIO read function with multiple Buttons
	switch(button_id)
	{
		case btn1_id:
			return GPIO_ReadInDataBit(USER_KEY_PORT,USER_KEY_PIN);
		default:
			return 0;
	}
}

// for mutilbutton init
button_init(&btn1, read_button_GPIO, 0, btn1_id);

d、注册按键事件
这里只注册了按下跟松开的事件，当然也支持单击，双击，以及长按短按等事件。

typedef enum {
	PRESS_DOWN = 0,
	PRESS_UP,
	PRESS_REPEAT,
	SINGLE_CLICK,
	DOUBLE_CLICK,
	LONG_PRESS_START,
	LONG_PRESS_HOLD,
	number_of_event,
	NONE_PRESS
}PressEvent;

注册代码如下

button_attach(&btn1, PRESS_DOWN,       BTN1_PRESS_DOWN_Handler);
button_attach(&btn1, PRESS_UP,         BTN1_PRESS_UP_Handler);

e、启动按键

button_start(&btn1);

f、设置一个5ms间隔的定时器循环调用后台处理函数
我们使用TIM7，设置5ms进入中断一次，然后调用MutilButton的处理函数。
TiM7的初始化代码如下：

/**
 * TIM7 通用定时器，Mutilbutton 处理数据
 * 5ms中断一次，调用 button_ticks
 * 假设TIM6 预分频prescaler = 1200-1，即120000000/1200 = 100K的计数频率，
 * 在100K的计数频率下，1s中要计数100K次，5ms计数500次，
 * 所以预装值period = 500 - 1
 * 而mm32这里用到了 StepFreqHz = 120M/(prescaler + 1) = 120000000/1200 = 100K
*/
void BOARD_TIM7_Init(void)
{
    uint32_t prioritygroup = 0;
    /* Set the counter counting step. */
    TIM_Init_Type tim_init;
    tim_init.ClockFreqHz = 120000000;
    tim_init.StepFreqHz = 100000; /* 5ms. */
    tim_init.Period = 500-1;
    tim_init.EnablePreloadPeriod = false;
    tim_init.PeriodMode = TIM_PeriodMode_Continuous;
    tim_init.CountMode = TIM_CountMode_Increasing;
    TIM_Init(TIM7, &tim_init);

    // prioritygroup = NVIC_GetPriorityGrouping();
    // NVIC_SetPriority(SysTick_IRQn, NVIC_EncodePriority(prioritygroup, 0, 1));
    /* Enable interrupt. */
    NVIC_EnableIRQ(TIM7_IRQn);
    TIM_EnableInterrupts(TIM7, TIM_INT_UPDATE_PERIOD, true);

    /* Start the counter. */
    TIM_Start(TIM7);
}

/* TIM_BASIC Period timeout ISR. */
void TIM7_IRQHandler(void)
{
    uint32_t flags = TIM_GetInterruptStatus(TIM7);
    if ( 0u != (flags & TIM_STATUS_UPDATE_PERIOD ) ) /* Check update status. */
    {
        button_ticks();
    }
    TIM_ClearInterruptStatus(TIM7, flags);
}

3、main调用代码

#include <stdint.h>
#include <stdio.h>
#include "clock_init.h"
#include "hal_rcc.h"
#include "hal_gpio.h"
#include "hal_uart.h"
#include "led.h"
#include "uart.h"
#include "systick.h"
#include "key.h"
#include "timer.h"
#include "multi_button.h"

struct Button btn1;

void BTN1_PRESS_DOWN_Handler(void* btn)
{
	//do something...
	printf("BTN1_PRESS_DOWN_Handler \r\n");
}

void BTN1_PRESS_UP_Handler(void* btn)
{
	//do something...
	printf("BTN1_PRESS_UP_Handler \r\n");
}

int main(void)
{
	BOARD_InitBootClocks();  // 初始化时钟
	BOARD_InitDebugConsole();
	BOARD_UserKeyInit();
	LED_Init();
	BOARD_TIM6_Init();

	// for mutilbutton init
	button_init(&btn1, read_button_GPIO, 0, btn1_id);
	button_attach(&btn1, PRESS_DOWN,       BTN1_PRESS_DOWN_Handler);
	button_attach(&btn1, PRESS_UP,         BTN1_PRESS_UP_Handler);
	button_start(&btn1);

	BOARD_TIM7_Init();

	BOARD_Delay1Ms(1000);

	printf("Board Init Success\r\n");
	while(1)
	{

	}	
}