ESP32的长按、短按、双击、多击 按键检测实现

2024-04-18 08:58

本文主要是介绍ESP32的长按、短按、双击、多击 按键检测实现,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

乐鑫官方有个仓库叫做esp-iot-solution,里面有很多常用外设的驱动和物联网场景的实现代码。其中就有一个button模块来实现按键的长按、短按检测(双击多击实现请看文末):
espressif/esp-iot-solution › components › general › button › button。
README翻译如下:

  • 本模块封装了一个按键对象
  • 一个按键设备定义如下:
    • GPIO 端口号
    • 信号有效电平
    • 触发模式:触发模式决定了是否调用连续触发
    • 多少秒后开始进行进行连续触发
  • 一个按键设备提供如下回调:
    • 一个按下事件回调
    • 一个释放事件回调
    • 一个短时触摸事件回调
    • 一个连续触发事件回调
    • 多个长按事件回调

所有事件可以设置不同的去抖时长。
当任意一个长按回调触发时,短时触摸事件不会被触发。
本模块基于idf的GPIO控制和freeRTOS的软件定时器实现。

  • 按键设备使用方法 :

    • 通过 iot_button_create() 创建按键对象
    • 然后为按键对象设置回调
    • 调用iot_button_delete 释放对象内存
  • Todo:

    • 增加硬件定时器模式(有时候软件定时器有些限制)

NOTE:

所有事件回调基于freeRTOS的软件定时器API实现,因此必须遵循如下规则:
由于按键回调在定时器服务任务中执行,因此不应进行任何阻塞操作。例如,按键回调中不可以调用vTaskDelay(),vTaskDelayUntil() ,以及访问队列或信号量时指定非零阻塞时间。

另外:
可以对如下宏进行重定义来调整定时器服务的栈深度/队列长度/任务优先级。

#define configUSE_TIMERS //enable soft-timer
#define configTIMER_TASK_PRIORITY // priority of the timers service task
#define configQueue_LENGTH // length of timer command queue
#define configTIMER_TASK_STACK_DEPTH // stack depth of the soft-timer

在模块的test子文件夹下面有参考例程。
如下代码进行了一些简化:

// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
#define BUTTON_IO_NUM  16
#define BUTTON_ACTIVE_LEVEL   0
#include "stdio.h"
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "freertos/queue.h"
#include "freertos/timers.h"#include "iot_button.h"
#include "esp_system.h"
#include "esp_log.h"static const char* TAG_BTN = "BTN_TEST";void button_tap_cb(void* arg)
{char* pstr = (char*) arg;ESP_EARLY_LOGI(TAG_BTN, "tap cb (%s), heap: %d\n", pstr, esp_get_free_heap_size());
}void button_press_serial_cb(void* arg)
{ESP_EARLY_LOGI(TAG_BTN, "serial push, heap: %d\n", esp_get_free_heap_size());
}void button_press_5s_cb(void* arg)
{ESP_EARLY_LOGI(TAG_BTN, "press 5s, heap: %d\n", esp_get_free_heap_size());
}void button_test()
{printf("before btn init, heap: %d\n", esp_get_free_heap_size());button_handle_t btn_handle = iot_button_create(BUTTON_IO_NUM, BUTTON_ACTIVE_LEVEL);// iot_button_set_evt_cb(btn_handle, BUTTON_CB_PUSH, button_tap_cb, "PUSH");// iot_button_set_evt_cb(btn_handle, BUTTON_CB_RELEASE, button_tap_cb, "RELEASE");iot_button_set_evt_cb(btn_handle, BUTTON_CB_TAP, button_tap_cb, "TAP");iot_button_set_serial_cb(btn_handle, 1, 1000/portTICK_RATE_MS, button_press_serial_cb, "SERIAL");iot_button_add_custom_cb(btn_handle, 5, button_press_5s_cb, NULL);printf("after btn init, heap: %d\n", esp_get_free_heap_size());}void app_main()
{button_test();
}

LOG如下:

before btn init, heap: 298560
use esp timer !!!
I (250) gpio: GPIO[16]| InputEn: 1| OutputEn: 0| OpenDrain: 0| Pullup: 1| Pulldown: 0| Intr:3 
after btn init, heap: 297752
#单次按键
I (3190) BTN_TEST: tap cb (TAP), heap: 303336
#按住不放
I (5920) BTN_TEST: serial push, heap: 303336I (6920) BTN_TEST: serial push, heap: 303336I (7920) BTN_TEST: serial push, heap: 303336I (8920) BTN_TEST: serial push, heap: 303336
#到达5s时打印如下两行内容:
I (9870) BTN_TEST: press 5s, heap: 303336I (9920) BTN_TEST: serial push, heap: 303336

Note:

单击+长按使用iot_button_set_evt_cb()设置BUTTON_CB_TAP事件+iot_button_add_custom_cb()设置长按事件实现。BUTTON_CB_PUSHBUTTON_CB_RELEASE在长按的时候也会被触发。

不过乐鑫这个模块并未实现双击或者多击。

但是有一个红旭的教程实现了长按+短按+单击+多击的参考代码。大家也可以参考一下。

这篇关于ESP32的长按、短按、双击、多击 按键检测实现的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/914329

相关文章

SpringBoot集成redisson实现延时队列教程

《SpringBoot集成redisson实现延时队列教程》文章介绍了使用Redisson实现延迟队列的完整步骤,包括依赖导入、Redis配置、工具类封装、业务枚举定义、执行器实现、Bean创建、消费... 目录1、先给项目导入Redisson依赖2、配置redis3、创建 RedissonConfig 配

Python的Darts库实现时间序列预测

《Python的Darts库实现时间序列预测》Darts一个集统计、机器学习与深度学习模型于一体的Python时间序列预测库,本文主要介绍了Python的Darts库实现时间序列预测,感兴趣的可以了解... 目录目录一、什么是 Darts?二、安装与基本配置安装 Darts导入基础模块三、时间序列数据结构与

Python使用FastAPI实现大文件分片上传与断点续传功能

《Python使用FastAPI实现大文件分片上传与断点续传功能》大文件直传常遇到超时、网络抖动失败、失败后只能重传的问题,分片上传+断点续传可以把大文件拆成若干小块逐个上传,并在中断后从已完成分片继... 目录一、接口设计二、服务端实现(FastAPI)2.1 运行环境2.2 目录结构建议2.3 serv

C#实现千万数据秒级导入的代码

《C#实现千万数据秒级导入的代码》在实际开发中excel导入很常见,现代社会中很容易遇到大数据处理业务,所以本文我就给大家分享一下千万数据秒级导入怎么实现,文中有详细的代码示例供大家参考,需要的朋友可... 目录前言一、数据存储二、处理逻辑优化前代码处理逻辑优化后的代码总结前言在实际开发中excel导入很

SpringBoot+RustFS 实现文件切片极速上传的实例代码

《SpringBoot+RustFS实现文件切片极速上传的实例代码》本文介绍利用SpringBoot和RustFS构建高性能文件切片上传系统,实现大文件秒传、断点续传和分片上传等功能,具有一定的参考... 目录一、为什么选择 RustFS + SpringBoot?二、环境准备与部署2.1 安装 RustF

Nginx部署HTTP/3的实现步骤

《Nginx部署HTTP/3的实现步骤》本文介绍了在Nginx中部署HTTP/3的详细步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学... 目录前提条件第一步:安装必要的依赖库第二步:获取并构建 BoringSSL第三步:获取 Nginx

MyBatis Plus实现时间字段自动填充的完整方案

《MyBatisPlus实现时间字段自动填充的完整方案》在日常开发中,我们经常需要记录数据的创建时间和更新时间,传统的做法是在每次插入或更新操作时手动设置这些时间字段,这种方式不仅繁琐,还容易遗漏,... 目录前言解决目标技术栈实现步骤1. 实体类注解配置2. 创建元数据处理器3. 服务层代码优化填充机制详

Python实现Excel批量样式修改器(附完整代码)

《Python实现Excel批量样式修改器(附完整代码)》这篇文章主要为大家详细介绍了如何使用Python实现一个Excel批量样式修改器,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一... 目录前言功能特性核心功能界面特性系统要求安装说明使用指南基本操作流程高级功能技术实现核心技术栈关键函

Java实现字节字符转bcd编码

《Java实现字节字符转bcd编码》BCD是一种将十进制数字编码为二进制的表示方式,常用于数字显示和存储,本文将介绍如何在Java中实现字节字符转BCD码的过程,需要的小伙伴可以了解下... 目录前言BCD码是什么Java实现字节转bcd编码方法补充总结前言BCD码(Binary-Coded Decima

SpringBoot全局域名替换的实现

《SpringBoot全局域名替换的实现》本文主要介绍了SpringBoot全局域名替换的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一... 目录 项目结构⚙️ 配置文件application.yml️ 配置类AppProperties.Ja