本文主要是介绍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_PUSH
和BUTTON_CB_RELEASE
在长按的时候也会被触发。
不过乐鑫这个模块并未实现双击或者多击。
但是有一个红旭的教程实现了长按+短按+单击+多击的参考代码。大家也可以参考一下。
这篇关于ESP32的长按、短按、双击、多击 按键检测实现的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!