Last modified by superadmin on 2026/06/24 21:41

Show last authors
1 Настройка плагина осуществляется в разделе [[Конфигурация узлов>>doc:ui.Параметры узла.WebHome]] > [[doc:ui.Параметры узла.Плагины.WebHome]] веб-интерфейса узла, через который осуществлялось физическое подключение «сторонней» системы: контроллера БОРЕЙ при интеграции по Modbus RTU, или Платформы НЕЙРОСС при интеграции по Modbus TCP.
2
3 Установка плагина
4
5 Модуль Modbus-интеграции в виде [[плагина>>doc:ui.Параметры узла.Плагины.WebHome]] — независимого программного модуля, предназначенного для расширения функционала. Установка плагина является стандартной процедурой и не зависит от предоставляемых функций. Перечень разработанных плагинов и порядок их установки приведён в разделе ~[[[doc:ui.Параметры узла.Плагины.WebHome]]].
6
7 {{info}}
8 Право использования функции мониторинга состояний и управление Modbus-элементами по количеству профилей систем указывается в параметрах лицензии. Дополнительная активация не требуется.
9 {{/info}}
10
11 Порядок настройки
12
13 Выполните подключение к [[веб-интерфейсу>>doc:ui.Рабочий стол НЕЙРОСС.WebHome]] узла НЕЙРОСС, через который осуществлялась интеграция. В разделе [[Конфигурация узлов>>doc:ui.Параметры узла.WebHome]] > [[doc:ui.Параметры узла.Плагины.WebHome]] найдите в списке установленных плагинов требуемый и нажмите на кнопку  **Настроить**.
14
15 [[image:attach:PluginModbus5.png||height="170"]]\\
16
17 Откроется окно конфигурирования плагина. Загрузите профиль интеграции. Для этого укажите путь к файлу профиля в формате **LUA**. Дождитесь окончания процедуры импорта. Откроется редактор плагина.
18
19 [[image:attach:PluginModbus6_new.png]]\\
20
21 **Редактор плагина**
22
23 [[image:attach:s_PluginModbus_redactor.png||width="900"]]
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}}
119 Благодаря встроенному редактору Lua-скриптов с подсветкой, проверкой синтаксиса и инструкциями по отладке, вы легко сможете отредактировать скрипт: изменить метки типов элементов, формулировки состояний и команд управления, а также заголовки событий для вывода в АРМ НЕЙРОСС Центр.
120
121 Вы также можете скачать профиль интеграции, отредактировать его в любом удобном вам редакторе и загрузить отредактированный файл. Для выгрузки профиля используйте ссылку скачать.
122 {{/info}}
123
124 Для изменения формулировок достаточно отредактировать текст.
125
126 Пример событий, отображаемых в ленте событий, и меток состояний элементов:
127
128 {{code language="java"}}
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
155 {{code language="java"}}
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
186 {{code language="java"}}
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. При этом пользовательские имена, заданные ранее не сбрасываются.