Inheritance diagram for Mycila::Dimmer:

Data Structures
struct	Metrics

Public Member Functions
virtual bool	begin ()
virtual void	end ()
virtual const char *	type () const
void	setDutyCycleLimit (float limit)
	Set the power duty cycle limit of the dimmer. The duty cycle will be clamped to this limit.
void	setDutyCycleMin (float min)
	Duty remapping (equivalent to Shelly Dimmer remapping feature). Useful to calibrate the dimmer when using for example a PWM signal to 0-10V analog convertor connected to a voltage regulator which is only working in a specific voltage range like 1-8V.
void	setDutyCycleMax (float max)
	Duty remapping (equivalent to Shelly Dimmer remapping feature). Useful to calibrate the dimmer when using for example a PWM signal to 0-10V analog convertor connected to a voltage regulator which is only working in a specific voltage range like 1-8V.
float	getDutyCycleLimit () const
	Get the power duty cycle limit of the dimmer.
float	getDutyCycleMin () const
	Get the remapped "0" of the dimmer duty cycle.
float	getDutyCycleMax () const
	Get the remapped "1" of the dimmer duty cycle.
bool	isEnabled () const
	Check if the dimmer is enabled (if it was able to initialize correctly).
virtual bool	isOnline () const
	Returns true if the dimmer is online.
void	setOnline (bool online)
	Set the online status of the dimmer.
void	on ()
	Turn on the dimmer at full power.
void	off ()
	Turn off the dimmer.
bool	isOff () const
	Check if the dimmer is off.
bool	isOn () const
	Check if the dimmer is on.
bool	isOnAtFullPower () const
	Check if the dimmer is on at full power.
virtual bool	setDutyCycle (float dutyCycle)
	Set the power duty.
float	getDutyCycle () const
	Get the power duty cycle configured for the dimmer by teh user.
float	getDutyCycleMapped () const
	Get the remapped power duty cycle from the currently user set duty cycle.
float	getDutyCycleFire () const
	Get the real firing duty cycle (conduction duty cycle) applied to the dimmer in the range [0, 1].
virtual float	getPowerRatio () const
bool	calculateHarmonics (float *array, size_t n) const
bool	calculateMetrics (Metrics &metrics, float gridVoltage, float loadResistance) const

Static Public Member Functions
static uint16_t	getSemiPeriod ()
	Get the semi-period in us used for the power LUT calculations. If LUT is disabled, returns 0.
static void	setSemiPeriod (uint16_t semiPeriod)
	Set the semi-period of the grid frequency in us for this dimmer. This is mandatory when using power LUT.

Protected Member Functions
virtual bool	_apply ()
virtual bool	_calculateDimmerHarmonics (float *array, size_t n) const

Static Protected Member Functions
static float	_contrain (float amt, float low, float high)

Protected Attributes
bool	_enabled = false
bool	_online = false
float	_dutyCycle = 0.0f
float	_dutyCycleFire = 0.0f
float	_dutyCycleLimit = 1.0f
float	_dutyCycleMin = 0.0f
float	_dutyCycleMax = 1.0f

Static Protected Attributes
static uint16_t	_semiPeriod = 0

Detailed Description

Definition at line 23 of file MycilaDimmer.h.

Constructor & Destructor Documentation

◆ ~Dimmer()

virtual Mycila::Dimmer::~Dimmer ( )

inlinevirtual

Definition at line 36 of file MycilaDimmer.h.

Member Function Documentation

◆ _apply()

virtual bool Mycila::Dimmer::_apply ( )

inlineprotectedvirtual

Definition at line 341 of file MycilaDimmer.h.

◆ _calculateDimmerHarmonics()

virtual bool Mycila::Dimmer::_calculateDimmerHarmonics	(	float *	array,
		size_t	n ) const

inlineprotectedvirtual

Definition at line 343 of file MycilaDimmer.h.

◆ _contrain()

float Mycila::Dimmer::_contrain	(	float	amt,
		float	low,
		float	high )

inlinestaticprotected

Definition at line 354 of file MycilaDimmer.h.

◆ begin()

virtual bool Mycila::Dimmer::begin ( )

inlinevirtual

Reimplemented in Mycila::CycleStealingDimmer, Mycila::DFRobotDimmer, Mycila::PWMDimmer, and Mycila::ThyristorDimmer.

Definition at line 38 of file MycilaDimmer.h.

◆ calculateHarmonics()

bool Mycila::Dimmer::calculateHarmonics	(	float *	array,
		size_t	n ) const

inline

Definition at line 222 of file MycilaDimmer.h.

◆ calculateMetrics()

bool Mycila::Dimmer::calculateMetrics	(	Metrics &	metrics,
		float	gridVoltage,
		float	loadResistance ) const

inline

Definition at line 252 of file MycilaDimmer.h.

◆ end()

virtual void Mycila::Dimmer::end ( )

inlinevirtual

Reimplemented in Mycila::CycleStealingDimmer, Mycila::DFRobotDimmer, Mycila::PWMDimmer, and Mycila::ThyristorDimmer.

Definition at line 42 of file MycilaDimmer.h.

◆ getDutyCycle()

float Mycila::Dimmer::getDutyCycle ( ) const

inline

Get the power duty cycle configured for the dimmer by teh user.

Definition at line 192 of file MycilaDimmer.h.

◆ getDutyCycleFire()

float Mycila::Dimmer::getDutyCycleFire ( ) const

inline

Get the real firing duty cycle (conduction duty cycle) applied to the dimmer in the range [0, 1].

At 0% power, the ratio is equal to 0.
At 100% power, the ratio is equal to 1.
Returns
The duty cycle applied on the hardware, or 0 if the dimmer is offline The firing ratio represents the actual proportion of time the dimmer is conducting power to the load within each AC cycle. It is computed based on the remapped duty cycle and eventually the power LUT if enabled.

Definition at line 207 of file MycilaDimmer.h.

◆ getDutyCycleLimit()

float Mycila::Dimmer::getDutyCycleLimit ( ) const

inline

Get the power duty cycle limit of the dimmer.

Definition at line 85 of file MycilaDimmer.h.

◆ getDutyCycleMapped()

float Mycila::Dimmer::getDutyCycleMapped ( ) const

inline

Get the remapped power duty cycle from the currently user set duty cycle.

Definition at line 197 of file MycilaDimmer.h.

◆ getDutyCycleMax()

float Mycila::Dimmer::getDutyCycleMax ( ) const

inline

Get the remapped "1" of the dimmer duty cycle.

Definition at line 95 of file MycilaDimmer.h.

◆ getDutyCycleMin()

float Mycila::Dimmer::getDutyCycleMin ( ) const

inline

Get the remapped "0" of the dimmer duty cycle.

Definition at line 90 of file MycilaDimmer.h.

◆ getPowerRatio()

virtual float Mycila::Dimmer::getPowerRatio ( ) const

inlinevirtual

Definition at line 213 of file MycilaDimmer.h.

◆ getSemiPeriod()

uint16_t Mycila::Dimmer::getSemiPeriod ( )

inlinestatic

Get the semi-period in us used for the power LUT calculations. If LUT is disabled, returns 0.

Definition at line 104 of file MycilaDimmer.h.

◆ isEnabled()

bool Mycila::Dimmer::isEnabled ( ) const

inline

Check if the dimmer is enabled (if it was able to initialize correctly).

Definition at line 120 of file MycilaDimmer.h.

◆ isOff()

bool Mycila::Dimmer::isOff ( ) const

inline

Check if the dimmer is off.

Definition at line 160 of file MycilaDimmer.h.

◆ isOn()

bool Mycila::Dimmer::isOn ( ) const

inline

Check if the dimmer is on.

Definition at line 165 of file MycilaDimmer.h.

◆ isOnAtFullPower()

bool Mycila::Dimmer::isOnAtFullPower ( ) const

inline

Check if the dimmer is on at full power.

Definition at line 170 of file MycilaDimmer.h.

◆ isOnline()

virtual bool Mycila::Dimmer::isOnline ( ) const

inlinevirtual

Returns true if the dimmer is online.

A dimmer is considered online if it is enabled, marked online

Reimplemented in Mycila::PhaseControlDimmer.

Definition at line 126 of file MycilaDimmer.h.

◆ off()

void Mycila::Dimmer::off ( )

inline

Turn off the dimmer.

Definition at line 155 of file MycilaDimmer.h.

◆ on()

void Mycila::Dimmer::on ( )

inline

Turn on the dimmer at full power.

Definition at line 150 of file MycilaDimmer.h.

◆ setDutyCycle()

virtual bool Mycila::Dimmer::setDutyCycle ( float dutyCycle )

inlinevirtual

Set the power duty.

Parameters

dutyCycle the power duty cycle in the range [0.0, 1.0]

Reimplemented in Mycila::PhaseControlDimmer.

Definition at line 177 of file MycilaDimmer.h.

◆ setDutyCycleLimit()

void Mycila::Dimmer::setDutyCycleLimit ( float limit )

inline

Set the power duty cycle limit of the dimmer. The duty cycle will be clamped to this limit.

Parameters

limit the power duty cycle limit in the range [0.0, 1.0]

Definition at line 54 of file MycilaDimmer.h.

◆ setDutyCycleMax()

void Mycila::Dimmer::setDutyCycleMax ( float max )

inline

Duty remapping (equivalent to Shelly Dimmer remapping feature). Useful to calibrate the dimmer when using for example a PWM signal to 0-10V analog convertor connected to a voltage regulator which is only working in a specific voltage range like 1-8V.

Parameters

max	Set the new "1" value for the power duty cycle. The duty cycle in the range [0.0, 1.0] will be remapped to [min, max].

Definition at line 77 of file MycilaDimmer.h.

◆ setDutyCycleMin()

void Mycila::Dimmer::setDutyCycleMin ( float min )

inline

Duty remapping (equivalent to Shelly Dimmer remapping feature). Useful to calibrate the dimmer when using for example a PWM signal to 0-10V analog convertor connected to a voltage regulator which is only working in a specific voltage range like 1-8V.

Parameters

min	Set the new "0" value for the power duty cycle. The duty cycle in the range [0.0, 1.0] will be remapped to [min, max].

Definition at line 66 of file MycilaDimmer.h.

◆ setOnline()

void Mycila::Dimmer::setOnline ( bool online )

inline

Set the online status of the dimmer.

This flag can be used to temporarily disable the dimmer when not connected to the grid

Definition at line 132 of file MycilaDimmer.h.

◆ setSemiPeriod()

void Mycila::Dimmer::setSemiPeriod ( uint16_t semiPeriod )

inlinestatic

Set the semi-period of the grid frequency in us for this dimmer. This is mandatory when using power LUT.

Typical values are 10000 for 50Hz and 8333 for 60Hz.

The value can also come from MycilaPulseAnalyzer

Definition at line 111 of file MycilaDimmer.h.

◆ type()

virtual const char * Mycila::Dimmer::type ( ) const

inlinevirtual

Definition at line 43 of file MycilaDimmer.h.

Field Documentation

◆ _dutyCycle

float Mycila::Dimmer::_dutyCycle = 0.0f

protected

Definition at line 333 of file MycilaDimmer.h.

◆ _dutyCycleFire

float Mycila::Dimmer::_dutyCycleFire = 0.0f

protected

Definition at line 334 of file MycilaDimmer.h.

◆ _dutyCycleLimit

float Mycila::Dimmer::_dutyCycleLimit = 1.0f

protected

Definition at line 335 of file MycilaDimmer.h.

◆ _dutyCycleMax

float Mycila::Dimmer::_dutyCycleMax = 1.0f

protected

Definition at line 337 of file MycilaDimmer.h.

◆ _dutyCycleMin

float Mycila::Dimmer::_dutyCycleMin = 0.0f

protected

Definition at line 336 of file MycilaDimmer.h.

◆ _enabled

bool Mycila::Dimmer::_enabled = false

protected

Definition at line 330 of file MycilaDimmer.h.

◆ _online

bool Mycila::Dimmer::_online = false

protected

Definition at line 331 of file MycilaDimmer.h.

◆ _semiPeriod

uint16_t Mycila::Dimmer::_semiPeriod = 0

staticprotected

Definition at line 339 of file MycilaDimmer.h.

The documentation for this class was generated from the following files:

src/MycilaDimmer.h
src/MycilaDimmer.cpp

Data Structures

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ ~Dimmer()

Member Function Documentation

◆ _apply()

◆ _calculateDimmerHarmonics()

◆ _contrain()

◆ begin()

◆ calculateHarmonics()

◆ calculateMetrics()

◆ end()

◆ getDutyCycle()

◆ getDutyCycleFire()

◆ getDutyCycleLimit()

◆ getDutyCycleMapped()

◆ getDutyCycleMax()

◆ getDutyCycleMin()

◆ getPowerRatio()

◆ getSemiPeriod()

◆ isEnabled()

◆ isOff()

◆ isOn()

◆ isOnAtFullPower()

◆ isOnline()

◆ off()

◆ on()

◆ setDutyCycle()

◆ setDutyCycleLimit()

◆ setDutyCycleMax()

◆ setDutyCycleMin()

◆ setOnline()

◆ setSemiPeriod()

◆ type()

Field Documentation

◆ _dutyCycle

◆ _dutyCycleFire

◆ _dutyCycleLimit

◆ _dutyCycleMax

◆ _dutyCycleMin

◆ _enabled

◆ _online

◆ _semiPeriod