WS2812B con ESP32 y WLED: conexiones, alimentación y configuración

Qué necesitas

Valores de resistencia y condensador como en la guía NeoPixel de Adafruit y en nuestra calculadora; el umbral de la entrada de datos, de la hoja de datos del WS2812B de Worldsemi.

¿WS2812B a 5 V o WS2815 a 12 V?

El WS2815 lleva sus tres LED en serie y funciona a 12 V, así que con el mismo número de píxeles consume mucha menos corriente. Para 5 m a 60 LED por metro, nuestra calculadora da:

Resultados de nuestra calculadora de fuente para tiras LED con las dos tiras (versión WS2815).

Dimensionar la alimentación

Un píxel WS2812B consume hasta unos 60 mA en blanco total. Cinco metros a 60 LED por metro son 300 LED: 18 A en blanco total, así que la calculadora pide una fuente de 5 V de al menos 21,6 A con un 20 % de margen. Si la dimensionas para efectos típicos, que consumen alrededor de un tercio, bastarían 7,2 A, pero entonces el limitador de brillo de WLED tiene que mantener la tira por debajo de esa corriente.

Elige tu tira y pon su longitud y su densidad: la calculadora te da la fuente, los puntos de alimentación, el fusible y el cable de cada punto y el límite para WLED.Abrir la calculadora de tiras LED

A 5 V, la caída de tensión a lo largo de la tira decide cada cuánto hay que volver a inyectar la alimentación. Para esta tira, la calculadora indica 4 puntos de alimentación separados 1,67 m, extremos incluidos, cada uno con hasta 6 A. Cada punto lleva su propio par de cables desde la fuente y su propio fusible de 7,5 A; para 2 m de cable con un 5 % de caída, la calculadora de sección de cable da 2,5 mm².

Las conexiones

• Masa. Todo comparte una sola masa: fuente, tira y controlador. Si el controlador tiene su propia fuente, une las dos masas. Sin masa común, la señal de datos no tiene referencia y la tira parpadea.
• Datos. GPIO → conversor de nivel (VCC a 5 V) → resistencia → DIN del primer LED. Mantén corto el cable entre el controlador y el primer LED, y pon la resistencia en el lado de la tira. Sigue las flechas impresas en la tira: los datos solo van en un sentido.
• Alimentación. Un par de cables independiente desde la fuente a cada punto, cada uno con su fusible, en lugar de un solo cable encadenado a lo largo de la tira.
• Condensador. Entre + y − donde la alimentación entra primero en la tira, respetando la polaridad.
• Orden. Conecta primero la masa, luego la alimentación y después los datos, y da tensión a los LED antes que al controlador.

El WS2815 se conecta igual, a 12 V. Con un WS2815B-V1, la señal de datos de 3,3 V del ESP32 suele funcionar directamente, así que a menudo se puede prescindir del conversor de nivel; añádelo si los primeros LED parpadean o muestran colores equivocados. Eso sí, el controlador necesita entonces su propia alimentación de 5 V, de un pequeño convertidor reductor de 12 a 5 V, porque el pin de 5 V de una placa de desarrollo está pensado para 5 V.

Seguridad

• Fuentes de red dentro de una caja. Las fuentes abiertas para LED llevan los bornes de red al aire. Móntalas en una caja cerrada, con un prensaestopas en cada cable y la toma de tierra conectada, y deja las conexiones a la red a un profesional cuando la normativa lo exija.
• Un fusible por rama. Dimensiona cada fusible según su cable, como hace la calculadora, para que se funda también con un cortocircuito al final de la tira.
• Una sola alimentación a la vez para la placa. En el esquema, el ESP32 toma los 5 V de la fuente de la tira por su pin de 5 V. La guía de Espressif para la DevKitC dice que la placa debe alimentarse desde una sola fuente; si no, la placa o la fuente pueden dañarse. Graba WLED y haz la primera configuración por USB antes de conectar ese cable de 5 V, y desconéctalo siempre que vuelvas a enchufar el USB; el cable de masa puede quedarse conectado.
• Nunca alimentes la tira a través de la placa. El pin de 5 V de una placa de desarrollo lleva la corriente del USB por pistas finas; la propia documentación de WLED dice que, si los LED se alimentan de ahí, el límite debe quedar por debajo de 1 A. Alimenta la tira directamente desde la fuente.
• Calor. En blanco total las tiras se calientan: en tramos largos, móntalas sobre un perfil de aluminio y comprueba que la fuente esté ventilada.

Instalar WLED

Abre el instalador web en install.wled.me con un navegador que tenga Web Serial: Chrome, Edge, Opera de escritorio, o Firefox a partir de la versión 151. Safari y los navegadores del móvil no funcionan. Conecta la placa con un cable USB de datos, elige la versión (la 16.0.1 es la última estable, de julio de 2026), pulsa Install y selecciona el puerto serie de la placa. Hazlo sin el cable de 5 V que une la placa con la fuente de la tira: una sola alimentación a la vez.

• ¿No aparece ningún puerto? Prueba otro cable y luego instala el controlador del chip USB de la placa: CH34x (WCH) o CP210x.
• ¿Sigue sin aparecer? Mantén pulsado el botón BOOT de la placa mientras la conectas.
• Tras grabarla, el instalador puede ofrecerte configurar el Wi-Fi en ese momento. Si no lo hace, usa el punto de acceso que se explica más abajo.

Las actualizaciones posteriores no necesitan cable: Config → Security & Updates acepta un firmware nuevo por Wi-Fi. Antes, desde esa misma página, haz una copia de seguridad de la configuración y de los preajustes.

Primera configuración

1. Sin Wi-Fi configurado, WLED abre un punto de acceso llamado WLED-AP. Conéctate con la contraseña wled1234.
2. Abre 4.3.2.1 en el navegador si la página de configuración no aparece sola.
3. Ve a WiFi settings, busca o escribe el nombre de tu red e introduce su contraseña. La red tiene que ser de 2,4 GHz.
4. Ponle un nombre mDNS, por ejemplo mesa, para encontrarlo luego en mesa.local, y cambia la contraseña del punto de acceso, que por defecto es wled1234.
5. Pulsa Save & Connect. WLED se une a tu red; lo encontrarás por su nombre mDNS o en el router.

Los ajustes de los LED

Abre Config → LED & Hardware antes que nada: WLED no conoce tu tira hasta que se lo dices.

• Type: WS281x, tanto para un WS2812B como para un WS2815.
• GPIO: el pin de datos, mira la tabla de abajo; Config → Pin Info muestra todos los pines y qué los está usando.
• Length: el número de LED, 300 en nuestro ejemplo.
• Color Order: GRB, el valor por defecto, para la mayoría de las tiras WS2812B. Si el rojo sale verde, prueba los demás.
• Limitador automático de brillo (Enable automatic brightness limiter): déjalo activado. En Maximum PSU Current pon el valor que da nuestra calculadora de fuente para tiras LED: 18.000 mA con la fuente de nuestro ejemplo, dimensionada para blanco total, o 6000 mA con una dimensionada para efectos típicos; WLED acepta de 250 a 65.000 mA. Ajusta también mA/LED como indica la calculadora: Custom con 60 mA para un WS2812B, o la opción «12mA (WS2815)».
• Los segmentos dividen la tira en partes con su propio efecto y color; los preajustes (presets) guardan un efecto con sus colores y su brillo, y Apply preset at boot elige con cuál arranca la tira.

Pines de arranque (strapping) y reservados, de nuestras páginas de pinout del ESP32, la ESP32-C3 SuperMini, el ESP32-S3 y la D1 mini; pines del ESP8266, de la documentación de WLED.

Home Assistant

Home Assistant suele descubrir WLED en la red: aparece en Configuración → Dispositivos y servicios, en el apartado Descubierto. Si no, pulsa Añadir integración, elige WLED e introduce el nombre de host o la dirección IP. La integración necesita WLED 0.14 o posterior.

La integración crea una entidad de luz para la tira; con dos o más segmentos, una por segmento más una luz principal para el encendido y el brillo general. Hay entidades de selección para preajustes, listas de reproducción y paletas, entidades numéricas para la velocidad y la intensidad de los efectos, y una entidad de actualización del firmware que ofrece las versiones estables de WLED.

Solución de problemas

El tono rosa o naranja al final de la tira es la señal típica de que faltan puntos de alimentación.