La mejora que no necesitaba una luz nueva

Este proyecto comenzó con dos luces LED bicolor comunes de 12 V. Funcionaban bien, pero cada ajuste requería alcanzar los botones físicos. Los reemplazos inteligentes con control remoto cuestan alrededor de $60 cada uno, y sustituir hardware funcional solamente por comodidad no parecía la respuesta correcta.

En cambio, me hice una pregunta más interesante: ¿podía conservar los LED y la electrónica de potencia que ya funcionaban y reemplazar solamente la capa de control? Esa pregunta se convirtió en AMS KeyLight, una plataforma de iluminación basada en ESP32 con Wi-Fi, interfaz de navegador, API de red, descubrimiento automático, control de varias luces y un plugin nativo para Elgato Stream Deck.

Ingeniería inversa de la luz original

Al abrir el controlador encontré canales LED cálidos y fríos separados que compartían la misma fuente de 12 V. La placa original ya contenía dos MOSFET que conmutaban esos canales, por lo que reconstruir toda la etapa de potencia habría añadido complejidad sin mejorar la luz.

Seguí las conexiones y medí el comportamiento de compuerta y drenaje con distintos niveles de brillo. Al principio, el multímetro mostraba valores extraños porque estaba promediando una señal que conmutaba rápidamente. Una vez entendido esto, el diseño quedó claro: el controlador de fábrica usaba PWM y un ESP32 podía asumir esas señales de control conservando la etapa MOSFET comprobada.

Luz bicolor abierta mostrando su matriz de LED cálidos y fríos
El panel original contiene canales LED cálidos y fríos intercalados que pueden controlarse de forma independiente.

Recreando el brillo y la temperatura de color con PWM

El primer prototipo conectó dos salidas GPIO del ESP32 a los canales cálido y frío. Desde ahí, el microcontrolador podía generar PWM para cada lado del panel y reproducir ambos controles originales completamente por software.

El usuario no necesita manejar dos canales. El firmware recibe un valor maestro de brillo y otro de temperatura de color, y calcula la mezcla correcta. Al moverlo hacia cálido aumenta ese canal y reduce el frío. Al moverlo hacia frío sucede lo contrario. La posición central mezcla ambos canales para producir una luz neutra.

Este modelo de control sencillo se convirtió en la base del proyecto. Cada interfaz puede solicitar un brillo y una temperatura, mientras el firmware traduce esas solicitudes al comportamiento eléctrico que necesita el panel.

Placa de desarrollo ESP32 utilizada para mapear y probar los controles de la luz
La placa ESP32 de tamaño completo facilitó cambiar y verificar las primeras mediciones PWM y los experimentos de control.

Encontrando un límite de operación estable

Obtener luz visible fue solamente la primera prueba. Con una salida PWM alta, el panel podía funcionar brevemente y después apagarse y reiniciarse varios minutos más tarde. Las pruebas cortas parecían exitosas, pero las sesiones largas revelaron caída de voltaje y un límite práctico en el hardware original de 12 V.

Reduje progresivamente el valor PWM máximo mientras observaba la fuente y repetía pruebas más largas. El firmware actual usa un límite conservador de 90 sobre 255. La pérdida de brillo percibida es pequeña, mientras la carga eléctrica se reduce considerablemente. Los valores más altos provocaban mucha más caída de voltaje sin producir una mejora visual proporcional.

La limitación exacta todavía merece una caracterización más profunda, pero el proceso reforzó una lección importante: un prototipo que sobrevive treinta segundos no es necesariamente estable. El comportamiento térmico, la entrega de potencia y las protecciones solamente se hacen visibles cuando se permite que el sistema funcione durante más tiempo.

Convirtiendo el prototipo en un dispositivo de red

Los LED respondiendo a un ESP32 demostraron el concepto, pero AMS KeyLight necesitaba comportarse como un dispositivo de red terminado. El firmware evolucionó hasta la versión 1.4 con reconexión Wi-Fi automática, servidor HTTP, estado en tiempo real y comandos API para encendido, brillo y temperatura de color.

El ESP32 también aloja su propia página de control con la identidad visual del proyecto. El encendido, brillo, temperatura, información del dispositivo y valores de salida actuales están disponibles desde cualquier navegador sin instalar software. El arte y el favicon se almacenan en la memoria flash, por lo que la interfaz es completamente autónoma y no depende de un servidor externo.

Esa separación importa. Un navegador, Stream Deck o integración futura solamente solicita un resultado. El firmware sigue siendo responsable de la mezcla PWM y del hardware físico que existe debajo.

Prototipo ESP32 instalado junto a la placa controladora original de la luz
El prototipo reutiliza la etapa de potencia original y añade el ESP32 como una nueva capa de control.

Descubrimiento automático en una red segmentada

Fijar una dirección IP funcionaría para una sola luz hasta que DHCP la cambiara. En su lugar, cada AMS KeyLight crea una identidad única a partir de su ESP32 y anuncia un servicio mDNS con su nombre, ID del dispositivo, versión del firmware y datos de conexión.

Ese diseño creó un reto real de redes en mi homelab segmentado. El tráfico HTTP normal se enrutaba correctamente entre VLAN, pero los anuncios mDNS permanecían dentro de su dominio de difusión local. Avahi en pfSense ahora refleja mDNS solamente entre las redes apropiadas, permitiendo que el plugin descubra las KeyLight a través del límite VLAN mientras la política normal del firewall mantiene el control.

El software recuerda el ID permanente del dispositivo, no una dirección temporal. Las luces adicionales pueden anunciarse de forma independiente, cambiar de dirección y seguir apareciendo como los mismos dispositivos físicos para cada controlador.

Creando una experiencia nativa para Stream Deck

El control remoto fue la motivación original, por lo que la interfaz web no era la meta final. Creé un plugin nativo para Elgato Stream Deck que descubre las AMS KeyLight y ofrece acciones dedicadas para encendido, brillo, temperatura, ajustes predefinidos y control mediante diales.

Cada acción incluye un selector de dispositivos que se completa automáticamente y una opción para Todas las luces. Las selecciones se guardan mediante el ID único, por lo que el plugin continúa controlando la luz correcta aunque cambie su dirección de red. Los ajustes predefinidos también pueden incluirse en Multi Actions de Stream Deck para escenas más amplias de transmisión o grabación.

En Stream Deck+, un dial ajusta el brillo y alterna el encendido al presionarlo. Otro se mueve entre luz cálida y fría y regresa a neutro al presionarlo. La pantalla táctil muestra los ajustes actuales, haciendo que el sistema se sienta nativo en lugar de una colección de solicitudes web genéricas.

Incluso la tecla de encendido requirió un manejo cuidadoso del estado. El cambio automático de estado de Stream Deck inicialmente no coincidía con la luz real. Ahora el ESP32 es la fuente de verdad, por lo que el plugin lee el estado real del dispositivo y actualiza el arte de la tecla solamente después de saber qué está haciendo el hardware.

Desarrollo del plugin AMS KeyLight para Stream Deck en Visual Studio Code
El plugin añade teclas y diales nativos, selección de dispositivos, información de estado y comandos para varias luces.

Lo que viene después

La arquitectura principal ya funciona desde los canales LED hasta la red y Stream Deck. La próxima revisión de hardware reemplazará la placa de desarrollo grande por un diseño ESP32-C3 mucho más pequeño y hará que la modificación sea más limpia y fácil de instalar.

La hoja de ruta también incluye una configuración Wi-Fi más sencilla, ajustes persistentes, actualizaciones de firmware OTA, mayor seguridad, calibración adicional, integración con los botones físicos originales y más refinamiento del paquete y el arte del plugin.

Lo que comenzó como una forma de evitar caminar hasta una luz económica se convirtió en una plataforma completa de hardware y software. ¿Era necesario todo esto solamente para cambiar el brillo desde una silla? Claro que no. Esa es también exactamente la razón por la que proyectos como este son tan divertidos.

Placas de desarrollo ESP32-C3 compactas consideradas para la próxima revisión de AMS KeyLight
Un ESP32-C3 compacto es la base planificada para una revisión de hardware más pequeña y limpia.