3.4 KiB
layout, title, description, date, sidebar, comments, sharing, footer
| layout | title | description | date | sidebar | comments | sharing | footer |
|---|---|---|---|---|---|---|---|
| page | Lights | Instructions how to setup your lights with Home Assistant. | 2015-01-24 14:39 | true | false | true | true |
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
The light component supports multiple entries in configuration.yaml by appending a sequential number to the section: light 2:, light 3: etc.
{% linkable_title Service light.turn_on %}
Turns one light on or multiple lights on using groups.
| Service data attribute | Optional | Description |
|---|---|---|
entity_id |
no | String or list of strings that point at entity_ids of lights. Else targets all. |
transition |
yes | Integer that represents the time the light should take to transition to the new state. *not supported by Wink |
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. |
xy_color |
yes | A list containing two floats representing the xy color you want the light to be. Two comma seperated floats that represent the color in XY. |
rgb_color |
yes | A list containing three integers representing the xy color you want the light to be. Three comma seperated integers that represent the color in RGB |
color_temp |
yes | An INT in mireds represending the color temperature you want the light to be. |
brightness |
yes | Integer between 0 and 255 for how bright the color should be. |
flash |
yes | Tell light to flash, can be either value short or long. *not supported by Wink |
{% linkable_title Service light.turn_off %}
Turns one or multiple lights off.
| Service data attribute | Optional | Description |
|---|---|---|
entity_id |
no | String or list of strings that point at entity_ids of lights. Else targets all. |
transition |
no | Integer that represents the time the light should take to transition to the new state. |
{% linkable_title Service light.toggle %}
Toggles the state of one or multiple lights using groups.
Note: If light.toggle is used for a group of lights, it will toggle the individual state of each light.
| Service data attribute | Optional | Description |
|---|---|---|
entity_id |
no | String or list of strings that point at entity_ids of lights. Else targets all. |
transition |
no | Integer that represents the time the light should take to transition to the new state. |