MycilaDimmerBurstFire.h

// SPDX-License-Identifier: MIT
/*
 * Copyright (C) 2023-2025 Mathieu Carbou
 */
#pragma once
 
#include "MycilaDimmer.h"
#include <driver/gptimer_types.h>
 
namespace Mycila {
  class BurstFireDimmer : public Dimmer {
    public:
      virtual ~BurstFireDimmer() { 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("MycilaDimmerBurstFire", "setSemiPeriod: semiPeriod must be > 0");
        }
        assert(semiPeriod > 0);
        _semiPeriod = semiPeriod;
      }

      uint16_t getSemiPeriod() const { return _semiPeriod; }

      virtual void begin();

      virtual void end();
 
      virtual const char* type() const { return "burst-fire"; }

      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:
      virtual bool _apply() {
        // if (!_online || !_semiPeriod || _dutyCycleFire == 0) {
        //   _delay = UINT16_MAX;
        //   return _enabled;
        // }
        // if (_dutyCycleFire == 1) {
        //   _delay = 0;
        //   return _enabled;
        // }
        // _delay = (1.0f - _dutyCycleFire) * static_cast<float>(_semiPeriod);
        return _enabled;
      }
 
    private:
      gpio_num_t _pin = GPIO_NUM_NC;
 
      static bool _fireTimerISR(gptimer_handle_t timer, const gptimer_alarm_event_data_t* event, void* arg);
      static void _registerDimmer(Mycila::BurstFireDimmer* dimmer);
      static void _unregisterDimmer(Mycila::BurstFireDimmer* dimmer);
  };
} // namespace Mycila