125 lines
3.4 KiB
Python
125 lines
3.4 KiB
Python
"""
|
|
Support for Decora dimmers.
|
|
|
|
For more details about this platform, please refer to the documentation at
|
|
https://home-assistant.io/components/light.decora/
|
|
"""
|
|
import logging
|
|
|
|
import voluptuous as vol
|
|
|
|
from homeassistant.const import CONF_API_KEY, CONF_DEVICES, CONF_NAME
|
|
from homeassistant.components.light import (
|
|
ATTR_BRIGHTNESS, SUPPORT_BRIGHTNESS, Light,
|
|
PLATFORM_SCHEMA)
|
|
import homeassistant.helpers.config_validation as cv
|
|
|
|
REQUIREMENTS = ['decora==0.4']
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
SUPPORT_DECORA_LED = (SUPPORT_BRIGHTNESS)
|
|
|
|
DEVICE_SCHEMA = vol.Schema({
|
|
vol.Optional(CONF_NAME): cv.string,
|
|
vol.Required(CONF_API_KEY): cv.string,
|
|
})
|
|
|
|
PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({
|
|
vol.Optional(CONF_DEVICES, default={}): {cv.string: DEVICE_SCHEMA},
|
|
})
|
|
|
|
|
|
def setup_platform(hass, config, add_devices, discovery_info=None):
|
|
"""Set up an Decora switch."""
|
|
lights = []
|
|
for address, device_config in config[CONF_DEVICES].items():
|
|
device = {}
|
|
device['name'] = device_config[CONF_NAME]
|
|
device['key'] = device_config[CONF_API_KEY]
|
|
device['address'] = address
|
|
light = DecoraLight(device)
|
|
if light.is_valid:
|
|
lights.append(light)
|
|
|
|
add_devices(lights)
|
|
|
|
|
|
class DecoraLight(Light):
|
|
"""Representation of an Decora light."""
|
|
|
|
def __init__(self, device):
|
|
"""Initialize the light."""
|
|
# pylint: disable=import-error
|
|
import decora
|
|
|
|
self._name = device['name']
|
|
self._address = device['address']
|
|
self._key = device["key"]
|
|
self._switch = decora.decora(self._address, self._key)
|
|
self._switch.connect()
|
|
self._state = self._switch.get_on()
|
|
self._brightness = self._switch.get_brightness()
|
|
self.is_valid = True
|
|
|
|
@property
|
|
def unique_id(self):
|
|
"""Return the ID of this light."""
|
|
return "{}.{}".format(self.__class__, self._address)
|
|
|
|
@property
|
|
def name(self):
|
|
"""Return the name of the device if any."""
|
|
return self._name
|
|
|
|
@property
|
|
def is_on(self):
|
|
"""Return true if device is on."""
|
|
return self._state
|
|
|
|
@property
|
|
def brightness(self):
|
|
"""Return the brightness of this light between 0..255."""
|
|
return self._brightness
|
|
|
|
@property
|
|
def supported_features(self):
|
|
"""Flag supported features."""
|
|
return SUPPORT_DECORA_LED
|
|
|
|
@property
|
|
def should_poll(self):
|
|
"""We can read the device state, so poll."""
|
|
return True
|
|
|
|
@property
|
|
def assumed_state(self):
|
|
"""We can read the actual state."""
|
|
return False
|
|
|
|
def set_state(self, brightness):
|
|
"""Set the state of this lamp to the provided brightness."""
|
|
self._switch.set_brightness(brightness)
|
|
self._brightness = brightness
|
|
return True
|
|
|
|
def turn_on(self, **kwargs):
|
|
"""Turn the specified or all lights on."""
|
|
brightness = kwargs.get(ATTR_BRIGHTNESS)
|
|
|
|
self._switch.on()
|
|
if brightness is not None:
|
|
self.set_state(brightness)
|
|
|
|
self._state = True
|
|
|
|
def turn_off(self, **kwargs):
|
|
"""Turn the specified or all lights off."""
|
|
self._switch.off()
|
|
self._state = False
|
|
|
|
def update(self):
|
|
"""Synchronise internal state with the actual light state."""
|
|
self._brightness = self._switch.get_brightness()
|
|
self._state = self._switch.get_on()
|