117 lines
3.5 KiB
Python
117 lines
3.5 KiB
Python
"""
|
|
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
|