Version 4.1 by admin on 2026/06/07 17:49

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