#include <feedback_cover.h>

Inheritance diagram for esphome::feedback::FeedbackCover:

Public Member Functions
void	setup () override

void	loop () override

void	dump_config () override

Trigger *	get_open_trigger () const

Trigger *	get_close_trigger () const

Trigger *	get_stop_trigger () const

void	set_open_endstop (binary_sensor::BinarySensor *open_endstop)

void	set_open_sensor (binary_sensor::BinarySensor *open_feedback)

void	set_open_obstacle_sensor (binary_sensor::BinarySensor *open_obstacle)

void	set_close_endstop (binary_sensor::BinarySensor *close_endstop)

void	set_close_sensor (binary_sensor::BinarySensor *close_feedback)

void	set_close_obstacle_sensor (binary_sensor::BinarySensor *close_obstacle)

void	set_open_duration (uint32_t duration)

void	set_close_duration (uint32_t duration)

void	set_has_built_in_endstop (bool value)

void	set_assumed_state (bool value)

void	set_max_duration (uint32_t max_duration)

void	set_obstacle_rollback (float obstacle_rollback)

void	set_update_interval (uint32_t interval)

void	set_infer_endstop (bool infer_endstop)

void	set_direction_change_waittime (uint32_t waittime)

void	set_acceleration_wait_time (uint32_t waittime)

cover::CoverTraits	get_traits () override

Public Member Functions inherited from esphome::cover::Cover
	Cover ()

CoverCall	make_call ()
	Construct a new cover call used to control the cover.

void	add_on_state_callback (std::function< void()> &&f)

void	publish_state (bool save=true)
	Publish the current state of the cover.

bool	is_fully_open () const
	Helper method to check if the cover is fully open. Equivalent to comparing .position against 1.0.

bool	is_fully_closed () const
	Helper method to check if the cover is fully closed. Equivalent to comparing .position against 0.0.

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::Component
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	control (const cover::CoverCall &call) override

void	stop_prev_trigger_ ()

bool	is_at_target_ () const

void	start_direction_ (cover::CoverOperation dir)

void	update_operation_ (cover::CoverOperation dir)

void	endstop_reached_ (bool open_endstop)

void	recompute_position_ ()

void	set_current_operation_ (cover::CoverOperation operation, bool is_triggered)

Protected Member Functions inherited from esphome::cover::Cover
optional< CoverRestoreState >	restore_state_ ()

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
binary_sensor::BinarySensor *	open_endstop_ {nullptr}

binary_sensor::BinarySensor *	close_endstop_ {nullptr}

binary_sensor::BinarySensor *	open_feedback_ {nullptr}

binary_sensor::BinarySensor *	close_feedback_ {nullptr}

binary_sensor::BinarySensor *	open_obstacle_ {nullptr}

binary_sensor::BinarySensor *	close_obstacle_ {nullptr}

Trigger *	open_trigger_ {new Trigger<>()}

Trigger *	close_trigger_ {new Trigger<>()}

Trigger *	stop_trigger_ {new Trigger<>()}

uint32_t	open_duration_ {0}

uint32_t	close_duration_ {0}

uint32_t	max_duration_ {UINT32_MAX}

optional< uint32_t >	direction_change_waittime_ {}

uint32_t	acceleration_wait_time_ {0}

bool	has_built_in_endstop_ {false}

bool	assumed_state_ {false}

bool	infer_endstop_ {false}

float	obstacle_rollback_ {0}

cover::CoverOperation	last_operation_ {cover::COVER_OPERATION_OPENING}

cover::CoverOperation	current_trigger_operation_ {cover::COVER_OPERATION_IDLE}

Trigger *	prev_command_trigger_ {nullptr}

uint32_t	last_recompute_time_ {0}

uint32_t	start_dir_time_ {0}

uint32_t	last_publish_time_ {0}

float	target_position_ {0}

uint32_t	update_interval_ {1000}

Protected Attributes inherited from esphome::cover::Cover
friend	CoverCall

CallbackManager< void()>	state_callback_ {}

ESPPreferenceObject	rtc_

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::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.

Additional Inherited Members
Data Fields inherited from esphome::cover::Cover
CoverOperation	current_operation {COVER_OPERATION_IDLE}
	The current operation of the cover (idle, opening, closing).

float	position
	The position of the cover from 0.0 (fully closed) to 1.0 (fully open).

float	tilt {COVER_OPEN}
	The current tilt value of the cover from 0.0 to 1.0.

Detailed Description

Definition at line 14 of file feedback_cover.h.

Member Function Documentation

◆ control()

void esphome::feedback::FeedbackCover::control ( const cover::CoverCall & call )

overrideprotectedvirtual

Implements esphome::cover::Cover.

Definition at line 255 of file feedback_cover.cpp.

◆ dump_config()

void esphome::feedback::FeedbackCover::dump_config ( )

overridevirtual

Reimplemented from esphome::Component.

Definition at line 52 of file feedback_cover.cpp.

◆ endstop_reached_()

void esphome::feedback::FeedbackCover::endstop_reached_ ( bool open_endstop )

protected

Definition at line 137 of file feedback_cover.cpp.

◆ get_close_trigger()

Trigger * esphome::feedback::FeedbackCover::get_close_trigger ( ) const

inline

Definition at line 21 of file feedback_cover.h.

◆ get_open_trigger()

Trigger * esphome::feedback::FeedbackCover::get_open_trigger ( ) const

inline

Definition at line 20 of file feedback_cover.h.

◆ get_stop_trigger()

Trigger * esphome::feedback::FeedbackCover::get_stop_trigger ( ) const

inline

Definition at line 22 of file feedback_cover.h.

◆ get_traits()

CoverTraits esphome::feedback::FeedbackCover::get_traits ( )

overridevirtual

Implements esphome::cover::Cover.

Definition at line 43 of file feedback_cover.cpp.

◆ is_at_target_()

bool esphome::feedback::FeedbackCover::is_at_target_ ( ) const

protected

Definition at line 314 of file feedback_cover.cpp.

◆ loop()

void esphome::feedback::FeedbackCover::loop ( )

overridevirtual

Reimplemented from esphome::Component.

Definition at line 221 of file feedback_cover.cpp.

◆ recompute_position_()

void esphome::feedback::FeedbackCover::recompute_position_ ( )

protected

Definition at line 391 of file feedback_cover.cpp.

◆ set_acceleration_wait_time()

void esphome::feedback::FeedbackCover::set_acceleration_wait_time ( uint32_t waittime )

inline

Definition at line 41 of file feedback_cover.h.

◆ set_assumed_state()

void esphome::feedback::FeedbackCover::set_assumed_state ( bool value )

inline

Definition at line 35 of file feedback_cover.h.

◆ set_close_duration()

void esphome::feedback::FeedbackCover::set_close_duration ( uint32_t duration )

inline

Definition at line 33 of file feedback_cover.h.

◆ set_close_endstop()

void esphome::feedback::FeedbackCover::set_close_endstop ( binary_sensor::BinarySensor * close_endstop )

Definition at line 127 of file feedback_cover.cpp.

◆ set_close_obstacle_sensor()

void esphome::feedback::FeedbackCover::set_close_obstacle_sensor ( binary_sensor::BinarySensor * close_obstacle )

Definition at line 186 of file feedback_cover.cpp.

◆ set_close_sensor()

void esphome::feedback::FeedbackCover::set_close_sensor ( binary_sensor::BinarySensor * close_feedback )

Definition at line 104 of file feedback_cover.cpp.

◆ set_current_operation_()

void esphome::feedback::FeedbackCover::set_current_operation_	(	cover::CoverOperation	operation,
		bool	is_triggered )

protected

Definition at line 161 of file feedback_cover.cpp.

◆ set_direction_change_waittime()

void esphome::feedback::FeedbackCover::set_direction_change_waittime ( uint32_t waittime )

inline

Definition at line 40 of file feedback_cover.h.

◆ set_has_built_in_endstop()

void esphome::feedback::FeedbackCover::set_has_built_in_endstop ( bool value )

inline

Definition at line 34 of file feedback_cover.h.

◆ set_infer_endstop()

void esphome::feedback::FeedbackCover::set_infer_endstop ( bool infer_endstop )

inline

Definition at line 39 of file feedback_cover.h.

◆ set_max_duration()

void esphome::feedback::FeedbackCover::set_max_duration ( uint32_t max_duration )

inline

Definition at line 36 of file feedback_cover.h.

◆ set_obstacle_rollback()

void esphome::feedback::FeedbackCover::set_obstacle_rollback ( float obstacle_rollback )

inline

Definition at line 37 of file feedback_cover.h.

◆ set_open_duration()

void esphome::feedback::FeedbackCover::set_open_duration ( uint32_t duration )

inline

Definition at line 32 of file feedback_cover.h.

◆ set_open_endstop()

void esphome::feedback::FeedbackCover::set_open_endstop ( binary_sensor::BinarySensor * open_endstop )

Definition at line 118 of file feedback_cover.cpp.

◆ set_open_obstacle_sensor()

void esphome::feedback::FeedbackCover::set_open_obstacle_sensor ( binary_sensor::BinarySensor * open_obstacle )

Definition at line 203 of file feedback_cover.cpp.

◆ set_open_sensor()

void esphome::feedback::FeedbackCover::set_open_sensor ( binary_sensor::BinarySensor * open_feedback )

Definition at line 90 of file feedback_cover.cpp.

◆ set_update_interval()

void esphome::feedback::FeedbackCover::set_update_interval ( uint32_t interval )

inline

Definition at line 38 of file feedback_cover.h.

◆ setup()

void esphome::feedback::FeedbackCover::setup ( )

overridevirtual

Reimplemented from esphome::Component.

Definition at line 13 of file feedback_cover.cpp.

◆ start_direction_()

void esphome::feedback::FeedbackCover::start_direction_ ( cover::CoverOperation dir )

protected

Definition at line 329 of file feedback_cover.cpp.

◆ stop_prev_trigger_()

void esphome::feedback::FeedbackCover::stop_prev_trigger_ ( )

protected

Definition at line 304 of file feedback_cover.cpp.

◆ update_operation_()

void esphome::feedback::FeedbackCover::update_operation_ ( cover::CoverOperation dir )

protected

Field Documentation

◆ acceleration_wait_time_

uint32_t esphome::feedback::FeedbackCover::acceleration_wait_time_ {0}

protected

Definition at line 72 of file feedback_cover.h.

◆ assumed_state_

bool esphome::feedback::FeedbackCover::assumed_state_ {false}

protected

Definition at line 74 of file feedback_cover.h.

◆ close_duration_

uint32_t esphome::feedback::FeedbackCover::close_duration_ {0}

protected

Definition at line 69 of file feedback_cover.h.

◆ close_endstop_

binary_sensor::BinarySensor* esphome::feedback::FeedbackCover::close_endstop_ {nullptr}

protected

Definition at line 57 of file feedback_cover.h.

◆ close_feedback_

binary_sensor::BinarySensor* esphome::feedback::FeedbackCover::close_feedback_ {nullptr}

protected

Definition at line 59 of file feedback_cover.h.

◆ close_obstacle_

binary_sensor::BinarySensor* esphome::feedback::FeedbackCover::close_obstacle_ {nullptr}

protected

Definition at line 61 of file feedback_cover.h.

◆ close_trigger_

Trigger* esphome::feedback::FeedbackCover::close_trigger_ {new Trigger<>()}

protected

Definition at line 65 of file feedback_cover.h.

◆ current_trigger_operation_

cover::CoverOperation esphome::feedback::FeedbackCover::current_trigger_operation_ {cover::COVER_OPERATION_IDLE}

protected

Definition at line 79 of file feedback_cover.h.

◆ direction_change_waittime_

optional<uint32_t> esphome::feedback::FeedbackCover::direction_change_waittime_ {}

protected

Definition at line 71 of file feedback_cover.h.

◆ has_built_in_endstop_

bool esphome::feedback::FeedbackCover::has_built_in_endstop_ {false}

protected

Definition at line 73 of file feedback_cover.h.

◆ infer_endstop_

bool esphome::feedback::FeedbackCover::infer_endstop_ {false}

protected

Definition at line 75 of file feedback_cover.h.

◆ last_operation_

cover::CoverOperation esphome::feedback::FeedbackCover::last_operation_ {cover::COVER_OPERATION_OPENING}

protected

Definition at line 78 of file feedback_cover.h.

◆ last_publish_time_

uint32_t esphome::feedback::FeedbackCover::last_publish_time_ {0}

protected

Definition at line 83 of file feedback_cover.h.

◆ last_recompute_time_

uint32_t esphome::feedback::FeedbackCover::last_recompute_time_ {0}

protected

Definition at line 81 of file feedback_cover.h.

◆ max_duration_

uint32_t esphome::feedback::FeedbackCover::max_duration_ {UINT32_MAX}

protected

Definition at line 70 of file feedback_cover.h.

◆ obstacle_rollback_

float esphome::feedback::FeedbackCover::obstacle_rollback_ {0}

protected

Definition at line 76 of file feedback_cover.h.

◆ open_duration_

uint32_t esphome::feedback::FeedbackCover::open_duration_ {0}

protected

Definition at line 68 of file feedback_cover.h.

◆ open_endstop_

binary_sensor::BinarySensor* esphome::feedback::FeedbackCover::open_endstop_ {nullptr}

protected

Definition at line 56 of file feedback_cover.h.

◆ open_feedback_

binary_sensor::BinarySensor* esphome::feedback::FeedbackCover::open_feedback_ {nullptr}

protected

Definition at line 58 of file feedback_cover.h.

◆ open_obstacle_

binary_sensor::BinarySensor* esphome::feedback::FeedbackCover::open_obstacle_ {nullptr}

protected

Definition at line 60 of file feedback_cover.h.

◆ open_trigger_

Trigger* esphome::feedback::FeedbackCover::open_trigger_ {new Trigger<>()}

protected

Definition at line 64 of file feedback_cover.h.

◆ prev_command_trigger_

Trigger* esphome::feedback::FeedbackCover::prev_command_trigger_ {nullptr}

protected

Definition at line 80 of file feedback_cover.h.

◆ start_dir_time_

uint32_t esphome::feedback::FeedbackCover::start_dir_time_ {0}

protected

Definition at line 82 of file feedback_cover.h.

◆ stop_trigger_

Trigger* esphome::feedback::FeedbackCover::stop_trigger_ {new Trigger<>()}

protected

Definition at line 66 of file feedback_cover.h.

◆ target_position_

float esphome::feedback::FeedbackCover::target_position_ {0}

protected

Definition at line 84 of file feedback_cover.h.

◆ update_interval_

uint32_t esphome::feedback::FeedbackCover::update_interval_ {1000}

protected

Definition at line 85 of file feedback_cover.h.

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

esphome/components/feedback/feedback_cover.h
esphome/components/feedback/feedback_cover.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ control()

◆ dump_config()

◆ endstop_reached_()

◆ get_close_trigger()

◆ get_open_trigger()

◆ get_stop_trigger()

◆ get_traits()

◆ is_at_target_()

◆ loop()

◆ recompute_position_()

◆ set_acceleration_wait_time()

◆ set_assumed_state()

◆ set_close_duration()

◆ set_close_endstop()

◆ set_close_obstacle_sensor()

◆ set_close_sensor()

◆ set_current_operation_()

◆ set_direction_change_waittime()

◆ set_has_built_in_endstop()

◆ set_infer_endstop()

◆ set_max_duration()

◆ set_obstacle_rollback()

◆ set_open_duration()

◆ set_open_endstop()

◆ set_open_obstacle_sensor()

◆ set_open_sensor()

◆ set_update_interval()

◆ setup()

◆ start_direction_()

◆ stop_prev_trigger_()

◆ update_operation_()

Field Documentation

◆ acceleration_wait_time_

◆ assumed_state_

◆ close_duration_

◆ close_endstop_

◆ close_feedback_

◆ close_obstacle_

◆ close_trigger_

◆ current_trigger_operation_

◆ direction_change_waittime_

◆ has_built_in_endstop_

◆ infer_endstop_

◆ last_operation_

◆ last_publish_time_

◆ last_recompute_time_

◆ max_duration_

◆ obstacle_rollback_

◆ open_duration_

◆ open_endstop_

◆ open_feedback_

◆ open_obstacle_

◆ open_trigger_

◆ prev_command_trigger_

◆ start_dir_time_

◆ stop_trigger_

◆ target_position_

◆ update_interval_