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

From Wiren Board
This is the approved revision of this page, as well as being the most recent.

Введение

Настройка подключённых устройств

Для работы с устройствами в контроллере есть драйвер 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.

  1. Откройте веб-интерфейс и перейдите в раздел Настройки → Конфигурационные файлы → Настройка драйвера serial-устройств.
  2. В левой части выберите порт, к которому вы подключили устройство. Для настройки порта установите галочку Включить порт и укажите параметры подключения:
Параметр, EN Параметр, RU Значение по умолчанию
Baud rate Скорость обмена 9600
Parity Контроль четности N
Data bits Число бит данных 8
Stop bits Количество стоп-бит 2
  • значение параметров можно взять из документации на оборудование;
  • для Modbus-устройств Wiren Board рекомендуем установить скорость обмена на шине RS485 115200 бит/с, инструкция;
  • к одному порту можно подключить несколько устройств, но в этом случае параметры подключения на всех устройствах должны совпадать.
  1. Нажмите Сохранить настройки.


TCP-порт

Настройки TCP-порта

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

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

  1. Перейдите в раздел Настройки → Конфигурационные файлы → Настройка драйвера serial-устройств.
  2. Нажмите Добавить порт.
  3. В зависимости от протокола, укажите тип порта Передача пакетов через TCP (Serial over TCP) или MODBUS TCP.
  4. Заполните поля IPv4 адрес или доменное имя устройства и Номер TCP порта. Узнать эти данные можно в документации подключаемого устройства.
  5. Нажмите Сохранить настройки.

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

В релизах wb-2207 и старее сканирование недоступно.
В релизах с wb-2304 по wb-2404 сканирование доступно в разделе Настройки → Сканирование.

Поиск устройств
Добавление устройств автоматически

Автоматическое добавление устройств в веб-интерфейсе связанно с функцией сканирования шины:

  1. Выберите Настройки → Конфигурационные файлы → Настройка драйвера serial-устройств → Найти и добавить устройства.
    • контроллер выполнит поиск устройств Wiren Board подключенных к шине RS-485 напрямую или через порт TCP с помощью преобразователя интерфейсов;
    • для поиска устройств не поддерживающих Быстрый Modbus нажмите Начать медленное сканирование.
  2. Выберите в списке найденные устройства и нажмите Добавить в wb-mqtt-serial:
    • если при добавлении устройств будут найдены конфликты адресов на шине, то конфигуратор предложит автоматически их исправить. Также вы можете изменить адреса Modbus-устройств вручную;
    • настройки связи добавляемых устройств будут изменены в соответствии с настройками порта;
    • каждому устройству будет назначен соответствующий ему шаблон.
  3. Нажмите Сохранить настройки.

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

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

Чтобы добавить устройство вручную вам понадобится:

  1. Шаблон устройства.
    • драйвер wb-mqtt-serial уже содержит шаблоны устройств Wiren Board и всех поддерживаемых устройств, поэтому специально ничего делать не нужно;
    • если ваше устройство не поддерживается, вы можете сделать свой шаблон и загрузить его на контроллер;
    • при отсутствии шаблона можно воспользоваться специальным шаблоном «Устройство с протоколом Modbus», чтобы добавить регистры устройства прямо в веб-интерфейсе. Этот способ удобен для быстрой проверки работы.
  2. Modbus-адрес (Slave id) устройства.
    • адрес устройств Wiren Board установлен на заводе и указан на наклейке на корпусе устройства;
    • также адреса устройств можно узнать если выполнить сканирование шины в веб-интерфейсе контроллера. Если адреса дублируются их нужно изменить;
    • адрес стороннего устройства смотрите в его документации или используйте медленное сканирование шины (Настройка драйвера serial-устройств → Найти и добавить устройства → Начать медленное сканирование).


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

Добавление устройств вручную
Выбор шаблона устройства
Устройство с шаблоном «Устройство с протоколом Modbus»
  1. Выберите Настройки → Конфигурационные файлы → Настройка драйвера serial-устройств → Добавить любые устройства вручную.
  2. В открывшемся окне выберите Порт к которому подключено устройство, в поле Тип устройства выберите шаблон устройства. Нажмите Добавить. Устройство будет добавлено и выбрано в конфигураторе.
  3. В поле Адрес устройства укажите его Modbus-адрес (Slave id).
  4. Нажмите Сохранить настройки.


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

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

Или воспользуйтесь специальным шаблоном «Устройство с протоколом Modbus», чтобы добавить регистры устройства прямо в веб-интерфейсе.

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

  1. Выберите Настройки → Конфигурационные файлы → Настройка драйвера serial-устройств → Добавить любые устройства вручную.
  2. В открывшемся окне выберите Порт к которому подключено устройство, в поле Тип устройства выберите шаблон «Устройство с протоколом Modbus». Нажмите Добавить. Устройство будет добавлено и выбрано в конфигураторе.
  3. В поле Адрес устройства укажите его Modbus-адрес (Slave id).
  4. Опишите каналы устройства:
    • нажмите Свойства и установите флажок Каналы, заданные пользователем. В описании устройства появится соответствующий раздел;
    • для добавления нового канала нажмите +Канал;
    • введите имя контрола, его адрес и другие параметры канала.
  5. Нажмите Сохранить настройки.

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

Вкладка Устройства

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

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

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

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

Доступно с релиза wb-2602 Конфигуратор может читать настройки из устройств. Логика работы:

  1. Если значение есть в конфиге — показывается оно.
  2. Если устройство подключено и в конфиге нет значения — берётся из устройства.
  3. Если устройство не подключено и значения нет в конфиге — используется значение по умолчанию.

Чтобы уменьшить размер конфига и ускорить старт системы, в конфиг записываются только параметры, отличающиеся от значений по умолчанию, или изменённые пользователем в текущей сессии.

Каналы заданные пользователем

Конфигуратор позволяет добавлять элементы управления для пользовательских параметров устройства. Это удобно, если шаблон отсутствует или не покрывает все нужные параметры. Настройка выполняется на вкладке «Пользовательские каналы».

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

Обычно тут ничего трогать не надо, все каналы устройств Wiren Board, где это имеет смысл, поддерживают события Быстрого Modbus и не нуждаются в дополнительных настройках.

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

Команду управления в устройство драйвер отправляет вне очереди, при первой возможности.

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