MultiButton

MultiButton

  • MultiButton
    • 简介
    • 使用方法
    • 特性
    • 按键事件
    • Examples
  • 具体实现代码
    • multi_button.c
    • multi_button.h

MultiButton

简介

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

使用方法

1.先申请一个按键结构

struct Button button1;

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

button_init(&button1, read_button_pin, 0, 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 使用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  button_id;uint8_t  (*hal_button_Level)(uint8_t  button_id_);BtnCallback  cb[number_of_event];struct Button* next;
};

这样每个按键使用单向链表相连，依次进入 button_handler(struct Button* handle) 状态机处理，所以每个按键的状态彼此独立。

按键事件

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

Examples

#include "button.h"unit8_t btn1_id = 0;struct Button btn1;uint8_t read_button_GPIO(uint8_t button_id)
{// you can share the GPIO read function with multiple Buttonsswitch(button_id){case btn1_id:return HAL_GPIO_ReadPin(B1_GPIO_Port, B1_Pin);break;default:return 0;break;}
}
void BTN1_PRESS_DOWN_Handler(void* btn)
{//do something...
}void BTN1_PRESS_UP_Handler(void* btn)
{//do something...
}...int main()
{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_attach(&btn1, PRESS_REPEAT,     BTN1_PRESS_REPEAT_Handler);button_attach(&btn1, SINGLE_CLICK,     BTN1_SINGLE_Click_Handler);button_attach(&btn1, DOUBLE_CLICK,     BTN1_DOUBLE_Click_Handler);button_attach(&btn1, LONG_PRESS_START, BTN1_LONG_PRESS_START_Handler);button_attach(&btn1, LONG_PRESS_HOLD,  BTN1_LONG_PRESS_HOLD_Handler);button_start(&btn1);//make the timer invoking the button_ticks() interval 5ms.//This function is implemented by yourself.__timer_start(button_ticks, 0, 5);while(1){}
}

具体实现代码

multi_button.c

/** Copyright (c) 2016 Zibin Zheng <znbin@qq.com>* All rights reserved*/#include "multi_button.h"#define EVENT_CB(ev)   if(handle->cb[ev])handle->cb[ev]((void*)handle)
#define PRESS_REPEAT_MAX_NUM  15 /*!< The maximum value of the repeat counter *///button handle list head.
static struct Button* head_handle = NULL;static void button_handler(struct Button* handle);/*** @brief  Initializes the button struct handle.* @param  handle: the button handle struct.* @param  pin_level: read the HAL GPIO of the connected button level.* @param  active_level: pressed GPIO level.* @param  button_id: the button id.* @retval None*/
void button_init(struct Button* handle, uint8_t(*pin_level)(uint8_t), uint8_t active_level, uint8_t button_id)
{memset(handle, 0, sizeof(struct Button));handle->event = (uint8_t)NONE_PRESS;handle->hal_button_Level = pin_level;handle->button_level = handle->hal_button_Level(button_id);handle->active_level = active_level;handle->button_id = button_id;
}/*** @brief  Attach the button event callback function.* @param  handle: the button handle struct.* @param  event: trigger event type.* @param  cb: callback function.* @retval None*/
void button_attach(struct Button* handle, PressEvent event, BtnCallback cb)
{handle->cb[event] = cb;
}/*** @brief  Inquire the button event happen.* @param  handle: the button handle struct.* @retval button event.*/
PressEvent get_button_event(struct Button* handle)
{return (PressEvent)(handle->event);
}/*** @brief  Button driver core function, driver state machine.* @param  handle: the button handle struct.* @retval None*/
static void button_handler(struct Button* handle)
{uint8_t read_gpio_level = handle->hal_button_Level(handle->button_id);//ticks counter working..if((handle->state) > 0) handle->ticks++;/*------------button debounce handle---------------*/if(read_gpio_level != handle->button_level) { //not equal to prev one//continue read 3 times same new level changeif(++(handle->debounce_cnt) >= DEBOUNCE_TICKS) {handle->button_level = read_gpio_level;handle->debounce_cnt = 0;}} else { //level not change ,counter reset.handle->debounce_cnt = 0;}/*-----------------State machine-------------------*/switch (handle->state) {case 0:if(handle->button_level == handle->active_level) {	//start press downhandle->event = (uint8_t)PRESS_DOWN;EVENT_CB(PRESS_DOWN);handle->ticks = 0;handle->repeat = 1;handle->state = 1;} else {handle->event = (uint8_t)NONE_PRESS;}break;case 1:if(handle->button_level != handle->active_level) { //released press uphandle->event = (uint8_t)PRESS_UP;EVENT_CB(PRESS_UP);handle->ticks = 0;handle->state = 2;} else if(handle->ticks > LONG_TICKS) {handle->event = (uint8_t)LONG_PRESS_START;EVENT_CB(LONG_PRESS_START);handle->state = 5;}break;case 2:if(handle->button_level == handle->active_level) { //press down againhandle->event = (uint8_t)PRESS_DOWN;EVENT_CB(PRESS_DOWN);if(handle->repeat != PRESS_REPEAT_MAX_NUM) {handle->repeat++;}EVENT_CB(PRESS_REPEAT); // repeat hithandle->ticks = 0;handle->state = 3;} else if(handle->ticks > SHORT_TICKS) { //released timeoutif(handle->repeat == 1) {handle->event = (uint8_t)SINGLE_CLICK;EVENT_CB(SINGLE_CLICK);} else if(handle->repeat == 2) {handle->event = (uint8_t)DOUBLE_CLICK;EVENT_CB(DOUBLE_CLICK); // repeat hit}handle->state = 0;}break;case 3:if(handle->button_level != handle->active_level) { //released press uphandle->event = (uint8_t)PRESS_UP;EVENT_CB(PRESS_UP);if(handle->ticks < SHORT_TICKS) {handle->ticks = 0;handle->state = 2; //repeat press} else {handle->state = 0;}} else if(handle->ticks > SHORT_TICKS) { // SHORT_TICKS < press down hold time < LONG_TICKShandle->state = 1;}break;case 5:if(handle->button_level == handle->active_level) {//continue hold triggerhandle->event = (uint8_t)LONG_PRESS_HOLD;EVENT_CB(LONG_PRESS_HOLD);} else { //releasedhandle->event = (uint8_t)PRESS_UP;EVENT_CB(PRESS_UP);handle->state = 0; //reset}break;default:handle->state = 0; //resetbreak;}
}/*** @brief  Start the button work, add the handle into work list.* @param  handle: target handle struct.* @retval 0: succeed. -1: already exist.*/
int button_start(struct Button* handle)
{struct Button* target = head_handle;while(target) {if(target == handle) return -1;	//already exist.target = target->next;}handle->next = head_handle;head_handle = handle;return 0;
}/*** @brief  Stop the button work, remove the handle off work list.* @param  handle: target handle struct.* @retval None*/
void button_stop(struct Button* handle)
{struct Button** curr;for(curr = &head_handle; *curr; ) {struct Button* entry = *curr;if(entry == handle) {*curr = entry->next;
//			free(entry);return;//glacier add 2021-8-18} else {curr = &entry->next;}}
}/*** @brief  background ticks, timer repeat invoking interval 5ms.* @param  None.* @retval None*/
void button_ticks(void)
{struct Button* target;for(target=head_handle; target; target=target->next) {button_handler(target);}
}

multi_button.h

/** Copyright (c) 2016 Zibin Zheng <znbin@qq.com>* All rights reserved*/#ifndef _MULTI_BUTTON_H_
#define _MULTI_BUTTON_H_#include <stdint.h>
#include <string.h>//According to your need to modify the constants.
#define TICKS_INTERVAL    5	//ms
#define DEBOUNCE_TICKS    3	//MAX 7 (0 ~ 7)
#define SHORT_TICKS       (300 /TICKS_INTERVAL)
#define LONG_TICKS        (1000 /TICKS_INTERVAL)typedef void (*BtnCallback)(void*);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;typedef 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  button_id;uint8_t  (*hal_button_Level)(uint8_t button_id_);BtnCallback  cb[number_of_event];struct Button* next;
}Button;#ifdef __cplusplus
extern "C" {
#endifvoid button_init(struct Button* handle, uint8_t(*pin_level)(uint8_t), uint8_t active_level, uint8_t button_id);
void button_attach(struct Button* handle, PressEvent event, BtnCallback cb);
PressEvent get_button_event(struct Button* handle);
int  button_start(struct Button* handle);
void button_stop(struct Button* handle);
void button_ticks(void);#ifdef __cplusplus
}
#endif#endif

这段代码实现了一个多按钮驱动库，用于处理单片机中多个按钮的按键事件。下面是对代码的详细解释：

  1. 数据结构定义：

    • Button 结构体定义了一个按钮的属性，包括按下时间、重复次数、当前事件、当前状态等信息。
    • PressEvent 枚举定义了按钮可能触发的事件类型，包括按下、释放、重复按下、单击、双击、长按开始和长按持续等事件。

  2. 函数说明：

    • button_init：初始化按钮结构体，设置按钮的GPIO读取函数、活动电平、按钮ID等参数。
    • button_attach：绑定按钮的事件回调函数，用于处理不同事件时的操作。
    • get_button_event：获取按钮当前的事件类型。
    • button_start：开始监听按钮事件，将按钮添加到事件处理列表中。
    • button_stop：停止监听按钮事件，将按钮从事件处理列表中移除。
    • button_ticks：定时器中断处理函数，用于处理按钮的状态机逻辑。

  3. 按钮状态机：

    • 按钮状态机包括了按下、释放、重复按下、单击、双击和长按等状态。
    • 每次定时器中断会调用 button_handler 函数处理按钮的状态转换和事件触发。

  4. 事件处理：

    • 当按钮按下时，触发 PRESS_DOWN 事件，当按钮释放时触发 PRESS_UP 事件。
    • 当按钮按下时间超过一定时间时，触发 LONG_PRESS_START 事件，持续按下时触发 LONG_PRESS_HOLD 事件。
    • 当按钮连续按下时，触发 SINGLE_CLICK 或 DOUBLE_CLICK 事件。

  5. 其他说明：

    • 定义了一些常量用于设置按钮的时间阈值和抖动时间。
    • 使用了链表结构管理多个按钮，可以方便地添加、删除和遍历按钮列表。

这段代码实现了一个简单但功能强大的多按钮驱动库，可以方便地集成到单片机的项目中，实现按钮事件的处理和响应。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/753506.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

深入理解数据结构森林

深入理解数据结构森林

文章目录 一、森林是什么二、森林的应用范围三、森林结构的MQL语言实现 一、森林是什么 数据结构中的"森林"是指多个树的集合。在树的概念中&#xff0c;每个节点可以有多个子节点&#xff0c;而在森林中&#xff0c;每个树都是独立的&#xff0c;没有共享的节点。换…
阅读更多...
如何在没有向量数据库的情况下使用知识图谱实现RAG

如何在没有向量数据库的情况下使用知识图谱实现RAG

引言 传统上&#xff0c;为大型语言模型&#xff08;LLMs&#xff09;提供长期记忆通常涉及到使用检索增强生成&#xff08;RAG&#xff09;解决方案&#xff0c;其中向量数据库作为长期记忆的存储机制。然而&#xff0c;我们是否能在没有向量数据库的情况下达到相同效果呢&am…
阅读更多...
Vue3中Pinia状态管理库学习笔记

Vue3中Pinia状态管理库学习笔记

pinia的基本使用 <template><div><h2>Home View</h2> <h2>count:{{ counterStore.count }}</h2><h2>count:{{ count }}</h2><button click"increment">count1</button></div> </template>…
阅读更多...
P1041 [NOIP2003 提高组] 传染病控制

P1041 [NOIP2003 提高组] 传染病控制

题目描述 研究表明&#xff0c;这种传染病的传播具有两种很特殊的性质&#xff1b; 第一是它的传播途径是树型的&#xff0c;一个人 X 只可能被某个特定的人 Y 感染&#xff0c;只要 Y 不得病&#xff0c;或者是 XY 之间的传播途径被切断&#xff0c;则 X 就不会得病。 第二…
阅读更多...
2024年56套包含java，ssm，springboot的平台设计与实现项目系统开发资源（可运行源代码+设计文档）分享【万字长文收藏耐心看】

2024年56套包含java，ssm，springboot的平台设计与实现项目系统开发资源（可运行源代码+设计文档）分享【万字长文收藏耐心看】

序号项目名称项目链接1某品零食交易平台设计与实现|基于springboot MysqlJava的某品交易平台设计与实现(源码数据库文档PPT)https://xiaoxiao.blog.csdn.net/article/details/136463403?spm1001.2014.3001.55022毕业生信息招聘平台|基于springboot MysqlJava的毕业生信息招聘平…
阅读更多...
LLM 面试知识点——模型基础知识

LLM 面试知识点——模型基础知识

1、主流架构 目前LLM（Large Language Model）主流结构包括三种范式，分别为Encoder-Decoder、Causal Decoder、Prefix Decode。对应的网络整体结构和Attention掩码如下图。 、 各自特点、优缺点如下： 1）Encoder-Decoder 结构特点：输入双向注意力，输出单向注意力。 代表…
阅读更多...
Tomcat：Session ID保持会话

Tomcat：Session ID保持会话

目录 前言 ​一、部署环境 二、部署nginx反向代理服务器 三、部署tomcat服务器1 四、部署tomcat服务器2 五、客户端测试&#xff08;Session ID不断变动&#xff09; 六、配置Session ID会话保持 七、客户端测试&#xff08;Session ID保持&#xff09; 前言 此次实验…
阅读更多...
nginx location块配置

nginx location块配置

nginx可以通过配置文件中的location指令来定义不同的请求匹配规则和处理逻辑&#xff0c;也就是描述不同请求资源在服务器的位置或者配置代理转发路径。 location块通常在server块中&#xff0c;一个server块可以包含多个location块。 server {location {}location {} }语法规…
阅读更多...
客户端渲染与服务端渲染（1）

客户端渲染与服务端渲染（1）

客户端渲染即普通的 React 项目渲染方式。 客户端渲染流程&#xff1a; 浏览器发送请求 服务器返回 HTML 浏览器发送 bundle.js 请求 服务器返回 bundle.js 浏览器执行 bundle.js 中的 React 代码 CSR 带来的问题&#xff1a; 首屏加载时间过长 SEO 不友好 因为时间在往返的几…
阅读更多...
python内置函数 M

python内置函数 M

python内置函数 M Python 解释器内置了很多函数和类型&#xff0c;任何时候都能使用。 M 名称描述map返回一个迭代器&#xff0c;其中包含函数应用于每个元素的结果。max返回给定可迭代对象&#xff08;如列表、元组、字符串等&#xff09;中的最大元素。memoryview返回由给…
阅读更多...
C语言自定义库

C语言自定义库

编写 xx.c 和xx.h文件\将源代码编译为目标文件 gcc -c add.c sub.c 执行完毕后会生产add.o和sub.o文件静态库创建使用ar命令&#xff1b; ar -r libmymath.a add.o sub.o将库和main.c文件一起编译 gcc -o main main.c -lmymath -L./ 注意 上述书写格式不要错乱 -L 是指定文件路…
阅读更多...
鸿蒙-项目创建及了解

鸿蒙-项目创建及了解

目录 项目创建 1.App普通项目创建 2.元服务创建 项目结构 .hvigor .idea AppScope entry EntryAbility.ts pages resources module.json5 ohosTest hvigorfile.ts build-profile.json5 oh_modules build-profile.json5 hvigorfile.ts 项目运行 项目创建 F…
阅读更多...
uniapp的描述的展开与收缩，超过三行有省略号才显示

uniapp的描述的展开与收缩，超过三行有省略号才显示

html代码&#xff1a; <view class"desc_box"><view id"desc" class"desc" :class"open ? open : three">{{ data.desc }}</view><view class"expand theme-color" click"unfold" v-if&qu…
阅读更多...
单模场哈密顿量推导

单模场哈密顿量推导

满足麦克斯韦方程和边界条件的单模场又下式&#xff08;1&#xff09;&#xff0c;&#xff08;2&#xff09;给出 --------&#xff08;1&#xff09; ---------&#xff08;2&#xff09; , 单模场的经典场能或者哈密顿量又下式给出&#xff1a; &#xff08;3&#xff09…
阅读更多...
JUC并发编程（四）

JUC并发编程（四）

1、同步模式保护性暂停 用一个线程等待另一个线程的执行结果 有一个结果需要从一个线程传递到另一个线程&#xff0c;让他们关联同一个中间类。如果有结果不断从一个线程到另一个线程那么可以使用消息队列&#xff08;见生产者/消费者&#xff09;。JDK 中&#xff0c;join 的…
阅读更多...
WebAssembly探索篇（三）emcc和cmake编译opencv案例

WebAssembly探索篇（三）emcc和cmake编译opencv案例

文章目录 开发环境安装opencv环境 实践出真知完整项目效果图 踩坑fatal error: opencv2/opencv.hpp file not found增加软链ln&#xff08;无效&#xff09;改用自行安装opencv&#xff0c;再显示指定lib路径 emcc命令行运行方式 最近因为项目原因&#xff0c;研究了一下WebAss…
阅读更多...
Anaconda概述

Anaconda概述

Anaconda是一个开源的Python发行版本&#xff0c;它整合了Python解释器、Conda包和环境管理器以及众多预装的科学计算库和工具包。这使得用户能够方便地使用和管理多个Python版本&#xff0c;并在不同的环境中调用不同的数据包。 Conda是Anaconda中的一个关键组件&#xff0c;…
阅读更多...
C语言例：表达式 45-35+1^2 的值

C语言例：表达式 45-35+1^2 的值

代码如下&#xff1a; #include<stdio.h> int main(void) {int a;a 4&5-3&&51^2;printf("4&5-3&&51^2 %d\n",a);return 0; } 结果如下&#xff1a;
阅读更多...
maven一点通

maven一点通

1.maven简介 Maven是一个基于Java的工程构建工具&#xff0c;用于管理和构建项目的依赖关系。它提供了一种标准的项目结构和一组约定&#xff0c;使得项目的开发、构建、部署和文档化更加容易和可靠。 Maven的主要功能包括&#xff1a; 依赖管理&#xff1a;Maven可以自动下载…
阅读更多...
课设系统篇

课设系统篇

《古代六扇门人员管理系统》 数据库 sixdoor 编码 utf8mb4 视图 查询官员等级 存储过程 CREATE DEFINERrootlocalhost PROCEDURE levelname(IN g_name VARCHAR(20)) BEGINSELECT name,level FROM servingofficials INNER JOIN jobtitle onservingofficials.role jobtitl…
阅读更多...
最新文章

Copyright @ 2022~2023