mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-10 10:56:49 +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 %}
|
{% 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
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user