|
| | Valve () |
| |
| ValveCall | make_call () |
| | Construct a new valve call used to control the valve.
|
| |
| void | add_on_state_callback (std::function< void()> &&f) |
| |
| void | publish_state (bool save=true) |
| | Publish the current state of the valve.
|
| |
| virtual ValveTraits | get_traits ()=0 |
| |
| bool | is_fully_open () const |
| | Helper method to check if the valve is fully open. Equivalent to comparing .position against 1.0.
|
| |
| bool | is_fully_closed () const |
| | Helper method to check if the valve is fully closed. Equivalent to comparing .position against 0.0.
|
| |
| const StringRef & | get_name () const |
| |
| bool | has_own_name () const |
| |
| ESPDEPRECATED("object_id mangles names and all object_id methods are planned for removal " "(see https://github.com/esphome/backlog/issues/76). " "Now is the time to stop using object_id. If still needed, use get_object_id_to() " "which will remain available longer. get_object_id() will be removed in 2026.7.0", "2025.12.0") std uint32_t | get_object_id_hash () |
| |
| 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 |
| |
| | ESPDEPRECATED ("set_internal() is undefined behavior at runtime — components and Home Assistant are NOT " "notified. Use the 'internal:' YAML key instead. Will be removed in 2027.3.0.", "2026.3.0") 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 |
| |
| template<typename T = int> |
| StringRef | get_device_class_ref () const |
| |
| template<typename T = int> |
| std::string | get_device_class () const |
| |
| | ESPDEPRECATED ("Use get_device_class_to() instead. Will be removed in ESPHome 2026.9.0", "2026.3.0") StringRef get_device_class_ref() const |
| |
| ESPDEPRECATED("Use get_device_class_to() instead. Will be removed in ESPHome 2026.9.0", "2026.3.0") std StringRef | get_unit_of_measurement_ref () const |
| |
| ESPDEPRECATED("Use get_unit_of_measurement_ref() instead for better performance (avoids string copy). Will be " "removed in ESPHome 2026.9.0", "2026.3.0") std const char * | get_icon_to (std::span< char, MAX_ICON_LENGTH > buffer) const |
| | Get the unit of measurement as std::string (deprecated, prefer get_unit_of_measurement_ref())
|
| |
| template<typename T = int> |
| StringRef | get_icon_ref () const |
| |
| template<typename T = int> |
| std::string | get_icon () const |
| |
| | ESPDEPRECATED ("Use get_icon_to() instead. Will be removed in ESPHome 2026.9.0", "2026.3.0") StringRef get_icon_ref() const |
| |
| ESPDEPRECATED("Use get_icon_to() instead. Will be removed in ESPHome 2026.9.0", "2026.3.0") std 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.
|
| |
Base class for all valve devices.
Valves currently have three properties:
- position - The current position of the valve from 0.0 (fully closed) to 1.0 (fully open). For valves with only binary OPEN/CLOSED position this will always be either 0.0 or 1.0
- current_operation - The operation the valve is currently performing, this can be one of IDLE, OPENING and CLOSING.
For users: All valve operations must be performed over the .make_call() interface. To command a valve, use .make_call() to create a call object, set all properties you wish to set, and activate the command with .perform(). For reading out the current values of the valve, use the public .position, etc. properties (these are read-only for users)
For integrations: Integrations must implement two methods: control() and get_traits(). Control will be called with the arguments supplied by the user and should be used to control all values of the valve. Also implement get_traits() to return what operations the valve supports.
Definition at line 104 of file valve.h.
Public Member Functions inherited from esphome::EntityBase
1.12.0