home-assistant.io/source/components/light.markdown

layout	title	description	date	sidebar	comments	sharing	footer
page	Lights	Instructions how to setup your lights with Home Assistant.	2015-01-24 14:39	false	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.

It supports the following platforms:

• hue for Philips Hue
• wink for Wink

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.

Service light.turn_on

Turns one light on or multiple lights on using groups.

Service data attribute	Optional	Description
entity_id	no	Only act on specified lights. Else targets all.
transition	yes	Seconds to take to switch to new state. *not supported by Wink
profile	yes	Which light profile to use.
xy_color	yes	Two comma seperated floats that represent the color in XY
rgb_color	yes	Three comma seperated integers that represent the color in RGB
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

Service light.turn_off

Turns one or multiple lights off.

Service data attribute	Optional	Description
entity_id	no	Only act on specified lights. Else targets all.