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
- Otwórz HACS w Home Assistant.
- Otwórz Integrations.
- Dodaj własne repozytorium https://github.com/11ado33/ha-homebrainz-integration.
- Ustaw kategorię na Integration.
- Zainstaluj HomeBrainz.
- Uruchom ponownie Home Assistant.
Opcja 2: Instalacja Ręczna
- Otwórz folder konfiguracji Home Assistant.
- Utwórz custom_components/homebrainz, jeśli jeszcze nie istnieje.
- Skopiuj pliki z folderu custom_components/homebrainz z repozytorium integracji do tego folderu.
- Uruchom ponownie Home Assistant.
Dodaj Integrację W Home Assistant
- W Home Assistant otwórz Settings > Devices & Services.
- Wybierz Add Integration.
- Wyszukaj HomeBrainz.
- Jeśli Home Assistant wykryje urządzenie automatycznie, wybierz je.
- Jeśli nie, wpisz adres IP urządzenia ręcznie.
- 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.
- Otwórz http://DEVICE_IP/.
- Użyj inkVision Device Dashboard do sprawdzenia stanu urządzenia, bieżących sensorów, jasności, obrotu ekranu, akcji OTA oraz restartu.
- Otwórz http://DEVICE_IP/ota, jeśli chcesz ręcznie wgrać lokalny plik firmware .bin.
- Jeśli Home Assistant pokazuje nieaktualne wartości, porównaj je z dashboardem albo z odpowiedziami /status i /sensors.
Zweryfikuj Połączenie
- Otwórz nową stronę urządzenia HomeBrainz w Home Assistant.
- Potwierdź, że wartości czujników się aktualizują.
- Otwórz lokalny link webowy urządzenia z poziomu Home Assistant, jeśli jest dostępny.
- 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.