Rozwiązanie społecznościowe

Steruj podświetleniem RGB ZimaCube za pomocą oficjalnego interfejsu API diod LED w 7. zatoce

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

Oświetlenie RGB w 7. zatoce ZimaCube ma już oficjalny protokół sterowania, więc nie musisz wgrywać CubeFX tylko po to, by zmienić kolory lub efekty. Oficjalny firmware udostępnia punkt dostępu Wi-Fi ESP32 pod adresem 172.16.1.1 i przyjmuje polecenia JSON dla efektu oddychania, jednolitego koloru oraz niestandardowych trybów sterowania poszczególnymi diodami LED.

CubeFX pozostaje opcjonalnym firmware’em społeczności dla użytkowników, którzy chcą innego interfejsu lub większych możliwości personalizacji. Jeśli wolisz standardowy firmware, użyj oficjalnej metody HTTP/JSON i nie wgrywaj ponownie firmware’u do ESP32.

Jak działa oświetlenie 7. zatoki

Aktualny protokół LED 7. zatoki informuje, że sterownik oświetlenia to ESP32 podłączony do taśmy z 13 diodami LED WS2812B.

Połącz się ze sterownikiem oświetlenia

Oficjalny firmware tworzy sieć Wi-Fi o nazwie ZimaCube i udokumentowanym haśle homecloud. Kontroler jest dostępny pod adresem 172.16.1.1.

ping 172.16.1.1

Ustaw jednolity kolor

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

Wyślij JSON do kontrolera:

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

Efekt oddychania i tryby niestandardowe

Tryb 1 to efekt oddychania z regulowaną prędkością. Tryb 5 umożliwia sterowanie kolorem i jasnością każdej z 13 diod LED. W oficjalnej dokumentacji tryby 3 i 4 są obecnie oznaczone jako będące w trakcie opracowywania.

Możesz pozostać przy standardowym firmware

To kluczowa zmiana w porównaniu z wątkiem na forum z 2024 roku: dostępna jest już oficjalna dokumentacja sterowania. Możesz skryptować standardowy firmware bez wgrywania obrazu innej firmy.

CubeFX nadal jest opcjonalną alternatywą

Wątek projektu społeczności CubeFX przedstawia niestandardową ścieżkę instalacji firmware’u dla zaawansowanych użytkowników, którzy świadomie jej chcą.

Aktualizacje firmware’u OTA

ESP32 udostępnia również interfejs OTA. Nie przesyłaj nieznanych plików firmware’u; zachowaj kopię odzyskiwania i pamiętaj, że niestandardowe firmware może zmienić protokół wymagany przez ZimaOS.

Użyj RGB do automatyzacji sygnalizacji statusu

Ponieważ punkt końcowy sterowania przyjmuje JSON, możesz za pomocą skryptów przypisywać kolory do stanu kopii zapasowych, alertów dotyczących dysków, pobierania plików lub aktywności lokalnej sztucznej inteligencji, nie ingerując w podsystem pamięci masowej.

Przegląd sterowania RGB zawiera dodatkowe informacje o projekcie.

Przelicz wartości HSV przed wysłaniem JSON

Oficjalny protokół wymaga wartości odcienia, nasycenia i jasności w skali 0–255. Jeśli selektor kolorów używa stopni i wartości procentowych, przelicz je przed wysłaniem do ESP32.

Przed automatyzacją przetestuj jeden prosty tryb

Zacznij od trybu stałego koloru i sprawdź, czy kontroler reaguje. Dopiero potem dodaj skrypty informujące o stanie kopii zapasowych, alertach dotyczących dysków lub efektach muzycznych. Pozwoli to odróżnić problemy z siecią lub protokołem od błędów w logice automatyzacji.

Nie używaj automatyzacji do zadań krytycznych

Używaj diod LED jako wygodnego wizualnego wskaźnika, a nie jedynego kanału powiadomień o awariach dysków lub kopiach zapasowych. Powiadomienia sprzętowe powinny być również dostępne w logach, e-mailach, systemie monitorowania lub innym trwałym kanale.

FAQ

Czy do sterowania diodami LED potrzebuję CubeFX?

Nie. Aktualne oficjalne oprogramowanie sprzętowe udostępnia udokumentowany protokół JSON/HTTP.

Ile diod LED jest na pasku?

W oficjalnej dokumentacji sprzętu podano 13 diod LED WS2812B.

Czy mogę sterować każdą diodą LED osobno?

Oficjalny tryb niestandardowy obsługuje wartości HSV dla każdej diody LED.

Czy po zainstalowaniu CubeFX mogę przywrócić fabryczne oprogramowanie?

Skorzystaj z oficjalnych zasobów OTA/firmware i przed ponownym wgraniem firmware’u potwierdź właściwą wersję sprzętu.