PicoFX - A RGB and Mono LED effects system for MicroPython

This repository is home to the PicoFX library, as well as MicroPython builds for supported boards like the Pimoroni Tiny FX.

• Introduction
• Download MicroPython for TinyFX
  • Firmware Only
  • With Libraries and Examples
• Flashing the Firmware
• Examples
• Documentation

Introduction

PicoFX is a MicroPython library for easily playing effects on mono and RGB leds.

Download MicroPython for TinyFX

All Tiny FX boards come pre-flashed with MicroPython and the libraries and examples needed to get you started. The instructions below are for if you wish to update your board to the latest firmware or restore it back to a factory state.

Grab the latest release from https://github.com/pimoroni/picofx/releases/latest

There are two .uf2 files to pick from:

Firmware Only

• tinyfx-vX.X.X-pimoroni-micropython.uf2

This build includes only the firmware needed for Tiny FX to function. You will need to manually update the lib/picofx library afterwards to get the latest features and bug fixes.

With Libraries and Examples

⚠️ This option will overwrite the entire contents of your TinyFX! Be sure to back up files to your PC before installing!

• tinyfx-vX.X.X-pimoroni-micropython-with-libs-and-examples.uf2

This build contains both the firmware for TinyFX, library files to easily create effects, and examples to get you going.

Flashing the Firmware

1. Connect Tiny FX to your computer using a USB A to C cable.

2. Put your board into bootloader mode by holding the BOOT button whilst tapping the RST button.

3. Drag and drop one of the tinyfx-vX.X.X... .uf2 files to the "RPI-RP2" drive that appears.

4. After the copy completes your board should reset and, if you used the with-libs-and-examples variant, should start playing a wave sequence on the mono outputs, and a rainbow on the RGB output.

Examples

There are many examples to get you started with TinyFX (and other boards), located in the examples folder of this repository:

• Examples: Tiny FX
• Examples: Plasma

Documentation

To take TinyFX further, the full API documentation for the board can be found at:

• Library Reference