Подключение ZONT к XIOT

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

В этой инструкции используется MQTT-брокер самого XIOT на отдельном порту 11123. Контроллер ZONT подключается к устройству с XIOT по локальной сети. Устанавливать Home Assistant или использовать брокер Wiren Board для этого не требуется.

Что потребуется

• Работающий XIOT-PLC с драйверами MQTT брокер и ZONT MQTT, доступ к настройке его проекта в XIOT-EDITOR.
• Контроллер ZONT, модель и прошивка которого поддерживают MQTT. Настройка описана для семейства H1000+ ПРО; набор объектов и названия отдельных пунктов зависят от прошивки.
• Доступ к веб-интерфейсу ZONT и возможность сохранить его конфигурацию.
• Сетевая связь по Ethernet или Wi-Fi между ZONT и устройством с XIOT. MQTT в контроллерах ZONT не работает через GSM. Желательно закрепить локальные IP-адреса, чтобы они не изменились после перезапуска роутера.

Драйвер поддерживает до десяти подключений ZONT. Для каждого указываются собственный серийный номер и параметры подключения. Несколько ZONT могут работать через один брокер.

MQTT передаёт данные между устройствами по локальной сети. Облачный API-токен ZONT для этого обмена не нужен. Доступ к веб-кабинету для первоначальной настройки и доступ к MQTT — разные подключения.

Адреса, порты и учётные данные

ZONT подключается к брокеру как MQTT-клиент. В данной схеме брокер работает на том же устройстве, что XIOT-PLC. Поэтому адреса в настройках ZONT и в драйвере XIOT различаются, хотя оба клиента подключаются к одному брокеру.

Где настраивать	Адрес брокера	Порт	Авторизация
В самом ZONT	Локальный IP устройства с XIOT, например 192.168.10.20	11123	Логин и пароль выделенного клиента в драйвере «MQTT брокер»
В драйвере «ZONT MQTT» в XIOT	127.0.0.1	11123	Те же логин и пароль

Адрес 192.168.10.20 приведён как пример: подставьте адрес своего устройства с XIOT. Не вводите 127.0.0.1 в настройках ZONT — для него это означало бы подключение к самому себе.

Порт 1887 — защищённый транспорт XIOT, он не используется для ZONT. Его пароль или токен не следует переносить в ZONT. Порт 11123 принадлежит отдельному внешнему MQTT-брокеру XIOT и использует учётные данные его клиентов.

На порту 11123 используется MQTT с логином и паролем, без TLS. Подключение рассчитано на доверенную локальную сеть; не настраивайте переадресацию этого порта из интернета.

1. Подготовить брокер в XIOT

1. Перед изменениями сохраните резервную копию проекта XIOT и конфигурации ZONT.
2. Откройте настройку драйверов в XIOT-EDITOR и выберите MQTT брокер.
3. Выберите отдельного свободного клиента и задайте понятное описание, например «ZONT котельная».
4. Активируйте клиента. Используйте показанные для него логин и пароль.
5. Сохраните проект и дождитесь успешной загрузки конфигурации в XIOT-PLC.

Для работы ZONT не нужно вручную создавать в этом разделе копии всех топиков датчиков и исполнительных устройств: их разбор выполняет драйвер ZONT MQTT.

Индикатор клиента в разделе «MQTT брокер» отслеживает сообщения с заданным там префиксом. У ZONT публикации имеют собственные топики, поэтому надпись «КЛИЕНТ НЕ ПОДКЛЮЧЕН» в этом разделе сама по себе не доказывает отсутствие соединения ZONT. Проверяйте состояние драйвера ZONT и свежесть его показаний.

Внешний брокер XIOT: отдельный клиент и порт 11123. Пароль скрыт при подготовке иллюстрации. Список топиков здесь можно оставить пустым: объекты обрабатывает драйвер ZONT.

2. Настроить соединение в ZONT

1. Откройте веб-интерфейс нужного контроллера ZONT и его настройки MQTT.
2. Откройте MQTT → Настройки подключения. В проверенной прошивке 602 адрес, порт и учётные данные вводятся одной строкой в поле Адрес.
3. Введите адрес вида mqtt://ЛОГИН:ПАРОЛЬ@192.168.10.20:11123, подставив логин и пароль выделенного клиента брокера XIOT и локальный IP устройства с XIOT. Это не пароль от кабинета ZONT и не пароль от аккаунта XIOT.
4. Схема mqtt:// соответствует этому подключению без TLS. Если логин или пароль содержат специальные символы URL, используйте их процентное кодирование.
5. Нажмите Сохранить и дождитесь применения конфигурации в устройстве.
6. Проверьте поступление свежих показаний через новый брокер. На H1000+ ПРО с прошивкой 602 изменение сохранённого адреса не переключало уже открытое MQTT-соединение до перезапуска прибора. Если соединение осталось на прежнем адресе, запланируйте штатную перезагрузку в разделе Сервис → Конфигурация устройства → Перезагрузить с учётом работы отопления.

Не меняйте серийный номер, адреса датчиков, назначения реле и параметры отопления ради изменения MQTT-соединения.

Настройки подключения ZONT. Строка адреса скрыта при подготовке иллюстрации, поскольку содержит пароль; формат строки приведён выше.

3. Выбрать, что ZONT публикует

Одного подключения к брокеру недостаточно: в ZONT нужно выбрать объекты для публикации.

Для автоматического появления устройств в XIOT:

1. Добавьте или откройте публикацию MQTT в ZONT.
2. Выберите нужные типы объектов или конкретные объекты. Начать удобно с двух температурных датчиков.
3. Выберите формат Home Assistant и включите Группировать в устройство. Это формат описания объектов; отдельная программа Home Assistant не нужна.
4. Задайте период публикации, например 10 секунд.
5. Сохраните конфигурацию в ZONT.

Повторите настройку для нужных контуров, реле, пользовательских регуляторов и кнопок. Объект, не включённый в публикацию, не появится в XIOT только потому, что он существует в конфигурации ZONT.

Для объектов без подходящего автоматического объявления используется обычная публикация MQTT. Сохраните её полный топик: он понадобится при ручном добавлении объекта в драйвер XIOT. Для управления также требуется топик подписки ZONT — тот, на котором контроллер принимает команды.

Автоматическое объявление объектов ZONT: формат Home Assistant и группировка в устройство. На этом стенде выбран период 2 секунды.

Обычная публикация выбранных объектов ZONT без формата Home Assistant.

Подписка ZONT на командный топик. Его имя используется в ручных привязках для управления.

4. Настроить драйвер ZONT MQTT в XIOT

1. В настройке драйверов откройте ZONT MQTT.
2. В поле Подключение выберите ZONT 1 для первого контроллера.
3. В блоке Подключение через брокер XIOT выберите активного клиента и нажмите Использовать брокер XIOT.
4. Проверьте подставленные параметры: адрес 127.0.0.1, порт 11123, логин и пароль выбранного клиента. TLS выключен.
5. Введите точный Серийный номер ZONT. Он ограничивает обнаружение объектами именно этого контроллера.
6. Оставьте Префикс обнаружения homeassistant, если в ZONT используется стандартный префикс.
7. Для публикации раз в 10 секунд задайте Ожидание показаний, с равным 60. Ожидание должно быть больше периода публикации.
8. Включите Активен, сохраните проект и дождитесь его загрузки на контроллер XIOT.
9. Нажмите Обновить список устройств и дождитесь свежих показаний.

Кнопка подстановки меняет только параметры выбранного подключения ZONT в черновике проекта. Остальные подключения и настройки брокера она не меняет. Если активного клиента нет, форма предлагает сначала настроить его в драйвере «MQTT брокер».

БРОКЕР ПОДКЛЮЧЕН означает, что XIOT подключился к брокеру. Для проверки самого ZONT дополнительно убедитесь, что появились его объекты и обновляются их показания.

Параметры драйвера ZONT: localhost 127.0.0.1, отдельный порт 11123, логин клиента, серийный номер и время ожидания. Пароль скрыт при подготовке иллюстрации.

Два настоящих датчика NTC в каталоге XIOT: свежие показания, адреса и доступ только для чтения.

5. Привязать объекты к устройствам XIOT

Драйвер показывает найденные объекты, их характеристики, единицы, адреса и доступ: Чтение, Команда или Чтение и управление. Эти адреса выбираются в обычных настройках характеристик XIOT.

Типичные адреса первого ZONT:

Значение	Пример адреса	Как использовать
Температура первого датчика	/zont1/sensor1/temperature	Статус текущей температуры
Доступность этого показания	/zont1/sensor1/temperature_available	Контроль связи и недоступности
Текущая температура контура	/zont1/climate1/temperature	Статус соответствующей температуры контура
Уставка контура	/zont1/climate1/target_temperature	Управление и статус заданной температуры
Состояние реле	/zont1/switch1/state	Управление и статус включения, если объект допускает запись
Положение регулятора	/zont1/valve1/position	Процентное значение; запись только при наличии команды
Нажатие кнопки	/zont1/button1/press	Команда кнопки

Номера в таблице — примеры. Выбирайте фактический адрес из своего каталога: он зависит от ранее обнаруженных объектов. У второго контроллера адреса начинаются с /zont2/, у десятого — с /zont10/.

Для датчика температуры привяжите показание к статусу Текущая температура. Датчики отображаются в предназначенном для них разделе, а на отдельной странице котельной — в верхнем компактном блоке температур. Подробности и график открываются нажатием на датчик.

Для управляемого реле привяжите адрес состояния к управлению и обратной связи характеристики включения. Для контура отдельно привяжите текущую температуру и уставку. Не назначайте адресу «только чтение» функцию управления.

Если регулирование выполняет ZONT, выключите «Собственная логика XIOT» у соответствующих устройств XIOT. Это особенно важно для насоса, сервопривода и крана: у существующих устройств собственная логика может быть включена. Используйте характеристики для отображения и явных команд ZONT, не создавая второго регулятора на том же выходе.

Текущая температура может означать воздух, теплоноситель или бак ГВС. Название, диапазон и привязку выбирайте по назначению конкретного контура ZONT.

После обнаружения устройств и настройки привязок ещё раз сохраните проект. Так присвоенные адреса сохранятся вместе с проектом и его резервной копией.

Температура NTC1 привязана к адресу состояния характеристики. Поле адреса управления оставлено пустым.

Пример комнаты с устройствами ZONT в основном интерфейсе XIOT. Показания датчиков открываются из компактного блока сверху.

Раздел датчиков комнаты: реальные NTC1 и NTC2 показаны отдельно от виртуальных учебных датчиков.

Какие типы поддерживаются

Автоматическое обнаружение распознаёт объявления типов sensor, binary_sensor, switch, button, climate и valve. Конкретные свойства и команды берутся из объявления ZONT, поэтому у двух внешне похожих объектов набор управления может отличаться.

Тип или назначение ZONT	Что получает XIOT	Управление и условия
Физический температурный датчик	Температуру и доступность	Только чтение. Запись в физический датчик не поддерживается.
Аналоговый датчик, в том числе давление или влажность	Числовое показание, если оно опубликовано	Единицу и масштаб проверяйте для конкретного подтипа. Название датчика само по себе не преобразует напряжение в давление.
Дискретный датчик	Двоичное состояние при соответствующем объявлении	Только чтение. Аналоговое показание и тревога — разные данные.
Радиодатчик	Температуру, влажность, заряд батареи и уровень сигнала при наличии соответствующей публикации	Только чтение. Набор полей зависит от датчика; радиоканал и дочерние устройства должны быть настроены в ZONT.
Виртуальный температурный или аналоговый вход	Показание	В обычной MQTT-привязке предусмотрена запись виртуального значения. Выбирайте этот тип только для действительно виртуального входа.
Реле, насос, переключатель	Состояние включения	Включение/выключение при наличии доступной команды. ZONT может ограничивать её своим режимом или логикой.
Контур отопления, комнатный контур, ГВС	Текущую и заданную температуру; дополнительные режимы/состояния при их объявлении	Изменение уставки и объявленных режимов. Не все внутренние параметры контура экспортируются.
Аналоговый регулятор	Число или процент, при обычной публикации также текстовую подпись	Управление процентом — при объявленном командном топике. Обычная публикация аналогового регулятора сама по себе доступна только для чтения.
Смеситель	Состояние движения	Состояние и команда представлены разными адресами. Направление движения не является процентом открытия.
Адаптер цифровой шины котла	Температуры подачи, обратки и ГВС, модуляцию, давление, состояние и код ошибки — при их публикации	Эти показатели доступны для чтения. Их наличие не означает управление всеми параметрами котла.
Простая/сложная кнопка, применение режима отопления	Команду, объявленную ZONT	Нажатие кнопки или применение режима. Результат проверяйте по фактическому состоянию/уставке управляемого объекта.
Действие/оповещение, охранная зона, сирена, индикатор	Предусмотрены соответствующие типы ручной MQTT-привязки	Команды зависят от конфигурации ZONT. Без опубликованной обратной связи их нельзя считать подтверждением исполнения.

В XIOT используются обычные устройства: датчики температуры/влажности/давления, реле и переключатели, насос, термостат, тепловой контур, котёл, сервопривод/регулятор и кнопка. Если подходящего поля в модели нет, добавьте кастомную характеристику нужного типа: число, дробное число, текст, процент, переключатель, список или кнопку. Для числовых полей можно задать подпись единицы измерения. Это оформление уже существующего показания, а не преобразование его масштаба.

Добавление карточки «Котёл», «Тепловой контур» или кастомного поля не создаёт в ZONT новых MQTT-данных. В каталоге драйвера сначала должен появиться соответствующий адрес.

Границы поддержки

Локальный обмен физическими NTC через отдельный порт 11123 проверен 11 октября 2026 года на H1000+ ПРО с прошивкой 602: авторизация, свежие показания, запись и возврат значения изолированного виртуального входа, потеря и восстановление связи с брокером, сохранение адресов XIOT. Контуры, уставки, кнопки, режимы и регуляторы дополнительно проверялись на изолированных объектах реального ZONT без подключения отопительных нагрузок. Эти проверки не заменяют наладку котельной и испытание подключённого котла, насоса или привода.

Радиодатчики, адаптер котла и модули расширения требуют проверки с конкретным оборудованием. Наличие MQTT в другой модели ZONT не гарантирует совпадения всех полей и команд.

Не заявляется редактирование из XIOT полной конфигурации ZONT: коэффициентов ПИД, кривой ПЗА, состава каскада, структуры внутренних сценариев, адресов шин и расписаний. По MQTT можно использовать опубликованные результаты и доступные команды, например применить заранее созданный режим через его кнопку.

Обычные публикации MQTT: ручное добавление

Этот способ нужен, если нужный объект передаёт обычный JSON, но не объявляется автоматически.

1. В драйвере ZONT MQTT раскройте Объекты с обычной публикацией MQTT.
2. Нажмите Добавить объект и выберите тип из списка.
3. Задайте имя для отображения.
4. Укажите полный Топик показаний из публикации ZONT.
5. Если требуется управление, укажите Топик управления из подписки ZONT и числовой ID объекта либо его точное имя.
6. Сохраните проект, дождитесь новых данных и проверьте появившиеся адреса.

Топик управления не следует угадывать по топику показаний. Для физического температурного датчика оставьте обычный тип «Датчик температуры»; наличие командного топика не делает его записываемым.

При одновременной обычной публикации и автоматическом объявлении один объект может иметь две записи в каталоге. Для привязки выбирайте осмысленно один источник, а не два управляющих адреса на одну характеристику.

Проверка после настройки

1. В драйвере XIOT появился статус БРОКЕР ПОДКЛЮЧЕН.
2. Найдены объекты именно нужного серийного номера ZONT.
3. Показания обновляются и совпадают с веб-интерфейсом ZONT с учётом периода публикации и округления.
4. В пользовательском интерфейсе отображаются нужные единицы и названия. Уставка и измерение не перепутаны.
5. На заранее подготовленном безопасном объекте команда приводит к изменению, которое подтверждается новым показанием ZONT. Успешная отправка команды сама по себе не доказывает её выполнение.
6. После восстановления соединения приходят свежие значения, а созданные привязки остаются на своих местах.

Проверку реле, насоса, клапана или нагрева выполняйте с учётом реально подключённых нагрузок. Для знакомства с интеграцией используйте отдельные виртуальные входы и учебные объекты без физических выходов.

Переход с другого брокера

Если ZONT уже связан с XIOT через брокер на порту 1883:

1. Сохраните актуальную конфигурацию обеих сторон и проекта.
2. Подготовьте клиента внешнего брокера XIOT на 11123.
3. В существующей линии ZONT MQTT подставьте параметры брокера XIOT. Не создавайте новую линию вместо прежней, не меняйте серийный номер и не удаляйте найденные объекты.
4. В ZONT замените адрес, порт и учётные данные MQTT-соединения. Сохраните прежние имена объектов, топики и состав публикаций.
5. Сохраните изменения обеих сторон, обновите каталог и проверьте показания.
6. Сверьте несколько действующих характеристик, затем сохраните проект с полученным каталогом.

Идентичность объекта определяется его идентификатором, а не порядком прихода сообщений. Переименование, переподключение и смена брокера сохраняют присвоенные адреса. Не удаляйте и не создавайте заново ручные записи ради смены соединения: новая запись имеет другую идентичность.

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

Если данные не появились

Симптом	Что проверить
Нет подключения к брокеру	Работает ли XIOT-PLC; активирован ли клиент в «MQTT брокер»; совпадают ли логин/пароль и порт 11123. Не использован ли системный порт 1887.
XIOT подключён, но список ZONT пуст	Подключился ли сам ZONT; его сервер должен быть LAN-адресом XIOT, а не 127.0.0.1. Проверьте серийный номер, префикс, выбор объектов и формат публикации. Нажмите «Обновить список устройств».
Только часть объектов видна	Включены ли они в публикацию; экспортирует ли прошивка данный тип; нужен ли ему режим обычной публикации и ручная привязка.
«Недоступен» или прочерк вместо значения	Приходят ли свежие сообщения; разрешён ли объекту опрос в ZONT; больше ли тайм-аут XIOT периода публикации. Недоступность не означает нулевую температуру.
Значение есть, команда не выполняется	Допускает ли адрес запись; задан ли правильный командный топик/ID; не блокирует ли действие логика, сервисный режим или условия работы ZONT. Проверьте фактическую обратную связь.
Неверная единица/масштаб	Что именно публикует выбранный подтип датчика. Подпись «бар» или «%» в кастомной характеристике не пересчитывает исходное число.
Удалённый в ZONT объект остался в каталоге	На прошивке 602 наблюдалось отсутствие объявления об удалении. Прекращение сообщений делает старое значение недоступным; оно не является подтверждением удаления объекта.

XIOT очищает доступность показаний при потере связи или по тайм-ауту. Старые измерения не восстанавливаются как свежие после запуска. Команды без связи не накапливаются для последующего неожиданного исполнения.

Документация производителя

• MQTT в контроллерах ZONT — официальная документация Micro Line.