RS-485:Configuration via Web Interface: различия между версиями
(не показано 10 промежуточных версий 3 участников) | |||
Строка 1: | Строка 1: | ||
{{DISPLAYTITLE:Начальное конфигурирование устройств через веб-интерфейс}} | {{DISPLAYTITLE:Начальное конфигурирование устройств через веб-интерфейс}} | ||
== Введение == | |||
{{note|info|С апреля 2024 года мы начали улучшать интерфейс конфигуратора, поэтому в вашем релизе софта он может немного или сильно отличаться. В этой статье описывается поведение в текущем [[testing|стабильном релизе]].}} | |||
{{PeerTube | |||
| link= https://peertube.wirenboard.com/video-playlists/embed/6623c76e-1abe-4728-959c-f5dde919d80c?playlistPosition=8 | |||
| playlist = true | |||
| text= Настройка подключённых устройств | |||
}} | |||
В контроллере для работы с устройствами есть драйвер [[wb-mqtt-serial]], в котором для каждого поддерживаемого устройства есть шаблон. Вам надо выбрать эти шаблоны в веб-интерфейсе контроллера. | |||
Информацию о том, как проложить шину RS-485 и подключить к ней устройства, читайте на странице [[RS-485|RS-485]]. | Информацию о том, как проложить шину RS-485 и подключить к ней устройства, читайте на странице [[RS-485|RS-485]]. | ||
== Как зайти в веб-интерфейс == | == Как зайти в веб-интерфейс == | ||
{{Wbincludes:How to enter}} | {{Wbincludes:How to enter}} | ||
Строка 6: | Строка 16: | ||
== Смена уровня доступа к веб-интерфейсу == | == Смена уровня доступа к веб-интерфейсу == | ||
{{Wbincludes:WebUI Change Access Level}} | {{Wbincludes:WebUI Change Access Level}} | ||
== Поиск устройств Wiren Board на шине RS-485 == | |||
{{Wbincludes:WebUI Scan Devices}} | |||
== Настройка порта == | == Настройка порта == | ||
Строка 69: | Строка 82: | ||
Для всех устройств Wiren Board и некоторых устройств сторонних производителей, в поставке ПО контроллера Wiren Board есть шаблоны, которые облегчают настройку устройства. Список поддерживаемых сторонних устройств можно посмотреть в таблице [[Поддерживаемые_устройства#Протестированные устройства сторонних производителей | Протестированные устройства сторонних производителей]], если у устройства есть шаблон, то он будет указан в колонке «Драйвер / название шаблона». | Для всех устройств Wiren Board и некоторых устройств сторонних производителей, в поставке ПО контроллера Wiren Board есть шаблоны, которые облегчают настройку устройства. Список поддерживаемых сторонних устройств можно посмотреть в таблице [[Поддерживаемые_устройства#Протестированные устройства сторонних производителей | Протестированные устройства сторонних производителей]], если у устройства есть шаблон, то он будет указан в колонке «Драйвер / название шаблона». | ||
Modbus-адрес (Slave id) устройств Wiren Board устанавливается с завода и указан в наклейке на корпусе устройства. Если | Modbus-адрес (Slave id) устройств Wiren Board устанавливается с завода и указан в наклейке на корпусе устройства. Также адреса устройств можно узнать если выполнить сканирование шины в веб-интерфейсе контроллера в разделе '''Settings → Scan'''. Там же можно получить список всех устройств Wiren Board, подключенных к шине RS-485 с их серийными номерами, настройками соединения и версиями прошивок. Если адреса дублируются их нужно [[Определение и изменение Modbus-адреса устройств Wirenboard |изменить]]. | ||
=== Устройство с шаблоном === | === Устройство с шаблоном === | ||
Строка 79: | Строка 92: | ||
=== Устройство без шаблона === | === Устройство без шаблона === | ||
{{Anchor|without-template}} | {{Anchor|without-template}} | ||
Если шаблона вашего устройства нет в списке, вы можете добавить устройство вручную или [[ | Если шаблона вашего устройства нет в списке, вы можете добавить устройство вручную или [[Connecting_Third_Party_Devices_to_Wiren_Board | составить свой шаблон]] и загрузить его на контроллер. | ||
Чтобы подключить устройство без шаблона: | Чтобы подключить устройство без шаблона: | ||
Строка 106: | Строка 119: | ||
== Отключение каналов, смена режимов и настройка параметров == | == Отключение каналов, смена режимов и настройка параметров == | ||
{{ | {{Anchor|poll-settings}} | ||
| | |||
В веб-интерфейсе вы можете: | В веб-интерфейсе вы можете: | ||
* Отключать опрос тех каналов устройства, которые вы не используете — это снизит нагрузку на шину [[RS-485]]. | * Отключать опрос тех каналов устройства, которые вы не используете — это снизит нагрузку на шину [[RS-485]]. | ||
Строка 122: | Строка 131: | ||
Image: WB-MRGBW-D Webui configs HW Info.png | Информация об устройстве | Image: WB-MRGBW-D Webui configs HW Info.png | Информация об устройстве | ||
</gallery> | </gallery> | ||
== Дополнительные параметры устройства == | == Дополнительные параметры устройства == | ||
Строка 157: | Строка 165: | ||
== Настройка периода опроса == | == Настройка периода опроса == | ||
{{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]]⚡. События опрашиваются широковещательными командами, поэтому для каналов поддерживающих события период опроса задать нельзя, а соответсвующее поле в веб-интерфейсе служит для изменения приоритета опроса событий.}} | |||
{{Anchor|poll-period}} | {{Anchor|poll-period}} | ||
Вы можете задать желаемый период опроса и драйвер будет стараться его выдержать, а если заданный период выдержать не получится — он сообщит об этом в карточке устройства. | Вы можете задать желаемый период опроса и драйвер будет стараться его выдержать, а если заданный период выдержать не получится — он сообщит об этом в карточке устройства. |
Текущая версия на 20:45, 26 августа 2024
Введение
С апреля 2024 года мы начали улучшать интерфейс конфигуратора, поэтому в вашем релизе софта он может немного или сильно отличаться. В этой статье описывается поведение в текущем стабильном релизе.
В контроллере для работы с устройствами есть драйвер wb-mqtt-serial, в котором для каждого поддерживаемого устройства есть шаблон. Вам надо выбрать эти шаблоны в веб-интерфейсе контроллера.
Информацию о том, как проложить шину RS-485 и подключить к ней устройства, читайте на странице RS-485.
Как зайти в веб-интерфейс
Чтобы зайти в веб-интерфейс контроллера Wiren Board, подключитесь к контроллеру через Wi-Fi или Ethernet и введите в адресную строку браузера IP-адрес контроллера.
Если вы находитесь в одной сети с контроллером и используете компьютер с Linux, Windows 10 и выше или macOS, или любое устройство Apple, то можно использовать mDNS. Вместо IP-адреса введите в адресную строку http://wirenboard-XXXXXXXX.local, где ХХХХХХХХ — серийный номер контроллера.
Также доступ можно получить через Wiren Board Cloud, если контроллер к нему подключен.
Смена уровня доступа к веб-интерфейсу
Для изменения настроек контроллера вам нужен уровень доступа Администратор, который можно выставить в разделе Настройки → Права доступа.
После завершения настроек рекомендуем поставить уровень доступа Пользователь или Оператор — это поможет не совершить случайных ошибок при ежедневной работе с веб-интерфейсом.
Поиск устройств Wiren Board на шине RS-485
Сканирование шины работает только для устройств с поддержкой Быстрого Modbus
В релизах с wb-2304 по wb-2404
В разделе Настройки → Сканирование можно получить список всех устройств Wiren Board подключенных к шине RS-485 с их серийными номерами, настройками соединения и версиями прошивок.
Возможности функции сканирования:
- отображение всех устройств Wiren Board, подключенных к контроллеру,
- обнаружение устройств с одинаковыми адресами на одной шине,
- обнаружение устройств с разными параметрами связи на одной шине.
Благодаря функции сканирования можно собирать шкаф управления не обращая внимания на адреса устройств — все адреса и параметры можно будет получить после сборки и сконфигурировать устройства не отключая от шины.
В релизах wb-2407 и новее
Так как сканирование тесно связано с добавлением устройств в конфигурацию контроллера, то мы убрали отдельный сканер и перенесли сканирование шины в конфигуратор настроек устройств.
Настройки → Конфигурационные файлы → Настройка драйвера serial-устройств → Найти и добавить устройства
Настройка порта
Последовательный порт
Последовательный порт служит для подключения 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 вверху страницы для сохранения изменений.
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.
Добавление устройств
Чтобы добавить устройство в веб-интерфейс, перейдите в настройках порта в раздел Devices attached to the port и нажмите кнопку +Device.
Для всех устройств Wiren Board и некоторых устройств сторонних производителей, в поставке ПО контроллера Wiren Board есть шаблоны, которые облегчают настройку устройства. Список поддерживаемых сторонних устройств можно посмотреть в таблице Протестированные устройства сторонних производителей, если у устройства есть шаблон, то он будет указан в колонке «Драйвер / название шаблона».
Modbus-адрес (Slave id) устройств Wiren Board устанавливается с завода и указан в наклейке на корпусе устройства. Также адреса устройств можно узнать если выполнить сканирование шины в веб-интерфейсе контроллера в разделе Settings → Scan. Там же можно получить список всех устройств Wiren Board, подключенных к шине RS-485 с их серийными номерами, настройками соединения и версиями прошивок. Если адреса дублируются их нужно изменить.
Устройство с шаблоном
Если у подключаемого устройства есть шаблон, то это облегчает настройку:
- В поле Device N, где N — порядковый номер устройства в списке, выберите в выпадающем списке шаблон устройства.
- Укажите его адрес в поле Slave id.
- Сохраните изменения в настройках — нажмите кнопку Save в верхней части окна.
Устройство без шаблона
Если шаблона вашего устройства нет в списке, вы можете добавить устройство вручную или составить свой шаблон и загрузить его на контроллер.
Чтобы подключить устройство без шаблона:
- Выберите шаблон
Custom device
. - Укажите его адрес в поле Slave id.
- Опишите каналы устройства:
- Нажмите кнопку Properties.
- Установите флажок Custom channels.
- В описании устройства появится раздел Custom channels.
- Теперь нужно добавить пользовательский канал, для этого в разделе Custom channels нажмите на кнопку +Channel.
- Введите имя контрола в веб-интерфейсе и другие параметры канала.
- Сохраните изменения в настройках — нажмите кнопку Save в верхней части окна.
Веб-интерфейс: основные настройки датчика WB-MSW v.3
Проверка работы
Проверить работу добавленного в веб-интерфейс устройства можно на вкладке Devices, после добавления устройства в веб-интерфейс на ней появится блок с этим устройством. Если вашего устройства там нет — проверьте параметры подключения и адрес самого устройства.
Датчик WB-MSW v.3 в веб-интерфейсе на вкладке Devices
Отключение каналов, смена режимов и настройка параметров
В веб-интерфейсе вы можете:
- Отключать опрос тех каналов устройства, которые вы не используете — это снизит нагрузку на шину RS-485.
- Выбирать режимы работы входов или выходов.
- Настраивать дополнительные параметры устройства, например, частоту PWM в диммерах.
Дополнительные параметры устройства
Дополнительные параметры устройства передаются устройству при перезапуске wb-mqtt-serial или при восстановлении связи с устройством.
Параметры, указанные в шаблоне (parameters-секция)
Если в шаблоне заполнена parameters-секция, то при выборе шаблона, в настройках устройства появится раздел Device options, который будет содержать указанные в шаблоне параметры.
По умолчанию все параметры отключены и для передачи на устройство их нужно включить. Чтобы включить параметр, установите флажок напротив названия.
После сохранения настроек включенные параметры будут записаны в устройство.
Пользовательские параметры
Если у устройства нет шаблона или в шаблоне не указаны нужные вам настройки инициализации, то вы можете добавить пользовательские параметры прямо из веб-интерфейса:
- Нажмите в описании устройства кнопку Properties.
- Поставьте флажок Custom setup commands. После этого появится раздел Custom setup commands.
- В разделе Custom setup commands нажмите кнопку +Setup command.
- Заполните поля:
- Command name — имя команды. Используется для записи в журналы и отладки.
- Address — адрес регистра, куда записывать значение.
- Value — значение, которое нужно записать для инициализации устройства.
После внесения изменений сохраните настройки.
Создание пользовательской команды инициализации реле WB-MR14
Настройка периода опроса
В свежих версиях прошивок некоторые регистры поддерживают события, которые являются частью расширения Быстрый Modbus⚡. События опрашиваются широковещательными командами, поэтому для каналов поддерживающих события период опроса задать нельзя, а соответсвующее поле в веб-интерфейсе служит для изменения приоритета опроса событий.
Вы можете задать желаемый период опроса и драйвер будет стараться его выдержать, а если заданный период выдержать не получится — он сообщит об этом в карточке устройства.
Точная настройка периода опроса может быть полезна, если какие-то каналы нужно опрашивать часто. Значения, которые можно указать, зависят от количества каналов, которые надо опрашивать быстро, обычно это: от 200 до 500 мс на канал. Не рекомендуем использовать эту настройку для замедления опроса каналов, например, установки значений в десятки секунд — это может сильно замедлить работу драйвера, так как он не сможет оптимизировать запросы по своему усмотрению.
Чтобы указать период опроса, перейдите в веб-интерфейсе в настройки драйвера serial-устройств и укажите желаемое значение для любого канала.
Рекомендации:
- Поднимите скорость шины до 115 200 бит/с, инструкция.
- Для ускорения опроса рекомендуем устанавливать период не меньше 100–300 мс и не более, чем для 10-15 каналов на порт. Здесь нужно учитывать, что драйвер оптимизирует запросы, например, состояние всех шести входов одного реле он может считать за один раз, а значит максимальное количество каналов нужно подбирать опытным путём и оно может быть сильно больше 15 штук.
- Проверьте, чтобы в записях драйвера wb-mqtt-serial в системном журнале не было ошибок, предупреждений и информации о недоступных устройствах. Если вы физически отключили какое-то устройство, то выключите его опрос в настройках драйвера.
- Если вы столкнулись с тем, что желаемый период выдержать не получается — увеличьте период опроса или пересмотрите количество каналов.
Для каналов управления менять период опроса имеет смысл только, если вам нужно быстро получить их состояние. Команду управления в устройство драйвер отправляет вне очереди, при первой возможности.