Przewodnik
Połącz z Home Assistant
Zainstaluj integrację inkVision 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/HomeBrainz/ha-inkVision.
- Ustaw kategorię na Integration.
- Zainstaluj inkVision.
- Uruchom ponownie Home Assistant.
Opcja 2: Instalacja Ręczna
- Otwórz folder konfiguracji Home Assistant.
- Utwórz custom_components/inkvision, jeśli jeszcze nie istnieje.
- Skopiuj pliki z folderu custom_components/inkvision z repozytorium integracji do tego folderu.
- Uruchom ponownie Home Assistant.
Przejście Z Integracji HomeBrainz
- Integracja nazywała się wcześniej HomeBrainz. Po aktualizacji w HACS i ponownym uruchomieniu Home Assistant Twoje urządzenia automatycznie przechodzą do inkVision i zachowują identyfikatory encji oraz historię.
- Akcje zmieniły nazwy z homebrainz.* na inkvision.*. Stare nazwy nadal działają, a w Ustawienia > Naprawy zobaczysz, gdy automatyzacja wciąż z nich korzysta.
- HACS pozostawia stary folder custom_components/homebrainz. Powiadomienie w Naprawach zaproponuje jego usunięcie; następnie uruchom ponownie Home Assistant.
Dodaj Integrację W Home Assistant
- W Home Assistant otwórz Settings > Devices & Services.
- Wybierz Add Integration.
- Wyszukaj inkVision.
- 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 zwykle automatycznie wykrywa urządzenie w sieci lokalnej, ale ręczne podanie adresu IP zawsze działa jako opcja awaryjna.
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 inkVision 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.