Communitylösning

Styr ZimaCubes RGB med det officiella LED-API:t för den sjunde hårddiskplatsen

A 2024 user asked how to control ZimaCube RGB without custom firmware; current ZimaOS docs now publish the official ESP32 JSON protocol.

RGB-belysningen i ZimaCube 7th Bay har nu ett officiellt styrprotokoll, så du behöver inte flasha CubeFX bara för att ändra färger eller effekter. Den officiella firmwaren tillhandahåller en Wi-Fi-endpoint för ESP32 på 172.16.1.1 och tar emot JSON-kommandon för pulserande, fast och anpassat läge med individuell styrning av varje lysdiod.

CubeFX är fortfarande en valfri community-firmware för användare som vill ha ett annat gränssnitt eller fler anpassningsmöjligheter. Om du föredrar den ursprungliga firmwaren kan du använda den officiella HTTP/JSON-metoden och undvika att flasha om ESP32-enheten.

Så fungerar belysningen i 7th Bay

Det aktuella LED-protokollet för 7th Bay anger att belysningens styrenhet är en ESP32 ansluten till en WS2812B-list med 13 lysdioder.

Anslut till belysningens styrenhet

Den officiella firmwaren skapar ett Wi-Fi-nätverk med namnet ZimaCube och det dokumenterade lösenordet homecloud. Du når styrenheten på 172.16.1.1.

ping 172.16.1.1

Ställ in en fast färg

{
  "id": 2,
  "data": [
    {"h": 21, "s": 255, "v": 255}
  ]
}

Skicka JSON till styrenheten:

curl -X POST -H "Content-Type: application/json" -d @light.json http://172.16.1.1/post

Pulserande och anpassade lägen

Läge 1 är ett pulserande läge med justerbar hastighet. Läge 5 ger kontroll över färg och ljusstyrka för var och en av de 13 lysdioderna. I den officiella dokumentationen anges för närvarande att lägena 3 och 4 är under utveckling.

Du kan behålla den ursprungliga firmwaren

Det här är den viktigaste skillnaden jämfört med forumtråden från 2024: det finns nu officiell dokumentation för styrningen. Du kan skripta den ursprungliga firmwaren utan att flasha en tredjepartsavbildning.

CubeFX är fortfarande ett valfritt alternativ

Communitytråden för CubeFX-projektet erbjuder en anpassad firmwarelösning för avancerade användare som vill ha just det.

OTA-firmwareuppdateringar

ESP32 har också ett OTA-webbgränssnitt. Ladda inte upp okända firmwarefiler; spara 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 tar emot JSON kan du med hjälp av skript koppla status för säkerhetskopiering, diskvarningar, nedladdningar eller lokal AI-aktivitet till färger utan att röra lagringsundersystemet.

Översikten över RGB-styrning ger ytterligare projektkontext.

Konvertera HSV-värden innan du skickar JSON

Det officiella protokollet förväntar sig värden för nyans, mättnad och ljusstyrka på en skala från 0 till 255. Om färgväljaren använder grader och procenttal konverterar du värdena innan du skickar dem till ESP32.

Testa ett enkelt läge innan du automatiserar

Börja med läget för konstant färg och kontrollera att styrenheten svarar. Lägg först därefter till skript för säkerhetskopieringsstatus, diskvarningar eller musikeffekter. Då kan du skilja nätverks- och protokollproblem från automatiseringslogiken.

Håll automatiseringen icke-kritisk

Använd LED-lamporna som en praktisk visuell hjälp, inte som enda larmväg vid diskfel eller säkerhetskopior. Hårdvaruaviseringar bör också 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 firmwareversionen har ett dokumenterat JSON-/HTTP-protokoll.

Hur många LED:er finns det i remsan?

Den officiella hårdvarudokumentationen anger 13 WS2812B-LED:er.

Kan jag styra varje LED separat?

Ja, det officiella anpassade läget stöder HSV-värden för varje LED.

Kan jag återställa originalfirmware efter CubeFX?

Använd de officiella OTA-/firmware-resurserna och bekräfta rätt hårdvarurevision innan du flashar om.