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

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	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 or multiple lights on.

Service data attribute	Optional	Description
entity_id	no	Only act on specified lights. Else targets all.
transition_seconds	no	Seconds to take to switch to new state.
profile	no	Which light profile to use.
xy_color	no	Two comma seperated floats that represent the color in XY
rgb_color	no	Three comma seperated integers that represent the color in RGB
brightness	no	Integer between 0 and 255 for how bright the color should be
flash	no	Tell light to flash, can be either value short or long

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.