Merge pull request #1 from ashwinvandijk/master

Support for RGBWW saturation

Author: soldag

.gitignore

@@ -0,0 +1 @@
+*.pyc

limitlessled/group/commands/v6.py

@@ -17,6 +17,7 @@ class CommandSetV6(CommandSet):
     PASSWORD_BYTE2 = 0x00
     MAX_COLOR = 0xFF
     MAX_BRIGHTNESS = 0x64
+    MAX_SATURATION = 0x64
     MAX_TEMPERATURE = 0x64
 
     def __init__(self, bridge, group_number, remote_style,
@@ -48,6 +49,19 @@ def convert_brightness(self, brightness):
         """
         return math.ceil(brightness * self.MAX_BRIGHTNESS)
 
+    def convert_saturation(self, saturation):
+        """
+        Convert the saturation from decimal percent (0.0-1.0)
+        to byte representation for use in commands.
+        :param saturation: The saturation from in decimal percent (0.0-1.0).
+        1.0 is the maximum saturation where no white leds will be on. 0.0 is no
+        saturation.
+        :return: The saturation in byte representation.
+        """
+
+        saturation_inverted = 1 - saturation;
+        return math.ceil(saturation_inverted * self.MAX_SATURATION)
+
     def convert_temperature(self, temperature):
         """
         Convert the temperature from decimal percent (0.0-1.0)
@@ -310,3 +324,11 @@ def brightness(self, brightness):
         :return: The command.
         """
         return self._build_command(0x03, self.convert_brightness(brightness))
+
+    def saturation(self, saturation):
+        """
+        Build command for setting the saturation of the led.
+        :param saturation: Value to set (0.0-1.0).
+        :return: The command.
+        """
+        return self._build_command(0x02, self.convert_saturation(saturation))

limitlessled/group/rgbw.py

@@ -80,6 +80,27 @@ def brightness(self, brightness):
         cmd = self.command_set.brightness(brightness)
         self.send(cmd)
 
+    @property
+    def saturation(self):
+        """ Saturation property.
+
+        :returns: Saturation.
+        """
+        return self._saturation
+
+    @brightness.setter
+    def saturation(self, saturation):
+        """ Set the group saturation.
+
+        :param saturation: Saturation in decimal percent (0.0-1.0).
+        """
+        if saturation < 0 or saturation > 1:
+            raise ValueError("Saturation must be a percentage "
+                             "represented as decimal 0-1.0")
+        self._saturation = saturation
+        cmd = self.command_set.saturation(saturation)
+        self.send(cmd)
+
     def transition(self, duration, color=None, brightness=None):
         """ Transition wrapper.