inkVisioninkVision

Przewodnik

Połącz z Home Assistant

Zainstaluj integrację HomeBrainz Home Assistant i dodaj urządzenie w swojej sieci lokalnej.

Zanim Zaczniesz

Ten przewodnik opisuje aktualną lokalną ścieżkę Home Assistant dla urządzeń Atmos Wi‑Fi, gdy są już połączone z domową siecią Wi‑Fi.

  • Potrzebujesz urządzenia Atmos, które jest już połączone z Twoją domową siecią.
  • Potrzebujesz działającej instancji Home Assistant w tej samej sieci lokalnej.
  • Potrzebujesz adresu IP urządzenia albo sieci, w której Home Assistant discovery może urządzenie odnaleźć.
  • Możesz potwierdzić, że urządzenie jest online, otwierając http://DEVICE_IP/ w przeglądarce.
  • Przydatne lokalne strony i endpointy urządzenia to /, /ota, /status, /sensors, /config.json i /ws.

Opcja 1: Instalacja Przez HACS

  1. Otwórz HACS w Home Assistant.
  2. Otwórz Integrations.
  3. Dodaj własne repozytorium https://github.com/11ado33/ha-homebrainz-integration.
  4. Ustaw kategorię na Integration.
  5. Zainstaluj HomeBrainz.
  6. Uruchom ponownie Home Assistant.

Opcja 2: Instalacja Ręczna

  1. Otwórz folder konfiguracji Home Assistant.
  2. Utwórz custom_components/homebrainz, jeśli jeszcze nie istnieje.
  3. Skopiuj pliki z folderu custom_components/homebrainz z repozytorium integracji do tego folderu.
  4. Uruchom ponownie Home Assistant.

Dodaj Integrację W Home Assistant

  1. W Home Assistant otwórz Settings > Devices & Services.
  2. Wybierz Add Integration.
  3. Wyszukaj HomeBrainz.
  4. Jeśli Home Assistant wykryje urządzenie automatycznie, wybierz je.
  5. Jeśli nie, wpisz adres IP urządzenia ręcznie.
  6. Dokończ proces konfiguracji.

Home Assistant discovery może działać z obecnymi wariantami nazewnictwa HomeBrainz i inkVision, ale ręczne podanie adresu IP jest zawsze poprawną opcją awaryjną.

Co Zostanie Dodane

  • Encje czujników temperatury, wilgotności, ciśnienia, siły sygnału Wi‑Fi i jakości powietrza.
  • Sterowanie jasnością i strefą czasową.
  • Sterowanie obrotem ekranu.
  • Akcje sprawdzania i instalacji firmware’u.
  • Sterowanie głośnikiem lub odtwarzaczem mediów w obsługiwanych buildach.

Użyj Wbudowanych Stron Urządzenia

Przed dodaniem urządzenia do Home Assistant albo po tym kroku możesz porównać jego lokalny stan bezpośrednio na wbudowanych stronach internetowych.

  1. Otwórz http://DEVICE_IP/.
  2. Użyj inkVision Device Dashboard do sprawdzenia stanu urządzenia, bieżących sensorów, jasności, obrotu ekranu, akcji OTA oraz restartu.
  3. Otwórz http://DEVICE_IP/ota, jeśli chcesz ręcznie wgrać lokalny plik firmware .bin.
  4. Jeśli Home Assistant pokazuje nieaktualne wartości, porównaj je z dashboardem albo z odpowiedziami /status i /sensors.

Zweryfikuj Połączenie

  1. Otwórz nową stronę urządzenia HomeBrainz w Home Assistant.
  2. Potwierdź, że wartości czujników się aktualizują.
  3. Otwórz lokalny link webowy urządzenia z poziomu Home Assistant, jeśli jest dostępny.
  4. Jeśli Twój build zawiera elementy sterujące, przetestuj jedną bezpieczną akcję, na przykład jasność.

Rozwiązywanie Problemów

Jeśli discovery nie działa, upewnij się, że Home Assistant i urządzenie Atmos są w tej samej sieci LAN albo osiągalnej podsieci lokalnej, sprawdź, czy http://DEVICE_IP/status odpowiada, i dodaj integrację ponownie z ręcznie wpisanym adresem IP.

Jeśli niektórych encji brakuje, pamiętaj, że encje czujników wymagają builda z sensorami, sterowanie głośnikiem wymaga builda z audio, a sterowanie wyświetlaczem wymaga builda z wyświetlaczem.

Jeśli integracja została dodana, ale wartości się nie aktualizują, przeładuj integrację, uruchom urządzenie Atmos ponownie i sprawdź logi Home Assistant pod kątem błędów połączenia lub WebSocket.

Jeśli nie znasz adresu IP urządzenia, sprawdź listę klientów routera albo użyj skanera sieci lokalnej.