removed platformio.ini

added EZButton.h and .cpp
added library.json

Author: IPdotSetAF

include/EZButton.h

@@ -0,0 +1,46 @@
+#ifndef EZButton_H
+#define EZButton_H
+
+#include <Arduino.h>
+
+enum EventTypes
+{
+    PRESSED,
+    HOLD,
+    HOLD_RELEASE,
+    RELEASE
+};
+
+class EZButton
+{
+public:
+    ulong long HoldTreshHold;
+    ulong HoldInterval;
+
+    EZButton(const String buttonNames[],
+             bool *(*readButtons)(String *, int),
+             ulong holdTreshold = 500,
+             ulong holdInterval = 500);
+
+    ~EZButton();
+
+    void CheckButtons();
+    void Subscribe(String buttonName, void (*event)(), EventTypes type);
+
+private:
+    int _numButtons;
+    String *_buttons;
+
+    unsigned long *_buttonDownMillis;
+    unsigned int *_lastHoldInterval;
+    bool *_buttonLastState;
+
+    typedef void (*Event)(); // Type alias for function pointer
+    Event *_onPressedEvents;
+    Event *_onReleaseEvents;
+    Event *_onHoldReleaseEvents;
+    Event *_onHoldEvents;
+    bool *(*_readButtons)(String *, int);
+};
+
+#endif // EZButton_H

library.json

@@ -0,0 +1,26 @@
+{
+    "name": "EZButton",
+    "version": "1.0.0",
+    "description": "A Library for managing different button events. Events include: OnPressed, OnReleased, OnHold, OnHoldReleased.",
+    "keywords": "button, key, event, hold, press, release",
+    "repository":
+    {
+      "type": "git",
+      "url": "https://github.com/IPdotSetAF/EZButton.git"
+    },
+    "authors":
+    [
+      {
+        "name": "Mohammad Mahdi Nazari",
+        "email": "[email protected]",
+        "url": "https://www.ip-af.ir/contact",
+        "maintainer": true
+      }
+    ],
+    "license": "GPL-V3",
+    "homepage": "https://www.ip-af.ir/Projects/Electronics/EZButton",
+    "dependencies": {
+    },
+    "frameworks": "*",
+    "platforms": "*"
+  }

platformio.ini

@@ -0,0 +1,117 @@
+#include "EZButton.h"
+
+EZButton::EZButton(const String buttonNames[],
+                   bool *(*readButtons)(String *, int),
+                   ulong holdTreshold,
+                   ulong holdInterval)
+{
+    _numButtons = buttonNames->length() - 1;
+    HoldTreshHold = holdTreshold;
+    HoldInterval = holdInterval;
+    _readButtons = readButtons;
+    _buttons = new String[_numButtons];
+    _onPressedEvents = new Event[_numButtons];
+    _onReleaseEvents = new Event[_numButtons];
+    _onHoldReleaseEvents = new Event[_numButtons];
+    _onHoldEvents = new Event[_numButtons];
+    _buttonDownMillis = new unsigned long[_numButtons];
+    _buttonLastState = new bool[_numButtons];
+    _lastHoldInterval = new unsigned int[_numButtons];
+
+    for (int i = 0; i < _numButtons; i++)
+    {
+        _buttons[i] = buttonNames[i];
+        _onPressedEvents[i] = nullptr;
+        _onReleaseEvents[i] = nullptr;
+        _onHoldReleaseEvents[i] = nullptr;
+        _onHoldEvents[i] = nullptr;
+        _buttonDownMillis[i] = 0;
+        _buttonLastState[i] = false;
+        _lastHoldInterval[i] = 0;
+    }
+}
+
+EZButton::~EZButton()
+{
+    delete[] _buttons;
+    delete[] _buttonDownMillis;
+    delete[] _buttonLastState;
+    delete[] _lastHoldInterval;
+    delete[] _onPressedEvents;
+    delete[] _onReleaseEvents;
+    delete[] _onHoldEvents;
+    delete[] _onHoldReleaseEvents;
+}
+
+void EZButton::CheckButtons()
+{
+    bool *buttonStates = _readButtons(_buttons, _numButtons);
+
+    for (int i = 0; i < _numButtons; i++)
+    {
+        if (buttonStates[i])
+        {
+            if (!_buttonLastState[i])
+            {
+                _buttonDownMillis[i] = millis();
+                _buttonLastState[i] = 1;
+                if (_onPressedEvents[i] != nullptr)
+                    _onPressedEvents[i]();
+            }
+            else if (millis() - _buttonDownMillis[i] > HoldTreshHold)
+            {
+                int interval = (millis() - _buttonDownMillis[i]) / HoldInterval;
+                if (interval > _lastHoldInterval[i])
+                {
+                    _lastHoldInterval[i] = interval;
+                    if (_onHoldEvents[i] != nullptr)
+                        _onHoldEvents[i]();
+                }
+            }
+        }
+        else
+        {
+            if (_buttonLastState[i])
+            {
+                _buttonLastState[i] = 0;
+                _lastHoldInterval[i] = 0;
+                if (millis() - _buttonDownMillis[i] > HoldTreshHold)
+                {
+                    if (_onHoldReleaseEvents[i] != nullptr)
+                        _onHoldReleaseEvents[i]();
+                }
+                else
+                {
+                    if (_onReleaseEvents[i] != nullptr)
+                        _onReleaseEvents[i]();
+                }
+            }
+        }
+    }
+
+    delete[] buttonStates;
+}
+
+void EZButton::Subscribe(String buttonName, void (*event)(), EventTypes type)
+{
+    int i = 0;
+    for (; i < _numButtons; i++)
+        if (_buttons[i].equals(buttonName))
+            break;
+
+    switch (type)
+    {
+    case EventTypes::PRESSED:
+        _onPressedEvents[i] = event;
+        break;
+    case EventTypes::HOLD_RELEASE:
+        _onHoldReleaseEvents[i] = event;
+        break;
+    case EventTypes::RELEASE:
+        _onReleaseEvents[i] = event;
+        break;
+    case EventTypes::HOLD:
+        _onHoldEvents[i] = event;
+        break;
+    }
+}

src/EZButton.cpp

@@ -0,0 +1,2 @@
+
+This directory is intended for project source files.