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.

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.

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.

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.

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.


