Cover: add state (#34684)

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

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 %}
## 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