https://wiki.xiot.ru/index.php?action=history&feed=atom&title=%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0_%D0%B0%D0%B3%D0%B5%D0%BD%D1%82%D0%B0_%D1%81_ZONTРабота агента с ZONT - История изменений2026-10-24T04:31:50ZИстория изменений этой страницы в викиMediaWiki 1.46.2https://wiki.xiot.ru/index.php?title=%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0_%D0%B0%D0%B3%D0%B5%D0%BD%D1%82%D0%B0_%D1%81_ZONT&diff=6047&oldid=prevAdmin: Инструкция для ИИ-агентов по работе с ZONT; без включения в меню и категории2026-10-13T10:36:20Z<p>Инструкция для ИИ-агентов по работе с ZONT; без включения в меню и категории</p>
<p><b>Новая страница</b></p><div>Инструкция для ИИ-агента, которому владелец поручил настроить контроллер '''ZONT''' или проверить его интеграцию с '''XIOT'''. Основной способ работы — штатный веб-интерфейс ZONT, автоматизация браузера и проверка существующего MQTT-обмена.<br />
<br />
Материал подготовлен '''13 октября 2026 года''' по опыту работы с H1000+ ПРО и драйвером ZONT MQTT. Перед выполнением задачи агент проверяет фактическую модель, прошивку и установленные версии XIOT. Инструкция не передаёт доступ к прибору и не заменяет поручение владельца.<br />
<br />
== Что подготовить ==<br />
<br />
* '''Конкретную задачу:''' какой прибор и проект XIOT используются, что требуется изменить и как проверить результат. Для управления оборудованием — назначение затрагиваемых входов, выходов и контуров.<br />
* '''Браузер с автоматизацией.''' Например, Chromium с Playwright позволяет читать элементы настоящей страницы, заполнять формы и нажимать штатные кнопки.<br />
* '''Собственный профиль браузера''' с обычным входом в кабинет ZONT. В новом окружении выполняется новый вход с доступом, предоставленным владельцем; сессии другого агента не копируются.<br />
* '''Доступ к локальной сети прибора''' для локальной диагностики. Для проверки интеграции — доступ к нужному проекту в XIOT-EDITOR.<br />
* '''Защищённое место для резервных копий.''' Экспорт конфигурации может содержать секреты. Его нельзя размещать в публичной статье, открытом отчёте или Git.<br />
<br />
Для этого процесса используются существующие кабинет и драйвер MQTT. Создавать отдельный API для агента не требуется. Облачный API-токен ZONT для MQTT-обмена с XIOT не нужен; вход в кабинет ZONT и авторизация MQTT — разные подключения.<br />
<br />
== Как выбрать способ работы ==<br />
<br />
{| class="wikitable"<br />
! Задача !! Способ<br />
|-<br />
| Добавить датчик, контур или элемент управления; настроить MQTT || Штатный конфигуратор в [https://my.zont.online/ кабинете ZONT].<br />
|-<br />
| Проверить сведения о приборе и текущие показания в локальной сети || Локальный веб-интерфейс по фактическому IP-адресу контроллера.<br />
|-<br />
| Проверить обмен показаниями и командами с XIOT || Настроенное MQTT-соединение и существующий драйвер '''ZONT MQTT'''.<br />
|-<br />
| Сопоставить показание с карточкой в XIOT-APP || Адрес объекта из каталога драйвера и соответствующая характеристика устройства XIOT.<br />
|}<br />
<br />
Возможности локального интерфейса ограничены, а его учётные данные могут отличаться от аккаунта кабинета. Следует использовать текущую форму входа конкретного прибора. Подробнее — [https://support.microline.ru/index.php/Локальное_управление_приборами_ZONT локальное управление приборами ZONT].<br />
<br />
В проверенном примере кабинет называл устройство '''H1000+ ПРО''', а локальный интерфейс — '''H1000 PRO, плата 722, прошивка 602'''. Поэтому прибор выбирают по серийному номеру и сверенным сведениям, а не только по похожему названию. Текущий IP-адрес проверяют перед подключением.<br />
<br />
== Порядок работы агента ==<br />
<br />
# '''Прочитать поручение и проверить доступность оборудования.''' Определить нужные прибор и проект, разрешённые действия и критерий результата. Для общего стенда согласовать время работы и исключить одновременное изменение той же конфигурации другим исполнителем. Уже согласованные действия повторно согласовывать не требуется.<br />
# '''Войти через собственный браузер.''' Открыть кабинет ZONT, выбрать нужный прибор и сверить его серийный номер. Код подтверждения запрашивать, когда соответствующая форма готова. Отказы авторизации не обходить.<br />
# '''Сохранить исходное состояние.''' Получить штатный экспорт конфигурации ZONT. Если задача затрагивает XIOT — сохранить актуальную сцену и конфигурацию проекта. Зафиксировать версии, ID нужных объектов и назначения физических входов и выходов.<br />
# '''Выполнить настройку через интерфейс.''' Дождаться загрузки и заполнения полей, прочитать существующие значения и изменить относящиеся к задаче параметры. Использовать имеющиеся объекты, характеристики и каналы обмена. Старую полную конфигурацию не загружать поверх новых изменений других участников.<br />
# '''Сохранить и перечитать результат.''' Проверить ответ интерфейса и заново прочитать состояние прибора. При необходимости сравнить новый экспорт с исходным. В XIOT отдельно проверить сохранение проекта и фактическую загрузку конфигурации в XIOT-PLC.<br />
# '''Проверить поведение.''' Для датчика сопоставить свежее показание в ZONT, MQTT и XIOT. Для разрешённой команды зафиксировать исходное состояние, отправить одну команду и дождаться нового состояния нужного объекта. Работу физического контакта подтвердить измерением или наблюдением подключённой нагрузки.<br />
# '''Завершить работу.''' Вернуть собственные временные тестовые значения, сохранить итоговые резервные копии, закрыть свои соединения и процессы, освободить занятые ресурсы. В отчёте разделить подтверждённый результат и то, что ещё не проверено.<br />
<br />
Нажатие '''«Сохранить»''', ответ HTTP 200 и успешная отправка MQTT сами по себе не доказывают выполнения команды. При неизвестном результате сначала перечитывают фактическое состояние, затем решают вопрос повторной отправки.<br />
<br />
Учебную проверку команд можно проводить на изолированных виртуальных объектах без физических назначений. Работа настоящего насоса, реле или котла должна входить в конкретное поручение и учитывать назначение оборудования.<br />
<br />
== Проверка интеграции с XIOT ==<br />
<br />
Подробная инструкция по параметрам подключения: [[Подключение ZONT к XIOT]]. Ниже — порядок действий именно для агента.<br />
<br />
Сначала следует проверить установленные версии '''XIOT-PLC''' и '''XIOT-EDITOR''', существующий режим подключения и актуальный каталог объектов. Рабочее MQTT-соединение не переключают только потому, что в инструкции приведён другой порт.<br />
<br />
# В драйвере '''ZONT MQTT''' выбрать нужное подключение '''ZONT 1'''…'''ZONT 10''' и сверить точный серийный номер.<br />
# Если установленная версия поддерживает '''«Прямо к XIOT»''' и этот режим входит в задачу, настроить общий порт ZONT, по умолчанию '''11124''', и его логин с паролем. Все прямые подключения используют общий порт, каталоги разделяются по серийным номерам. Поддержка нужна в обоих компонентах: PLC и редакторе.<br />
# Если используется режим '''«Через внешний MQTT-брокер»''', сохранить рабочие параметры до поручения о переходе. Порты <code>1883</code>, <code>11123</code> и <code>11124</code> не являются взаимозаменяемыми настройками одного подключения.<br />
# На стороне ZONT сверить адрес брокера, порт и авторизацию. Проверить, что нужные объекты включены в публикацию. Для автоматического обнаружения использовать формат '''Home Assistant''' и группировку по устройству; отдельный сервер Home Assistant для драйвера XIOT не нужен.<br />
# После разрешённых изменений сохранить настройки и выполнить в XIOT '''«Обновить список устройств»'''. Брать адрес характеристики из текущего каталога, не вычислять его по названию датчика или номеру физического реле.<br />
# Привязать адрес к существующей характеристике устройства XIOT. Для управления и обратной связи проверить оба назначения. Если стандартного поля нет, рассмотреть имеющийся механизм кастомных характеристик.<br />
# Сохранить проект после обнаружения и привязки, чтобы назначенные адреса вошли в проект и его резервную копию. Проверить загрузку на PLC, состояние связи и свежесть показаний в XIOT-APP.<br />
<br />
Примеры адресов: <code>/zont1/sensor1/temperature</code>, <code>/zont1/climate1/target_temperature</code>, <code>/zont1/switch1/state</code>. Адреса другого проекта следует получить из его каталога.<br />
<br />
Если регулирование выполняет ZONT, следует проверить настройку '''«Собственная логика XIOT»''' у связанного устройства XIOT: на одном физическом выходе не должно появиться второго независимого регулятора. Изменение этой настройки выполняют в пределах поручения по интеграции.<br />
<br />
На дату подготовки материала общий порт 11124 проверен изолированными испытаниями реализации. Аппаратная проверка MQTT 11 октября завершалась возвратом к прежнему соединению на 1883. Это различие необходимо учитывать: программный тест не доказывает, что новая схема уже установлена на конкретном приборе.<br />
<br />
Форматы публикаций и команд описаны в [https://support.microline.ru/index.php/Использование_протокола_MQTT_в_контроллерах_ZONT официальной документации MQTT ZONT]. Для обычного управления через XIOT используются характеристики и драйвер; вручную составлять команды для отопительных выходов не требуется.<br />
<br />
== Наблюдения на прошивке 602 ==<br />
<br />
Следующие особенности зафиксированы в конкретных испытаниях H1000+ ПРО. Для другой модели или прошивки их проверяют заново.<br />
<br />
* Объявления и состояния не поступали новому подписчику как сохранённые '''retained-сообщения'''. Для начала проверки требовались запрос объявлений и свежие показания.<br />
* В испытании использовались публикация раз в '''10 секунд''' и ожидание показаний '''60 секунд'''. Ожидание должно быть больше периода публикации.<br />
* После удаления объекта не поступило сообщение удаления. Отсутствие объекта в очередном неполном наборе сообщений не доказывает его удаление; старый адрес может остаться недоступным.<br />
* В одном аппаратном испытании сохранение нового адреса MQTT не переключило открытое соединение до штатной перезагрузки ZONT. Сначала следует проверить фактическое соединение. Перезагрузку проводят только в рамках поручения, с учётом работы отопления.<br />
* Статус отправки команды проверяют отдельно от её исполнения: требуется новое показание объекта, а для испытания оборудования — физическая обратная связь.<br />
<br />
== Готовое первое поручение агенту ==<br />
<br />
<blockquote><br />
Подключись к указанному ZONT через собственный браузер и штатный кабинет. Сначала выполни только диагностику: проверь модель, серийный номер, прошивку, текущую конфигурацию и связь. Сохрани защищённую резервную копию. Если проверяется интеграция XIOT, прочитай фактическую версию драйвера, режим MQTT и каталог объектов; сопоставь свежие показания двух датчиков в ZONT и XIOT. Настройки, реальные выходы и прошивку в этой диагностике не меняй. В ответе дай таблицу «объект — ID — значение — время — адрес XIOT», найденные расхождения и конкретные следующие действия. Секреты и полный конфиг в отчёт не включай.<br />
</blockquote><br />
<br />
К поручению нужно добавить сведения о целевом приборе и проекте. Доступ передаётся отдельно через принятый защищённый способ.<br />
<br />
Примеры следующих задач после диагностики:<br />
<br />
* «Добавь подключённые NTC10 на NTC1 и NTC2; проверь показания и привязку температур к XIOT. Назначение отопительных выходов сохранить».<br />
* «Создай виртуальный датчик и учебное реле без физических назначений; проверь сценарий на значениях 24, 26 и 25 °C, затем верни исходное состояние».<br />
* «Проверь, почему команда уставки не подтверждается: проследи характеристику XIOT, отправку драйвера и новое состояние ZONT. Повторно команду без проверки результата не отправляй».<br />
<br />
== Что включить в результат ==<br />
<br />
{| class="wikitable"<br />
! Поле !! Содержание<br />
|-<br />
| Цель || Модель и идентификатор прибора, версия прошивки, проект XIOT — в отчёте владельцу.<br />
|-<br />
| Изменение || Что было и что стало; ID затронутых объектов.<br />
|-<br />
| Подтверждение || Источник нового состояния, время и наблюдаемое значение.<br />
|-<br />
| Результат || Проверено; выполнено, но не подтверждено; не проверялось.<br />
|-<br />
| Завершение || Итоговое состояние, сохранённые копии, закрытые соединения и освобождённые ресурсы.<br />
|}<br />
<br />
В публичный материал не включают пароли, коды входа, cookies, токены, полные конфигурации и идентификаторы чужого оборудования. Доступ к кабинетам и приборам агент получает отдельно от этой инструкции.</div>Admin