upd

Author: GyverLibs

README.md

@@ -108,7 +108,12 @@ EncButton2<EB_ENC, EB_CALLBACK> enc[количество];
 EncButton2<EB_BTN, EB_CALLBACK> enc[количество];
 // и так далее
 
-// ПИНЫ НАСТРАИВАЮТСЯ ПРИ ПОМОЩИ setPins(uint8_t mode, uint8_t P1, uint8_t P2, uint8_t P3);
+// ПИНЫ НАСТРАИВАЮТСЯ ПРИ ПОМОЩИ setPins(mode, P1, P2, P3);
+// mode - INPUT/INPUT_PULLUP (для всех пинов)
+// указываем только нужные для выбранного режима пины:
+// EB_ENCBTN - A, B, KEY
+// EB_ENC - A, B
+// EB_BTN - KEY
 // см. пример EucButton2_array
 ```
 
@@ -125,18 +130,24 @@ void setButtonLevel(bool level);    // уровень кнопки: LOW - кно
 
 // ================= TICK ================
 // тикер, вызывать как можно чаще или в прерывании
-// вернёт отличное от нуля значение, если произошло какое то событие
+// вернёт отличное от нуля значение, если произошло какое то событие (см. пример optimisation)
 uint8_t tick();
 
 // tick(uint8_t s1 = 0, uint8_t s2 = 0, uint8_t key = 0)
-// может принимать виртуальный сигнал при режиме VIRT_:
+// может принимать виртуальный сигнал при режиме VIRT_xxx:
 // (сигнал кнопки)
 // (сигнал энкодера А, сигнал энкодера B)
 // (сигнал энкодера А, сигнал энкодера B, сигнал кнопки)
 
-uint8_t tickISR();      // тикер для прерывания при режиме callback. Не вызывает подключенные функции
-void checkCallback();   // проверяет и вызывает подключенные функции для режима callback
+// Тикер для прерывания в режиме callback. Не вызывает подключенные функции!
+// Требует наличие обычного tick() в loop() (см. примеры tickISR и callbackISR)
+uint8_t tickISR();
 
+// проверяет и вызывает подключенные функции для режима callback
+// Встроено в tick(), но вынесено отдельной функцией для нестандартных сценариев работы
+void checkCallback();
+
+// =============== STATUS ================
 uint8_t getState();     // получить статус
 void resetState();      // сбросить статус
 
@@ -186,14 +197,17 @@ PRESS_HANDLER
 RELEASE_HANDLER
 
 // =============== DEFINES ===============
-// дефайны настроек (дефайнить ПЕРЕД ПОДКЛЮЧЕНИЕМ БИБЛИОТЕКИ)
-// показаны значения по умолчанию
-//#define EB_FAST 30     // таймаут быстрого поворота, мс
-//#define EB_DEB 50      // дебаунс кнопки, мс
-//#define EB_STEP 500    // период срабатывания степ, мс
-//#define EB_CLICK 400   // таймаут накликивания, мс
-//#define EB_HOLD 1000   // таймаут удержания кнопки (устанавливает значение по умолчанию), мс
-//#define EB_BETTER_ENC  // улучшенный алгоритм опроса энкодера. Добавит 16 байт SRAM при подключении библиотеки
+// дефайны настроек (дефайнить ПЕРЕД ПОДКЛЮЧЕНИЕМ БИБЛИОТЕКИ), показаны значения по умолчанию
+// энк
+#define EB_FAST 30      // таймаут быстрого поворота, мс
+#define EB_BETTER_ENC   // улучшенный алгоритм опроса энкодера. Добавит 16 байт SRAM при подключении библиотеки
+#define EB_HALFSTEP_ENC // режим опроса полушагового энкодера (включи если твой энкодер делает два тика за один)
+
+// кнопка
+#define EB_DEB 50       // дебаунс кнопки, мс
+#define EB_STEP 500     // период срабатывания степ, мс
+#define EB_CLICK 400    // таймаут накликивания, мс
+#define EB_HOLD 1000    // таймаут удержания кнопки (можно переназначить setHoldTimeout() из программы), мс
 ```
 ### Дополнительно EncButton2
 ```cpp
@@ -202,11 +216,12 @@ void pullUp();          // здесь не реализована!
 ```
 
 ### Особенности
-- Библиотека универсальная, но сделана с упором на оптимизацию памяти при работе во всех режимах внутри одного класса
+- Библиотека универсальная, но сделана с упором на максимальную оптимизацию памяти при работе во всех режимах внутри одного класса, поэтому используется шаблон и дефайны
     - При создании объекта с разным количеством пинов (энкодер, кнопка, энкодер с кнопкой) библиотека будет компилироваться по разному, ненужный код будет вырезан. Это позволяет экономить Flash память.
     - То же самое касается режимов работы TICK/CALLBACK, при использовании TICK весь относящийся к CALLBACK код вырезается компилятором
 - Два алгоритма опроса энкодера, обычный и точный. Точный использует на 16 байт больше SRAM памяти (на всю библиотеку), но позволяет работать даже с низкокачественными и убитыми энкодерами
     - Точный алгоритм активируется добавлением `#define EB_BETTER_ENC` перед подключением библиотеки
+- Версия библиотеки *EncButton2.h* хранит номера пинов в классе. Используйте эту версию для создания массива объектов EncButton!
 
 <a id="example"></a>
 ## Примеры
@@ -325,6 +340,7 @@ void loop() {
 - v1.13 - добавлен экспериментальный EncButton2
 - v1.14 - добавлена releaseStep(). Отпускание кнопки внесено в дебаунс
 - v1.15 - добавлен setPins() для EncButton2
+- v1.16 - добавлен режим EB_HALFSTEP_ENC для полушаговых энкодеров
 
 <a id="feedback"></a>
 ## Баги и обратная связь

examples/EucButton2/EucButton2.ino renamed to examples/EncButton2/EncButton2.ino

@@ -15,6 +15,7 @@ EB_STEP	KEYWORD1
 EB_CLICK	KEYWORD1
 
 EB_BETTER_ENC	KEYWORD1
+EB_HALFSTEP_ENC	KEYWORD1
 
 #######################################
 # Methods and Functions (KEYWORD2)

examples/EucButton2_array/EucButton2_array.ino renamed to examples/EncButton2_array/EncButton2_array.ino

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

examples/isr/isr.ino renamed to examples/tickISR/tickISR.ino

@@ -35,6 +35,7 @@
     v1.13 - добавлен экспериментальный EncButton2
     v1.14 - добавлена releaseStep(). Отпускание кнопки внесено в дебаунс
     v1.15 - добавлен setPins() для EncButton2
+    v1.16 - добавлен режим EB_HALFSTEP_ENC для полушаговых энкодеров
 */
 
 #ifndef _EncButton_h
@@ -299,7 +300,12 @@ class EncButton {
         if (_prev != state) {
             _ecount += _EB_DIR[state | (_prev << 2)];                   // сдвиг внутреннего счётчика
             _prev = state;
+            #ifdef EB_HALFSTEP_ENC                                      // полушаговый энкодер
+            // спасибо https://github.com/GyverLibs/EncButton/issues/10#issue-1092009489
+            if ((state == 0x3 || state == 0x0) && _ecount != 0) {
+            #else                                                       // полношаговый
             if (state == 0x3 && _ecount != 0) {                         // защёлкнули позицию
+            #endif
                 EBState = (_ecount < 0) ? 1 : 2;
                 _ecount = 0;
                 if (_S2 == EB_NO_PIN || _KEY != EB_NO_PIN) {            // энкодер с кнопкой

keywords.txt

@@ -263,7 +263,12 @@ class EncButton2 {
         if (_prev != state) {
             _ecount += _EB_DIR[state | (_prev << 2)];                   // сдвиг внутреннего счётчика
             _prev = state;
+            #ifdef EB_HALFSTEP_ENC                                      // полушаговый энкодер
+            // спасибо https://github.com/GyverLibs/EncButton/issues/10#issue-1092009489
+            if ((state == 0x3 || state == 0x0) && _ecount != 0) {
+            #else                                                       // полношаговый
             if (state == 0x3 && _ecount != 0) {                         // защёлкнули позицию
+            #endif
                 EBState = (_ecount < 0) ? 1 : 2;
                 _ecount = 0;
                 if (_EB_TYPE == EB_ENCBTN || _EB_TYPE == VIRT_ENCBTN) { // энкодер с кнопкой