From 2992cd35be85c482cdadf6f49721c3e3d20478e9 Mon Sep 17 00:00:00 2001
From: Matthew Garrett <mjg59@coreos.com>
Date: Sat, 21 Jan 2017 14:14:08 -0800
Subject: [PATCH] Add support for Leviton Decora Bluetooth dimmer switches
 (#5434)

* Add support for Leviton Decora Bluetooth dimmer switches

Add support for the Decora Bluetooth smart dimmer switches from Leviton.

* Update decora.py
---
 .coveragerc                              |   1 +
 homeassistant/components/light/decora.py | 124 +++++++++++++++++++++++
 requirements_all.txt                     |   3 +
 script/gen_requirements_all.py           |   3 +-
 4 files changed, 130 insertions(+), 1 deletion(-)
 create mode 100644 homeassistant/components/light/decora.py

diff --git a/.coveragerc b/.coveragerc
index ea0530aa8f7..47f602072c0 100644
--- a/.coveragerc
+++ b/.coveragerc
@@ -191,6 +191,7 @@ omit =
     homeassistant/components/keyboard_remote.py
     homeassistant/components/light/avion.py
     homeassistant/components/light/blinksticklight.py
+    homeassistant/components/light/decora.py
     homeassistant/components/light/flux_led.py
     homeassistant/components/light/hue.py
     homeassistant/components/light/hyperion.py
diff --git a/homeassistant/components/light/decora.py b/homeassistant/components/light/decora.py
new file mode 100644
index 00000000000..eaae90f486e
--- /dev/null
+++ b/homeassistant/components/light/decora.py
@@ -0,0 +1,124 @@
+"""
+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.3']
+
+_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()
diff --git a/requirements_all.txt b/requirements_all.txt
index 1b92e6b81c4..68326dbd1b4 100755
--- a/requirements_all.txt
+++ b/requirements_all.txt
@@ -87,6 +87,9 @@ colorlog>2.1,<3
 # homeassistant.components.binary_sensor.concord232
 concord232==0.14
 
+# homeassistant.components.light.decora
+# decora==0.3
+
 # homeassistant.components.media_player.denonavr
 denonavr==0.3.1
 
diff --git a/script/gen_requirements_all.py b/script/gen_requirements_all.py
index e23c8d09fea..f5b0a271d84 100755
--- a/script/gen_requirements_all.py
+++ b/script/gen_requirements_all.py
@@ -20,7 +20,8 @@ COMMENT_REQUIREMENTS = (
     'evdev',
     'pycups',
     'python-eq3bt',
-    'avion'
+    'avion',
+    'decora'
 )
 
 IGNORE_PACKAGES = (