Use a custom state class for addressable lights, to allow type system to discriminate between addressable and non-addressable lights. More...

#include <addressable_light.h>

Inheritance diagram for esphome::light::AddressableLightState:

Additional Inherited Members
Public Member Functions inherited from esphome::light::LightState
	LightState (LightOutput *output)

LightTraits	get_traits ()

LightCall	turn_on ()
	Make a light state call.

LightCall	turn_off ()

LightCall	toggle ()

LightCall	make_call ()

void	setup () override
	Load state from preferences.

void	dump_config () override

void	loop () override

float	get_setup_priority () const override
	Shortly after HARDWARE.

void	publish_state ()
	Publish the currently active state to the frontend.

LightOutput *	get_output () const
	Get the light output associated with this object.

std::string	get_effect_name ()
	Return the name of the current effect, or if no effect is active "None".

StringRef	get_effect_name_ref ()
	Return the name of the current effect as StringRef (for API usage)

void	add_new_remote_values_callback (std::function< void()> &&send_callback)
	This lets front-end components subscribe to light change events.

void	add_new_target_state_reached_callback (std::function< void()> &&send_callback)
	The callback is called once the state of current_values and remote_values are equal (when the transition is finished).

void	set_default_transition_length (uint32_t default_transition_length)
	Set the default transition length, i.e. the transition length when no transition is provided.

uint32_t	get_default_transition_length () const

void	set_flash_transition_length (uint32_t flash_transition_length)
	Set the flash transition length.

uint32_t	get_flash_transition_length () const

void	set_gamma_correct (float gamma_correct)
	Set the gamma correction factor.

float	get_gamma_correct () const

void	set_restore_mode (LightRestoreMode restore_mode)
	Set the restore mode of this light.

void	set_initial_state (const LightStateRTCState &initial_state)
	Set the initial state of this light.

bool	supports_effects ()
	Return whether the light has any effects that meet the trait requirements.

const FixedVector< LightEffect * > &	get_effects () const
	Get all effects for this light state.

void	add_effects (const std::initializer_list< LightEffect * > &effects)
	Add effects for this light state.

size_t	get_effect_count () const
	Get the total number of effects available for this light.

uint32_t	get_current_effect_index () const
	Get the currently active effect index (0 = no effect, 1+ = effect index).

uint32_t	get_effect_index (const std::string &effect_name) const
	Get effect index by name. Returns 0 if effect not found.

LightEffect *	get_effect_by_index (uint32_t index) const
	Get effect by index. Returns nullptr if index is invalid.

std::string	get_effect_name_by_index (uint32_t index) const
	Get effect name by index. Returns "None" for index 0, empty string for invalid index.

void	current_values_as_binary (bool *binary)
	The result of all the current_values_as_* methods have gamma correction applied.

void	current_values_as_brightness (float *brightness)

void	current_values_as_rgb (float red, float green, float *blue, bool color_interlock=false)

void	current_values_as_rgbw (float red, float green, float blue, float white, bool color_interlock=false)

void	current_values_as_rgbww (float red, float green, float blue, float cold_white, float *warm_white, bool constant_brightness=false)

void	current_values_as_rgbct (float red, float green, float blue, float color_temperature, float *white_brightness)

void	current_values_as_cwww (float cold_white, float warm_white, bool constant_brightness=false)

void	current_values_as_ct (float color_temperature, float white_brightness)

bool	is_transformer_active ()
	Indicator if a transformer (e.g.

Public Member Functions inherited from esphome::EntityBase
const StringRef &	get_name () const

void	set_name (const char *name)

bool	has_own_name () const

std::string	get_object_id () const

void	set_object_id (const char *object_id)

uint32_t	get_object_id_hash ()

bool	is_internal () const

void	set_internal (bool internal)

bool	is_disabled_by_default () const

void	set_disabled_by_default (bool disabled_by_default)

EntityCategory	get_entity_category () const

void	set_entity_category (EntityCategory entity_category)

ESPDEPRECATED("Use get_icon_ref() instead for better performance (avoids string copy). Will be removed in ESPHome 2026.5.0", "2025.11.0") std void	set_icon (const char *icon)

StringRef	get_icon_ref () const

uint32_t	get_device_id () const

void	set_device (Device *device)

bool	has_state () const

void	set_has_state (bool state)

uint32_t	get_preference_hash ()
	Get a unique hash for storing preferences/settings for this entity.

Public Member Functions inherited from esphome::Component
float	get_actual_setup_priority () const

void	set_setup_priority (float priority)

virtual float	get_loop_priority () const
	priority of loop().

void	call ()

virtual void	on_shutdown ()

virtual void	on_safe_shutdown ()

virtual bool	teardown ()
	Called during teardown to allow component to gracefully finish operations.

virtual void	on_powerdown ()
	Called after teardown is complete to power down hardware.

uint8_t	get_component_state () const

void	reset_to_construction_state ()
	Reset this component back to the construction state to allow setup to run again.

bool	is_in_loop_state () const
	Check if this component has completed setup and is in the loop state.

bool	is_idle () const
	Check if this component is idle.

virtual void	mark_failed ()
	Mark this component as failed.

void	mark_failed (const char *message)

void	disable_loop ()
	Disable this component's loop.

void	enable_loop ()
	Enable this component's loop.

void	enable_loop_soon_any_context ()
	Thread and ISR-safe version of enable_loop() that can be called from any context.

bool	is_failed () const

bool	is_ready () const

virtual bool	can_proceed ()

bool	status_has_warning () const

bool	status_has_error () const

void	status_set_warning (const char *message=nullptr)

void	status_set_warning (const LogString *message)

void	status_set_error (const char *message=nullptr)

void	status_clear_warning ()

void	status_clear_error ()

void	status_momentary_warning (const std::string &name, uint32_t length=5000)

void	status_momentary_error (const std::string &name, uint32_t length=5000)

bool	has_overridden_loop () const

void	set_component_source (const LogString *source)
	Set where this component was loaded from for some debug messages.

const LogString *	get_component_log_str () const
	Get the integration where this component was declared as a LogString for logging.

bool	should_warn_of_blocking (uint32_t blocking_time)

Data Fields inherited from esphome::light::LightState
LightColorValues	current_values
	The current values of the light as outputted to the light.

LightColorValues	remote_values
	The remote color values reported to the frontend.

Protected Member Functions inherited from esphome::light::LightState
void	start_effect_ (uint32_t effect_index)
	Internal method to start an effect with the given index.

LightEffect *	get_active_effect_ ()
	Internal method to get the currently active effect.

void	stop_effect_ ()
	Internal method to stop the current effect (if one is active).

void	start_transition_ (const LightColorValues &target, uint32_t length, bool set_remote_values)
	Internal method to start a transition to the target color with the given length.

void	start_flash_ (const LightColorValues &target, uint32_t length, bool set_remote_values)
	Internal method to start a flash for the specified amount of time.

void	set_immediately_ (const LightColorValues &target, bool set_remote_values)
	Internal method to set the color values to target immediately (with no transition).

void	save_remote_values_ ()
	Internal method to save the current remote_values to the preferences.

Protected Member Functions inherited from esphome::EntityBase
StringRef	get_object_id_ref_for_api_ () const

void	calc_object_id_ ()

bool	is_object_id_dynamic_ () const
	Check if the object_id is dynamic (changes with MAC suffix)

Protected Member Functions inherited from esphome::Component
virtual void	call_loop ()

virtual void	call_setup ()

virtual void	call_dump_config ()

void	set_component_state_ (uint8_t state)
	Helper to set component state (clears state bits and sets new state)

void	set_interval (const std::string &name, uint32_t interval, std::function< void()> &&f)
	Set an interval function with a unique name.

void	set_interval (const char *name, uint32_t interval, std::function< void()> &&f)
	Set an interval function with a const char* name.

void	set_interval (uint32_t interval, std::function< void()> &&f)

bool	cancel_interval (const std::string &name)
	Cancel an interval function.

bool	cancel_interval (const char *name)

void	set_retry (const std::string &name, uint32_t initial_wait_time, uint8_t max_attempts, std::function< RetryResult(uint8_t)> &&f, float backoff_increase_factor=1.0f)
	Set an retry function with a unique name.

void	set_retry (uint32_t initial_wait_time, uint8_t max_attempts, std::function< RetryResult(uint8_t)> &&f, float backoff_increase_factor=1.0f)

bool	cancel_retry (const std::string &name)
	Cancel a retry function.

void	set_timeout (const std::string &name, uint32_t timeout, std::function< void()> &&f)
	Set a timeout function with a unique name.

void	set_timeout (const char *name, uint32_t timeout, std::function< void()> &&f)
	Set a timeout function with a const char* name.

void	set_timeout (uint32_t timeout, std::function< void()> &&f)

bool	cancel_timeout (const std::string &name)
	Cancel a timeout function.

bool	cancel_timeout (const char *name)

void	defer (const std::string &name, std::function< void()> &&f)
	Defer a callback to the next loop() call.

void	defer (const char *name, std::function< void()> &&f)
	Defer a callback to the next loop() call with a const char* name.

void	defer (std::function< void()> &&f)
	Defer a callback to the next loop() call.

bool	cancel_defer (const std::string &name)
	Cancel a defer callback using the specified name, name must not be empty.

Protected Attributes inherited from esphome::light::LightState
friend	LightOutput

friend	LightCall

LightOutput *	output_
	Store the output to allow effects to have more access.

std::unique_ptr< LightTransformer >	transformer_ {nullptr}
	The currently active transformer for this light (transition/flash).

FixedVector< LightEffect * >	effects_
	List of effects for this light.

ESPPreferenceObject	rtc_
	Object used to store the persisted values of the light.

uint32_t	active_effect_index_ {}
	Value for storing the index of the currently active effect. 0 if no effect is active.

uint32_t	default_transition_length_ {}
	Default transition length for all transitions in ms.

uint32_t	flash_transition_length_ {}
	Transition length to use for flash transitions.

float	gamma_correct_ {}
	Gamma correction factor for the light.

bool	next_write_ {true}
	Whether the light value should be written in the next cycle.

bool	is_transformer_active_ = false

CallbackManager< void()>	remote_values_callback_ {}
	Callback to call when new values for the frontend are available.

CallbackManager< void()>	target_state_reached_callback_ {}
	Callback to call when the state of current_values and remote_values are equal This should be called once the state of current_values changed and equals the state of remote_values.

optional< LightStateRTCState >	initial_state_ {}
	Initial state of the light.

LightRestoreMode	restore_mode_
	Restore mode of the light.

Protected Attributes inherited from esphome::EntityBase
StringRef	name_

const char *	object_id_c_str_ {nullptr}

const char *	icon_c_str_ {nullptr}

uint32_t	object_id_hash_ {}

Device *	device_ {}

struct esphome::EntityBase::EntityFlags	flags_

Protected Attributes inherited from esphome::Component
const LogString *	component_source_ {nullptr}

uint16_t	warn_if_blocking_over_ {WARN_IF_BLOCKING_OVER_MS}
	Warn if blocked for this many ms (max 65.5s)

uint8_t	component_state_ {0x00}
	State of this component - each bit has a purpose: Bits 0-2: Component state (0x00=CONSTRUCTION, 0x01=SETUP, 0x02=LOOP, 0x03=FAILED, 0x04=LOOP_DONE) Bit 3: STATUS_LED_WARNING Bit 4: STATUS_LED_ERROR Bits 5-7: Unused - reserved for future expansion.

volatile bool	pending_enable_loop_ {false}
	ISR-safe flag for enable_loop_soon_any_context.

Detailed Description

Use a custom state class for addressable lights, to allow type system to discriminate between addressable and non-addressable lights.

Definition at line 25 of file addressable_light.h.

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

esphome/components/light/addressable_light.h

Additional Inherited Members

Detailed Description