Перейти к содержанию

Навигация

Wiren Board Web Interface: различия между версиями

Wiren Board Web Interface (просмотреть исходный код)

Версия 20:09, 16 апреля 2019

18 434 байта добавлено ,  5 лет назад
Нет описания правки
(Отметить эту версию для перевода)
(не показано 177 промежуточных версий 6 участников)
Строка 2: Строка 2:
<translate>
<translate>
<!--T:1-->
<!--T:1-->
[[Special:MyLanguage/Файл:Веб-интерфейс - главная.png|thumb|600 px|Главная страница веб-интерфейса]]
[[Файл:Web-Home-2.0.png|thumb|700 px|Главная страница Web-интерфейса]]
Wiren Board имеет собственный веб-интерфейс, находящийся локально на устройстве, через который можно управлять подключёнными устройствами и следить за показаниями датчиков. Интерфейс работает в том числе на мобильных устройствах.
Контроллер Wiren Board имеет встроенный веб-интерфейс.
Через интерфейс можно:
*следить за состоянием контроллера и подключённых устройств и управлять ими;
*подключать устройства к контроллеру;
*настраивать контроллер и обновлять его ПО;
*писать правила на встроенном движке;
*настраивать SMS и email уведомления;
*смотреть на графике историю значений (например, температуры).


Веб-интерфейс работает непосредственно на Wiren Board. В качестве веб-сервера работает [http://nginx.org nginx], сайт взаимодействует с MQTT через [http://en.wikipedia.org/wiki/WebSocket WebSocket].
== Предыдущая версия Web-интерфейса ==
Начиная с апреля 2019 года на контроллерах Wiren Board устанавливается новая версия Web-интерфейса Web UI 2.0. Описание предыдущей версии можно найти на странице [[Веб-интерфейс_Wiren_Board_1.0| Веб-интерфейс Wiren Board 1.0]].
== Основные отличия новой версии ==
* Каждый виджет может содержать произвольное число каналов, в виджете каналы можно переименовывать
* Отдельные устройства теперь автоматически сворачиваются в виде плиток, если не помещаются на экране. Плитки можно развернуть или свернуть
* Появились уровни доступа к интерфейсу (пользователь, оператор, администратор). Текущий уровень доступа отображается в правом верхнем углу интерфейса, рядом со значком состояния подключения
* Улучшенный интерфейс для мобильных устройств
* По клику на канал или значение название канала или его значение копируются в буфер обмена
* Историю значений можно посмотреть, нажав на кнопку, появляющуюся рядом со значением при наведении
* Историю значений можно скачивать в виде текстового файла
* Исторические данные загружаются постепенно; возможно сравнивать значения нескольких каналов
* Удаление лишних MQTT-топиков из интерфейса
* Все настройки отображения теперь хранятся в конфиг-файле /etc/wb-ui.conf в формате JSON. Теперь их можно редактировать и генерировать из сторонних программ и очень просто копировать с одного контроллера на другой
* Отсутствуют "Комнаты"
* Сохранение конфигурации интерфейса при обновлении с предыдущей версии Web-интерфейса.


== Как зайти в веб-интерфейс == <!--T:2-->
== Как зайти в веб-интерфейс == <!--T:2-->


<!--T:3-->
<!--T:3-->
Просто введите в адресную строку браузера IP-адрес контроллера. Также смотрите статью [[Special:MyLanguage/Как узнать IP-адрес контроллера|Как узнать IP-адрес контроллера]].
Просто введите в адресную строку браузера IP-адрес контроллера ([[Как узнать IP-адрес контроллера|как узнать IP-адрес контроллера]]). Если вы заходите с устройства Apple или компьютера с Linux и находитесь в одной сети с контроллером, введите в адресную строку ''wirenboard-XXXXXXXX.local'', где ХХХХХХХХ - восьмизначный серийный номер контроллера. ( в старых версиях контроллера доступ осуществлялся через адрес  ''wirenboard.local'').
 
== Работа с Web-интерфейсом ==
[[File:Web-Acess_Level-2.0.png|thumb|center|600 px|Выбор уровня доступа]]
 
Для начала работы с Web-интерфейсом выберите уровень доступа. Для этого на вкладке '''Settings -> Change access level -> Acess Level''' выберите один из пунктов '''User, Operator''' или '''Administrator'''.
Уровни ограничивают доступ к функционалу Web-интерфейса: например пользователь '''User''' может просматривать только настроенный виджеты, их редактирование и изменение настроек контроллера недоступно. Пользователь '''Operator''' получает доступ к контролам устройств, управляемых контроллером, может добавлять виджеты в панели (dashboards) (см. далее). Пользователь '''Administrator''' обладает всеми правами. Изменение текущего уровня доступа может быть изменено любым пользователем и предназначено больше для защиты от неверных действий, чем для разграничения прав.  


В дальнейшем изложении мы предполагаем, что все действия выполняются пользователем '''Administrator'''.


== Структура интерфейса == <!--T:4-->
Чтобы получить уровень доступа '''Administrator''', на вкладке '''Access Level''' выберите опцию '''Administrator''', подтвердите выбор, установив флажок в поле '''"I take full responsibility for my actions"''', и нажмите кнопку '''Apply''' (как показано на рисунке "Выбор уровня доступа").


<!--T:5-->
== Разделы интерфейса == <!--T:4-->
В интерфейсе есть 6 разделов:


=== Home (Главная страница) === <!--T:6-->
=== Home (Главная страница) === <!--T:6-->
[[File:Web-Home-2.0.png|thumb|center|600 px|Home - главная страница]]


<!--T:7-->
<!--T:7-->
Это главная панель управления. На ней отображаются элементы управления - виджеты (widget). Это могут быть, например, показания датчиков (например, температура с 1-Wire), или кнопка включения реле, или блок выбора цвета светодиодной ленты.
Это главная страница пользователя. На неё выводятся элементы интерфейса - так называемые "виджеты" (widget). Это могут быть показания датчиков (например, датчика температуры), кнопки включения света, управления подключёнными реле.
 
Набор виджетов на главной странице полностью настраивается пользователем в меню '''Settings -> Web UI -> Common Info''', где можно выбрать панель, которая будет отображаться на вкладке '''Home''' по умолчанию.


=== Dashboards (Панели) === <!--T:8-->
=== Dashboards (Панели) === <!--T:8-->
[[File:Web-Dashboards-2.0.png|thumb|600 px|center|Dashboards - список панелей]]


<!--T:9-->
<!--T:9-->
Виджеты со схожим назначением можно группировать в панели, где на одном экране находятся все необходимые кнопки, настройки и показатели датчиков. Например, можно объединить виджеты включения подогрева, кондиционера, отображения температуры и влажности. В разделе Dashboards можно увидеть все созданные панели. На самом деле, раздел Home тоже отображает одну из панелей, какую - выбирается в настройках.
Виджеты со схожим назначением можно группировать в панели, где на одном экране находятся все необходимые кнопки, настройки и показатели датчиков. Например, можно объединить виджеты включения подогрева, кондиционера, отображения температуры и влажности. В разделе '''Dashboards''' можно увидеть все созданные панели. Раздел Home тоже отображает одну из панелей, выбранную в настройках.
 
Дважды щелкнув на вкладке '''Dashboards''' на боковой панели можно раскрыть список всех панелей, созданных в Web-интерфейсе.


=== Devices (Устройства) === <!--T:10-->
=== Devices (Устройства) === <!--T:10-->
[[File:Web-Devices-2.0.png|thumb|center|700 px|Devices - список всех аппаратных функций контроллера и подключённых устройств]]


<!--T:11-->
<!--T:11-->
Здесь отображаются все физически подключённые устройства и их параметры. Отображаемые устройства и параметры не тождественны виджетам; наоборот, виджеты строятся на их основе.
На странице '''Devices''' отображаются все аппаратные возможности контроллера (состояние входов, выходов, напряжение питания), а также подключённых датчиков и устройств. Если вы подключили к контроллеру внешний модуль, все его меняющиеся значения будут отображены тут.
 
Каждый элемент устройства (показание значения напряжения, сетевой адрес, кнопка управления реле, флажок состояния входа  и т.п.) -- называется "контрол". Несколько контролов могут быть объединены в один виджет - подробнее смотрите в разделе [[#Widgets (Виджеты)|Widgets (Виджеты)]].
 
Подключаемые устройства (Modbus-модули , боковые и внутренние модули) '''не''' определяются контроллером автоматически. Чтобы на этой странице появились аппаратные возможности подключённых устройств (например, внешних модулей реле), сначала нужно настроить их через раздел [[#Configs |Configs (Конфигурирование)]].


=== Rooms (Комнаты) === <!--T:12-->
Удалить отключенные/неработающие устройства из Web-интерфейса можно с помощью кнопки '''Delete''' в виде значка с изображением мусорной корзины, в верхней строке плитки устройства. Кнопка появляется, конгда указатель мыши находится над плиткой устройства.


<!--T:13-->
[[File:Web-Devices-Delete-Device-2.0.png|thumb|center|400 px|Удаление отключенного устройства]]
Так как виджетов может быть очень много, каждый из них привязывается к определённой "комнате". Обычно комнаты соответствуют комнатам без кавычек - физическим локациям, в которых находятся подключённые устройства. Комната задаётся при создании виджета, потом каждый виджет можно найти в соответствующей комнате.


=== Widgets (Виджеты) === <!--T:14-->
=== Widgets (Виджеты) === <!--T:14-->
[[File:Web-Widgets-2.0.png|thumb|center|718px|Widgets - страница управления виджетами]]


<!--T:15-->
<!--T:15-->
Виджеты - непосредственно элементы интерфейса. Создаются на основе подключённых устройств. Например, если через встроенное Реле 1 Wiren Board подключён главный свет в комнате 1, то можно создать такой виджет:
Виджеты - комбинированные элементы интерфейса контрроллера, включающие в себя набор контролов, то есть аппаратных параметров контроллера и подключённых к нему устройств - тех, что отображаются на странице [[#Devices (Устройства)|Devices (Устройства)]].
*Название: ''Главный свет''
 
*Комната: ''Комната 1'' (комнату с таким названием нужно заранее создать в разделе Rooms)
На странице Widgets представлен список всех виджетов, созданных в системе. Сами виджеты создаются в настройках панелей, на этой странице ими можно только управлять: просматривать, удалять и добавлять к существующим панелям-дашбордам.
*Тип виджета: ''Light Control Relay (Управление светом)''
 
*"Контрол" (реальное устройство, которое будет выполнять эту функцию): ''/devices/wb-gpio/controls/Relay_1''
 
==== Пример создания виджетов ====
{|
|[[File:Web-Dashboards-Add_Dashboard-2.0.png|thumb|500px|center|Создать новую панель]]
|[[File:Web-Dashboards-Add_Widget-2.0.png|thumb|500px|center|Создать новый виджет]]
|}
Для примера создадим два виджета с показаниями температуры и переключателями управления отопительными конвекторами для двух комнат ''"Комната 1"'' и ''"Комната 2"''.
 
* На боковой панели щелкнем на вкладке '''Dashboards''', в раскрывшемся списке выберем элемент '''List''', и на открывшейся странице нажмем кнопку '''Add'''.
* В поле '''Name''' напишем название новой панели, ''"Управление отоплением"'', и нажмем кнопку '''Save'''.
* В списке на странице '''Dashoards''' щелкнем на кнопке '''View''' напротив новой панели "Управление отоплением".
* В открывшемся окне с названием панели щелкнем на кнопке '''Add widget''' в правом верхнем углу окна (см. Рис. "Создать новый виджет").
* В заголовке виджета укажем название, в нашем случае ''"Комната 1"'', в списке '''Add control...''' выберем контрол, соовететвующий термометру в первой комнате, еще раз в этом списке выберем реле, которое будет включать нагреватель.
* В поле '''Name''' виджета можно задать осмысленные названия для контролов, например: ''"Температура"'' и ''"Обогреватель"''. Снимите флажок '''Compact mode''', чтобы эти названия контролов отображались в виджете.
* В поле '''Widget description''' можно написать назначение виджета.
* Аналогично создадим виджет для управления отоплением в комнате 2.
* Для внесения изменений подведите курсор к заголовку виджета и нажмите кнопку '''Edit widget''', внесите изменения и нажмите кнопку '''Save'''.
 
{| class="wikitable"
|- style="vertical-align:bottom;"
|[[File:Web-Dashboards-Add_Control-2.0.png|thumb|400px|center|Добавить новый контрол в виджет]]
|[[File:Web-Dashboards-Widget_Ready-2.0.png|thumb|330px|center|Пример создания виджета]]
|[[File:Web-Dashboards-Dashboard_With_Widgets-2.0.png|thumb|460px|center|Пример готовых виджетов на панели]]
|}
 
=== History (История показаний) === <!--T:20-->
[[File:Web-History-Web-2.0.png|thumb|center|814px|Пример отображения исторических данных]]
 
На странице ''History'' можно просмотреть историю изменения значений аппаратных ресурсов (например, датчиков температуры, напряжения, показаний счётчиков). История представляется одновременно в виде графика и таблицы значений с метками времени.
 
Возможности просмотра исторических данных:
* Указание интервала времени для отображения данных
* Добавление и удаление нескольких показателей (кнопки Add channel и delete) на график
* Промсмотр данных в виде графика и в виде таблицы
* Загрузку данных за выбранный период в csv-формате.
 
При наведении указателя мыши на область изображения становятся доступными дополнительные функции (кнопки в верхней правой части графика):
* Сохранение графика в формате .png
* Переключение между режимами Zoom (увеличения/уменьшения отрезка данных и масштаба с помощью выделения нужной области указателем мыши) и панорамирования Pan (перемещения области видимости с зажатой левой кнопкой мыши)
* Уменьшения и увеличения отображаемого временного интервала (Zoom in и Zoom out)
* Автоматического выбора масштаба графика по обеим осям
* Возвращение масштаба осей к исходному
* Включения/выключения указателя координат
 
 
[[Wb-mqtt-db-cli|Утилита для извлечения исторических данных из внутренней базы данных]]
 
=== Rules (Правила-скрипты) === <!--T:20-->
[[File:Web-Rules-2.0.png|thumb|center|800 px|Скрипт, открытый для просмотра и редактирования]]
 
На странице '''Rules''' можно создавать и редактировать правила. Правила пишутся на простом языке, похожем на JavaScript, и позволяют создавать правила ("включай свет с 10:00 до 18:00") или виртуальные устройства (например, кнопка в интерфейсе, которая включает и отключает всё освещение в здании вместе).
*[[Движок правил wb-rules | Подробнее про скрипты]].
 
=== Settings -> Configs (Настройки -> Конфигурирование) === <!--T:100-->
[[File:Web-Configs-2.0.png|thumb|center|600 px|Страница Configs]]
На странице '''Settings -> Configs''' производится конфигурирование контроллера и настройка подключения внешних устройств:
* настройка сетевых интерфейсов
* настройка серверов получения точного времени
* конфигурирование и настройка боковых и внутренних модулей
* настройка цифровых входов и выходов
* настройка аналоговых входов
* настройка логирования значений
* настройка шлюза контроллерр -> Modbus TCP
* настройка подключёния устройств RS-485
* настройка предупреждений (alarms)
* доступ к редактированию JSON-файла настроек Web-интерфейса
 
=== Settings -> WebUI (Настройки -> Web-интерфейс) === <!--T:100-->
[[File:Web-Settings_WebUI-2.0.png|center|thumb|600 px|Страница Settings]]
 
На странице '''Web UI''' настраиваются параметры веб-интерфейса и контроллера. Здесь можно:
* Выбрать подключение к MQTT-брокеру (Web-sockets), если используется нелокальный брокер, а, например, облачный сервис
* При необходимости указать учетные данные на удаленном MQTT-брокере
* Указать префикс всех топиков, с которым данные охраняются в облачном сервисе
* Выбрать панель (Default Dashboard), которая будет отображаться на главной странице (Home)
 
 
=== Settings -> System (Настройки -> Системные) ===
 
[[File:Web-Settings_System-2.0.png|center|thumb|600 px|Страница System]]
 
На этой странице можно обновить прошивку контроллера, предварительно скачав ее на компьютер.
 


=== Settings (Настройки) === <!--T:16-->
=== Settings -> MQTT Channels (Настройки -> MQTT-каналы) ===
[[File:Web-Settings_MQTT_Channels-2.0.png|center|thumb|600 px|MQTT Channels]]


<!--T:17-->
На этой странице приводится справочная информация о всех MQTT-топиках, полученных Web-интерфейсом контроллера а так же статус их получения ('''ОК''' или '''ERR''' в последнем столбце).
Раздел "Login" - используется только при работе через облачный веб-интерфейс, если вы работаете с интерфейсом локально на устройстве, то все настройки в нём уже выставлены правильно. Если вы работаете с облачным интерфейсом, смотрите раздел ниже.


<!--T:18-->
Раздел "Common Info" - здесь можно выбрать панель, которая будет отображаться на главной странице странице (Home).


<!--T:19-->
=== Settings -> Change access level (Настройки -> Изменить уровень доступа) ===
Раздел "Statistics Overview" - здесь выводится техническая информация, в частности, все подключённые устройства и их "контролы", а также возможные типы виджетов.
[[File:Web-Acess_Level-2.0.png|center|thumb|600 px|Выбор уровня доступа]]
На этой странице можно изменить текущий уровень доступа пользователя к настройкам Web-интерфейса.
 
== Стандартные задачи, решаемые через веб-интерфейс ==
 
=== Покдлючить устройство RS-485 Modbus и создать кнопки управления на главной панели ===
[[RS-485:Настройка через веб-интерфейс]]
===Обновить прошивку контроллера===
[[Обновление прошивки#Обновление прошивки через веб-интерфейс|Обновление прошивки через веб-интерфейс]]


== Облачный интерфейс == <!--T:20-->
== Облачный интерфейс == <!--T:20-->


<!--T:21-->
<!--T:21-->
Wiren Board может управляться не только с интерфейса, расположенного на самом контроллере - этот же интерфейс может находиться на сервере в облаке. ''Пока что такой вариант доступен только корпоративным клиентам по запросу.''
Веб-интерфейс Wiren Board можно разместить не только на самом контроллере, но и на специальном сервере. Тогда на интерфейс можно будет заходить используя всегда один и тот же IP-адрес.
 
Чтобы контроллер начал работать с веб-интерфейсом, размещённым на сервере, нужно внести некоторые изменения в конфигурацию контроллера.
 
Такой вариант удобен, если ваш контроллер находится за роутером и не имеет глобального IP-адреса, или если он подключён по GPRS - тогда он тоже, скорее всего, не имеет глобального IP, да ещё и работа с удалённым веб-интерфейсом израсходует слишком много трафика.
 
'''Пока что такой вариант доступен только корпоративным клиентам по запросу.'''
 
<!--Также рекомендуем воспользоваться сервисом [http://inspektor.carbonfay.ru Inspektor SCADA], который предоставляет схожую функциональность. [[Inspektor SCADA|Статья]] про настройку доступа к Inspektor SCADA.-->
 
 
</translate>
</translate>
== Настройка авторизованного доступа к Web-интерфейсу контроллера ==
В статье [[Защита_паролем|Защита паролем]] приводятся краткие инструкции по перенастройке контроллера, обеспечивающие авторизованный доступ к Web-интерфейсу контроллера.
Kilpio
5813

правок

Источник — https://wirenboard.com/wiki/Служебная:Сравнение_версий/4149...17914