upd

Author: GyverLibs

README.md

@@ -1,4 +1,4 @@
-[![Foo](https://img.shields.io/badge/Version-1.19.2-brightgreen.svg?style=flat-square)](#versions)
+[![Foo](https://img.shields.io/badge/Version-1.19.3-brightgreen.svg?style=flat-square)](#versions)
 [![Foo](https://img.shields.io/badge/Website-AlexGyver.ru-blue.svg?style=flat-square)](https://alexgyver.ru/)
 [![Foo](https://img.shields.io/badge/%E2%82%BD$%E2%82%AC%20%D0%9D%D0%B0%20%D0%BF%D0%B8%D0%B2%D0%BE-%D1%81%20%D1%80%D1%8B%D0%B1%D0%BA%D0%BE%D0%B9-orange.svg?style=flat-square)](https://alexgyver.ru/support_alex/)
 
@@ -334,10 +334,12 @@ void detachClicks();                       // отключить обработ
 
 ### Виртуальный режим
 Виртуальный режим позволяет получить все возможности библиотеки EncButton в ситуациях, когда кнопка не подключена напрямую к микроконтроллеру, либо для её опроса используется другая библиотека:
-- Аналоговая клавиатура (например через библиотеку [AnalogKey](https://github.com/GyverLibs/AnalogKey))
-- Матричная клавиатура (например через библиотеку [SimpleKeypad](https://github.com/maximebohrer/SimpleKeypad))
+- Аналоговая клавиатура (например через библиотеку [AnalogKey](https://github.com/GyverLibs/AnalogKey)). Смотри пример *virtual_AnalogKey*
+- Матричная клавиатура (например через библиотеку [SimpleKeypad](https://github.com/maximebohrer/SimpleKeypad)). Смотри пример *virtual_SimpleKeypad* и *virtual_SimpleKeypad_array*
 - Кнопки или энкодеры, подключенные через расширители пинов или сдвиговые регистры  
 
+Таким образом можно получить несколько нажатий с матричной клавиатуры, удержание кнопок матричной клавиатуры, импульсное удержание и прочие фишки EncButton.  
+
 Для работы нужно передать в `tick()` текущие состояния "пинов" кнопки/энкодера: `tick(s1, s2, s3)` в следующем порядке
 - Кнопка - (сигнал кнопки)
 - Энкодер - (сигнал энкодера А, сигнал энкодера B)
@@ -527,6 +529,7 @@ void loop() {
 - v1.19 - оптимизация скорости, уменьшен вес в sram
 - v1.19.1 - ещё чутка увеличена производительность
 - v1.19.2 - ещё немного увеличена производительность, спасибо XRay3D
+- v1.19.3 - сделал высокий уровень кнопки по умолчанию в виртуальном режиме
 
 <a id="feedback"></a>
 ## Баги и обратная связь

examples/virtual/virtual.ino

@@ -15,7 +15,7 @@ void loop() {
   // (сигнал кнопки)
   // (сигнал энкодера А, сигнал энкодера B)
   // (сигнал энкодера А, сигнал энкодера B, сигнал кнопки)
-  enc.tick(digitalRead(4));
+  enc.tick(!digitalRead(4));
 
   if (enc.press()) Serial.println("press");
   if (enc.click()) Serial.println("click");

examples/virtual_AnalogKey/virtual_AnalogKey.ino

@@ -0,0 +1,35 @@
+// пример работы в виртуальном режиме совместно с библиотекой AnalogKey
+// https://github.com/GyverLibs/AnalogKey
+
+#include <EncButton.h>
+EncButton<EB_TICK, VIRT_BTN> btn0;
+EncButton<EB_TICK, VIRT_BTN> btn1;
+
+#include <AnalogKey.h>
+// создаём массив значений сигналов с кнопок
+int16_t sigs[16] = {
+  1023, 927, 856, 783,
+  671,  632,  590,  560,
+  504,  480,  455,  440,
+  399,  319,  255,  230
+};
+
+// указываем пин, количество кнопок и массив значений
+AnalogKey<A0, 16, sigs> keys;
+
+
+void setup() {
+  Serial.begin(9600);
+}
+
+void loop() {
+  btn0.tick(keys.status(0));
+  btn1.tick(keys.status(1));
+
+  // забираем действия с кнопок
+  if (btn0.click()) Serial.println("click 0");
+  if (btn0.held()) Serial.println("held 0");
+
+  if (btn1.press()) Serial.println("press 1");
+  if (btn1.step()) Serial.println("step 1");
+}

examples/virtual_SimpleKeypad/virtual_SimpleKeypad.ino

@@ -0,0 +1,44 @@
+// пример работы в виртуальном режиме совместно с библиотекой SimpleKeypad
+// https://github.com/maximebohrer/SimpleKeypad
+
+#include <EncButton.h>
+EncButton<EB_TICK, VIRT_BTN> btn0;
+EncButton<EB_TICK, VIRT_BTN> btn1;
+
+// пины подключения (по порядку штекера)
+byte colPins[] = {7, 6, 5, 4};
+byte rowPins[] = {11, 10, 9, 8};
+
+// массив имён кнопок
+char keys[4][4] = {
+  {'1', '2', '3', 'A'},
+  {'4', '5', '6', 'B'},
+  {'7', '8', '9', 'C'},
+  {'*', '0', '#', 'D'}
+};
+
+#include <SimpleKeypad.h>
+SimpleKeypad pad((char*)keys, rowPins, colPins, 4, 4);
+
+void setup() {
+  Serial.begin(9600);
+}
+
+void loop() {
+  // тикаем все кнопки, передавая сравнение с кодом кнопки в цикле
+  // делаем это по таймеру, чтобы не опрашивать клавиатуру постоянно
+  static uint32_t tmr;
+  if (millis() - tmr >= 10) {
+    tmr = millis();
+    char key = pad.scan();
+    btn0.tick(key == '1');
+    btn1.tick(key == '2');
+  }
+
+  // забираем действия с кнопок
+  if (btn0.click()) Serial.println("click 0");
+  if (btn0.held()) Serial.println("held 0");
+
+  if (btn1.press()) Serial.println("press 1");
+  if (btn1.step()) Serial.println("step 1");
+}

examples/virtual_SimpleKeypad_array/virtual_SimpleKeypad_array.ino

@@ -0,0 +1,44 @@
+// пример работы в виртуальном режиме совместно с библиотекой SimpleKeypad
+// https://github.com/maximebohrer/SimpleKeypad
+// передаём EncButton сразу всю клавиатуру через массивы и циклы
+
+#include <EncButton.h>
+EncButton<EB_TICK, VIRT_BTN> btn[16];
+
+// пины подключения (по порядку штекера)
+byte colPins[] = {7, 6, 5, 4};
+byte rowPins[] = {11, 10, 9, 8};
+
+// массив имён кнопок
+char keys[4][4] = {
+  {'1', '2', '3', 'A'},
+  {'4', '5', '6', 'B'},
+  {'7', '8', '9', 'C'},
+  {'*', '0', '#', 'D'}
+};
+
+#include <SimpleKeypad.h>
+SimpleKeypad pad((char*)keys, rowPins, colPins, 4, 4);
+
+void setup() {
+  Serial.begin(9600);
+}
+
+void loop() {
+  // массово тикаем все кнопки, передавая сравнение с кодом кнопки в цикле
+  // делаем это по таймеру, чтобы не опрашивать клавиатуру постоянно
+  static uint32_t tmr;
+  if (millis() - tmr >= 10) {
+    tmr = millis();
+    char key = pad.scan();
+    char* keysPtr = (char*)keys;  // указатель для удобства опроса
+    for (int i = 0; i < 16; i++) btn[i].tick(key == keysPtr[i]);
+  }
+
+  // забираем действия с кнопок
+  if (btn[0].click()) Serial.println("click 0");
+  if (btn[0].held()) Serial.println("held 0");
+
+  if (btn[1].press()) Serial.println("press 1");
+  if (btn[1].step()) Serial.println("step 1");
+}

library.properties

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

src/EncButton.h

@@ -43,6 +43,7 @@
     v1.19 - оптимизация скорости, уменьшен вес в sram
     v1.19.1 - ещё чутка увеличена производительность
     v1.19.2 - ещё немного увеличена производительность, спасибо XRay3D
+    v1.19.3 - сделал высокий уровень кнопки по умолчанию в виртуальном режиме
 */
 
 #ifndef _EncButton_h
@@ -122,7 +123,7 @@ class EncButton {
     // можно указать режим работы пина
     EncButton(const uint8_t mode = INPUT_PULLUP) {
         if (_S1 < 252 && mode == INPUT_PULLUP) pullUp();
-        setButtonLevel(LOW);
+        setButtonLevel(_S1 < 252 ? LOW : HIGH);     // высокий уровень в виртуальном режиме
     }
 
     // подтянуть пины внутренней подтяжкой

src/EncButton2.h

@@ -77,7 +77,7 @@ class EncButton2 {
 public:
     // pinMode, pin1, pin2, pin3
     EncButton2(uint8_t mode = INPUT, uint8_t P1 = 255, uint8_t P2 = 255, uint8_t P3 = 255) {
-        setButtonLevel(LOW);
+        setButtonLevel(_S1 < 252 ? LOW : HIGH);     // высокий уровень в виртуальном режиме
         setPins(mode, P1, P2, P3);
     }