L’éclairage RGB de la 7e baie du ZimaCube dispose désormais d’un protocole de contrôle officiel : vous n’avez donc pas besoin de flasher CubeFX simplement pour modifier les couleurs ou les effets. Le micrologiciel officiel expose un point d’accès Wi-Fi ESP32 à 172.16.1.1 et accepte des commandes JSON pour les modes respirant, fixe et personnalisé par LED.
CubeFX reste un micrologiciel communautaire facultatif pour les utilisateurs qui souhaitent une autre interface ou une personnalisation plus poussée. Si vous préférez le micrologiciel d’origine, utilisez la méthode officielle HTTP/JSON et évitez de reflasher l’ESP32.
Fonctionnement de l’éclairage de la 7e baie
Le protocole actuel des LED de la 7e baie indique que le contrôleur d’éclairage est un ESP32 relié à une bande de 13 LED WS2812B.
Se connecter au contrôleur d’éclairage
Le micrologiciel officiel crée un réseau Wi-Fi nommé ZimaCube, protégé par le mot de passe indiqué dans la documentation : homecloud. Le contrôleur est accessible à l’adresse 172.16.1.1.
ping 172.16.1.1Définir une couleur fixe
{
"id": 2,
"data": [
{"h": 21, "s": 255, "v": 255}
]
}Envoyez le JSON au contrôleur :
curl -X POST -H "Content-Type: application/json" -d @light.json http://172.16.1.1/postModes respirant et personnalisé
Le mode 1 est un mode respirant à vitesse réglable. Le mode 5 permet de contrôler la couleur et la luminosité de chacune des 13 LED. La documentation officielle indique actuellement que les modes 3 et 4 sont en cours de développement.
Vous pouvez conserver le micrologiciel d’origine
C’est le principal changement par rapport au fil du forum de 2024 : une documentation officielle sur le contrôle est désormais disponible. Vous pouvez automatiser le micrologiciel d’origine sans flasher une image tierce.
CubeFX reste une solution alternative facultative
Le fil de discussion communautaire du projet CubeFX propose une méthode pour installer un micrologiciel personnalisé, destinée aux utilisateurs avancés qui le souhaitent délibérément.
Mises à jour du firmware OTA
L’ESP32 propose également une interface web OTA. Ne téléversez pas de fichiers de firmware d’origine inconnue ; conservez une copie de récupération et gardez à l’esprit qu’un firmware personnalisé peut modifier le protocole attendu par ZimaOS.
Utilisez le RGB pour automatiser les indicateurs d’état
Comme le point de terminaison de contrôle accepte le JSON, vous pouvez associer l’état des sauvegardes, les alertes de disque, les téléchargements ou l’activité de l’IA locale à des couleurs au moyen de scripts, sans toucher au sous-système de stockage.
L’aperçu du contrôle RGB apporte des informations supplémentaires sur le projet.
Convertissez les valeurs HSV avant d’envoyer le JSON
Le protocole officiel attend des valeurs de teinte, de saturation et de luminosité sur une échelle de 0 à 255. Si votre sélecteur de couleurs utilise des degrés et des pourcentages, convertissez ces valeurs avant de les envoyer à l’ESP32.
Testez un mode simple avant d’automatiser
Commencez par le mode couleur constante et vérifiez que le contrôleur répond. Ajoutez ensuite des scripts pour indiquer l’état des sauvegardes, les alertes de disque ou les effets musicaux. Vous pourrez ainsi distinguer les problèmes de réseau ou de protocole de ceux liés à la logique d’automatisation.
Ne faites pas des automatisations un élément critique
Utilisez les LED comme un indicateur visuel pratique, et non comme seul moyen d’alerte en cas de panne de disque ou de problème de sauvegarde. Les notifications matérielles doivent également être disponibles dans les journaux, par e-mail, via un système de surveillance ou par un autre canal persistant.
FAQ
Ai-je besoin de CubeFX pour contrôler les LED ?
Non. Le firmware officiel actuel dispose d’un protocole JSON/HTTP documenté.
Combien de LED compte la bande ?
La documentation matérielle officielle indique la présence de 13 LED WS2812B.
Puis-je contrôler chaque LED séparément ?
Oui, le mode personnalisé officiel permet de définir les valeurs HSV de chaque LED.
Puis-je restaurer le firmware d’origine après avoir installé CubeFX ?
Utilisez les ressources OTA et de firmware officielles et vérifiez la révision matérielle avant de reflasher.
