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

Навигация

RS-485:Configuration via Web Interface: различия между версиями

м (→‎Порт: Уточнил)
(не показано 50 промежуточных версий 3 участников)
Строка 1: Строка 1:
{{DISPLAYTITLE:Начальное конфигурирование устройств через веб-интерфейс}}
{{DISPLAYTITLE:Начальное конфигурирование устройств через веб-интерфейс}}
Информацию о том, как проложить шину RS-485 и подключить к ней устройства, читайте на странице [[RS-485|RS-485]].
Информацию о том, как проложить шину RS-485 и подключить к ней устройства, читайте на странице [[RS-485|RS-485]].
== Как зайти в веб-интерфейс ==
{{Wbincludes:How to enter}}


== Настройка порта ==  
== Смена уровня доступа к веб-интерфейсу ==
{{Wbincludes:WebUI Change Access Level}}
 
== Поиск устройств Wiren Board на шине RS-485 ==
[[Image: Scan-screen.png |300px|thumb|right| Сканирование устройств ]]
В разделе '''Настройки''' → '''Сканирование''' можно получить список всех устройств Wiren Board подключенных к шине RS-485 с их серийными номерами, настройками соединения и версиями прошивок.
 
Возможности функции сканирования:
* отображение всех устройств Wiren Board, подключенных к контроллеру,
* обнаружение устройств с одинаковыми адресами на одной шине,
* обнаружение устройств с разными параметрами связи на одной шине.
 
Благодаря функции сканирования можно собирать шкаф управления не обращая внимания на адреса устройств — все адреса и параметры можно будет получить после сборки и сконфигурировать устройства не отключая от шины.
 
== Настройка порта ==
=== Последовательный порт ===
Последовательный порт служит для подключения Modbus-устройств к контроллеру через шину [[RS-485]].
Откройте веб-интерфейс и перейдите в раздел '''Settings''' → '''Configs''' → '''Serial Device Driver Configuration'''.
Откройте веб-интерфейс и перейдите в раздел '''Settings''' → '''Configs''' → '''Serial Device Driver Configuration'''.


Строка 34: Строка 53:
После указания настроек подключения можете продолжить редактирование других параметров или нажмите кнопку '''Save''' вверху страницы для сохранения изменений.
После указания настроек подключения можете продолжить редактирование других параметров или нажмите кнопку '''Save''' вверху страницы для сохранения изменений.


<gallery mode="packed" heights="300px">
<gallery widths=400px heights=240px perrow=2>
Image: webui2. Settings → Configs.png | Выберите ''Serial Device Driver Configuration''
Image: webui2. Settings → Configs.png | Выберите ''Serial Device Driver Configuration''
Image: webui2. Settings → Configs → Serial Device Driver Configuration.png | Выберите нужный serial-порт, включите его и укажите настройки подключения: ''Baud rate'', ''Parity'', ''Data bits'', ''Stop bits''
Image: webui2. Settings → Configs → Serial Device Driver Configuration.png | Выберите нужный serial-порт, включите его и укажите настройки подключения: ''Baud rate'', ''Parity'', ''Data bits'', ''Stop bits''
</gallery>
=== TCP-порт ===
TCP-порт служит для подключения устройств по протоколам ''TCP port (Serial over TCP)'' или ''MODBUS TCP Port'', например, WB-MGE или WB-MIO-E.
Чтобы добавить новый TCP-порт:
# Перейдите в раздел '''Settings''' → '''Configs''' → '''Serial Device Driver Configuration'''.
# Нажмите кнопку '''+Port'''.
# В зависимости от протокола, укажите тип порта '''TCP port (Serial over TCP)''' или '''MODBUS TCP Port'''.
# В поле IPv4 введите IP-адрес сервера.
# В поле '''TCP port number''', введите номер TCP-порта сервера.
# Нажмите слева вверху кнопку '''Save'''.
<gallery mode="packed" widths=200px heights=200px perrow=2>
Image: webui2. Settings → Configs.png | Выберите ''Serial Device Driver Configuration''
Image: Wiren Board WebUI configs modbus-tcp-port.png | Добавьте новый порт, выберите один из типов:  ''TCP port (Serial over TCP)'' или ''MODBUS TCP Port'', укажите IP-адрес и TCP-порт сервера
</gallery>
</gallery>


Строка 45: Строка 80:
Для всех устройств Wiren Board и некоторых устройств сторонних производителей, в поставке ПО контроллера Wiren Board есть шаблоны, которые облегчают настройку устройства. Список поддерживаемых сторонних устройств можно посмотреть в таблице [[Поддерживаемые_устройства#Протестированные устройства сторонних производителей | Протестированные устройства сторонних производителей]], если у устройства есть шаблон, то он будет указан в колонке «Драйвер / название шаблона».
Для всех устройств Wiren Board и некоторых устройств сторонних производителей, в поставке ПО контроллера Wiren Board есть шаблоны, которые облегчают настройку устройства. Список поддерживаемых сторонних устройств можно посмотреть в таблице [[Поддерживаемые_устройства#Протестированные устройства сторонних производителей | Протестированные устройства сторонних производителей]], если у устройства есть шаблон, то он будет указан в колонке «Драйвер / название шаблона».


Modbus-адрес (Slave id) устройств Wiren Board устанавливается с завода и указан в наклейке на корпусе устройства. Если адрес был изменен и вы его не знаете — его можно [[Определение и изменение Modbus-адреса устройств Wirenboard | определить или назначить новый]].
Modbus-адрес (Slave id) устройств Wiren Board устанавливается с завода и указан в наклейке на корпусе устройства. Также адреса устройств можно узнать если выполнить сканирование шины в веб-интерфейсе контроллера в разделе '''Settings → Scan'''. Там же можно получить список всех устройств Wiren Board, подключенных к шине RS-485 с их серийными номерами, настройками соединения и версиями прошивок. Если адреса дублируются их нужно [[Определение и изменение Modbus-адреса устройств Wirenboard |изменить]].


=== Устройство с шаблоном ===
=== Устройство с шаблоном ===
Строка 54: Строка 89:


=== Устройство без шаблона ===
=== Устройство без шаблона ===
 
{{Anchor|without-template}}
Если шаблона вашего устройства нет в списке, вы можете добавить устройство вручную или [[Wb-mqtt-serial templates | составить свой шаблон]] и загрузить его на контроллер.
Если шаблона вашего устройства нет в списке, вы можете добавить устройство вручную или [[Connecting_Third_Party_Devices_to_Wiren_Board | составить свой шаблон]] и загрузить его на контроллер.


Чтобы подключить устройство без шаблона:
Чтобы подключить устройство без шаблона:
Строка 68: Строка 103:
# Сохраните изменения в настройках — нажмите кнопку '''Save''' в верхней части окна.
# Сохраните изменения в настройках — нажмите кнопку '''Save''' в верхней части окна.


<gallery mode="packed" heights="300px">
<gallery mode="packed" widths=200px heights=200px perrow=2>
Image: webui2. Serial Device Driver Configuration. Add new device.png | Нажмите кнопку ''+Device'', чтобы добавить новое serial-устройство</code>
Image: webui2. Serial Device Driver Configuration. Add new device.png | Нажмите кнопку ''+Device'', чтобы добавить новое serial-устройство</code>
Image: webui2. Serial Device Driver Configuration. WB-MSW3.png | Веб-интерфейс: основные настройки датчика [[WB-MSW v.3]]
Image: webui2. Serial Device Driver Configuration. WB-MSW3.png | Веб-интерфейс: основные настройки датчика [[WB-MSW v.3]]
Строка 76: Строка 111:
Проверить работу [[#Добавление устройств | добавленного в веб-интерфейс]] устройства можно на вкладке '''Devices''', после [[#Добавление устройств | добавления устройства в веб-интерфейс]] на ней появится блок с этим устройством. Если вашего устройства там нет — проверьте [[#Настройка порта | параметры подключения]] и адрес самого устройства.
Проверить работу [[#Добавление устройств | добавленного в веб-интерфейс]] устройства можно на вкладке '''Devices''', после [[#Добавление устройств | добавления устройства в веб-интерфейс]] на ней появится блок с этим устройством. Если вашего устройства там нет — проверьте [[#Настройка порта | параметры подключения]] и адрес самого устройства.


<gallery mode="packed" heights="300px">
<gallery mode="packed" widths=200px heights=200px perrow=2>
Image: webui2. Serial Device Driver Configuration. Save config.png | Перед переходом на вкладку ''Devices'' не забудьте сохранить настройки
Image: webui2. Serial Device Driver Configuration. Save config.png | Перед переходом на вкладку ''Devices'' не забудьте сохранить настройки
Image: webui2. Devices WB-MSW3.png | Датчик [[WB-MSW v.3]] в веб-интерфейсе на вкладке ''Devices''
Image: webui2. Devices WB-MSW3.png | Датчик [[WB-MSW v.3]] в веб-интерфейсе на вкладке ''Devices''
</gallery>
== Отключение каналов, смена режимов и настройка параметров ==
{{Anchor|poll-settings}}
В веб-интерфейсе вы можете:
* Отключать опрос тех каналов устройства, которые вы не используете — это снизит нагрузку на шину [[RS-485]].
* Выбирать режимы работы входов или выходов.
* Настраивать дополнительные параметры устройства, например, частоту PWM в диммерах.
<gallery widths=180px heights=150px perrow=4 caption="Настройки модуля WB-MRGBW-D в веб-интерфейсе контроллера Wiren Board">
Image: WB-MRGBW-D Webui configs Inputs.png | Настройка входов
Image: WB-MRGBW-D Webui configs Channels rgb+w.png | Настройка выходов
Image: WB-MRGBW-D Webui configs Channels Independent.png | Настройка скорости обмена
Image: WB-MRGBW-D Webui configs HW Info.png | Информация об устройстве
</gallery>
</gallery>


Строка 84: Строка 133:
Дополнительные параметры устройства передаются устройству при перезапуске [[Wb-mqtt-serial driver | wb-mqtt-serial]] или при восстановлении связи с устройством.
Дополнительные параметры устройства передаются устройству при перезапуске [[Wb-mqtt-serial driver | wb-mqtt-serial]] или при восстановлении связи с устройством.


=== Параметры, указанные в шаблоне (setup-секция) ===
=== Параметры, указанные в шаблоне (parameters-секция) ===
Если в шаблоне заполнена setup-секция, то при выборе шаблона в настройках устройства появится раздел '''Device options''', который будет содержать указанные в [[Wb-mqtt-serial templates#Секция инициализации (setup-секция) | шаблоне параметры]].
Если в шаблоне заполнена parameters-секция, то при выборе шаблона, в настройках устройства появится раздел '''Device options''', который будет содержать указанные в [[Wb-mqtt-serial templates#Секция параметров (parameters-секция) | шаблоне параметры]].


После сохранения настроек параметры будут записаны в устройство.
По умолчанию все параметры отключены и для передачи на устройство их нужно включить. Чтобы включить параметр, установите флажок напротив названия.


<gallery mode="packed" heights="300px">
После сохранения настроек включенные параметры будут записаны в устройство.
Image: webui2. WB-MR14 Device Options in template (setup-section).png | Параметры инициализации устройства (setup-секция) в файле шаблона  
 
Image: webui2. WB-MR14 Device Options.png | Параметры инициализации устройства (setup-секция) в веб-интерфейсе
<gallery mode="packed" widths=200px heights=200px perrow=2>
Image: webui2. WB-MR14 Device Options in template (parameters-section).png | Параметры инициализации устройства (parameters-секция) в файле шаблона  
Image: webui2. WB-MR14 Device Options.png | Параметры инициализации устройства (parameters-секция) в веб-интерфейсе
</gallery>
</gallery>


Строка 106: Строка 157:
После внесения изменений сохраните настройки.
После внесения изменений сохраните настройки.


<gallery mode="packed" heights="300px">
<gallery mode="packed" widths=200px heights=200px perrow=2>
Image: webui2. Device Custom setup commands.png | Включение отображения пользовательских команд инициализации
Image: webui2. Device Custom setup commands.png | Включение отображения пользовательских команд инициализации
Image: webui2. WB-MR14 No contacts.png | Создание пользовательской команды инициализации реле [[WB-MR14 Modbus 14 Channel Relay Module | WB-MR14]]
Image: webui2. WB-MR14 No contacts.png | Создание пользовательской команды инициализации реле [[WB-MR14 Modbus 14 Channel Relay Module | WB-MR14]]
</gallery>
== Вложенные устройства ==
Некоторое оборудование на каждом канале имеет вложенные устройства, например, [[MAI11| WB-MAI11]]. Для того чтобы в веб-интерфейсе отобразились вложенные устройства, они должны быть [[Wb-mqtt-serial templates#Вложенные устройства (subdevices) | описаны в шаблоне]].
Вложенные устройства отображаются в разделе ''Channels'', но в отличие от каналов, могут содержать свои setup-секцию и каналы.
<gallery mode="packed" heights="300px">
Image: Config, Device, Nested devices in channels. Template.png | Вложенные устройства в шаблоне
Image: webui2. Config, Device, Nested devices in channels.png | Вложенные устройства в веб-интерфейсе
</gallery>
</gallery>


== Настройка периода опроса ==
== Настройка периода опроса ==
Общий для всех устройств период опроса задается параметром ''Desired poll interval'' в настройках порта. Вы можете переопределить период опроса для порта, каждого устройства или канала. Например, вы можете изменить период опроса входов реле, что сократит время срабатывания.
{{note|warn| В свежих версиях прошивок некоторые регистры поддерживают события, которые являются частью расширения [[Modbus#%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D0%B5%20%D0%BF%D1%80%D0%BE%D1%82%D0%BE%D0%BA%D0%BE%D0%BB%D0%B0%20Modbus%20%D0%BE%D1%82%20Wiren%20Board | Быстрый Modbus]]&#9889;. События опрашиваются широковещательными командами, поэтому для каналов поддерживающих события период опроса задать нельзя, а соответсвующее поле в веб-интерфейсе служит для изменения приоритета опроса событий.}}
 
{{Anchor|poll-period}}
=== Порт ===
Вы можете задать желаемый период опроса и драйвер будет стараться его выдержать, а если заданный период выдержать не получится — он сообщит об этом в карточке устройства.  
Если интервал опроса не задан явно, то он равен 20 мс для всех устройств, подключенных к порту.


Вы можете задать свой период опроса устройств, для этого нужно включить отображение поля ''Desired poll interval'' и указать значение:
Точная настройка периода опроса может быть полезна, если какие-то каналы нужно опрашивать часто. Значения, которые можно указать, зависят от количества каналов, которые надо опрашивать быстро, обычно это: от 200 до 500 мс на канал. Не рекомендуем использовать эту настройку для замедления опроса каналов, например, установки значений в десятки секунд — это может сильно замедлить работу драйвера, так как он не сможет оптимизировать запросы по своему усмотрению.
# Нажмите на кнопку '''Properties''' в описании serial-порта.
# Отметьте флажок '''Desired poll interval'''. В описании порта появится одноименное поле.
# Введите в поле '''Desired poll interval''' значение в миллисекундах.


После сохранения настроек устройства, подключенные к этому порту будут опрашиваться с заданным интервалом.
Чтобы указать период опроса, перейдите в веб-интерфейсе в настройки драйвера serial-устройств и укажите желаемое значение для любого канала.
 
<gallery mode="packed" heights="300px">
Image: webui2. Config, Port, Desired poll interval visible.png | Включение отображения опции ''Desired poll interval''
Image: webui2. Config, Port, Desired poll interval.png| Настройка периода опроса serial-порта <code>/dev/ttyRS485-1</code>
</gallery>


=== Устройство ===
Рекомендации:
При необходимости, вы можете переопределить период опроса устройства, установленный в параметрах serial-порта. Для этого нужно включить отображение поля ''Desired poll interval'' и указать нужное значение:
* Поднимите скорость шины до 115 200 бит/с, [[UART_Communication_Settings#Изменение скорости обмена|инструкция]].
# Нажмите на кнопку '''Properties''' в описании устройства.
* Для ускорения опроса рекомендуем устанавливать период не меньше 100–300 мс и не более, чем для 10-15 каналов на порт. Здесь нужно учитывать, что драйвер оптимизирует запросы, например, состояние всех шести входов одного реле он может считать за один раз, а значит максимальное количество каналов нужно подбирать опытным путём и оно может быть сильно больше 15 штук.
# Отметьте флажок '''Desired poll interval'''. В описании устройства появится одноименное поле.
* Проверьте, чтобы в записях драйвера wb-mqtt-serial в [[Wiren_Board_Web_Interface#logs | системном журнале]] не было ошибок, предупреждений и информации о недоступных устройствах. Если вы физически отключили какое-то устройство, то выключите его опрос в настройках драйвера.
# Введите в поле '''Desired poll interval''' значение в миллисекундах.
* Если вы столкнулись с тем, что желаемый период выдержать не получается — увеличьте период опроса или пересмотрите количество каналов.


После сохранения настроек устройство будет опрашиваться с заданным интервалом. Значение по умолчанию — 20 мс.
Для каналов управления менять период опроса имеет смысл только, если вам нужно быстро получить их состояние. Команду управления в устройство драйвер отправляет вне очереди, при первой возможности.


<gallery mode="packed" heights="300px">
<gallery mode="packed" heights="260px" caption="Настройка периода опроса">
Image: webui2. Device Desired pool interval.png | Включение отображения опции ''Desired poll interval''
Image: Poll Period wb-mqtt-serial in Settings.png | Выбор периода для опроса канала
Image: webui2. WB-MR14 Desired pool interval.png | Настройка периода опроса реле [[WB-MR14 Modbus 14 Channel Relay Module | WB-MR14]]
Image: Poll Period wb-mqtt-serial in Devices.png | Предупреждение о том, что период опроса канала ''Input 1'' выдержать не получается
</gallery>
</gallery>


=== Канал ===
== Полезные ссылки ==
Помимо периода опроса устройства целиком, можно задать индивидуальный период опроса каждого канала в отдельности, для этого в описании каждого канала есть поле ''Poll interval'':
* [[Wb-mqtt-serial driver| Описание драйвера wb-mqtt-serial в нашей вики]]
# Перейдите в описание устройства и разверните группу '''Channels'''.
* [[Wb-mqtt-serial templates| Описание шаблонов и примеры]]
# Найдите поле '''Poll interval''' и введите значение в миллисекундах для каждого канала.
 
После сохранения настроек канал будет опрашиваться с заданным интервалом. Значение по умолчанию — 20 мс.
 
<gallery mode="packed" heights="300px">
Image: webui2. Config, Device, Channels collapsed.png | Разверните список каналов
Image: webui2. Config, Device, Channels.png | Для каждого канала укажите нужное значение в поле ''Poll interval''
</gallery>