mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-28 13:57:04 +00:00

* 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
67 lines
1.9 KiB
Markdown
67 lines
1.9 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.
|
|
|
|
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).
|
|
|
|
```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. A workaround for this limitation is to write a script, which you then turn on in your scene.
|
|
</p>
|