AudioActions.h

#pragma once
#include "AudioBasic/Collections/Vector.h"
#include "AudioTools/AudioLogger.h"
 
#ifndef TOUCH_LIMIT
#define TOUCH_LIMIT 20
#endif
 
#ifndef DEBOUNCE_DELAY
#define DEBOUNCE_DELAY 500
#endif
 
#if defined(IS_MIN_DESKTOP)
extern "C" void pinMode(int, int);
extern "C" int digitalRead(int);
#endif
 
namespace audio_tools {
 
// global reference to access from static callback methods
class AudioActions;
static AudioActions *selfAudioActions = nullptr;
 
class AudioActions {
public:
  enum ActiveLogic : uint8_t {
    ActiveLow,
    ActiveHigh,
    ActiveChange,
    ActiveTouch
  };
 
  struct Action {
    int16_t pin = -1;
    void (*actionOn)(bool pinStatus, int pin, void *ref) = nullptr;
    void (*actionOff)(bool pinStatus, int pin, void *ref) = nullptr;
    void *ref = nullptr;
    unsigned long debounceTimeout = 0;
    ActiveLogic activeLogic;
    bool lastState = true;
    bool enabled = true;
 
    int debounceDelayValue = DEBOUNCE_DELAY;
    int touchLimit = TOUCH_LIMIT;
 
    bool readValue() {
#ifdef USE_TOUCH_READ
      bool result;
      if (this->activeLogic == ActiveTouch) {
        int value = touchRead(this->pin);
        result = value <= touchLimit;
        if (result) {
          // retry to confirm reading
          value = touchRead(this->pin);
          result = value <= touchLimit;
          LOGI("touch pin: %d value %d (limit: %d) -> %s", this->pin, value,
               touchLimit, result ? "true" : "false");
        }
      } else {
        result = digitalRead(this->pin);
      }
      return result;
#else
      return digitalRead(this->pin);
#endif
    }
 
    void process() {
      if (this->enabled) {
        bool value = readValue();
        if (this->actionOn != nullptr && this->actionOff != nullptr) {
          // we have on and off action defined
          if (value != this->lastState) {
            //LOGI("processActions: case with on and off");
            // execute action -> reports active instead of pin state
            if ((value && this->activeLogic == ActiveHigh) ||
                (!value && this->activeLogic == ActiveLow)) {
              this->actionOn(true, this->pin, this->ref);
            } else {
              this->actionOff(false, this->pin, this->ref);
            }
            this->lastState = value;
          }
        } else if (this->activeLogic == ActiveChange) {
          bool active = value;
          // reports pin state
          if (value != this->lastState && millis() > this->debounceTimeout) {
            //LOGI("processActions: ActiveChange");
            //  execute action
            this->actionOn(active, this->pin, this->ref);
            this->lastState = value;
            this->debounceTimeout = millis() + debounceDelayValue;
          }
        } else {
          bool active = (this->activeLogic == ActiveLow) ? !value : value;
          if (active &&
              (active != this->lastState || millis() > this->debounceTimeout)) {
            // LOGI("processActions: %d Active %d - %d", this->pin, value,
            //  execute action
            this->actionOn(active, this->pin, this->ref);
            this->lastState = active;
            this->debounceTimeout = millis() + debounceDelayValue;
          }
        }
      }
    }
  };
 
  AudioActions(bool useInterrupt = false) {
    selfAudioActions = this;
    setUsePinInterrupt(useInterrupt);
  }
 
  void add(int pin, void (*actionOn)(bool pinStatus, int pin, void *ref),
           ActiveLogic activeLogic = ActiveLow, void *ref = nullptr) {
    add(pin, actionOn, nullptr, activeLogic, ref);
  }
 
  void add(int pin, void (*actionOn)(bool pinStatus, int pin, void *ref),
           void (*actionOff)(bool pinStatus, int pin, void *ref),
           ActiveLogic activeLogicPar = ActiveLow, void *ref = nullptr) {
    LOGI("ActionLogic::add pin: %d / logic: %d", pin, activeLogicPar);
    if (pin >= 0) {
      // setup pin mode
      setupPin(pin, activeLogicPar);
 
      Action *p_action = findAction(pin);
      if (p_action) {
        // replace value
        p_action->actionOn = actionOn;
        p_action->actionOff = actionOff;
        p_action->activeLogic = activeLogicPar;
        p_action->ref = ref;
      } else {
        // add value
        Action action;
        action.pin = pin;
        action.actionOn = actionOn;
        action.actionOff = actionOff;
        action.activeLogic = activeLogicPar;
        action.ref = ref;
 
        action.debounceDelayValue = debounceDelayValue;
        action.touchLimit = touchLimit;
 
        actions.push_back(action);
      }
    } else {
      LOGW("pin %d -> Ignored", pin);
    }
  }
 
  void setEnabled(int pin, bool enabled) {
    Action *p_action = findAction(pin);
    if (p_action) {
      p_action->enabled = enabled;
    }
  }
 
  void processActions() {
    static int pos = 0;
    if (actions.empty())
      return;
    // execute action
    actions[pos].process();
    pos++;
    if (pos >= actions.size()) {
      pos = 0;
    }
  }
 
  void processAllActions() {
    for (Action &action : actions) {
      action.process();
    }
  }
 
  Action *findAction(int pin) {
    for (Action &action : actions) {
      if (action.pin == pin) {
        return &action;
      }
    }
    return nullptr;
  }
 
  void setDebounceDelay(int value) { debounceDelayValue = value; }
  void setTouchLimit(int value) { touchLimit = value; }
  void setUsePinInterrupt(bool active) { use_pin_interrupt = active; }
  void setPinMode(bool active) { use_pin_mode = active; }
 
protected:
  int debounceDelayValue = DEBOUNCE_DELAY;
  int touchLimit = TOUCH_LIMIT;
  bool use_pin_interrupt = false;
  bool use_pin_mode = true;
 
  Vector<Action> actions{0};
 
  static void audioActionsISR() { selfAudioActions->processAllActions(); }
 
  void setupPin(int pin, ActiveLogic logic) {
    // in the audio-driver library the pins are already set up
    if (use_pin_mode) {
      if (logic == ActiveLow) {
        pinMode(pin, INPUT_PULLUP);
        LOGI("pin %d -> INPUT_PULLUP", pin);
      } else {
        pinMode(pin, INPUT);
        LOGI("pin %d -> INPUT", pin);
      }
    }
 
#if !defined(IS_MIN_DESKTOP)
    if (use_pin_interrupt) {
      attachInterrupt(digitalPinToInterrupt(pin), audioActionsISR, CHANGE);
    }
#endif
  }
};
 
} // namespace audio_tools