jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-10 10:56:49 +00:00
Code Issues Packages Projects Releases Wiki Activity

Cover: add state (#34684)

Browse Source
This commit is contained in:
c0ffeeca7 2024-09-11 14:19:09 +02:00 committed by GitHub
parent e8a47136d4
commit 8f3a461421
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 20 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
source/_integrations/cover.markdown
View File

@ -20,6 +20,17 @@ Home Assistant can give you an interface to control covers such as rollershutter
{% include integrations/building_block_integration.md %} {% 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 ## Device class
{% include integrations/device_class_intro.md %} {% 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` 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 | | 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 #### Automation example
@ -75,9 +86,9 @@ automation:
Set cover position of one or multiple covers. Set cover position of one or multiple covers.
| Data attribute | Optional | Description | | 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. |
| `position` | no | Integer between 0 and 100. | | `position` | no | Integer between 0 and 100. |
#### Automation example #### Automation example
@ -98,10 +109,10 @@ automation:
Set cover tilt position of one or multiple covers. Set cover tilt position of one or multiple covers.
| Data attribute | Optional | Description | | 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. |
| `tilt_position` | no | Integer between 0 and 100. | | `tilt_position` | no | Integer between 0 and 100. |
#### Automation example #### Automation example