La iluminación RGB de la 7.ª bahía de ZimaCube ya cuenta con un protocolo de control oficial, así que no necesitas instalar CubeFX para cambiar los colores o los efectos. El firmware oficial ofrece un punto de acceso Wi-Fi del ESP32 en 172.16.1.1 y acepta comandos JSON para los modos de respiración, color fijo y personalización de cada LED.
CubeFX sigue siendo un firmware comunitario opcional para quienes quieran una interfaz diferente o una personalización más avanzada. Si prefieres el firmware de fábrica, usa el método oficial HTTP/JSON y evita volver a instalar el firmware del ESP32.
Cómo funciona la iluminación de la 7.ª bahía
El protocolo LED de la 7.ª bahía actual indica que el controlador de iluminación es un ESP32 conectado a una tira de 13 LED WS2812B.
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 fijo
{
"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 uno de los 13 LED. La documentación oficial indica actualmente que los modos 3 y 4 están en desarrollo.
Puedes conservar el firmware de fábrica
Este es el cambio clave respecto al hilo del foro de 2024: ahora existe documentación oficial de control. Puedes crear scripts para el firmware de fábrica sin instalar una imagen de terceros.
CubeFX sigue siendo una alternativa opcional
El hilo del proyecto CubeFX en la comunidad ofrece una opción de firmware personalizado para los usuarios avanzados que la quieran expresamente.
Actualizaciones de firmware OTA
El ESP32 también ofrece una interfaz web OTA. No cargues archivos 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.
Usa RGB para automatizar los indicadores de estado
Como el endpoint de control acepta JSON, puedes asignar colores al estado de las copias de seguridad, las alertas de disco, las descargas o la actividad de la IA local mediante scripts, sin modificar el subsistema de almacenamiento.
El resumen del control RGB ofrece más contexto sobre el proyecto.
Convierte los valores HSV antes de enviar el JSON
El protocolo oficial espera valores de matiz, saturación y valor en una escala de 0 a 255. Si tu selector de color usa grados y porcentajes, convierte esos valores antes de enviarlos al ESP32.
Prueba un modo sencillo antes de automatizar
Empieza con el modo de color constante y confirma que el controlador responda. Solo entonces añade scripts para el estado de las copias de seguridad, alertas de disco o efectos musicales. Así se separan los problemas de red o protocolo de la lógica de automatización.
Mantén la automatización al margen de las funciones críticas
Usa los LED como una ayuda visual, no como único medio de alerta ante fallos de disco o problemas con las copias de seguridad. Las notificaciones de hardware también deben aparecer en registros, correos electrónicos, sistemas de supervisió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 permite configurar valores HSV para cada LED.
¿Puedo restaurar el firmware de fábrica después de CubeFX?
Usa los recursos oficiales de OTA y firmware, y confirma la revisión de hardware correcta antes de volver a instalar el firmware.
