hbridge_light_output.h

Go to the documentation of this file.

#pragma once
 
#include "esphome/components/light/light_output.h"
#include "esphome/components/output/float_output.h"
#include "esphome/core/component.h"
 
namespace esphome::hbridge {
 
class HBridgeLightOutput final : public PollingComponent, public light::LightOutput {
 public:
  void set_pina_pin(output::FloatOutput *pina_pin) { this->pina_pin_ = pina_pin; }
  void set_pinb_pin(output::FloatOutput *pinb_pin) { this->pinb_pin_ = pinb_pin; }
 
  light::LightTraits get_traits() override {
    auto traits = light::LightTraits();
    traits.set_supported_color_modes({light::ColorMode::COLD_WARM_WHITE});
    traits.set_min_mireds(153);
    traits.set_max_mireds(500);
    return traits;
  }
 
  void setup() override { this->stop_poller(); }
 
  void update() override {
    // Flip the H-bridge direction to multiplex cold/warm white. update_interval must stay
    // slower than the output's PWM period (flipping faster collapses the output onto one
    // channel) but fast enough to avoid flicker (issue #17030).
    if (!this->forward_direction_) {
      this->pina_pin_->set_level(this->pina_duty_);
      this->pinb_pin_->set_level(0);
      this->forward_direction_ = true;
    } else {
      this->pina_pin_->set_level(0);
      this->pinb_pin_->set_level(this->pinb_duty_);
      this->forward_direction_ = false;
    }
  }
 
  float get_setup_priority() const override { return setup_priority::HARDWARE; }
 
  void write_state(light::LightState *state) override {
    float new_pina, new_pinb;
    state->current_values_as_cwww(&new_pina, &new_pinb, false);
 
    this->pina_duty_ = new_pina;
    this->pinb_duty_ = new_pinb;
 
    if (new_pina != 0.0f && new_pinb != 0.0f) {
      // Both channels active — multiplex the H-bridge direction via the poller.
      if (!this->multiplexing_) {
        this->multiplexing_ = true;
        this->start_poller();
      }
    } else {
      // Zero or one channel active — drive pins directly, no multiplexing needed.
      if (this->multiplexing_) {
        this->multiplexing_ = false;
        this->stop_poller();
      }
      this->pina_pin_->set_level(new_pina);
      this->pinb_pin_->set_level(new_pinb);
    }
  }
 
 protected:
  output::FloatOutput *pina_pin_;
  output::FloatOutput *pinb_pin_;
  float pina_duty_{0};
  float pinb_duty_{0};
  bool forward_direction_{false};
  bool multiplexing_{false};
};
 
}  // namespace esphome::hbridge