Additional colour and static examples

examples/tiny_fx/README.md

@@ -7,6 +7,7 @@ These are micropython examples for the Pimoroni [TinyFX](https://shop.pimoroni.c
   - [Sensor Meter](#sensor-meter)
   - [Voltage Meter](#voltage-meter)
 - [Mono Effect Examples](#mono-effect-examples)
+  - [Static Brightness](#static-brightness)
   - [Single Blink](#single-blink)
   - [Single Flashing](#single-flashing)
   - [Single Flicker](#single-flicker)
@@ -18,6 +19,9 @@ These are micropython examples for the Pimoroni [TinyFX](https://shop.pimoroni.c
   - [Binary Counter](#binary-counter)
   - [Traffic Light](#traffic-light)
 - [Colour Effect Examples](#colour-effect-examples)
+  - [Static RGB](#static-rgb)
+  - [Static HSV](#static-hsv)
+  - [Blink](#blink)
   - [Rainbow](#rainbow)
   - [Random](#random)
   - [Hue Step](#hue-step)
@@ -55,6 +59,12 @@ Use TinyFX's mono outputs as a bargraph to show the voltage that is powering the
 
 ## Mono Effect Examples
 
+### Static Brightness
+[effects/mono/static_brightness.py](examples/effects/mono/static_brightness.py)
+
+Show a static brightness on one of TinyFX's outputs.
+
+
 ### Single Blink
 [effects/mono/single_blink.py](examples/effects/mono/single_blink.py)
 
@@ -117,6 +127,23 @@ Play a traffic light sequence on TinyFX's outputs.
 
 ## Colour Effect Examples
 
+### Static RGB
+[effects/colour/static_rgb.py](examples/effects/colour/static_rgb.py)
+
+Show a static colour on TinyFX's RGB output.
+
+
+### Static HSV
+[effects/colour/static_hsv.py](examples/effects/colour/static_hsv.py)
+
+Show a static colour on TinyFX's RGB output, using HSV.
+
+
+### Blink
+[effects/colour/blink.py](examples/effects/colour/blink.py)
+Play a blinking sequence effect on TinyFX's RGB output. Each blink in the sequence can be a different colour.
+
+
 ### Rainbow
 [effects/colour/rainbow.py](examples/effects/colour/rainbow.py)
 

examples/tiny_fx/examples/effects/colour/blink.py

@@ -0,0 +1,35 @@
+from tiny_fx import TinyFX
+from picofx import ColourPlayer
+from picofx.colour import RGBBlinkFX, RED, YELLOW, GREEN, CYAN, BLUE, MAGENTA
+
+"""
+Play a blinking sequence effect on TinyFX's RGB output. Each blink in the sequence can be a different colour.
+
+Press "Boot" to exit the program.
+"""
+
+# Constants
+COLOURS = [RED, YELLOW, GREEN, CYAN, BLUE, MAGENTA]
+
+# Variables
+tiny = TinyFX()                         # Create a new TinyFX object to interact with the board
+player = ColourPlayer(tiny.rgb)         # Create a new effect player to control TinyFX's RGB output
+
+
+# Create and set up a rainbow effect to play
+player.effects = RGBBlinkFX(colour=COLOURS,     # The colour (or colours to blink in sequence)
+                            speed=0.5)          # The speed to cycle through colours at, with 1.0 being 1 second
+
+
+# Wrap the code in a try block, to catch any exceptions (including KeyboardInterrupt)
+try:
+    player.start()   # Start the effects running
+
+    # Loop until the effect stops or the "Boot" button is pressed
+    while player.is_running() and not tiny.boot_pressed():
+        pass
+
+# Stop any running effects and turn off all the outputs
+finally:
+    player.stop()
+    tiny.shutdown()

examples/tiny_fx/examples/effects/colour/static_hsv.py

@@ -0,0 +1,34 @@
+from tiny_fx import TinyFX
+from picofx import ColourPlayer
+from picofx.colour import HSVFX
+
+"""
+Show a static colour on TinyFX's RGB output, using HSV.
+
+Press "Boot" to exit the program.
+"""
+
+# Constants
+HUE = 0.0       # The colour's hue (from 0.0 to 1.0)
+SAT = 1.0       # The colour's saturation (from 0.0 to 1.0)
+VAL = 1.0       # The colour's value/brightness (from 0.0 to 1.0)
+
+# Variables
+tiny = TinyFX()                     # Create a new TinyFX object
+player = ColourPlayer(tiny.rgb)     # Create a new effect player to control TinyFX's RGB output
+
+# Set up the colour effect to play
+player.effects = HSVFX(HUE, SAT, VAL)
+
+# Wrap the code in a try block, to catch any exceptions (including KeyboardInterrupt)
+try:
+    player.start()   # Start the effects running
+
+    # Loop until the effect stops or the "Boot" button is pressed
+    while player.is_running() and not tiny.boot_pressed():
+        pass
+
+# Stop any running effects and turn off all the outputs
+finally:
+    player.stop()
+    tiny.shutdown()

examples/tiny_fx/examples/effects/colour/static_rgb.py

@@ -0,0 +1,34 @@
+from tiny_fx import TinyFX
+from picofx import ColourPlayer
+from picofx.colour import RGBFX
+
+"""
+Show a static colour on TinyFX's RGB output.
+
+Press "Boot" to exit the program.
+"""
+
+# Constants
+R = 255     # The amount of red (from 0 to 255)
+G = 0       # The amount of green (from 0 to 255)
+B = 0       # The amount of blue (from 0 to 255)
+
+# Variables
+tiny = TinyFX()                     # Create a new TinyFX object
+player = ColourPlayer(tiny.rgb)     # Create a new effect player to control TinyFX's RGB output
+
+# Set up the colour effect to play
+player.effects = RGBFX(R, G, B)
+
+# Wrap the code in a try block, to catch any exceptions (including KeyboardInterrupt)
+try:
+    player.start()   # Start the effects running
+
+    # Loop until the effect stops or the "Boot" button is pressed
+    while player.is_running() and not tiny.boot_pressed():
+        pass
+
+# Stop any running effects and turn off all the outputs
+finally:
+    player.stop()
+    tiny.shutdown()

examples/tiny_fx/examples/effects/mono/static_brightness.py

@@ -0,0 +1,43 @@
+from tiny_fx import TinyFX
+from picofx import MonoPlayer
+from picofx.mono import StaticFX
+
+"""
+Show a static brightness on one of TinyFX's outputs.
+
+Press "Boot" to exit the program.
+"""
+
+# Constants
+BRIGHTNESS = 1.0    # The brightness (from 0.0 to 1.0)
+
+# Variables
+tiny = TinyFX()                     # Create a new TinyFX object to interact with the board
+player = MonoPlayer(tiny.outputs)   # Create a new effect player to control TinyFX's mono outputs
+
+
+# Create and set up a blink effect to play
+player.effects = [
+    StaticFX(BRIGHTNESS),
+
+    # No effects played on the rest of the outputs (unnecessary to list, but show for clarity)
+    None,
+    None,
+    None,
+    None,
+    None,
+]
+
+
+# Wrap the code in a try block, to catch any exceptions (including KeyboardInterrupt)
+try:
+    player.start()   # Start the effects running
+
+    # Loop until the effect stops or the "Boot" button is pressed
+    while player.is_running() and not tiny.boot_pressed():
+        pass
+
+# Stop any running effects and turn off all the outputs
+finally:
+    player.stop()
+    tiny.shutdown()

picofx/__init__.py

@@ -5,7 +5,7 @@
 from machine import Pin, PWM, Timer
 
 
-PICOFX_VERSION = "1.0.0"
+PICOFX_VERSION = "1.0.1"
 
 
 def rgb_from_hsv(h, s, v):
@@ -96,6 +96,34 @@ def reset(self):
         self.__offset = 0
 
 
+class CyclingAction(Updateable):
+    def __init__(self, speed):
+        self.speed = speed
+        self.__offset_ms = 0
+        self.__offset = 0
+
+    def next(self):
+        pass
+
+    def prev(self):
+        pass
+
+    def tick(self, delta_ms):
+        self.__offset_ms += int(delta_ms * self.speed)
+        if self.__offset_ms >= 1000:
+            self.__offset_ms -= 1000
+            self.next()
+        elif self.__offset_ms < 0:
+            self.__offset_ms += 1000
+            self.prev()
+
+        self.__offset = self.__offset_ms / 1000
+
+    def reset(self):
+        self.__offset_ms = 0
+        self.__offset = 0
+
+
 class EffectPlayer:
     DEFAULT_FPS = 100
 

picofx/colour/__init__.py

@@ -2,6 +2,7 @@
 #
 # SPDX-License-Identifier: MIT
 
+from .blink import RGBBlinkFX
 from .colour import RGBFX, HSVFX
 from .rainbow import RainbowFX, RainbowWaveFX
 from .step import HueStepFX
@@ -20,5 +21,6 @@
     HSVFX,
     RainbowFX,
     RainbowWaveFX,
-    HueStepFX
+    HueStepFX,
+    RGBBlinkFX
 ]

picofx/colour/blink.py

@@ -0,0 +1,48 @@
+# SPDX-FileCopyrightText: 2024 Christopher Parrott for Pimoroni Ltd
+#
+# SPDX-License-Identifier: MIT
+
+from picofx import CyclingAction
+
+
+# Derived from maltheim's example: https://forums.pimoroni.com/t/rgb-led-kit-for-tiny-fx-tutorial/25293/15
+class RGBBlinkFX(CyclingAction):
+    """
+    Blinks the RGB LED according to the speed, phase and duty cycle.
+
+    The colour argument is a single tuple of the form (R,G,B), or a
+    list of such tuples. A None colour argument defaults to red.
+
+    :param:   colour  an RGB tuple as the colour or colours of the blink
+    :param:   speed   the speed of the blink, where 1.0 is 1 second, 0.5 is 2 seconds, etc.
+    :param:   phase   the phase of the blink
+    :param:   duty    the duty cycle of the blink
+    """
+    def __init__(self, colour=None, speed=1, phase=0.0, duty=0.5):
+        super().__init__(speed)
+        self.phase = phase
+        self.duty  = duty
+        self.__colours = []
+        self.__index = 0
+        if colour is None:
+            self.__colours.append((255, 0, 0))
+        elif isinstance(colour, tuple) and len(colour) == 3:
+            self.__colours.append(colour)
+        elif isinstance(colour, list):
+            self.__colours.extend(colour)
+        else:
+            raise TypeError("colour is not a supported type. Expected a tuple of 3 numbers, a list of tuples, or None.")
+
+    def __call__(self):
+        percent = (self.__offset + self.phase) % 1.0
+        if percent < self.duty:
+            colour = self.__colours[self.__index]
+            return int(colour[0]), int(colour[1]), int(colour[2])
+        else:
+            return 0, 0, 0
+
+    def next(self):
+        self.__index = (self.__index + 1) % len(self.__colours)
+
+    def prev(self):
+        self.__index = (self.__index - 1) % len(self.__colours)