Wiren Board Web Interface: различия между версиями
(добавил wb-mqtt-homeui) |
|||
(не показано 40 промежуточных версий 4 участников) | |||
Строка 1: | Строка 1: | ||
<languages/><translate> | <languages/><translate> | ||
{{DISPLAYTITLE: Веб-интерфейс контроллеров Wiren Board | {{DISPLAYTITLE: Веб-интерфейс контроллеров Wiren Board}} | ||
== Общая информация == <!--T:1--> | == Общая информация == <!--T:1--> | ||
{{Anchor|features}} | {{Anchor|features}} | ||
В контроллерах Wiren Board есть встроенный веб-интерфейс, который позволяет выполнить большинство задач по настройке контроллера, встроенного ПО и подключённых устройств. Исходный код открыт и доступен в [https://github.com/wirenboard/ нашем репозитории]. | В контроллерах Wiren Board есть встроенный веб-интерфейс, который позволяет выполнить большинство задач по настройке контроллера, встроенного ПО и подключённых устройств. Исходный код открыт и доступен в [https://github.com/wirenboard/ нашем репозитории]. | ||
Строка 81: | Строка 76: | ||
</gallery> | </gallery> | ||
== | === Режим киоска === <!--T:42--> | ||
{{Anchor|kiosk}} | |||
<!--T: | |||
{{Anchor| | |||
{{SupportedSinceRelease | {{SupportedSinceRelease | ||
| release = wb- | | release = wb-2207 | ||
|content= | |content= | ||
Если вы используете обычный планшет в качестве панели управления и выводите на него веб-интерфейс контроллера, то будет полезно скрыть лишние элементы и окно браузера: | |||
# Откройте панель и нажмите кнопку '''Открыть в полноэкранном режиме'''. | |||
# Скопируйте в адресной строке браузера URL панель, на конце должен быть параметр <code>?fullscreen</code>. | |||
# Запустите браузер в режиме киоска и передайте ему параметром URL панели, примеры: | |||
#:<syntaxhighlight lang="bash"> | |||
irefox -kiosk 'http://wirenboard-ascmdm6q.local/#!/dashboards/dashboard1?fullscreen' | |||
chromium -kiosk 'http://wirenboard-ascmdm6q.local/#!/dashboards/dashboard1?fullscreen' | |||
<syntaxhighlight lang=" | |||
http:// | |||
http:// | |||
</syntaxhighlight> | </syntaxhighlight> | ||
<!--T:43--> | |||
Это работает для всех типов панелей. | |||
<!--T:44--> | |||
< | <gallery mode="packed" heights="150px"> | ||
Image: Text-Dashboard full screen.png | Переход в полноэкранный режим | |||
Image: Text-Dashboard full screen 2.png | Полноэкранный режим | |||
Image: Text-Dashboard full screen 3.png | Режим киоска | |||
<gallery mode="packed" heights="150px | |||
Image: | |||
Image: | |||
Image: | |||
</gallery> | </gallery> | ||
}} | }} | ||
Строка 192: | Строка 117: | ||
* масштабирование; | * масштабирование; | ||
* снятие скриншота; | * снятие скриншота; | ||
* курсорные измерения. | * курсорные измерения. | ||
<!--T:23--> | <!--T:23--> | ||
Если | Если вам надо больше возможностей, вы можете настроить автоматический экспорт данных в [[Grafana]]. | ||
<!--T:24--> | <!--T:24--> | ||
<gallery mode="packed" heights="100px | <gallery mode="packed" heights="100px"> | ||
Image: Web-History-Web-2.0.png | График | Image: Web-History-Web-2.0.png | График | ||
Image: Web-History-Web-2.0 1.png | Табличное представление | Image: Web-History-Web-2.0 1.png | Табличное представление | ||
Строка 236: | Строка 137: | ||
<!--T:27--> | <!--T:27--> | ||
Редактор доступен в разделе '''Правила''' | Редактор доступен в разделе '''Правила'''. | ||
<!--T:28--> | <!--T:28--> | ||
Строка 276: | Строка 155: | ||
<!--T:31--> | <!--T:31--> | ||
Например, через веб-интерфейс можно настроить подключённые [[RS-485:Configuration via Web Interface| Modbus-устройства]], шлюзы [[KNX | KNX]] и [[Modbus RTU/TCP Slave]] и другие параметры. | Например, через веб-интерфейс можно настроить подключённые [[RS-485:Configuration via Web Interface| Modbus-устройства]], шлюзы [[KNX | KNX]] и [[Modbus RTU/TCP Slave]] и другие параметры. | ||
== Уведомления о событиях == <!--T:32--> | == Уведомления о событиях == <!--T:32--> | ||
Строка 291: | Строка 166: | ||
{{Anchor|diagnostic}} | {{Anchor|diagnostic}} | ||
[[Image: Web-Configs-2.0 system.png |300px|thumb|right| Обновление ПО и выгрузка диагностики ]] | [[Image: Web-Configs-2.0 system.png |300px|thumb|right| Обновление ПО и выгрузка диагностики ]] | ||
Обновить ПО контроллера без доступа к интернету можно через веб-интерфейс, для этого вам понадобится компьютер и заранее загруженный fit-файл прошивки. Подробнее про обновление ПО контроллера читайте | Обновить ПО контроллера без доступа к интернету можно через веб-интерфейс, для этого вам понадобится компьютер и заранее загруженный fit-файл прошивки. Подробнее про обновление ПО контроллера читайте в [[Wiren Board Firmware Update| инструкции]]. | ||
<!--T:35--> | <!--T:35--> | ||
Если в работе контроллера возникли ошибки, то при обращении в техническую поддержку рекомендуем выгрузить диагностический архив — это поможет нам быстрее разобраться в проблеме. | Если в работе контроллера возникли ошибки, то при обращении в техническую поддержку рекомендуем выгрузить диагностический архив — это поможет нам быстрее разобраться в проблеме. Если по какой-то причине выгрузить архив из веб-интерфейса не получается, воспользуйтесь консольной утилитой [https://github.com/wirenboard/wb-diag-collect wb-diag-collect]. | ||
== Просмотр MQTT-каналов и системного журнала == <!--T:36--> | == Просмотр MQTT-каналов и системного журнала == <!--T:36--> | ||
{{Anchor|mqtt-channels}} | {{Anchor|mqtt-channels}} | ||
Список MQTT-каналов пригодится при диагностике неисправностей, или при настройке интеграции со сторонним ПО, например, [[Rapid SCADA]] или [[Home Assistant]]. Список доступен в разделе '''Настройки''' → '''MQTT-каналы''' | Список MQTT-каналов пригодится при диагностике неисправностей, или при настройке интеграции со сторонним ПО, например, [[Rapid SCADA]] или [[Home Assistant]]. Список доступен в разделе '''Настройки''' → '''MQTT-каналы'''. | ||
<!--T:37--> | <!--T:37--> | ||
Строка 328: | Строка 183: | ||
Image:Web-Configs-2.0 logs.png| Системный журнал | Image:Web-Configs-2.0 logs.png| Системный журнал | ||
</gallery> | </gallery> | ||
== Управление с телефона == <!--T:45--> | == Управление с телефона == <!--T:45--> | ||
Веб-интерфейс адаптируется под размер экрана, поэтому управлять системой автоматизациии можно с мобильного устройства или планшета. | |||
Веб-интерфейс адаптируется под размер экрана, поэтому управлять системой | |||
<!--T:46--> | <!--T:46--> |
Версия 12:20, 3 августа 2022
Общая информация
В контроллерах Wiren Board есть встроенный веб-интерфейс, который позволяет выполнить большинство задач по настройке контроллера, встроенного ПО и подключённых устройств. Исходный код открыт и доступен в нашем репозитории.
В качестве веб-сервера работает nginx, сайт взаимодействует с MQTT через WebSocket.
Обзор возможностей веб-интерфейса контроллеров Wiren Board.
Как зайти в веб-интерфейс
Чтобы зайти в веб-интерфейс контроллера Wiren Board, подключитесь к контроллеру через Wi-Fi или Ethernet и введите в адресную строку браузера IP-адрес контроллера.
Если вы находитесь в одной сети с контроллером и используете компьютер с Linux, Windows 10 и выше или macOS, или любое устройство Apple, то можно использовать mDNS. Вместо IP-адреса введите в адресную строку http://wirenboard-XXXXXXXX.local, где ХХХХХХХХ — серийный номер контроллера.
Также доступ можно получить через Wiren Board Cloud, если контроллер к нему подключен.
Смена уровня доступа
Для изменения настроек контроллера вам нужен уровень доступа Администратор, который можно выставить в разделе Настройки → Права доступа.
После завершения настроек рекомендуем поставить уровень доступа Пользователь или Оператор — это поможет не совершить случайных ошибок при ежедневной работе с веб-интерфейсом.
Настройка подключения к MQTT и выбор языка
В разделе Настройки → Веб-интерфейс можно настроить подключение к MQTT-брокеру, выбрать панель для домашней страницы и сменить язык веб-интерфейса.
Веб-интерфейс не поддерживает авторизацию пользователя, но вы можете настроить http-авторизацию сервера nginx. Подробные инструкции смотрите в статье Защита веб-интерфейса контроллера паролем.
Список устройств
На странице Устройства находятся виртуальные представления физически подключённых к контроллеру устройств или виртуальных устройств, созданных скриптами wb-rules.
Каждое устройства представлено карточкой, которая содержит каналы устройства — контролы. Если нажать на название контрола, то вы получите путь вида device/control
, который можно использовать при написании скриптов на wb-rules.
Не используйте эту страницу для управления системой автоматизацией, для этого есть панели.
Интерактивные панели и виджеты
Панели
Вы можете создавать текстовые и графические SVG-панели для отображения данных и управления системой автоматизации.
Текстовая панель состоит из виджетов, а графическая — из фонового изображения с привязками к MQTT-каналам контроллера. Как сделать SVG-панель.
Виджеты
С помощью виджетов удобно объединять контролы разных устройств по смыслу, или местонахождению. Например, можно сделать виджет для управления освещением в спальне, или виджет климата в магазине. Виджеты группируются в панели, один виджет может быть добавлен в несколько панелей.
Создавать виджеты можно в разделе Виджеты, или прямо из панели. Есть визуальный конструктор и редактор JSON.
Режим киоска
Если вы используете обычный планшет в качестве панели управления и выводите на него веб-интерфейс контроллера, то будет полезно скрыть лишние элементы и окно браузера:
- Откройте панель и нажмите кнопку Открыть в полноэкранном режиме.
- Скопируйте в адресной строке браузера URL панель, на конце должен быть параметр
?fullscreen
. - Запустите браузер в режиме киоска и передайте ему параметром URL панели, примеры:
irefox -kiosk 'http://wirenboard-ascmdm6q.local/#!/dashboards/dashboard1?fullscreen' chromium -kiosk 'http://wirenboard-ascmdm6q.local/#!/dashboards/dashboard1?fullscreen'
Это работает для всех типов панелей.
История полученных данных
По умолчанию стандартное ПО контроллера хранит все полученные данные, которые вы можете посмотреть в виде графиков или таблицы. Данные можно выгрузить в csv, для этого нажмите на кнопку под графиком, или воспользуйтесь утилитой wb-mqtt-db-cli.
Для просмотра истории перейдите в раздел История и выберите нужные каналы, или наведите курсор на канал виджета и нажмите кнопку с изображением гистограммы.
Возможности отображения:
- выбор периода;
- одновременный просмотр нескольких каналов;
- масштабирование;
- снятие скриншота;
- курсорные измерения.
Если вам надо больше возможностей, вы можете настроить автоматический экспорт данных в Grafana.
Скрипты автоматизации
В веб-интерфейсе контроллера есть редактор скриптов wb-rules, который позволяет создавать, редактировать и удалять правила. Если в скрипте есть ошибки, то редактор сообщит вам об этом и укажет место в скрипте.
Редактор доступен в разделе Правила.
Настройка контроллера и подключённых устройств
Контроллер Wiren Board работает на Linux, поэтому почти все настройки хранятся в конфигурационных файлах. Файлы можно редактировать через SSH или с помощью веб-конфигуратора.
Список доступных настроек вы найдёте в разделе Настройки → Конфигурационные файлы.
Например, через веб-интерфейс можно настроить подключённые Modbus-устройства, шлюзы KNX и Modbus RTU/TCP Slave и другие параметры.
Уведомления о событиях
В веб-интерфейсе контроллера можно настроить отправку уведомления о событиях по SMS или Email, например, при срабатывании тревоги в модуле WB-MWAC, отправить SMS на заданный номер. Настройка модуля уведомлений.
Также вы можете отправлять уведомления в Телеграм, для этого нужно написать небольшой скрипт на wb-rules, пример.
Обновление прошивки и выгрузка диагностического архива
Обновить ПО контроллера без доступа к интернету можно через веб-интерфейс, для этого вам понадобится компьютер и заранее загруженный fit-файл прошивки. Подробнее про обновление ПО контроллера читайте в инструкции.
Если в работе контроллера возникли ошибки, то при обращении в техническую поддержку рекомендуем выгрузить диагностический архив — это поможет нам быстрее разобраться в проблеме. Если по какой-то причине выгрузить архив из веб-интерфейса не получается, воспользуйтесь консольной утилитой wb-diag-collect.
Просмотр MQTT-каналов и системного журнала
Список MQTT-каналов пригодится при диагностике неисправностей, или при настройке интеграции со сторонним ПО, например, Rapid SCADA или Home Assistant. Список доступен в разделе Настройки → MQTT-каналы.
Системный журнал ОС Linux можно посмотреть с помощью утилиты journalctl или в веб-интерфейсе контроллера в разделе Настройки → Системный журнал.
Управление с телефона
Веб-интерфейс адаптируется под размер экрана, поэтому управлять системой автоматизациии можно с мобильного устройства или планшета.
Альтернативой может быть использование сторонних приложений: MQTT_Dash, Home Assistant, Салют! Умный дом и других, полный список смотрите в таблице поддерживаемых устройств и программ.
Предыдущая версия
- Веб-интерфейс Wiren Board 1.0, заменён на 2.0 в начале 2021 года.