MQTT консоль

Отправка команд и мониторинг сообщений в реальном времени
MQTT консоль — инструмент для разработки и отладки. Она позволяет вручную отправлять произвольные MQTT сообщения любым устройствам, а также подписываться на топики и наблюдать за поступающими ответами. Незаменима при подключении нового устройства, написании сценариев и диагностике проблем.

Как открыть

Два способа открыть MQTT консоль:

  • На странице «Настройки» → карточка «MQTT брокер» → кнопка «MQTT консоль»
  • На странице «Сценарии» — кнопка в нижней панели
MQTT консоль доступна только с правами пользователя или администратора. Гость не имеет к ней доступа.

Отправка MQTT сообщения

Верхняя часть страницы — форма отправки:

ПолеОписание
Устройство Выберите устройство из рабочего поля — топик и payload заполнятся автоматически. Или введите Device SN вручную.
MQTT топик Куда отправить сообщение. Примеры:
  • zigbee2mqtt/lamp_kitchen/set — команда Zigbee устройству
  • realiot/command/my_device — команда WiFi устройству
  • matter/my_device/set — команда Matter устройству
Payload (JSON) Тело сообщения в формате JSON. Примеры:
  • {"state": "ON"} — включить устройство
  • {"brightness": 128} — установить яркость
  • {"state": "OFF"} — выключить устройство
MQTT брокер Через какой брокер отправлять: основной или один из дополнительных.

После заполнения нажмите «Отправить». Статус отправки отобразится под кнопкой.

Мониторинг ответов

Нижняя часть страницы — лента входящих сообщений в реальном времени:

ЭлементОписание
Фильтр топика Подписка на топики для наблюдения. Поддерживает wildcards:
  • zigbee2mqtt/# — все сообщения от Zigbee устройств
  • realiot/data/# — все данные от WiFi устройств
  • # — все сообщения на брокере
Поиск Поиск по тексту внутри потока входящих сообщений
Пауза Останавливает обновление ленты для изучения конкретного момента
Лента сообщений Хронологический поток входящих MQTT сообщений с временными метками, топиками и payload
MQTT консоль — отправка и мониторинг
MQTT консоль: публикация (вверху) и лента входящих сообщений (внизу)

Практическое применение

🔌 Проверка нового Zigbee устройства

  1. Подпишитесь на zigbee2mqtt/#
  2. Нажмите кнопку на корпусе устройства
  3. В ленте появятся сообщения с параметрами устройства
  4. Убедитесь, что нужные параметры присутствуют и имеют корректные значения

⚙️ Тестирование команды управления

  1. Выберите устройство из списка
  2. Заполните топик: zigbee2mqtt/lamp_kitchen/set
  3. Payload: {"state": "ON", "brightness": 200}
  4. Нажмите «Отправить» — лампа должна включиться

🔍 Поиск правильного формата команды

Подпишитесь на zigbee2mqtt/имя_устройства и с помощью физического управления устройством (кнопки, пульт) вызовите нужное состояние. В ленте появится сообщение с точным форматом данных, которые устройство отправляет — используйте его как шаблон для сценариев.

📡 Диагностика LoRaWAN устройства

Подпишитесь на application/#, чтобы видеть все данные от LoRaWAN устройств через ChirpStack. Убедитесь, что данные приходят и декодируются корректно.

Форматы топиков для разных протоколов
ПротоколТопик данныхТопик команд
Zigbee zigbee2mqtt/<device_name> zigbee2mqtt/<device_name>/set
WiFi (RealLab) realiot/data/<deviceSN> realiot/command/<deviceSN>
Matter matter/<deviceSN> matter/<deviceSN>/set
LoRaWAN application/<id>/device/<deveui>/event/up application/<id>/device/<deveui>/command/down
VirtualDevice realiot/data/json realiot/virtual/command/<deviceSN>

Используйте MQTT консоль при подключении новых устройств, отладке сценариев и диагностике любых проблем с обменом данными.

← Назад к справке