ESPHome 2026.11.0-dev
Loading...
Searching...
No Matches
esphome::modbus_controller::ModbusSwitch Class Referencefinal

#include <modbus_switch.h>

Inheritance diagram for esphome::modbus_controller::ModbusSwitch:
esphome::Component esphome::switch_::Switch esphome::modbus_controller::SensorItem esphome::modbus_controller::WriterEntity esphome::EntityBase

Public Types

using transform_func_t = optional<bool> (*)(ModbusSwitch *, bool, std::span<const uint8_t>)
 
using write_transform_func_t = optional<bool> (*)(ModbusSwitch *, bool, modbus::helpers::PduBuffer &)
 

Public Member Functions

 ModbusSwitch (modbus::EntityType register_type, uint16_t start_address, uint8_t offset, uint32_t bitmask, RangeReuse reuse_previous_range)
 
void setup () override
 
void write_state (bool state) override
 
void dump_config () override
 
void set_assumed_state (bool assumed_state)
 
void set_state (bool state)
 
void parse_and_publish (std::span< const uint8_t > data) override
 
void set_parent (ModbusController *parent)
 
void set_template (transform_func_t f)
 
void set_write_template (write_transform_func_t f)
 
void set_use_write_mutiple (bool use_write_multiple)
 
- Public Member Functions inherited from esphome::Component
virtual void loop ()
 This method will be called repeatedly.
 
virtual float get_setup_priority () const
 priority of setup().
 
float get_actual_setup_priority () const
 
void set_setup_priority (float priority)
 
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.
 
void mark_failed ()
 Mark this component as failed.
 
void mark_failed (const LogString *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 ()
 
void status_set_warning (const char *message)
 
void status_set_warning (const LogString *message)
 
bool status_comm_result (bool ok)
 Clears the warning when ok, else sets it with message (default "Communication failed"); returns ok.
 
bool status_comm_result (bool ok, const LogString *message)
 
void status_set_error ()
 
void status_set_error (const LogString *message)
 
void status_clear_warning ()
 
void status_clear_error ()
 
 ESPDEPRECATED ("Use status_momentary_warning() without a name. Removed in 2027.5.0", "2026.11.0") void status_momentary_warning(const char *name
 
void status_momentary_warning (uint32_t length=5000)
 Set warning status flag and clear it after length ms.
 
void status_momentary_warning (const LogString *message, uint32_t length=5000)
 
 ESPDEPRECATED ("Use status_momentary_error() without a name. Removed in 2027.5.0", "2026.11.0") void status_momentary_error(const char *name
 
void status_momentary_error (uint32_t length=5000)
 Set error status flag and clear it after length ms.
 
void status_momentary_error (const LogString *message, uint32_t length=5000)
 
bool has_overridden_loop () const
 
const LogString * get_component_log_str () const ESPHOME_ALWAYS_INLINE
 Get the integration where this component was declared as a LogString for logging.
 
bool should_warn_of_blocking (uint32_t blocking_time, uint32_t &threshold_ms_out)
 
- 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.
 
template<typename F >
void add_on_state_callback (F &&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.
 
void restore ()
 Drive the switch to the state its restore mode yields, through control(), so inversion and write_state() apply; a disabled restore mode drives when_disabled, or nothing without one.
 
void restore (bool when_disabled)
 
bool is_inverted () const
 
void set_restore_mode (SwitchRestoreMode restore_mode)
 
- Public Member Functions inherited from esphome::EntityBase
 ESPDEPRECATED ("Use get_name_to() or get_log_name() instead. Will be removed in ESPHome 2027.5.0", "2026.11.0") const StringRef &get_name() const
 The name is in flash here; the first call makes a RAM copy that is kept for the life of the device.
 
StringRef get_name_to (std::span< char, ENTITY_NAME_BUF_SIZE > buffer) const
 Get the name of this Entity, copied out of flash into buffer.
 
 ESPDEPRECATED ("Use get_name_to() or get_log_name() instead. Will be removed in ESPHome 2027.5.0", "2026.11.0") const StringRef &get_name() const
 
const StringRef & get_name_to (std::span< char, ENTITY_NAME_BUF_SIZE >) const
 
bool name_equals (const StringRef &other) const
 
const ProgmemStringRef & get_name_progmem () const
 The name as stored, for consumers that read flash themselves (e.g. API progmem fields).
 
size_t write_name_to (char *buf, size_t buf_size) const
 Copy the name into buf (null terminated), returns its length.
 
const LogString * get_log_name () const
 Get the name for a "%s" log argument (LOG_STR_ARG).
 
bool has_own_name () const
 
uint32_t get_object_id_hash () const
 
StringRef get_object_id_to (std::span< char, OBJECT_ID_MAX_LEN > buf) const
 Get object_id with zero heap allocation For static case: returns StringRef to internal storage (buffer unused) For dynamic case: formats into buffer and returns StringRef to buffer.
 
size_t write_object_id_to (char *buf, size_t buf_size) const
 Write object_id directly to buffer, returns length written (excluding null) Useful for building compound strings without intermediate buffer.
 
bool is_internal () const
 
void set_internal (bool internal)
 
bool is_disabled_by_default () const
 
EntityCategory get_entity_category () const
 
const char * get_device_class_to (std::span< char, MAX_DEVICE_CLASS_LENGTH > buffer) const
 
ProgmemStringRef get_device_class_progmem () const
 The device class as stored (in flash on ESP8266), for consumers that read flash themselves.
 
StringRef get_unit_of_measurement_ref () const
 
const char * get_icon_to (std::span< char, MAX_ICON_LENGTH > buffer) const
 
ProgmemStringRef get_icon_progmem () const
 The icon as stored (in flash on ESP8266), for consumers that read flash themselves.
 
uint32_t get_device_id () const
 
Device * get_device () const
 
bool has_state () const
 
void set_has_state (bool state)
 
 ESPDEPRECATED ("Use make_entity_preference<T>() instead, or preferences won't be migrated. " "See https://github.com/esphome/backlog/issues/85. Will be removed in 2027.1.0.", "2026.7.0") uint32_t get_preference_hash()
 Get a unique hash for storing preferences/settings for this entity.
 
template<typename T >
ESPPreferenceObject make_entity_preference (uint32_t version=0)
 Create a preference object for storing this entity's state/settings.
 
template<typename T >
ESPPreferenceObject make_entity_preference (uint32_t version, bool in_flash)
 As make_entity_preference(), stored in flash or RTC memory where the backend supports the choice.
 
- Public Member Functions inherited from esphome::modbus_controller::SensorItem
bool addresses_bits () const
 Coils and discrete inputs address individual bits; every other type addresses 16-bit registers.
 
uint16_t write_address () const
 Address a write entity (switch/number/select) targets, derived from its resolved position within the range so that a write lands on the register the sensor reads from.
 
void set_offset_from_start_address (uint8_t offset)
 Records the offset as configured, and seeds the resolved position with it.
 
void set_address (uint16_t address)
 Sets the configured address, and points the range base at it.
 
void set_custom_pdu (std::initializer_list< uint8_t > pdu)
 
virtual uint16_t entity_count () const
 Entities this item spans: one bit for bit-addressed types, ceil(bytes / 2) registers for RAW with a response_size, else the value type's register width.
 
virtual size_t get_register_size () const
 Bytes this item's registers occupy in a response: one per bit for bit-addressed types; response_size when set (devices that answer more bytes per register than the standard two); else two per register.
 
void set_register_size (uint8_t register_size)
 
- Public Member Functions inherited from esphome::modbus_controller::WriterEntity
bool dispatched () const
 Whether the lambda called a request helper since the last clear_dispatched_().
 
void set_write_options (modbus::CommandOptions options)
 
bool write_single_register (uint16_t address, uint16_t value)
 
bool write_single_coil (uint16_t address, bool value)
 
bool write_multiple_registers (uint16_t address, std::span< const uint16_t > values)
 
bool write_multiple_coils (uint16_t address, std::span< const bool > values)
 
bool write_multiple_coils (uint16_t address, modbus::PackedBits bits)
 
bool queue_pdu (std::span< const uint8_t > pdu)
 
bool queue_pdu (std::span< const uint8_t > pdu, modbus::CommandOptions options)
 
void clear_tx_queue_for_device ()
 

Protected Member Functions

bool assumed_state () override
 
- Protected Member Functions inherited from esphome::Component
friend void::setup ()
 
friend void::original_setup ()
 
void set_component_source_ (uint8_t index)
 Set where this component was loaded from for some debug messages.
 
virtual void call_setup ()
 
void call_dump_config_ ()
 
void enable_loop_slow_path_ ()
 
void set_component_state_ (uint8_t state)
 Helper to set component state (clears state bits and sets new state)
 
bool set_status_flag_ (uint8_t flag)
 Helper to set a status LED flag on both this component and the app.
 
bool set_error_flag_ (const LogString *message)
 Set the error flag and log it; true when it was not set before.
 
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 id, uint32_t interval, std::function< void()> &&f)
 Set an interval function with a numeric ID (zero heap allocation).
 
void set_interval (InternalSchedulerID id, uint32_t interval, std::function< void()> &&f)
 
void set_interval (uint32_t interval, std::function< void()> &&f)
 
bool cancel_interval (const char *name)
 Cancel an interval function.
 
bool cancel_interval (uint32_t id)
 
bool cancel_interval (InternalSchedulerID id)
 
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 id, uint32_t timeout, std::function< void()> &&f)
 Set a timeout function with a numeric ID (zero heap allocation).
 
void set_timeout (InternalSchedulerID id, uint32_t timeout, std::function< void()> &&f)
 
void set_timeout (uint32_t timeout, std::function< void()> &&f)
 
bool cancel_timeout (const char *name)
 Cancel a timeout function.
 
bool cancel_timeout (uint32_t id)
 
bool cancel_timeout (InternalSchedulerID id)
 
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.
 
void defer (uint32_t id, std::function< void()> &&f)
 Defer a callback with a numeric ID (zero heap allocation)
 
bool cancel_defer (const char *name)
 Cancel a defer callback using the specified name, name must not be empty.
 
bool cancel_defer (uint32_t id)
 
void status_clear_warning_slow_path_ ()
 
void status_clear_error_slow_path_ ()
 
- Protected Member Functions inherited from esphome::switch_::Switch
- Protected Member Functions inherited from esphome::EntityBase
friend void::setup ()
 
friend void::original_setup ()
 
void configure_entity_ (const char *name, uint32_t object_id_hash, uint32_t entity_fields)
 Combined entity setup from codegen: set name, object_id hash, entity string indices, and flags.
 
void set_device_ (Device *device)
 
ESPPreferenceObject make_entity_preference_ (size_t size, uint32_t version)
 Non-template helpers for make_entity_preference() to avoid code bloat.
 
ESPPreferenceObject make_entity_preference_ (size_t size, uint32_t version, bool in_flash)
 
uint32_t entity_preference_key_ (uint32_t version)
 Key for both helpers; preference hash migration goes here.
 
- Protected Member Functions inherited from esphome::modbus_controller::WriterEntity
bool send_raw_frame_deprecated_ (std::span< const uint8_t > frame)
 
void set_controller_ (ModbusController *controller)
 
void clear_dispatched_ ()
 
void warn_write_buffer_deprecated_ (const LogString *platform, uint16_t address)
 

Protected Attributes

bool use_write_multiple_ {false}
 
optional< transform_func_t > publish_transform_func_ {nullopt}
 
optional< write_transform_func_t > write_transform_func_ {nullopt}
 
bool assumed_state_ {false}
 
- Protected Attributes inherited from esphome::Component
uint8_t component_source_index_ {0}
 Index into component source PROGMEM lookup table (0 = not set)
 
uint8_t warn_if_blocking_over_ {WARN_IF_BLOCKING_OVER_CS}
 Warn threshold in centiseconds (max 2550ms)
 
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 Bit 5: Has overridden loop() (set at registration time) Bits 6-7: Unused - reserved for future expansion.
 
volatile bool pending_enable_loop_ {false}
 ISR-safe flag for enable_loop_soon_any_context.
 
ComponentRuntimeStats runtime_stats_
 
- Protected Attributes inherited from esphome::switch_::Switch
ESPPreferenceObject rtc_
 
LazyCallbackManager< void(bool)> state_callback_ {}
 
Deduplicator< bool > publish_dedup_
 
bool inverted_ {false}
 
- Protected Attributes inherited from esphome::EntityBase
ProgmemStringRef name_
 
uint32_t object_id_hash_ {}
 
Device * device_ {}
 
struct esphome::EntityBase::EntityFlags flags_
 
uint8_t device_class_idx_ {}
 
uint8_t uom_idx_ {}
 
uint8_t icon_idx_ {}
 

Additional Inherited Members

- Data Fields inherited from esphome::Component
uint32_t length = 5000)
 
- 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.
 
- Data Fields inherited from esphome::modbus_controller::SensorItem
modbus::EntityType register_type {modbus::EntityType::CUSTOM}
 
SensorValueType sensor_value_type {SensorValueType::RAW}
 
uint16_t start_address {0}
 
uint32_t bitmask {0}
 
uint8_t offset {0}
 Position of this sensor's data within its range's response - a byte offset for registers, a bit index for coils and discrete inputs.
 
uint8_t response_bytes {0}
 
uint8_t offset_from_start_address {0}
 The offset exactly as configured: measured from this sensor's own start_address, where offset is measured from the first register of the range it ends up polled in.
 
uint16_t range_start_address {0}
 First register of the range this sensor is polled in; equals start_address for an unpolled item.
 
SmallInlineBuffer< 8 > custom_pdu {}
 
RangeReuse reuse_previous_range {RangeReuse::AUTO}
 

Detailed Description

Definition at line 11 of file modbus_switch.h.

Member Typedef Documentation

◆ transform_func_t

using esphome::modbus_controller::ModbusSwitch::transform_func_t = optional<bool> (*)(ModbusSwitch *, bool, std::span<const uint8_t>)

Definition at line 39 of file modbus_switch.h.

◆ write_transform_func_t

Constructor & Destructor Documentation

◆ ModbusSwitch()

esphome::modbus_controller::ModbusSwitch::ModbusSwitch ( modbus::EntityType register_type,
uint16_t start_address,
uint8_t offset,
uint32_t bitmask,
RangeReuse reuse_previous_range )
inline

Definition at line 13 of file modbus_switch.h.

Member Function Documentation

◆ assumed_state()

bool esphome::modbus_controller::ModbusSwitch::assumed_state ( )
overrideprotectedvirtual

Reimplemented from esphome::switch_::Switch.

Definition at line 18 of file modbus_switch.cpp.

◆ dump_config()

void esphome::modbus_controller::ModbusSwitch::dump_config ( )
overridevirtual

Reimplemented from esphome::Component.

Definition at line 16 of file modbus_switch.cpp.

◆ parse_and_publish()

void esphome::modbus_controller::ModbusSwitch::parse_and_publish ( std::span< const uint8_t > data)
overridevirtual

Implements esphome::modbus_controller::SensorItem.

Definition at line 20 of file modbus_switch.cpp.

◆ set_assumed_state()

void esphome::modbus_controller::ModbusSwitch::set_assumed_state ( bool assumed_state)
inline

Definition at line 34 of file modbus_switch.h.

◆ set_parent()

void esphome::modbus_controller::ModbusSwitch::set_parent ( ModbusController * parent)
inline

Definition at line 37 of file modbus_switch.h.

◆ set_state()

void esphome::modbus_controller::ModbusSwitch::set_state ( bool state)
inline

Definition at line 35 of file modbus_switch.h.

◆ set_template()

void esphome::modbus_controller::ModbusSwitch::set_template ( transform_func_t f)
inline

Definition at line 41 of file modbus_switch.h.

◆ set_use_write_mutiple()

void esphome::modbus_controller::ModbusSwitch::set_use_write_mutiple ( bool use_write_multiple)
inline

Definition at line 43 of file modbus_switch.h.

◆ set_write_template()

void esphome::modbus_controller::ModbusSwitch::set_write_template ( write_transform_func_t f)
inline

Definition at line 42 of file modbus_switch.h.

◆ setup()

void esphome::modbus_controller::ModbusSwitch::setup ( )
overridevirtual

Reimplemented from esphome::Component.

Definition at line 15 of file modbus_switch.cpp.

◆ write_state()

void esphome::modbus_controller::ModbusSwitch::write_state ( bool state)
overridevirtual

Implements esphome::switch_::Switch.

Definition at line 50 of file modbus_switch.cpp.

Field Documentation

◆ assumed_state_

bool esphome::modbus_controller::ModbusSwitch::assumed_state_ {false}
protected

Definition at line 50 of file modbus_switch.h.

◆ publish_transform_func_

optional<transform_func_t> esphome::modbus_controller::ModbusSwitch::publish_transform_func_ {nullopt}
protected

Definition at line 48 of file modbus_switch.h.

◆ use_write_multiple_

bool esphome::modbus_controller::ModbusSwitch::use_write_multiple_ {false}
protected

Definition at line 47 of file modbus_switch.h.

◆ write_transform_func_

optional<write_transform_func_t> esphome::modbus_controller::ModbusSwitch::write_transform_func_ {nullopt}
protected

Definition at line 49 of file modbus_switch.h.


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