O NasBlogKontakt
Zaawansowane i Poradniki

Zdalne urządzenia

Jak dodać i kontrolować zdalne urządzenia boneIO Black i ESPHome przez MQTT i ESPHome API.

Sterownik boneIO Black może kontrolować inne urządzenia w sieci - zarówno inne sterowniki boneIO Black (przez MQTT), jak i urządzenia ESPHome (przez ESPHome API).

Automatyczne wykrywanie - urządzenia boneIO Black w tej samej sieci MQTT są automatycznie wykrywane. Urządzenia ESPHome można znaleźć przez skanowanie sieci.

Lista zdalnych urządzeń

Lista zdalnych urządzeń

Przejdź do UstawieniaRemote Devices aby zobaczyć listę skonfigurowanych zdalnych urządzeń.

Wspierane protokoły

MQTT - boneIO Black

Sterowniki boneIO Black w obrębie tego samego brokera MQTT są automatycznie wykrywane i mogą kontrolować swoje wyjścia i rolety nawzajem.

Wymagania:

  • Wszystkie urządzenia boneIO Black muszą być podłączone do tego samego brokera MQTT
  • Urządzenia automatycznie publikują swoją dostępność i listę wyjść/rolet

Zastosowania:

  • Centralne sterowanie wieloma sterownikami z jednego miejsca
  • Synchronizacja działania między urządzeniami
  • Tworzenie złożonych automatyzacji między sterownikami

ESPHome API - urządzenia ESPHome

Urządzenia ESPHome w tej samej sieci lokalnej mogą być kontrolowane przez ESPHome Native API.

Wsparcie ESPHome jest eksperymentalne - funkcja jest w fazie testów i może wymagać dodatkowej konfiguracji.

Wymagania:

  • Urządzenie ESPHome musi mieć włączone API w konfiguracji
  • Urządzenia muszą być w tej samej sieci lokalnej
  • Opcjonalnie: hasło API lub klucz szyfrowania

Wspierane encje ESPHome:

  • Switches - przełączniki
  • Lights - oświetlenie (z obsługą jasności, temperatury barwowej, RGB/RGBW)
  • Covers - rolety/żaluzje (z obsługą pozycji i pochylenia)

Automatyczne wykrywanie urządzeń

Wykrywanie boneIO Black (MQTT)

Urządzenia boneIO Black są automatycznie wykrywane gdy:

  1. Są podłączone do tego samego brokera MQTT
  2. Mają włączone MQTT Discovery
  3. Publikują swoje wyjścia i rolety

Lista wykrytych urządzeń odświeża się automatycznie co 30 sekund.

Skanowanie ESPHome (mDNS)

Aby znaleźć urządzenia ESPHome w sieci:

  1. Przejdź do UstawieniaRemote Devices
  2. Kliknij przycisk Scan ESPHome
  3. System przeskanuje sieć lokalną przez mDNS (timeout 3s)
  4. Wykryte urządzenia pojawią się na liście

Dodawanie zdalnego urządzenia

Dodawanie z automatycznego wykrywania

  1. Przejdź do UstawieniaRemote Devices
  2. W sekcji Autodiscovered Devices znajdź urządzenie
  3. Kliknij przycisk Add przy wybranym urządzeniu
  4. Urządzenie zostanie automatycznie dodane z wykrytymi wyjściami/roletami

Dodawanie zdalnego urządzenia

Ręczne dodawanie urządzenia

Jeśli urządzenie nie zostało automatycznie wykryte, możesz je dodać ręcznie:

Pola podstawowe

PoleOpisWymagane
Device IDUnikalny identyfikator urządzenia✅ Tak
Device NameNazwa wyświetlana✅ Tak
ProtocolProtokół: mqtt lub esphome_api✅ Tak
Device TypeTyp: boneio_black, esphome, genericNie

Konfiguracja MQTT (dla boneIO Black)

PoleOpis
OutputsLista wyjść (ID i nazwa)
CoversLista rolet (ID i nazwa)

Konfiguracja ESPHome API

PoleOpisWymagane
HostAdres IP lub hostname urządzenia ESPHome✅ Tak
PortPort API (domyślnie 6053)Nie
PasswordHasło API (jeśli skonfigurowane)Nie
Encryption KeyKlucz szyfrowania (jeśli skonfigurowany)Nie

Wykrywanie encji ESPHome

Po dodaniu urządzenia ESPHome:

  1. Kliknij przycisk Discover (ikona odświeżania) przy urządzeniu
  2. System połączy się z urządzeniem i pobierze listę dostępnych encji
  3. Wykryte switches, lights i covers zostaną automatycznie dodane
  4. Liczba wykrytych encji pojawi się jako badge przy przycisku

Przykłady konfiguracji

Przykład 1: Dodanie drugiego boneIO Black

  1. Upewnij się, że oba urządzenia są podłączone do tego samego brokera MQTT
  2. Drugie urządzenie pojawi się automatycznie w sekcji Autodiscovered Devices
  3. Kliknij Add - urządzenie zostanie dodane z wszystkimi wyjściami i roletami
  4. Możesz teraz kontrolować wyjścia drugiego urządzenia z pierwszego sterownika

Przykład 2: Dodanie urządzenia ESPHome

Konfiguracja ESPHome (na urządzeniu ESPHome):

api:
  password: "twoje_haslo"
  encryption:
    key: "twoj_klucz_szyfrowania"

switch:
  - platform: gpio
    pin: GPIO5
    name: "Światło garaż"
    id: garage_light

W boneIO Black:

  1. Kliknij Scan ESPHome - urządzenie powinno się pojawić
  2. Kliknij Add przy wykrytym urządzeniu
  3. Wprowadź hasło API i klucz szyfrowania (jeśli są ustawione)
  4. Kliknij Discover aby pobrać listę encji
  5. Switch "Światło garaż" będzie dostępny do kontroli

Urządzenia zarządzające tym sterownikiem

W sekcji Managed By zobaczysz listę innych sterowników boneIO Black, które mają skonfigurowane to urządzenie jako zdalne.

To pozwala zobaczyć, które urządzenia mogą kontrolować ten sterownik - przydatne przy diagnozowaniu konfiguracji w większych instalacjach.

Użycie w automatyzacjach

Zdalne urządzenia mogą być używane w:

  • Akcjach eventów - kliknięcie przycisku na jednym sterowniku włącza światło na drugim
  • Akcjach binary sensors - czujnik ruchu na jednym urządzeniu kontroluje wyjście na drugim
  • Automatyzacjach czasowych - harmonogramy mogą kontrolować zdalne urządzenia

Wszystkie zdalne wyjścia i rolety są dostępne w dropdownach wyboru akcji, oznaczone prefiksem z nazwą urządzenia.

Weryfikacja w Home Assistant

Zdalne urządzenia kontrolowane przez boneIO Black:

  • Nie pojawiają się jako osobne urządzenia w Home Assistant
  • Są kontrolowane przez główny sterownik boneIO Black
  • Wszystkie akcje są wykonywane przez sterownik główny

Jeśli chcesz kontrolować zdalne urządzenia bezpośrednio z Home Assistant, dodaj je jako osobne integracje MQTT lub ESPHome.

Rozwiązywanie problemów

Urządzenie boneIO Black nie jest wykrywane

  1. Sprawdź czy oba urządzenia są podłączone do tego samego brokera MQTT
  2. Sprawdź czy MQTT Discovery jest włączone na obu urządzeniach
  3. Sprawdź logi MQTT - czy urządzenie publikuje swoje dane
  4. Odśwież stronę - lista odświeża się co 30 sekund

Urządzenie ESPHome nie jest wykrywane

  1. Upewnij się, że urządzenie jest w tej samej sieci lokalnej
  2. Sprawdź czy API jest włączone w konfiguracji ESPHome
  3. Sprawdź czy urządzenie odpowiada na ping
  4. Spróbuj dodać urządzenie ręcznie przez adres IP

Nie można połączyć się z ESPHome API

  1. Sprawdź czy hasło API jest poprawne
  2. Sprawdź czy klucz szyfrowania jest poprawny (jeśli używany)
  3. Sprawdź czy port 6053 nie jest zablokowany przez firewall
  4. Sprawdź logi ESPHome - czy API jest aktywne