Начальное конфигурирование устройств через веб-интерфейс
Введение
Для работы с устройствами в контроллере есть драйвер wb-mqtt-serial, в котором для каждого поддерживаемого устройства есть шаблон.
Вы можете добавлять устройства в конфигураторе автоматически или вручную, через выбор шаблона. Если для вашего устройства нет шаблона, вы можете сделать его самостоятельно или воспользоваться специальным шаблоном.
Настраиваемые устройства должны быть подключены к контроллеру. Информацию о том, как проложить шину RS-485 и подключить к ней устройства, читайте на странице RS-485.
Как зайти в веб-интерфейс
Чтобы зайти в веб-интерфейс контроллера Wiren Board, подключитесь к контроллеру через Wi-Fi или Ethernet и введите в адресную строку браузера IP-адрес контроллера.
Если вы находитесь в одной сети с контроллером и используете компьютер с Linux, Windows 10 и выше или macOS, или любое устройство Apple, то можно использовать mDNS. Вместо IP-адреса введите в адресную строку http://wirenboard-XXXXXXXX.local, где ХХХХХХХХ — серийный номер контроллера.
Для обеспечения безопасности с использованием протокола HTTPS, при обращении к веб-интерфейсу, будет произведён переход на доменное имя IP.XXXXXXXX.ip.wirenboard.com (см. Безопасность соединения).
Также доступ можно получить через Wiren Board Cloud, если контроллер к нему подключен.
Смена уровня доступа к веб-интерфейсу
Доступно с релиза wb-2602
Уровень доступа зависит от учетной записи пользователя, аутентификация пользователей происходит по логину и паролю. Для изменения настроек контроллера ваша учетная запись должна иметь уровень доступа Администратор. Управление учетными записями доступно в разделе Настройки → Пользователи. Подробнее см. Аутентификация и авторизация пользователя.
В релизах до wb-2602 нет учетных записей пользователя, а уровень доступа настраивается в разделе Настройки → Права доступа.
Настройка порта
Последовательный порт
Последовательный порт служит для подключения 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-MDM3 в веб-интерфейсе контроллера Wiren Board
Доступно с релиза wb-2602 Конфигуратор может читать настройки из устройств. Логика работы:
- Если значение есть в конфиге — показывается оно.
- Если устройство подключено и в конфиге нет значения — берётся из устройства.
- Если устройство не подключено и значения нет в конфиге — используется значение по умолчанию.
Чтобы уменьшить размер конфига и ускорить старт системы, в конфиг записываются только параметры, отличающиеся от значений по умолчанию, или изменённые пользователем в текущей сессии.
Каналы заданные пользователем
Конфигуратор позволяет добавлять элементы управления для пользовательских параметров устройства. Это удобно, если шаблон отсутствует или не покрывает все нужные параметры. Настройка выполняется на вкладке «Пользовательские каналы».
- Настройка пользовательского канала устройства
Настройка периода опроса
Обычно тут ничего трогать не надо, все каналы устройств Wiren Board, где это имеет смысл, поддерживают события Быстрого Modbus и не нуждаются в дополнительных настройках.
Для каналов сторонних устройств можно опционально указать желаемый период опроса.
Команду управления в устройство драйвер отправляет вне очереди, при первой возможности.
- Настройка периода опроса
