Połączenie z Home Assistant
Jak połączyć sterownik boneIO Black z Home Assistant przez MQTT.
Sterownik boneIO Black komunikuje się z Home Assistant przez protokół MQTT. Masz dwa sposoby konfiguracji:
Opcja 1: Broker MQTT na boneIO Black (domyślnie)
To najprostszy sposób - sterownik ma wbudowany broker MQTT Mosquitto, który jest już skonfigurowany i uruchomiony.

Konfiguracja domyślna
Domyślnie sterownik jest połączony z lokalnym brokerem MQTT:
- Host:
127.0.0.1(localhost) - Port:
1883 - Username:
boneio - Password:
boneio - Topic Prefix:
boneio
Zmień hasło MQTT! Przejdź do Ustawienia → System → zakładka MQTT i zmień domyślne hasło brokera MQTT na bezpieczne.

Podłączenie Home Assistant do brokera na boneIO
-
Zainstaluj Mosquitto Broker w Home Assistant (jeśli jeszcze nie masz):
- Przejdź do Ustawienia → Dodatki → Sklep z dodatkami
- Wyszukaj Mosquitto broker
- Kliknij Instaluj i Uruchom
-
Dodaj integrację MQTT w Home Assistant:
- Przejdź do Ustawienia → Urządzenia i usługi
- Kliknij Dodaj integrację → wyszukaj MQTT
- Wprowadź dane:
- Broker: IP sterownika boneIO (np.
192.168.1.100) - Port:
1883 - Username:
homeassistant(lubboneio) - Password: hasło zmienione w zakładce System
- Broker: IP sterownika boneIO (np.
- Kliknij Prześlij
-
Automatyczne wykrywanie:
- Sterownik boneIO automatycznie zgłosi wszystkie urządzenia do Home Assistant
- Urządzenia pojawią się w Ustawienia → Urządzenia i usługi → MQTT
Opcja 2: Broker MQTT na Home Assistant
Możesz podłączyć sterownik do brokera MQTT znajdującego się na Home Assistant lub innym urządzeniu.
Konfiguracja brokera w Home Assistant
-
Zainstaluj Mosquitto Broker (jeśli jeszcze nie masz):
- Przejdź do Ustawienia → Dodatki → Sklep z dodatkami
- Wyszukaj Mosquitto broker
- Kliknij Instaluj i Uruchom
-
Utwórz użytkownika MQTT:
- Przejdź do Ustawienia → Osoby → Użytkownicy
- Kliknij Dodaj użytkownika
- Wypełnij dane:
- Nazwa:
boneio - Nazwa użytkownika:
boneio - Hasło: wybierz bezpieczne hasło
- Nazwa:
- Kliknij Utwórz
-
Dodaj integrację MQTT (jeśli jeszcze nie masz):
- Przejdź do Ustawienia → Urządzenia i usługi
- MQTT powinien być automatycznie wykryty
- Jeśli nie, kliknij Dodaj integrację → MQTT
- Wprowadź dane użytkownika (np.
homeassistantlub utworzonego użytkownika)
Konfiguracja MQTT w sterowniku boneIO
- Przejdź do Ustawienia → MQTT
- Wprowadź dane brokera:
- Host: IP Home Assistant (np.
192.168.1.50) - Port:
1883 - Username:
boneio - Password: hasło utworzonego użytkownika
- Topic Prefix:
boneio(lub dowolny)
- Host: IP Home Assistant (np.
- Kliknij Zapisz
- Urządzenia automatycznie pojawią się w Home Assistant
Komunikacja między sterownikami boneIO
Jeśli masz wiele sterowników boneIO Black i chcesz, aby mogły nawzajem wykonywać komendy (np. przycisk na jednym sterowniku włącza światło na drugim), wszystkie sterowniki muszą być podłączone do tego samego brokera MQTT.
Przykład konfiguracji dla wielu sterowników:
- Wybierz jeden broker MQTT (np. na Home Assistant lub na jednym ze sterowników)
- Podłącz wszystkie sterowniki do tego samego brokera
- Każdy sterownik powinien mieć unikalny Topic Prefix (np.
boneio1,boneio2,boneio3) - W akcjach możesz używać Remote Output i Remote Cover do sterowania urządzeniami na innych sterownikach
Weryfikacja połączenia
Po poprawnej konfiguracji:
- W Home Assistant przejdź do Ustawienia → Urządzenia i usługi → MQTT
- Powinieneś zobaczyć urządzenie boneIO Black z wszystkimi skonfigurowanymi wyjściami, roletami, wejściami i sensorami
- Wszystkie encje będą automatycznie dostępne w Home Assistant
Sterownik używa MQTT Discovery - wszystkie urządzenia są automatycznie wykrywane przez Home Assistant bez konieczności ręcznej konfiguracji.