Common Troubleshooting Issues
Troubleshooting LED Installations
Symptom → Cause → Fix
| Symptom | Likely Cause | Fix |
|---|---|---|
| First pixel is wrong color | Data line too close to power; missing resistor | Add 330-470Ω resistor on data line; separate data wire from power |
| Flickering at high brightness | PSU undersized | Calculate actual current draw; get bigger PSU |
| Flickering at low brightness | PWM frequency too low | Use higher PWM chip (APA107, GS8208); increase frequency in firmware |
| Strip dim at far end | Voltage drop | Inject power at far end; use thicker wire |
| Colors are wrong (swap) | Wrong color order | Change color order in firmware (GRB→RGB→BRG→etc.) |
| ESP32 not connecting | WiFi channel/firmware issue | USB flash latest WLED; check 2.4GHz only |
| Random pixels glitching | Power issue; data signal interference | Check PSU voltage under load; shield data cable; add ferrite bead |
| No LEDs light up | No power; wrong pin | Check PSU output with multimeter; confirm GPIO pin in firmware |
| LEDs stay on when off | Data line voltage level | Pull data pin to GND with 10kΩ resistor |
| Entire strip is white (no control) | Data line not connected | Check data wire from controller to strip DIN |
Diagnostic Tools
| Tool | What it checks | Price |
|---|---|---|
| Digital multimeter | Voltage at strip start/end | $10-30 |
| ESP32 + WLED test | Each pixel individually | $5-10 |
| LED test pixel | Insert before strip to check signal | $1 |
| Logic analyzer | Data signal timing (advanced) | $15-100 |