Initial Dotstar Additions

Author: Melissa LeBlanc-Williams

README.rst

@@ -25,6 +25,7 @@ These drivers depends on:
 * `INA219 <https://github.com/adafruit/Adafruit_CircuitPython_INA219>`_
 * `Seesaw <https://github.com/adafruit/Adafruit_CircuitPython_seesaw>`_
 * `HT16K33 <https://github.com/adafruit/Adafruit_CircuitPython_HT16K33>`_
+* `DotStar <https://github.com/adafruit/Adafruit_CircuitPython_DotStar>`_
 
 Please ensure all dependencies are available on the CircuitPython filesystem.
 This is easily achieved by downloading

adafruit_featherwing/dotstar_featherwing.py

@@ -0,0 +1,61 @@
+# The MIT License (MIT)
+#
+# Copyright (c) 2019 Melissa LeBlanc-Williams for Adafruit Industries LLC
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+"""
+`adafruit_featherwing.dotstar_featherwing`
+====================================================
+
+Helper for using the `Dotstar FeatherWing <https://www.adafruit.com/product/3449>`_.
+
+* Author(s): Melissa LeBlanc-Williams
+"""
+
+__version__ = "0.0.0-auto.0"
+__repo__ = "https://github.com/adafruit/Adafruit_CircuitPython_FeatherWing.git"
+
+import board
+import time
+import adafruit_dotstar as dotstar
+
+class DotStarFeatherWing:
+    """Class representing a `DotStar FeatherWing
+       <https://www.adafruit.com/product/3449>`_.
+
+       The feather uses pins D13 and D11"""
+    def __init__(self, clock=board.D13, data=board.D11, brightness=0.2):
+        """
+            :param pin clock: The clock pin for the featherwing
+            :param pin data: The data pin for the featherwing
+            :param float brightness: Optional brightness (0.0-1.0) that defaults to 1.0
+        """
+        self._rows = 6
+        self._columns = 12
+        self._brightness = brightness
+        self._dotstar = dotstar.DotStar(clock, data, self._rows * self._columns, brightness=self._brightness)
+
+    def fill(self, color):
+        """Fills the wing with a color.
+           Does NOT update the LEDs.
+
+           :param (int, int, int) color: the color to fill with
+        """
+        self._dotstar.fill(color)
+

docs/api.rst

@@ -10,3 +10,6 @@
 .. automodule:: adafruit_featherwing.alphanum_featherwing
    :members:
 
+.. automodule:: adafruit_featherwing.dotstar_featherwing
+   :members:
+

docs/examples.rst

@@ -15,5 +15,9 @@ Ensure your device works with this simple test.
     :caption: examples/featherwing_alphanum_simpletest.py
     :linenos:
 
+.. literalinclude:: ../examples/featherwing_dotstar_simpletest.py
+    :caption: examples/featherwing_dotstar_simpletest.py
+    :linenos:
+
 
 

examples/featherwing_dotstar_simpletest.py

@@ -0,0 +1,18 @@
+"""This example changes the screen different colors"""
+
+from time import sleep
+import random
+from adafruit_featherwing import dotstar_featherwing
+
+dotstar = dotstar_featherwing.DotStarFeatherWing()
+
+# HELPERS
+# a random color 0 -> 224
+def random_color():
+    return random.randrange(0, 8) * 32
+
+# MAIN LOOP
+while True:
+    # Fill screen with a random color
+    dotstar.fill((random_color(), random_color(), random_color()))
+    sleep(.25)

requirements.txt

@@ -4,3 +4,5 @@ adafruit-circuitpython-register
 adafruit-circuitpython-ina219
 adafruit-circuitpython-seesaw
 adafruit-circuitpython-ht16k33
+adafruit-circuitpython-dotstar
+

setup.py

@@ -37,7 +37,8 @@
 
     install_requires=['Adafruit-Blinka', 'adafruit-circuitpython-busdevice',
                       'adafruit-circuitpython-register', 'adafruit-circuitpython-ina219',
-                      'adafruit-circuitpython-seesaw', 'adafruit-circuitpython-ht16k33'],
+                      'adafruit-circuitpython-seesaw', 'adafruit-circuitpython-ht16k33',
+                      'adafruit-circuitpython-dotstar'],
 
     # Choose your license
     license='MIT',