Die RGB-Beleuchtung des 7. Einschubs des ZimaCube verfügt jetzt über ein offizielles Steuerungsprotokoll. Sie müssen CubeFX also nicht mehr flashen, nur um Farben oder Effekte zu ändern. Die offizielle Firmware stellt einen ESP32-WLAN-Endpunkt unter 172.16.1.1 bereit und akzeptiert JSON-Befehle für Atmungs-, Dauerlicht- und benutzerdefinierte Modi pro LED.
CubeFX bleibt eine optionale Community-Firmware für Nutzer, die eine andere Benutzeroberfläche oder umfangreichere Anpassungsmöglichkeiten wünschen. Wenn Sie die Standardfirmware bevorzugen, verwenden Sie die offizielle HTTP-/JSON-Methode und vermeiden Sie ein erneutes Flashen des ESP32.
So funktioniert die Beleuchtung des 7. Einschubs
Das aktuelle LED-Protokoll für den 7. Einschub besagt, dass der Beleuchtungscontroller ein ESP32 ist, der mit einem WS2812B-Streifen mit 13 LEDs verbunden ist.
Mit dem Beleuchtungscontroller verbinden
Die offizielle Firmware erstellt ein WLAN mit dem Namen ZimaCube und dem dokumentierten Passwort homecloud. Der Controller ist unter 172.16.1.1 erreichbar.
ping 172.16.1.1Eine konstante Farbe einstellen
{
"id": 2,
"data": [
{"h": 21, "s": 255, "v": 255}
]
}Senden Sie das JSON an den Controller:
curl -X POST -H "Content-Type: application/json" -d @light.json http://172.16.1.1/postAtmungs- und benutzerdefinierte Modi
Modus 1 ist der Atmungsmodus mit einstellbarer Geschwindigkeit. Modus 5 ermöglicht die individuelle Steuerung von Farbe und Helligkeit für alle 13 LEDs. In der offiziellen Dokumentation sind die Modi 3 und 4 derzeit als in Entwicklung gekennzeichnet.
Sie können die Standardfirmware behalten
Das ist die wesentliche Änderung gegenüber dem Forenbeitrag von 2024: Inzwischen gibt es eine offizielle Dokumentation zur Steuerung. Sie können die Standardfirmware per Skript steuern, ohne ein Image eines Drittanbieters zu flashen.
CubeFX bleibt eine optionale Alternative
Der CubeFX-Projektthread der Community bietet fortgeschrittenen Nutzern, die dies ausdrücklich wünschen, die Möglichkeit, eine benutzerdefinierte Firmware zu verwenden.
OTA-Firmware-Updates
Der ESP32 stellt außerdem eine OTA-Weboberfläche bereit. Laden Sie keine unbekannten Firmware-Binärdateien hoch. Bewahren Sie eine Wiederherstellungskopie auf und beachten Sie, dass benutzerdefinierte Firmware das von ZimaOS erwartete Protokoll ändern kann.
RGB für die Statusautomatisierung verwenden
Da der Steuerungsendpunkt JSON akzeptiert, können Sie den Status von Backups, Festplattenwarnungen, Downloads oder lokalen KI-Aktivitäten per Skript Farben zuweisen, ohne das Speichersystem zu berühren.
Die Übersicht zur RGB-Steuerung bietet zusätzlichen Projektkontext.
HSV-Werte vor dem Senden des JSON umwandeln
Das offizielle Protokoll erwartet Farbton, Sättigung und Helligkeitswert auf einer Skala von 0–255. Wenn Ihre Farbauswahl Farbton in Grad und Sättigung beziehungsweise Helligkeit in Prozent verwendet, wandeln Sie diese Werte vor dem Senden an den ESP32 um.
Vor der Automatisierung einen einfachen Modus testen
Beginnen Sie mit dem Dauerlichtmodus und überprüfen Sie, ob der Controller reagiert. Fügen Sie erst danach Skripte für den Backup-Status, Festplattenwarnungen oder Musikeffekte hinzu. So lassen sich Netzwerk- und Protokollprobleme von Fehlern in der Automatisierungslogik unterscheiden.
Automatisierung nicht für kritische Meldungen verwenden
Verwenden Sie die LEDs als visuelle Hilfe, nicht als einzigen Benachrichtigungsweg für Festplattenausfälle oder Backups. Hardwarebenachrichtigungen sollten zusätzlich in Protokollen, per E-Mail, in der Überwachung oder über einen anderen dauerhaften Kanal verfügbar sein.
FAQ
Benötige ich CubeFX, um die LEDs zu steuern?
Nein. Die aktuelle offizielle Firmware verfügt über ein dokumentiertes JSON-/HTTP-Protokoll.
Wie viele LEDs enthält der Streifen?
Die offizielle Hardwaredokumentation nennt 13 WS2812B-LEDs.
Kann ich jede LED einzeln steuern?
Ja, der offizielle benutzerdefinierte Modus unterstützt HSV-Werte für einzelne LEDs.
Kann ich nach CubeFX die Standardfirmware wiederherstellen?
Verwenden Sie die offiziellen OTA-/Firmware-Ressourcen und bestätigen Sie vor dem erneuten Flashen die richtige Hardwarerevision.
