From 17ce11168adf26545cb605ad1dea5f4d50f50b3b Mon Sep 17 00:00:00 2001 From: Jan Bouwhuis Date: Sat, 22 Jul 2023 17:55:23 +0200 Subject: [PATCH] Add missing info for scene integration (#28262) Co-authored-by: Franck Nijhof --- source/_integrations/scene.markdown | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/source/_integrations/scene.markdown b/source/_integrations/scene.markdown index 529300d77c8..30959148f41 100644 --- a/source/_integrations/scene.markdown +++ b/source/_integrations/scene.markdown @@ -1,5 +1,5 @@ --- -title: Scenes +title: Scene description: Instructions on how to setup scenes within Home Assistant. ha_category: - Organization @@ -11,6 +11,24 @@ ha_domain: scene ha_integration_type: entity --- +A scene entity is an entity that can restore the state of a group of entities. +Scenes can be user-defined or can be provided through an integration. + +## The state of a scene + +The scene entity is stateless, as in, it cannot have a state like the `on` or +`off` state that, for example, a normal switch entity has. + +Every scene entity does keep track of the timestamp of when the last time +the scene entity was called via the Home Assistant UI or called via +a service call. + +## Scenes created by integrations + +Some integrations like [Philips Hue](/integrations/hue), [MQTT](/integrations/mqtt), and [KNX](/integrations/knx) provide scenes. You can activate them from the Home Assistant UI or via as service calls. In this case, the integration provides the preferred states to restore. + +## Creating a scene + 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. Scenes can be created and managed via the user interface using the [Scene Editor](/docs/scene/editor/). They can also be manually configured via `configuration.yaml`. Note that the entity data is not service call parameters, it's a representation of the wanted state: