Time Based Cover¶
time_based cover platform allows you to create covers with position control that do not
have any position feedback. The state of the cover is thus always an assumed one, the current
position is approximated with the time the cover has been moving in a direction.
# Example configuration entry cover: - platform: time_based name: "Time-Based Cover" open_action: - switch.turn_on: open_cover_switch open_duration: 2.1min close_action: - switch.turn_on: close_cover_switch close_duration: 2min stop_action: - switch.turn_off: open_cover_switch - switch.turn_off: close_cover_switch
name (Required, string): The name of the cover.
open_action (Required, Action): The action that should be performed when the remote requests the cover to be opened.
open_duration (Required, Time): The amount of time it takes the cover to open up from the fully-closed state.
close_action (Optional, Action): The action that should be performed when the remote requests the cover to be closed.
close_duration (Required, Time): The amount of time it takes the cover to close from the fully-open state.
stop_action (Required, Action): The action that should be performed to stop the cover when the remote requests the cover to be stopped or when the cover has been opening/closing for the given durations.
has_built_in_endstop (Optional, boolean): Indicates that the cover has built in end stop detectors. In this configuration the
stop_actionis not performed when the open or close time is completed and if the cover is commanded to open or close the corresponding actions will be performed without checking current state. Defaults to
manual_control (Optional, boolean): For covers with manual external controls. With this configuration if the cover is commanded to open or close the corresponding actions will be performed even if the current state fully open or fully closed matches desired state, then
stop_actionwill be called after the full duration of the action elapses. The current state will then be relearned upon completion. It’s recommended to set
assumed_stateto true so the cover control button aren’t disabled in the interface. Defaults to
assumed_state (Optional, boolean): Whether the true state of the cover is not known. This will make the Home Assistant frontend show buttons for both OPEN and CLOSE actions, instead of hiding or disabling one of them. Defaults to
id (Optional, ID): Manually specify the ID used for code generation.
All other options from Cover.
The stop button on the UI is always enabled even when the cover is stopped and each press
on the button will cause the
stop_action to be performed.
The state of the cover can be restored from flash after a node reboot, with
esp8266_restore_from_flash: true option set.
See esp8266_restore_from_flash for details.