|
|
(не показано 148 промежуточных версий 7 участников) |
Строка 1: |
Строка 1: |
| {{DISPLAYTITLE:Начальное конфигурирование устройств через веб-интерфейс}}
| | Общую информацию по подключению устройств RS-485 к контроллеру смотрите на странице [[RS-485]]. |
| == Введение ==
| | #Зайдите на страницу ''Configs'' [[Веб-интерфейс Wiren Board|веб-интерфейса]], щёлкните по пункту ''/etc/wb-mqtt-serial.conf'' (''serial'' - название последовательных портов, RS-485 относится к ним). [[File:rs-485-setup-configs.png|thumb|center|500 px]] |
| {{note|info|С апреля 2024 года мы начали улучшать интерфейс конфигуратора, поэтому в вашем релизе софта он может немного или сильно отличаться. В этой статье описывается поведение в текущем [[testing|стабильном релизе]].}}
| | #Откроется страница настройки последовательных портов. В левой части выберите порт, к которому вы подключили устройство. Порты названы по терминологии Linux - ''/dev/ttyXXXN''; чтобы понять, как называется используемый вами, смотрите [[RS-485#Реализация портов в разных версиях Wiren Board]]. [[File:rs-485-setup-select-port.png|center|500 px|На скриншоте выбран порт Wiren Board 5, подписанный на корпусе как ''RS-485'']] |
| {{PeerTube
| | #Установите настройки порта: скорость (бит/с), количество бит в пакете, есть ли бит чётности, количество стоп-битов - эта информация указана в документации к периферийному оборудованию. Затем обязательно поставьте галочку ''Enable port'' - ''Включить порт'' (с помощью этой настройки порт можно отключить, если какое-нибудь оборудование на нём начнёт сбоить).<br>'''N.B.''' Если вы подключаете несколько устройств к одному порту контроллера, эти настройки у них должны совпадать. [[File:rs-485-setup-port-settings.png|thumb|center|500 px|Установлены настройки для релейного [[WB-MRM2]]]] |
| | link= https://peertube.wirenboard.com/video-playlists/embed/6623c76e-1abe-4728-959c-f5dde919d80c?playlistPosition=8 | | #Перейдите к разделу ''List of devices'' - ''Список устройств'' ниже. Нажмите кнопку ''+ Serial Device'', чтобы добавить устройство. Выберите тип устройства (обычно соответствует модели устройства) и укажите его адрес (обычно указывается документации к устройству, для устройств нашего производства указан на корпусе). Адрес устройства указывается либо в шестнадцатеричном виде (начинается с ''0x..''), либо в десятичном (как обычное число). Затем обязательно нажмите синюю кнопку ''Save'' - ''Сохранить'' вверху страницы. [[File:rs-485-setup-device-settings.png|thumb|center|500 px|Выбран тип устройства [[WB-MRM2]] и установлен десятичный адрес ''130'']] |
| | playlist = true
| | #Чтобы проверить работу устройства, перейдите на страницу ''Devices''. На ней должен появиться блок, соответствующий подключённому устройству. В нашем примере, появился блок ''WB-MRM2 130'' (шаблон названия - ''ТИП_УСТРОЙСТВА АДРЕС'') с двумя кнопками для управления реле, двумя индикаторами входов для кнопок и счётчиками нажатий. Можно нажать на кнопку - реле на подключённом устройстве переключится. [[File:rs-485-setup-device-connected.png|thumb|center|500 px|Отображение подключённого устройства [[WB-MRM2]] с адресом ''130'' на странице ''Devices''. Можно нажимать кнопки и управлять реле на устройстве]] |
| | text= Настройка подключённых устройств
| | #Чтобы добавить кнопку управления на главную страницу ''Home'' и назвать её соответственно назначению (например, ''Свет в коридоре''), нужно создать виджет (''Widget''). Для этого нужно перейти на страницу ''Widgets'' и нажать зелёную кнопку ''Add widget''. Затем нужно ввести параметры виджета: имя (так он называться в интерфейсе), комнату (группу, к которой привязан виджет; используется для упорядочивания, когда виджетов много - если мало, можно выбрать любую), и тип виджета - в нашем случае реле управляет освещением, поэтому выбираем ''Light Control Relay''. После этого появляется ещё одна опция - нужно выбрать, какому именно устройству соответствует виджет. Все доступные устройства выбранного типа показываются в списке, их имена даны в соответствии с терминологией [[MQTT]]. В завершении нажимаем кнопку ''Submit'' - новый виджет появится на странице ''Widgets''. [[File:rs-485-setup-add-widget.png|thumb|center|500 px|Создание виджета для управления светом на основе Реле 1 подключённого устройства [[WB-MRM2]]]] |
| }}
| |
| В контроллере для работы с устройствами есть драйвер [[wb-mqtt-serial]], в котором для каждого поддерживаемого устройства есть шаблон. Вам надо выбрать эти шаблоны в веб-интерфейсе контроллера.
| |
| | |
| Информацию о том, как проложить шину RS-485 и подключить к ней устройства, читайте на странице [[RS-485|RS-485]].
| |
| | |
| == Как зайти в веб-интерфейс ==
| |
| {{Wbincludes:How to enter}}
| |
| | |
| == Смена уровня доступа к веб-интерфейсу ==
| |
| {{Wbincludes:WebUI Change Access Level}}
| |
| | |
| == Поиск устройств Wiren Board на шине RS-485 ==
| |
| {{Wbincludes:WebUI Scan Devices}}
| |
| | |
| == Настройка порта ==
| |
| === Последовательный порт ===
| |
| Последовательный порт служит для подключения Modbus-устройств к контроллеру через шину [[RS-485]].
| |
|
| |
| Откройте веб-интерфейс и перейдите в раздел '''Settings''' → '''Configs''' → '''Serial Device Driver Configuration'''.
| |
| | |
| В левой части выберите порт, к которому вы подключили устройство. Для настройки порта нужно установить галочку '''Enable port''' и указать параметры подключения: | |
| {|class="wikitable" style="text-align:left"
| |
| ! Параметр, EN
| |
| ! Параметр, RU
| |
| ! Значение по умолчанию
| |
| |-
| |
| | Baud rate
| |
| | Скорость
| |
| | 9600
| |
| |-
| |
| | Parity
| |
| | Четность
| |
| | N
| |
| |-
| |
| | Data bits
| |
| | Биты данных
| |
| | 8
| |
| |-
| |
| | Stop bits | |
| | Количество стоп-бит | |
| | 2 | |
| |}
| |
| | |
| Значение параметров можно взять из документации на оборудование. В колонке «По умолчанию» указаны заводские параметры для подключения к оборудованию Wiren Board.
| |
| | |
| К одному порту можно подключить несколько устройств, но в этом случае параметры подключения на всех устройствах должны совпадать.
| |
| | |
| После указания настроек подключения можете продолжить редактирование других параметров или нажмите кнопку '''Save''' вверху страницы для сохранения изменений.
| |
| | |
| <gallery widths=400px heights=240px perrow=2>
| |
| Image: webui2. Settings → Configs.png | Выберите ''Serial Device Driver Configuration''
| |
| Image: webui2. Settings → Configs → Serial Device Driver Configuration.png | Выберите нужный serial-порт, включите его и укажите настройки подключения: ''Baud rate'', ''Parity'', ''Data bits'', ''Stop bits''
| |
| </gallery>
| |
| | |
| === TCP-порт ===
| |
| TCP-порт служит для подключения устройств по протоколам ''TCP port (Serial over TCP)'' или ''MODBUS TCP Port'', например, WB-MGE или WB-MIO-E.
| |
| | |
| Чтобы добавить новый TCP-порт:
| |
| # Перейдите в раздел '''Settings''' → '''Configs''' → '''Serial Device Driver Configuration'''.
| |
| # Нажмите кнопку '''+Port'''.
| |
| # В зависимости от протокола, укажите тип порта '''TCP port (Serial over TCP)''' или '''MODBUS TCP Port'''.
| |
| # В поле IPv4 введите IP-адрес сервера.
| |
| # В поле '''TCP port number''', введите номер TCP-порта сервера.
| |
| # Нажмите слева вверху кнопку '''Save'''.
| |
| | |
| <gallery mode="packed" widths=200px heights=200px perrow=2> | |
| Image: webui2. Settings → Configs.png | Выберите ''Serial Device Driver Configuration''
| |
| Image: Wiren Board WebUI configs modbus-tcp-port.png | Добавьте новый порт, выберите один из типов: ''TCP port (Serial over TCP)'' или ''MODBUS TCP Port'', укажите IP-адрес и TCP-порт сервера
| |
| </gallery>
| |
| | |
| == Добавление устройств ==
| |
| | |
| Чтобы добавить устройство в веб-интерфейс, перейдите в [[#Настройка порта | настройках порта]] в раздел '''Devices attached to the port''' и нажмите кнопку '''+Device'''.
| |
| | |
| Для всех устройств Wiren Board и некоторых устройств сторонних производителей, в поставке ПО контроллера Wiren Board есть шаблоны, которые облегчают настройку устройства. Список поддерживаемых сторонних устройств можно посмотреть в таблице [[Поддерживаемые_устройства#Протестированные устройства сторонних производителей | Протестированные устройства сторонних производителей]], если у устройства есть шаблон, то он будет указан в колонке «Драйвер / название шаблона».
| |
| | |
| Modbus-адрес (Slave id) устройств Wiren Board устанавливается с завода и указан в наклейке на корпусе устройства. Также адреса устройств можно узнать если выполнить сканирование шины в веб-интерфейсе контроллера в разделе '''Settings → Scan'''. Там же можно получить список всех устройств Wiren Board, подключенных к шине RS-485 с их серийными номерами, настройками соединения и версиями прошивок. Если адреса дублируются их нужно [[Определение и изменение Modbus-адреса устройств Wirenboard |изменить]].
| |
| | |
| === Устройство с шаблоном ===
| |
| Если у подключаемого устройства есть шаблон, то это облегчает настройку:
| |
| # В поле Device N, где N — порядковый номер устройства в списке, выберите в выпадающем списке шаблон устройства. | |
| # Укажите его адрес в поле '''Slave id'''.
| |
| # Сохраните изменения в настройках — нажмите кнопку '''Save''' в верхней части окна.
| |
| | |
| === Устройство без шаблона ===
| |
| {{Anchor|without-template}}
| |
| Если шаблона вашего устройства нет в списке, вы можете добавить устройство вручную или [[Connecting_Third_Party_Devices_to_Wiren_Board | составить свой шаблон]] и загрузить его на контроллер.
| |
| | |
| Чтобы подключить устройство без шаблона:
| |
| # Выберите шаблон <code>Custom device</code>.
| |
| # Укажите его адрес в поле '''Slave id'''.
| |
| # Опишите каналы устройства:
| |
| #* Нажмите кнопку '''Properties'''.
| |
| #* Установите флажок '''Custom channels'''.
| |
| #* В описании устройства появится раздел ''Custom channels''.
| |
| #* Теперь нужно добавить пользовательский канал, для этого в разделе '''Custom channels''' нажмите на кнопку '''+Channel'''.
| |
| #* Введите имя контрола в веб-интерфейсе и другие параметры канала.
| |
| # Сохраните изменения в настройках — нажмите кнопку '''Save''' в верхней части окна.
| |
| | |
| <gallery mode="packed" widths=200px heights=200px perrow=2>
| |
| Image: webui2. Serial Device Driver Configuration. Add new device.png | Нажмите кнопку ''+Device'', чтобы добавить новое serial-устройство</code>
| |
| Image: webui2. Serial Device Driver Configuration. WB-MSW3.png | Веб-интерфейс: основные настройки датчика [[WB-MSW v.3]]
| |
| </gallery>
| |
| | |
| == Проверка работы ==
| |
| Проверить работу [[#Добавление устройств | добавленного в веб-интерфейс]] устройства можно на вкладке '''Devices''', после [[#Добавление устройств | добавления устройства в веб-интерфейс]] на ней появится блок с этим устройством. Если вашего устройства там нет — проверьте [[#Настройка порта | параметры подключения]] и адрес самого устройства.
| |
| | |
| <gallery mode="packed" widths=200px heights=200px perrow=2>
| |
| Image: webui2. Serial Device Driver Configuration. Save config.png | Перед переходом на вкладку ''Devices'' не забудьте сохранить настройки
| |
| Image: webui2. Devices WB-MSW3.png | Датчик [[WB-MSW v.3]] в веб-интерфейсе на вкладке ''Devices''
| |
| </gallery>
| |
| | |
| == Отключение каналов, смена режимов и настройка параметров ==
| |
| {{Anchor|poll-settings}}
| |
| В веб-интерфейсе вы можете:
| |
| * Отключать опрос тех каналов устройства, которые вы не используете — это снизит нагрузку на шину [[RS-485]].
| |
| * Выбирать режимы работы входов или выходов.
| |
| * Настраивать дополнительные параметры устройства, например, частоту PWM в диммерах.
| |
| | |
| <gallery widths=180px heights=150px perrow=4 caption="Настройки модуля WB-MRGBW-D в веб-интерфейсе контроллера Wiren Board">
| |
| Image: WB-MRGBW-D Webui configs Inputs.png | Настройка входов
| |
| Image: WB-MRGBW-D Webui configs Channels rgb+w.png | Настройка выходов
| |
| Image: WB-MRGBW-D Webui configs Channels Independent.png | Настройка скорости обмена
| |
| Image: WB-MRGBW-D Webui configs HW Info.png | Информация об устройстве
| |
| </gallery>
| |
| | |
| == Дополнительные параметры устройства ==
| |
| Дополнительные параметры устройства передаются устройству при перезапуске [[Wb-mqtt-serial driver | wb-mqtt-serial]] или при восстановлении связи с устройством.
| |
| | |
| === Параметры, указанные в шаблоне (parameters-секция) ===
| |
| Если в шаблоне заполнена parameters-секция, то при выборе шаблона, в настройках устройства появится раздел '''Device options''', который будет содержать указанные в [[Wb-mqtt-serial templates#Секция параметров (parameters-секция) | шаблоне параметры]].
| |
| | |
| По умолчанию все параметры отключены и для передачи на устройство их нужно включить. Чтобы включить параметр, установите флажок напротив названия.
| |
| | |
| После сохранения настроек включенные параметры будут записаны в устройство.
| |
| | |
| <gallery mode="packed" widths=200px heights=200px perrow=2>
| |
| Image: webui2. WB-MR14 Device Options in template (parameters-section).png | Параметры инициализации устройства (parameters-секция) в файле шаблона
| |
| Image: webui2. WB-MR14 Device Options.png | Параметры инициализации устройства (parameters-секция) в веб-интерфейсе
| |
| </gallery>
| |
| | |
| === Пользовательские параметры ===
| |
| Если у устройства нет шаблона или в шаблоне не указаны нужные вам настройки инициализации, то вы можете добавить пользовательские параметры прямо из веб-интерфейса:
| |
| # Нажмите в описании устройства кнопку '''Properties'''.
| |
| # Поставьте флажок '''Custom setup commands'''. После этого появится раздел ''Custom setup commands''.
| |
| # В разделе '''Custom setup commands''' нажмите кнопку '''+Setup command'''.
| |
| # Заполните поля:
| |
| #* Command name — имя команды. Используется для записи в журналы и отладки.
| |
| #* Address — адрес регистра, куда записывать значение.
| |
| #* Value — значение, которое нужно записать для инициализации устройства.
| |
| | |
| После внесения изменений сохраните настройки.
| |
| | |
| <gallery mode="packed" widths=200px heights=200px perrow=2>
| |
| Image: webui2. Device Custom setup commands.png | Включение отображения пользовательских команд инициализации
| |
| Image: webui2. WB-MR14 No contacts.png | Создание пользовательской команды инициализации реле [[WB-MR14 Modbus 14 Channel Relay Module | WB-MR14]]
| |
| </gallery>
| |
| | |
| == Настройка периода опроса ==
| |
| {{note|warn| В свежих версиях прошивок некоторые регистры поддерживают события, которые являются частью расширения [[Modbus#%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D0%B5%20%D0%BF%D1%80%D0%BE%D1%82%D0%BE%D0%BA%D0%BE%D0%BB%D0%B0%20Modbus%20%D0%BE%D1%82%20Wiren%20Board | Быстрый Modbus]]⚡. События опрашиваются широковещательными командами, поэтому для каналов поддерживающих события период опроса задать нельзя, а соответсвующее поле в веб-интерфейсе служит для изменения приоритета опроса событий.}}
| |
| {{Anchor|poll-period}}
| |
| Вы можете задать желаемый период опроса и драйвер будет стараться его выдержать, а если заданный период выдержать не получится — он сообщит об этом в карточке устройства.
| |
| | |
| Точная настройка периода опроса может быть полезна, если какие-то каналы нужно опрашивать часто. Значения, которые можно указать, зависят от количества каналов, которые надо опрашивать быстро, обычно это: от 200 до 500 мс на канал. Не рекомендуем использовать эту настройку для замедления опроса каналов, например, установки значений в десятки секунд — это может сильно замедлить работу драйвера, так как он не сможет оптимизировать запросы по своему усмотрению.
| |
| | |
| Чтобы указать период опроса, перейдите в веб-интерфейсе в настройки драйвера serial-устройств и укажите желаемое значение для любого канала.
| |
| | |
| Рекомендации:
| |
| * Поднимите скорость шины до 115 200 бит/с, [[UART_Communication_Settings#Изменение скорости обмена|инструкция]].
| |
| * Для ускорения опроса рекомендуем устанавливать период не меньше 100–300 мс и не более, чем для 10-15 каналов на порт. Здесь нужно учитывать, что драйвер оптимизирует запросы, например, состояние всех шести входов одного реле он может считать за один раз, а значит максимальное количество каналов нужно подбирать опытным путём и оно может быть сильно больше 15 штук.
| |
| * Проверьте, чтобы в записях драйвера wb-mqtt-serial в [[Wiren_Board_Web_Interface#logs | системном журнале]] не было ошибок, предупреждений и информации о недоступных устройствах. Если вы физически отключили какое-то устройство, то выключите его опрос в настройках драйвера.
| |
| * Если вы столкнулись с тем, что желаемый период выдержать не получается — увеличьте период опроса или пересмотрите количество каналов.
| |
| | |
| Для каналов управления менять период опроса имеет смысл только, если вам нужно быстро получить их состояние. Команду управления в устройство драйвер отправляет вне очереди, при первой возможности.
| |
| | |
| <gallery mode="packed" heights="260px" caption="Настройка периода опроса">
| |
| Image: Poll Period wb-mqtt-serial in Settings.png | Выбор периода для опроса канала
| |
| Image: Poll Period wb-mqtt-serial in Devices.png | Предупреждение о том, что период опроса канала ''Input 1'' выдержать не получается
| |
| </gallery>
| |
| | |
| == Полезные ссылки ==
| |
| * [[Wb-mqtt-serial driver| Описание драйвера wb-mqtt-serial в нашей вики]]
| |
| * [[Wb-mqtt-serial templates| Описание шаблонов и примеры]]
| |