O NasBlogKontakt

Klient MQTT

W najnowszej wersji aplikacji bardzo dużo pracy poświecliśmy dopracowaniu apektów związanych z mqtt. Domyślnym i preferowanym trybem pracy dla naszego ekosystemu jest ten w którym to własnie boneIO i wbudowany w niego mosquitto zostają brokerem mqtt.

Konfiguracja w aplikacji webowej

Zalecany sposób konfiguracji.

Przykładowa konfiguracja w webui

W sekcji ustawien definiujemy wszystkie niezbędne parametry dla naszego brokera mqtt.

Widok menu Obszary

Nazwa opcjiOpis
Hostnazwa hosta bądź jego adres - domyślnie localhost, broker na sterowniku (urządzenie z brokerem MQTT).
PortPort do połączenia z brokerem MQTT.
Nazwa użytkownikaNazwa z jaką aplikacja boneIO łączy się z brokerem MQTT.
Włącz HA AutodiscoveryUmożliwia automatyczną rejestrację urządzenia w HA.
Prefiks Tematu Autodiscovery HAPrefiks tematu Autodiscovery HA - domyślny homeassistant.
Wysyłaj Autodiscovery boneIOPublikuj wszystkie wyjścia, wejścia do tematów MQTT - Umożliwia zdalne sterowanie naszym urzadzeniem bezpośrednio przez inne urządzenia boneIO/
Odbieraj Autodiscovery boneIOUmożliwia odkrywanie w sieci innych urządzeń boneIO.

Edytor YAML

Komponent klienta MQTT łączy się z Twoim brokerem MQTT.

W większości przypadków broker ten powinien być tym samym brokerem, którego używa Home Assistant, abyś mógł bezpośrednio widzieć nowe urządzenia dzięki opcji autodetekcji (auto-discovery) MQTT w HA.

Przykładowa konfiguracja

Przykładowa konfiguracja
mqtt:
  host: localhost
  username: mqtt
  password: mqtt
  topic_prefix: boneio1
  ha_discovery:
    enabled: yes

Zmienne konfiguracyjne:

  • host (Wymagane, string) - Nazwa hosta lub adres IP brokera MQTT.
  • username (Opcjonalne, string) - Nazwa użytkownika do połączenia z brokerem MQTT.
  • password (Opcjonalne, string) - Hasło do brokera MQTT.
  • port (Opcjonalne, integer, domyślnie: 1883) - Port do połączenia z brokerem MQTT.
  • topic_prefix (Opcjonalne, string, domyślnie: boneIO) - Prefiks tematu (topic) do użycia przez boneIO. Ten tekst będzie używany w Home Assistant.
  • ha_discovery:
    • enabled (Opcjonalne, boolean, domyślnie: True) - Włącz autodetekcję (discovery) HA.
    • topic_prefix (Opcjonalne, string, domyślnie: homeassistant) - Prefiks tematu, którego Home Assistant używa do autodetekcji MQTT.