MQTT

Publikować odczyty na własnym brokerze i wybierać spośród pięciu formatów wiadomości.

Zakładka MQTT publikuje te same odczyty na dowolnym brokerze. Służy tym, którzy zasilają system inny niż Home Assistant, albo tym, którzy wolą zasilać Home Assistant przez własnego brokera.

Tak jak przy integracji natywnej, połączenie idzie z twojego telefonu prosto na twoją maszynę, bez przechodzenia przez nasze serwery.

  1. Wprowadź brokera

    Wypełnij Adres brokera i Port. Jeśli broker wymaga uwierzytelnienia, wypełnij też Użytkownik i Hasło.

    Włącz Użyj protokołu TLS (SSL), gdy broker jest wystawiony poza twoją sieć. Użyj protokołu WebSocket i Ścieżka bazowa służą brokerom za proxy.

  2. Wybierz wersję protokołu

    Przyciski MQTT 3.1.1 i MQTT 5.0 wybierają wersję. W razie wątpliwości wybierz 3.1.1, szerzej zgodną.

  3. Wybierz format

    Format MQTT ustala kształt tematów i format każdej wiadomości. Jest pięć opcji:

    • Home Assistant Discovery: przy automatycznym wykrywaniu encje tworzą się same, z nazwą, jednostką i ikoną.
    • Homie 4.0: idzie za konwencją Homie.
    • Proste tematy: jedna wartość na temat, bez dodatkowej struktury. Najłatwiejszy do skonsumowania ze skryptu.
    • Ujednolicony JSON: wszystko w jednej wiadomości, na temacie, który ustawisz.
    • ThingsBoard: format telemetrii ThingsBoard.

    Część formatów ma własne ustawienia, jak Payload JSON (wartość + znacznik czasu) przy prostych tematach i Dołącz znacznik czasu przy ThingsBoard.

  4. Ustaw prefiks tematów

    Prefiks tematu to korzeń wszystkiego, co publikuje aplikacja. Ustaw wartość na początku i unikaj zmieniania jej później, bo zmiana zostawia stare tematy osierocone na brokerze.

  5. Przetestuj przed wyjściem

    Dotknij Połączenie testowe. Test potwierdza adres, port, TLS i dane logowania, zanim włączysz transmisję.

  6. Włącz transmisję i zapisz

    Włącz Włącz transmisję, ustaw Interwał transmisji i zapisz przyciskiem pływającym.

Jeśli coś pójdzie nie tak

Sprawdzaj w tej kolejności: adres i port, czy telefon jest w sieci, która sięga brokera, czy Użyj protokołu TLS (SSL) zgadza się z tym, czego oczekuje broker, i czy użytkownik oraz hasło są właściwe.

Port 1883 zwykle działa bez TLS, a 8883 z TLS. Włączenie TLS wobec portu, który go nie używa, daje niepowodzenie bez pomocnego komunikatu.

Wybierz format Home Assistant Discovery, jedyny z automatycznym wykrywaniem. W pozostałych formatach encje trzeba zadeklarować ręcznie.

Dla Home Assistant rozważ integrację natywną: działa w obie strony, publikuje zdarzenia na magistrali i nie wymaga brokera.

Aplikacja pyta, czy chcesz posprzątać tematy poprzedniego formatu. Jeśli odpowiedzią było je zachować, zostają na brokerze, dopóki nie zostaną tam usunięte.

Dla Home Assistant integracja natywna daje więcej: działa w obie strony, publikuje zdarzenia na magistrali i nie wymaga brokera.

MQTT to właściwy wybór, gdy już prowadzisz brokera, gdy zasilasz system inny niż Home Assistant, albo gdy potrzebujesz danych w więcej niż jednym miejscu naraz.

← Wszystkie poradnikiW FAQ: Home Assistant i MQTT →