ESP-IDF使用Button组件实现按键检测的功能

2024-05-24 12:12
文章标签 实现 使用 组件 功能 检测 按键 idf button esp

本文主要是介绍ESP-IDF使用Button组件实现按键检测的功能，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

ESP32使用Button组件实现按键检测的功能

    • ESP-IDF 组件管理
    • LED 组件简介
    • 测试button组件
    • 写在最后

ESP-IDF 组件管理

IDF 组件管理器工具用于下载 ESP-IDF CMake 项目的依赖项，该下载在 CMake 运行期间自动完成。IDF 组件管理器可以从自动从组件注册表 或 Git 仓库获取组件，具体的使用和介绍，请查看官方文档，需要注意的是 ESP-IDF 管理器是 IDF4.4 以后引入的特性，使用IDF框架时，建议尽量使用最新的 release 版本 IDF 构建自己的项目。

要获取组件列表，请参阅 https://components.espressif.com/

LED 组件简介

  1. 我们从 ESP-IDF 组件管理器网页搜索我们需要的组件【button】,然后 点开 espressif/button 组件
    在这里插入图片描述
    在这里插入图片描述

  2. button 组件简介

Button按键组件实现了 GPIO 和 ADC 两种按键，并允许同时创建两种不同的按键。下图显示了两种按键的硬件设计：
在这里插入图片描述

  • GPIO 按键优点有：每一个按键占用独立的 IO，之间互不影响，稳定性高；缺点有：按键数量多时占用太多 IO 资源。

  • ADC 按键优点有：可多个按键共用一个 ADC 通道，占用 IO 资源少；缺点有：不能同时按下多按键，当按键因氧化等因素导致闭合电阻增大时，容易误触，稳定性不高。
    每个按键拥有下表的 8 个事件：
    在这里插入图片描述
    每个按键可以有 回调 和 轮询 两种使用方式：

  • 回调：一个按键的每个事件都可以为其注册一个回调函数，产生事件时回调函数将会被调用。这种方式的效率和实时性高，不会丢失事件。

  • 轮询：在程序中周期性调用 :ciot_button_get_event 查询按键当前的事件。
    这种方式使用简单，适合任务简单的场合，当然你也可以将以上两种方式组合使用。

注意：回调函数中不能有 TaskDelay 等阻塞的操作

具体功能和使用方法，请查看官方文档

测试button组件

  1. 使用 VSCODE 的 ESP-IDF 插件创建一个 helloword 的工程
    在这里插入图片描述
  2. 复制button组件界面上配置组件的命令 idf.py add-dependency "espressif/button^3.2.0" 在当前 helloworld 工程下增加 button组件
    在这里插入图片描述

PS：遇到的一些问题及解决方法：

  • idf.py 的命令无法执行，提示 idf.py : 无法将 “idf.py ”项识别为 cmet、函数、脚本文件或可运行程序的名称。请检査名称的拼写，如果包括路径，请确保路径正确，然后再试一次。 或者只会打开 idf.py 这个文件而不执行这个文件的内容.
    解决方法：
    指令只能在 ESP-IDF Terminal 中执行，不能在系统自带的 powershell 等工具中执行
    在这里插入图片描述

  1. 生成 idf_component.yml 文件后，使用命令 idf.py build 或者插件上面的编译按钮对整个工程先进行一次编译，编译完成后，组件就会出现在 managed_components 目录下
    在这里插入图片描述

  2. 此处我们测试最简单GPIO控制LED的功能；将D:\Espressif\MyProject\hello_world\managed_components\espressif__button\examples\button_power_save\main\main.c 文件里面的内容全部复制到 hello_world_main.c 中
    在这里插入图片描述

并对 hello_world_main.c 的内容进行稍微的修改，因为我们不测试低功耗的相关功能，故删除低功耗测试的相关代码，并且修改 GPIO 及按键按下的有效电平；以下使用IO0作为按键输入，且有效电平为低电平。

/** SPDX-FileCopyrightText: 2023-2024 Espressif Systems (Shanghai) CO LTD** SPDX-License-Identifier: Apache-2.0*/#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"
#include "esp_pm.h"
#include "iot_button.h"
#include "esp_sleep.h"
#include "esp_idf_version.h"/* Most development boards have "boot" button attached to GPIO0.* You can also change this to another pin.*/
#if CONFIG_IDF_TARGET_ESP32C3 || CONFIG_IDF_TARGET_ESP32C2 || CONFIG_IDF_TARGET_ESP32H2 || CONFIG_IDF_TARGET_ESP32C6
#define BOOT_BUTTON_NUM         9
#else
#define BOOT_BUTTON_NUM         0
#endif
#define BUTTON_ACTIVE_LEVEL     0static const char *TAG = "button_test";const char *button_event_table[] = {"BUTTON_PRESS_DOWN","BUTTON_PRESS_UP","BUTTON_PRESS_REPEAT","BUTTON_PRESS_REPEAT_DONE","BUTTON_SINGLE_CLICK","BUTTON_DOUBLE_CLICK","BUTTON_MULTIPLE_CLICK","BUTTON_LONG_PRESS_START","BUTTON_LONG_PRESS_HOLD","BUTTON_LONG_PRESS_UP",
};static void button_event_cb(void *arg, void *data)
{ESP_LOGI(TAG, "Button event %s", button_event_table[(button_event_t)data]);#if CONFIG_GPIO_BUTTON_SUPPORT_POWER_SAVEesp_sleep_wakeup_cause_t cause = esp_sleep_get_wakeup_cause();if (cause != ESP_SLEEP_WAKEUP_UNDEFINED) {ESP_LOGI(TAG, "Wake up from light sleep, reason %d", cause);}#endif
}void button_init(uint32_t button_num)
{button_config_t btn_cfg = {.type = BUTTON_TYPE_GPIO,.gpio_button_config = {.gpio_num = button_num,.active_level = BUTTON_ACTIVE_LEVEL,
#if CONFIG_GPIO_BUTTON_SUPPORT_POWER_SAVE.enable_power_save = true,
#endif},};button_handle_t btn = iot_button_create(&btn_cfg);assert(btn);esp_err_t err = iot_button_register_cb(btn, BUTTON_PRESS_DOWN, button_event_cb, (void *)BUTTON_PRESS_DOWN);err |= iot_button_register_cb(btn, BUTTON_PRESS_UP, button_event_cb, (void *)BUTTON_PRESS_UP);err |= iot_button_register_cb(btn, BUTTON_PRESS_REPEAT, button_event_cb, (void *)BUTTON_PRESS_REPEAT);err |= iot_button_register_cb(btn, BUTTON_PRESS_REPEAT_DONE, button_event_cb, (void *)BUTTON_PRESS_REPEAT_DONE);err |= iot_button_register_cb(btn, BUTTON_SINGLE_CLICK, button_event_cb, (void *)BUTTON_SINGLE_CLICK);err |= iot_button_register_cb(btn, BUTTON_DOUBLE_CLICK, button_event_cb, (void *)BUTTON_DOUBLE_CLICK);err |= iot_button_register_cb(btn, BUTTON_LONG_PRESS_START, button_event_cb, (void *)BUTTON_LONG_PRESS_START);err |= iot_button_register_cb(btn, BUTTON_LONG_PRESS_HOLD, button_event_cb, (void *)BUTTON_LONG_PRESS_HOLD);err |= iot_button_register_cb(btn, BUTTON_LONG_PRESS_UP, button_event_cb, (void *)BUTTON_LONG_PRESS_UP);ESP_ERROR_CHECK(err);
}
#if CONFIG_GPIO_BUTTON_SUPPORT_POWER_SAVE
#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 1, 0)
void power_save_init(void)
{esp_pm_config_t pm_config = {.max_freq_mhz = CONFIG_EXAMPLE_MAX_CPU_FREQ_MHZ,.min_freq_mhz = CONFIG_EXAMPLE_MIN_CPU_FREQ_MHZ,
#if CONFIG_FREERTOS_USE_TICKLESS_IDLE.light_sleep_enable = true
#endif};ESP_ERROR_CHECK(esp_pm_configure(&pm_config));
}
#else
void power_save_init(void)
{
#if CONFIG_IDF_TARGET_ESP32esp_pm_config_esp32_t pm_config = {
#elif CONFIG_IDF_TARGET_ESP32S2esp_pm_config_esp32s2_t pm_config = {
#elif CONFIG_IDF_TARGET_ESP32C3esp_pm_config_esp32c3_t pm_config = {
#elif CONFIG_IDF_TARGET_ESP32S3esp_pm_config_esp32s3_t pm_config = {
#elif CONFIG_IDF_TARGET_ESP32C2esp_pm_config_esp32c2_t pm_config = {
#endif.max_freq_mhz = CONFIG_EXAMPLE_MAX_CPU_FREQ_MHZ,.min_freq_mhz = CONFIG_EXAMPLE_MIN_CPU_FREQ_MHZ,
#if CONFIG_FREERTOS_USE_TICKLESS_IDLE.light_sleep_enable = true
#endif};ESP_ERROR_CHECK(esp_pm_configure(&pm_config));
}
#endif
#endifvoid app_main(void)
{#if CONFIG_GPIO_BUTTON_SUPPORT_POWER_SAVEpower_save_init();
#endifbutton_init(BOOT_BUTTON_NUM);
}
  1. 对修改完成的功能进行编译，并下载到测试的开发板上，按下接到 IO0 上的按键，就可以通过日志参看按键的事件：
    在这里插入图片描述

写在最后

如果觉得文章对您有帮助，请关注、点赞、收藏，谢谢！

这篇关于ESP-IDF使用Button组件实现按键检测的功能的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/998377。

相关文章

Linux中压缩、网络传输与系统监控工具的使用完整指南

Linux中压缩、网络传输与系统监控工具的使用完整指南

《Linux中压缩、网络传输与系统监控工具的使用完整指南》在Linux系统管理中,压缩与传输工具是数据备份和远程协作的桥梁,而系统监控工具则是保障服务器稳定运行的眼睛,下面小编就来和大家详细介绍一下它... 目录引言一、压缩与解压：数据存储与传输的优化核心1. zip/unzip：通用压缩格式的便捷操作2.
阅读更多...
Python实现对阿里云OSS对象存储的操作详解

Python实现对阿里云OSS对象存储的操作详解

《Python实现对阿里云OSS对象存储的操作详解》这篇文章主要为大家详细介绍了Python实现对阿里云OSS对象存储的操作相关知识,包括连接,上传,下载,列举等功能,感兴趣的小伙伴可以了解下... 目录一、直接使用代码二、详细使用1. 环境准备2. 初始化配置3. bucket配置创建4. 文件上传到os
阅读更多...
关于集合与数组转换实现方法

关于集合与数组转换实现方法

《关于集合与数组转换实现方法》：本文主要介绍关于集合与数组转换实现方法,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录1、Arrays.asList()1.1、方法作用1.2、内部实现1.3、修改元素的影响1.4、注意事项2、list.toArray()2.1、方
阅读更多...
使用Python实现可恢复式多线程下载器

使用Python实现可恢复式多线程下载器

《使用Python实现可恢复式多线程下载器》在数字时代,大文件下载已成为日常操作,本文将手把手教你用Python打造专业级下载器,实现断点续传,多线程加速,速度限制等功能,感兴趣的小伙伴可以了解下... 目录一、智能续传：从崩溃边缘抢救进度二、多线程加速：榨干网络带宽三、速度控制：做网络的好邻居四、终端交互
阅读更多...
Python中注释使用方法举例详解

Python中注释使用方法举例详解

《Python中注释使用方法举例详解》在Python编程语言中注释是必不可少的一部分,它有助于提高代码的可读性和维护性,：本文主要介绍Python中注释使用方法的相关资料,需要的朋友可以参考下... 目录一、前言二、什么是注释？示例：三、单行注释语法：以 China编程# 开头，后面的内容为注释内容示例：示例：四
阅读更多...
mysql表操作与查询功能详解

mysql表操作与查询功能详解

《mysql表操作与查询功能详解》本文系统讲解MySQL表操作与查询,涵盖创建、修改、复制表语法,基本查询结构及WHERE、GROUPBY等子句,本文结合实例代码给大家介绍的非常详细,感兴趣的朋友跟随... 目录01.表的操作1.1表操作概览1.2创建表1.3修改表1.4复制表02.基本查询操作2.1 SE
阅读更多...
java实现docker镜像上传到harbor仓库的方式

java实现docker镜像上传到harbor仓库的方式

《java实现docker镜像上传到harbor仓库的方式》：本文主要介绍java实现docker镜像上传到harbor仓库的方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地... 目录1. 前 言2. 编写工具类2.1 引入依赖包2.2 使用当前服务器的docker环境推送镜像2.2
阅读更多...
C++20管道运算符的实现示例

C++20管道运算符的实现示例

《C++20管道运算符的实现示例》本文简要介绍C++20管道运算符的使用与实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧... 目录标准库的管道运算符使用自己实现类似的管道运算符我们不打算介绍太多，因为它实际属于c++20最为重要的
阅读更多...
Java easyExcel实现导入多sheet的Excel

Java easyExcel实现导入多sheet的Excel

《JavaeasyExcel实现导入多sheet的Excel》这篇文章主要为大家详细介绍了如何使用JavaeasyExcel实现导入多sheet的Excel,文中的示例代码讲解详细,感兴趣的小伙伴可... 目录1.官网2.Excel样式3.代码1.官网easyExcel官网2.Excel样式3.代码
阅读更多...
Go语言数据库编程GORM 的基本使用详解

Go语言数据库编程GORM 的基本使用详解

《Go语言数据库编程GORM的基本使用详解》GORM是Go语言流行的ORM框架,封装database/sql,支持自动迁移、关联、事务等,提供CRUD、条件查询、钩子函数、日志等功能,简化数据库操作... 目录一、安装与初始化1. 安装 GORM 及数据库驱动2. 建立数据库连接二、定义模型结构体三、自动迁
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2