upd

Author: GyverLibs

README.md

@@ -123,6 +123,9 @@
 Объявлять до подключения библиотеки
 
 ```cpp
+// отключить поддержку pressFor/holdFor/stepFor и счётчик степов (экономит 2 байта оперативки)
+#define EB_NO_FOR
+
 // отключить обработчик событий attach (экономит 2 байта оперативки)
 #define EB_NO_CALLBACK
 
@@ -142,7 +145,7 @@
 */
 #define EB_DEB_TIME 50      // таймаут гашения дребезга кнопки (кнопка)
 #define EB_CLICK_TIME 500   // таймаут ожидания кликов (кнопка)
-#define EB_HOLD_TIME 500    // таймаут удержания (кнопка)
+#define EB_HOLD_TIME 600    // таймаут удержания (кнопка)
 #define EB_STEP_TIME 200    // таймаут импульсного удержания (кнопка)
 #define EB_FAST_TIME 30     // таймаут быстрого поворота (энкодер)
 ```
@@ -194,12 +197,16 @@
 | step            |      ✔    |       ✔      |    ✔  |     ✔    |
 | hasClicks       |      ✔    |       ✔      |    ✔  |     ✔    |
 | getClicks       |      ✔    |       ✔      |    ✔  |     ✔    |
+| getSteps        |      ✔    |       ✔      |    ✔  |     ✔    |
 | releaseHold     |      ✔    |       ✔      |    ✔  |     ✔    |
 | releaseStep     |      ✔    |       ✔      |    ✔  |     ✔    |
-| timeout         |      ✔    |       ✔      |    ✔  |     ✔    |
 | waiting         |      ✔    |       ✔      |    ✔  |     ✔    |
 | busy            |      ✔    |       ✔      |    ✔  |     ✔    |
 | action          |      ✔    |       ✔      |    ✔  |     ✔    |
+| timeout         |      ✔    |       ✔      |    ✔  |     ✔    |
+| pressFor        |      ✔    |       ✔      |    ✔  |     ✔    |
+| holdFor         |      ✔    |       ✔      |    ✔  |     ✔    |
+| stepFor         |      ✔    |       ✔      |    ✔  |     ✔    |
 </details>
 
 <details>
@@ -236,7 +243,7 @@
 
 ```cpp
 // ================ НАСТРОЙКИ ================
-// установить таймаут удержания, умолч. 500 (макс. 4000 мс)
+// установить таймаут удержания, умолч. 600 (макс. 4000 мс)
 void setHoldTimeout(uint16_t tout);
 
 // установить таймаут импульсного удержания, умолч. 200 (макс. 4000 мс)
@@ -315,6 +322,9 @@ bool hasClicks(uint8_t num);
 // получить количество кликов
 uint8_t getClicks();
 
+// получить количество степов
+uint16_t getSteps();
+
 // кнопка отпущена после удержания [событие]
 bool releaseHold();
 
@@ -327,9 +337,6 @@ bool releaseStep();
 // кнопка отпущена после импульсного удержания с предварительными кликами [событие]
 bool releaseStep(uint8_t num);
 
-// после взаимодействия с кнопкой (или энкодером EncButton) прошло указанное время, мс [событие]
-bool timeout(uint16_t tout);
-
 // кнопка ожидает повторных кликов (между click() и hasClicks()) [состояние]
 bool waiting();
 
@@ -339,6 +346,27 @@ bool busy();
 // было действие с кнопки, вернёт код события [событие]
 uint16_t action();
 
+// ================== ВРЕМЯ ==================
+// после взаимодействия с кнопкой (или энкодером EncButton) прошло указанное время, мс [событие]
+bool timeout(uint16_t ms);
+
+// время, которое кнопка удерживается (с начала нажатия), мс
+uint16_t pressFor();
+
+// кнопка удерживается дольше чем (с начала нажатия), мс [состояние]
+bool pressFor(uint16_t ms);
+
+// время, которое кнопка удерживается (с начала удержания), мс
+uint16_t holdFor();
+
+// кнопка удерживается дольше чем (с начала удержания), мс [состояние]
+bool holdFor(uint16_t ms);
+
+// время, которое кнопка удерживается (с начала степа), мс
+uint16_t stepFor();
+
+// кнопка удерживается дольше чем (с начала степа), мс [состояние]
+bool stepFor(uint16_t ms);
 ```
 </details>
 <details>
@@ -924,12 +952,13 @@ switch (eb.action()) {
 #### Вес библиотеки
 Для максимального уменьшения веса библиотеки (в частности в оперативной памяти) нужно задавать тайматуы константами через define (экономия 1 байт за таймаут), отключить обработчик событий, счётчики-буферы и использовать T-класс (экономия 1 байт за пин):
 ```cpp
+#define EB_NO_FOR
 #define EB_NO_CALLBACK
 #define EB_NO_COUNTER
 #define EB_NO_BUFFER
 #define EB_DEB_TIME 50     // таймаут гашения дребезга кнопки (кнопка)
 #define EB_CLICK_TIME 500  // таймаут ожидания кликов (кнопка)
-#define EB_HOLD_TIME 500   // таймаут удержания (кнопка)
+#define EB_HOLD_TIME 600   // таймаут удержания (кнопка)
 #define EB_STEP_TIME 200   // таймаут импульсного удержания (кнопка)
 #define EB_FAST_TIME 30    // таймаут быстрого поворота (энкодер)
 #include <EncButton.h>
@@ -1215,7 +1244,7 @@ EncoderT<enc0, enc1> e(mode);   // + режим пинов энкодера (у
 
 // #define EB_DEB_TIME 50      // таймаут гашения дребезга кнопки (кнопка)
 // #define EB_CLICK_TIME 500   // таймаут ожидания кликов (кнопка)
-// #define EB_HOLD_TIME 500    // таймаут удержания (кнопка)
+// #define EB_HOLD_TIME 600    // таймаут удержания (кнопка)
 // #define EB_STEP_TIME 200    // таймаут импульсного удержания (кнопка)
 // #define EB_FAST_TIME 30     // таймаут быстрого поворота (энкодер)
 
@@ -1232,7 +1261,7 @@ void setup() {
     eb.setBtnLevel(LOW);
     eb.setClickTimeout(500);
     eb.setDebTimeout(50);
-    eb.setHoldTimeout(500);
+    eb.setHoldTimeout(600);
     eb.setStepTimeout(200);
 
     eb.setEncReverse(0);
@@ -1512,6 +1541,9 @@ void loop() {
 - v3.2
   - Добавлены функции tickRaw() и clear() для всех классов. Позволяет проводить раздельную обработку (см. доку)
   - Улучшена обработка кнопки с использованием прерываний
+- v3.3
+  - Добавлены функции получения времени удержания pressFor(), holdFor(), stepFor() (отключаемые)
+  - Добавлен счётчик степов getSteps() (отключаемый)
     
 <a id="feedback"></a>
 ## Баги и обратная связь

examples/callback/callback.ino

@@ -18,7 +18,14 @@ void cb() {
             Serial.println("step");
             break;
         case EB_RELEASE:
-            Serial.println("release");
+            Serial.print("release. steps: ");
+            Serial.print(eb.getSteps());
+            Serial.print(", press for: ");
+            Serial.print(eb.pressFor());
+            Serial.print(", hold for: ");
+            Serial.print(eb.holdFor());
+            Serial.print(", step for: ");
+            Serial.println(eb.stepFor());
             break;
         case EB_CLICK:
             Serial.println("click");
@@ -49,7 +56,8 @@ void cb() {
             Serial.print("release step clicks ");
             Serial.println(eb.getClicks());
             break;
-        default: Serial.println();
+        default:
+            Serial.println();
     }
 }
 

examples/demo/demo.ino

@@ -1,19 +1,20 @@
 // полное демо
 #include <Arduino.h>
+// #define EB_NO_FOR           // отключить поддержку pressFor/holdFor/stepFor и счётчик степов (экономит 2 байта оперативки)
 // #define EB_NO_CALLBACK      // отключить обработчик событий attach (экономит 2 байта оперативки)
 // #define EB_NO_COUNTER       // отключить счётчик энкодера (экономит 4 байта оперативки)
 // #define EB_NO_BUFFER        // отключить буферизацию энкодера (экономит 1 байт оперативки)
 
 // #define EB_DEB_TIME 50      // таймаут гашения дребезга кнопки (кнопка)
 // #define EB_CLICK_TIME 500   // таймаут ожидания кликов (кнопка)
-// #define EB_HOLD_TIME 500    // таймаут удержания (кнопка)
+// #define EB_HOLD_TIME 600    // таймаут удержания (кнопка)
 // #define EB_STEP_TIME 200    // таймаут импульсного удержания (кнопка)
 // #define EB_FAST_TIME 30     // таймаут быстрого поворота (энкодер)
 
 #include <EncButton.h>
 EncButton eb(2, 3, 4);
-//EncButton eb(2, 3, 4, INPUT); // + режим пинов энкодера
-//EncButton eb(2, 3, 4, INPUT, INPUT_PULLUP); // + режим пинов кнопки
+// EncButton eb(2, 3, 4, INPUT); // + режим пинов энкодера
+// EncButton eb(2, 3, 4, INPUT, INPUT_PULLUP); // + режим пинов кнопки
 
 void setup() {
     Serial.begin(115200);
@@ -22,7 +23,7 @@ void setup() {
     eb.setBtnLevel(LOW);
     eb.setClickTimeout(500);
     eb.setDebTimeout(50);
-    eb.setHoldTimeout(500);
+    eb.setHoldTimeout(600);
     eb.setStepTimeout(200);
 
     eb.setEncReverse(0);
@@ -53,7 +54,16 @@ void loop() {
 
     // кнопка
     if (eb.press()) Serial.println("press");
-    if (eb.release()) Serial.println("release");
+    if (eb.release()) {
+        Serial.print("release. steps: ");
+        Serial.print(eb.getSteps());
+        Serial.print(", press for: ");
+        Serial.print(eb.pressFor());
+        Serial.print(", hold for: ");
+        Serial.print(eb.holdFor());
+        Serial.print(", step for: ");
+        Serial.println(eb.stepFor());
+    }
     if (eb.click()) Serial.println("click");
 
     // состояния

keywords.txt

@@ -16,6 +16,7 @@ VirtButton	KEYWORD1
 EB_NO_COUNTER	KEYWORD1
 EB_NO_BUFFER	KEYWORD1
 EB_NO_CALLBACK	KEYWORD1
+EB_NO_FOR	KEYWORD1
 
 EB_DEB_TIME	KEYWORD1
 EB_CLICK_TIME	KEYWORD1
@@ -42,6 +43,7 @@ holding	KEYWORD2
 step	KEYWORD2
 hasClicks	KEYWORD2
 getClicks	KEYWORD2
+getSteps	KEYWORD2
 releaseHold	KEYWORD2
 releaseStep	KEYWORD2
 timeout	KEYWORD2
@@ -50,6 +52,9 @@ busy	KEYWORD2
 action	KEYWORD2
 attach	KEYWORD2
 pressISR	KEYWORD2
+pressFor	KEYWORD2
+holdFor	KEYWORD2
+stepFor	KEYWORD2
 
 setEncReverse	KEYWORD2
 setEncType	KEYWORD2

library.properties

@@ -1,9 +1,9 @@
 name=EncButton
-version=3.2
+version=3.3
 author=AlexGyver <[email protected]>
 maintainer=AlexGyver <[email protected]>
 sentence=Light and powerful library for button and encoder operation for Arduino
 paragraph=Debounce, click count, hold, step hold mode and many more. Maximum possibilities for button and encoder
 category=Sensors
 url=https://github.com/GyverLibs/EncButton
-architectures=*
+architectures=*