K1 Lightwave Firmware Rewrite

ESP32-S3 firmware prototype for K1 Lightwave audio-reactive LED control.

What It Does

• Captures audio from an I2S microphone.
• Drives WS2812 LED strips with FastLED.
• Provides serial control and diagnostics.
• Supports ESP-NOW peer-to-peer synchronisation experiments.
• Builds with PlatformIO for ESP32-S3 targets.

Build

Install PlatformIO, then build one of the tracked environments:

pio run -e esp32-s3-16mb
pio run -e esp32-s3-sph0645

Upload after confirming the intended device port:

pio device list
pio run -e esp32-s3-sph0645 --target upload --upload-port <PORT>

Monitor serial output:

pio device monitor --baud 230400 --port <PORT>

Layout

• src/ - firmware source.
• simulation/ - audio-analysis helper scripts and generated plots retained with the prototype.
• docs/ - technical notes retained for the public prototype.
• platformio.ini - PlatformIO environments.
• partitions_16MB_ota.csv - tracked 16 MB OTA partition table required by both build environments.

Documentation

Start with docs/README.md for the retained technical notes.

Licence

No licence file is currently published for this repository. Do not assume reuse rights until a licence is added.