Troubleshooting
LEDs Not Lighting Up
- Check wiring — Ensure 5V, GND, and DIN are connected correctly
- Check data pin — Verify your code uses the same pin as your wiring (default: pin 7)
- Check power — Make sure your power supply can deliver enough current
- Check USB — Try a different USB cable or port. Some cables are charge-only
Flickering or Incorrect Colors
- Power supply — Insufficient power causes flickering. Try reducing
MAX_BRIGHTNESSor using a higher-rated supply - Long wires — Keep data wires short. For runs longer than ~50cm, add a 300–500Ω resistor on the DIN line
- Grounding — Ensure all boards share a common ground with the MCU
Only Some LEDs Work
- Daisy-chain break — If LEDs stop at a certain point, check the connection between boards at that position
- NUM_BOARDS setting — Ensure
NUM_BOARDSmatches your actual board count - Damaged LED — A single dead LED can break the chain. The signal passes through each LED in series
USB Power Issues
| Symptom | Likely Cause | Solution |
|---|---|---|
| Board resets when LEDs turn on | Insufficient USB current | Use USB-C 1.5A+ or external 5V PSU |
| Colors look wrong at full brightness | Voltage drop | Reduce brightness or upgrade power supply |
| Works at low brightness but not high | Current limiting | External 5V supply rated for full current |
Library Not Found
- Ensure RobotechPixel is installed via Library Manager
- Check that Adafruit NeoPixel is also installed (dependency)
- Restart Arduino IDE after installing
Serial Monitor Not Working
- Set baud rate to 115200
- Set line ending to "No line ending" or "Newline"
- Make sure your sketch includes
Serial.begin(115200)insetup()
Still Need Help?
Open an issue on GitHub and we'll help you out!
