MQTT

Публікувати показники на власний брокер і обирати між п'ятьма форматами повідомлень.

Вкладка MQTT публікує ті самі показники на будь-який брокер. Вона потрібна тим, хто живить систему, відмінну від Home Assistant, або тим, хто воліє живити Home Assistant через власний брокер.

Як і в рідної інтеграції, з'єднання йде з вашого телефона просто на вашу машину, не проходячи через наші сервери.

  1. Уведіть брокер

    Заповніть Адреса брокера та Порт. Якщо брокер вимагає автентифікації, заповніть також Користувач і Пароль.

    Увімкніть Використовувати TLS (SSL), коли брокер доступний за межами вашої мережі. Використовуйте WebSocket і Базовий шлях потрібні брокерам за проксі.

  2. Оберіть версію протоколу

    Кнопки MQTT 3.1.1 і MQTT 5.0 обирають версію. У сумніві обирайте 3.1.1, ширше сумісну.

  3. Оберіть формат

    Формат MQTT задає вигляд тем і формат кожного повідомлення. Є п'ять варіантів:

    • Home Assistant Discovery: з автоматичним виявленням сутності створюються самі, з іменем, одиницею та значком.
    • Homie 4.0: іде за угодою Homie.
    • Прості теми: одне значення на тему, без додаткової структури. Найлегше розбирати зі скрипта.
    • Об'єднаний JSON: усе в одному повідомленні, на темі, яку ви задасте.
    • ThingsBoard: формат телеметрії ThingsBoard.

    Деякі формати мають власні налаштування, наприклад JSON-навантаження (значення + мітка часу) у простих тем і Включити мітку часу у ThingsBoard.

  4. Задайте префікс тем

    Префікс теми — це корінь усього, що публікує застосунок. Задайте значення на початку й уникайте змінювати його потім, бо зміна залишає старі теми осиротілими на брокері.

  5. Перевірте перед виходом

    Натисніть Тестове підключення. Перевірка підтверджує адресу, порт, TLS і облікові дані, перш ніж ви увімкнете передачу.

  6. Увімкніть передачу й збережіть

    Увімкніть Увімкнути передачу, задайте Інтервал передачі і збережіть плаваючою кнопкою.

Якщо щось пішло не так

Перевіряйте в такому порядку: адресу та порт, чи телефон у мережі, яка дістає до брокера, чи Використовувати TLS (SSL) відповідає тому, чого чекає брокер, і чи правильні користувач та пароль.

Порт 1883 зазвичай працює без TLS, а 8883 з TLS. Увімкнути TLS проти порту, який його не використовує, дає збій без корисного повідомлення.

Оберіть формат Home Assistant Discovery, єдиний з автоматичним виявленням. В інших форматах сутності доводиться оголошувати вручну.

Для Home Assistant придивіться до рідної інтеграції: вона працює в обидва боки, публікує події на шині й не потребує брокера.

Застосунок питає, чи хочете ви прибрати теми попереднього формату. Якщо відповіддю було лишити їх, вони лишаються на брокері, доки їх не видалять там.

Для Home Assistant рідна інтеграція дає більше: вона працює в обидва боки, публікує події на шині й не потребує брокера.

MQTT — правильний вибір, коли ви вже маєте брокер, коли живите систему, відмінну від Home Assistant, або коли дані потрібні одразу в кількох місцях.

← Усі посібникиУ FAQ: Home Assistant і MQTT →