Wiki source code of Настройка плагина Modbus-интеграции
Last modified by superadmin on 2026/06/24 21:41
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
| |
4.1 | 1 | Настройка плагина осуществляется в разделе [[Конфигурация узлов>>doc:ui.Параметры узла.WebHome]] > [[doc:ui.Параметры узла.Плагины.WebHome]] веб-интерфейса узла, через который осуществлялось физическое подключение «сторонней» системы: контроллера БОРЕЙ при интеграции по Modbus RTU, или Платформы НЕЙРОСС при интеграции по Modbus TCP. |
| |
1.1 | 2 | |
| |
4.1 | 3 | Установка плагина |
| |
1.1 | 4 | |
| |
4.1 | 5 | Модуль Modbus-интеграции в виде [[плагина>>doc:ui.Параметры узла.Плагины.WebHome]] — независимого программного модуля, предназначенного для расширения функционала. Установка плагина является стандартной процедурой и не зависит от предоставляемых функций. Перечень разработанных плагинов и порядок их установки приведён в разделе ~[[[doc:ui.Параметры узла.Плагины.WebHome]]]. |
| |
1.1 | 6 | |
| 7 | {{info}} | ||
| 8 | Право использования функции мониторинга состояний и управление Modbus-элементами по количеству профилей систем указывается в параметрах лицензии. Дополнительная активация не требуется. | ||
| 9 | {{/info}} | ||
| 10 | |||
| |
4.1 | 11 | Порядок настройки |
| |
1.1 | 12 | |
| |
4.1 | 13 | Выполните подключение к [[веб-интерфейсу>>doc:ui.Рабочий стол НЕЙРОСС.WebHome]] узла НЕЙРОСС, через который осуществлялась интеграция. В разделе [[Конфигурация узлов>>doc:ui.Параметры узла.WebHome]] > [[doc:ui.Параметры узла.Плагины.WebHome]] найдите в списке установленных плагинов требуемый и нажмите на кнопку **Настроить**. |
| |
1.1 | 14 | |
| |
4.1 | 15 | [[image:attach:PluginModbus5.png||height="170"]]\\ |
| |
1.1 | 16 | |
| |
4.1 | 17 | Откроется окно конфигурирования плагина. Загрузите профиль интеграции. Для этого укажите путь к файлу профиля в формате **LUA**. Дождитесь окончания процедуры импорта. Откроется редактор плагина. |
| |
1.1 | 18 | |
| |
4.1 | 19 | [[image:attach:PluginModbus6_new.png]]\\ |
| |
1.1 | 20 | |
| |
4.1 | 21 | **Редактор плагина** |
| |
1.1 | 22 | |
| |
4.1 | 23 | [[image:attach:s_PluginModbus_redactor.png||width="900"]] |
| |
1.1 | 24 | |
| 25 | 1. ((( | ||
| 26 | Вкладки редактора | ||
| 27 | |||
| 28 | |=((( | ||
| 29 | Вкладка | ||
| 30 | )))|=((( | ||
| 31 | Комментарий | ||
| 32 | ))) | ||
| 33 | |((( | ||
| 34 | Профили системы | ||
| 35 | )))|((( | ||
| 36 | В заголовке вкладки указано количество загруженных профилей и общее количество профилей, доступных по лицензии. Например, (2/5) означает, что загружено два профиля, свободно ещё три лицензии. | ||
| 37 | ))) | ||
| 38 | |((( | ||
| 39 | Элементы | ||
| 40 | )))|((( | ||
| 41 | Вкладка содержит дерево элементов, вычитанных профилями. Вы можете задать пользовательские имена ~[[[#Изменение имён элементов>>doc:||anchor="НастройкаплагинаModbus-интеграции-Изменениеимёнэлементов"]]]. | ||
| 42 | ))) | ||
| 43 | ))) | ||
| 44 | 1. ((( | ||
| 45 | Перечень загруженных профилей. Содержит инструменты управления профилями. | ||
| 46 | |||
| 47 | |=((( | ||
| 48 | Команда | ||
| 49 | )))|=((( | ||
| 50 | Комментарий | ||
| 51 | ))) | ||
| 52 | |((( | ||
| 53 | ((( | ||
| 54 | Удалить профиль | ||
| 55 | ))) | ||
| 56 | )))|((( | ||
| 57 | ((( | ||
| 58 | Для удаления профиля нажмите на кнопку [[image:attach:btn_del_new.png||thumbnail="true" height="15"]] в заголовке вкладки и подтвердите удаление | ||
| 59 | ))) | ||
| 60 | ))) | ||
| 61 | |((( | ||
| 62 | Добавить профиль | ||
| 63 | )))|((( | ||
| 64 | ((( | ||
| 65 | Для добавления профиля нажмите на кнопку [[image:attach:ui.Параметры узла.WebHome@fa-plus.png||thumbnail="true" height="19"]] в заголовке новой вкладки и укажите путь к файлу профиля. | ||
| 66 | ))) | ||
| 67 | ))) | ||
| 68 | ))) | ||
| 69 | 1. ((( | ||
| 70 | Скачать или обновить файл профиля. | ||
| 71 | |||
| 72 | |=((( | ||
| 73 | Команда | ||
| 74 | )))|=((( | ||
| 75 | Комментарий | ||
| 76 | ))) | ||
| 77 | |((( | ||
| 78 | ((( | ||
| 79 | Скачать профиль | ||
| 80 | ))) | ||
| 81 | )))|((( | ||
| 82 | ((( | ||
| 83 | Нажмите скачать, чтобы загрузить файл профиля в папку загрузок браузера. Вы можете отредактировать профиль и затем повторно загрузить его или воспользоваться встроенным редактором [5]. | ||
| 84 | ))) | ||
| 85 | ))) | ||
| 86 | |((( | ||
| 87 | Обновить профиль | ||
| 88 | )))|((( | ||
| 89 | ((( | ||
| 90 | Нажмите на кнопку **Выберите файл** и укажите путь к файлу профиля. Нажмите на кнопку **Импортировать**. | ||
| 91 | ))) | ||
| 92 | ))) | ||
| 93 | ))) | ||
| 94 | 1. ((( | ||
| 95 | **Переменные профиля**: если переменные в профиле оформлены специальным образом, доступен режим редактирования переменных из формы. При этом вам не потребуется просматривать код профиля и искать строчку объявления переменных. Оформление переменных в коде профиля: | ||
| 96 | |||
| 97 | (% class="wrapped" style="text-align: left;" %) | ||
| 98 | (% style="text-align: left;" %)|(% style="text-align: left;" %)((( | ||
| 99 | (% style="text-align: left;" %) | ||
| 100 | (% class="java comments" style="text-align: left;" %){{code language="none"}}// @parameter { "type": "тип поля", "title": "заголовок поля", "key": "имя переменной" }{{/code}} | ||
| 101 | ))) | ||
| 102 | |||
| 103 | Где: | ||
| 104 | |||
| 105 | * type — тип поля, возможные значения: "boolean", "string", "number", "select"; | ||
| 106 | * title — заголовок поля в форме — произвольный текст; | ||
| 107 | * key — имя переменной. | ||
| 108 | \\ | ||
| 109 | ))) | ||
| 110 | 1. **Исходный код профиля**. Путём редактирования исходного кода профиля вам доступны не только базовые переменные профиля, но также возможность изменения формулировок команд и меток элементов. | ||
| 111 | |||
| 112 | Задайте параметры плагина, при необходимости, откорректируйте профиль ~[[[#Корректировка профиля интеграции>>doc:||anchor="НастройкаплагинаModbus-интеграции-Корректировкапрофиляинтеграции"]]]. | ||
| 113 | |||
| 114 | При необходимости, откорректируйте названия элементов ~[[[#Изменение имён элементов>>doc:||anchor="НастройкаплагинаModbus-интеграции-Изменениеимёнэлементов"]]]. | ||
| 115 | |||
| 116 | == {{id name="НастройкаплагинаModbus-интеграции-Корректировкапрофиляинтеграции"/}}Корректировка профиля интеграции == | ||
| 117 | |||
| 118 | {{info}} | ||
| |
4.1 | 119 | Благодаря встроенному редактору Lua-скриптов с подсветкой, проверкой синтаксиса и инструкциями по отладке, вы легко сможете отредактировать скрипт: изменить метки типов элементов, формулировки состояний и команд управления, а также заголовки событий для вывода в АРМ НЕЙРОСС Центр. |
| |
1.1 | 120 | |
| |
4.1 | 121 | Вы также можете скачать профиль интеграции, отредактировать его в любом удобном вам редакторе и загрузить отредактированный файл. Для выгрузки профиля используйте ссылку скачать. |
| |
1.1 | 122 | {{/info}} |
| 123 | |||
| 124 | Для изменения формулировок достаточно отредактировать текст. | ||
| 125 | |||
| 126 | Пример событий, отображаемых в ленте событий, и меток состояний элементов: | ||
| 127 | |||
| |
2.1 | 128 | {{code language="java"}} |
| |
1.1 | 129 | ['Alarm,FireWarning'] = { |
| 130 | headline ="Предварительная тревога «Внимание»", | ||
| 131 | min = 4 | ||
| 132 | }, | ||
| 133 | Alarm = { | ||
| 134 | headline ="Тревога", | ||
| 135 | min = 5 | ||
| 136 | }, | ||
| 137 | Fault = { | ||
| 138 | headline ="Неисправность", | ||
| 139 | min = 6 | ||
| 140 | }, | ||
| 141 | Armed = { | ||
| 142 | headline = "На охране", | ||
| 143 | eventTags = "BurglarAlarm", | ||
| 144 | min = 11 | ||
| 145 | }, | ||
| 146 | ['Fire,Alarm'] = { | ||
| 147 | headline ="Пожар", | ||
| 148 | eventTags = "FireAlarm", | ||
| 149 | min = 20 | ||
| 150 | }, | ||
| 151 | {{/code}} | ||
| 152 | |||
| 153 | Пример списка команд: | ||
| 154 | |||
| |
2.1 | 155 | {{code language="java"}} |
| |
1.1 | 156 | action_tco_alarm = { |
| 157 | commands = { | ||
| 158 | ['На охрану'] = "0x101", | ||
| 159 | ['Снять'] = "0x102", | ||
| 160 | ['Сбросить охранный ШС'] = "0x103", | ||
| 161 | ['Обход'] = "0x104" | ||
| 162 | } | ||
| 163 | }, | ||
| 164 | action_tco_fire = { | ||
| 165 | commands = { | ||
| 166 | ['Сбросить пожарный ШС'] = "0x301" | ||
| 167 | } | ||
| 168 | }, | ||
| 169 | action_aspt = { | ||
| 170 | commands = { | ||
| 171 | ['Включить автоматику АСПТ'] = "0x901", | ||
| 172 | ['Отключить автоматику АСПТ'] = "0x902", | ||
| 173 | ['Пуск АСПТ'] = "0x904", | ||
| 174 | ['Отмена пуска АСПТ'] = "0x906", | ||
| 175 | ['Сбросить АСПТ'] = "0x907" | ||
| 176 | } | ||
| 177 | }, | ||
| 178 | {{/code}} | ||
| 179 | |||
| 180 | Пример списка меток типов и состояний элементов для кастомизации внешнего вида иконок и геометрических фигур в АРМ НЕЙРОСС Центр ~[[[doc:ui.Параметры узла.Элементы.WebHome]]]. | ||
| 181 | |||
| 182 | {{error}} | ||
| 183 | Для кастомизации отображения в АРМ НЕЙРОСС Центр используйте английское написание меток! Русское название дано для информации. | ||
| 184 | {{/error}} | ||
| 185 | |||
| |
2.1 | 186 | {{code language="java"}} |
| |
1.1 | 187 | R08_Devices = "Папка ТСО", |
| 188 | R08_Device = "ТСО", | ||
| 189 | R08_Zones = "Папка зон", | ||
| 190 | R08_Zone = "ЗонаР08", | ||
| 191 | Normal = "Норма", | ||
| 192 | FireAlarmNormal = "Норма пож.ШС", | ||
| 193 | Alarm = "Тревога", | ||
| 194 | BurglarAlarm = "ТревогаОТС", | ||
| 195 | Fault = "Неисправность", | ||
| 196 | AsptFault = "НеисправностьАСПТ", | ||
| 197 | BurglarFault = "НеисправностьОТС", | ||
| 198 | FireFault = "НеисправностьПС", | ||
| 199 | EdFault = "НеисправностьИУ", | ||
| 200 | ModbusError = "Ошибка", | ||
| 201 | Fire = "Пожар", | ||
| 202 | AsptFire = "ПожарАСПТ", | ||
| 203 | Armed = "НаОхране", | ||
| 204 | Disarmed = "БезОхраны", | ||
| 205 | NotReadyToArm = "Невзятие", | ||
| 206 | On = "Включено", | ||
| 207 | Off = "Выключено", | ||
| 208 | FireWarning = "Пожарное «Внимание»", | ||
| 209 | FireReady = "Готов пож.ШС", | ||
| 210 | {{/code}} | ||
| 211 | |||
| 212 | == {{id name="НастройкаплагинаModbus-интеграции-Изменениеимёнэлементов"/}}Изменение имён элементов == | ||
| 213 | |||
| 214 | Протокол Modbus не поддерживает передачу имён элементов, а только числовых данных как значений регистров, поэтому при вычитывании списка элементов их имена задаются автоматически на основе номеров разделов/зон/датчиков. В целях удобства использования мы предусмотрели механизм изменения заданных по умолчанию имён. | ||
| 215 | |||
| 216 | [[image:attach:ModbusElements.png]] | ||
| 217 | |||
| 218 | Чтобы задать пользовательское название: | ||
| 219 | |||
| 220 | 1. В окне плагина перейдите к вкладке **Элементы**. | ||
| 221 | 1. В дереве элементов слева выберите требуемый элемент и откорректируйте его наименование. Для этого в поле **Название** введите новое название и нажмите на кнопку **Сохранить**. | ||
| 222 | |||
| 223 | {{info}} | ||
| 224 | Заданное в плагине пользовательское имя элемента сохраняется и не меняется при обновлении списка элементов ~[[[#Поиск элементов>>doc:||anchor="НастройкаплагинаModbus-интеграции-Поискэлементов"]]]. Это же имя вычитывается в Платформу НЕЙРОСС и используется для наименования элементов как источников событий. Если имя было изменено впоследствии, необходимо перевычитать конфигурацию ~[[[Сеть ~> Выгрузка конфигурации узлов>>doc:ui.Сеть.WebHome||anchor="Сеть-Выгрузкаконфигурацииузлов"]]]. | ||
| 225 | {{/info}} | ||
| 226 | |||
| 227 | Чтобы **сбросить** название элемента к дефолтному (заданному профилем интеграции автоматически): | ||
| 228 | |||
| 229 | Нажмите на кнопку **Сбросить к стандартному названию.** | ||
| 230 | |||
| 231 | [[image:attach:ModbusElements1.png||width="550"]] | ||
| 232 | |||
| 233 | {{info}} | ||
| 234 | Метки состояния отражают состояние выбранного элемента на момент загрузки окна **Элементы**. | ||
| 235 | {{/info}} | ||
| 236 | |||
| 237 | == {{id name="НастройкаплагинаModbus-интеграции-Поискэлементов"/}}Поиск элементов == | ||
| 238 | |||
| 239 | Поиск элементов может осуществляться как по стандартному, так и по пользовательскому имени. Для этого в окне поиска достаточно ввести значащую часть названия. | ||
| 240 | |||
| 241 | Кнопка **Обновить список элементов** запускает процедуру вычитывания элементов из сети Modbus. При этом пользовательские имена, заданные ранее не сбрасываются. |