RS-485:Configuration via Web Interface: различия между версиями

Материал из Wiren Board
м (Обновил с учетом нового веб-интерфейса и wb-mqtt-serial.)
(не показаны 22 промежуточные версии этого же участника)
Строка 1: Строка 1:
{{DISPLAYTITLE:Начальное конфигурирование устройств через веб-интерфейс}}
{{DISPLAYTITLE:Начальное конфигурирование устройств через веб-интерфейс}}
Информацию о том, как проложить шину RS-485 и подключить к ней устройства, читайте на странице [[RS-485|RS-485]].


Информацию о том, как проложить шину RS-485 и подключить к ней устройства, читайте на странице [[RS-485|RS-485]].
== Смена уровня доступа к веб-интерфейсу ==
{{Wbincludes:WebUI Change Access Level}}


=== Настройка порта ===  
== Настройка порта ==  
Откройте веб-интерфейс и перейдите в раздел '''Settings''' → '''Configs''' → '''Serial Device Driver Configuration'''.
Откройте веб-интерфейс и перейдите в раздел '''Settings''' → '''Configs''' → '''Serial Device Driver Configuration'''.


В левой части выберите порт, к которому вы подключили устройство. В последних версиях контроллера встроенные serial-порты называются <code>/dev/ttyRS485-1</code> и <code>/dev/ttyRS485-2</code>.
В левой части выберите порт, к которому вы подключили устройство. Для настройки порта нужно установить галочку '''Enable port''' и указать параметры подключения:
 
Для настройки порта нужно установить галочку '''Enable port''' и указать параметры подключения:
{|class="wikitable" style="text-align:left"
{|class="wikitable" style="text-align:left"
! Параметр, EN
! Параметр, EN
Строка 39: Строка 39:
<gallery mode="packed" heights="300px">
<gallery mode="packed" heights="300px">
Image: webui2. Settings → Configs.png | Выберите ''Serial Device Driver Configuration''
Image: webui2. Settings → Configs.png | Выберите ''Serial Device Driver Configuration''
Image: webui2. Settings → Configs → Serial Device Driver Configuration.png | Выберите нужный serial-порт, включите его и укажите настройки подключения
Image: webui2. Settings → Configs → Serial Device Driver Configuration.png | Выберите нужный serial-порт, включите его и укажите настройки подключения: ''Baud rate'', ''Parity'', ''Data bits'', ''Stop bits''
</gallery>
</gallery>


=== Добавление устройств ===
== Добавление устройств ==
 
Чтобы добавить устройство в веб-интерфейс, перейдите в [[#Настройка порта | настройках порта]] в раздел '''Devices attached to the port''' и нажмите кнопку '''+Device'''.


Чтобы добавить устройство в веб-интерфейс, выберите в [[#Настройка порта | настройках порта]], раздел '''Devices attached to the port''' и нажмите кнопку '''+Device'''.
Для всех устройств Wiren Board и некоторых устройств сторонних производителей, в поставке ПО контроллера Wiren Board есть шаблоны, которые облегчают настройку устройства. Список поддерживаемых сторонних устройств можно посмотреть в таблице [[Поддерживаемые_устройства#Протестированные устройства сторонних производителей | Протестированные устройства сторонних производителей]], если у устройства есть шаблон, то он будет указан в колонке «Драйвер / название шаблона».


Для всех наших устройств и некоторых сторонних, в поставке ПО контроллера Wiren Board есть шаблоны, которые облегчают настройку устройства. Список поддерживаемых сторонних устройств можно посмотреть в таблице [[Поддерживаемые_устройства#Протестированные устройства сторонних производителей | Протестированные устройства сторонних производителей]], если у устройства есть шаблон, то он будет указан в колонке «Драйвер / название шаблона».
Modbus-адрес (Slave id) устройств Wiren Board устанавливается с завода и указан в наклейке на корпусе устройства. Если адрес был изменен и вы его не знаете — его можно [[Определение и изменение Modbus-адреса устройств Wirenboard | определить или назначить новый]].


==== Устройство с шаблоном ====
=== Устройство с шаблоном ===
Если у подключаемого устройства есть шаблон, то настройка сводится к двум шагам:
Если у подключаемого устройства есть шаблон, то это облегчает настройку:
# В поле Device N, где N — порядковый номер устройства в списке, выберите в выпадающем списке шаблон устройства.  
# В поле Device N, где N — порядковый номер устройства в списке, выберите в выпадающем списке шаблон устройства.  
# Укажите его адрес в поле '''Slave id'''.
# Укажите его адрес в поле '''Slave id'''.
# Сохраните изменения в настройках — нажмите кнопку '''Save''' в верхней части окна.
# Сохраните изменения в настройках — нажмите кнопку '''Save''' в верхней части окна.


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


Если шаблона вашего устройства нет в списке, вы можете добавить устройство вручную или [[Wb-mqtt-serial templates | составить свой шаблон]] и загрузить его на контроллер.
Если шаблона вашего устройства нет в списке, вы можете добавить устройство вручную или [[Wb-mqtt-serial templates | составить свой шаблон]] и загрузить его на контроллер.
Строка 74: Строка 76:
</gallery>
</gallery>


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


<gallery mode="packed" heights="300px">
<gallery mode="packed" heights="300px">
Строка 82: Строка 84:
</gallery>
</gallery>


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


==== Параметры, указанные в шаблоне (setup-секция) ====
=== Параметры, указанные в шаблоне (parameters-секция) ===
Если в шаблоне заполнена setup-секция, то при выборе шаблона в настройках устройства появится раздел '''Device options''', который будет содержать указанные в шаблоне параметры.
Если в шаблоне заполнена parameters-секция, то при выборе шаблона в настройках устройства появится раздел '''Device options''', который будет содержать указанные в [[Wb-mqtt-serial templates#Секция параметров (parameters-секция) | шаблоне параметры]].


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


О том, как составить свой шаблон и заполнить setup-секцию читайте в статье [[Wb-mqtt-serial templates | Шаблоны]].
После сохранения настроек включенные параметры будут записаны в устройство.


<gallery mode="packed" heights="300px">
<gallery mode="packed" heights="300px">
Image: webui2. WB-MR14 Device Options in template (setup-section).png | Параметры инициализации устройства (setup-секция) в файле шаблона  
Image: webui2. WB-MR14 Device Options in template (parameters-section).png | Параметры инициализации устройства (parameters-секция) в файле шаблона  
Image: webui2. WB-MR14 Device Options.png | Параметры инициализации устройства (setup-секция) в веб-интерфейсе
Image: webui2. WB-MR14 Device Options.png | Параметры инициализации устройства (parameters-секция) в веб-интерфейсе
</gallery>
</gallery>


==== Пользовательские параметры ====
=== Пользовательские параметры ===
Если у устройства нет шаблона или в шаблоне не указаны нужные вам настройки инициализации, то вы можете добавить пользовательские параметры прямо из веб-интерфейса:
Если у устройства нет шаблона или в шаблоне не указаны нужные вам настройки инициализации, то вы можете добавить пользовательские параметры прямо из веб-интерфейса:
# Нажмите в описании устройства кнопку '''Properties'''.
# Нажмите в описании устройства кнопку '''Properties'''.
Строка 114: Строка 116:
</gallery>
</gallery>


=== Вложенные устройства ===
== Вложенные устройства ==
Некоторое оборудование на каждом канале имеет вложенные устройства, например, [[MAI11| WB-MAI11]]. Для того чтобы в веб-интерфейсе отобразились вложенные устройства, они должны быть [[Wb-mqtt-serial templates | описаны в шаблоне]].
Некоторое оборудование на каждом канале имеет вложенные устройства, например, [[MAI11| WB-MAI11]]. Для того чтобы в веб-интерфейсе отобразились вложенные устройства, они должны быть [[Wb-mqtt-serial templates#Вложенные устройства (subdevices) | описаны в шаблоне]].


Вложенные устройства отображаются в разделе ''Channels'', но в отличие от каналов, имеют свой набор полей.
Вложенные устройства отображаются в разделе ''Channels'', но в отличие от каналов, могут содержать свои setup- и parameters-секции, а также каналы.


<gallery mode="packed" heights="300px">
<gallery mode="packed" heights="300px">
Image: Config, Device, Nested devices in channels. Template.png | Вложенные устройства в шаблоне
Image: Config, Device, Nested devices in channels. Template.png | Вложенные устройства в шаблоне WB-MAI11
Image: webui2. Config, Device, Nested devices in channels.png | Вложенные устройства в веб-интерфейсе
Image: webui2. Config, Device, Nested devices in channels.png | Вложенные устройства в веб-интерфейсе
</gallery>
</gallery>


=== Настройка периода опроса ===
== Настройка периода опроса ==
Общий для всех устройств период опроса задается параметром ''Desired poll interval'' в настройках порта. Вы можете переопределить период опроса для порта, каждого устройства или канала. Например, вы можете изменить период опроса каналов реле, что сократит время срабатывания.
Общий для всех устройств период опроса задается параметром ''Desired poll interval'' в настройках порта. Вы можете переопределить период опроса для порта, каждого устройства или канала. Например, вы можете изменить период опроса входов реле, что сократит время срабатывания.
 
=== Порт ===
Если интервал опроса не задан явно, то он равен 20 мс для всех устройств, подключенных к порту.


==== Порт ====
Вы можете задать свой период опроса устройств, для этого нужно включить отображение поля ''Desired poll interval'' и указать значение:
Вы можете задать период опроса устройств, подключенных к порту. Для этого нужно включить отображение поля ''Desired poll interval'' и указать значение:
# Нажмите на кнопку '''Properties''' в описании serial-порта.
# Нажмите на кнопку '''Properties''' в описании serial-порта.
# Отметьте флажок '''Desired poll interval'''. В описании порта появится одноименное поле.
# Отметьте флажок '''Desired poll interval'''. В описании порта появится одноименное поле.
# Введите в поле '''Desired poll interval''' значение в миллисекундах.
# Введите в поле '''Desired poll interval''' значение в миллисекундах.


После сохранения настроек устройства, подключенные к этому порту будут опрашиваться с заданным интервалом. Значение по умолчанию — 10 мс.
После сохранения настроек устройства, подключенные к этому порту будут опрашиваться с заданным интервалом.


<gallery mode="packed" heights="300px">
<gallery mode="packed" heights="300px">
Строка 140: Строка 144:
</gallery>
</gallery>


==== Устройство ====
=== Устройство ===
Вы можете задать период опроса устройства, для этого нужно включить отображение поля ''Desired poll interval'' и указать значение:
 
Если интервал опроса не задан явно, то он берется из настроек serial-порта.
 
При необходимости, вы можете переопределить период опроса устройства, установленный в параметрах serial-порта. Для этого нужно включить отображение поля ''Desired poll interval'' и указать нужное значение:
# Нажмите на кнопку '''Properties''' в описании устройства.
# Нажмите на кнопку '''Properties''' в описании устройства.
# Отметьте флажок '''Desired poll interval'''. В описании устройства появится одноименное поле.
# Отметьте флажок '''Desired poll interval'''. В описании устройства появится одноименное поле.
# Введите в поле '''Desired poll interval''' значение в миллисекундах.
# Введите в поле '''Desired poll interval''' значение в миллисекундах.


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


<gallery mode="packed" heights="300px">
<gallery mode="packed" heights="300px">
Image: webui2. Device Desired pool interval.png | Включение отображения опции ''Desired poll interval''
Image: webui2. Device Desired pool interval.png | Включение отображения опции ''Desired poll interval''
Image: webui2. WB-MR14 Desired pool interval.png | Настройка периода опроса реле [[WB-MR14 Modbus 14 Channel Relay Module | WB-MR14]], установлено значение по умолчанию — 20 мс.
Image: webui2. WB-MR14 Desired pool interval.png | Настройка периода опроса реле [[WB-MR14 Modbus 14 Channel Relay Module | WB-MR14]]
</gallery>
</gallery>


==== Канал ====
=== Канал ===
Помимо периода опроса устройства целиком, можно задать индивидуальный период опроса каждого канала в отдельности, для этого в описании каждого канала есть поле ''Poll interval'':
Помимо периода опроса устройства целиком, можно задать индивидуальный период опроса каждого канала в отдельности, для этого в описании каждого канала есть поле ''Poll interval'':
# Перейдите в описание устройства и разверните группу '''Channels'''.
# Перейдите в описание устройства и разверните группу '''Channels'''.
Строка 164: Строка 171:
Image: webui2. Config, Device, Channels.png | Для каждого канала укажите нужное значение в поле ''Poll interval''  
Image: webui2. Config, Device, Channels.png | Для каждого канала укажите нужное значение в поле ''Poll interval''  
</gallery>
</gallery>
== Полезные ссылки ==
* [[Wb-mqtt-serial driver| Описание драйвера wb-mqtt-serial в нашей вики]]
* [[Wb-mqtt-serial templates| Описание шаблонов и примеры]]

Версия 20:14, 21 апреля 2021

Информацию о том, как проложить шину RS-485 и подключить к ней устройства, читайте на странице RS-485.

Смена уровня доступа к веб-интерфейсу

Уровень «Администратор»

Для изменения настроек контроллера вам нужен уровень доступа Администратор, который можно выставить в разделе НастройкиПрава доступа.

После завершения настроек рекомендуем поставить уровень доступа Пользователь или Оператор — это поможет не совершить случайных ошибок при ежедневной работе с веб-интерфейсом.

Настройка порта

Откройте веб-интерфейс и перейдите в раздел SettingsConfigsSerial Device Driver Configuration.

В левой части выберите порт, к которому вы подключили устройство. Для настройки порта нужно установить галочку Enable port и указать параметры подключения:

Параметр, EN Параметр, RU Значение по умолчанию
Baud rate Скорость 9600
Parity Четность N
Data bits Биты данных 8
Stop bits Количество стоп-бит 2

Значение параметров можно взять из документации на оборудование. В колонке «По умолчанию» указаны заводские параметры для подключения к оборудованию Wiren Board.

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

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

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

Чтобы добавить устройство в веб-интерфейс, перейдите в настройках порта в раздел Devices attached to the port и нажмите кнопку +Device.

Для всех устройств Wiren Board и некоторых устройств сторонних производителей, в поставке ПО контроллера Wiren Board есть шаблоны, которые облегчают настройку устройства. Список поддерживаемых сторонних устройств можно посмотреть в таблице Протестированные устройства сторонних производителей, если у устройства есть шаблон, то он будет указан в колонке «Драйвер / название шаблона».

Modbus-адрес (Slave id) устройств Wiren Board устанавливается с завода и указан в наклейке на корпусе устройства. Если адрес был изменен и вы его не знаете — его можно определить или назначить новый.

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

Если у подключаемого устройства есть шаблон, то это облегчает настройку:

  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, после добавления устройства в веб-интерфейс на ней появится блок с этим устройством. Если вашего устройства там нет — проверьте параметры подключения и адрес самого устройства.

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

Дополнительные параметры устройства передаются устройству при перезапуске 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 — значение, которое нужно записать для инициализации устройства.

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

Вложенные устройства

Некоторое оборудование на каждом канале имеет вложенные устройства, например, WB-MAI11. Для того чтобы в веб-интерфейсе отобразились вложенные устройства, они должны быть описаны в шаблоне.

Вложенные устройства отображаются в разделе Channels, но в отличие от каналов, могут содержать свои setup- и parameters-секции, а также каналы.

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

Общий для всех устройств период опроса задается параметром Desired poll interval в настройках порта. Вы можете переопределить период опроса для порта, каждого устройства или канала. Например, вы можете изменить период опроса входов реле, что сократит время срабатывания.

Порт

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

Вы можете задать свой период опроса устройств, для этого нужно включить отображение поля Desired poll interval и указать значение:

  1. Нажмите на кнопку Properties в описании serial-порта.
  2. Отметьте флажок Desired poll interval. В описании порта появится одноименное поле.
  3. Введите в поле Desired poll interval значение в миллисекундах.

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

Устройство

Если интервал опроса не задан явно, то он берется из настроек serial-порта.

При необходимости, вы можете переопределить период опроса устройства, установленный в параметрах serial-порта. Для этого нужно включить отображение поля Desired poll interval и указать нужное значение:

  1. Нажмите на кнопку Properties в описании устройства.
  2. Отметьте флажок Desired poll interval. В описании устройства появится одноименное поле.
  3. Введите в поле Desired poll interval значение в миллисекундах.

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

Канал

Помимо периода опроса устройства целиком, можно задать индивидуальный период опроса каждого канала в отдельности, для этого в описании каждого канала есть поле Poll interval:

  1. Перейдите в описание устройства и разверните группу Channels.
  2. Найдите поле Poll interval и введите значение в миллисекундах для каждого канала.

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

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