Начальное конфигурирование устройств через веб-интерфейс
Введение
Для работы с устройствами в контроллере есть драйвер 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, если контроллер к нему подключен.
Смена уровня доступа к веб-интерфейсу
Для изменения настроек контроллера вам нужен уровень доступа Администратор, который можно выставить в разделе Настройки → Права доступа.
После завершения настроек рекомендуем поставить уровень доступа Пользователь или Оператор — это поможет не совершить случайных ошибок при ежедневной работе с веб-интерфейсом.
Настройка порта
Последовательный порт
Последовательный порт служит для подключения Modbus-устройств к контроллеру через шину RS-485.
- Откройте веб-интерфейс и перейдите в раздел Настройки → Конфигурационные файлы → Настройка драйвера serial-устройств.
- В левой части выберите порт, к которому вы подключили устройство. Для настройки порта установите галочку Включить порт и укажите параметры подключения:
Параметр, EN Параметр, RU Значение по умолчанию Baud rate Скорость обмена 9600 Parity Контроль четности N Data bits Число бит данных 8 Stop bits Количество стоп-бит 2
- значение параметров можно взять из документации на оборудование;
- для Modbus-устройств Wiren Board рекомендуем установить скорость обмена на шине RS485 115200 бит/с, инструкция;
- к одному порту можно подключить несколько устройств, но в этом случае параметры подключения на всех устройствах должны совпадать.
- Нажмите Сохранить настройки.
TCP-порт
TCP-порт служит для подключения устройств по протоколам TCP port (Serial over TCP) или MODBUS TCP Port, например, WB-MGE или WB-MIO-E.
Чтобы добавить новый TCP-порт:
- Перейдите в раздел Настройки → Конфигурационные файлы → Настройка драйвера serial-устройств.
- Нажмите Добавить порт.
- В зависимости от протокола, укажите тип порта Передача пакетов через TCP (Serial over TCP) или MODBUS TCP.
- Заполните поля IPv4 адрес или доменное имя устройства и Номер TCP порта. Узнать эти данные можно в документации подключаемого устройства.
- Нажмите Сохранить настройки.
Добавление устройств автоматически
В релизах wb-2207 и старее сканирование недоступно.
В релизах с wb-2304 по wb-2404 сканирование доступно в разделе Настройки → Сканирование.
Автоматическое добавление устройств в веб-интерфейсе связанно с функцией сканирования шины:
- Выберите Настройки → Конфигурационные файлы → Настройка драйвера serial-устройств → Найти и добавить устройства.
- контроллер выполнит поиск устройств Wiren Board подключенных к шине RS-485 напрямую или через порт TCP с помощью преобразователя интерфейсов;
- для поиска устройств не поддерживающих Быстрый Modbus нажмите Начать медленное сканирование.
- Выберите в списке найденные устройства и нажмите Добавить в wb-mqtt-serial:
- если при добавлении устройств будут найдены конфликты адресов на шине, то конфигуратор предложит автоматически их исправить. Также вы можете изменить адреса Modbus-устройств вручную;
- настройки связи добавляемых устройств будут изменены в соответствии с настройками порта;
- каждому устройству будет назначен соответствующий ему шаблон.
- Нажмите Сохранить настройки.
В редких случаях у разных устройств могут быть одинаковые сигнатуры, но разные шаблоны. В этом случае конфигуратор предложит выбрать нужный шаблон вручную.
Добавление устройств вручную
Чтобы добавить устройство вручную вам понадобится:
- Шаблон устройства.
- драйвер wb-mqtt-serial уже содержит шаблоны устройств Wiren Board и всех поддерживаемых устройств, поэтому специально ничего делать не нужно;
- если ваше устройство не поддерживается, вы можете сделать свой шаблон и загрузить его на контроллер;
- при отсутствии шаблона можно воспользоваться специальным шаблоном «Устройство с протоколом Modbus», чтобы добавить регистры устройства прямо в веб-интерфейсе. Этот способ удобен для быстрой проверки работы.
- Modbus-адрес (Slave id) устройства.
- адрес устройств Wiren Board установлен на заводе и указан на наклейке на корпусе устройства;
- также адреса устройств можно узнать если выполнить сканирование шины в веб-интерфейсе контроллера. Если адреса дублируются их нужно изменить;
- адрес стороннего устройства смотрите в его документации или используйте медленное сканирование шины (Настройка драйвера serial-устройств → Найти и добавить устройства → Начать медленное сканирование).
Устройство с шаблоном
- Выберите Настройки → Конфигурационные файлы → Настройка драйвера serial-устройств → Добавить любые устройства вручную.
- В открывшемся окне выберите Порт к которому подключено устройство, в поле Тип устройства выберите шаблон устройства. Нажмите Добавить. Устройство будет добавлено и выбрано в конфигураторе.
- В поле Адрес устройства укажите его Modbus-адрес (Slave id).
- Нажмите Сохранить настройки.
Устройство без шаблона
Если для вашего устройства нет шаблона, вы можете сделать его самостоятельно, загрузить на контроллер и добавить по инструкции выше как «устройство с шаблоном».
Или воспользуйтесь специальным шаблоном «Устройство с протоколом Modbus», чтобы добавить регистры устройства прямо в веб-интерфейсе.
Чтобы подключить устройство без шаблона:
- Выберите Настройки → Конфигурационные файлы → Настройка драйвера serial-устройств → Добавить любые устройства вручную.
- В открывшемся окне выберите Порт к которому подключено устройство, в поле Тип устройства выберите шаблон «Устройство с протоколом Modbus». Нажмите Добавить. Устройство будет добавлено и выбрано в конфигураторе.
- В поле Адрес устройства укажите его Modbus-адрес (Slave id).
- Опишите каналы устройства:
- нажмите Свойства и установите флажок Каналы, заданные пользователем. В описании устройства появится соответствующий раздел;
- для добавления нового канала нажмите +Канал;
- введите имя контрола, его адрес и другие параметры канала.
- Нажмите Сохранить настройки.
Проверка работы
Проверить работу добавленного в веб-интерфейс устройства можно на вкладке Устройства, на ней появится блок с этим устройством. Если вашего устройства там нет — проверьте параметры подключения и адрес самого устройства.
Отключение каналов, смена режимов и настройка параметров
В веб-интерфейсе вы можете:
- отключать опрос неиспользуемых каналов устройства — это снизит нагрузку на шину RS-485;
- выбирать режим работы входов или выходов;
- настраивать дополнительные параметры устройства, например, частоту PWM в диммерах.
- Настройки модуля WB-LED v.1 в веб-интерфейсе контроллера Wiren Board
Настройка входов
Настройка выходов
Настройка скорости обмена
Информация об устройстве
Каналы заданные пользователем
В конфигураторе устройств с помощью свойства Каналы, заданные пользователем можно добавить в стандартный шаблон устройства дополнительные каналы для чтения или записи регистров. Это удобно, так как не требует редактирования шаблона для взаимодействия с новыми регистрами.
В шаблоне устройства нажмите Свойства и установите флажок Каналы, заданные пользователем, в конфигураторе устройства появится соответствующий раздел. Добавьте +Канал и настройте его параметры. Добавленные каналы будут отображаться в виджете устройства.
Пример: Управление светодиодом Status в виджете устройства с помощью пользовательских каналов.
Настроим пользовательский канал датчика WB-MSW v.4 для регистра 130 (отключение светодиода Status: 0 - включен, 1 - отключен). В примере приведены два способа настройки канала для одного регистра устройства. В канале «led_status_2» параметры Значение включенного состояния ('On' value) и Значение выключенного состояния ('Off' value) добавлены через Свойства канала.
- Настройка пользовательского канала устройства
Настройка канала «led_status_1» тип «value»
Настройка канала «led_status_2» тип «switch»
Управление светодиодом Status в виджете устройства с помощью пользовательских каналов
Дополнительные параметры устройства
Дополнительные параметры устройства передаются устройству при перезапуске wb-mqtt-serial или при восстановлении связи с устройством.
Параметры, указанные в шаблоне (parameters-секция)
Шаблон устройства может содержать параметры (прописанные в секции parameters шаблона), которые отображаются при выборе устройства в конфигураторе устройств.
По умолчанию все параметры устройства отключены, для их включения:
- Выберите Настройки → Конфигурационные файлы → Настройка драйвера serial-устройств.
- Выберите устройство и группу параметров для настройки.
- Включите галочкой параметр и установите требуемое значение.
- Нажмите Сохранить настройки. Включенные параметры будут записаны в устройство.
Пользовательские параметры
Если у устройства нет шаблона или в шаблоне не указаны нужные вам настройки инициализации, то вы можете добавить пользовательские параметры прямо из веб-интерфейса:
- Нажмите в описании устройства кнопку Свойства.
- Поставьте флажок Команды настройки. После этого появится раздел Команды настройки.
- В разделе Команды настройки нажмите кнопку +Команда настройки.
- Заполните поля:
- Название команды — имя команды. Используется для записи в журналы и отладки;
- Адрес — адрес регистра, куда записывать значение;
- Значение — значение, которое нужно записать для инициализации устройства.
- Нажмите Сохранить настройки.
Включение отображения пользовательских команд инициализации
Создание пользовательской команды инициализации реле WB-MR14
Настройка периода опроса
В свежих версиях прошивок некоторые регистры поддерживают события, которые являются частью расширения Быстрый Modbus⚡. События опрашиваются широковещательными командами, поэтому для каналов поддерживающих события период опроса задать нельзя, а соответсвующее поле в веб-интерфейсе служит для изменения приоритета опроса событий.
Вы можете задать желаемый период опроса и драйвер будет стараться его выдержать, а если заданный период выдержать не получится — он сообщит об этом в карточке устройства.
Точная настройка периода опроса может быть полезна, если какие-то каналы нужно опрашивать часто. Значения, которые можно указать, зависят от количества каналов, которые надо опрашивать быстро, обычно это: от 200 до 500 мс на канал. Не рекомендуем использовать эту настройку для замедления опроса каналов, например, установки значений в десятки секунд — это может сильно замедлить работу драйвера, так как он не сможет оптимизировать запросы по своему усмотрению.
Чтобы указать период опроса, перейдите в веб-интерфейсе в настройки драйвера serial-устройств и укажите желаемое значение для любого канала.
Рекомендации:
- поднимите скорость шины до 115200 бит/с, инструкция;
- для ускорения опроса рекомендуем устанавливать период не меньше 100–300 мс и не более, чем для 10-15 каналов на порт. Здесь нужно учитывать, что драйвер оптимизирует запросы, например, состояние всех шести входов одного реле он может считать за один раз, а значит максимальное количество каналов нужно подбирать опытным путём и оно может быть сильно больше 15 штук;
- проверьте, чтобы в записях драйвера wb-mqtt-serial в системном журнале не было ошибок, предупреждений и информации о недоступных устройствах. Если вы физически отключили какое-то устройство, то выключите его опрос в настройках драйвера;
- если вы столкнулись с тем, что желаемый период выдержать не получается — увеличьте период опроса или пересмотрите количество каналов.
Для каналов управления менять период опроса имеет смысл только, если вам нужно быстро получить их состояние. Команду управления в устройство драйвер отправляет вне очереди, при первой возможности.
- Настройка периода опроса
Выбор периода для опроса канала
Предупреждение о том, что период опроса канала Input 1 выдержать не получается
