""" Support for KNX/IP lights. For more details about this platform, please refer to the documentation at https://home-assistant.io/components/light.knx/ """ import asyncio import voluptuous as vol from homeassistant.components.knx import DATA_KNX, ATTR_DISCOVER_DEVICES from homeassistant.components.light import PLATFORM_SCHEMA, Light, \ SUPPORT_BRIGHTNESS, ATTR_BRIGHTNESS from homeassistant.const import CONF_NAME from homeassistant.core import callback import homeassistant.helpers.config_validation as cv CONF_ADDRESS = 'address' CONF_STATE_ADDRESS = 'state_address' CONF_BRIGHTNESS_ADDRESS = 'brightness_address' CONF_BRIGHTNESS_STATE_ADDRESS = 'brightness_state_address' DEFAULT_NAME = 'KNX Light' DEPENDENCIES = ['knx'] PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Required(CONF_ADDRESS): cv.string, vol.Optional(CONF_NAME, default=DEFAULT_NAME): cv.string, vol.Optional(CONF_STATE_ADDRESS): cv.string, vol.Optional(CONF_BRIGHTNESS_ADDRESS): cv.string, vol.Optional(CONF_BRIGHTNESS_STATE_ADDRESS): cv.string, }) @asyncio.coroutine def async_setup_platform(hass, config, add_devices, discovery_info=None): """Set up light(s) for KNX platform.""" if DATA_KNX not in hass.data \ or not hass.data[DATA_KNX].initialized: return False if discovery_info is not None: async_add_devices_discovery(hass, discovery_info, add_devices) else: async_add_devices_config(hass, config, add_devices) return True @callback def async_add_devices_discovery(hass, discovery_info, add_devices): """Set up lights for KNX platform configured via xknx.yaml.""" entities = [] for device_name in discovery_info[ATTR_DISCOVER_DEVICES]: device = hass.data[DATA_KNX].xknx.devices[device_name] entities.append(KNXLight(hass, device)) add_devices(entities) @callback def async_add_devices_config(hass, config, add_devices): """Set up light for KNX platform configured within plattform.""" import xknx light = xknx.devices.Light( hass.data[DATA_KNX].xknx, name=config.get(CONF_NAME), group_address_switch=config.get(CONF_ADDRESS), group_address_switch_state=config.get(CONF_STATE_ADDRESS), group_address_brightness=config.get(CONF_BRIGHTNESS_ADDRESS), group_address_brightness_state=config.get( CONF_BRIGHTNESS_STATE_ADDRESS)) hass.data[DATA_KNX].xknx.devices.add(light) add_devices([KNXLight(hass, light)]) class KNXLight(Light): """Representation of a KNX light.""" def __init__(self, hass, device): """Initialization of KNXLight.""" self.device = device self.hass = hass self.async_register_callbacks() @callback def async_register_callbacks(self): """Register callbacks to update hass after device was changed.""" @asyncio.coroutine def after_update_callback(device): """Callback after device was updated.""" # pylint: disable=unused-argument yield from self.async_update_ha_state() self.device.register_device_updated_cb(after_update_callback) @property def name(self): """Return the name of the KNX device.""" return self.device.name @property def should_poll(self): """No polling needed within KNX.""" return False @property def brightness(self): """Return the brightness of this light between 0..255.""" return self.device.brightness \ if self.device.supports_dimming else \ None @property def xy_color(self): """Return the XY color value [float, float].""" return None @property def rgb_color(self): """Return the RBG color value.""" return None @property def color_temp(self): """Return the CT color temperature.""" return None @property def white_value(self): """Return the white value of this light between 0..255.""" return None @property def effect_list(self): """Return the list of supported effects.""" return None @property def effect(self): """Return the current effect.""" return None @property def is_on(self): """Return true if light is on.""" return self.device.state @property def supported_features(self): """Flag supported features.""" flags = 0 if self.device.supports_dimming: flags |= SUPPORT_BRIGHTNESS return flags @asyncio.coroutine def async_turn_on(self, **kwargs): """Turn the light on.""" if ATTR_BRIGHTNESS in kwargs and self.device.supports_dimming: yield from self.device.set_brightness(int(kwargs[ATTR_BRIGHTNESS])) else: yield from self.device.set_on() @asyncio.coroutine def async_turn_off(self, **kwargs): """Turn the light off.""" yield from self.device.set_off()