""" Support for the IKEA Tradfri platform. For more details about this platform, please refer to the documentation at https://home-assistant.io/components/light.tradfri/ """ import asyncio import logging from homeassistant.core import callback from homeassistant.components.light import ( ATTR_BRIGHTNESS, ATTR_COLOR_TEMP, ATTR_RGB_COLOR, ATTR_TRANSITION, SUPPORT_BRIGHTNESS, SUPPORT_TRANSITION, SUPPORT_COLOR_TEMP, SUPPORT_RGB_COLOR, Light) from homeassistant.components.light import \ PLATFORM_SCHEMA as LIGHT_PLATFORM_SCHEMA from homeassistant.components.tradfri import KEY_GATEWAY, KEY_TRADFRI_GROUPS, \ KEY_API from homeassistant.util import color as color_util _LOGGER = logging.getLogger(__name__) DEPENDENCIES = ['tradfri'] PLATFORM_SCHEMA = LIGHT_PLATFORM_SCHEMA IKEA = 'IKEA of Sweden' TRADFRI_LIGHT_MANAGER = 'Tradfri Light Manager' SUPPORTED_FEATURES = (SUPPORT_BRIGHTNESS | SUPPORT_TRANSITION) ALLOWED_TEMPERATURES = {IKEA} @asyncio.coroutine def async_setup_platform(hass, config, async_add_devices, discovery_info=None): """Set up the IKEA Tradfri Light platform.""" if discovery_info is None: return gateway_id = discovery_info['gateway'] api = hass.data[KEY_API][gateway_id] gateway = hass.data[KEY_GATEWAY][gateway_id] devices_command = gateway.get_devices() devices_commands = yield from api(devices_command) devices = yield from api(*devices_commands) lights = [dev for dev in devices if dev.has_light_control] if lights: async_add_devices(TradfriLight(light, api) for light in lights) allow_tradfri_groups = hass.data[KEY_TRADFRI_GROUPS][gateway_id] if allow_tradfri_groups: groups_command = gateway.get_groups() groups_commands = yield from api(groups_command) groups = yield from api(*groups_commands) if groups: async_add_devices(TradfriGroup(group, api) for group in groups) class TradfriGroup(Light): """The platform class required by hass.""" def __init__(self, light, api): """Initialize a Group.""" self._api = api self._group = light self._name = light.name self._refresh(light) @asyncio.coroutine def async_added_to_hass(self): """Start thread when added to hass.""" self._async_start_observe() @property def should_poll(self): """No polling needed for tradfri group.""" return False @property def supported_features(self): """Flag supported features.""" return SUPPORTED_FEATURES @property def name(self): """Return the display name of this group.""" return self._name @property def is_on(self): """Return true if group lights are on.""" return self._group.state @property def brightness(self): """Return the brightness of the group lights.""" return self._group.dimmer @asyncio.coroutine def async_turn_off(self, **kwargs): """Instruct the group lights to turn off.""" self.hass.async_add_job(self._api(self._group.set_state(0))) @asyncio.coroutine def async_turn_on(self, **kwargs): """Instruct the group lights to turn on, or dim.""" keys = {} if ATTR_TRANSITION in kwargs: keys['transition_time'] = int(kwargs[ATTR_TRANSITION]) if ATTR_BRIGHTNESS in kwargs: self.hass.async_add_job(self._api( self._group.set_dimmer(kwargs[ATTR_BRIGHTNESS], **keys))) else: self.hass.async_add_job(self._api(self._group.set_state(1))) @callback def _async_start_observe(self, exc=None): """Start observation of light.""" from pytradfri.error import PyTradFriError if exc: _LOGGER.warning("Observation failed for %s", self._name, exc_info=exc) try: cmd = self._group.observe(callback=self._observe_update, err_callback=self._async_start_observe, duration=0) self.hass.async_add_job(self._api(cmd)) except PyTradFriError as err: _LOGGER.warning("Observation failed, trying again", exc_info=err) self._async_start_observe() def _refresh(self, group): """Refresh the light data.""" self._group = group self._name = group.name def _observe_update(self, tradfri_device): """Receive new state data for this light.""" self._refresh(tradfri_device) self.hass.async_add_job(self.async_update_ha_state()) class TradfriLight(Light): """The platform class required by Home Assistant.""" def __init__(self, light, api): """Initialize a Light.""" self._api = api self._light = None self._light_control = None self._light_data = None self._name = None self._rgb_color = None self._features = SUPPORTED_FEATURES self._temp_supported = False self._refresh(light) @property def min_mireds(self): """Return the coldest color_temp that this light supports.""" from pytradfri.color import MAX_KELVIN_WS return color_util.color_temperature_kelvin_to_mired(MAX_KELVIN_WS) @property def max_mireds(self): """Return the warmest color_temp that this light supports.""" from pytradfri.color import MIN_KELVIN_WS return color_util.color_temperature_kelvin_to_mired(MIN_KELVIN_WS) @property def device_state_attributes(self): """Return the devices' state attributes.""" info = self._light.device_info attrs = { 'manufacturer': info.manufacturer, 'model_number': info.model_number, 'serial': info.serial, 'firmware_version': info.firmware_version, 'power_source': info.power_source_str, 'battery_level': info.battery_level } return attrs @asyncio.coroutine def async_added_to_hass(self): """Start thread when added to hass.""" self._async_start_observe() @property def should_poll(self): """No polling needed for tradfri light.""" return False @property def supported_features(self): """Flag supported features.""" return self._features @property def name(self): """Return the display name of this light.""" return self._name @property def is_on(self): """Return true if light is on.""" return self._light_data.state @property def brightness(self): """Return the brightness of the light.""" return self._light_data.dimmer @property def color_temp(self): """Return the CT color value in mireds.""" if (self._light_data.kelvin_color is None or self.supported_features & SUPPORT_COLOR_TEMP == 0 or not self._temp_supported): return None return color_util.color_temperature_kelvin_to_mired( self._light_data.kelvin_color ) @property def rgb_color(self): """RGB color of the light.""" return self._rgb_color @asyncio.coroutine def async_turn_off(self, **kwargs): """Instruct the light to turn off.""" self.hass.async_add_job(self._api( self._light_control.set_state(False))) @asyncio.coroutine def async_turn_on(self, **kwargs): """ Instruct the light to turn on. After adding "self._light_data.hexcolor is not None" for ATTR_RGB_COLOR, this also supports Philips Hue bulbs. """ if ATTR_RGB_COLOR in kwargs and self._light_data.hex_color is not None: self.hass.async_add_job(self._api( self._light.light_control.set_rgb_color( *kwargs[ATTR_RGB_COLOR]))) elif ATTR_COLOR_TEMP in kwargs and \ self._light_data.hex_color is not None and \ self._temp_supported: kelvin = color_util.color_temperature_mired_to_kelvin( kwargs[ATTR_COLOR_TEMP]) self.hass.async_add_job(self._api( self._light_control.set_kelvin_color(kelvin))) keys = {} if ATTR_TRANSITION in kwargs: keys['transition_time'] = int(kwargs[ATTR_TRANSITION]) if ATTR_BRIGHTNESS in kwargs: self.hass.async_add_job(self._api( self._light_control.set_dimmer(kwargs[ATTR_BRIGHTNESS], **keys))) else: self.hass.async_add_job(self._api( self._light_control.set_state(True))) @callback def _async_start_observe(self, exc=None): """Start observation of light.""" from pytradfri.error import PyTradFriError if exc: _LOGGER.warning("Observation failed for %s", self._name, exc_info=exc) try: cmd = self._light.observe(callback=self._observe_update, err_callback=self._async_start_observe, duration=0) self.hass.async_add_job(self._api(cmd)) except PyTradFriError as err: _LOGGER.warning("Observation failed, trying again", exc_info=err) self._async_start_observe() def _refresh(self, light): """Refresh the light data.""" self._light = light # Caching of LightControl and light object self._light_control = light.light_control self._light_data = light.light_control.lights[0] self._name = light.name self._rgb_color = None self._features = SUPPORTED_FEATURES if self._light_data.hex_color is not None: if self._light.device_info.manufacturer == IKEA: self._features |= SUPPORT_COLOR_TEMP else: self._features |= SUPPORT_RGB_COLOR self._temp_supported = self._light.device_info.manufacturer \ in ALLOWED_TEMPERATURES def _observe_update(self, tradfri_device): """Receive new state data for this light.""" self._refresh(tradfri_device) # Handle Hue lights paired with the gateway # hex_color is 0 when bulb is unreachable if self._light_data.hex_color not in (None, '0'): self._rgb_color = color_util.rgb_hex_to_rgb_list( self._light_data.hex_color) self.hass.async_add_job(self.async_update_ha_state())