• LED
  • Beginner
  • 3 min
  • Serial CLI

Recipe · Beginner · LED

How to configure an addressable LED strip

Configure LED pin, protocol, brightness and strip length before running color tests on WS2812, SK6812, APA102 or similar LEDs.

Addressable LED strip test pattern.
A practical ESP32 Bit Pirate workflow based on the documented firmware commands.

Wiring View

BP DIN/DATALED data pinGNDGND5V/3.3V powerLED strip power...CLKclock pin only ...
Generated from the wiring summary: to BP.
Step 1

Commands

Run the workflow from the CLI after selecting the matching mode.

Result

What it means

The output confirms that the protocol path is working and gives you a baseline for deeper experiments.

Troubleshooting

  • If colors are wrong, try another protocol or color order.
  • If only the first LED works, check strip length and data direction.
  • If the board resets, reduce brightness or use external LED power.

Next steps

  • Use set for individual pixels.
  • Try rainbow or chase animations.
  • Save the working protocol and pinout.

addressable LED strip configuration FAQ

What does LED config set?

It sets the data pin, LED count, brightness and protocol so later fill, set and animation commands use the same strip assumptions.

How do I choose the right LED protocol?

Start with the strip type if you know it, such as WS2812, SK6812 or APA102. If colors flicker or do not latch, use setprotocol and try the closest FastLED-compatible chipset.

Why configure brightness before fill or set commands?

Brightness sets the test intensity used by later LED actions. Choosing it early keeps first visual checks controlled while you confirm protocol, color order and strip length.

Go deeper