ZimaCubes RGB-belysning för den sjunde platsen har nu ett officiellt styrprotokoll, så du behöver inte flasha CubeFX bara för att ändra färger eller effekter. Den officiella fasta programvaran tillhandahåller en ESP32 Wi-Fi-slutpunkt på 172.16.1.1 och accepterar JSON-kommandon för pulserande, konstant och anpassade lägen per LED.
CubeFX är fortfarande en valfri community-firmware för användare som vill ha ett annat gränssnitt eller mer avancerad anpassning. Om du föredrar den fabriksinstallerade programvaran använder du den officiella HTTP/JSON-metoden och undviker att flasha om ESP32-enheten.
Så fungerar belysningen på den sjunde platsen
Det aktuella LED-protokollet för den sjunde platsen anger att belysningsstyrenheten är en ESP32 ansluten till en WS2812B-list med 13 LED-lampor.
Anslut till belysningsstyrenheten
Den officiella fasta programvaran skapar ett Wi-Fi-nätverk med namnet ZimaCube och det dokumenterade lösenordet homecloud. Styrenheten kan nås på 172.16.1.1.
ping 172.16.1.1Ställ in en konstant färg
{
"id": 2,
"data": [
{"h": 21, "s": 255, "v": 255}
]
}Skicka JSON-filen till styrenheten:
curl -X POST -H "Content-Type: application/json" -d @light.json http://172.16.1.1/postPulserande och anpassade lägen
Läge 1 är pulserande läge med justerbar hastighet. Läge 5 ger kontroll över färg och ljusstyrka för varje LED för alla 13 LED-lampor. De officiella dokumenten anger för närvarande att läge 3 och 4 är under utveckling.
Du kan behålla den fabriksinstallerade programvaran
Detta är den viktiga förändringen jämfört med forumtråden från 2024: det finns nu officiell dokumentation för styrningen. Du kan skripta den fabriksinstallerade programvaran utan att flasha en tredjepartsavbild.
CubeFX är fortfarande ett valfritt alternativ
Community-projekttråden för CubeFX erbjuder en väg med anpassad firmware för avancerade användare som medvetet vill använda den.
OTA-uppdateringar av fast programvara
ESP32-enheten tillhandahåller även ett webbaserat OTA-gränssnitt. Ladda inte upp okända firmwarebinärer; behåll en återställningskopia och tänk på att anpassad firmware kan ändra det protokoll som ZimaOS förväntar sig.
Använd RGB för statusautomatisering
Eftersom styrningsslutpunkten accepterar JSON kan du från skript koppla säkerhetskopieringsstatus, diskvarningar, nedladdningar eller lokal AI-aktivitet till färger utan att röra lagringsundersystemet.
Översikten över RGB-styrning ger ytterligare projektbakgrund.
Konvertera HSV-värden innan du skickar JSON
Det officiella protokollet förväntar sig nyans, mättnad och värde på en skala från 0 till 255. Om din färgväljare använder grader och procenttal ska du konvertera dessa värden innan du skickar dem till ESP32-enheten.
Testa ett enkelt läge innan du automatiserar
Börja med läget för konstant färg och bekräfta att styrenheten svarar. Lägg först därefter till skript för säkerhetskopieringsstatus, diskvarningar eller musikeffekter. På så sätt skiljer du nätverks- och protokollproblem från automatiseringslogiken.
Håll automatiseringen icke-kritisk
Använd LED-lamporna som en visuell hjälp, inte som den enda varningsvägen för diskfel eller säkerhetskopieringar. Hårdvaruaviseringar bör även finnas i loggar, e-post, övervakning eller någon annan beständig kanal.
Vanliga frågor
Behöver jag CubeFX för att styra LED-lamporna?
Nej. Den aktuella officiella fasta programvaran har ett dokumenterat JSON/HTTP-protokoll.
Hur många LED-lampor finns i listen?
Den officiella maskinvarudokumentationen anger 13 WS2812B-LED-lampor.
Kan jag styra varje LED separat?
Ja, det officiella anpassade läget stöder HSV-värden per LED.
Kan jag återställa den fabriksinstallerade programvaran efter CubeFX?
Använd de officiella OTA- och firmware-resurserna och bekräfta rätt maskinvaruversion innan du flashar om enheten.
