markroland / dotstar-sequences

This project contains scripts that perform lighting effect sequences for Adafruit Dotstar LED strips

Adafruit Dotstar Sequence Scripts

This project contains scripts that perform lighting effect sequences for Adafruit Dotstar LED strips.

"Cuttlefish" Sequence Video

"Cuttlefish" Sequence Simulation

Hardware Recommendations

• Raspberry Pi 3
• Adafruit Dotstar LED Strip
• Breadboard
• Jumber Wires
• Power Supply

Software Recommendations

• Python 3.5+
• Adafruit CircuitPython

Circuit

TBD

Usage

Setup

Copy and set the .env Environment file for your configuration

cp .env.example .env

Run

python3 play.py cuttlefish

Folder Descriptions

data

Contains static data to be read in for rendering a sequence

demo

Contains project documentation resources

pattern

Python modules for static lighting patterns

sequence

Python modules for animated lighting sequences

server

A web server for controller lighting sequences remotely

python3 ./server/index.py

Script Descriptions

play.py

demo.py

schedule.py

Run this script continuously with different sequences scheduled for each day.

simulate.py

Render a Sequence to an animated GIF image.

Simulator

This code includes a browser-based simulator to display the lighting sequences. It uses Node and Three.js.

From the simulator directory:

npm install
npx vite

Once Vite is running you can view the simulator in your browser. Vite should tell you a URL to load, like http://localhost:5173.

Resources

• Adafruit DotStar LEDs
• CircuitPython DotStar
• Blinka Test Script

License

This work is licensed under a Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0) License.

This work makes use of the Adafruit CircuitPython DotStar library.