Using the GPIO solder pads (IO6, IO7, IO10)

The MagWLED-1 exposes three GPIO solder pads on the board: IO6, IO7, and IO10. These are general-purpose I/O pins on the ESP32-C3 and can be used for various purposes through WLED’s configuration.

Common uses

Button / trigger input

Solder a momentary button between a GPIO pad and GND. In WLED: Config → Usermods → Button — assign the pin and configure what it does (change preset, toggle on/off, etc.).

Motion sensor (PIR/IR)

Connect the signal output of a PIR motion sensor to a GPIO pad. The MagWLED-1 breakout header provides both 3.3V (200mA max) and 5V (100mA max) power rails, so you can power PIR sensors that require either voltage directly from the board. Configure the GPIO in WLED’s button/sensor settings to trigger presets on motion. See the WLED PIR sensor documentation for wiring and configuration details.

Relay control

The GPIO pins can sink/source about 20mA each, which is enough to drive most relay modules directly. In WLED, use a timed preset or macro to set the GPIO high/low. For higher current relay coils, use a transistor or a relay module with its own driver IC.

Additional LED data output

Yes — the GPIO pads can be used as additional data outputs for a second LED strip. In WLED: Config → LED Preferences → Add LED strip and assign the pin. Note that the GPIO pads output 3.3V logic (not level shifted to 5V).

Pin reference

If you’re using AudioReactive with an external microphone, IO7 and IO10 are used for I2S clock and data. Use IO6 for your external connections in that case.

For full details on connecting an external microphone, see Adding a microphone for AudioReactive effects.