Simon Elsbrock d48262c14a Scene component: describe limitations wrt states (#1710)
Currently the scene component only allows setting states of a single service per component. Document this limitation.

references https://github.com/home-assistant/home-assistant/issues/5123
2017-01-04 20:11:23 +01:00

60 lines
1.4 KiB
Markdown

---
layout: page
title: "Scenes"
description: "Instructions how to setup scenes within Home Assistant."
date: 2015-03-23 19:59
sidebar: true
comments: false
sharing: true
footer: true
logo: home-assistant.png
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.
```yaml
# Example configuration.yaml entry
scene:
- name: Romantic
entities:
light.tv_back_light: on
light.ceiling:
state: on
xy_color: [0.33, 0.66]
brightness: 200
- name: Movies
entities:
light.tv_back_light:
state: on
brightness: 100
light.ceiling: off
media_player.sony_bravia_tv:
source: HDMI 1
```
Configuration variables:
- **name** (*Required*): Friendly name of scene.
- **entities** (*Required*): Entities to control.
Scenes can be activated using the service `scene.turn_on` (there is no 'scene.turn_off' service).
```yaml
# Example automation
...
automation:
trigger:
platform: state
entity_id: device_tracker.sweetheart
from: 'not_home'
to: 'home'
action:
service: scene.turn_on
entity_id: scene.romantic
```
<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.
</p>