More information can be found on the Philips Hue API documentation website.
The Hue platform has it’s own concept of Scenes for setting the colors of a group of lights at once. Hue Scenes are very cheap, get created by all kinds of apps (as it is the only way to have 2 or more lights change at the same time), and are rarely deleted. A typical Hue hub might have hundreds of scenes stored in them, many that you’ve never used, almost all very poorly named.
-To avoid user interface overload we don’t expose Scenes directly. Instead there is a light.hue_activate_scene service which can be used by automation or script components. For
-instance:
To avoid user interface overload we don’t expose Scenes directly. Instead there is a light.hue_activate_scene service which can be used by automation or script components.
+This will have all the bulbs transitioned at once, instead of one at a time using standard scenes in Home Assistant.
+For instance:
script:
porch_on:
sequence:
@@ -118,6 +119,28 @@ instance:
scene_name: "Porch Orange"
| Service data attribute | +Optional | +Description | +
|---|---|---|
group_name |
+ no | +The group/room name of the lights. Find this in the Hue official app. | +
scene_name |
+ no | +The name of the Scene. Find this in the Hue official app. | +
Note: group_name is not linked to Home Assistant group name.
** Finding Group and Scene Names **
How do you find these names?
The easiest way to do this is only use the scenes from the 2nd generation Hue app. That is organized by Room (Group) and Scene diff --git a/components/light/index.html b/components/light/index.html index 0e71ef5580..641eac17ff 100644 --- a/components/light/index.html +++ b/components/light/index.html @@ -66,19 +66,13 @@
This component allows you to track and control various light bulbs.
-It has 4 built-in light profiles which you’re able to extend by putting a light_profiles.csv file in your config dir.
Preferred way to setup the Philips Hue platform is through the the discovery component. For the Wink light platform enable the wink component.
-If you want to enable the light component directly, add the following lines to your configuration.yaml:
light:
- platform: hue
-This component allows you to track and control various light bulbs. Read the platform documentation for your particular light hardware to learn how to enable it.
The light component supports multiple entries in configuration.yaml by appending a sequential number to the section: light 2:, light 3: etc.
light.turn_onTurns one light on or multiple lights on using groups.
+Most lights do not support all attributes. You can check the platform documentation of your particular light for hints but in general you will have to try things out and see what works.
transition |
yes | -Integer that represents the time the light should take to transition to the new state in seconds. *Not supported by all lights. | +Integer that represents the time the light should take to transition to the new state in seconds. |
profile |
yes | -String with the name of one of the built-in profiles (relax, energize, concentrate, reading) or one of the custom profiles defined in light_profiles.csv in the current working directory. Light profiles define a xy color and a brightness. If a profile is given and a brightness or xy color then the profile values will be overwritten. |
+ String with the name of one of the built-in profiles (relax, energize, concentrate, reading) or one of the custom profiles defined in light_profiles.csv in the current working directory. Light profiles define a xy color and a brightness. If a profile is given and a brightness or xy color then the profile values will be overwritten. |
xy_color |
@@ -141,7 +135,7 @@ The light component supports multiple entries in |||
flash |
yes | -Tell light to flash, can be either value short or long. *Not supported by all lights. |
+ Tell light to flash, can be either value short or long. |
effect |
@@ -197,33 +191,6 @@ The light component supports multiple entries in
light.hue_activate_sceneIf you have hue lights, there is a service call to directly activate -scenes that are stored in your hue hub. This will have all the bulbs -transitioned at once, instead of one at a time using standard scenes -in Home Assistant.
-| Service data attribute | -Optional | -Description | -
|---|---|---|
group_name |
- no | -The group/room name of the lights. Find this in the Hue official app. | -
scene_name |
- no | -The name of the Scene. Find this in the Hue official app. | -
Note: group_name is not linked to Home Assistant group name.