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

相关文章

Nginx 配置跨域的实现及常见问题解决

《Nginx配置跨域的实现及常见问题解决》本文主要介绍了Nginx配置跨域的实现及常见问题解决,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来... 目录1. 跨域1.1 同源策略1.2 跨域资源共享(CORS)2. Nginx 配置跨域的场景2.1

Python中提取文件名扩展名的多种方法实现

《Python中提取文件名扩展名的多种方法实现》在Python编程中,经常会遇到需要从文件名中提取扩展名的场景,Python提供了多种方法来实现这一功能,不同方法适用于不同的场景和需求,包括os.pa... 目录技术背景实现步骤方法一:使用os.path.splitext方法二:使用pathlib模块方法三

CSS实现元素撑满剩余空间的五种方法

《CSS实现元素撑满剩余空间的五种方法》在日常开发中,我们经常需要让某个元素占据容器的剩余空间,本文将介绍5种不同的方法来实现这个需求,并分析各种方法的优缺点,感兴趣的朋友一起看看吧... css实现元素撑满剩余空间的5种方法 在日常开发中,我们经常需要让某个元素占据容器的剩余空间。这是一个常见的布局需求

HTML5 getUserMedia API网页录音实现指南示例小结

《HTML5getUserMediaAPI网页录音实现指南示例小结》本教程将指导你如何利用这一API,结合WebAudioAPI,实现网页录音功能,从获取音频流到处理和保存录音,整个过程将逐步... 目录1. html5 getUserMedia API简介1.1 API概念与历史1.2 功能与优势1.3

Java实现删除文件中的指定内容

《Java实现删除文件中的指定内容》在日常开发中,经常需要对文本文件进行批量处理,其中,删除文件中指定内容是最常见的需求之一,下面我们就来看看如何使用java实现删除文件中的指定内容吧... 目录1. 项目背景详细介绍2. 项目需求详细介绍2.1 功能需求2.2 非功能需求3. 相关技术详细介绍3.1 Ja

使用Python和OpenCV库实现实时颜色识别系统

《使用Python和OpenCV库实现实时颜色识别系统》:本文主要介绍使用Python和OpenCV库实现的实时颜色识别系统,这个系统能够通过摄像头捕捉视频流,并在视频中指定区域内识别主要颜色(红... 目录一、引言二、系统概述三、代码解析1. 导入库2. 颜色识别函数3. 主程序循环四、HSV色彩空间详解

PostgreSQL中MVCC 机制的实现

《PostgreSQL中MVCC机制的实现》本文主要介绍了PostgreSQL中MVCC机制的实现,通过多版本数据存储、快照隔离和事务ID管理实现高并发读写,具有一定的参考价值,感兴趣的可以了解一下... 目录一 MVCC 基本原理python1.1 MVCC 核心概念1.2 与传统锁机制对比二 Postg

SpringBoot整合Flowable实现工作流的详细流程

《SpringBoot整合Flowable实现工作流的详细流程》Flowable是一个使用Java编写的轻量级业务流程引擎,Flowable流程引擎可用于部署BPMN2.0流程定义,创建这些流程定义的... 目录1、流程引擎介绍2、创建项目3、画流程图4、开发接口4.1 Java 类梳理4.2 查看流程图4

C++中零拷贝的多种实现方式

《C++中零拷贝的多种实现方式》本文主要介绍了C++中零拷贝的实现示例,旨在在减少数据在内存中的不必要复制,从而提高程序性能、降低内存使用并减少CPU消耗,零拷贝技术通过多种方式实现,下面就来了解一下... 目录一、C++中零拷贝技术的核心概念二、std::string_view 简介三、std::stri

C++高效内存池实现减少动态分配开销的解决方案

《C++高效内存池实现减少动态分配开销的解决方案》C++动态内存分配存在系统调用开销、碎片化和锁竞争等性能问题,内存池通过预分配、分块管理和缓存复用解决这些问题,下面就来了解一下... 目录一、C++内存分配的性能挑战二、内存池技术的核心原理三、主流内存池实现:TCMalloc与Jemalloc1. TCM