Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added NeoPixel FeatherWing #25

Merged
merged 17 commits into from
Feb 12, 2019
Merged

Added NeoPixel FeatherWing #25

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
814b0af
Added NeoPixel FeatherWing. Modified DotStar Lib.
Feb 6, 2019
a6bbcca
Restructured DotStar and NeoPixel to use common base class
Feb 6, 2019
b862de5
Linting
Feb 6, 2019
c5522d5
Undid class split. Linting.
Feb 6, 2019
bb1bf82
Final Linting
Feb 6, 2019
8f8d345
fixed merge conflict
Feb 6, 2019
e7f836d
Changed display to matrix
Feb 6, 2019
aef49c4
Linting
Feb 6, 2019
b3cd6e3
Merge branch 'neopixel'
Feb 6, 2019
c9b8582
Neopixels and DotStars using Base Class
Feb 7, 2019
08b9662
Fixed Base Class
Feb 7, 2019
570bfe9
Disabled bugged Lint Messages
Feb 7, 2019
f16b992
Merge branch 'neopixel2'
Feb 7, 2019
20f1c9b
Moved PixelMatrix to separate class
Feb 8, 2019
a74a071
Merge branch 'neopixel2'
Feb 8, 2019
4162737
Removed a lot of the overriding functions
Feb 12, 2019
dd7dc3f
Merge branch 'neopixel2'
Feb 12, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@ These drivers depends on:
* `Seesaw <https://github.com/adafruit/Adafruit_CircuitPython_seesaw>`_
* `HT16K33 <https://github.com/adafruit/Adafruit_CircuitPython_HT16K33>`_
* `DotStar <https://github.com/adafruit/Adafruit_CircuitPython_DotStar>`_
* `NeoPixel <https://github.com/adafruit/Adafruit_CircuitPython_NeoPixel>`_

Please ensure all dependencies are available on the CircuitPython filesystem.
This is easily achieved by downloading
Expand Down
321 changes: 5 additions & 316 deletions adafruit_featherwing/dotstar_featherwing.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,8 +33,9 @@

import board
import adafruit_dotstar as dotstar
from adafruit_featherwing.pixelmatrix import PixelMatrix

class DotStarFeatherWing:
class DotStarFeatherWing(PixelMatrix):
"""Class representing a `DotStar FeatherWing
<https://www.adafruit.com/product/3449>`_.

Expand All @@ -45,320 +46,8 @@ def __init__(self, clock=board.D13, data=board.D11, brightness=0.2):
:param pin data: The data pin for the featherwing
:param float brightness: Optional brightness (0.0-1.0) that defaults to 1.0
"""
super().__init__()
self.rows = 6
self.columns = 12
self._auto_write = True
self._dotstar = dotstar.DotStar(clock, data, self.rows * self.columns,
brightness=brightness, auto_write=False)

def __setitem__(self, indices, value):
"""
indices can be one of three things:
x and y ints that are calculated to the DotStar index
a slice of DotStar indexes with a set of values that match the slice
a single int that specifies the DotStar index
value can be one of three things:
a (r,g,b) list/tuple
a (r,g,b, brightness) list/tuple
a single, longer int that contains RGB values, like 0xFFFFFF
brightness, if specified should be a float 0-1
"""
self._dotstar[self._get_index(indices)] = value
self._update()

def __getitem__(self, indices):
"""
indices can be one of three things:
x and y ints that are calculated to the DotStar index
a slice of DotStar indexes to retrieve
a single int that specifies the DotStar index
"""
return self._dotstar[self._get_index(indices)]

def _get_index(self, indices):
"""
Figure out which DotStar to address based on what was passed in
"""
if isinstance(indices, int):
if not 0 <= indices < self.rows * self.columns:
raise ValueError('The index of {} is out of range'.format(indices))
return indices
elif isinstance(indices, slice):
return indices
elif len(indices) == 2:
x, y = indices
if not 0 <= x < self.columns:
raise ValueError('The X value of {} is out of range'.format(x))
if not 0 <= y < self.rows:
raise ValueError('The Y value of {} is out of range'.format(y))
return y * self.columns + x
else:
raise ValueError('Index must be 1 or 2 number')

def fill(self, color=0):
"""
Fills all of the DotStars with a color or unlit if empty.

:param color: (Optional) The text or number to display (default=0)
:type color: list/tuple or int

This example shows various ways of using the fill() function

.. code-block:: python

import time
from adafruit_featherwing import dotstar_featherwing

dotstar = dotstar_featherwing.DotStarFeatherWing()
dotstar.fill((255, 255, 255)) # Fill White
time.sleep(1)
dotstar.fill((255, 255, 255, 0.5)) # Fill White Half Brightness
time.sleep(1)
dotstar.fill(0xFF0000) # Fill Red
time.sleep(1)
dotstar.fill() # Clear all lit DotStars

"""
self._dotstar.fill(color)
self._update()

def show(self):
"""
Update the DotStars. This is only needed if auto_write is set to False
This can be very useful for more advanced graphics effects.

This example changes the blink rate and prints out the current setting

.. code-block:: python

import time
from adafruit_featherwing import dotstar_featherwing

dotstar = dotstar_featherwing.DotStarFeatherWing()
dotstar.fill() # Clear any lit Dotstars
dotstar.auto_write = False
dotstar[0, 0] = (255, 255, 255) # Set White
time.sleep(1)
dotstar.show() # Update the DotStars

"""
self._dotstar.show()

def shift_right(self, rotate=False):
"""
Shift all pixels right

:param rotate: (Optional) Rotate the shifted pixels to the left side (default=False)

This example shifts 2 pixels to the right

.. code-block:: python

import time
from adafruit_featherwing import dotstar_featherwing

dotstar = dotstar_featherwing.DotStarFeatherWing()

# Draw Red and Green Pixels
dotstar[5, 3] = (255, 0, 0)
dotstar[6, 3] = (0, 255, 0)

# Rotate it off the screen
for i in range(0, 11):
dotstar.shift_right(True)
time.sleep(.1)

time.sleep(1)
# Shift it off the screen
for i in range(0, 11):
dotstar.shift_right()
time.sleep(.1)

"""
for y in range(0, self.rows):
last_pixel = self._dotstar[(y + 1) * self.columns - 1] if rotate else 0
for x in range(self.columns - 1, 0, -1):
self._dotstar[y * self.columns + x] = self._dotstar[y * self.columns + x - 1]
self._dotstar[y * self.columns] = last_pixel
self._update()

def shift_left(self, rotate=False):
"""
Shift all pixels left

:param rotate: (Optional) Rotate the shifted pixels to the right side (default=False)

This example shifts 2 pixels to the left

.. code-block:: python

import time
from adafruit_featherwing import dotstar_featherwing

dotstar = dotstar_featherwing.DotStarFeatherWing()

# Draw Red and Green Pixels
dotstar[5, 3] = (255, 0, 0)
dotstar[6, 3] = (0, 255, 0)

# Rotate it off the screen
for i in range(0, 11):
dotstar.shift_left(True)
time.sleep(.1)

time.sleep(1)
# Shift it off the screen
for i in range(0, 11):
dotstar.shift_left()
time.sleep(.1)

"""
for y in range(0, self.rows):
last_pixel = self._dotstar[y * self.columns] if rotate else 0
for x in range(0, self.columns - 1):
self._dotstar[y * self.columns + x] = self._dotstar[y * self.columns + x + 1]
self._dotstar[(y + 1) * self.columns - 1] = last_pixel
self._update()

def shift_up(self, rotate=False):
"""
Shift all pixels up

:param rotate: (Optional) Rotate the shifted pixels to bottom (default=False)

This example shifts 2 pixels up

.. code-block:: python

import time
from adafruit_featherwing import dotstar_featherwing

dotstar = dotstar_featherwing.DotStarFeatherWing()

# Draw Red and Green Pixels
dotstar[5, 3] = (255, 0, 0)
dotstar[6, 3] = (0, 255, 0)

# Rotate it off the screen
for i in range(0, 5):
dotstar.shift_up(True)
time.sleep(.1)

time.sleep(1)
# Shift it off the screen
for i in range(0, 5):
dotstar.shift_up()
time.sleep(.1)

"""
for x in range(0, self.columns):
last_pixel = self._dotstar[(self.rows - 1) * self.columns + x] if rotate else 0
for y in range(self.rows - 1, 0, -1):
self._dotstar[y * self.columns + x] = self._dotstar[(y - 1) * self.columns + x]
self._dotstar[x] = last_pixel
self._update()

def shift_down(self, rotate=False):
"""
Shift all pixels down

:param rotate: (Optional) Rotate the shifted pixels to top (default=False)

This example shifts 2 pixels down

.. code-block:: python

import time
from adafruit_featherwing import dotstar_featherwing

dotstar = dotstar_featherwing.DotStarFeatherWing()

# Draw Red and Green Pixels
dotstar[5, 3] = (255, 0, 0)
dotstar[6, 3] = (0, 255, 0)

# Rotate it off the screen
for i in range(0, 5):
dotstar.shift_down(True)
time.sleep(.1)

time.sleep(1)
# Shift it off the screen
for i in range(0, 5):
dotstar.shift_down()
time.sleep(.1)

"""
for x in range(0, self.columns):
last_pixel = self._dotstar[x] if rotate else 0
for y in range(0, self.rows - 1):
self._dotstar[y * self.columns + x] = self._dotstar[(y + 1) * self.columns + x]
self._dotstar[(self.rows - 1) * self.columns + x] = last_pixel
self._update()

def _update(self):
"""
Update the Display automatically if auto_write is set to True
"""
if self._auto_write:
self._dotstar.show()

@property
def auto_write(self):
"""
Whether or not we are automatically updating
If set to false, be sure to call show() to update

This lights DotStars with and without auto_write

.. code-block:: python

import time
from adafruit_featherwing import dotstar_featherwing

dotstar = dotstar_featherwing.DotStarFeatherWing()
dotstar.fill() # Clear any lit Dotstars
dotstar[0, 0] = (255, 255, 255) # Set White
time.sleep(1)

dotstar.auto_write = False
dotstar[1, 0] = (255, 255, 255) # Set White
time.sleep(1)
dotstar.show() # Update the DotStars

"""
return self._auto_write

@auto_write.setter
def auto_write(self, write):
if isinstance(write, bool):
self._auto_write = write

@property
def brightness(self):
"""
Overall brightness of the display

This example changes the brightness

.. code-block:: python

import time
from adafruit_featherwing import dotstar_featherwing

dotstar = dotstar_featherwing.DotStarFeatherWing()
dotstar.brightness = 0
dotstar.fill(0xFFFFFF)
for i in range(0, 6):
dotstar.brightness = (i / 10)
time.sleep(.2)

dotstar.brightness = 0.3

"""
return self._dotstar.brightness

@brightness.setter
def brightness(self, brightness):
self._dotstar.brightness = min(max(brightness, 0.0), 1.0)
self._update()
self._matrix = dotstar.DotStar(clock, data, self.rows * self.columns,
brightness=brightness, auto_write=False)
Loading