Это старая версия документа.
Содержание
Общая конфигурация плагинов и модулей
Плагины и модули
Для удобства расширения функциональности используются система подключаемых плагинов.
Плагин - это подключаемый jar-файл, хранящийся по умолчанию в jar/plugin
. При запуске jar/core/jroboplc.jar
выполняется проверка доступных к использованию плагинов, загрузка плагинов и создание модулей.
Модуль - это основной программный компонент, из которых состоит работающее приложение. Модули создаются на стадии загрузки программы, объединяются в задачи и, после старта системы, выполняют определенную им работу.
Конфигурационные файлы
Конфигурация проекта может состоять из одного и более yml-файлов, которые хранятся в каталоге проекта. Данный каталог указывается параметром -cfg
при запуске приложения. При загрузке сканируется весь каталог (без вложенных каталогов), и загружаются все найденные yml-файлы (кроме скрытых, начинающихся с точки).
Конфигурация записывается в YAML-формате.
https://www.youtube.com/watch?v=AXLoRpKnK8U
Общий формат конфигурационного файла:
param1: value param2: value plugin.pluginA: enable: on module.moduleA1 modprm1: value modprm2: value module.moduleA2 modprm1: value modprm2: value plugin.pluginB: enable: off module.moduleB1 modprm1: value tag.values: tagname: value regex: value tag.flags: tagname1: none tagname2: autosave regex: autosave hidden
Общие настройки для плагинов
plugin.name | название плагина (Правила именования модулей) |
enable | разрешение работы плагина |
off - плагин отключен и не загружается при старте приложения | |
on - плагин включен |
Общие настройки для модулей
module.name | название модуля |
enable | разрешение работы модуля |
off - модуль загружается при старте приложения, но не выполняется в runtime | |
on - модуль выполняется в runtime | |
tag.values | переопределение значений тегов, где tagname имя тега модуля, либо regex-выражение |
tag.flags | переопределение флагов тегов, где tagname имя тега модуля, либо regex-выражение. Флаги указываются через пробел или запятую: |
none | |
autosave - значение тега сохраняется (необходимо использовать модуль tagsaver | |
hidden - тег не предназначен для показа удаленным клиентам | |
external - тег содержит значение, запрошенное с удаленного сервера | |
status - тег может изменять свой статус GOOD /BAD |
Настройка логирования
В файле conf.yml
указывается путь (относительно каталога конфигурации) до каталога с лог-файлами.
log.dir: log