MycilaDimmerCycleStealing.h

// SPDX-License-Identifier: MIT
/*
 * Copyright (C) 2023-2025 Mathieu Carbou
 */
#pragma once
 
#include "MycilaDimmer.h"
#include <driver/gptimer_types.h>
 
namespace Mycila {
  class CycleStealingDimmer : public Dimmer {
    public:
      virtual ~CycleStealingDimmer() { end(); }

      void setPin(gpio_num_t pin) { _pin = pin; }

      gpio_num_t getPin() const { return _pin; }

      void setSemiPeriod(uint16_t semiPeriod) {
        if (semiPeriod == 0) {
          ESP_LOGE("CycleStealing", "setSemiPeriod: semiPeriod must be > 0");
        }
        assert(semiPeriod > 0);
        _semiPeriod = semiPeriod;
      }

      uint16_t getSemiPeriod() const { return _semiPeriod; }

      void begin() override;

      void end() override;
 
      const char* type() const override { return "cycle-stealing"; }
 
      bool calculateMetrics(Metrics& metrics, float gridVoltage, float loadResistance) const override {
        // return isEnabled() && _calculatePhaseControlMetrics(metrics, _dutyCycleFire, gridVoltage, loadResistance);
        return isEnabled();
      }

      static void onZeroCross(int16_t delayUntilZero, void* args);
 
#ifdef MYCILA_JSON_SUPPORT
      void toJson(const JsonObject& root) const override {
        Dimmer::toJson(root);
        root["dimmer_pin"] = _pin;
        root["dimmer_semi_period"] = _semiPeriod;
      }
#endif
 
    protected:
      bool _apply() override;
 
      bool _calculateHarmonics(float* array, size_t n) const override {
        for (size_t i = 0; i < n; i++) {
          array[i] = 0.0f;
        }
        return true;
      }
 
    private:
      gpio_num_t _pin = GPIO_NUM_NC;
      bool _running = false;
 
      static bool _fireTimerISR(gptimer_handle_t timer, const gptimer_alarm_event_data_t* event, void* arg);
      static void _registerDimmer(Mycila::CycleStealingDimmer* dimmer);
      static void _unregisterDimmer(Mycila::CycleStealingDimmer* dimmer);
  };
} // namespace Mycila