De RGB-verlichting van de 7th Bay van de ZimaCube heeft nu een officieel besturingsprotocol. Je hoeft CubeFX dus niet te flashen om kleuren of effecten te wijzigen. De officiële firmware biedt een wifi-eindpunt voor de ESP32 op 172.16.1.1 en accepteert JSON-opdrachten voor ademhalings-, vaste en aangepaste modi per led.
CubeFX blijft optionele communityfirmware voor gebruikers die een andere interface of uitgebreidere aanpassingsmogelijkheden willen. Gebruik je liever de standaardfirmware, gebruik dan de officiële HTTP/JSON-methode en flash de ESP32 niet opnieuw.
Hoe de verlichting van de 7th Bay werkt
In het huidige LED-protocol voor de 7th Bay staat dat de verlichtingscontroller een ESP32 is die is verbonden met een WS2812B-strip met 13 leds.
Verbinding maken met de verlichtingscontroller
De officiële firmware maakt een wifi-netwerk met de naam ZimaCube en het gedocumenteerde wachtwoord homecloud aan. De controller is bereikbaar op 172.16.1.1.
ping 172.16.1.1Een vaste kleur instellen
{
"id": 2,
"data": [
{"h": 21, "s": 255, "v": 255}
]
}Stuur de JSON naar de controller:
curl -X POST -H "Content-Type: application/json" -d @light.json http://172.16.1.1/postAdemhalings- en aangepaste modi
Modus 1 is de ademhalingsmodus met instelbare snelheid. Modus 5 biedt bediening van de kleur en helderheid van elke afzonderlijke LED, voor alle 13 leds. In de officiële documentatie staan modi 3 en 4 momenteel als in ontwikkeling vermeld.
Je kunt de standaardfirmware blijven gebruiken
Dit is de belangrijkste verandering ten opzichte van de forumthread uit 2024: er is nu officiële documentatie voor de bediening. Je kunt de standaardfirmware scripten zonder een image van derden te flashen.
CubeFX is nog steeds een optioneel alternatief
De community-thread CubeFX-project biedt een aangepast firmwaretraject voor gevorderde gebruikers die daar bewust voor kiezen.
OTA-firmware-updates
De ESP32 biedt ook een OTA-webinterface. Upload geen onbekende firmwarebestanden; bewaar een herstelkopie en houd er rekening mee dat aangepaste firmware het protocol kan wijzigen dat ZimaOS verwacht.
Gebruik RGB voor statusautomatisering
Omdat het bedieningsendpoint JSON accepteert, kun je met scripts de back-upstatus, schijfwaarschuwingen, downloads of lokale AI-activiteit aan kleuren koppelen zonder het opslagsubsysteem aan te passen.
Het overzicht van RGB-bediening biedt meer context voor het project.
Zet HSV-waarden om voordat je JSON verzendt
Het officiële protocol verwacht hue-, verzadigings- en helderheidswaarden op een schaal van 0–255. Als je kleurenkiezer graden en percentages gebruikt, moet je deze waarden omzetten voordat je ze naar de ESP32 verzendt.
Test eerst een eenvoudige modus voordat je automatiseert
Begin met de modus voor een vaste kleur en controleer of de controller reageert. Voeg pas daarna scripts toe voor de back-upstatus, schijfwaarschuwingen of muziekeffecten. Zo houd je netwerk- en protocolproblemen gescheiden van automatiseringslogica.
Houd automatisering niet-kritiek
Gebruik de leds als visueel hulpmiddel, niet als enige manier om waarschuwingen over schijfstoringen of back-ups te ontvangen. Hardwaremeldingen moeten ook beschikbaar zijn in logboeken, e-mail, monitoring of een ander blijvend kanaal.
Veelgestelde vragen
Heb ik CubeFX nodig om de leds te bedienen?
Nee. De huidige officiële firmware heeft een gedocumenteerd JSON/HTTP-protocol.
Hoeveel leds zitten er in de strip?
In de officiële hardwaredocumentatie staan 13 WS2812B-leds vermeld.
Kan ik elke led afzonderlijk bedienen?
Ja, de officiële aangepaste modus ondersteunt HSV-waarden per led.
Kan ik de standaardfirmware herstellen na CubeFX?
Gebruik de officiële OTA-/firmwarebronnen en controleer de juiste hardwarerevisie voordat je de firmware opnieuw installeert.
