From 8f3a461421d87dd08bcf296f530878a6f783821c Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Wed, 11 Sep 2024 14:19:09 +0200 Subject: [PATCH] Cover: add state (#34684) --- source/_integrations/cover.markdown | 29 ++++++++++++++++++++--------- 1 file changed, 20 insertions(+), 9 deletions(-) diff --git a/source/_integrations/cover.markdown b/source/_integrations/cover.markdown index c1aefb91294..bebe04f2ecf 100644 --- a/source/_integrations/cover.markdown +++ b/source/_integrations/cover.markdown @@ -20,6 +20,17 @@ Home Assistant can give you an interface to control covers such as rollershutter {% include integrations/building_block_integration.md %} +## The state of a cover + +A can have the following states: + +- **Opening**: The cover is in the process of opening to reach a set position. +- **Open**: The cover has reached the open position. +- **Closing**: The cover is in the process of closing to reach a set position. +- **Closed**: The cover has reached the closed position. + +How the state of a cover is represented in the frontend depends on the device class. + ## Device class {% include integrations/device_class_intro.md %} @@ -54,8 +65,8 @@ The following device classes are supported for covers. Available actions: `cover.open_cover`, `cover.close_cover`, `cover.stop_cover`, `cover.toggle`, `cover.open_cover_tilt`, `cover.close_cover_tilt`, `cover.stop_cover_tilt`, `cover.toggle_tilt` | Data attribute | Optional | Description | -| ---------------------- | -------- | ---------------------------------------------------------------------------------------------------- | -| `entity_id` | yes | String or list of strings that point at `entity_id`'s of covers. Use `entity_id: all` to target all. | +| -------------- | -------- | ---------------------------------------------------------------------------------------------------- | +| `entity_id` | yes | String or list of strings that point at `entity_id`'s of covers. Use `entity_id: all` to target all. | #### Automation example @@ -75,9 +86,9 @@ automation: Set cover position of one or multiple covers. | Data attribute | Optional | Description | -| ---------------------- | -------- | ---------------------------------------------------------------------------------------------------- | -| `entity_id` | yes | String or list of strings that point at `entity_id`'s of covers. Use `entity_id: all` to target all. | -| `position` | no | Integer between 0 and 100. | +| -------------- | -------- | ---------------------------------------------------------------------------------------------------- | +| `entity_id` | yes | String or list of strings that point at `entity_id`'s of covers. Use `entity_id: all` to target all. | +| `position` | no | Integer between 0 and 100. | #### Automation example @@ -98,10 +109,10 @@ automation: Set cover tilt position of one or multiple covers. -| Data attribute | Optional | Description | -| ---------------------- | -------- | ---------------------------------------------------------------------------------------------------- | -| `entity_id` | yes | String or list of strings that point at `entity_id`'s of covers. Use `entity_id: all` to target all. | -| `tilt_position` | no | Integer between 0 and 100. | +| Data attribute | Optional | Description | +| --------------- | -------- | ---------------------------------------------------------------------------------------------------- | +| `entity_id` | yes | String or list of strings that point at `entity_id`'s of covers. Use `entity_id: all` to target all. | +| `tilt_position` | no | Integer between 0 and 100. | #### Automation example