21ic电子技术开发论坛 › 单片机与嵌入式系统 › 雅特力AT32 MCU › 【AT-START-F423测评】移植一个优秀的按键程序 ...
返回列表 发新帖我要提问

[AT32F423] 【AT-START-F423测评】移植一个优秀的按键程序

[复制链接]
 楼主| lulugl 发表于 2023-10-25 09:32 | 显示全部楼层 |阅读模式
<
AT32F423, 按键程序, 移植
本帖最后由 lulugl 于 2023-10-25 09:34 编辑

#申请原创# #有奖活动#@21ic小跑堂
【按键驱动】
单片机在输入设备中，按键是最简单经济可靠的设备之一。单按键可以直接由GPIO来驱动，采集他的高低电平来实现按键状态的功能，但是在实际中，按键的状态获取，要考虑到消抖情况，如果单一按键要通过单击、双击、连击、长按等来实现结合功能，那就实现起来就非常复杂，效果也不是非常好。
在github中我找到了一个开源的按键驱动，Button_drive是一个小巧的按键驱动，支持单击、双击、长按、连续触发等（后续可以在按键控制块中添加触发事件），理论上可无限量扩展Button，Button_drive采用按键触发事件回调方式处理业务逻辑，支持在RTOS中使用，我目前仅在 HYPERLINK "https://github.com/RT-Thread/rt-thread" 上测试过。 写按键驱动的目的是想要将用户按键逻辑与按键处理事件分离，用户无需处理复杂麻烦的逻辑事件。https://github.com/jiejieTop/ButtonDrive
【实现方式】
下载github源码
复制一份示例的printf工程到一个新的文件夹中，重命名为printf_button。
d5106db8e81438ec5fa1ab5d5a768419
解压源码后复制button.c/h到工程文件的middlewares下的button文件夹中。
9842e4bafd50d7189fec0b4e13bfdebf
在工程文件中新增button组，把button.c加入button组中。
a20a24f8a42a16ae616438a379b31c12
添加头文件的引用。
2897d7b07193197dc8be08aab9c867dd
在button.c中添加at32f423_board.h头文件的引用。
3d400889c601b643d75d23e225f01ce3
在button.c中实现按键电平的获取自定义函数，在模版工程中，官方在at32f423_board.c中实现的按键的初始化，我们直接引用就可以实现按键状态的获取：
复制
  1. /* 获取按键电平 */
    


  2. 

  3. uint8_t Read_KEY1_Level(void)
    


  4. 

  5. {
    


  6. 

  7. return at32_button_state();
    


  8. 

  9. }

在main.c中，我们实现用户的单击、双击、长按释放的功能回调函数，代码如下：
复制
  1. Button_t Button1;
    


  2. 

  3. void Btn1_Dowm_CallBack(void *btn)
    


  4. 

  5. {
    


  6. 

  7. printf("Button1 单击!\r\n");
    


  8. 

  9. }
    


  10. 

  11. void Btn1_Double_CallBack(void *btn)
    


  12. 

  13. {
    


  14. 

  15. printf("Button1 双击!\r\n");
    


  16. 

  17. }
    


  18. 

  19. void Btn1_Long_CallBack(void *btn)
    


  20. 

  21. {
    


  22. 

  23. printf("Button1 长按!\r\n");
    


  24. 

  25. }
    


  26. 

  27. void Btn1_ContinuosFree_CallBack(void *btn)
    


  28. 

  29. {
    


  30. 

  31. printf("Button1 连按释放!\r\n");
    


  32. 

  33. }

在主函中，我们注册需要实现的功能函数，我这里添加单击、双击、长按、长按释放，代码如下：
复制
  1. Button_Attach(&Button1,BUTTON_DOWM,Btn1_Dowm_CallBack); //单击
    


  2. 

  3. Button_Attach(&Button1,BUTTON_DOUBLE,Btn1_Double_CallBack); //双击
    


  4. 

  5. Button_Attach(&Button1,BUTTON_LONG,Btn1_Long_CallBack); //长按BUTTON_LONG_FREE,
    


  6. 

  7. Button_Attach(&Button1,BUTTON_LONG_FREE,Btn1_ContinuosFree_CallBack);

在while中添加按键检测函数：
复制
  1. Button_Process(); //需要周期调用按键处理函数

到此，移植结束，下载到开发板上可以实现相应的功能，按下开发板的按键，就在串口打印出相应的状态：
79ee03a2f36f9b7b8a7ce3677c24a7dd
button.c完整程序如下：
复制
  1. /************************************************************
    

  2.   * [url=home.php?mod=space&uid=247401]@brief[/url]   按键驱动
    

  3.         * @param   NULL
    

  4.   * [url=home.php?mod=space&uid=266161]@return[/url]  NULL
    

  5.   * [url=home.php?mod=space&uid=187600]@author[/url]  jiejie
    

  6.   * [url=home.php?mod=space&uid=2757600]@Github[/url]  https://github.com/jiejieTop
    

  7.   * [url=home.php?mod=space&uid=212281]@date[/url]    2018-xx-xx
    

  8.   * [url=home.php?mod=space&uid=895143]@version[/url] v1.0
    

  9.   * [url=home.php?mod=space&uid=536309]@NOTE[/url]    button.c
    

  10.   ***********************************************************/
    

  11. #include "button.h"
    

  12. #include "at32f423_board.h"
    

  13. #include "stdio.h"
    

  14. #include "string.h"
    

  15. /*******************************************************************
    

  16.  *                          变量声明                               
    

  17.  *******************************************************************/
    


  18. 

  19. static struct button* Head_Button = NULL;
    


  20. 


  21. 

  22. /*******************************************************************
    

  23.  *                         函数声明     
    

  24.  *******************************************************************/
    

  25. static char *StrnCopy(char *dst, const char *src, uint32_t n);
    

  26. static void Print_Btn_Info(Button_t* btn);
    

  27. static void Add_Button(Button_t* btn);
    


  28. 


  29. 

  30. /************************************************************
    

  31.   * [url=home.php?mod=space&uid=247401]@brief[/url]   按键创建
    

  32.         * @param   name : 按键名称
    

  33.         * @param   btn : 按键结构体
    

  34.   * @param   read_btn_level : 按键电平读取函数，需要用户自己实现返回uint8_t类型的电平
    

  35.   * @param   btn_trigger_level : 按键触发电平
    

  36.   * [url=home.php?mod=space&uid=266161]@return[/url]  NULL
    

  37.   * [url=home.php?mod=space&uid=187600]@author[/url]  jiejie
    

  38.   * [url=home.php?mod=space&uid=2757600]@Github[/url]  https://github.com/jiejieTop
    

  39.   * [url=home.php?mod=space&uid=212281]@date[/url]    2018-xx-xx
    

  40.   * [url=home.php?mod=space&uid=895143]@version[/url] v1.0
    

  41.   * [url=home.php?mod=space&uid=536309]@NOTE[/url]    NULL
    

  42.   ***********************************************************/
    

  43. void Button_Create(const char *name,
    

  44.                   Button_t *btn, 
    

  45.                   uint8_t(*read_btn_level)(void),
    

  46.                   uint8_t btn_trigger_level)
    

  47. {
    

  48.   if( btn == NULL)
    

  49.   {
    

  50.     printf("struct button is null!");
    

  51.     //ASSERT(ASSERT_ERR);
    

  52.   }
    

  53.   
    

  54.   memset(btn, 0, sizeof(struct button));  //清除结构体信息，建议用户在之前清除
    

  55.  
    

  56.   StrnCopy(btn->Name, name, BTN_NAME_MAX); /* 创建按键名称 */
    

  57.   
    

  58.   
    

  59.   btn->Button_State = NONE_TRIGGER;           //按键状态
    

  60.   btn->Button_Last_State = NONE_TRIGGER;      //按键上一次状态
    

  61.   btn->Button_Trigger_Event = NONE_TRIGGER;   //按键触发事件
    

  62.   btn->Read_Button_Level = read_btn_level;    //按键读电平函数
    

  63.   btn->Button_Trigger_Level = btn_trigger_level;  //按键触发电平
    

  64.   btn->Button_Last_Level = btn->Read_Button_Level(); //按键当前电平
    

  65.   btn->Debounce_Time = 0;
    

  66.   
    

  67.   printf("button create success!");
    

  68.   
    

  69.   Add_Button(btn);          //创建的时候添加到单链表中
    

  70.   
    

  71.   Print_Btn_Info(btn);     //打印信息
    

  72.  
    

  73. }
    


  74. 

  75. /************************************************************
    

  76.   * @brief   按键触发事件与回调函数映射链接起来
    

  77.         * @param   btn : 按键结构体
    

  78.         * @param   btn_event : 按键触发事件
    

  79.   * @param   btn_callback : 按键触发之后的回调处理函数。需要用户实现
    

  80.   * @return  NULL
    

  81.   * @author  jiejie
    

  82.   * @github  https://github.com/jiejieTop
    

  83.   * @date    2018-xx-xx
    

  84.   * @version v1.0
    

  85.   ***********************************************************/
    

  86. void Button_Attach(Button_t *btn,Button_Event btn_event,Button_CallBack btn_callback)
    

  87. {
    

  88.         uint8_t i;
    

  89.   if( btn == NULL)
    

  90.   {
    

  91.     printf("struct button is null!");
    

  92.     //ASSERT(ASSERT_ERR);       //断言
    

  93.   }
    

  94.   
    

  95.   if(BUTTON_ALL_RIGGER == btn_event)
    

  96.   {
    

  97.     for(i = 0 ; i < number_of_event-1 ; i++)
    

  98.       btn->CallBack_Function[i] = btn_callback; //按键事件触发的回调函数，用于处理按键事件
    

  99.   }
    

  100.   else
    

  101.   {
    

  102.     btn->CallBack_Function[btn_event] = btn_callback; //按键事件触发的回调函数，用于处理按键事件
    

  103.   }
    

  104. }
    


  105. 

  106. /************************************************************
    

  107.   * @brief   删除一个已经创建的按键
    

  108.         * @param   NULL
    

  109.   * @return  NULL
    

  110.   * @author  jiejie
    

  111.   * @github  https://github.com/jiejieTop
    

  112.   * @date    2018-xx-xx
    

  113.   * @version v1.0
    

  114.   * @note    NULL
    

  115.   ***********************************************************/
    

  116. void Button_Delete(Button_t *btn)
    

  117. {
    

  118.   struct button** curr;
    

  119.   for(curr = &Head_Button; *curr;) 
    

  120.   {
    

  121.     struct button* entry = *curr;
    

  122.     if (entry == btn) 
    

  123.     {
    

  124.       *curr = entry->Next;
    

  125.     } 
    

  126.     else
    

  127.     {
    

  128.       curr = &entry->Next;
    

  129.     }
    

  130.   }
    

  131. }
    


  132. 

  133. /************************************************************
    

  134.   * @brief   获取按键触发的事件
    

  135.         * @param   NULL
    

  136.   * @return  NULL
    

  137.   * @author  jiejie
    

  138.   * @github  https://github.com/jiejieTop
    

  139.   * @date    2018-xx-xx
    

  140.   * @version v1.0
    

  141.   ***********************************************************/
    

  142. void Get_Button_EventInfo(Button_t *btn)
    

  143. {
    

  144.         uint8_t i;
    

  145.   //按键事件触发的回调函数，用于处理按键事件
    

  146.   for(i = 0 ; i < number_of_event-1 ; i++)
    

  147.   {
    

  148.     if(btn->CallBack_Function[i] != 0)
    

  149.     {
    

  150.       printf("Button_Event:%d",i);
    

  151.     }      
    

  152.   } 
    

  153. }
    


  154. 

  155. uint8_t Get_Button_Event(Button_t *btn)
    

  156. {
    

  157.   return (uint8_t)(btn->Button_Trigger_Event);
    

  158. }
    


  159. 

  160. /************************************************************
    

  161.   * @brief   获取按键触发的事件
    

  162.         * @param   NULL
    

  163.   * @return  NULL
    

  164.   * @author  jiejie
    

  165.   * @github  https://github.com/jiejieTop
    

  166.   * @date    2018-xx-xx
    

  167.   * @version v1.0
    

  168.   ***********************************************************/
    

  169. uint8_t Get_Button_State(Button_t *btn)
    

  170. {
    

  171.   return (uint8_t)(btn->Button_State);
    

  172. }
    


  173. 

  174. /************************************************************
    

  175.   * @brief   按键周期处理函数
    

  176.   * @param   btn:处理的按键
    

  177.   * @return  NULL
    

  178.   * @author  jiejie
    

  179.   * @github  https://github.com/jiejieTop
    

  180.   * @date    2018-xx-xx
    

  181.   * @version v1.0
    

  182.   * @note    必须以一定周期调用此函数，建议周期为20~50ms
    

  183.   ***********************************************************/
    

  184. void Button_Cycle_Process(Button_t *btn)
    

  185. {
    

  186.   uint8_t current_level = (uint8_t)btn->Read_Button_Level();//获取当前按键电平
    

  187.   
    

  188.   if((current_level != btn->Button_Last_Level)&&(++(btn->Debounce_Time) >= BUTTON_DEBOUNCE_TIME)) //按键电平发生变化，消抖
    

  189.   {
    

  190.       btn->Button_Last_Level = current_level; //更新当前按键电平
    

  191.       btn->Debounce_Time = 0;                 //确定了是按下
    

  192.       
    

  193.       //如果按键是没被按下的，改变按键状态为按下(首次按下/双击按下)
    

  194.       if((btn->Button_State == NONE_TRIGGER)||(btn->Button_State == BUTTON_DOUBLE))
    

  195.       {
    

  196.         btn->Button_State = BUTTON_DOWM;
    

  197.       }
    

  198.       //释放按键
    

  199.       else if(btn->Button_State == BUTTON_DOWM)
    

  200.       {
    

  201.         btn->Button_State = BUTTON_UP;
    

  202.         TRIGGER_CB(BUTTON_UP);    // 触发释放
    

  203. //        printf("释放了按键");
    

  204.       }
    

  205.   }
    

  206.   
    

  207.   switch(btn->Button_State)
    

  208.   {
    

  209.     case BUTTON_DOWM :            // 按下状态
    

  210.     {
    

  211.       if(btn->Button_Last_Level == btn->Button_Trigger_Level) //按键按下
    

  212.       {
    

  213.         #if CONTINUOS_TRIGGER     //支持连续触发
    


  214. 

  215.         if(++(btn->Button_Cycle) >= BUTTON_CONTINUOS_CYCLE)
    

  216.         {
    

  217.           btn->Button_Cycle = 0;
    

  218.           btn->Button_Trigger_Event = BUTTON_CONTINUOS; 
    

  219.           TRIGGER_CB(BUTTON_CONTINUOS);    //连按
    

  220.           printf("连按");
    

  221.         }
    

  222.         
    

  223.         #else
    

  224.         
    

  225.         btn->Button_Trigger_Event = BUTTON_DOWM;
    

  226.       
    

  227.         if(++(btn->Long_Time) >= BUTTON_LONG_TIME)  //释放按键前更新触发事件为长按
    

  228.         {
    

  229.           #if LONG_FREE_TRIGGER
    

  230.           
    

  231.           btn->Button_Trigger_Event = BUTTON_LONG; 
    

  232.           
    

  233.           #else
    

  234.           
    

  235.           if(++(btn->Button_Cycle) >= BUTTON_LONG_CYCLE)    //连续触发长按的周期
    

  236.           {
    

  237.             btn->Button_Cycle = 0;
    

  238.             btn->Button_Trigger_Event = BUTTON_LONG; 
    

  239.             TRIGGER_CB(BUTTON_LONG);    //长按
    

  240.           }
    

  241.           #endif
    

  242.           
    

  243.           if(btn->Long_Time == 0xFF)  //更新时间溢出
    

  244.           {
    

  245.             btn->Long_Time = BUTTON_LONG_TIME;
    

  246.           }
    

  247. //          printf("长按");
    

  248.         }
    

  249.           
    

  250.         #endif
    

  251.       }
    


  252. 

  253.       break;
    

  254.     } 
    

  255.     
    

  256.     case BUTTON_UP :        // 弹起状态
    

  257.     {
    

  258.       if(btn->Button_Trigger_Event == BUTTON_DOWM)  //触发单击
    

  259.       {
    

  260.         if((btn->Timer_Count <= BUTTON_DOUBLE_TIME)&&(btn->Button_Last_State == BUTTON_DOUBLE)) // 双击
    

  261.         {
    

  262.           btn->Button_Trigger_Event = BUTTON_DOUBLE;
    

  263.           TRIGGER_CB(BUTTON_DOUBLE);    
    

  264. //          printf("双击");
    

  265.           btn->Button_State = NONE_TRIGGER;
    

  266.           btn->Button_Last_State = NONE_TRIGGER;
    

  267.         }
    

  268.         else
    

  269.         {
    

  270.             btn->Timer_Count=0;
    

  271.             btn->Long_Time = 0;   //检测长按失败，清0
    

  272.           
    

  273.           #if (SINGLE_AND_DOUBLE_TRIGGER == 0)
    

  274.             TRIGGER_CB(BUTTON_DOWM);    //单击
    

  275.           #endif
    

  276.             btn->Button_State = BUTTON_DOUBLE;
    

  277.             btn->Button_Last_State = BUTTON_DOUBLE;
    

  278.           
    

  279.         }
    

  280.       }
    

  281.       
    

  282.       else if(btn->Button_Trigger_Event == BUTTON_LONG)
    

  283.       {
    

  284.         #if LONG_FREE_TRIGGER
    

  285.           TRIGGER_CB(BUTTON_LONG);    //长按
    

  286.         #else
    

  287.           TRIGGER_CB(BUTTON_LONG_FREE);    //长按释放
    

  288.         #endif
    

  289.         btn->Long_Time = 0;
    

  290.         btn->Button_State = NONE_TRIGGER;
    

  291.         btn->Button_Last_State = BUTTON_LONG;
    

  292.       } 
    

  293.       
    

  294.       #if CONTINUOS_TRIGGER
    

  295.         else if(btn->Button_Trigger_Event == BUTTON_CONTINUOS)  //连按
    

  296.         {
    

  297.           btn->Long_Time = 0;
    

  298.           TRIGGER_CB(BUTTON_CONTINUOS_FREE);    //连发释放
    

  299.           btn->Button_State = NONE_TRIGGER;
    

  300.           btn->Button_Last_State = BUTTON_CONTINUOS;
    

  301.         } 
    

  302.       #endif
    

  303.       
    

  304.       break;
    

  305.     }
    

  306.     
    

  307.     case BUTTON_DOUBLE :
    

  308.     {
    

  309.       btn->Timer_Count++;     //时间记录 
    

  310.       if(btn->Timer_Count>=BUTTON_DOUBLE_TIME)
    

  311.       {
    

  312.         btn->Button_State = NONE_TRIGGER;
    

  313.         btn->Button_Last_State = NONE_TRIGGER;
    

  314.       }
    

  315.       #if SINGLE_AND_DOUBLE_TRIGGER
    

  316.       
    

  317.         if((btn->Timer_Count>=BUTTON_DOUBLE_TIME)&&(btn->Button_Last_State != BUTTON_DOWM))
    

  318.         {
    

  319.           btn->Timer_Count=0;
    

  320.           TRIGGER_CB(BUTTON_DOWM);    //单击
    

  321.           btn->Button_State = NONE_TRIGGER;
    

  322.           btn->Button_Last_State = BUTTON_DOWM;
    

  323.         }
    

  324.         
    

  325.       #endif
    


  326. 

  327.       break;
    

  328.     }
    


  329. 

  330.     default :
    

  331.       break;
    

  332.   }
    

  333.   
    

  334. }
    


  335. 

  336. /************************************************************
    

  337.   * @brief   遍历的方式扫描按键，不会丢失每个按键
    

  338.         * @param   NULL
    

  339.   * @return  NULL
    

  340.   * @author  jiejie
    

  341.   * @github  https://github.com/jiejieTop
    

  342.   * @date    2018-xx-xx
    

  343.   * @version v1.0
    

  344.   * @note    此函数要周期调用，建议20-50ms调用一次
    

  345.   ***********************************************************/
    

  346. void Button_Process(void)
    

  347. {
    

  348.   struct button* pass_btn;
    

  349.   for(pass_btn = Head_Button; pass_btn != NULL; pass_btn = pass_btn->Next)
    

  350.   {
    

  351.       Button_Cycle_Process(pass_btn);
    

  352.   }
    

  353. }
    


  354. 

  355. /************************************************************
    

  356.   * @brief   遍历按键
    

  357.         * @param   NULL
    

  358.   * @return  NULL
    

  359.   * @author  jiejie
    

  360.   * @github  https://github.com/jiejieTop
    

  361.   * @date    2018-xx-xx
    

  362.   * @version v1.0
    

  363.   * @note    NULL
    

  364.   ***********************************************************/
    

  365. void Search_Button(void)
    

  366. {
    

  367.   struct button* pass_btn;
    

  368.   for(pass_btn = Head_Button; pass_btn != NULL; pass_btn = pass_btn->Next)
    

  369.   {
    

  370.     printf("button node have %s",pass_btn->Name);
    

  371.   }
    

  372. }
    


  373. 

  374. /************************************************************
    

  375.   * @brief   处理所有按键回调函数
    

  376.         * @param   NULL
    

  377.   * @return  NULL
    

  378.   * @author  jiejie
    

  379.   * @github  https://github.com/jiejieTop
    

  380.   * @date    2018-xx-xx
    

  381.   * @version v1.0
    

  382.   * @note    暂不实现
    

  383.   ***********************************************************/
    

  384. void Button_Process_CallBack(void *btn)
    

  385. {
    

  386.   uint8_t btn_event = Get_Button_Event(btn);
    


  387. 

  388.   switch(btn_event)
    

  389.   {
    

  390.     case BUTTON_DOWM:
    

  391.     {
    

  392.       printf("添加你的按下触发的处理逻辑");
    

  393.       break;
    

  394.     }
    

  395.     
    

  396.     case BUTTON_UP:
    

  397.     {
    

  398.       printf("添加你的释放触发的处理逻辑");
    

  399.       break;
    

  400.     }
    

  401.     
    

  402.     case BUTTON_DOUBLE:
    

  403.     {
    

  404.       printf("添加你的双击触发的处理逻辑");
    

  405.       break;
    

  406.     }
    

  407.     
    

  408.     case BUTTON_LONG:
    

  409.     {
    

  410.       printf("添加你的长按触发的处理逻辑");
    

  411.       break;
    

  412.     }
    

  413.     
    

  414.     case BUTTON_LONG_FREE:
    

  415.     {
    

  416.       printf("添加你的长按释放触发的处理逻辑");
    

  417.       break;
    

  418.     }
    

  419.     
    

  420.     case BUTTON_CONTINUOS:
    

  421.     {
    

  422.       printf("添加你的连续触发的处理逻辑");
    

  423.       break;
    

  424.     }
    

  425.     
    

  426.     case BUTTON_CONTINUOS_FREE:
    

  427.     {
    

  428.       printf("添加你的连续触发释放的处理逻辑");
    

  429.       break;
    

  430.     }
    

  431.       
    

  432.   } 
    

  433. }
    


  434. 


  435. 

  436. /**************************** 以下是内部调用函数 ********************/
    


  437. 

  438. /************************************************************
    

  439.   * @brief   拷贝指定长度字符串
    

  440.         * @param   NULL
    

  441.   * @return  NULL
    

  442.   * @author  jiejie
    

  443.   * @github  https://github.com/jiejieTop
    

  444.   * @date    2018-xx-xx
    

  445.   * @version v1.0
    

  446.   * @note    NULL
    

  447.   ***********************************************************/
    

  448. static char *StrnCopy(char *dst, const char *src, uint32_t n)
    

  449. {
    

  450.   if (n != 0)
    

  451.   {
    

  452.     char *d = dst;
    

  453.     const char *s = src;
    

  454.     do
    

  455.     {
    

  456.         if ((*d++ = *s++) == 0)
    

  457.         {
    

  458.             while (--n != 0)
    

  459.                 *d++ = 0;
    

  460.             break;
    

  461.         }
    

  462.     } while (--n != 0);
    

  463.   }
    

  464.   return (dst);
    

  465. }
    


  466. 

  467. /************************************************************
    

  468.   * @brief   打印按键相关信息
    

  469.         * @param   NULL
    

  470.   * @return  NULL
    

  471.   * @author  jiejie
    

  472.   * @github  https://github.com/jiejieTop
    

  473.   * @date    2018-xx-xx
    

  474.   * @version v1.0
    

  475.   * @note    NULL
    

  476.   ***********************************************************/
    

  477. static void Print_Btn_Info(Button_t* btn)
    

  478. {
    

  479.   
    

  480.   printf("button struct information:\n\
    

  481.               btn->Name:%s \n\
    

  482.               btn->Button_State:%d \n\
    

  483.               btn->Button_Trigger_Event:%d \n\
    

  484.               btn->Button_Trigger_Level:%d \n\
    

  485.               btn->Button_Last_Level:%d \n\
    

  486.               ",
    

  487.               btn->Name,
    

  488.               btn->Button_State,
    

  489.               btn->Button_Trigger_Event,
    

  490.               btn->Button_Trigger_Level,
    

  491.               btn->Button_Last_Level);
    

  492.   Search_Button();
    

  493. }
    

  494. /************************************************************
    

  495.   * @brief   使用单链表将按键连接起来
    

  496.         * @param   NULL
    

  497.   * @return  NULL
    

  498.   * @author  jiejie
    

  499.   * @github  https://github.com/jiejieTop
    

  500.   * @date    2018-xx-xx
    

  501.   * @version v1.0
    

  502.   * @note    NULL
    

  503.   ***********************************************************/
    

  504. static void Add_Button(Button_t* btn)
    

  505. {
    

  506.   btn->Next = Head_Button;
    

  507.   Head_Button = btn;
    

  508. }
    


  509. 

  510. /* 获取按键电平 */
    

  511. uint8_t Read_KEY1_Level(void)
    

  512. {
    

  513.         return at32_button_state();
    

  514. }
    


  515. 


  516. 


  517.
button.h完整代码：
复制
  1. #ifndef BUTTON_H
    

  2. #define BUTTON_H
    


  3. 

  4. #include "at32f423_conf.h"
    


  5. 

  6. #define NULL          0
    

  7. #define BTN_NAME_MAX  32     //名字最大为32字节
    


  8. 

  9. /* 按键消抖时间40ms, 建议调用周期为20ms
    

  10.  只有连续检测到40ms状态不变才认为有效，包括弹起和按下两种事件
    

  11. */
    


  12. 

  13. #define CONTINUOS_TRIGGER             0  //是否支持连续触发，连发的话就不要检测单双击与长按了        
    


  14. 

  15. /* 是否支持单击&双击同时存在触发，如果选择开启宏定义的话，单双击都回调，只不过单击会延迟响应，
    

  16.    因为必须判断单击之后是否触发了双击否则，延迟时间是双击间隔时间 BUTTON_DOUBLE_TIME。
    

  17.    而如果不开启这个宏定义，建议工程中只存在单击/双击中的一个，否则，在双击响应的时候会触发一次单击，
    

  18.    因为双击必须是有一次按下并且释放之后才产生的 */
    

  19. #define SINGLE_AND_DOUBLE_TRIGGER     1 
    


  20. 

  21. /* 是否支持长按释放才触发，如果打开这个宏定义，那么长按释放之后才触发单次长按，
    

  22.    否则在长按指定时间就一直触发长按，触发周期由 BUTTON_LONG_CYCLE 决定 */
    

  23. #define LONG_FREE_TRIGGER             0 
    


  24. 

  25. #define BUTTON_DEBOUNCE_TIME           2   //消抖时间      (n-1)*调用周期
    

  26. #define BUTTON_CONTINUOS_CYCLE  1          //连按触发周期时间  (n-1)*调用周期  
    

  27. #define BUTTON_LONG_CYCLE       1          //长按触发周期时间  (n-1)*调用周期 
    

  28. #define BUTTON_DOUBLE_TIME      15         //双击间隔时间  (n-1)*调用周期  建议在200-600ms
    

  29. #define BUTTON_LONG_TIME               50                /* 持续n秒((n-1)*调用周期 ms)，认为长按事件 */
    


  30. 

  31. #define TRIGGER_CB(event)   \
    

  32.         if(btn->CallBack_Function[event]) \
    

  33.           btn->CallBack_Function[event]((Button_t*)btn)
    


  34. 

  35. typedef void (*Button_CallBack)(void*);   /* 按键触发回调函数，需要用户实现 */
    


  36. 


  37. 


  38. 

  39. typedef enum {
    

  40.   BUTTON_DOWM = 0,
    

  41.   BUTTON_UP,
    

  42.   BUTTON_DOUBLE,
    

  43.   BUTTON_LONG,
    

  44.   BUTTON_LONG_FREE,
    

  45.   BUTTON_CONTINUOS,
    

  46.   BUTTON_CONTINUOS_FREE,
    

  47.   BUTTON_ALL_RIGGER,
    

  48.   number_of_event, /* 触发回调的事件 */
    

  49.   NONE_TRIGGER
    

  50. }Button_Event;
    


  51. 

  52. /*
    

  53.         每个按键对应1个全局的结构体变量。
    

  54.         其成员变量是实现滤波和多种按键状态所必须的
    

  55. */
    

  56. typedef struct button
    

  57. {
    

  58.         /* 下面是一个函数指针，指向判断按键手否按下的函数 */
    

  59.         uint8_t (*Read_Button_Level)(void); /* 读取按键电平函数，需要用户实现 */
    

  60.   
    

  61.   char Name[BTN_NAME_MAX];
    

  62.           
    

  63.   uint8_t Button_State              :   4;          /* 按键当前状态（按下还是弹起） */
    

  64.   uint8_t Button_Last_State         :   4;          /* 上一次的按键状态，用于判断双击 */
    

  65.   uint8_t Button_Trigger_Level      :   2;    /* 按键触发电平 */
    

  66.   uint8_t Button_Last_Level         :   2;    /* 按键当前电平 */
    

  67.   
    

  68.   uint8_t Button_Trigger_Event;     /* 按键触发事件，单击，双击，长按等 */
    

  69.   
    

  70.   Button_CallBack CallBack_Function[number_of_event];
    

  71.   
    

  72.         uint8_t Button_Cycle;                   /* 连续按键周期 */
    

  73.   
    

  74.   uint8_t Timer_Count;                        /* 计时 */
    

  75.         uint8_t Debounce_Time;                /* 消抖时间 */
    

  76.   
    

  77.         uint8_t Long_Time;                  /* 按键按下持续时间 */
    

  78.   
    

  79.   struct button *Next;
    

  80.   
    

  81. }Button_t;
    


  82. 


  83. 


  84. 


  85. 

  86. /* 供外部调用的函数声明 */
    


  87. 

  88. void Button_Create(const char *name,
    

  89.                   Button_t *btn, 
    

  90.                   uint8_t(*read_btn_level)(void),
    

  91.                   uint8_t btn_trigger_level);
    

  92.                   
    

  93. void Button_Attach(Button_t *btn,Button_Event btn_event,Button_CallBack btn_callback);   
    

  94.                   
    

  95. void Button_Cycle_Process(Button_t *btn);   
    

  96.                   
    

  97. void Button_Process(void);
    

  98.                   
    

  99. void Button_Delete(Button_t *btn);   
    

  100.   
    

  101. void Search_Button(void);     
    

  102.                   
    

  103. void Get_Button_EventInfo(Button_t *btn);
    

  104. uint8_t Get_Button_Event(Button_t *btn);
    

  105. uint8_t Get_Button_State(Button_t *btn);
    

  106. void Button_Process_CallBack(void *btn);
    

  107. uint8_t Read_KEY1_Level(void);                  
    

  108. #endif
main.c完整代码：
复制
  1. /**
    

  2.   **************************************************************************
    

  3.   * [url=home.php?mod=space&uid=288409]@file[/url]     main.c
    

  4.   * @brief    main program
    

  5.   **************************************************************************
    

  6.   *                       Copyright notice & Disclaimer
    

  7.   *
    

  8.   * The software Board Support Package (BSP) that is made available to
    

  9.   * download from Artery official website is the copyrighted work of Artery.
    

  10.   * Artery authorizes customers to use, copy, and distribute the BSP
    

  11.   * software and its related documentation for the purpose of design and
    

  12.   * development in conjunction with Artery microcontrollers. Use of the
    

  13.   * software is governed by this copyright notice and the following disclaimer.
    

  14.   *
    

  15.   * THIS SOFTWARE IS PROVIDED ON "AS IS" BASIS WITHOUT WARRANTIES,
    

  16.   * GUARANTEES OR REPRESENTATIONS OF ANY KIND. ARTERY EXPRESSLY DISCLAIMS,
    

  17.   * TO THE FULLEST EXTENT PERMITTED BY LAW, ALL EXPRESS, IMPLIED OR
    

  18.   * STATUTORY OR OTHER WARRANTIES, GUARANTEES OR REPRESENTATIONS,
    

  19.   * INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
    

  20.   * FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.
    

  21.   *
    

  22.   **************************************************************************
    

  23.   */
    


  24. 

  25. #include "at32f423_board.h"
    

  26. #include "at32f423_clock.h"
    

  27. #include "button.h"
    


  28. 

  29. /** @addtogroup AT32F423_periph_examples
    

  30.   * @{
    

  31.   */
    


  32. 

  33. /** @addtogroup 423_USART_printf USART_printf
    

  34.   * @{
    

  35.   */
    


  36. 

  37. __IO uint32_t time_cnt = 0;
    

  38. Button_t Button1;
    


  39. 


  40. 

  41. void Btn1_Dowm_CallBack(void *btn)
    

  42. {
    

  43.   printf("Button1 单击!\r\n");
    

  44. }
    


  45. 

  46. void Btn1_Double_CallBack(void *btn)
    

  47. {
    

  48.   printf("Button1 双击!\r\n");
    

  49. }
    


  50. 

  51. void Btn1_Long_CallBack(void *btn)
    

  52. {
    

  53.   printf("Button1 长按!\r\n");
    

  54. }
    

  55. void Btn1_ContinuosFree_CallBack(void *btn)
    

  56. {
    

  57.   printf("Button1 连按释放!\r\n");
    

  58. }
    


  59. 

  60. /**
    

  61.   * @brief  main function.
    

  62.   * @param  none
    

  63.   * @retval none
    

  64.   */
    

  65. int main(void)
    

  66. {
    

  67.   system_clock_config();
    

  68.   at32_board_init();
    

  69.   uart_print_init(115200);
    

  70.          Button_Create("Button1",
    

  71.               &Button1, 
    

  72.               Read_KEY1_Level, 
    

  73.               1);
    

  74.   Button_Attach(&Button1,BUTTON_DOWM,Btn1_Dowm_CallBack);                       //单击
    

  75.   Button_Attach(&Button1,BUTTON_DOUBLE,Btn1_Double_CallBack);                   //双击  
    

  76.   Button_Attach(&Button1,BUTTON_LONG,Btn1_Long_CallBack);                       //长按BUTTON_LONG_FREE,
    

  77.         Button_Attach(&Button1,BUTTON_LONG_FREE,Btn1_ContinuosFree_CallBack); 
    

  78.   /* output a message on hyperterminal using printf function */
    

  79.   printf("usart printf example: retarget the c library printf function to the usart\r\n");
    

  80.         Get_Button_Event(&Button1);
    

  81.   while(1)
    

  82.   {
    

  83.                 Button_Process();     //需要周期调用按键处理函数
    

  84. //    printf("usart printf counter: %u\r\n",time_cnt++);
    

  85. //    delay_sec(1);
    

  86.                 delay_ms(20);
    

  87.   }
    

  88. }
    


  89. 

  90. /**
    

  91.   * @}
    

  92.   */
    


  93. 

  94. /**
    

  95.   * @}
    

  96.   */

【试用心得】
1、此次是我第一次使用按键的驱动代码，实现了很多单按键的功能，这在我们以后面的编程工作中会有很大的帮助。
2、能够顺利的移植，也得益于雅特力的官方示例给了开发板的常规驱动，比如Uart\printf重定向、按键驱动、LED灯驱动都写好了，我们只要调用board.c中的就可以了。
3、在github上有很多优秀的开源软件，能向大佬们学习，也是提高自身技术水平的重要方式之一，这里要感觉这些无私奉献的大佬。

回复 赏

举报

相关帖子
184592967 发表于 2023-10-25 15:32 | 显示全部楼层
谢谢分享，搞来试试
回复 赏

举报

Aeddg 发表于 2023-10-25 16:32 | 显示全部楼层
谢谢分享！
回复 赏

举报

 楼主| lulugl 发表于 2023-10-25 18:23 | 显示全部楼层
184592967 发表于 2023-10-25 15:32
谢谢分享，搞来试试

挺好用的一个开源库，你值得拥有！
回复 赏

举报

trucyw 发表于 2023-10-26 08:23 | 显示全部楼层
谢谢分享，搞来试试
回复 赏

举报

jobszheng 发表于 2023-10-26 09:26 | 显示全部楼层
这个按键代码优秀在哪里了啊？
回复 赏

举报

 楼主| lulugl 发表于 2023-10-26 10:40 | 显示全部楼层
jobszheng 发表于 2023-10-26 09:26
这个按键代码优秀在哪里了啊？

不只是我说他优秀，其他的人也认为他优秀，而且这个驱动，移植方便，只要实现一下IO的驱动，电平状态的获取后就可以实现单击、双击、连击等等的。这样的不优秀，还有什么可以说他优秀？
回复 赏

举报

ssy123321 发表于 2024-12-13 17:42 | 显示全部楼层
mark
回复 赏

举报

呐咯密密 发表于 2024-12-13 20:06 | 显示全部楼层
这些开源的按键驱动真的好用
回复 赏

举报

返回列表 发新帖
高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 注册

本版积分规则

lulugl Image

180

主题

830

帖子

12

粉丝
快速回复 在线客服 返回列表 返回顶部
lulugl Image

180

主题

830

帖子

12

粉丝
快速回复 在线客服 返回列表 返回顶部