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

Материал из Wiren Board
(не показаны 132 промежуточные версии 7 участников)
Строка 1: Строка 1:
Общую информацию по подключению устройств RS-485 к контроллеру смотрите на странице [[RS-485]].
{{DISPLAYTITLE:Начальное конфигурирование устройств через веб-интерфейс}}
#Зайдите на страницу ''Configs'' [[Веб-интерфейс Wiren Board|веб-интерфейса]], щёлкните по пункту ''/etc/wb-mqtt-serial.conf'' (''serial'' - название последовательных портов, RS-485 относится к ним). [[File:rs-485-setup-configs.png|thumb|center|500 px]]
Информацию о том, как проложить шину RS-485 и подключить к ней устройства, читайте на странице [[RS-485|RS-485]].
#Откроется страница настройки последовательных портов. В левой части выберите порт, к которому вы подключили устройство. Порты названы по терминологии Linux - ''/dev/ttyXXXN''; чтобы понять, как называется используемый вами, смотрите [[RS-485#Реализация портов в разных версиях Wiren Board]]. [[File:rs-485-setup-select-port.png|center|500 px|На скриншоте выбран порт Wiren Board 5, подписанный на корпусе как ''RS-485'']]
== Как зайти в веб-интерфейс ==
#Установите настройки порта: скорость (бит/с), количество бит в пакете, есть ли бит чётности, количество стоп-битов - эта информация указана в документации к периферийному оборудованию. Затем обязательно поставьте галочку ''Enable port'' - ''Включить порт'' (с помощью этой настройки порт можно отключить, если какое-нибудь оборудование на нём начнёт сбоить).<br>'''N.B.''' Если вы подключаете несколько устройств к одному порту контроллера, эти настройки у них должны совпадать. [[File:rs-485-setup-port-settings.png|thumb|center|500 px|Установлены настройки для релейного [[WB-MRM2]]]]
{{Wbincludes:How to enter}}
#Перейдите к разделу ''List of devices'' - ''Список устройств'' ниже. Нажмите кнопку ''+ Serial Device'', чтобы добавить устройство. Выберите тип устройства (обычно соответствует модели устройства) и укажите его адрес (обычно указывается  документации к устройству, для устройств нашего производства указан на корпусе на наклейке — в десятичном формате) [[Файл:modbus_address_mr14.png|150px|thumb|left|Modbus-адрес, установленный на производстве]] Адрес устройства указывается либо в шестнадцатеричном виде (начинается с ''0x..''), либо в десятичном (как обычное число). Затем обязательно нажмите синюю кнопку ''Save'' - ''Сохранить'' вверху страницы. [[File:rs-485-setup-device-settings.png|thumb|center|500 px|Выбран тип устройства [[WB-MRM2]] и установлен десятичный адрес ''130'']]
 
#Чтобы проверить работу устройства, перейдите на страницу ''Devices''. На ней должен появиться блок, соответствующий подключённому устройству. В нашем примере, появился блок ''WB-MRM2 130'' (шаблон названия - ''ТИП_УСТРОЙСТВА АДРЕС'') с двумя кнопками для управления реле, двумя индикаторами входов для кнопок и счётчиками нажатий. Можно нажать на кнопку - реле на подключённом устройстве переключится. [[File:rs-485-setup-device-connected.png|thumb|center|500 px|Отображение подключённого устройства [[WB-MRM2]] с адресом ''130'' на странице ''Devices''. Можно нажимать кнопки и управлять реле на устройстве]]
== Смена уровня доступа к веб-интерфейсу ==
#Чтобы добавить кнопку управления на главную страницу ''Home'' и назвать её соответственно назначению (например, ''Свет в коридоре''), нужно создать виджет (''Widget''). Для этого нужно перейти на страницу ''Widgets'' и нажать зелёную кнопку ''Add widget''. Затем нужно ввести параметры виджета: имя (так он называться в интерфейсе), комнату (группу, к которой привязан виджет; используется для упорядочивания, когда виджетов много - если мало, можно выбрать любую), и тип виджета - в нашем случае реле управляет освещением, поэтому выбираем ''Light Control Relay''. После этого появляется ещё одна опция - нужно выбрать, какому именно устройству соответствует виджет. Все доступные устройства выбранного типа показываются в списке, их имена даны в соответствии с терминологией [[MQTT]]. В завершении нажимаем кнопку ''Submit'' - новый виджет появится на странице ''Widgets''. [[File:rs-485-setup-add-widget.png|thumb|center|500 px|Создание виджета для управления светом на основе Реле 1 подключённого устройства [[WB-MRM2]]]]
{{Wbincludes:WebUI Change Access Level}}
#Настройка дополнительных параметров устройства осуществляется через кнопку ''Properties''. В выпадающем меню можно вывести дополнительные поля конфигурации устройства.
 
[[File:Web-Interface-Device-Props.png|thumb|center|700 px| Настрорйка отображения дополнительных параметров]]
== Поиск устройств Wiren Board на шине RS-485 ==
Для инициализации определенных регистров устройства перед началом работы используется setup-секция (List of setup commands). В качестве примера запишем значение 0 в holding-регистр релейного модуля WB-MR14, чтобы задать режим управления кнопкой без фиксации для всех входов модуля. Щелкаем на кнопке ''Properties'' и устанавливаем флажок ''List of setup commands''. Ещё раз щелкаем на кнопке ''Properties'', чтобы скрыть выпадающий список.
[[Image: Scan-screen.png |300px|thumb|right| Сканирование устройств ]]
[[Файл:Setup-section.png|800px|thumb|center|Добавляем раздел setup-секции устройства]]
В разделе '''Настройки''' → '''Сканирование''' можно получить список всех устройств Wiren Board подключенных к шине RS-485 с их серийными номерами, настройками соединения и версиями прошивок.  
У устройства появится раздел '''List of setup commands'''. Нажимаем на кнопку '''+Setup command''' и перейдем к созданию setup-команды. Setup-инициализация выполнятся однократно после загрузки драйвера.
 
#Драйвер ([[https://github.com/contactless/wb-homa-drivers/tree/master/wb-mqtt-serial wb-mqtt-serial]]) позволяет определять, с какой скоростью будут опрашиваться те или иные каналы устройства. Данный параметр называется Desired poll interval и задается в миллисекундах. Общий для всех интервал опроса задается параметром Desired poll interval в конфигурации порта. Если этот параметр не будет переопределен в других устройствах или других каналов, то для каждого канала будет использоваться именно это значение. Если скорость опроса задана для какого-то конкретного устройства, то для всех каналов этого устройства будет использоваться именно она, опять-таки, если для какого-то канала не задан свой интервал опроса. Приоритет интервалов выглядит таким образом: канал-> устройство -> порт. Например, если у нас есть несколько входов релейного модуля, критичных ко времени срабатывания, для них мы можем задать минимальный интервал в 1 мс.
Возможности функции сканирования:
По умолчанию в web-интерфейсе отсутствует поле для изменения этого свойства -- его надо добавить. Сначала указываем канал, свойство которого мы хотим переопределить, для чего щелкаем по кнопке '''+Item'''. Имя контрола и его адрес можно узнать в файле шаблона устройства
* отображение всех устройств Wiren Board, подключенных к контроллеру,
[[Файл:Channel_name_address.png|400px|thumb|left|Фрагмент описания канала устройства из файла шаблона из директории /usr/share/wb-mqtt-serial/templates]]
* обнаружение устройств с одинаковыми адресами на одной шине,
В поле Control name мы подставляем значение переменной "name", Address -- "address". Соответственно заполняем поля Control type и Register type.
* обнаружение устройств с разными параметрами связи на одной шине.
[[Файл:Channel_props_poll.png|400px|thumb|center|Добавляем свойство интервала опроса для канала устройства]]
 
щелкаем на кнопке Properties соответствующего канала и ставим флажок в поле Desired poll interval (ms), как показано на рисунке.
Благодаря функции сканирования можно собирать шкаф управления не обращая внимания на адреса устройств — все адреса и параметры можно будет получить после сборки и сконфигурировать устройства не отключая от шины.
В результате получаем следующий набор полей:
 
[[Файл:Channel_settings.png|600px|thumb|center|Набор полей, определяющих свойства конкретного канала. Поле Desired poll interval (ms) определяет интервал между двумя опросами параметра]]
== Настройка порта ==
Для сохранения нажимаем кнопку Save в верхней части страницы. Для проверки можно задать очень большой интервал опросаи убедиться, что реакция на замыкание соответствующего внешнего входа замедлилась.
=== Последовательный порт ===
[[Файл:Setup_commands_list.png|600px|thumb|center|Добавляем раздел setup-секции устройства]],
Последовательный порт служит для подключения Modbus-устройств к контроллеру через шину [[RS-485]].
Мы должны указать название команды, номер Modbus-регистра и инициирующее значение. Нажмем кнопку Save и убедимся, что модуль работает в режиме управления кнопочными выключателями.
Откройте веб-интерфейс и перейдите в раздел '''Settings''' → '''Configs''' → '''Serial Device Driver Configuration'''.
 
В левой части выберите порт, к которому вы подключили устройство. Для настройки порта нужно установить галочку '''Enable port''' и указать параметры подключения:
{|class="wikitable" style="text-align:left"
! Параметр, EN
! Параметр, RU
! Значение по умолчанию
|-
| Baud rate
| Скорость
| 9600
|-
| Parity
| Четность
| N
|-
| Data bits
| Биты данных
| 8
|-
| Stop bits
| Количество стоп-бит
| 2
|}
 
Значение параметров можно взять из документации на оборудование. В колонке «По умолчанию» указаны заводские параметры для подключения к оборудованию Wiren Board.
 
К одному порту можно подключить несколько устройств, но в этом случае параметры подключения на всех устройствах должны совпадать.
 
После указания настроек подключения можете продолжить редактирование других параметров или нажмите кнопку '''Save''' вверху страницы для сохранения изменений.
 
<gallery widths=400px heights=240px perrow=2>
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''
</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>
 
== Добавление устройств ==
 
Чтобы добавить устройство в веб-интерфейс, перейдите в [[#Настройка порта | настройках порта]] в раздел '''Devices attached to the port''' и нажмите кнопку '''+Device'''.
 
Для всех устройств Wiren Board и некоторых устройств сторонних производителей, в поставке ПО контроллера Wiren Board есть шаблоны, которые облегчают настройку устройства. Список поддерживаемых сторонних устройств можно посмотреть в таблице [[Поддерживаемые_устройства#Протестированные устройства сторонних производителей | Протестированные устройства сторонних производителей]], если у устройства есть шаблон, то он будет указан в колонке «Драйвер / название шаблона».
 
Modbus-адрес (Slave id) устройств Wiren Board устанавливается с завода и указан в наклейке на корпусе устройства. Также адреса устройств можно узнать если выполнить сканирование шины в веб-интерфейсе контроллера в разделе '''Settings → Scan'''. Там же можно получить список всех устройств Wiren Board, подключенных к шине RS-485 с их серийными номерами, настройками соединения и версиями прошивок. Если адреса дублируются их нужно [[Определение и изменение Modbus-адреса устройств Wirenboard |изменить]].
 
=== Устройство с шаблоном ===
Если у подключаемого устройства есть шаблон, то это облегчает настройку:
# В поле Device N, где N — порядковый номер устройства в списке, выберите в выпадающем списке шаблон устройства.  
# Укажите его адрес в поле '''Slave id'''.
# Сохраните изменения в настройках — нажмите кнопку '''Save''' в верхней части окна.
 
=== Устройство без шаблона ===
{{Anchor|without-template}}
Если шаблона вашего устройства нет в списке, вы можете добавить устройство вручную или [[Connecting_Third_Party_Devices_to_Wiren_Board | составить свой шаблон]] и загрузить его на контроллер.
 
Чтобы подключить устройство без шаблона:
# Выберите шаблон <code>Custom device</code>.
# Укажите его адрес в поле '''Slave id'''.
# Опишите каналы устройства:
#* Нажмите кнопку '''Properties'''.
#* Установите флажок '''Custom channels'''.
#* В описании устройства появится раздел ''Custom channels''.
#* Теперь нужно добавить пользовательский канал, для этого в разделе '''Custom channels''' нажмите на кнопку '''+Channel'''.
#* Введите имя контрола в веб-интерфейсе и другие параметры канала.
# Сохраните изменения в настройках — нажмите кнопку '''Save''' в верхней части окна.
 
<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. WB-MSW3.png | Веб-интерфейс: основные настройки датчика [[WB-MSW v.3]]
</gallery>
 
== Проверка работы ==
Проверить работу [[#Добавление устройств | добавленного в веб-интерфейс]] устройства можно на вкладке '''Devices''', после [[#Добавление устройств | добавления устройства в веб-интерфейс]] на ней появится блок с этим устройством. Если вашего устройства там нет — проверьте [[#Настройка порта | параметры подключения]] и адрес самого устройства.
 
<gallery mode="packed" widths=200px heights=200px perrow=2>
Image: webui2. Serial Device Driver Configuration. Save config.png | Перед переходом на вкладку ''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>
 
== Дополнительные параметры устройства ==
Дополнительные параметры устройства передаются устройству при перезапуске [[Wb-mqtt-serial driver | wb-mqtt-serial]] или при восстановлении связи с устройством.
 
=== Параметры, указанные в шаблоне (parameters-секция) ===
Если в шаблоне заполнена parameters-секция, то при выборе шаблона, в настройках устройства появится раздел '''Device options''', который будет содержать указанные в [[Wb-mqtt-serial templates#Секция параметров (parameters-секция) | шаблоне параметры]].
 
По умолчанию все параметры отключены и для передачи на устройство их нужно включить. Чтобы включить параметр, установите флажок напротив названия.
 
После сохранения настроек включенные параметры будут записаны в устройство.
 
<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>
 
=== Пользовательские параметры ===
Если у устройства нет шаблона или в шаблоне не указаны нужные вам настройки инициализации, то вы можете добавить пользовательские параметры прямо из веб-интерфейса:
# Нажмите в описании устройства кнопку '''Properties'''.
# Поставьте флажок '''Custom setup commands'''. После этого появится раздел ''Custom setup commands''.
# В разделе '''Custom setup commands''' нажмите кнопку '''+Setup command'''.
# Заполните поля:
#* Command name — имя команды. Используется для записи в журналы и отладки.
#* Address — адрес регистра, куда записывать значение.
#* Value — значение, которое нужно записать для инициализации устройства.
 
После внесения изменений сохраните настройки.
 
<gallery mode="packed" widths=200px heights=200px perrow=2>
Image: webui2. Device Custom setup commands.png | Включение отображения пользовательских команд инициализации
Image: webui2. WB-MR14 No contacts.png | Создание пользовательской команды инициализации реле [[WB-MR14 Modbus 14 Channel Relay Module | WB-MR14]]
</gallery>
 
== Настройка периода опроса ==
{{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}}
Вы можете задать желаемый период опроса и драйвер будет стараться его выдержать, а если заданный период выдержать не получится — он сообщит об этом в карточке устройства.
 
Точная настройка периода опроса может быть полезна, если какие-то каналы нужно опрашивать часто. Значения, которые можно указать, зависят от количества каналов, которые надо опрашивать быстро, обычно это: от 200 до 500 мс на канал. Не рекомендуем использовать эту настройку для замедления опроса каналов, например, установки значений в десятки секунд — это может сильно замедлить работу драйвера, так как он не сможет оптимизировать запросы по своему усмотрению.
 
Чтобы указать период опроса, перейдите в веб-интерфейсе в настройки драйвера serial-устройств и укажите желаемое значение для любого канала.
 
Рекомендации:
* Поднимите скорость шины до 115 200 бит/с, [[UART_Communication_Settings#Изменение скорости обмена|инструкция]].
* Для ускорения опроса рекомендуем устанавливать период не меньше 100–300 мс и не более, чем для 10-15 каналов на порт. Здесь нужно учитывать, что драйвер оптимизирует запросы, например, состояние всех шести входов одного реле он может считать за один раз, а значит максимальное количество каналов нужно подбирать опытным путём и оно может быть сильно больше 15 штук.
* Проверьте, чтобы в записях драйвера wb-mqtt-serial в [[Wiren_Board_Web_Interface#logs | системном журнале]] не было ошибок, предупреждений и информации о недоступных устройствах. Если вы физически отключили какое-то устройство, то выключите его опрос в настройках драйвера.
* Если вы столкнулись с тем, что желаемый период выдержать не получается — увеличьте период опроса или пересмотрите количество каналов.
 
Для каналов управления менять период опроса имеет смысл только, если вам нужно быстро получить их состояние. Команду управления в устройство драйвер отправляет вне очереди, при первой возможности.
 
<gallery mode="packed" heights="260px" caption="Настройка периода опроса">
Image: Poll Period wb-mqtt-serial in Settings.png | Выбор периода для опроса канала
Image: Poll Period wb-mqtt-serial in Devices.png | Предупреждение о том, что период опроса канала ''Input 1'' выдержать не получается
</gallery>
 
== Полезные ссылки ==
* [[Wb-mqtt-serial driver| Описание драйвера wb-mqtt-serial в нашей вики]]
* [[Wb-mqtt-serial templates| Описание шаблонов и примеры]]

Версия 11:46, 12 февраля 2024

Информацию о том, как проложить шину RS-485 и подключить к ней устройства, читайте на странице RS-485.

Как зайти в веб-интерфейс

Чтобы зайти в веб-интерфейс контроллера Wiren Board, подключитесь к контроллеру через Wi-Fi или Ethernet и введите в адресную строку браузера IP-адрес контроллера.

Если вы находитесь в одной сети с контроллером и используете компьютер с Linux, Windows 10 и выше или macOS, или любое устройство Apple, то можно использовать mDNS. Вместо IP-адреса введите в адресную строку http://wirenboard-XXXXXXXX.local, где ХХХХХХХХ — серийный номер контроллера.

Смена уровня доступа к веб-интерфейсу

Уровень «Администратор»

Для изменения настроек контроллера вам нужен уровень доступа Администратор, который можно выставить в разделе Настройки → Права доступа.

После завершения настроек рекомендуем поставить уровень доступа Пользователь или Оператор — это поможет не совершить случайных ошибок при ежедневной работе с веб-интерфейсом.

Поиск устройств Wiren Board на шине RS-485

Сканирование устройств

В разделе Настройки → Сканирование можно получить список всех устройств Wiren Board подключенных к шине RS-485 с их серийными номерами, настройками соединения и версиями прошивок.

Возможности функции сканирования:

  • отображение всех устройств Wiren Board, подключенных к контроллеру,
  • обнаружение устройств с одинаковыми адресами на одной шине,
  • обнаружение устройств с разными параметрами связи на одной шине.

Благодаря функции сканирования можно собирать шкаф управления не обращая внимания на адреса устройств — все адреса и параметры можно будет получить после сборки и сконфигурировать устройства не отключая от шины.

Настройка порта

Последовательный порт

Последовательный порт служит для подключения Modbus-устройств к контроллеру через шину RS-485.

Откройте веб-интерфейс и перейдите в раздел Settings → Configs → Serial Device Driver Configuration.

В левой части выберите порт, к которому вы подключили устройство. Для настройки порта нужно установить галочку Enable port и указать параметры подключения:

Параметр, EN Параметр, RU Значение по умолчанию
Baud rate Скорость 9600
Parity Четность N
Data bits Биты данных 8
Stop bits Количество стоп-бит 2

Значение параметров можно взять из документации на оборудование. В колонке «По умолчанию» указаны заводские параметры для подключения к оборудованию Wiren Board.

К одному порту можно подключить несколько устройств, но в этом случае параметры подключения на всех устройствах должны совпадать.

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

  • Выберите Serial Device Driver Configuration

  • Выберите нужный serial-порт, включите его и укажите настройки подключения: Baud rate, Parity, Data bits, Stop bits

TCP-порт

TCP-порт служит для подключения устройств по протоколам TCP port (Serial over TCP) или MODBUS TCP Port, например, WB-MGE или WB-MIO-E.

Чтобы добавить новый TCP-порт:

  1. Перейдите в раздел Settings → Configs → Serial Device Driver Configuration.
  2. Нажмите кнопку +Port.
  3. В зависимости от протокола, укажите тип порта TCP port (Serial over TCP) или MODBUS TCP Port.
  4. В поле IPv4 введите IP-адрес сервера.
  5. В поле TCP port number, введите номер TCP-порта сервера.
  6. Нажмите слева вверху кнопку Save.

  • Выберите Serial Device Driver Configuration

  • Добавьте новый порт, выберите один из типов: TCP port (Serial over TCP) или MODBUS TCP Port, укажите IP-адрес и TCP-порт сервера

Добавление устройств

Чтобы добавить устройство в веб-интерфейс, перейдите в настройках порта в раздел Devices attached to the port и нажмите кнопку +Device.

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

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

Устройство с шаблоном

Если у подключаемого устройства есть шаблон, то это облегчает настройку:

  1. В поле Device N, где N — порядковый номер устройства в списке, выберите в выпадающем списке шаблон устройства.
  2. Укажите его адрес в поле Slave id.
  3. Сохраните изменения в настройках — нажмите кнопку Save в верхней части окна.

Устройство без шаблона

Если шаблона вашего устройства нет в списке, вы можете добавить устройство вручную или составить свой шаблон и загрузить его на контроллер.

Чтобы подключить устройство без шаблона:

  1. Выберите шаблон Custom device.
  2. Укажите его адрес в поле Slave id.
  3. Опишите каналы устройства:
    • Нажмите кнопку Properties.
    • Установите флажок Custom channels.
    • В описании устройства появится раздел Custom channels.
    • Теперь нужно добавить пользовательский канал, для этого в разделе Custom channels нажмите на кнопку +Channel.
    • Введите имя контрола в веб-интерфейсе и другие параметры канала.
  4. Сохраните изменения в настройках — нажмите кнопку Save в верхней части окна.

  • Нажмите кнопку +Device, чтобы добавить новое serial-устройство

  • Веб-интерфейс: основные настройки датчика WB-MSW v.3

Проверка работы

Проверить работу добавленного в веб-интерфейс устройства можно на вкладке Devices, после добавления устройства в веб-интерфейс на ней появится блок с этим устройством. Если вашего устройства там нет — проверьте параметры подключения и адрес самого устройства.

  • Перед переходом на вкладку Devices не забудьте сохранить настройки

  • Датчик WB-MSW v.3 в веб-интерфейсе на вкладке Devices

Отключение каналов, смена режимов и настройка параметров

В веб-интерфейсе вы можете:

  • Отключать опрос тех каналов устройства, которые вы не используете — это снизит нагрузку на шину RS-485.
  • Выбирать режимы работы входов или выходов.
  • Настраивать дополнительные параметры устройства, например, частоту PWM в диммерах.
  • Настройки модуля WB-MRGBW-D в веб-интерфейсе контроллера Wiren Board

  • Настройка входов

  • Настройка выходов

  • Настройка скорости обмена

  • Информация об устройстве

Дополнительные параметры устройства

Дополнительные параметры устройства передаются устройству при перезапуске wb-mqtt-serial или при восстановлении связи с устройством.

Параметры, указанные в шаблоне (parameters-секция)

Если в шаблоне заполнена parameters-секция, то при выборе шаблона, в настройках устройства появится раздел Device options, который будет содержать указанные в шаблоне параметры.

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

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

  • Параметры инициализации устройства (parameters-секция) в файле шаблона

  • Параметры инициализации устройства (parameters-секция) в веб-интерфейсе

Пользовательские параметры

Если у устройства нет шаблона или в шаблоне не указаны нужные вам настройки инициализации, то вы можете добавить пользовательские параметры прямо из веб-интерфейса:

  1. Нажмите в описании устройства кнопку Properties.
  2. Поставьте флажок Custom setup commands. После этого появится раздел Custom setup commands.
  3. В разделе Custom setup commands нажмите кнопку +Setup command.
  4. Заполните поля:
    • Command name — имя команды. Используется для записи в журналы и отладки.
    • Address — адрес регистра, куда записывать значение.
    • Value — значение, которое нужно записать для инициализации устройства.

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

  • Включение отображения пользовательских команд инициализации

  • Создание пользовательской команды инициализации реле WB-MR14

Настройка периода опроса

В свежих версиях прошивок некоторые регистры поддерживают события, которые являются частью расширения Быстрый Modbus⚡. События опрашиваются широковещательными командами, поэтому для каналов поддерживающих события период опроса задать нельзя, а соответсвующее поле в веб-интерфейсе служит для изменения приоритета опроса событий.

Вы можете задать желаемый период опроса и драйвер будет стараться его выдержать, а если заданный период выдержать не получится — он сообщит об этом в карточке устройства.

Точная настройка периода опроса может быть полезна, если какие-то каналы нужно опрашивать часто. Значения, которые можно указать, зависят от количества каналов, которые надо опрашивать быстро, обычно это: от 200 до 500 мс на канал. Не рекомендуем использовать эту настройку для замедления опроса каналов, например, установки значений в десятки секунд — это может сильно замедлить работу драйвера, так как он не сможет оптимизировать запросы по своему усмотрению.

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

Рекомендации:

  • Поднимите скорость шины до 115 200 бит/с, инструкция.
  • Для ускорения опроса рекомендуем устанавливать период не меньше 100–300 мс и не более, чем для 10-15 каналов на порт. Здесь нужно учитывать, что драйвер оптимизирует запросы, например, состояние всех шести входов одного реле он может считать за один раз, а значит максимальное количество каналов нужно подбирать опытным путём и оно может быть сильно больше 15 штук.
  • Проверьте, чтобы в записях драйвера wb-mqtt-serial в системном журнале не было ошибок, предупреждений и информации о недоступных устройствах. Если вы физически отключили какое-то устройство, то выключите его опрос в настройках драйвера.
  • Если вы столкнулись с тем, что желаемый период выдержать не получается — увеличьте период опроса или пересмотрите количество каналов.

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

  • Настройка периода опроса

  • Выбор периода для опроса канала

  • Предупреждение о том, что период опроса канала Input 1 выдержать не получается

Полезные ссылки

Источник — https://wirenboard.com/wiki/index.php?title=RS-485:Configuration_via_Web_Interface&oldid=79427