#include <nextion_switch.h>

Inheritance diagram for esphome::nextion::NextionSwitch:

Public Member Functions
	NextionSwitch (NextionBase *nextion)

void	update () override

void	update_component () override

void	process_bool (const std::string &variable_name, bool on) override

void	set_state (bool state) override

void	set_state (bool state, bool publish) override

void	set_state (bool state, bool publish, bool send_to_nextion) override

void	send_state_to_nextion () override

NextionQueueType	get_queue_type () override

void	set_state_from_string (const std::string &state_value, bool publish, bool send_to_nextion) override

void	set_state_from_int (int state_value, bool publish, bool send_to_nextion) override

Public Member Functions inherited from esphome::nextion::NextionComponent
void	update_component_settings () override

void	update_component_settings (bool force_update) override

void	set_background_color (Color bco)

void	set_background_pressed_color (Color bco2)

void	set_foreground_color (Color pco)

void	set_foreground_pressed_color (Color pco2)

void	set_font_id (uint8_t font_id)

void	set_visible (bool visible)

Public Member Functions inherited from esphome::nextion::NextionComponentBase
virtual	~NextionComponentBase ()=default

void	set_variable_name (const std::string &variable_name, const std::string &variable_name_to_send="")

virtual void	process_sensor (const std::string &variable_name, int state)

virtual void	process_touch (uint8_t page_id, uint8_t component_id, bool on)

virtual void	process_text (const std::string &variable_name, const std::string &text_value)

virtual void	set_state (float state)

virtual void	set_state (float state, bool publish)

virtual void	set_state (float state, bool publish, bool send_to_nextion)

virtual void	set_state (const std::string &state)

virtual void	set_state (const std::string &state, bool publish)

virtual void	set_state (const std::string &state, bool publish, bool send_to_nextion)

uint8_t	get_component_id ()

void	set_component_id (uint8_t component_id)

uint8_t	get_wave_channel_id ()

void	set_wave_channel_id (uint8_t wave_chan_id)

std::vector< uint8_t >	get_wave_buffer ()

size_t	get_wave_buffer_size ()

void	clear_wave_buffer (size_t buffer_sent)

std::string	get_variable_name ()

std::string	get_variable_name_to_send ()

virtual std::string	get_queue_type_string ()

bool	get_needs_to_send_update ()

uint8_t	get_wave_chan_id ()

void	set_wave_max_length (int wave_max_length)

Public Member Functions inherited from esphome::switch_::Switch
	Switch ()

void	publish_state (bool state)
	Publish a state to the front-end from the back-end.

void	control (bool target_state)
	Control this switch using a boolean state value.

void	turn_on ()
	Turn this switch on.

void	turn_off ()
	Turn this switch off.

void	toggle ()
	Toggle this switch.

void	set_inverted (bool inverted)
	Set whether the state should be treated as inverted.

void	add_on_state_callback (std::function< void(bool)> &&callback)
	Set callback for state changes.

optional< bool >	get_initial_state ()
	Returns the initial state of the switch, as persisted previously, or empty if never persisted.

optional< bool >	get_initial_state_with_restore_mode ()
	Returns the initial state of the switch, after applying restore mode rules.

virtual bool	assumed_state ()
	Return whether this switch uses an assumed state - i.e.

bool	is_inverted () const

void	set_restore_mode (SwitchRestoreMode restore_mode)

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::EntityBase_DeviceClass
ESPDEPRECATED("Use get_device_class_ref() instead for better performance (avoids string copy). Will be removed in " "ESPHome 2026.5.0", "2025.11.0") std void	set_device_class (const char *device_class)
	Get the device class, using the manual override if set.

StringRef	get_device_class_ref () const
	Get the device class as StringRef.

Public Member Functions inherited from esphome::PollingComponent
	PollingComponent ()

	PollingComponent (uint32_t update_interval)
	Initialize this polling component with the given update interval in ms.

virtual void	set_update_interval (uint32_t update_interval)
	Manually set the update interval in ms for this polling object.

void	call_setup () override

virtual uint32_t	get_update_interval () const
	Get the update interval in ms of this sensor.

void	start_poller ()

void	stop_poller ()

Public Member Functions inherited from esphome::Component
virtual void	setup ()
	Where the component's initialization should happen.

virtual void	loop ()
	This method will be called repeatedly.

virtual void	dump_config ()

virtual float	get_setup_priority () const
	priority of setup().

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)

Protected Member Functions
void	write_state (bool state) override

Protected Member Functions inherited from esphome::nextion::NextionComponent
	NextionComponent ()
	Constructor initializes component state with visible=true (default state)

Protected Member Functions inherited from esphome::switch_::Switch
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_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.

Additional Inherited Members
Data Fields inherited from esphome::switch_::Switch
SwitchRestoreMode	restore_mode {SWITCH_RESTORE_DEFAULT_OFF}
	Indicates whether or not state is to be retrieved from flash and how.

bool	state
	The current reported state of the binary sensor.

Protected Attributes inherited from esphome::nextion::NextionComponent
NextionBase *	nextion_

Color	bco_

Color	bco2_

Color	pco_

Color	pco2_

uint8_t	font_id_ = 0

struct esphome::nextion::NextionComponent::ComponentState	component_flags_

Protected Attributes inherited from esphome::nextion::NextionComponentBase
std::string	variable_name_

std::string	variable_name_to_send_

uint8_t	component_id_ = 0

uint8_t	wave_chan_id_ = UINT8_MAX

std::vector< uint8_t >	wave_buffer_

int	wave_max_length_ = 255

bool	needs_to_send_update_

Protected Attributes inherited from esphome::switch_::Switch
ESPPreferenceObject	rtc_

CallbackManager< void(bool)>	state_callback_ {}

Deduplicator< bool >	publish_dedup_

bool	inverted_ {false}

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::EntityBase_DeviceClass
const char *	device_class_ {nullptr}
	Device class override.

Protected Attributes inherited from esphome::PollingComponent
uint32_t	update_interval_

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

Definition at line 11 of file nextion_switch.h.

Constructor & Destructor Documentation

◆ NextionSwitch()

esphome::nextion::NextionSwitch::NextionSwitch ( NextionBase * nextion )

inline

Definition at line 13 of file nextion_switch.h.

Member Function Documentation

◆ get_queue_type()

NextionQueueType esphome::nextion::NextionSwitch::get_queue_type ( )

inlineoverridevirtual

Reimplemented from esphome::nextion::NextionComponentBase.

Definition at line 24 of file nextion_switch.h.

◆ process_bool()

void esphome::nextion::NextionSwitch::process_bool	(	const std::string &	variable_name,
		bool	on )

overridevirtual

Reimplemented from esphome::nextion::NextionComponentBase.

Definition at line 10 of file nextion_switch.cpp.

◆ send_state_to_nextion()

void esphome::nextion::NextionSwitch::send_state_to_nextion ( )

inlineoverridevirtual

Reimplemented from esphome::nextion::NextionComponentBase.

Definition at line 23 of file nextion_switch.h.

◆ set_state() [1/3]

void esphome::nextion::NextionSwitch::set_state ( bool state )

inlineoverridevirtual

Reimplemented from esphome::nextion::NextionComponentBase.

Definition at line 19 of file nextion_switch.h.

◆ set_state() [2/3]

void esphome::nextion::NextionSwitch::set_state	(	bool	state,
		bool	publish )

inlineoverridevirtual

Reimplemented from esphome::nextion::NextionComponentBase.

Definition at line 20 of file nextion_switch.h.

◆ set_state() [3/3]

void esphome::nextion::NextionSwitch::set_state	(	bool	state,
		bool	publish,
		bool	send_to_nextion )

overridevirtual

Reimplemented from esphome::nextion::NextionComponentBase.

Definition at line 26 of file nextion_switch.cpp.

◆ set_state_from_int()

void esphome::nextion::NextionSwitch::set_state_from_int	(	int	state_value,
		bool	publish,
		bool	send_to_nextion )

inlineoverridevirtual

Reimplemented from esphome::nextion::NextionComponentBase.

Definition at line 26 of file nextion_switch.h.

◆ set_state_from_string()

void esphome::nextion::NextionSwitch::set_state_from_string	(	const std::string &	state_value,
		bool	publish,
		bool	send_to_nextion )

inlineoverridevirtual

Reimplemented from esphome::nextion::NextionComponentBase.

Definition at line 25 of file nextion_switch.h.

◆ update()

void esphome::nextion::NextionSwitch::update ( )

overridevirtual

Implements esphome::PollingComponent.

Definition at line 20 of file nextion_switch.cpp.

◆ update_component()

void esphome::nextion::NextionSwitch::update_component ( )

inlineoverridevirtual

Reimplemented from esphome::nextion::NextionComponentBase.

Definition at line 16 of file nextion_switch.h.

◆ write_state()

void esphome::nextion::NextionSwitch::write_state ( bool state )

overrideprotectedvirtual

Implements esphome::switch_::Switch.

Definition at line 49 of file nextion_switch.cpp.

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

esphome/components/nextion/switch/nextion_switch.h
esphome/components/nextion/switch/nextion_switch.cpp

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ NextionSwitch()

Member Function Documentation

◆ get_queue_type()

◆ process_bool()

◆ send_state_to_nextion()

◆ set_state() [1/3]

◆ set_state() [2/3]

◆ set_state() [3/3]

◆ set_state_from_int()

◆ set_state_from_string()

◆ update()

◆ update_component()

◆ write_state()