BlogKontakt

Podłączenie boneIO Black

Jak połączyć Home Assistant ze sterownikiem boneIO Black przez MQTT, z brokerem na sterowniku albo w Home Assistant.

Sterownik boneIO Black rozmawia z Home Assistant przez MQTT. W Home Assistant dodajesz jedną integrację, MQTT, a sterownik sam zgłasza wszystkie wyjścia, rolety, wejścia, czujniki i szablony. Niczego nie dopisujesz w YAML.

Broker MQTT, czyli program, przez który oba systemy wymieniają wiadomości, może działać w jednym z dwóch miejsc:

Broker na sterowniku (zalecany)Mosquitto w Home Assistant
Gdzie działana boneIO Black, od razu po instalacjiw Home Assistant, jako aplikacja Mosquitto
Co instalujesz w Home Assistanttylko integrację MQTTaplikację Mosquitto i integrację MQTT
Kiedy wybraćprawie zawszegdy masz już Mosquitto w Home Assistant, np. dla dużej sieci Zigbee2MQTT, i chcesz mieć wszystko w jednym brokerze

Broker na sterowniku (zalecany)

1. Ustaw hasło MQTT na sterowniku

Broker na sterowniku ma konto homeassistant z losowym hasłem, innym na każdym urządzeniu. Ustaw znane Ci hasło: w panelu boneIO Black przejdź do Ustawienia → Usługi na sterowniku → Broker MQTT (lokalny), na karcie homeassistant wpisz dwa razy nowe hasło i kliknij Zmień hasło. Szczegóły są na stronie Połączenie z Home Assistant.

2. Dodaj integrację MQTT w Home Assistant

  1. Przejdź do Ustawienia → Urządzenia oraz usługi i kliknij Dodaj integrację w prawym dolnym rogu.

    Home Assistant: Urządzenia oraz usługi, przycisk Dodaj integrację

  2. Wpisz MQTT i wybierz MQTT z listy.

    Home Assistant: wyszukiwanie MQTT w oknie Wybierz markę

  3. Home Assistant pokaże kilka integracji ze słowem MQTT w nazwie. Wybierz pierwszą, samo MQTT.

    Home Assistant: lista Co chcesz dodać? z integracją MQTT na górze

  4. Wybierz Manually enter the MQTT broker connection details (ręczne wpisanie brokera). Home Assistant nie tłumaczy tej opcji na polski.

    Home Assistant: wybór między aplikacją Mosquitto a ręcznym wpisaniem brokera

  5. Wypełnij formularz:

    • Pośrednik: adres IP sterownika boneIO Black, np. 192.168.1.100 (pokazuje go ekran OLED sterownika),
    • Port: 1883,
    • Nazwa użytkownika: homeassistant,
    • Hasło: hasło ustawione w kroku 1.

    Kliknij Zatwierdź.

    Home Assistant: formularz połączenia z brokerem MQTT na sterowniku

  6. Home Assistant od razu znajduje sterownik i otwiera okno Nazwij i przypisz. Każde pomieszczenie ustawione w boneIO jest osobnym urządzeniem, przypisanym już do obszaru o tej samej nazwie. Kliknij Zakończ.

    Home Assistant: okno Nazwij i przypisz z urządzeniami boneIO Black przypisanymi do obszarów

Połączenie można zaszyfrować (TLS, port 8883), co ma sens w sieci współdzielonej albo przez VPN. Opisuje to strona Połączenie z Home Assistant.

Mosquitto w Home Assistant

W tym wariancie broker działa w Home Assistant, a sterownik boneIO Black łączy się z nim.

  1. Przejdź do Ustawienia → Aplikacje i kliknij Zainstaluj aplikację.

    Home Assistant: pusta lista Aplikacje

  2. W Sklep z aplikacjami wpisz Mosquitto i otwórz Mosquitto broker.

    Home Assistant: Sklep z aplikacjami, wynik Mosquitto broker

  3. Kliknij Zainstaluj.

    Home Assistant: strona aplikacji Mosquitto broker przed instalacją

  4. Po instalacji kliknij Uruchom. Uruchamianie przy starcie jest włączone, więc broker wstanie sam po restarcie Home Assistant.

    Home Assistant: Mosquitto broker zainstalowany, przycisk Uruchom

    Home Assistant: Mosquitto broker uruchomiony

  5. Załóż konto, którym sterownik zaloguje się do brokera: Ustawienia → Osoby → Użytkownicy → Dodaj użytkownika, np. z nazwą użytkownika boneio i własnym hasłem.

  6. Home Assistant zwykle sam proponuje integrację MQTT dla nowego brokera w Ustawienia → Urządzenia oraz usługi, w części Wykryte. Kliknij przy niej Utwórz i potwierdź.

  7. W panelu boneIO Black przejdź do Ustawienia → Połączenia → MQTT i wpisz adres IP Home Assistant, port 1883 oraz konto z kroku 5. Opisuje to strona Połączenie z Home Assistant. Po zapisaniu sterownik połączy się z brokerem w Home Assistant i zgłosi swoje urządzenia jak w wariancie z brokerem na sterowniku.

W tym wariancie boneIO Black zależy od Home Assistant: gdy Home Assistant się restartuje albo jest wyłączony, sterownik nie ma brokera i nie wysyła stanów. Akcje ustawione w boneIO (przycisk → światło) działają dalej, bo nie potrzebują MQTT.

Co zobaczysz w Home Assistant

Integracja MQTT pokazuje sterownik i jego urządzenia.

Home Assistant: integracja MQTT z urządzeniami boneIO Black

W Ustawienia → Urządzenia oraz usługi → Urządzenia jest lista:

  • boneIO Black 32x10A: sam sterownik, z jego czujnikami i wszystkim, co nie ma pomieszczenia,
  • boneIO Black 32x10A - Salon, - Kuchnia itd.: jedno urządzenie na każde pomieszczenie ustawione w boneIO, w obszarze o tej samej nazwie. Pomieszczenia ustawiasz w panelu boneIO na stronie Obszary,
  • szablony boneIO (termostat, panel alarmowy, brama, nawadnianie) jako osobne urządzenia, pod swoimi nazwami.

Home Assistant: lista urządzeń boneIO Black z obszarami

Strona jednego pomieszczenia zbiera wszystko, co jest w nim podłączone: światła, rolety i termostat w Sterowanie, kontaktrony i czujniki ruchu w Sensory, przyciski w Zdarzenia.

Home Assistant: urządzenie boneIO Black 32x10A - Salon z encjami

Nazwy w Home Assistant są takie, jak w panelu boneIO.

Aktualizacje boneIO w Home Assistant

Gdy jest nowa wersja aplikacji boneIO Black, Home Assistant pokazuje ją na górze Ustawień, jako boneIO Black Firmware z numerem wersji. Samą aktualizację zrób w panelu boneIO: Jak zaktualizować.

Home Assistant: Ustawienia z aktualizacją boneIO Black Firmware na górze

Panel boneIO w Home Assistant

Aplikacja boneIO do Home Assistant otwiera panel sterownika w menu Home Assistant, bez osobnej karty przeglądarki. Dodaje się ją z repozytorium https://github.com/boneio-eu/home-assistant-addons: w Ustawienia → Aplikacje → Zainstaluj aplikację kliknij trzy kropki w prawym górnym rogu, wybierz Repozytoria, dodaj adres i zainstaluj aplikację boneIO. Opisuje to strona Połączenie z Home Assistant.