La iluminación RGB de la séptima bahía de ZimaCube ahora cuenta con un protocolo de control oficial, por lo que no necesitas instalar CubeFX solo para cambiar los colores o los efectos. El firmware oficial expone un punto de acceso Wi‑Fi del ESP32 en 172.16.1.1 y acepta comandos JSON para los modos de respiración, constante y personalizado por LED.
CubeFX sigue siendo un firmware comunitario opcional para quienes desean una interfaz diferente o una personalización más profunda. Si prefieres el firmware original, utiliza el método HTTP/JSON oficial y evita volver a instalar el firmware del ESP32.
Cómo funciona la iluminación de la séptima bahía
El protocolo LED de la séptima bahía actual indica que el controlador de iluminación es un ESP32 conectado a una tira WS2812B de 13 LED.
Conectarse al controlador de iluminación
El firmware oficial crea una red Wi‑Fi llamada ZimaCube con la contraseña documentada homecloud. Se puede acceder al controlador en 172.16.1.1.
ping 172.16.1.1Establecer un color constante
{
"id": 2,
"data": [
{"h": 21, "s": 255, "v": 255}
]
}Envía el JSON al controlador:
curl -X POST -H "Content-Type: application/json" -d @light.json http://172.16.1.1/postModos de respiración y personalizados
El modo 1 es el modo de respiración con velocidad ajustable. El modo 5 permite controlar el color y el brillo de cada LED de los 13 LED. La documentación oficial marca actualmente los modos 3 y 4 como en desarrollo.
Puedes conservar el firmware original
Este es el cambio clave con respecto al hilo del foro de 2024: ahora existe documentación oficial de control. Puedes crear scripts para el firmware original sin instalar una imagen de terceros.
CubeFX sigue siendo una alternativa opcional
El hilo del proyecto CubeFX comunitario ofrece una opción de firmware personalizado para usuarios avanzados que lo quieran específicamente.
Actualizaciones de firmware OTA
El ESP32 también expone una interfaz web OTA. No subas binarios de firmware desconocidos; conserva una copia de recuperación y ten en cuenta que el firmware personalizado puede cambiar el protocolo que espera ZimaOS.
Usar RGB para automatizar estados
Como el punto de control acepta JSON, puedes asociar el estado de las copias de seguridad, las alertas de disco, las descargas o la actividad de la IA local con colores desde scripts, sin tocar el subsistema de almacenamiento.
La descripción general del control RGB ofrece contexto adicional para el proyecto.
Convertir los valores HSV antes de enviar el JSON
El protocolo oficial espera que el tono, la saturación y el valor estén en una escala de 0 a 255. Si tu selector de color utiliza grados y porcentajes, convierte esos valores antes de enviarlos al ESP32.
Probar un modo sencillo antes de automatizar
Empieza con el modo de color constante y confirma que el controlador responde. Solo después añade scripts para el estado de las copias de seguridad, las alertas de disco o los efectos musicales. Así separarás los problemas de red o del protocolo de la lógica de automatización.
Mantener la automatización fuera de funciones críticas
Utiliza los LED como una ayuda visual, no como el único medio de alerta ante fallos de disco o de las copias de seguridad. También deben existir notificaciones de hardware en registros, correo electrónico, sistemas de monitorización u otro canal persistente.
Preguntas frecuentes
¿Necesito CubeFX para controlar los LED?
No. El firmware oficial actual cuenta con un protocolo JSON/HTTP documentado.
¿Cuántos LED tiene la tira?
La documentación oficial del hardware especifica 13 LED WS2812B.
¿Puedo controlar cada LED por separado?
Sí, el modo personalizado oficial admite valores HSV individuales para cada LED.
¿Puedo restaurar el firmware original después de usar CubeFX?
Utiliza los recursos oficiales de OTA y firmware, y confirma la revisión de hardware correcta antes de volver a instalar el firmware.
