merge things cleanup....

Author: s-light

adafruit_tlc59711.py

@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2017 Tony DiCola for Adafruit Industries
+# SPDX-FileCopyrightText: 2018 Stefan Krüger s-light.eu
 #
 # SPDX-License-Identifier: MIT
 
@@ -9,7 +10,7 @@
 
 CircuitPython module for the
 TLC59711 or TLC5971 16-bit 12 channel LED PWM driver.
-See examples/simpletest_multi.py for a demo of the usage.
+See examples/tlc59711_simpletest.py for a demo of the usage.
 
 * Author(s): Tony DiCola, Stefan Kruger
 
@@ -183,9 +184,21 @@ class TLC59711:
     _BC_BIT_COUNT = const(3 * 7)
     # this holds the chip offset and
     _BC_FIELDS = {
-        "BCR": {"offset": 0, "length": 7, "mask": 0b01111111,},
-        "BCG": {"offset": 7, "length": 7, "mask": 0b01111111,},
-        "BCB": {"offset": 14, "length": 7, "mask": 0b01111111,},
+        "BCR": {
+            "offset": 0,
+            "length": 7,
+            "mask": 0b01111111,
+        },
+        "BCG": {
+            "offset": 7,
+            "length": 7,
+            "mask": 0b01111111,
+        },
+        "BCB": {
+            "offset": 14,
+            "length": 7,
+            "mask": 0b01111111,
+        },
     }
 
     ##########################################
@@ -218,11 +231,31 @@ class TLC59711:
     _FC_CHIP_BUFFER_BIT_OFFSET = const(_BC_BIT_COUNT)
     _FC_BIT_COUNT = const(5)
     _FC_FIELDS = {
-        "BLANK": {"offset": 0, "length": 1, "mask": 0b1,},
-        "DSPRPT": {"offset": 1, "length": 1, "mask": 0b1,},
-        "TMGRST": {"offset": 2, "length": 1, "mask": 0b1,},
-        "EXTGCK": {"offset": 3, "length": 1, "mask": 0b1,},
-        "OUTTMG": {"offset": 4, "length": 1, "mask": 0b1,},
+        "BLANK": {
+            "offset": 0,
+            "length": 1,
+            "mask": 0b1,
+        },
+        "DSPRPT": {
+            "offset": 1,
+            "length": 1,
+            "mask": 0b1,
+        },
+        "TMGRST": {
+            "offset": 2,
+            "length": 1,
+            "mask": 0b1,
+        },
+        "EXTGCK": {
+            "offset": 3,
+            "length": 1,
+            "mask": 0b1,
+        },
+        "OUTTMG": {
+            "offset": 4,
+            "length": 1,
+            "mask": 0b1,
+        },
     }
 
     ##########################################
@@ -232,7 +265,11 @@ class TLC59711:
     _WC_CHIP_BUFFER_BIT_OFFSET = const(_FC_BIT_COUNT + _BC_BIT_COUNT)
     _WC_BIT_COUNT = const(6)
     _WC_FIELDS = {
-        "WRITE_COMMAND": {"offset": 0, "length": 6, "mask": 0b111111,},
+        "WRITE_COMMAND": {
+            "offset": 0,
+            "length": 6,
+            "mask": 0b111111,
+        },
     }
     WRITE_COMMAND = const(0b100101)
     ##########################################
@@ -433,7 +470,6 @@ def _write(self):
             self._spi.unlock()
 
     def show(self):
-
         """Write out the current LED PWM state to the chip."""
         self._write()
 
@@ -839,57 +875,12 @@ def set_channel(self, channel_index, value):
             )
 
     # Define index and length properties to set and get each pixel as
-=======
-        """Write out the current LED PWM state to the chip.  This is only necessary if
-        auto_show was set to false in the initializer.
-        """
-        self._write()
-
-    # Define properties for global brightness control channels.
-    @property
-    def red_brightness(self):
-        """The red brightness for all channels (i.e. R0, R1, R2, and R3).  This is a 7-bit
-        value from 0-127.
-        """
-        return self._bcr
-
-    @red_brightness.setter
-    def red_brightness(self, val):
-        assert 0 <= val <= 127
-        self._bcr = val
-        if self.auto_show:
-            self._write()
-
-    @property
-    def green_brightness(self):
-        """The green brightness for all channels (i.e. G0, G1, G2, and G3).  This is a
-        7-bit value from 0-127.
-        """
-        return self._bcg
-
-    @green_brightness.setter
-    def green_brightness(self, val):
-        assert 0 <= val <= 127
-        self._bcg = val
-        if self.auto_show:
-            self._write()
-
-    @property
-    def blue_brightness(self):
-        """The blue brightness for all channels (i.e. B0, B1, B2, and B3).  This is a 7-bit
-        value from 0-127.
-        """
-        return self._bcb
-
-    @blue_brightness.setter
-    def blue_brightness(self, val):
-        assert 0 <= val <= 127
-        self._bcb = val
-        if self.auto_show:
-            self._write()
-
-    # Define index and length properties to set and get each channel as
+    # atomic RGB tuples.  This provides a similar feel as using neopixels.
+    def __len__(self):
+        """Retrieve TLC5975 the total number of Pixels available."""
+        return self.pixel_count
 
+    def __getitem__(self, key):
         """
         Retrieve the R, G, B values for the provided channel as a 3-tuple.
 

examples/tlc59711_dev.py

@@ -1,4 +1,12 @@
-"""TLC5971 / TLC59711 Multi."""
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# CircuitPython
+
+# SPDX-FileCopyrightText: 2021 s-light
+# SPDX-License-Identifier: MIT
+# Author Stefan Krüger (s-light)
+
+"""TLC5971 / TLC59711 Multi Development."""
 
 __doc__ = """
 TLC59711 development helper.
@@ -101,7 +109,10 @@ def timeit_call(message, test_function, loop_count=1000):
     # "{:>8.2f}ms".format(3.56)
     print(
         "{call_duration:>10.4f}ms\t{message}"
-        "".format(call_duration=(duration / loop_count) * 1000, message=message,)
+        "".format(
+            call_duration=(duration / loop_count) * 1000,
+            message=message,
+        )
     )
 
 
@@ -408,15 +419,22 @@ def test_bcdata():
         "bcr: {:>3}\n"
         "bcg: {:>3}\n"
         "bcb: {:>3}\n"
-        "".format(pixels.bcr, pixels.bcg, pixels.bcb,)
+        "".format(
+            pixels.bcr,
+            pixels.bcg,
+            pixels.bcb,
+        )
     )
     # calculate bc values
     Ioclmax = adafruit_tlc59711.TLC59711.calculate_Ioclmax(Riref=2.7)
     print("Ioclmax = {}".format(Ioclmax))
     Riref = adafruit_tlc59711.TLC59711.calculate_Riref(Ioclmax=Ioclmax)
     print("Riref = {}".format(Riref))
     BCValues = adafruit_tlc59711.TLC59711.calculate_BCData(
-        Ioclmax=Ioclmax, IoutR=18, IoutG=11, IoutB=13,
+        Ioclmax=Ioclmax,
+        IoutR=18,
+        IoutG=11,
+        IoutB=13,
     )
     # (127, 77, 91)
     print("BCValues = {}".format(BCValues))
@@ -431,7 +449,11 @@ def test_bcdata():
         "bcr: {:>3}\n"
         "bcg: {:>3}\n"
         "bcb: {:>3}\n"
-        "".format(pixels.bcr, pixels.bcg, pixels.bcb,)
+        "".format(
+            pixels.bcr,
+            pixels.bcg,
+            pixels.bcb,
+        )
     )
     time.sleep(2)
 

examples/tlc59711_fancyled.py

@@ -2,6 +2,10 @@
 # -*- coding: utf-8 -*-
 # CircuitPython
 
+# SPDX-FileCopyrightText: 2021 s-light
+# SPDX-License-Identifier: MIT
+# Author Stefan Krüger (s-light)
+
 """TLC59711 & FancyLED."""
 
 __doc__ = """
@@ -38,7 +42,10 @@
 print(42 * "*")
 print("init TLC5957")
 NUM_LEDS = 16
-pixels = adafruit_tlc59711.TLC59711(spi=spi, pixel_count=NUM_LEDS,)
+pixels = adafruit_tlc59711.TLC59711(
+    spi=spi,
+    pixel_count=NUM_LEDS,
+)
 
 print("pixel_count", pixels.pixel_count)
 print("chip_count", pixels.chip_count)

examples/tlc59711_fastset.py

@@ -1,4 +1,12 @@
-"""TLC5971 / TLC59711."""
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# CircuitPython
+
+# SPDX-FileCopyrightText: 2021 s-light
+# SPDX-License-Identifier: MIT
+# Author Stefan Krüger (s-light)
+
+"""TLC5971 / TLC59711 Example."""
 
 __doc__ = """
 tlc59711_fastset.py - TLC59711 fast set example.
@@ -10,6 +18,7 @@
 Enjoy the colors :-)
 """
 
+
 import time
 
 import board
@@ -58,7 +67,10 @@ def test_main():
     print(42 * "*")
 
     bcvalues = adafruit_tlc59711.TLC59711.calculate_BCData(
-        Ioclmax=18, IoutR=18, IoutG=11, IoutB=13,
+        Ioclmax=18,
+        IoutR=18,
+        IoutG=11,
+        IoutB=13,
     )
     print("bcvalues = {}".format(bcvalues))
     pixels.bcr = bcvalues[0]

examples/tlc59711_singlechip_autoshow.py

@@ -1,4 +1,12 @@
-"""TLC5971 / TLC59711."""
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# CircuitPython
+
+# SPDX-FileCopyrightText: 2021 s-light
+# SPDX-License-Identifier: MIT
+# Author Stefan Krüger (s-light)
+
+"""TLC5971 / TLC59711 Example."""
 
 __doc__ = """
 tlc59711_singlechip_autoshow.py - TLC59711AutoShow minimal usage example.

examples/tlc59711_test_bcdata.py

@@ -1,4 +1,12 @@
-"""TLC5971 / TLC59711 Multi."""
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# CircuitPython
+
+# SPDX-FileCopyrightText: 2021 s-light
+# SPDX-License-Identifier: MIT
+# Author Stefan Krüger (s-light)
+
+"""TLC5971 / TLC59711 Test BCData."""
 
 __doc__ = """
 tlc59711_test_bcdata.py.
@@ -43,7 +51,10 @@ def main_loop():
         except ValueError as e:
             print("Exception: ", e)
         BCValues = adafruit_tlc59711.TLC59711.calculate_BCData(
-            Ioclmax=Ioclmax, IoutR=IoutR, IoutG=IoutG, IoutB=IoutB,
+            Ioclmax=Ioclmax,
+            IoutR=IoutR,
+            IoutG=IoutG,
+            IoutB=IoutB,
         )
         pixels.bcr = BCValues[0]
         pixels.bcg = BCValues[1]
@@ -52,7 +63,11 @@ def main_loop():
             "bcr: {:>3}\n"
             "bcg: {:>3}\n"
             "bcb: {:>3}\n"
-            "".format(pixels.bcr, pixels.bcg, pixels.bcb,)
+            "".format(
+                pixels.bcr,
+                pixels.bcg,
+                pixels.bcb,
+            )
         )
         pixels.update_BCData()
     pixels.show()
@@ -77,7 +92,10 @@ def test_main():
     Riref = adafruit_tlc59711.TLC59711.calculate_Riref(Ioclmax=Ioclmax)
     print("Riref = {}".format(Riref))
     BCValues = adafruit_tlc59711.TLC59711.calculate_BCData(
-        Ioclmax=Ioclmax, IoutR=18, IoutG=11, IoutB=13,
+        Ioclmax=Ioclmax,
+        IoutR=18,
+        IoutG=11,
+        IoutB=13,
     )
     # (127, 77, 91)
     print("BCValues = {}".format(BCValues))

pylama.ini

@@ -1,3 +1,6 @@
+# SPDX-FileCopyrightText: 2021 s-light
+# SPDX-License-Identifier: Unlicense
+
 [pylama:pycodestyle]
 max_line_length = 100