Wiren Board Web Interface: различия между версиями
(не показаны 92 промежуточные версии 4 участников) | |||
Строка 1: | Строка 1: | ||
{{DISPLAYTITLE: Веб-интерфейс Wiren Board}} | |||
{{DISPLAYTITLE: Веб-интерфейс | [[Файл:Web-Home-2.0.png|thumb|700 px|Главная страница веб-интерфейса]] | ||
== Возможности == | |||
Контроллер Wiren Board имеет встроенный веб-интерфейс. | |||
Через интерфейс можно: | |||
*следить за состоянием контроллера и подключённых устройств и управлять ими; | |||
*подключать устройства к контроллеру; | |||
*настраивать контроллер и обновлять его ПО; | |||
*писать правила на встроенном движке; | |||
*настраивать SMS и email-уведомления; | |||
*смотреть на графике историю значений (например, температуры). | |||
Веб-интерфейс работает непосредственно на Wiren Board. В качестве веб-сервера работает [http://nginx.org nginx], сайт взаимодействует с MQTT через [http://en.wikipedia.org/wiki/WebSocket WebSocket]. | |||
В качестве веб-сервера работает [http://nginx.org nginx], сайт взаимодействует с MQTT через [http://en.wikipedia.org/wiki/WebSocket WebSocket]. | |||
Ниже дано описание версии 2.0. Про предыдущую версию можно найти на странице [[Веб-интерфейс_Wiren_Board_1.0| Веб-интерфейс Wiren Board 1.0]]. | |||
== Как зайти в веб-интерфейс == | == Как зайти в веб-интерфейс == | ||
{{Wbincludes:How to enter}} | {{Wbincludes:How to enter}} | ||
== Смена уровня доступа == | == Смена уровня доступа == | ||
{{Wbincludes:WebUI Change Access Level}} | {{Wbincludes:WebUI Change Access Level}} | ||
== | == Подключённые устройства == | ||
{{Anchor|devices}} | {{Anchor|devices}} | ||
На странице | На странице «Устройства» находятся виртуальные представления физически подключённых к контроллеру устройств или виртуальных устройств, созданных скриптами [[wb-rules]]. | ||
Каждое устройства представлено карточкой, которая содержит каналы устройства — контролы. Если нажать на название контрола, то вы получите путь вида <code>device/control</code>, который можно использовать при написании скриптов на wb-rules. | Каждое устройства представлено карточкой, которая содержит каналы устройства — контролы. Если нажать на название контрола, то вы получите путь вида <code>device/control</code>, который можно использовать при написании скриптов на wb-rules. | ||
Не используйте эту страницу для управления системой автоматизацией, для этого есть панели. | Не используйте эту страницу для управления системой автоматизацией, для этого есть панели. | ||
<gallery mode="packed" heights="150px"> | <gallery mode="packed" heights="150px"> | ||
Image: Web-Devices-2.0.png | Список устройств, подключённых к контроллеру | Image: Web-Devices-2.0.png | Список устройств, подключённых к контроллеру | ||
Строка 48: | Строка 34: | ||
</gallery> | </gallery> | ||
== Интерактивные панели и виджеты == | == Интерактивные панели и виджеты == | ||
=== Панели === | === Панели === | ||
{{Anchor|dashboards}} | {{Anchor|dashboards}} | ||
Каналы различных устройств можно объединять в виджеты, из которых потом создаются текстовые панели. Например, можно сделать один виджет «Климат», в котором будут: температура, влажность, переключатели управления вентиляцией, обогревом и кондиционером. | |||
Также веб-интерфейс позволяет создавать интерактивные [[SVG-Dashboards | интерактивные графические SVG-панели]], которые можно вывести на планшет и использовать как пульт управления автоматизацией. | |||
<gallery mode="packed" heights="150px"> | <gallery mode="packed" heights="150px"> | ||
Image: Web-Dashboards-2.0.png | Список панелей | Image: Web-Dashboards-2.0.png | Список панелей | ||
Строка 64: | Строка 47: | ||
</gallery> | </gallery> | ||
=== Виджеты === | === Виджеты === | ||
{{Anchor|widgets}} | {{Anchor|widgets}} | ||
С помощью виджетов удобно объединять контролы разных устройств по смыслу, или местонахождению. Например, можно сделать виджет для | С помощью виджетов удобно объединять контролы разных устройств по смыслу, или местонахождению. Например, можно сделать виджет для управление освещением в спальне, или виджет климата в магазине. | ||
Проще всего виджеты добавлять сразу на панель управления кнопкой «Добавить виджет», а потом воспользоваться конструктором или описать виджет в формате JSON. | |||
<gallery mode="packed" heights="100px"> | |||
<gallery mode="packed" heights=" | Image: widget-create-1.png | Добавление виджета на панель | ||
Image: widget-create-1.png | | |||
Image: widget-create-2.png | Конструктор виджета | Image: widget-create-2.png | Конструктор виджета | ||
Image: widget-create-2.2.png | Вид JSON | Image: widget-create-2.2.png | Вид JSON | ||
Строка 81: | Строка 61: | ||
</gallery> | </gallery> | ||
== История == | |||
== История | |||
{{Anchor|history}} | {{Anchor|history}} | ||
По умолчанию стандартное ПО контроллера хранит все полученные данные, которые вы можете посмотреть в виде графиков или таблицы. Данные можно выгрузить в csv, для этого нажмите на кнопку под графиком, или воспользуйтесь утилитой [[Wb-mqtt-db-cli|wb-mqtt-db-cli]]. | |||
По умолчанию стандартное ПО контроллера хранит все полученные данные, которые вы можете посмотреть в виде графиков или таблицы. Данные можно выгрузить в csv, для этого нажмите на кнопку под графиком, или воспользуйтесь утилитой [ | |||
Возможности отображения: | Возможности отображения: | ||
* выбор периода; | * выбор периода; | ||
Строка 192: | Строка 71: | ||
* масштабирование; | * масштабирование; | ||
* снятие скриншота; | * снятие скриншота; | ||
* курсорные измерения. | * курсорные измерения. | ||
Если вам надо больше возможностей, вы можете настроить автоматический экспорт данных в [[Grafana]]. | |||
Если | |||
<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 | Табличное представление | ||
Строка 229: | Строка 82: | ||
</gallery> | </gallery> | ||
== Скрипты автоматизации == | == Скрипты автоматизации == | ||
{{Anchor|rules}} | {{Anchor|rules}} | ||
В веб-интерфейсе контроллера есть редактор скриптов [[wb-rules]], который позволяет создавать, редактировать и удалять правила. Если в скрипте есть ошибки, то редактор сообщит вам об этом и укажет место в скрипте. | В веб-интерфейсе контроллера есть редактор скриптов [[wb-rules]], который позволяет создавать, редактировать и удалять правила. Если в скрипте есть ошибки, то редактор сообщит вам об этом и укажет место в скрипте. | ||
Редактор доступен в разделе '''Правила'''. | |||
Редактор доступен в разделе '''Правила''' | |||
<gallery mode="packed" heights="150px"> | <gallery mode="packed" heights="150px"> | ||
Image: Web-Rules-2.0.png | Редактор скриптов | Image: Web-Rules-2.0.png | Редактор скриптов | ||
Строка 266: | Строка 94: | ||
</gallery> | </gallery> | ||
== Настройка контроллера и подключённых устройств == | == Настройка контроллера и подключённых устройств == | ||
{{Anchor|settings}} | {{Anchor|settings}} | ||
[[Image: Web-Configs-2.0.png |300px|thumb|right| Конфигурационные файлы ]] | [[Image: Web-Configs-2.0.png |300px|thumb|right| Конфигурационные файлы ]] | ||
Контроллер Wiren Board работает на Linux, поэтому почти все настройки хранятся в конфигурационных файлах. Файлы можно редактировать через [[SSH]] или с помощью веб-конфигуратора. | Контроллер Wiren Board работает на Linux, поэтому почти все настройки хранятся в конфигурационных файлах. Файлы можно редактировать через [[SSH]] или с помощью веб-конфигуратора. | ||
Список доступных настроек вы найдёте в разделе ''' Настройки''' → '''Конфигурационные файлы'''. | Список доступных настроек вы найдёте в разделе ''' Настройки''' → '''Конфигурационные файлы'''. | ||
== Настройка веб-интерфейса == | |||
{{Anchor|webui}} | |||
[[Image: Web-Configs-2.0 webui.png |300px|thumb|right| Настройки веб-интерфейса ]] | |||
== | В разделе '''Настройки''' → '''Веб-интерфейс''' можно настроить подключение к MQTT-брокеру, выбрать панель для домашней страницы и сменить язык веб-интерфейса. | ||
{{Anchor| | |||
== Обновление | == Обновление контроллера и выгрузка диагностической информации == | ||
{{Anchor|diagnostic}} | {{Anchor|diagnostic}} | ||
Обновить ПО контроллера без доступа к интернету можно через веб-интерфейс, для этого вам понадобится компьютер и заранее загруженный fit-файл прошивки. Подробнее про обновление ПО контроллера читайте в [[Wiren Board Firmware Update| инструкции]]. | |||
Обновить ПО контроллера без доступа к интернету можно через веб-интерфейс, для этого вам понадобится компьютер и заранее загруженный fit-файл прошивки. Подробнее про обновление ПО контроллера читайте | |||
Если в работе контроллера возникли ошибки, то при обращении в техническую поддержку рекомендуем выгрузить диагностический архив — это поможет нам быстрее разобраться в проблеме. Также рекомендуем попробовать советы из статьи [[How_to_diagnose | Диагностика ошибок в работе контроллера Wiren Board]] | |||
[[Image: Web-Configs-2.0 system.png |400px]] | |||
== Просмотр MQTT-каналов и системного журнала == | |||
<gallery mode="packed" heights="120px"> | <gallery mode="packed" heights="120px"> | ||
Image:Web-Configs-2.0 mqtt.png| MQTT-каналы | Image:Web-Configs-2.0 mqtt.png| MQTT-каналы | ||
Строка 329: | Строка 120: | ||
</gallery> | </gallery> | ||
== | == Стандартные задачи, решаемые через веб-интерфейс == | ||
== | === Подключить устройство RS-485 Modbus и создать кнопки управления на главной панели === | ||
[[RS-485:Настройка через веб-интерфейс]] | |||
===Обновить прошивку контроллера=== | |||
[[Wiren_Board_Firmware_Update#Обновление через веб-интерфейс|Обновление прошивки через веб-интерфейс]] | |||
== Настройка авторизованного доступа к веб-интерфейсу контроллера == | |||
В статье [[Защита_паролем|Защита паролем]] приводятся краткие инструкции по перенастройке контроллера, обеспечивающие авторизованный доступ к веб-интерфейсу контроллера. | |||
== Основные отличия версии 2.x от 1.0 == | |||
* Каждый виджет может содержать произвольное число каналов, в виджете каналы можно переименовывать | |||
* | * Отдельные устройства теперь автоматически сворачиваются в виде плиток, если не помещаются на экране. Плитки можно развернуть или свернуть | ||
* Появились уровни доступа к интерфейсу (пользователь, оператор, администратор). Текущий уровень доступа отображается в правом верхнем углу интерфейса, рядом со значком состояния подключения | |||
* Улучшенный интерфейс для мобильных устройств | |||
* По клику на канал или значение название канала или его значение копируются в буфер обмена | |||
* Историю значений можно посмотреть, нажав на кнопку, появляющуюся рядом со значением при наведении | |||
* Историю значений можно скачивать в виде текстового файла | |||
* Исторические данные загружаются постепенно; возможно сравнивать значения нескольких каналов | |||
* Удаление лишних MQTT-топиков из интерфейса | |||
* Все настройки отображения теперь хранятся в конфиг-файле /etc/wb-ui.conf в формате JSON. Теперь их можно редактировать и генерировать из сторонних программ и очень просто копировать с одного контроллера на другой | |||
* Отсутствуют "Комнаты" | |||
* Сохранение конфигурации интерфейса при обновлении предыдущей версии веб-интерфейса. |
Версия 13:14, 2 августа 2022
Возможности
Контроллер Wiren Board имеет встроенный веб-интерфейс. Через интерфейс можно:
- следить за состоянием контроллера и подключённых устройств и управлять ими;
- подключать устройства к контроллеру;
- настраивать контроллер и обновлять его ПО;
- писать правила на встроенном движке;
- настраивать SMS и email-уведомления;
- смотреть на графике историю значений (например, температуры).
Веб-интерфейс работает непосредственно на Wiren Board. В качестве веб-сервера работает nginx, сайт взаимодействует с MQTT через WebSocket.
Ниже дано описание версии 2.0. Про предыдущую версию можно найти на странице Веб-интерфейс Wiren Board 1.0.
Как зайти в веб-интерфейс
Чтобы зайти в веб-интерфейс контроллера Wiren Board, подключитесь к контроллеру через Wi-Fi или Ethernet и введите в адресную строку браузера IP-адрес контроллера.
Если вы находитесь в одной сети с контроллером и используете компьютер с Linux, Windows 10 и выше или macOS, или любое устройство Apple, то можно использовать mDNS. Вместо IP-адреса введите в адресную строку http://wirenboard-XXXXXXXX.local, где ХХХХХХХХ — серийный номер контроллера.
Также доступ можно получить через Wiren Board Cloud, если контроллер к нему подключен.
Смена уровня доступа
Для изменения настроек контроллера вам нужен уровень доступа Администратор, который можно выставить в разделе Настройки → Права доступа.
После завершения настроек рекомендуем поставить уровень доступа Пользователь или Оператор — это поможет не совершить случайных ошибок при ежедневной работе с веб-интерфейсом.
Подключённые устройства
На странице «Устройства» находятся виртуальные представления физически подключённых к контроллеру устройств или виртуальных устройств, созданных скриптами wb-rules.
Каждое устройства представлено карточкой, которая содержит каналы устройства — контролы. Если нажать на название контрола, то вы получите путь вида device/control
, который можно использовать при написании скриптов на wb-rules.
Не используйте эту страницу для управления системой автоматизацией, для этого есть панели.
Интерактивные панели и виджеты
Панели
Каналы различных устройств можно объединять в виджеты, из которых потом создаются текстовые панели. Например, можно сделать один виджет «Климат», в котором будут: температура, влажность, переключатели управления вентиляцией, обогревом и кондиционером.
Также веб-интерфейс позволяет создавать интерактивные интерактивные графические SVG-панели, которые можно вывести на планшет и использовать как пульт управления автоматизацией.
Виджеты
С помощью виджетов удобно объединять контролы разных устройств по смыслу, или местонахождению. Например, можно сделать виджет для управление освещением в спальне, или виджет климата в магазине.
Проще всего виджеты добавлять сразу на панель управления кнопкой «Добавить виджет», а потом воспользоваться конструктором или описать виджет в формате JSON.
История
По умолчанию стандартное ПО контроллера хранит все полученные данные, которые вы можете посмотреть в виде графиков или таблицы. Данные можно выгрузить в csv, для этого нажмите на кнопку под графиком, или воспользуйтесь утилитой wb-mqtt-db-cli.
Возможности отображения:
- выбор периода;
- одновременный просмотр нескольких каналов;
- масштабирование;
- снятие скриншота;
- курсорные измерения.
Если вам надо больше возможностей, вы можете настроить автоматический экспорт данных в Grafana.
Скрипты автоматизации
В веб-интерфейсе контроллера есть редактор скриптов wb-rules, который позволяет создавать, редактировать и удалять правила. Если в скрипте есть ошибки, то редактор сообщит вам об этом и укажет место в скрипте.
Редактор доступен в разделе Правила.
Настройка контроллера и подключённых устройств
Контроллер Wiren Board работает на Linux, поэтому почти все настройки хранятся в конфигурационных файлах. Файлы можно редактировать через SSH или с помощью веб-конфигуратора.
Список доступных настроек вы найдёте в разделе Настройки → Конфигурационные файлы.
Настройка веб-интерфейса
В разделе Настройки → Веб-интерфейс можно настроить подключение к MQTT-брокеру, выбрать панель для домашней страницы и сменить язык веб-интерфейса.
Обновление контроллера и выгрузка диагностической информации
Обновить ПО контроллера без доступа к интернету можно через веб-интерфейс, для этого вам понадобится компьютер и заранее загруженный fit-файл прошивки. Подробнее про обновление ПО контроллера читайте в инструкции.
Если в работе контроллера возникли ошибки, то при обращении в техническую поддержку рекомендуем выгрузить диагностический архив — это поможет нам быстрее разобраться в проблеме. Также рекомендуем попробовать советы из статьи Диагностика ошибок в работе контроллера Wiren Board
Просмотр MQTT-каналов и системного журнала
Стандартные задачи, решаемые через веб-интерфейс
Подключить устройство RS-485 Modbus и создать кнопки управления на главной панели
RS-485:Настройка через веб-интерфейс
Обновить прошивку контроллера
Обновление прошивки через веб-интерфейс
Настройка авторизованного доступа к веб-интерфейсу контроллера
В статье Защита паролем приводятся краткие инструкции по перенастройке контроллера, обеспечивающие авторизованный доступ к веб-интерфейсу контроллера.
Основные отличия версии 2.x от 1.0
- Каждый виджет может содержать произвольное число каналов, в виджете каналы можно переименовывать
- Отдельные устройства теперь автоматически сворачиваются в виде плиток, если не помещаются на экране. Плитки можно развернуть или свернуть
- Появились уровни доступа к интерфейсу (пользователь, оператор, администратор). Текущий уровень доступа отображается в правом верхнем углу интерфейса, рядом со значком состояния подключения
- Улучшенный интерфейс для мобильных устройств
- По клику на канал или значение название канала или его значение копируются в буфер обмена
- Историю значений можно посмотреть, нажав на кнопку, появляющуюся рядом со значением при наведении
- Историю значений можно скачивать в виде текстового файла
- Исторические данные загружаются постепенно; возможно сравнивать значения нескольких каналов
- Удаление лишних MQTT-топиков из интерфейса
- Все настройки отображения теперь хранятся в конфиг-файле /etc/wb-ui.conf в формате JSON. Теперь их можно редактировать и генерировать из сторонних программ и очень просто копировать с одного контроллера на другой
- Отсутствуют "Комнаты"
- Сохранение конфигурации интерфейса при обновлении предыдущей версии веб-интерфейса.