MQTT (Message Queue Telemetry Transport)  - упрощённый сетевой протокол, работающий поверх TCP/IP. Используется для обмена сообщениями между устройствами по принципу издатель-подписчик.

Информация на брокере MQTT публикуется в элементах-топиках, которые в простейшем виде имеют вид login/hostname/метрика,
где:

login- логин или emal, который используется для доступа к MQTT брокеру(серверу). Указывается на вкладке настроек Servers. Там же указывается пароль, если он требуется

hostname - имя модуля, настраивается на вкладке настроек Main.

метрика - имя датчика или устройства, а так же номер GPIO.

Пример: mylogin/dacha/dsw3 - в этом топике публикуются показания третьего датчика DS18b20 с модуля с именем dacha, который использует логин mylogin для публикации на брокере.

Важно: В адресе топика в MQTT нет корневого слэша, то есть всегда пишется login/hostname/sensor, а не /login/hostname/sensor

Нельзя называть модуль (hostname) русскими буквами - иначе возможны проблемы в работе MQTT.

Дополнительные опции:

                                      для ESP8266    

                               для ESP32/ESP8266RTOS

MQTT Lite Mode - короткие топики, без включенной настройки топики будут иметь более длинный вид с текстом login/hostname/sensors/xxx и login/hostname/gpio/xxx

fix 2.05.16 - исправление для стабильности работы MQTT (для ESP8266).

Дополнительный буфер MQTT - необходимо установить объем памяти зарезервированный под MQTT в случае, если не все метрики видно на брокере. Расчет примерно 50 байт на каждую метрику. Опция уменьшает размер свободного ОЗУ модуля. Конструктор прошивки автоматически рассчитывает размер буфера, но иногда его может не хватать (для ESP8266).

Отдельный топик на запись -  login/hostname/set/output5  - для записи,  login/hostname/output5  - для чтения. Во избежание срабатывания от эхо - рекомендуемая опция.

Свой корневой топик - вместо login/hostname/sensor (описанного в данной документации) будет использоваться путь свой_текст/sensor, который установлен в настройках модуля. Можно делать вложенные топики. Длина до 63 символов.

Новый MQTT  (для RTOS прошивок ESP8266/ESP32)

Данная опция использует mqtt из SDK. Опция поддерживает несколько вариантов подключения. Требуется указывать префикс перед адресом:

mqtt:// - стандартное подключение

ws:// - websocket режим.

mqtts:// - стандартное подключение, но с ssl (не протестировано)

wss:// -websocket режим, но с ssl (не протестировано)

Пример mqtt://mqtt.wifi-iot.com или ws://mqtt.wifi-iot.com для websocket режима

SSL должен поддерживается сервером. Обычно для него используется отдельный порт.

Возможна работа через сертификаты TLS, загружаемые из SPIFFS, но функция не активирована.

Статус подключения MQTT

На сервисной вкладке http://[ip_adr]/debug можно узнать статус подключения к серверу MQTT.

Для ESP8266:

Пример: MQTT IP: 192.81.221.198 State: 15 / Errors: 1

Что значит модуль подключен  к серверу IP адресом 192.81.221.198. Статус подключения 15, количество переподключений - 1.

Статус может принимать несколько вариантов:

15 - подключение успешно. Данные должны передаваться.

6 - ошибка, возможно не верный логин/пароль.

7,8 - ошибка подключения, сбой, исправляется обычно перезагрузкой модуля. Редкая проблема, но бывает, например, если сервер отключался.

Для RTOS прошивок:

Отображает счетчик переподключений и текущее состояние подключения.

Ограничения в MQTT

В Free варианте нельзя управлять устройством, интервал отправки фиксирован на 600 секундах.

Ограничение длины поля логина у ESP8266- 20 символов, пароля - 10 символов. В данный момент увеличить длину пароля можно  через дополнительную настройку в шестеренке опции, но это испортит настройки модуля из-за смещения структуры параметров если не используется опция NVS2.

При изменении настроек MQTT сервера, логина, пароля или имени устройства рекомендуется перезагрузка устройства.

VDD у ESP8266 не передается.

В safe mode у ESP8266 MQTT не работает.

Сервисные MQTT команды:

login/hostname/system/restart - перезапуск модуля.

login/hostname/system/upd - обновление по OTA.

login/hostname/system/aupd - обновление по Auto OTA.

В данные топики нужно отправить цифру 1.

MQTT серверы (брокеры):

---

Android приложения, совместимые с проектом:

Mqtt IoT - Автор Dolfik. WIKI.

MQTT Dash - Автор Routix.

Linear MQTT Dashboard - Автор Ravend. WIKI.

Таблица метрик:

Внимание ! Имена некоторых метрик поменялись с 6.02.21 !! Новые имена можно посмотреть на вкладке Metrics на самом модуле.