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-19 15:26:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

clarify scenes (#4471)

Browse Source 
* clarify scenes

- add helper pointer, see https://github.com/home-assistant/home-assistant/pull/11819
- add workaround for multiple services, not sure actually where I found this
- add description of state definition, as it took me some time to get this

* ✏️ Minor changes
This commit is contained in:
akloeckner 2018-01-26 22:12:04 +01:00 committed by Franck Nijhof
parent 19eccf43e6
commit 5ba6298e21
1 changed files with 9 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
source/_components/scene.markdown
View File

@ -11,7 +11,7 @@ logo: home-assistant.png
ha_category: Organization ha_category: Organization
--- ---
You can create scenes that capture the states you want certain entities to be. For example a scene can specify that light A should be turned on and light B should be bright red. You can create scenes that capture the states you want certain entities to be. For example, a scene can specify that light A should be turned on and light B should be bright red.
```yaml ```yaml
# Example configuration.yaml entry # Example configuration.yaml entry
@ -38,6 +38,13 @@ Configuration variables:
- **name** (*Required*): Friendly name of scene. - **name** (*Required*): Friendly name of scene.
- **entities** (*Required*): Entities to control. - **entities** (*Required*): Entities to control.
As you can see, there are two ways to define the states of each `entity_id`:
- Define the `state` directly with the entity.
- Define a complex state with its attributes.
The mapping from states to services is done with the [state helper](https://github.com/home-assistant/home-assistant/blob/master/homeassistant/helpers/state.py#L74). So, please have a look there for available states for your scenes.
Scenes can be activated using the service `scene.turn_on` (there is no 'scene.turn_off' service). Scenes can be activated using the service `scene.turn_on` (there is no 'scene.turn_off' service).
```yaml ```yaml
@ -55,5 +62,5 @@ automation:
``` ```
<p class='note'> <p class='note'>
Please note that the scene component currently only supports one service call per entity to achieve the state. Due to this limitation you cannot set states belonging to different services. Please note that the scene component currently only supports one service call per entity to achieve the state. Due to this limitation, you cannot set states belonging to different services. A workaround for this limitation is to write a script, which you then turn on in your scene.
</p> </p>