当前位置：首页 > news >正文

初出茅庐的小李博客之按键驱动库使用

news 来源：原创 2025/6/23 14:41:06

驱动库介绍

源码地址：https://github.com/jiejieTop/ButtonDrive
使用只需3步，创建按键，按键事件与回调处理函数链接映射，周期检查按键，支持单双击、连按、长按；采用回调处理按键事件（自定义消抖时间）
按键代码想必做嵌入式开发的无人不知无人不晓吧，但是真的在项目中我们的按键不仅仅是一个按钮那么简单，可能会涉及到长按
双击、单机、连击等操作。举个日常生活中的理解，比如我们在机场经常会可以看到免费的饮水机，一般都是三个按钮，一个是热水开关、一个是常温水开关、还有一个是童锁开关，为什么会设置这个童锁开关呢，我想这里应该是处于安全考虑，一般冷水都是按一下开再按一下就关这个逻辑很清晰，热水也是一样，但是热水比较危险如果小孩子不慎触碰就会有烫伤危险所以童锁的按钮就显得比较重要了，童锁也是一个普通按钮只不过童锁一般都需要长按解锁，虽然叫童锁其实也是大人锁，这个按钮一般都是要长按解锁后再开启热水的开关这样做就会比较安全。假设我们需要这样的功能，那么这个驱动库就比较有用了。

移植适配

1.下载源码

准备好自己的工程

自己的工程中需要适配一下底层IO口的配置
再一个就是移植修改两个读取IO电平状态的接口
创建两个按钮并且编写其按下后回调函数

Button_t Button1;/*创建一个按钮Button1*/
Button_t Button2; /*创建一个按钮Button2*/

/*按钮1单击执行动作*/
void Btn1_Dowm_CallBack(void *btn)
{
  PRINT_INFO("Button1 单击!");
}
/*按钮1双击执行动作*/
void Btn1_Double_CallBack(void *btn)
{
  PRINT_INFO("Button1 双击!");
}
/*按钮1长按执行动作*/
void Btn1_Long_CallBack(void *btn)
{
  PRINT_INFO("Button1 长按!");
}
/*按钮1连按执行动作*/
void Btn1_Continuos_CallBack(void *btn)
{
  PRINT_INFO("Button1 连按!");
}
/*按钮1连按释放执行动作*/
void Btn1_ContinuosFree_CallBack(void *btn)
{
  PRINT_INFO("Button1 连按释放!");
}

/*按钮2单击执行动作*/
void Btn2_Dowm_CallBack(void *btn)
{
  PRINT_INFO("Button2 单击!");
}
/*按钮2双击执行动作*/
void Btn2_Double_CallBack(void *btn)
{
  PRINT_INFO("Button2 双击!");
}
/*按钮2长按执行动作*/
void Btn2_Long_CallBack(void *btn)
{
  PRINT_INFO("Button2 长按!");
}
/*按钮2连按执行动作*/
void Btn2_Continuos_CallBack(void *btn)
{
  PRINT_INFO("Button2 连按!");
}
/*按钮2连按释放执行动作*/
void Btn2_ContinuosFree_CallBack(void *btn)
{
  PRINT_INFO("Button2 连按释放!");
}

编写测试程序

编写测试按钮前适配一下串口方便打印调试信息
把两个按钮的底层先初始化一下可以读取IO口状态
Button_Process(); 需要周期调用按键处理函数直接放while循环

int main(void)
{
	LED_Config();
	KEY_Config();
	USART1_Config();
	//RS485_Config();
	/* 打印信息 */
	PRINT_INFO("welcome to learn jiejie stm32 library!\n");


	Button_Create("Button1",&Button1,Read_Button1_Level, HIGH);
	Button_Attach(&Button1,BUTTON_DOWM,Btn1_Dowm_CallBack);                       //单击
	Button_Attach(&Button1,BUTTON_DOUBLE,Btn1_Double_CallBack);                   //双击
	Button_Attach(&Button1,BUTTON_CONTINUOS,Btn1_Continuos_CallBack);             //连按  
	Button_Attach(&Button1,BUTTON_CONTINUOS_FREE,Btn1_ContinuosFree_CallBack);    //连按释放  
	Button_Attach(&Button1,BUTTON_LONG,Btn1_Long_CallBack);                       //长按


	Button_Create("Button2",&Button2, Read_Button2_Level, LOW);
	Button_Attach(&Button2,BUTTON_DOWM,Btn2_Dowm_CallBack);                     //单击
	Button_Attach(&Button2,BUTTON_DOUBLE,Btn2_Double_CallBack);                 //双击
	Button_Attach(&Button2,BUTTON_CONTINUOS,Btn2_Continuos_CallBack);           //连按
	Button_Attach(&Button2,BUTTON_CONTINUOS_FREE,Btn2_ContinuosFree_CallBack);  //连按释放
	Button_Attach(&Button2,BUTTON_LONG,Btn2_Long_CallBack);                     //长按

	Get_Button_Event(&Button1);
	Get_Button_Event(&Button2);

	while(1)                            
	{
//		if((GPIOA->IDR & 1<<0) ==0)
//		{
//			LED1_ONOFF(1);
//		}
//		else
//		{
//			LED1_ONOFF(0);
//		}
		Button_Process();     //需要周期调用按键处理函数
		Delay_Nms(20);
	}
}