upd

Author: GyverLibs

README.md

@@ -227,7 +227,6 @@
 
 |                | VirtEncoder | Encoder | VirtEncButton | EncButton |
 | -------------- | :---------: | :-----: | :-----------: | :-------: |
-| readEnc        |             |         |               |     ✔     |
 | initEnc        |      ✔      |    ✔    |       ✔       |     ✔     |
 | setEncReverse  |      ✔      |    ✔    |       ✔       |     ✔     |
 | setEncType     |      ✔      |    ✔    |       ✔       |     ✔     |
@@ -518,6 +517,9 @@ bool tick();
 
 // обработка кнопки без сброса событий и вызова коллбэка
 bool tickRaw();
+
+// получить пин кнопки
+uint8_t getPin();
 ```
 </details>
 <details>
@@ -561,6 +563,12 @@ int8_t tickISR();
 
 // функция обработки для вызова в loop
 int8_t tick();
+
+// получить пин энкодера
+uint8_t getPinA();
+
+// получить пин энкодера
+uint8_t getPinB();
 ```
 </details>
 <details>
@@ -612,8 +620,14 @@ bool tick();
 // прочитать значение кнопки с учётом setBtnLevel
 bool readBtn();
 
-// прочитать значение энкодера
-int8_t readEnc();
+// получить пин кнопки
+uint8_t getPin();
+
+// получить пин энкодера
+uint8_t getPinA();
+
+// получить пин энкодера
+uint8_t getPinB();
 ```
 </details>
 <details>
@@ -642,9 +656,6 @@ bool tick();
 
 // прочитать значение кнопки
 bool readBtn();
-
-// прочитать значение энкодера
-int8_t readEnc();
 ```
 </details>
 
@@ -1116,8 +1127,10 @@ void loop() {
 
 ### Одновременное нажатие
 Библиотека нативно поддерживает работу с двумя одновременно нажатыми кнопками как с третьей кнопкой. Для этого нужно:
+
+#### Новый способ (v3)
 1. Cоздать специальную кнопку `MultiButton`
-2. Передать виртуальной кнопке в обработку свои кнопки (это могут быть объекты классов `VirtButton`, `Button`, `EncButton` + их `T`-версии). **Мульти-кнопка сама опросит обе кнопки!**
+2. Передать виртуальной кнопке в обработку свои кнопки (это могут быть объекты классов `Button` и `EncButton` + их `T`-версии). **Мульти-кнопка сама опросит обе кнопки!**
 3. Опрашивать события или слушать обработчик
 
 ```cpp
@@ -1137,6 +1150,34 @@ void loop() {
 
 Библиотека сама "сбросит" лишние события с реальных кнопок, если они были нажаты вместе, за исключением события `press`. Таким образом получается полноценная третья кнопка из двух других с удобным опросом.
 
+#### Старый способ
+1. Создать дополнительную виртуальную кнопку
+2. Вызвать тикеры у отдельных кнопок
+3. Вызвать тикер у виртуальной кнопки, передав в него отдельные кнопки
+
+Данный способ не работает с обработчиком - он будет вызван у отдельных кнопок в любом случае
+
+```cpp
+Button b0(4);
+Button b1(5);
+VirtButton b2;  // виртуальная - 1
+
+void loop() {
+    // тикеры - 2
+    b0.tick();
+    b1.tick();
+
+    // обработка одновременного нажатия двух кнопок - 3
+    b2.tick(b0, b1);
+
+    if (b0.click()) Serial.println("b0 click");
+    if (b1.click()) Serial.println("b1 click");
+
+    if (b2.click()) Serial.println("b0+b1 click");
+    if (b2.step()) Serial.println("b0+b1 step");
+}
+```
+
 <a id="isr"></a>
 
 ### Прерывания

README_EN.md

@@ -216,7 +216,6 @@ Thus, to study all the available functions of a particular library, you need to
 
 ||Virtencoder |Encoder |Virtencbutton |Encbutton |
 | -------------- |: ----------------------------- |: -------: |: -----------------------------: |: ---------: |
-|Readenc ||||✔ |
 |Initenc |✔ |✔ |✔ |✔ |
 |Setencreverse |✔ |✔ |✔ |✔ |
 |Setenctype |✔ |✔ |✔ |✔ |
@@ -591,9 +590,6 @@ Bool Tick ();
 
 // Read the value of the button taking into account Setbtnlevel
 Bool Readbtn ();
-
-// Read the value of the encoder
-Int8_T Readenc ();
 `` `
 </details>
 <details>
@@ -622,9 +618,6 @@ Bool Tick ();
 
 // Read the button value
 Bool Readbtn ();
-
-// Read the value of the encoder
-Int8_T Readenc ();
 `` `
 </details>
 

keywords.txt

@@ -89,7 +89,6 @@ tickRaw	KEYWORD2
 tickISR	KEYWORD2
 tick	KEYWORD2
 readBtn	KEYWORD2
-readEnc	KEYWORD2
 
 #######################################
 # Constants (LITERAL1)

library.properties

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

src/core/Button.h

@@ -33,6 +33,11 @@ class Button : public VirtButton {
         return VirtButton::tickRaw(EB_read(pin));
     }
 
+    // получить пин кнопки
+    uint8_t getPin() {
+        return pin;
+    }
+
    private:
     uint8_t pin;
 };

src/core/EncButton.h

@@ -46,6 +46,21 @@ class EncButton : public VirtEncButton {
         return EB_read(b) ^ bf.read(EB_INV);
     }
 
+    // получить пин кнопки
+    uint8_t getPin() {
+        return b;
+    }
+
+    // получить пин энкодера
+    uint8_t getPinA() {
+        return e0;
+    }
+
+    // получить пин энкодера
+    uint8_t getPinB() {
+        return e1;
+    }
+
     // ===================== PRIVATE =====================
    private:
     uint8_t e0, e1, b;

src/core/Encoder.h

@@ -36,6 +36,16 @@ class Encoder : public VirtEncoder {
         return ef.read(EB_EISR) ? VirtEncoder::tickRaw() : VirtEncoder::tickRaw(EB_read(e0), EB_read(e1));
     }
 
+    // получить пин энкодера
+    uint8_t getPinA() {
+        return e0;
+    }
+
+    // получить пин энкодера
+    uint8_t getPinB() {
+        return e1;
+    }
+
    private:
     uint8_t e0, e1;
 };

src/core/MultiButton.h

@@ -12,18 +12,23 @@ class MultiButton : public VirtButton {
         b0.tickRaw();
         b1.tickRaw();
 
-        if (bf.read(EB_BOTH)) {
-            if (!b0.pressing() && !b1.pressing()) bf.clear(EB_BOTH);
-            if (!b0.pressing()) b0.reset();
-            if (!b1.pressing()) b1.reset();
-            b0.clear();
-            b1.clear();
-            return VirtButton::tick(true);
-        } else {
-            if (b0.pressing() && b1.pressing()) bf.set(EB_BOTH);
+        // if (bf.read(EB_BOTH)) {
+        //     if (!b0.pressing() && !b1.pressing()) bf.clear(EB_BOTH);
+        //     if (!b0.pressing()) b0.reset();
+        //     if (!b1.pressing()) b1.reset();
+        //     b0.clear();
+        //     b1.clear();
+        //     return VirtButton::tick(true);
+        // } else {
+        //     if (b0.pressing() && b1.pressing()) bf.set(EB_BOTH);
+        //     b0.call();
+        //     b1.call();
+        //     return VirtButton::tick(false);
+        // }
+        if (!bf.read(EB_BOTH)) {
             b0.call();
             b1.call();
-            return VirtButton::tick(false);
         }
+        return VirtButton::tick(b0, b1);
     }
 };

src/core/VirtButton.h

@@ -86,6 +86,7 @@ enum class EBAction {
 #define EB_HLD_R (1 << 2)
 #define EB_STP_R (1 << 3)
 #define EB_REL_R (1 << 4)
+#define EB_ALL_R (EB_CLKS_R | EB_PRS_R | EB_HLD_R | EB_STP_R | EB_REL_R)
 
 #define EB_PRS (1 << 5)
 #define EB_HLD (1 << 6)
@@ -165,11 +166,9 @@ class VirtButton {
 
     // принудительно сбросить флаги событий
     void clear(bool resetTout = false) {
-        if (resetTout && bf.read(EB_TOUT)) bf.clear(EB_TOUT);
+        if (resetTout) bf.clear(EB_TOUT);
         if (bf.read(EB_CLKS_R)) clicks = 0;
-        if (bf.read(EB_CLKS_R | EB_STP_R | EB_PRS_R | EB_HLD_R | EB_REL_R)) {
-            bf.clear(EB_CLKS_R | EB_STP_R | EB_PRS_R | EB_HLD_R | EB_REL_R);
-        }
+        bf.clear(EB_ALL_R);
     }
 
     // игнорировать все события до отпускания кнопки
@@ -206,7 +205,7 @@ class VirtButton {
 
     // кнопка отпущена (в любом случае) [событие]
     bool release() {
-        return bf.eq(EB_REL_R | EB_REL, EB_REL_R | EB_REL);
+        return bf.all(EB_REL_R | EB_REL);
     }
 
     // кнопка отпущена (в любом случае) с предварительными кликами [событие]
@@ -246,7 +245,7 @@ class VirtButton {
 
     // кнопка удерживается (больше таймаута) [состояние]
     bool holding() {
-        return bf.eq(EB_PRS | EB_HLD, EB_PRS | EB_HLD);
+        return bf.all(EB_PRS | EB_HLD);
     }
 
     // кнопка удерживается (больше таймаута) с предварительными кликами [состояние]
@@ -304,7 +303,7 @@ class VirtButton {
 
     // кнопка отпущена после импульсного удержания с предварительными кликами [событие]
     bool releaseStep(const uint8_t num) {
-        return clicks == num && bf.eq(EB_CLKS_R | EB_STP, EB_CLKS_R | EB_STP);
+        return clicks == num && bf.all(EB_CLKS_R | EB_STP);
     }
 
     // кнопка отпущена после удержания или импульсного удержания [событие]
@@ -319,7 +318,7 @@ class VirtButton {
 
     // кнопка ожидает повторных кликов [состояние]
     bool waiting() {
-        return clicks && bf.eq(EB_PRS | EB_REL, 0);
+        return clicks && !bf.read(EB_PRS | EB_REL);
     }
 
     // идёт обработка [состояние]
@@ -329,7 +328,7 @@ class VirtButton {
 
     // было действие с кнопки, вернёт код события [событие]
     uint16_t action() {
-        switch (bf.mask(0b111111111)) {
+        switch (bf.mask(EB_ALL_R | EB_PRS | EB_HLD | EB_STP | EB_REL)) {
             case (EB_PRS | EB_PRS_R): return EB_PRESS;
             case (EB_PRS | EB_HLD | EB_HLD_R): return EB_HOLD;
             case (EB_PRS | EB_HLD | EB_STP | EB_STP_R): return EB_STEP;
@@ -416,10 +415,10 @@ class VirtButton {
             if (!b1.pressing()) b1.reset();
             b0.clear();
             b1.clear();
-            return tick(1);
+            return tick(true);
         } else {
             if (b0.pressing() && b1.pressing()) bf.set(EB_BOTH);
-            return tick(0);
+            return tick(false);
         }
     }
 
@@ -456,11 +455,11 @@ class VirtButton {
 
     uint8_t clicks;
 
-    // deprecated
+    // ===================== DEPRECATED =====================
     void setButtonLevel(bool level) __attribute__((deprecated)) {
         bf.write(EB_INV, !level);
     }
-    
+
     // после взаимодействия с кнопкой (или энкодером EncButton) прошло указанное время, мс [событие]
     bool timeout(const uint16_t tout) /*__attribute__((deprecated))*/ {
         if (timeoutState(tout)) {
@@ -475,6 +474,14 @@ class VirtButton {
         return (bf.read(EB_TOUT) && (uint16_t)((uint16_t)EB_uptime() - tmr) > tout);
     }
 
+    bool isStep() __attribute__((deprecated)) { return step(); }
+    bool isHold() __attribute__((deprecated)) { return holding(); }
+    bool isHolded() __attribute__((deprecated)) { return hold(); }
+    bool isHeld() __attribute__((deprecated)) { return hold(); }
+    bool isClick() __attribute__((deprecated)) { return click(); }
+    bool isRelease() __attribute__((deprecated)) { return release(); }
+    bool isPress() __attribute__((deprecated)) { return press(); }
+
     // ====================== PRIVATE ======================
    protected:
     uint16_t tmr = 0;
@@ -564,7 +571,7 @@ class VirtButton {
             } else if (clicks) {                                                                // есть клики, ждём EB_CLICK_TIME
                 if (bf.read(EB_HLD | EB_STP) || deb >= EB_GET_CLICK_TIME()) bf.set(EB_CLKS_R);  // флаг clicks
 #ifndef EB_NO_FOR
-                else if (ftmr) ftmr = 0;
+                else ftmr = 0;
 #endif
             } else if (bf.read(EB_BUSY)) {
                 bf.clear(EB_HLD | EB_STP | EB_BUSY);
@@ -576,6 +583,6 @@ class VirtButton {
             }
             if (bf.read(EB_DEB)) bf.clear(EB_DEB);  // сброс ожидания нажатия (дебаунс)
         }
-        return bf.read(EB_CLKS_R | EB_PRS_R | EB_HLD_R | EB_STP_R | EB_REL_R);
+        return bf.read(EB_ALL_R);
     }
 };