upd

Author: GyverLibs

README.md

@@ -59,6 +59,7 @@
   - [Одновременное нажатие](#double)
   - [Прерывания](#isr)
   - [Массив кнопок/энкодеров](#array)
+  - [Кастомные функции](#custom)
   - [Мини примеры, сценарии](#examples-mini)
 - [Миграция с v2](#migrate)
 - [Примеры](#example)
@@ -67,6 +68,7 @@
 
 <a id="install"></a>
 ## Установка
+- Для работы требуется библиотека [GyverIO](https://github.com/GyverLibs/GyverIO)
 - Библиотеку можно найти по названию **EncButton** и установить через менеджер библиотек в:
     - Arduino IDE
     - Arduino IDE v2
@@ -125,6 +127,9 @@
 Объявлять до подключения библиотеки
 
 ```cpp
+// отключить привязку к библиотеке GyverIO и использовать стандартный digitalRead
+#define EB_NO_GYVER_IO
+
 // отключить поддержку pressFor/holdFor/stepFor и счётчик степов (экономит 2 байта оперативки)
 #define EB_NO_FOR
 
@@ -137,6 +142,10 @@
 // отключить буферизацию энкодера (экономит 2 байта оперативки)
 #define EB_NO_BUFFER
 
+// кастомные функции
+#define EB_CUSTOM_READ      // использовать своё чтение пина
+#define EB_CUSTOM_UPTIME  // использовать свой таймер
+
 /*
   Настройка таймаутов для всех классов
   - Заменяет таймауты константами, изменить их из программы (SetXxxTimeout()) будет нельзя
@@ -1201,6 +1210,34 @@ void loop() {
 }
 ```
 
+<a id="custom"></a>
+
+### Кастомные функции
+Библиотека поддерживает задание своих функций для чтения пина и получения времени без редактирования файлов библиотеки. Для этого нужно:
+- Объявить соответствующий дефайн перед подключением библиотеки
+  - `EB_CUSTOM_READ` - для своей функции чтения пина
+  - `EB_CUSTOM_UPTIME` - для своего аналога millis()
+- Реализовать соответствующую функцию в .cpp или .ino файле
+  - `EB_read` - для своей функции чтения пина
+  - `EB_uptime` - для своего аналога millis()
+
+Пример:
+
+```cpp
+#define EB_CUSTOM_READ
+#define EB_CUSTOM_UPTIME
+
+#include <EncButton.h>
+
+bool EB_read(const uint8_t pin) {
+    return digitalRead(pin);
+}
+
+uint32_t EB_uptime() {
+    return millis();
+}
+```
+
 <a id="examples-mini"></a>
 
 ### Мини примеры, сценарии
@@ -1653,6 +1690,9 @@ void loop() {
 - v3.4
   - Доступ к счётчику кликов во время нажатого поворота
   - Добавлена функция detach()
+- v3.5 
+  - Добавлена зависимость GyverIO (ускорен опрос пинов)
+  - Добавлена возможность задать свои функции аптайма и чтения пина
     
 <a id="feedback"></a>
 ## Баги и обратная связь

keywords.txt

@@ -24,9 +24,17 @@ EB_HOLD_TIME	KEYWORD1
 EB_STEP_TIME	KEYWORD1
 EB_FAST_TIME	KEYWORD1
 
+EB_NO_GYVER_IO	KEYWORD1
+EB_CUSTOM_READ	KEYWORD1
+EB_CUSTOM_UPTIME	KEYWORD1
+
 #######################################
 # Methods and Functions (KEYWORD2)
 #######################################
+
+EB_read	KEYWORD2
+EB_uptime	KEYWORD2
+
 setHoldTimeout	KEYWORD2
 setStepTimeout	KEYWORD2
 setClickTimeout	KEYWORD2

library.properties

@@ -1,9 +1,10 @@
 name=EncButton
-version=3.4
+version=3.5.0
 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=*
+depends=GyverIO

src/core/Button.h

@@ -20,17 +20,17 @@ class Button : public VirtButton {
 
     // прочитать текущее значение кнопки (без дебаунса)
     bool read() {
-        return EBread(pin) ^ read_bf(EB_INV);
+        return EB_read(pin) ^ read_bf(EB_INV);
     }
 
     // функция обработки, вызывать в loop
     bool tick() {
-        return VirtButton::tick(EBread(pin));
+        return VirtButton::tick(EB_read(pin));
     }
 
     // обработка кнопки без сброса событий и вызова коллбэка
     bool tickRaw() {
-        return VirtButton::tickRaw(EBread(pin));
+        return VirtButton::tickRaw(EB_read(pin));
     }
 
    private:
@@ -53,17 +53,17 @@ class ButtonT : public VirtButton {
 
     // прочитать текущее значение кнопки (без дебаунса)
     bool read() {
-        return EBread(PIN) ^ read_bf(EB_INV);
+        return EB_read(PIN) ^ read_bf(EB_INV);
     }
 
     // функция обработки, вызывать в loop
     bool tick() {
-        return VirtButton::tick(EBread(PIN));
+        return VirtButton::tick(EB_read(PIN));
     }
 
     // обработка кнопки без сброса событий и вызова коллбэка
     bool tickRaw() {
-        return VirtButton::tickRaw(EBread(PIN));
+        return VirtButton::tickRaw(EB_read(PIN));
     }
 
    private:

src/core/EncButton.h

@@ -32,25 +32,25 @@ class EncButton : public VirtEncButton {
 
     // функция обработки, вызывать в loop
     bool tick() {
-        if (read_ef(EB_EISR)) return VirtEncButton::tick(EBread(b));
-        else return VirtEncButton::tick(readEnc(), EBread(b));
+        if (read_ef(EB_EISR)) return VirtEncButton::tick(EB_read(b));
+        else return VirtEncButton::tick(readEnc(), EB_read(b));
     }
 
     // функция обработки без сброса событий
     bool tickRaw() {
-        if (read_ef(EB_EISR)) return VirtEncButton::tickRaw(EBread(b));
-        else return VirtEncButton::tickRaw(readEnc(), EBread(b));
+        if (read_ef(EB_EISR)) return VirtEncButton::tickRaw(EB_read(b));
+        else return VirtEncButton::tickRaw(readEnc(), EB_read(b));
     }
 
     // ====================== READ ======================
     // прочитать значение кнопки
     bool readBtn() {
-        return EBread(b) ^ read_bf(EB_INV);
+        return EB_read(b) ^ read_bf(EB_INV);
     }
 
     // прочитать значение энкодера
     int8_t readEnc() {
-        return EBread(e0) | (EBread(e1) << 1);
+        return EB_read(e0) | (EB_read(e1) << 1);
     }
 
     // ===================== PRIVATE =====================
@@ -84,25 +84,25 @@ class EncButtonT : public VirtEncButton {
 
     // функция обработки, вызывать в loop
     bool tick() {
-        if (read_ef(EB_EISR)) return VirtEncButton::tick(EBread(BTN));
-        else return VirtEncButton::tick(readEnc(), EBread(BTN));
+        if (read_ef(EB_EISR)) return VirtEncButton::tick(EB_read(BTN));
+        else return VirtEncButton::tick(readEnc(), EB_read(BTN));
     }
 
     // функция обработки без сброса событий
     bool tickRaw() {
-        if (read_ef(EB_EISR)) return VirtEncButton::tickRaw(EBread(BTN));
-        else return VirtEncButton::tickRaw(readEnc(), EBread(BTN));
+        if (read_ef(EB_EISR)) return VirtEncButton::tickRaw(EB_read(BTN));
+        else return VirtEncButton::tickRaw(readEnc(), EB_read(BTN));
     }
 
     // ====================== READ ======================
     // прочитать значение кнопки
     bool readBtn() {
-        return EBread(BTN) ^ read_bf(EB_INV);
+        return EB_read(BTN) ^ read_bf(EB_INV);
     }
 
     // прочитать значение энкодера
     int8_t readEnc() {
-        return EBread(ENCA) | (EBread(ENCB) << 1);
+        return EB_read(ENCA) | (EB_read(ENCB) << 1);
     }
 
     // ===================== PRIVATE =====================

src/core/Encoder.h

@@ -43,7 +43,7 @@ class Encoder : public VirtEncoder {
 
     // прочитать значение энкодера
     int8_t readEnc() {
-        return EBread(e0) | (EBread(e1) << 1);
+        return EB_read(e0) | (EB_read(e1) << 1);
     }
 };
 
@@ -82,7 +82,7 @@ class EncoderT : public VirtEncoder {
 
     // прочитать значение энкодера
     int8_t readEnc() {
-        return EBread(ENCA) | (EBread(ENCB) << 1);
+        return EB_read(ENCA) | (EB_read(ENCB) << 1);
     }
 
    private:

src/core/VirtButton.h

@@ -101,7 +101,7 @@ class VirtButton {
 
     // кнопка нажата в прерывании (не учитывает btnLevel!)
     void pressISR() {
-        if (!read_bf(EB_DEB)) tmr = EB_UPTIME();
+        if (!read_bf(EB_DEB)) tmr = EB_uptime();
         set_bf(EB_DEB | EB_BISR);
     }
 
@@ -273,7 +273,7 @@ class VirtButton {
     // ====================== TIME ======================
     // после взаимодействия с кнопкой (или энкодером EncButton) прошло указанное время, мс [событие]
     bool timeout(uint16_t tout) {
-        if (read_bf(EB_TOUT) && (uint16_t)((uint16_t)EB_UPTIME() - tmr) > tout) {
+        if (read_bf(EB_TOUT) && (uint16_t)((uint16_t)EB_uptime() - tmr) > tout) {
             clr_bf(EB_TOUT);
             return 1;
         }
@@ -283,7 +283,7 @@ class VirtButton {
     // время, которое кнопка удерживается (с начала нажатия), мс
     uint16_t pressFor() {
 #ifndef EB_NO_FOR
-        if (ftmr) return (uint16_t)EB_UPTIME() - ftmr;
+        if (ftmr) return (uint16_t)EB_uptime() - ftmr;
 #endif
         return 0;
     }
@@ -382,7 +382,7 @@ class VirtButton {
             else return 0;
         }
 
-        uint16_t ms = EB_UPTIME();
+        uint16_t ms = EB_uptime();
         uint16_t deb = ms - tmr;
 
         if (s) {                                         // кнопка нажата

src/core/VirtEncButton.h

@@ -174,7 +174,7 @@ class VirtEncButton : public VirtButton, public VirtEncoder {
 
    private:
     bool checkFast() {
-        uint16_t ms = EB_UPTIME();
+        uint16_t ms = EB_uptime();
         bool f = 0;
         if (ms - tmr < EB_FAST_T) f = 1;
         tmr = ms;

src/core/utils.cpp

@@ -1,5 +1,27 @@
+#pragma once
 #include <Arduino.h>
 
-#define EB_UPTIME() millis()
+#if !defined(EB_NO_GYVER_IO) && !defined(EB_CUSTOM_READ)
+#include <GyverIO.h>
+#endif
 
-bool EBread(const uint8_t pin);
+bool EB_read(const uint8_t pin);
+uint32_t EB_uptime();
+
+// ====================
+
+#ifndef EB_CUSTOM_READ
+bool EB_read(const uint8_t pin) {
+#ifndef EB_NO_GYVER_IO
+    return gio::read(pin);
+#else
+    return digitalRead(pin);
+#endif
+}
+#endif
+
+#ifndef EB_CUSTOM_UPTIME
+uint32_t EB_uptime() {
+    return millis();
+}
+#endif