Instructivo sobre la utilización de WLED para estudiantes de Diseño de espacios y objetos de la Universidad del Desarrollo.
- Esp32 devkit
- Fuente de poder 12v
- Tira led 5v/12v compatible (listado de tiras compatibles)
- Dispositivo de control (Celular o Computador)
Primero se debe conectar la placa Esp32 vía USB al computador. En un navegador compatible se abre la página para instalar el código en la placa (instalador web).
Navegador no compatible:
Navegador compatible:
Luego se selecciona la versión a instalar, y se presiona el botón Install, tras ello la página solicitará seleccionar el puerto serial en el cuál realizar la instalación, es decir en qué dispositivo conectado al equipo se subirá el programa, por lo mismo se debe saber cual de los puertos es el ocupado por el Esp32, esto se puede averiguar desconectando y conectando el USB, el que desaparezca y aparezca es el correcto.
Se Presiona el botón conectar, tras esto va a aparecer una ventana de carga que dice Connecting, y aparecerá la opción Install WLED y Logs & Console, la primera es para insalar wled en el Esp32, y el segundo para visualizar la información mandada por el Esp32 a travéz del puerto serial. Si se presiona Install WLED pedirá confirmar la acción, y si se confirma la página comenzará a preparar la instalación.
Luego mostrará el porcentaje de la instalación, se debe esperar en la página que ocurra este proceso, y al final aparece el mensaje de instalación completa; se presiona Next y a continuación se debe realizar la configuración de red, se selecciona el nombre de la red o se escribe si no aparece, y se ingresa la contraseña adecuada.
Por último, teniendo instalado el software y configurada la red se puede acceder a la interfaz de WLED, cuyo uso se explica en el Proceso de Configuración. A continuación se explica el armado del dispositivo.
Para armar este dispositivo, lo primero que hay que hacer es identificar los pines del Esp32, el pin de entrada de voltaje (VIN - 5v), el pin de salida de voltaje (3V3 - 3.3v), los pines de tierra (GND), y los pines de señal (D2, D3, D4... en adelante); por otro lado hay que identificar los cables de la tira led, que debe contar con: entrada de voltaje (5v/12v), tierra (GND), y señal digital entrada (Din) en la que se debe ver la dirección en la que apunta la flecha para luego realizar la conexión; en el caso de que la tira LED sea de un voltaje distinto a 5v o si con la alimentación del ESP32 no es suficiente, entoces hay que conectar una fuente de poder del voltaje de la tira led; en la fuente de poder al igual que en los otros elementos hay que identificar las salidas y entradas a usar, para la realización de esta documentación se usó una fuente de alimentación de 12 voltios (12V), 6 amperios (6A), y 75 vatios (75W) FAP-75-12V-S; dicha fuente cuenta con las conexiones para la corriente alterna 220v de la red eléctrica a un extremo, y al otro tien las conexiones a las tiras led.
La conexión entre la tira led y el Esp32 es mediante el cable de señal que debe conectar la entrada digital (Din) de la tira led con uno de los pines de señal del Esp32 (D2, D3, D4... en adelante) esto luego se debe configurar en la interfaz de wled, 5v y GND de la tira deben ir conectados o al VIN y GND del Esp32 o, si es necesario a lo correspondiente en la fuente de alimentación, que sería v+ el 12v y al v- el gnd, pero ojo también es necesario conectar el v- de la fuente al gnd del controlador ESP32.
Con eso ya se puede realizar el proceso de configuración, y se recomenda leer esa etapa antes de conectar otros elementos.
Si se quisieran añadir más elementos, como sensores de presencia, botones, u otros sensores se deben realizar lo siguiente, en lo que se revisará el uso de 3 tipos de sensores, en el caso de que se quiera usar un sensor distinto a los que se muestran aquí se recomienda el video de ResinChem Tech Level Up Your WLED Projects: A Guide to adding Components (no code) (en este también estan los que se ven aquí).
Para esta etapa se recomienda usar Cables duPont y Protoboard, ya que facilitan las conexiones.
Se conecta un lado del botón a un pin de señal del Esp32 y el otro a la tierra. El resto es configurar el funcionamiento de este sensor, desde la interfaz de wled.
- configurar las conexiones en LED Preferences. 🔗
- configurar las funciones de interacción en Time & Macros. 🔗
Se conecta el GND del sensor a GND del Esp32 o de la fuente de poder, se conecta el VCC del sensor a VIN del Esp32 o a los 5v de la fuente de poder, y se conecta el OUT del sensor a un pin de señal del Esp32. El resto es configurar el funcionamiento de este sensor, desde la interfaz de wled.
- configurar las conexiones en LED Preferences. 🔗
- configurar las funciones de interacción en Time & Macros. 🔗
Para hacer que el dispositivo funcione de manera reactiva al audio se recomienda usar micrófonos específicos (manual del audioreactive), sin embargo para la prueba de esta funcionalidad se utilizó un módulo de micrófono para arduino del tipo KY-037, se espera en el futuro documentar el uso con el MAX4466 y el MAX9814. Continuando con el uso del KY-037, se conecta el + del sensor al VIN del Esp32 o a 5v de la fuente de poder; el G del sensor a GND del Esp32 o el GND de la fuente de poder; y se conecta la salida digital del KY-037 (DO) a un pin de señal del Esp32. Luego de ello se debe configurar el sensor desde el menú de Usermods🔗.
Tras configurar el microfono en Usermods se puede probar el funcionamiento del dispositivo seleccionando un efecto que tenga el ícono ♪, se recomenda probar con Pixels 🎨⋮♪. El KY-037 al ser un micrófono de muy corto alcance para probar el funcionamiento del dispositvo habrá que soplarle o aplaudir para que ocurra algo.
Al ingresar en la interfaz de wled lo primero que aparece en la parte superior se encuentran los siguientes botones:
- Power (para encender y apagar la luz del dispositivo)
- Timer (para encender y apagar el cambio de estado programado)
- Sync (para sincronizar otros dispositivos con este)
- Peek TODO qué hace peek?
- Info (para ver los datos del dispositivo)
- Config (para configurar luces, sensores, comportamientos, etc)
Bajo esto hay un slider para asignar el brillo y la sección para escoger el color (Colors) que consta de una rueda de color, 2 sliders, 10 muestras, y un botón para escoger un color al azar; además está la opción de escoger paletas de color en forma de gradientes.
También está la sección Effects, con más de 100 distintos efectos de luz que se pueden escoger. Cada uno de los cuáles se puede configurar mediante distintos parámetros controlados por sliders ubicados en la parte inferior.
La sección Segments permite configurar distintos comportamientos a secciones de la tira led.
Finalmente está la sección Presets, en la que se pueden guardar configuraciones que se quieran usar en el futuro, ya sea seleccionandolas manualmente o de manera automatizada, cada preset se guarda con un Nombre y un ID, este último será de mucha utilidad a la hora de asignar comportamientos automatizados. Cada preset se puede editar luego marcando la casilla Overwrite with state cambiando los parámetros y luego presionando Save en la pestaña del preset.
Eso es lo que hay en la pestaña principal, ahora lo recomendable tras conocer la interfaz de control es ir a las configuraciones en Config, al presionar el botón se despliega un menú con diferentes opciones:
- Back (para volver a la pestaña principal)
- WiFi Setup (para las opciones de red)
- LED Preferences (para las opciones de las tiras y sus comportamientos)
- 2D Cofiguration (para configurar los LED como panel bidimensional)
- User Interface (para personalizar la interfaz de la app)
- Time & Macros (para configurar el reloj y comportamientos relacionados al tiempo)
- Usermods (para activar y configurar acciones personalizadas, por ejemplo aquí está AudioReactive)
- Security & Updates (para las opciones de seguridad)
Lo primero a hacer en el menú es ir al WiFi Setup para habilitar un Access point que permitirá prescindir de redes WiFi externas, y se podrá llevar el dispositivo a distintos lugares, sin la necesidad de conectarlo a una red. Por el contrario esto hará que el Esp32 genere una red a la que se puede acceder desde el celular o computador.
Entonces se entra al menú WiFi Setup se desliza hasta la sección Configure Access Point, se escribe un nuevo nombre para la red (reconocible, distinto al de otras redes y otros dispositivos wled), se escribe un acontraseña o se deja vacía para dejar la red abierta, en el canal se deja el 1, y en AP opens se selecciona Always. Con eso ya se debería poder acceder a la red, la cuál pedirá ingresar, lo que lleva a la interfaz de WLED.
Para configurar la o las tiras led que se van a usar hay que ir a LED Preferences, lo primero que aparece es la información general sobre como están ya configurados los LED.
Después está la configuración de las tiras LED, en la que se puede escoger el modelo de tira LED con la que se está trabajando y según eso se despliegan opciones de configuración, en este caso se muestran las opciones de los modelos WS281X que son las siguientes: el orden de color de la señal digital (Color Order), el led desde el que va comenzar (Start, es automático), y la longitud de la tira contado en cantidad de LEDs (Length); también se debe escoger el pin de señal del Esp32 al que se está conectando (GPIO), si se quiere invertir o no el orden de los LEDs (Reversed (rotated 180°)), cuántos LEDs ignorar o no encender (Skip first LEDs), y el último es la opción de refrescar la tira con un apagado (Off Refresh).
Tras estas opciones hay un ícono de cruz que sirve para añadir más tiras LED que se conecten a otros pines GPIO del Esp32, esta es una de las formas para añadir mas LED, puesto que también está la opción de conectar las tiras unas a otras (mientras sean del mismo tipo). Bueno, al presionar el botón para añadir más, surge una sección identica a la que se describió anteriormente.
Un poco más abajo están las opciones de botones, esto permite configurar sensores digitales para que gatillen comportamientos en el sistema. Existe la posibilidad de usar hasta 4 de estos, desde el 0 al 3, para ello se debe escoger el pin de señal de cada sensor, y el tipo de sensor o de comportamiento de sensor:
- Pushbutton
- Push inverted
- Switch
- PIR Sensor
- Touch
- Analog
- Analog inverted
Luego hay una casilla para activar o desactivar el pull-up/down interno del Esp32, el que estando activado simplifica las conexiones del sensor; también se puede ajustar el umbral para detectar una pulsación; y se puede configurar el uso de un sensor infrarrojo para usar con un control remoto.
Más abajo, casi al final están las configuraciones de transición y de temporizador, en la primera sección se pueden ajustar los tiempos y el tipo de transición al cambier de modos las luces, y en la otra sección se pueden realizar ajustes para el temporizador que se activa manualmente desde la interfaz de wled.
Para configurar acciones temporales hay que ir al menú de Time & Macros.
En esta sección se puede escoger el servidor desde el que se consulta la hora actual,
Aquí se pueden configurar los comportamientos de las distintas interacciones con los 4 diferentes botones/sensores, para cada uno hay 3 posibles interacciones, presionar (short), mantener presionado (long), y presionar 2 veces (double). Esto se organiza en una tabla en la que se cruza botón con interacción, en las intersecciones de esto se escribe ID del preset que se quisiera activar; por ejemplo en si se quisiera activar el preset con el ID 102 al presionar el segundo botón una sola vez, se escribiría 102 en la intersección de Button 1 y short on->off.
En esta sección se pueden dejar programadas acciones para que ocurran en una hora en específico, esto se hace escribiendo una hora y minuto en la casilla correspondiente, y escribiendo un ID de preset en la fila de la hora en la que se quiere que ocurra.
Para configurar las acciones personalizadas hay que ir al menú de Usermods, entre esto están las configuraciones para la audio-reactividad.
Si se quiere usar el micrófono, se debe activar la casilla Enabled, además se habrá que seleccionar el pin al que se conectó el micrófono y seleccionar Generic Analog en Type; en el caso de trabajar con el MAX4466 o el MAX9814 se recomienda seguir el instructivo de wled (manual del audioreactive), que detalla las conexiones del circuito y la configuración; igualmente con esto basta para hacer funcionar el KY-037.
documentado por AndresMartinM 2025