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-26 02:37:03 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update command_line cover component configuration (#7256)

Browse Source
This commit is contained in:
Klaas Schoute 2018-10-30 19:19:46 +01:00 committed by Fabian Affolter
parent f1f14f7ea6
commit 2092dd0067
1 changed files with 40 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
source/_components/cover.command_line.markdown
View File

@ -28,16 +28,46 @@ cover:
command_stop: move_command stop garage command_stop: move_command stop garage
``` ```
Configuration variables: {% configuration %}
covers:
- **covers** (*Required*): The array that contains all command line covers. description: The array that contains all command line covers.
- **identifier** (*Required*): Name of the command line cover as slug. Multiple entries are possible. required: true
- **command_open** (*Required*): The command to open the cover. type: list
- **command_close** (*Required*): The action to close the cover. keys:
- **command_stop** (*Required*): The action to stop the cover. identifier:
- **command_state** (*Optional*): If given, this will act as a sensor that runs in the background and updates the state of the cover. If the command returns a `0` the indicates the cover is fully closed, whereas a 100 indicates the cover is fully open. description: Name of the command line cover as slug. Multiple entries are possible.
- **value_template** (*optional - default: '{% raw %}{{ value }}{% endraw%}'*): if specified, `command_state` will ignore the result code of the command but the template evaluating will indicate the position of the cover. For example, if your `command_state` returns a string "open", using `value_template` as in the example config above will allow you to translate that into the valid state `100`. required: true
- **friendly_name** (*Optional*): The name used to display the cover in the frontend. type: list
keys:
command_open:
description: The command to open the cover.
required: true
default: true
type: string
command_close:
description: The action to close the cover.
required: true
default: true
type: string
command_stop:
description: The action to stop the cover.
required: true
default: true
type: string
command_state:
description: If given, this will act as a sensor that runs in the background and updates the state of the cover. If the command returns a `0` the indicates the cover is fully closed, whereas a 100 indicates the cover is fully open.
required: false
type: string
value_template:
description: if specified, `command_state` will ignore the result code of the command but the template evaluating will indicate the position of the cover. For example, if your `command_state` returns a string "open", using `value_template` as in the example config above will allow you to translate that into the valid state `100`.
required: false
default: "'{% raw %}{{ value }}{% endraw%}'"
type: template
friendly_name:
description: The name used to display the cover in the frontend.
required: false
type: string
{% endconfiguration %}
## {% linkable_title Examples %} ## {% linkable_title Examples %}