Die RGB-Beleuchtung des ZimaCube 7th Bay verfügt jetzt über ein offizielles Steuerungsprotokoll. Sie müssen CubeFX also nicht 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 Atemeffekte, konstante Farben und benutzerdefinierte Modi für einzelne LEDs.
CubeFX bleibt eine optionale Community-Firmware für Nutzer, die eine andere Benutzeroberfläche oder weitergehende Anpassungsmöglichkeiten wünschen. Wenn Sie die Standard-Firmware bevorzugen, verwenden Sie die offizielle HTTP/JSON-Methode und verzichten Sie darauf, den ESP32 neu zu flashen.
So funktioniert die Beleuchtung des 7th Bay
Laut dem aktuellen 7th-Bay-LED-Protokoll ist der Beleuchtungscontroller ein ESP32, 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/postAtemeffekt und benutzerdefinierte Modi
Modus 1 ist ein Atemeffekt mit einstellbarer Geschwindigkeit. Modus 5 ermöglicht die Steuerung von Farbe und Helligkeit jeder der 13 LEDs. In der offiziellen Dokumentation sind die Modi 3 und 4 derzeit als in Entwicklung gekennzeichnet.
Sie können die Standard-Firmware beibehalten
Das ist die entscheidende Änderung gegenüber dem Forenthread von 2024: Eine offizielle Steuerungsdokumentation ist jetzt verfügbar. Sie können die Standard-Firmware skripten, ohne ein Drittanbieter-Image aufzuspielen.
CubeFX ist weiterhin eine optionale Alternative
Der Community-CubeFX-Projektthread bietet einen benutzerdefinierten Firmware-Weg für fortgeschrittene Nutzer, die ihn bewusst nutzen möchten.
OTA-Firmware-Updates
Der ESP32 bietet auch eine OTA-Weboberfläche. Lade keine unbekannten Firmware-Binärdateien hoch; bewahre eine Wiederherstellungskopie auf und bedenke, dass benutzerdefinierte Firmware das von ZimaOS erwartete Protokoll ändern kann.
RGB für die Statusautomatisierung nutzen
Da der Steuerungsendpunkt JSON akzeptiert, kannst du Backup-Status, Laufwerkswarnungen, Downloads oder lokale KI-Aktivitäten über Skripte Farben zuordnen, ohne das Speichersubsystem anzutasten.
Der Überblick zur RGB-Steuerung bietet zusätzlichen Projektkontext.
HSV-Werte vor dem Senden des JSON umrechnen
Das offizielle Protokoll erwartet Farbton, Sättigung und Helligkeitswert auf einer Skala von 0 bis 255. Wenn dein Farbwähler Gradangaben und Prozentwerte verwendet, rechne diese Werte vor dem Senden in den ESP32 um.
Vor der Automatisierung einen einfachen Modus testen
Beginne mit dem Modus für konstante Farben und prüfe, ob der Controller reagiert. Füge erst dann Skripte für den Backup-Status, Laufwerkswarnungen oder Musikeffekte hinzu. So lassen sich Netzwerk- und Protokollprobleme von der Automatisierungslogik trennen.
Automatisierungen nicht für kritische Aufgaben verwenden
Nutze die LEDs als visuelle Ergänzung und nicht als einzigen Benachrichtigungskanal bei Laufwerksausfällen oder Backups. Hardware-Benachrichtigungen sollten auch in Protokollen, E-Mails, Überwachungssystemen oder einem anderen dauerhaften Kanal verfügbar sein.
FAQ
Brauche ich CubeFX, um die LEDs zu steuern?
Nein. Die aktuelle offizielle Firmware bietet ein dokumentiertes JSON-/HTTP-Protokoll.
Wie viele LEDs hat der Streifen?
In der offiziellen Hardware-Dokumentation sind 13 WS2812B-LEDs angegeben.
Kann ich jede LED einzeln steuern?
Der offizielle Custom-Modus unterstützt HSV-Werte für jede LED.
Kann ich nach CubeFX die Firmware auf den Werkszustand zurücksetzen?
Nutze die offiziellen OTA-/Firmware-Ressourcen und bestätige vor dem erneuten Flashen die richtige Hardware-Revision.
