LED Ambient Lamp (WLED / ESP32 D1 Mini USB-C)

A small and compact ambiance light powered by a USB-C ESP32 D1 Mini and a WS2812B LED Ring, running WLED for full RGB lighting control.

Bill of Materials

The lamp was designed to perfectly fit the following components:

• USB-C ESP32 D1 Mini from AZ-Delivery
• 50mm WS2812B LED Ring from AZ-Delivery

You’ll need to solder the LED ring to the ESP32 using three short wires.

Printing recommandations

• The diffuser is meant to be printed upside down on a smooth build plate. Using a textured plate will alter the surface finish and reduce light diffusion quality.
• Any build plate type will work fine for the base and the LED ring holder.

Instructions

1. LED Ring

Solder first three wires to the LED Ring, facing toward the center of the ring. Do not connect them to the ESP32 yet.

You will need to connect:

• LED Ring GND
• LED Ring 5V
• LED Ring DI

Next, assemble the LED Ring with the LED Ring holder. The wires should pass through the center of the ring.

2. ESP32 D1 Mini

Once the LED Ring is in place, solder the wires to the ESP32, making sure they come through the back of the LED Ring.

Solder the LED Ring to the ESP32 as follows:

• LED Ring GND → ESP32 GND
• LED Ring 5V → ESP32 5V
• LED Ring DI → ESP32 IO16 (as recommended by the WLED documentation) 

Then follow the official WLED documentation to install WLED on your ESP32:

• WLED installed site (recommanded method)
• WLED documentation

3. Lamp Base

Mount the ESP32 into the base.

Insert the USB-C connector first, then gently push the antenna side past the retaining clips.

If you need to remove the ESP32, you can push it out through the bottom access hole (a pen works well):

Finally, clip the LED Ring to the base.Finally, clip the LED Ring to the base.

4. Lamp

Place the diffuser on the top of the lamp base, and you're done!

5. Bonus: Fancier Diffuser (using AMS or manual filament swap).

Using an AMS, you can print a few layers of the diffuser with a non–light-diffusing color (e.g., black) to enhance the lamp’s appearance.
Check out the alternative profile with a preconfigured two-color diffuser for a result like the one shown below (on the right).

6. Bonus: Home-Assistant Automations

This lamp can easily be integrated into Home Assistant or any WLED-compatible automation setup.

You might be especially interested in:

• The official WLED integration