Update

More responsive pressCode() function

Author: Dlloydev

README.md

@@ -307,11 +307,11 @@ if (retrigger(500)) {
 ##### Description
 
 - Up to 225 possible codes with one button. The returned code (*byte*) is easy to interpret when viewed in hex format. For example, `47` is 4 long, 7 short presses. `F2` is double-click, `F7` is 7 `F`ast clicks. 
-- Fast-click mode is detected if the first 2 clicks (presses) are less than 0.4 sec, then counts any extra presses if the duration is less than 1 sec, up to 15 max (code `FF`) 
-- Detection of long (greater than 1 sec) presses and short (less than 1 sec) presses occurs if the first press is 0.4 sec or longer. 
+- Fast-click mode is detected if the first several clicks (presses) are less than 0.2 sec, then all presses are counted as fast, up to 15 max (code `FF`) 
+- Detection of long presses occurs if the first press is greater than 0.2 sec, then all presses greater than 0.2 sec are counted as long and all presses less than 0.2 sec are counted as short presses. 
 - Detect up to 15 short presses
 - Detect up to 14 long presses
-- Returns code after button is released for 1 sec
+- Returns code after button is released for 0.5 sec
 - simplifies your code while adding maximum functionality to one button
 
 ##### Example

examples/Press_Code/Press_Code.ino

@@ -3,7 +3,23 @@
   ===================
   A simple example that demonstrates how fast-clicks, short presses and
   long presses can be automatically detected and combined into a byte code.
-  In debug mode, the serial monitor shows timing results and code.
+ 
+  ⦿ Up to 225 possible codes with one button. The returned code (byte) is easy to
+    interpret when viewed in hex format. For example, `47` is 4 long, 7 short presses.
+    F2 is double-click, F7 is 7 `F`ast clicks.
+
+  ⦿ Fast-click mode is detected if the first several presses are less than 0.2 sec,
+    then all presses are counted as fast, up to 15 max (code `FF`).
+
+  ⦿ Detection of long presses occurs if the first press is greater than 0.2 sec,
+    then all presses greater than 0.2 sec are counted as long
+    and all presses less than 0.2 sec are counted as short presses.
+
+  ⦿ Detect up to 15 short presses
+  ⦿ Detect up to 14 long presses
+  ⦿ Returns code after button is released for 0.5 sec
+  ⦿ simplifies your code while adding maximum functionality to one button
+  
   Try on Wokwi UNO: https://wokwi.com/projects/334284248581145170
           ESP32-S2: https://wokwi.com/projects/334320246564323924
   ***********************************************************************/

keywords.txt

@@ -62,5 +62,5 @@ input_pullup	LITERAL1
 input_pulldown	LITERAL1
 input_bit	LITERAL1
 input_byte	LITERAL1
-MULTI	LITERAL1
-LONG	LITERAL1
+FAST	LITERAL1
+DONE	LITERAL1

library.json

@@ -1,6 +1,6 @@
 {
   "name": "Toggle",
-  "version": "3.1.7",
+  "version": "3.1.8",
   "description": "Arduino button debounce library for various switch types, port expanders and other 8-bit data sources. Fast and robust debounce algorithm.",
   "keywords": "debounce, toggle, button, switch, data, deglitch",
   "repository":

library.properties

@@ -1,5 +1,5 @@
 name=Toggle
-version=3.1.7
+version=3.1.8
 author=David Lloyd
 maintainer=David Lloyd <dlloydev@testcor.ca>
 sentence=AArduino button debounce library for various switch types, port expanders and other 8-bit data sources.

src/Toggle.cpp

@@ -1,5 +1,5 @@
 /************************************************
-   Toggle Library for Arduino - Version 3.1.7
+   Toggle Library for Arduino - Version 3.1.8
    by dlloydev https://github.com/Dlloydev/Toggle
    Licensed under the MIT License.
  ************************************************/
@@ -196,7 +196,7 @@ uint8_t Toggle::pressCode(bool debug) {
   switch (_state) {
     case PB_DEFAULT:
       elapsedMs = getElapsedMs();
-      if (pCode && isReleased() && (elapsedMs > (CLICK::LONG))) _state = PB_DONE;
+      if (pCode && isReleased() && (elapsedMs > (CLICK::DONE))) _state = PB_DONE;
       if (onChange()) clearTimer();
       if (onPress()) {
         _state = PB_ON_PRESS;
@@ -214,12 +214,13 @@ uint8_t Toggle::pressCode(bool debug) {
       break;
 
     case PB_ON_RELEASE:
-      if ((elapsedMs < CLICK::MULTI) && (!pCode || (pCode > 0xEF))) _state = PB_MULTI_CLICKS;
-      else if (elapsedMs < CLICK::LONG) _state = PB_SHORT_CLICKS;
-      else _state = PB_LONG_CLICKS;
+      if (elapsedMs > CLICK::FAST && (!pCode || pCode >= 0x10)) _state = PB_LONG_CLICKS;
+      else if (elapsedMs < CLICK::FAST && pCode >= 0x10) _state = PB_SHORT_CLICKS;
+      else if (elapsedMs < CLICK::FAST && !pCode) _state = PB_FAST_CLICKS;
+      else  _state = PB_SHORT_CLICKS;
       break;
 
-    case PB_MULTI_CLICKS:
+    case PB_FAST_CLICKS:
       pCode |= 0xF0;
       if ((pCode & 0x0F) < 0x0F) pCode += 1;
       _state = PB_DEFAULT;

src/Toggle.h

@@ -47,12 +47,12 @@ class Toggle {
 
   private:
 
-    enum CLICK : uint16_t {MULTI = 400, LONG = 1000};
+    enum CLICK : uint16_t {FAST = 200, DONE = 500};
     enum fsm_t : uint8_t {  // finite state machine
       PB_DEFAULT = 0,
       PB_ON_PRESS = 1,
       PB_ON_RELEASE = 2,
-      PB_MULTI_CLICKS = 3,
+      PB_FAST_CLICKS = 3,
       PB_SHORT_CLICKS = 4,
       PB_LONG_CLICKS = 5,
       PB_DONE = 6