""" homeassistant.components.light.zwave ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Support for Z-Wave lights. For more details about this platform, please refer to the documentation at https://home-assistant.io/components/light.zwave/ """ # Because we do not compile openzwave on CI # pylint: disable=import-error from threading import Timer from homeassistant.components.light import ATTR_BRIGHTNESS, DOMAIN, Light from homeassistant.components.zwave import ( ATTR_NODE_ID, ATTR_VALUE_ID, COMMAND_CLASS_SWITCH_MULTILEVEL, GENRE_USER, NETWORK, TYPE_BYTE, ZWaveDeviceEntity) from homeassistant.const import STATE_OFF, STATE_ON def setup_platform(hass, config, add_devices, discovery_info=None): """ Find and add Z-Wave lights. """ if discovery_info is None or NETWORK is None: return node = NETWORK.nodes[discovery_info[ATTR_NODE_ID]] value = node.values[discovery_info[ATTR_VALUE_ID]] if value.command_class != COMMAND_CLASS_SWITCH_MULTILEVEL: return if value.type != TYPE_BYTE: return if value.genre != GENRE_USER: return value.set_change_verified(False) add_devices([ZwaveDimmer(value)]) def brightness_state(value): """ Returns the brightness and state according to the current data of given value. """ if value.data > 0: return (value.data / 99) * 255, STATE_ON else: return 255, STATE_OFF class ZwaveDimmer(ZWaveDeviceEntity, Light): """ Provides a Z-Wave dimmer. """ # pylint: disable=too-many-arguments def __init__(self, value): from openzwave.network import ZWaveNetwork from pydispatch import dispatcher ZWaveDeviceEntity.__init__(self, value, DOMAIN) self._brightness, self._state = brightness_state(value) # Used for value change event handling self._refreshing = False self._timer = None dispatcher.connect( self._value_changed, ZWaveNetwork.SIGNAL_VALUE_CHANGED) def _value_changed(self, value): """ Called when a value has changed on the network. """ if self._value.value_id != value.value_id: return if self._refreshing: self._refreshing = False self._brightness, self._state = brightness_state(value) else: def _refresh_value(): """Used timer callback for delayed value refresh.""" self._refreshing = True self._value.refresh() if self._timer is not None and self._timer.isAlive(): self._timer.cancel() self._timer = Timer(2, _refresh_value) self._timer.start() self.update_ha_state() @property def brightness(self): """ Brightness of this light between 0..255. """ return self._brightness @property def is_on(self): """ True if device is on. """ return self._state == STATE_ON def turn_on(self, **kwargs): """ Turn the device on. """ if ATTR_BRIGHTNESS in kwargs: self._brightness = kwargs[ATTR_BRIGHTNESS] # Zwave multilevel switches use a range of [0, 99] to control # brightness. brightness = (self._brightness / 255) * 99 if self._value.node.set_dimmer(self._value.value_id, brightness): self._state = STATE_ON def turn_off(self, **kwargs): """ Turn the device off. """ if self._value.node.set_dimmer(self._value.value_id, 0): self._state = STATE_OFF