Начальное конфигурирование устройств через веб-интерфейс

Материал из Wiren Board
Это утверждённая версия страницы. Она же — наиболее свежая версия.

Информацию о том, как проложить шину 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.

Откройте веб-интерфейс и перейдите в раздел SettingsConfigsSerial 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-порт:

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

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

Чтобы добавить устройство в веб-интерфейс, перейдите в настройках порта в раздел 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 в верхней части окна.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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