MQTT

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

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

Как и у родной интеграции, соединение идёт с вашего телефона прямо на вашу машину, не проходя через наши серверы.

  1. Введите брокер

    Заполните Адрес брокера и Порт. Если брокер требует аутентификации, заполните также Пользователь и Пароль.

    Включите Используйте TLS (SSL), когда брокер доступен за пределами вашей сети. Используйте вебсокет и Базовый путь нужны брокерам за прокси.

  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 →