mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-09 18:36:51 +00:00
Cover: add state (#34684)
This commit is contained in:
parent
e8a47136d4
commit
8f3a461421
@ -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
|
||||
|
||||
|
Loading…
x
Reference in New Issue
Block a user