Arduino OneButton按键处理库实现单击/双击/长按功能

Arduino OneButton按键处理库实现单击/双击长按功能

✨在Arduino开发平台下，按键的单击/双击/长按功能，在通过使用OneButton库，很容易就可以轻松实现。这就是支持C/C++模块化设计的好处，避免重复性开发的工作。

• 🔖本文将具体接收OneButton库的相关调用函数介绍说明以及有关常用按键操作的使用方法。
• 📍 OneButton库github地址：https://github.com/mathertel/OneButton

OneButton接口函数

• 🌿 OneButton(const int pin, const boolean activeLow = true, const bool pullupActive = true);//实例化OneButton对象

• pin,必填参数，指定引脚号。
• bool，类型，可选，默认参数是true:按下为低电平; false : 按下为高电平
• bool,类型，可选，默认参数是true,也就是将引脚上拉开启。

• 🌿setClickTicks(const unsigned int ms)：设置单击时间
• 🌿setDebounceMs(const unsigned int ms)：设置双击时间
• 🌿setPressTicks(const unsigned int ms)：设置长按时间
• 🌿attachClick(callbackFunction newFunction);：单击时调用的函数。
• 🌿attachDoubleClick(callbackFunction newFunction);：双击时调用的函数。
• 🌿attachMultiClick(callbackFunction newFunction);：多次按此单击时调用的函数。
• 🌿attachLongPressStart(callbackFunction newFunction);：长按开始时调用的函数。
• 🌿attachLongPressStop(callbackFunction newFunction);：长按结束调用的函数。
• 🌿attachDuringLongPress(callbackFunction newFunction);：长按期间调用的函数。
• 🌿tick(void);按键扫描函数。
• 🌿tick(bool level);：重新给按键引脚电平状态。
• 🌿reset(void);：重启按键状态。
• 🌿getNumberClicks(void);：获取按键次数（单击或多击）。
• 🌿bool isIdle() ：查询当前按键状态。如果当前正在处理按钮按流，则返回true。(这允许对电源敏感的应用程序知道何时可以安全地关闭主CPU)
• 🌿isLongPressed()：当检测到长按时为True

📝测试代码

• 🌿测试对象：ESP32S3

• 📋单击按下esp32板上的 boot0按键时，板载ws2812变为红色，双击按钮变成绿色，长按之后变成蓝色。

#include <Arduino.h>
#include "OneButton.h"  //https://github.com/mathertel/OneButton
#include <FastLED.h>  //https://github.com/FastLED/FastLED#define KEY 0 //esp32 BOOT0按键引脚#define LED_PIN 48  //ESP32-S3-DevKitC-1 RGB GPIO38 /YD:GPIO48
#define NUM_LEDS 1
OneButton button(KEY, true);CRGB leds[NUM_LEDS];void click();/******单击******/
void doubleclick();/******双击******/
void longPressStart();/******长按开始******/
void duringLongPress();/******长按期间******/
void longPressStop();/******长按结束******/
void attachPressStart();void setup()
{Serial.begin(115200);FastLED.addLeds<WS2812, LED_PIN, GRB>(leds, NUM_LEDS);// pinMode(RGB_PIN,OUTPUT);// digitalWrite(RGB_PIN,LOW);button.reset();//清除按钮状态机的状态button.attachClick(click);//注册单击button.attachDoubleClick(doubleclick);//注册双击button.attachLongPressStart(longPressStart);//注册长按开始button.attachDuringLongPress(duringLongPress);//注册长按button.attachLongPressStop(longPressStop);//注册长按结束button.attachDuringLongPress(attachPressStart);//按下键就会持续触发leds[0] = CRGB(255, 0, 0); // 设置颜色为红色FastLED.show();delay(1000);leds[0] = CRGB(0, 255, 0); // 设置颜色为绿色FastLED.show();delay(1000);leds[0] = CRGB(0, 0, 255); // 设置颜色为红色FastLED.show();delay(1000);leds[0] = CRGB(0, 0, 0); // 关闭FastLED.show();
}
void loop()
{button.tick();delay(10);
}
/******单击******/
void click()
{Serial.println("click");leds[0] = CRGB(255, 0, 0); // 设置颜色为红色FastLED.show();
}
/******双击******/
void doubleclick()
{Serial.println("Doubleclick");leds[0] = CRGB(0, 255, 0); // 设置颜色为绿色FastLED.show();
}
/******长按开始******/
void longPressStart()
{Serial.println("LongPressStart");
}
/******长按期间******/
void duringLongPress()
{if (button.isLongPressed()){Serial.printf("DuringLongPress,KEY STATE:%d\r\n",digitalRead(KEY));delay(50);//稍作延时处}
}
/******长按结束******/
void longPressStop()
{Serial.println("LongPressStop"); leds[0] = CRGB(51, 51, 153); // 设置颜色为靛蓝FastLED.show();}
void attachPressStart()
{Serial.printf("attachPressStart,KEY STATE:%d\r\n",digitalRead(KEY));
}