L'illuminazione RGB del 7th Bay di ZimaCube dispone ora di un protocollo di controllo ufficiale, quindi non è necessario installare CubeFX solo per cambiare colori o effetti. Il firmware ufficiale espone un endpoint Wi-Fi ESP32 all'indirizzo 172.16.1.1 e accetta comandi JSON per le modalità respirazione, colore fisso e personalizzata per singolo LED.
CubeFX rimane un firmware della community opzionale per gli utenti che desiderano un'interfaccia diversa o una personalizzazione più avanzata. Se preferisci il firmware di serie, usa il metodo HTTP/JSON ufficiale ed evita di reinstallare il firmware dell'ESP32.
Come funziona l'illuminazione del 7th Bay
L'attuale protocollo LED del 7th Bay indica che il controller dell'illuminazione è un ESP32 collegato a una striscia WS2812B da 13 LED.
Connettersi al controller dell'illuminazione
Il firmware ufficiale crea una rete Wi-Fi denominata ZimaCube con la password documentata homecloud. Il controller è raggiungibile all'indirizzo 172.16.1.1.
ping 172.16.1.1Impostare un colore fisso
{
"id": 2,
"data": [
{"h": 21, "s": 255, "v": 255}
]
}Invia il JSON al controller:
curl -X POST -H "Content-Type: application/json" -d @light.json http://172.16.1.1/postModalità respirazione e personalizzata
La modalità 1 è la modalità respirazione con velocità regolabile. La modalità 5 consente di controllare il colore e la luminosità di ciascuno dei 13 LED. La documentazione ufficiale indica attualmente le modalità 3 e 4 come in fase di sviluppo.
Puoi mantenere il firmware di serie
Questa è la differenza principale rispetto alla discussione del forum del 2024: ora esiste una documentazione ufficiale per il controllo. Puoi creare script per il firmware di serie senza installare un'immagine di terze parti.
CubeFX rimane un'alternativa opzionale
La discussione sul progetto CubeFX della community offre un percorso di installazione del firmware personalizzato per gli utenti esperti che lo desiderano consapevolmente.
Aggiornamenti firmware OTA
L'ESP32 espone anche un'interfaccia web OTA. Non caricare binari firmware sconosciuti; conserva una copia di ripristino e tieni presente che il firmware personalizzato può modificare il protocollo previsto da ZimaOS.
Usare l'RGB per automatizzare lo stato
Poiché l'endpoint di controllo accetta JSON, puoi associare lo stato dei backup, gli avvisi sui dischi, i download o l'attività dell'IA locale a colori gestiti da script, senza intervenire sul sottosistema di archiviazione.
La panoramica del controllo RGB offre ulteriore contesto per il progetto.
Convertire i valori HSV prima di inviare il JSON
Il protocollo ufficiale prevede tonalità, saturazione e valore su una scala da 0 a 255. Se il selettore di colori usa gradi e percentuali, converti questi valori prima di inviarli all'ESP32.
Testare una modalità semplice prima di automatizzare
Inizia con la modalità a colore fisso e verifica che il controller risponda. Solo in seguito aggiungi script per lo stato dei backup, gli avvisi sui dischi o gli effetti musicali. In questo modo puoi distinguere i problemi di rete o di protocollo dalla logica di automazione.
Mantenere l'automazione non critica
Usa i LED come ausilio visivo, non come unico canale di avviso per guasti ai dischi o backup. Le notifiche hardware dovrebbero essere presenti anche nei log, nelle email, nei sistemi di monitoraggio o in un altro canale persistente.
Domande frequenti
Ho bisogno di CubeFX per controllare i LED?
No. Il firmware ufficiale attuale dispone di un protocollo JSON/HTTP documentato.
Quanti LED ci sono nella striscia?
La documentazione hardware ufficiale specifica 13 LED WS2812B.
Posso controllare ogni LED separatamente?
Sì, la modalità personalizzata ufficiale supporta valori HSV per singolo LED.
Posso ripristinare il firmware di serie dopo CubeFX?
Usa le risorse ufficiali OTA/firmware e verifica la revisione hardware corretta prima di reinstallare il firmware.
