upd

Author: GyverLibs

README.md

@@ -163,14 +163,17 @@ int8_t getDir();    // направление последнего поворо
 int counter;        // доступ к счётчику энкодера
 
 // ================ BUTTON ================
+bool state();       // текущий статус кнопки
 bool press();       // кнопка нажата
 bool release();     // кнопка отпущена
 bool click();       // клик
 bool held();        // было удержание (однократное срабатывание)
 bool hold();        // удерживается (постоянное срабатывание)
 bool step();        // режим импульсного удержания
+bool step(uint8_t clicks);    // режим импульсного удержания с предварительным накликиванием
 bool releaseStep(); // отпущена после режима step
-bool state();       // текущий статус кнопки
+bool releaseStep(uint8_t clicks); // отпущена после режима step с предварительным накликиванием
+
 uint8_t clicks;     // доступ к счётчику кликов
 uint8_t hasClicks();            // вернёт количество кликов, если они есть
 bool hasClicks(uint8_t num);    // проверка на наличие указанного количества кликов
@@ -223,6 +226,7 @@ void pullUp();          // здесь не реализована!
     - Точный алгоритм активируется добавлением `#define EB_BETTER_ENC` перед подключением библиотеки
 - Версия библиотеки *EncButton2.h* хранит номера пинов в классе. Используйте эту версию для создания массива объектов EncButton!
 
+
 <a id="example"></a>
 ## Примеры
 ### Полное демо tick
@@ -320,6 +324,57 @@ void loop() {
 }
 ```
 
+### Одна кнопка управляет несколькими переменными
+```cpp
+// используем одну КНОПКУ для удобного изменения трёх переменных
+// первая - один клик, затем удержание (нажал-отпустил-нажал-держим)
+// вторая - два клика, затем удержание
+// третья - три клика, затем удержание
+// смотри монитор порта
+
+#include <EncButton.h>
+EncButton<EB_TICK, 3> btn;
+
+// переменные для изменения
+int val_a, val_b, val_c;
+
+// шаги изменения (signed)
+int8_t step_a = 1;
+int8_t step_b = 5;
+int8_t step_c = 10;
+
+void setup() {
+  Serial.begin(9600);
+}
+
+void loop() {
+  btn.tick();
+
+  // передаём количество предварительных кликов
+  if (btn.step(1)) {
+    val_a += step_a;
+    Serial.print("val_a: ");
+    Serial.println(val_a);
+  }
+  if (btn.step(2)) {
+    val_b += step_b;
+    Serial.print("val_b: ");
+    Serial.println(val_b);
+  }
+  if (btn.step(3)) {
+    val_c += step_c;
+    Serial.print("val_c: ");
+    Serial.println(val_c);
+  }
+
+  // разворачиваем шаг для изменения в обратную сторону
+  // передаём количество предварительных кликов
+  if (btn.releaseStep(1)) step_a = -step_a;
+  if (btn.releaseStep(2)) step_b = -step_b;
+  if (btn.releaseStep(3)) step_c = -step_c;
+}
+```
+
 <a id="versions"></a>
 ## Версии
 - v1.1 - пуллап отдельныи методом
@@ -341,6 +396,7 @@ void loop() {
 - v1.14 - добавлена releaseStep(). Отпускание кнопки внесено в дебаунс
 - v1.15 - добавлен setPins() для EncButton2
 - v1.16 - добавлен режим EB_HALFSTEP_ENC для полушаговых энкодеров
+- v1.17 - добавлен step с предварительными кликами
 
 <a id="feedback"></a>
 ## Баги и обратная связь

examples/stepMode/stepMode.ino

@@ -0,0 +1,47 @@
+// используем одну КНОПКУ для удобного изменения трёх переменных
+// первая - один клик, затем удержание (нажал-отпустил-нажал-держим)
+// вторая - два клика, затем удержание
+// третья - три клика, затем удержание
+// смотри монитор порта
+
+#include <EncButton.h>
+EncButton<EB_TICK, 3> btn;
+
+// переменные для изменения
+int val_a, val_b, val_c;
+
+// шаги изменения (signed)
+int8_t step_a = 1;
+int8_t step_b = 5;
+int8_t step_c = 10;
+
+void setup() {
+  Serial.begin(9600);
+}
+
+void loop() {
+  btn.tick();
+
+  // передаём количество предварительных кликов
+  if (btn.step(1)) {
+    val_a += step_a;
+    Serial.print("val_a: ");
+    Serial.println(val_a);
+  }
+  if (btn.step(2)) {
+    val_b += step_b;
+    Serial.print("val_b: ");
+    Serial.println(val_b);
+  }
+  if (btn.step(3)) {
+    val_c += step_c;
+    Serial.print("val_c: ");
+    Serial.println(val_c);
+  }
+
+  // разворачиваем шаг для изменения в обратную сторону
+  // передаём количество предварительных кликов
+  if (btn.releaseStep(1)) step_a = -step_a;
+  if (btn.releaseStep(2)) step_b = -step_b;
+  if (btn.releaseStep(3)) step_c = -step_c;
+}

library.properties

@@ -1,5 +1,5 @@
 name=EncButton
-version=1.16
+version=1.17
 author=AlexGyver <[email protected]>
 maintainer=AlexGyver <[email protected]>
 sentence=Light and fast library for button and encoder operation for Arduino

src/EncButton.h

@@ -36,6 +36,7 @@
     v1.14 - добавлена releaseStep(). Отпускание кнопки внесено в дебаунс
     v1.15 - добавлен setPins() для EncButton2
     v1.16 - добавлен режим EB_HALFSTEP_ENC для полушаговых энкодеров
+    v1.17 - добавлен step с предварительными кликами
 */
 
 #ifndef _EncButton_h
@@ -249,21 +250,23 @@ class EncButton {
     int16_t counter = 0;                        // счётчик энкодера
 
     // ======================================= BTN =======================================
+    bool state() { return _btnState; }          // статус кнопки
     bool press() { return checkState(8); }      // кнопка нажата
     bool release() { return checkFlag(10); }    // кнопка отпущена
     bool click() { return checkState(5); }      // клик по кнопке
     bool held() { return checkState(6); }       // кнопка удержана
     bool hold() { return _EB_readFlag(4); }     // кнопка удерживается
-    bool step() { return checkState(7); }       // режим импульсного удержания
-    bool state() { return _btnState; }          // статус кнопки
-    bool releaseStep() {return checkFlag(12);}  // кнопка отпущена после импульсного удержания
+    bool step(uint8_t clk = 0) { return (clicks == clk) ? checkState(7) : 0; }  // режим импульсного удержания с предварительным накликиванием
+    bool releaseStep(uint8_t clk = 0) { return (clicks == clk) ? checkFlag(12) : 0; }  // кнопка отпущена после импульсного удержания с предварительным накликиванием
 
     uint8_t clicks = 0;                         // счётчик кликов
     bool hasClicks(uint8_t num) { return (clicks == num && checkFlag(7)) ? 1 : 0; } // имеются клики
     uint8_t hasClicks() { return checkFlag(6) ? clicks : 0; }                       // имеются клики
 
     // ===================================================================================
     // =================================== DEPRECATED ====================================
+    //bool step() { return checkState(7); }       // режим импульсного удержания
+    //bool releaseStep() { return checkFlag(12); } // кнопка отпущена после импульсного удержания
     bool isStep() { return step(); }
     bool isHold() { return hold(); }
     bool isHolded() { return held(); }

src/EncButton2.h

@@ -225,21 +225,23 @@ class EncButton2 {
     int16_t counter = 0;                        // счётчик энкодера
 
     // ======================================= BTN =======================================
+    bool state() { return _btnState; }          // статус кнопки
     bool press() { return checkState(8); }      // кнопка нажата
     bool release() { return checkFlag(10); }    // кнопка отпущена
     bool click() { return checkState(5); }      // клик по кнопке
     bool held() { return checkState(6); }       // кнопка удержана
     bool hold() { return _EB_readFlag(4); }     // кнопка удерживается
-    bool step() { return checkState(7); }       // режим импульсного удержания
-    bool state() { return _btnState; }          // статус кнопки
-    bool releaseStep() {return checkFlag(12);}  // кнопка отпущена после импульсного удержания
+    bool step(uint8_t clk = 0) { return (clicks == clk) ? checkState(7) : 0; }  // режим импульсного удержания с предварительным накликиванием
+    bool releaseStep(uint8_t clk = 0) { return (clicks == clk) ? checkFlag(12) : 0; }  // кнопка отпущена после импульсного удержания с предварительным накликиванием
 
     uint8_t clicks = 0;                         // счётчик кликов
     bool hasClicks(uint8_t num) { return (clicks == num && checkFlag(7)) ? 1 : 0; } // имеются клики
     uint8_t hasClicks() { return checkFlag(6) ? clicks : 0; }                       // имеются клики
 
     // ===================================================================================
     // =================================== DEPRECATED ====================================
+    //bool step() { return checkState(7); }       // режим импульсного удержания
+    //bool releaseStep() { return checkFlag(12); } // кнопка отпущена после импульсного удержания
     bool isStep() { return step(); }
     bool isHold() { return hold(); }
     bool isHolded() { return held(); }