Convergence

Ambient LED control system running on a Raspberry Pi Zero W 2 — synchronised output across a 200+ addressable Neopixel string and an RGB LED matrix.

Hardware

• Raspberry Pi Zero W 2
• RGB LED matrix — driven via rpi-rgb-led-matrix
• 200+ WS281x addressable Neopixels — driven via rpi_ws281x

How it works

Pattern sequences are generated algorithmically in Python and written to a matrix output file. run_all.sh coordinates both LED systems, running the matrix driver and Neopixel strand in parallel. Patterns can be hot-swapped by editing the output file or replacing the generation script.

Setup

Flash a lite Raspbian image to microSD. Headless setup (SSH over Ethernet) is supported.

# rpi-rgb-led-matrix: https://github.com/hzeller/rpi-rgb-led-matrix
# rpi_ws281x: pip install rpi_ws281x

git clone https://github.com/Existentialist-Robot/Convergence
cd Convergence
sudo bash run_all.sh

Note: LED matrix control requires root (sudo) for direct hardware access.

Files

File	Purpose
strand.py	Neopixel pattern generation and control
matrix_strand.sh	Matrix driver launch script
run_all.sh	Orchestrates both LED systems
Arduino_RE_V1.m	MATLAB prototype (early iteration)