Files

Claude 530e9da957 feat(01-04): wire all subsystems in main.cpp + protocol documentation

- initStrips() → initAnimationEngine() → WiFi → WIFI_PS_NONE → startUdpServer() order
- loop() handles WiFi reconnect: re-enables WIFI_PS_NONE, restarts UDP server
- Startup breathing animation fires during WiFi connect (D-11 compliance)
- D-10 WiFi timeout: continues last animation on disconnect, UDP auto-restarts
- docs/protocol.md: all 8 animations, all commands, zones, port 4210, error handling

2026-04-03 13:32:43 +02:00

2.4 KiB

Raw Blame History

ESP32 LED Controller — UDP Protocol Reference

Version: 1 ("v":1 required in every command) Transport: UDP Port: 4210 Max payload: 512 bytes

Zones

Zone value	Strip	LEDs	Protocol
`"schrank"`	WS2801 (Schrank, cabinet)	160	SPI RGB
`"wand"`	SK6812 (Wand, wall)	300	RMT RGBW
`"all"`	Both strips	460	—

Commands

Run Animation

{"v":1,"zone":"wand","animation":"chase","params":{"speed":0.5,"intensity":1.0,"colors":[[255,0,0,0]]}}

Fields:

zone (required): "schrank", "wand", or "all"
animation (required): see Animation List below
params.speed (optional, 0.0–1.0, default 0.5): animation tempo multiplier
params.intensity (optional, 0.0–1.0, default 1.0): brightness multiplier
params.colors (optional): array of [R,G,B,W] arrays (W=0 → auto-derived on RGBW strip)
params.direction (optional, 0 or 1): forward/reverse

Stop Animation

{"v":1,"cmd":"stop","zone":"all"}

Set Brightness

{"v":1,"cmd":"brightness","zone":"all","value":40}

value: 0–60 (firmware enforces max 60% for safety)

Query Status

{"v":1,"cmd":"status"}

Response (UDP to sender IP:port):

{"v":1,"status":"ok","wand":"chase","schrank":"breathe","brightness":40}

Animation List

Name	Effect	Key params
`chase`	Moving window of lit LEDs along strip	speed, colors[0]
`pulse`	All LEDs pulse to sine wave	speed, colors[0]
`rainbow`	HSV rainbow sweeps across strip	speed
`strobe`	Rapid on/off flash	speed (flash rate), colors[0]
`color_wash`	Cross-fades through palette colors	speed, colors[]
`breathe`	Slow brightness inhale/exhale	speed, colors[0]
`sparkle`	Random pixels flash	intensity, colors[0]
`gradient_sweep`	Gradient between 2 colors sweeps	speed, colors[0..1]

Error Handling

Unknown commands → silently ignored, logged to ESP32 serial console
Malformed JSON → silently dropped, logged to serial console
Wrong version ("v" != 1) → dropped
No UDP error responses on error (check serial console for debugging)

Timing

Animation tick rate: 50fps (20ms)
UDP → animation start latency: <50ms (queue drain on next tick)
WiFi disconnect: last animation continues, UDP server restarts on reconnect

2.4 KiB Raw Blame History Unescape Escape