De RGB-verlichting van de 7e bay van de ZimaCube heeft nu een officieel besturingsprotocol, zodat je CubeFX niet hoeft te flashen om kleuren of effecten te wijzigen. De officiële firmware biedt een ESP32-wifi-endpoint op 172.16.1.1 en accepteert JSON-opdrachten voor ademende, constante en aangepaste modi per led.
CubeFX blijft optionele communityfirmware voor gebruikers die een andere interface of uitgebreidere aanpassingsmogelijkheden willen. Als je de standaardfirmware wilt behouden, gebruik dan de officiële HTTP/JSON-methode en flash de ESP32 niet opnieuw.
Hoe de verlichting van de 7e bay werkt
Het huidige ledprotocol voor de 7e bay vermeldt 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 aan met de naam ZimaCube en het gedocumenteerde wachtwoord homecloud. De controller is bereikbaar op 172.16.1.1.
ping 172.16.1.1Een constante 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/postAdemende en aangepaste modi
Modus 1 is de ademende modus met instelbare snelheid. Modus 5 biedt kleur- en helderheidsregeling per led voor alle 13 leds. In de officiële documentatie worden modi 3 en 4 momenteel als in ontwikkeling aangeduid.
Je kunt de standaardfirmware behouden
Dit is de belangrijkste verandering ten opzichte van het forumtopic uit 2024: er is nu officiële documentatie voor de besturing. Je kunt de standaardfirmware scripten zonder een image van derden te flashen.
CubeFX blijft een optioneel alternatief
Het community-CubeFX-projecttopic biedt een aangepast firmwaretraject voor gevorderde gebruikers die dit bewust willen.
OTA-firmware-updates
De ESP32 biedt ook een OTA-webinterface. Upload geen onbekende firmwarebinaries; bewaar een herstelkopie en houd er rekening mee dat aangepaste firmware het protocol kan wijzigen dat ZimaOS verwacht.
RGB gebruiken voor statusautomatisering
Omdat het besturingseindpunt JSON accepteert, kun je back-upstatus, schijfwaarschuwingen, downloads of lokale AI-activiteit vanuit scripts aan kleuren koppelen zonder het opslagsubsysteem aan te raken.
Het overzicht van de RGB-besturing biedt aanvullende projectcontext.
HSV-waarden converteren voordat je JSON verzendt
Het officiële protocol verwacht tint, verzadiging en waarde op een schaal van 0–255. Als je kleurkiezer graden en percentages gebruikt, moet je die waarden converteren voordat je ze naar de ESP32 verzendt.
Eerst één eenvoudige modus testen voordat je automatiseert
Begin met de modus voor een constante kleur en controleer of de controller reageert. Voeg pas daarna scripts toe voor back-upstatus, schijfwaarschuwingen of muziekeffecten. Zo houd je netwerk- en protocolproblemen gescheiden van problemen in de automatiseringslogica.
Automatisering niet-kritiek houden
Gebruik de leds als visueel hulpmiddel, niet als het enige waarschuwingskanaal voor schijfstoringen of back-ups. Hardwaremeldingen moeten ook beschikbaar zijn in logboeken, e-mail, monitoring of een ander persistent 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 worden 13 WS2812B-leds gespecificeerd.
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- en firmwarebronnen en controleer vóór het opnieuw flashen of de hardwareversie klopt.
