Перейти к содержанию

Работа с шаблонами

Modbus FS - Работа с шаблонами

Редактирование, добавление, удаление и обновление Modbus шаблонов внутри контроллера Lavritech

Работа с файлами шаблонов

Существует возможность просмотра и редактирования шаблонов для Modbus устройств в веб-интерфейсе контроллера Lavritech. Ниже показано как получить доступ к файлам шаблонов в контроллере.

Переходим по ссылке [ip]/configeasyfs (вместо [ip] указываем ip-адрес контроллера) и попадаем в файловый менеджер:

Список файлов включает в себя:

  • файл modbus.list содержит редактируемый список шаблонов. Он определяет содержимое выпадающего списка в опции "ModBus".

  • файлы с расширением .mb - шаблоны устройств.

Напротив каждого файла есть две кнопки:

  • Edit - редактировать файл
  • Delete - удалить файл

Новые файлы шаблонов подгружаются с сервера по мере необходимости, когда шаблон становится активным.
Для этого на странице опции "ModВus" выбираем нужный шаблон, ставим галочку "Enable device", и нажимаем "SET".
Также можно обновить все активные шаблоны, запустив обновление шаблонов с сервера.

Редактирование списка шаблонов

Путём редактирования файла modbus.list можно создать свой уникальный список для выбора только нужных шаблонов.

Для начала редактирования нажмите "Edit" напротив файла modbus.list. На странице, в редакторе откроется файл со списком шаблонов со следующим содержанием (пример):

Сверху отображается имя файла - Filename: modbus.list
В каждой строке указывается имя шаблона, а также версия шаблона после точки с запятой:

  • имя шаблона должно совпадать с именем файла (без расширения .md)
  • версия шаблона в списке должна совпадать со значением поля ver в секции main в файле шаблона

После редактирования файла - нажмите "SET", чтобы сохранить изменения.
Таким образом, в контроллере будет сохранён изменённый список шаблонов.

Чтобы изменения в списке применились, необходимо нажать "Reload devices list" на странице опции "ModBus".

🔔 Внимание! При обновлении шаблонов с сервера по кнопке "Update devices list" также затрутся изменения и в файле modbus.list, поэтому нужно внимательно делать операции обновления. Желательно сохранять копии всех внесённых изменений локально, тогда всегда можно будет восстановить старые настройки. Подробнее см. раздел "Обновление шаблонов с сервера"

Редактирование шаблона

Рассмотрим пример редактирования шаблона для датчика WB-MSW.

  • открываем список шаблонов по ссылке [ip]/configeasyfs.
  • нажимаем Edit напротив нужного файла шаблона:

  • откроется окно редактирования шаблона.
    Теперь текст шаблона доступен для редактирования.
    Сверху отображается имя файла шаблона.

  • для сохранения внесённых изменений нажимаем кнопку "SET"
  • чтобы изменения применились, необходимо нажать "Reload devices list" на странице опции "ModBus"

Полный текст шаблона для датчика WB-MSW представлен в каталоге шаблонов.

Шаблоны составляются по определённым правилам. Они подробно рассмотрены в разделе "Структура шаблонов".

Отредактированные шаблоны сохраняются локально в файловой системе контроллера. Таким образом можно вносить свои изменения в базовые шаблоны, а также создавать свои собственные шаблоны.

Добавление нового шаблона

Для создания нового шаблона перейдите на страницу файлового менеджера [ip]/configeasyfs и нажимте на кнопку Add_file (она располагается внизу после списка шаблонов).

При нажатии на неё откроется пустое окно редактора:

  • в поле Filename указываем новое имя файла шаблона (*.md)
  • в основном поле ввода помещаем текст шаблона

Для сохранения изменений внизу под полем ввода нажимаем кнопку "SET".
При этом локально, на контроллере будет создан новый файл.

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

Обновление шаблонов с сервера

🔔 Будьте внимательны! Если Вы вносили локальные изменения в файлах, то перед обновлением желательно сохранить на ПК копии всех внесённых изменений. Нужно сохранить содержимое файла modbus.list и изменённых файлов шаблонов. Тогда всегда можно будет восстановить старые шаблоны и список.

Обновление происходит следующим образом:

  1. С сервера подгружается стандартный список шаблонов с новыми версиями шаблонов. Локальный файл modbus.list будет заменён!
  2. Программа контроллера анализирует все используемые шаблоны. Если в контроллере будет найден устаревший шаблон (версия в файле ниже, чем версия в новом списке modbus.list), то с сервера будет загружена новая версия шаблона. При этом локальный файл шаблона будет заменён!
Пример

Допустим на контроллере присутствует шаблон, у которого в секции [main] указана ver=1, а на сервере есть новый шаблон с ver=2.
После обновления файл modbus.list будет содержать строчку с новой версией: WB-MSW;2.
Также произойдёт обновление файла WB-MSW.md c сервера.
После обновления можно проконтролировать версию в тексте шаблона в секции [main], её значение будет: ver=2

Для обновления шаблонов с сервера нужно использовать кнопку Update devices list на странице опции "ModBus".