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

Shelly Pro 3EM web interface guide

Материал из База знаний Shelly

Обзор

Устройства Shelly предоставляют локальный веб-интерфейс, который позволяет управлять и настраивать ваши устройства через стандартный веб-браузер на компьютере или мобильном устройстве. С его помощью вы можете включать и выключать подключенные к вашему устройству приборы, устанавливать расписания и настраивать действия, которые будут выполняться при выполнении определенных условий.

Обратите внимание, что для использования локального веб-интерфейса вам не требуется подключение к интернету или Shelly Cloud — единственное требование заключается в том, что ваш браузер должен находиться в той же сети Wi-Fi, что и ваше устройство Shelly.


Доступ к веб-интерфейсу

Для доступа к веб-интерфейсу:

  1. Подключите ваше устройство к сети Wi-Fi с именем (SSID), соответствующим следующему формату: ""DeviceName-XXXXXXXXXX", где "DeviceName" — это имя устройства, к которому вы хотите подключиться, а "XXXXXXXXXX" представляет собой уникальную комбинацию букв и цифр, составляющую идентификатор устройства.
  2. После установления соединения с точкой доступа/AP устройства (Указанная в шаге 1 сеть Wi-Fi) Доступ к веб-интерфейсу осуществляется путем ввода в браузере универсального IP-адреса для всех устройств Shelly: 192.168.33.1.

Теперь вы находитесь в веб-интерфейсе вашего устройства.


Подключение устройства к сети Wi-Fi

Некоторые настройки, которые вы увидите в веб-интерфейсе, доступны только при подключении устройства к интернету. Для этого выполните следующие действия:

  1. В веб-интерфейсе перейдите в «Настройки» > «Wi-Fi».

Введите или выберите предпочитаемую сеть Wi-Fi и введите ее пароль. Также можно подключиться к открытой сети, для чего необходимо установить флажок для подключения к открытым сетям Wi-Fi. Кроме того, рекомендуется установить статический IP-адрес.

Подождите несколько секунд, пока устройство попытается подключиться к указанной вами сети Wi-Fi. Если введенный вами пароль неверен или сеть Wi-Fi недостаточно мощная или стабильная, в веб-интерфейсе отобразится сообщение о том, что соединение не удалось установить. После успешного подключения к Wi-Fi над настройками Wi-Fi появится ссылка с новым IP-адресом. Просто скопируйте и вставьте эту ссылку в свой браузер.

Теперь вы находитесь в веб-интерфейсе вашего устройства, подключенного к интернету. В следующий раз, когда вам понадобится получить доступ к веб-интерфейсу, просто подключитесь к той же сети Wi-Fi, что и ваше устройство, и введите новый IP-адрес, полученный на шаге 3. Рекомендуется установить статический IP-адрес, поскольку это гарантирует постоянную доступность по этому конкретному адресу.


Понимание структуры

Веб-интерфейс можно разделить на четыре основных раздела: заголовок, нижний колонтитул, главное меню и основное содержимое.


Заголовок

Заголовок состоит из двух компонентов: названия вашего устройства слева и нескольких значков, отображающих основные сетевые и коммуникационные функции вашего устройства справа. Эти значки могут включать в себя такие функции, как Wi-Fi, Bluetooth, MQTT и многое другое, а также значок, показывающий наличие новых обновлений прошивки для вашего устройства. Наведение курсора мыши на значок предоставит вам дополнительную информацию. Вы найдете легенду со значением каждого значка в руководстве по веб-интерфейсу каждого устройства. Обратите внимание, что в отдельных руководствах описаны только функции подключения, доступные для конкретного устройства.


Нижний колонтитул

В нижней части экрана слева направо по порядку отображаются название модели устройства, его идентификатор, версия веб-интерфейса, версия прошивки устройства и, наконец, текущее время. Если время не синхронизировано, вы получите уведомление в верхней части экрана, и некоторые расписания и действия могут работать некорректно. Некоторые предыдущие версии веб-интерфейса не содержат всех этих компонентов.


Главное меню

В настольной версии веб-интерфейса главное меню находится слева, тогда как на мобильных устройствах оно выглядит как меню-гамбургер с иконкой из трех горизонтальных линий, расположенных друг над другом. Меню содержит разные элементы в зависимости от устройства, но нажатие на пункт меню переводит вас на другую страницу. Вы также можете использовать его, чтобы вернуться на главную страницу, нажав «Главная».


Основное содержимое

Нажав на пункт главного меню, вы сможете перемещаться по веб-интерфейсу. Все, что вы видите на экране, за исключением заголовка, нижнего колонтитула и главного меню, считается основным содержимым.

  • Обратите внимание, что не все скриншоты веб-интерфейса, отображаемые в верхней части каждой страницы руководства по веб-интерфейсу (где есть скриншот), относятся к последней версии. Поэтому они могут выглядеть немного иначе, чем последняя версия, и могут не отражать внешний вид веб-интерфейса каждого устройства.

Классический вид главной страницы


Главное меню

Ниже приведены пояснения к каждой настройке в главном меню, включая то, что отображается как основное содержимое при нажатии на различные настройки. Краткое описание значков в заголовке, специфичных для этого устройства, также присутствует в пояснении к главной странице. Обратите внимание, что заголовок присутствует на всех экранах, а не только на главной странице.


Главная страница

В веб-интерфейсе вы увидите пять значков в заголовке, включая значки для AP, Wi-Fi, Bluetooth, Cloud и MQTT-соединения. Вот что означают разные цвета состояния:

{ | class=""wikitable"" | - ! ! Значок точки доступа: Серый: Режим точки доступа отключен. Синий: Режим точки доступа включен. | }

{ | class=""wikitable"" | - ! ! Значок Wi-Fi: Серый: Подключение Wi-Fi отключено. Белый: Подключение Wi-Fi включено, но не установлено. Синий: Устройство подключено к Wi-Fi. | }

{ | class=""wikitable"" | - ! ! Значок Bluetooth: Серый: Подключение отключено. Синий: Подключение включено. | }

{ | class=""wikitable"" | - ! ! Значок облака: Серый: Подключение к облаку Shelly отключено. Белый: Подключение к облаку Shelly включено, но не установлено. Синий: Устройство подключено к облаку Shelly. | }

{ | class=""wikitable"" | - ! ! Значок Ethernet: Серый: Подключение к сети Ethernet отключено. Белый: Подключение к сети Ethernet включено, но не установлено. Синий: Устройство подключено к сети Ethernet. | }

{ | class=""wikitable"" | - ! ! Значок MQTT: Серый: MQTT отключен. Синий: MQTT включен. | }

{ | class=""wikitable"" | - ! ! Значок обновления прошивки: Синий: Для вашего устройства доступна новая стабильная версия прошивки. Не отображается: Прошивка устройства обновлена. | }

На главной странице веб-интерфейса вашего устройства есть три варианта отображения. В классическом режиме вы заметите, что показания фаз разделены на столбцы для каждой фазы — A, B и C. В то время как каждый столбец показывает отдельные показания фаз, включая напряжение, ток, активную мощность, полную мощность и коэффициент мощности, приведенная выше таблица с пометкой «Итого» показывает сумму показаний для каждой фазы. Показания напряжения, тока и активной мощности измеряются, соответственно, в вольтах, амперах и ваттах. Полная мощность измеряется в вольт-амперах. Коэффициент мощности может быть:
  • Положительным (больше 0), что указывает на индуктивные нагрузки.
  • Отрицательным (меньше 0), что указывает на емкостные нагрузки.
Под каждой таблицей для фаз от A до C находится раздел под названием «Энергия за последнюю минуту». Это показания для конкретной фазы за последнюю минуту, касающиеся активной и активной возвращенной энергии в мегаватт-часах. Диаграмма на главной странице В режиме диаграммы показания, отображаемые в классическом режиме, визуализируются с помощью схемы устройства, при этом каждая часть обозначается соответствующим значением. Здесь вы также заметите, что для трех фаз отображаются собственные показания, поскольку над каждой фазой указаны текущие показания и показания мощности, примерно как в классическом режиме. График энергии В режиме «График энергии» для каждой фазы есть два меню, посвященных ей — «Фаза» (и ее название, в данном случае A-C) и «Фаза» (ее название, в данном случае A-C) возвращаемой энергии. Они помогают визуализировать значения энергии в Вт·ч за последние 30 минут, разделяя мощность на активную и активную возвращаемую энергию. Вы заметите, что этот режим похож на более подробную версию меню «Энергия за последнюю минуту» в классическом режиме. В каждом из этих режимов будет доступна кнопка «Загрузить файл CVS». Нажав кнопку «<» рядом с этой опцией, вы можете выбрать загрузку файла, включающего:
  • Показания за последние n часов, где n — это значение, которое вы можете ввести.
  • Показания за последние n дней, где n — это значение, которое вы можете ввести.
  • Все данные, собранные вашим устройством с момента его настройки и первого включения.
  • При нажатии на меню «Настройки» рядом с разделом «Обзор» вы перейдете к:
  • Название счетчика электроэнергии — Назовите/переименуйте свой счетчик электроэнергии.
  • Изменение направления измерения трансформатора тока — Изменяет направление, в котором трансформатор тока (ТТ) измеряет электрический ток в течение одного или нескольких часов. Больше фаз. В зависимости от вашей проводки, вы можете применить эту настройку к некоторым или всем фазам (A, B и C). Выберите ту/те, для которых вы хотите изменить направление измерения, и нажмите «Сохранить настройки».
  • «Выбор режима мигания» — выберите способ управления светодиодным индикатором состояния вашего устройства — активной энергией или полной энергией. Выбранная электрическая величина будет управлять светодиодом, и состояние светодиода будет изменяться в соответствии с ней.
  • «Выбор фазы» — все фазы могут управлять светодиодом одновременно, или вы можете выбрать определенную фазу, для которой хотите иметь полный контроль над светодиодом. Если вы выберете одну фазу, изменения показаний для других фаз не повлияют на светодиод.
  • Мониторинг последовательности фаз - Включение этой настройки позволит вашему устройству проверять и уведомлять о неправильно установленных токовых трансформаторах (ТТ) в трехфазной системе.

Регистратор данных

  • Удаление сохраненных данных - Удалите все показания, собранные вашим устройством.


Действия

Настройте действия для вашего устройства - создавайте новые действия, редактируйте существующие действия или удаляйте действия. При создании действий для вашего устройства вам необходимо указать условие, при котором происходит действие. Вы также можете установить продолжительность выполнения действий, а также URL-адрес, который будет активирован при выполнении условия действия.


Настройки

Сетевые настройки

  • Точка доступа — Настройте точку доступа устройства (AP), установив флажок «Включить точку доступа» и задав пароль для защиты вашей сети от несанкционированного доступа. Точка доступа устройства по умолчанию является открытой сетью. SSID уникален и не может быть изменен.
  • Wi-Fi — Зарегистрируйте устройство Shelly для подключения к двум различным сетям Wi-Fi. Введите (написав в текстовом поле) или выберите сеть Wi-Fi, щелкнув значок стрелы (шеврон), чтобы просмотреть все доступные сети. Можно выбрать открытую сеть, а также установить статический IP-адрес. Включите Wi-Fi 1, Wi-Fi 2 или оба одновременно (используя переключатель рядом с каждым из них). Если включены обе сети Wi-Fi 1 и Wi-Fi 2, и устройство Shelly отключается от одной из них, оно подключится к другой. Включить Wi-Fi можно только после установки имени сети (SSID). Если у устройства нет других доступных подключений (точка доступа, Bluetooth, Ethernet (если применимо) или вторая сеть Wi-Fi), попытка отключить Wi-Fi вызовет всплывающее окно с вопросом, хотите ли вы продолжить.
  • Bluetooth - Отключение/включение Bluetooth путем переключения тумблера. В этом случае включена стандартная настройка Bluetooth устройства.
  • Ethernet - Вы можете подключить устройство через Ethernet вместо Wi-Fi. Как и в настройках Wi-Fi, вы можете установить статический IP-адрес для вашего устройства (что рекомендуется), чтобы оно всегда подключалось к устройству по одному и тому же IP-адресу. Если включен статический IP-адрес, вам будет предложено указать IP-адрес, DNS-сервер, шлюз и маску подсети.


Подключение

Примечание для связи по RPC: Если вызов RPC не удается выполнить, появляется сообщение-баннер, уведомляющее о том, что устройство не отвечает вовремя и потеряло соединение. После восстановления соединения запрос будет отправлен снова.

  • Облако — Подключение Shelly к облаку позволяет управлять им удаленно и получать уведомления и обновления о ваших устройствах. По умолчанию облако включено. Если вы отключите поддержку облака для устройства, вы потеряете связь с устройством извне его локальной сети!
  • MQTT — Настройте устройство Shelly для выполнения действий через MQTT. По умолчанию MQTT отключен, но вы можете включить его, выбрав пустой флажок. Изменение этих настроек приведет к перезагрузке устройства. Есть и другие настройки, такие как «Уведомления о состоянии RPC через MQTT» (позволяет обмениваться данными с устройством посредством уведомлений RPC) и «Общее обновление состояния через MQTT» (для получения общего обновления состояния), которые можно включить или отключить. Вы также можете включить SSL и ввести свой сервер, имя пользователя и пароль, но имейте в виду, что включение SSL негативно скажется на времени работы батареи и, скорее всего, сократит его вдвое.
  • «Исходящий Websocket» — указывает, будет ли HTTP-канал создавать исключение ввода-вывода при закрытии входящего соединения, которое все еще используется сервлетом. По умолчанию эта настройка отключена. Чтобы включить ее, щелкните переключатель рядом с «Включить». Введите свой сервисный адрес в текстовое поле и из выпадающего меню в разделе «SSL-подключение» выберите «
  • », «ca.pem» или «user_ca.pem».
  • «Расширитель диапазона» — включение функции «Расширитель диапазона» создает точку доступа, к которой можно подключать устройства Wi-Fi. Если устройство Shelly с включенным расширителем диапазона подключено к маршрутизатору Wi-Fi и Интернету, все подключенные к нему устройства также подключаются к маршрутизатору и Интернету. Даже если устройство Shelly не подключено к маршрутизатору Wi-Fi, все подключенные к нему устройства все равно могут взаимодействовать с ним и друг с другом. Ниже приведена информация о подключенных клиентах AP — их количестве, а также IP-адресах, MAC-адресах и внутренних и внешних IP-адресах.
  • RPC через UDP — Общайтесь с вашим устройством и отправляйте запросы через удаленный вызов процедур (RPC) по UDP-серверу. Это может быть полезно для удаленного управления и мониторинга вашего устройства без необходимости в выделенном сервере или подключении. Для использования этой настройки вам потребуется ввести порт прослушивания и адрес назначения для UDP-сервера. Порт прослушивания — это номер порта, на котором устройство будет принимать входящие запросы, а адрес назначения — это IP-адрес сервера, на который будут отправляться запросы. После ввода необходимой информации вы можете использовать протокол RPC по UDP для отправки запросов на ваше устройство и получения ответов.


Настройки устройства

  • Имя устройства (информация) — Узнайте идентификатор вашего устройства, сеть Wi-Fi, к которой оно подключено, и значение RSSI Wi-Fi.
  • Перезагрузка — После нажатия кнопки «Перезагрузка» вам будет предложено подтвердить, что вы хотите перезагрузить устройство. Нажмите «ОК» для перезагрузки устройства и «Отмена», если вы не хотите перезагрузки устройства.
  • «Сброс к заводским настройкам» — Нажав кнопку «Сброс», вы сбросите все настройки устройства до значений по умолчанию. Все внесенные вами изменения будут отменены. Вы можете подтвердить сброс устройства к заводским настройкам, нажав «ОК» во всплывающем окне, или «Отмена», чтобы отменить сброс.
  • «Местоположение и часовой пояс» — Ваш часовой пояс и местоположение будут определены автоматически, но вы можете изменить их вручную в этой настройке, выбрав часовой пояс из выпадающего меню и введя широту и долготу. Также есть кнопка «Автоматическое определение местоположения», которая позволит устройству автоматически определить местоположение еще раз, если в прошлый раз это не удалось.

«Если время устройства не синхронизировано с текущим временем, расписания и действия могут работать некорректно. Если время не синхронизировано, появится сообщение.»

  • «Аутентификация» — если вы включите аутентификацию, вам будет предложено ввести пароль, который вы будете использовать для доступа к веб-интерфейсу устройства. После включения, чтобы отключить ее, нажмите переключатель и введите свой пароль аутентификации, когда появится соответствующий запрос.
  • «Прошивка» — в этом разделе вы можете увидеть идентификатор вашего устройства, версию прошивки, идентификатор сборки и идентификатор веб-сборки. Используйте кнопку «Копировать» над идентификатором прошивки или идентификатором веб-сборки, чтобы скопировать содержимое в буфер обмена. Вы также можете увидеть доступные новые версии, проверить наличие обновлений и легко обновить ваше устройство. Также есть возможность загрузить собственную прошивку, однако прошивка устройства пользовательской прошивкой необратимо аннулирует гарантию устройства.
  • Сертификат пользователя (конфигурация TLS) — Загрузите пользовательский центр сертификации, клиентский сертификат и клиентский ключ, перетащив файл(ы) или выбрав нужные файлы, нажав соответствующую кнопку. Нажмите «Загрузить», чтобы загрузить файлы, и «Очистить», чтобы удалить файлы, которые вы не хотите загружать.
  • Эко-режим — Снизьте энергопотребление устройства, уменьшив частоту процессора и активность модема в эко-режиме. Чтобы включить эту настройку, переключите тумблер рядом с «Включить эко-режим», а затем нажмите кнопку «Применить», чтобы сохранить изменения.
  • Отладка — Эта настройка включает отладку MQTT, Websocket и UDP. Чтобы включить любую из них, переключите тумблер рядом с соответствующей настройкой. Для отладки по UDP вам также будет предложено ввести «UDP-адрес».
  • Единицы измерения температуры -Выберите единицы измерения, в которых будут отображаться измеренные данные - Цельсий или Фаренгейт.


Скрипты

Это устройство обладает возможностями написания скриптов. Вы можете использовать их для настройки и расширения функциональности устройства в соответствии с конкретными потребностями пользователя. Эти скрипты могут учитывать состояние устройства, взаимодействовать с другими устройствами или получать данные из внешних сервисов, таких как прогнозы погоды. Скрипт — это программа, написанная на подмножестве JavaScript.

В веб-интерфейсе, перейдя в меню «Скрипты», вы увидите существующие скрипты, или, если у вас их нет, вы можете создать свой собственный или открыть библиотеку, чтобы изучить уже доступные скрипты. Рядом с каждым скриптом вы сможете увидеть его статус (работает он или остановлен), а также переключатель, позволяющий запускать скрипт при запуске системы. Если в скрипте есть ошибки, под именем скрипта будет отображаться последняя сохраненная ошибка.

В режиме редактирования скрипта вы увидите консоль, а также любые возникающие ошибки. Над полем кода расположены параметры «Сохранить», «Запустить/Остановить» или «Удалить» скрипт. Вы также можете получить доступ к «Фрагментам» и «Документации», щелкнув соответствующие метки.


Расширенные настройки

При нажатии на стрелку рядом с этой настройкой отобразятся расширенные настройки. Они описаны ниже.


KVS

KVS расшифровывается как Key-Value Storage и представляет собой тип нереляционной базы данных, которая работает с использованием простого метода ключ-значение для хранения данных. На одном устройстве можно хранить до 50 пар ключ-значение. После нажатия кнопки «Добавить значение» вы перейдете на экран создания значения, где вам будет предложено ввести ключ (до 42 символов) и значение (до 253 символов). Вы заметите, что под текстовым полем для значения указан текущий тип значения. По умолчанию тип значения — «Число», но при вводе текста тип изменится на «Строка». Чтобы сохранить ключ, просто нажмите кнопку «Сохранить». Чтобы отредактировать существующее значение, просто щелкните по нему. Чтобы удалить пару ключ-значение, нажмите кнопку «Удалить», которая появится под ней при редактировании ключа. Нажатие на вопросительный знак рядом с названием параметра переведет вас на страницу документации API, где вы найдете дополнительную информацию о работе «KVS» для устройств Shelly.


Диагностика

В этом параметре вы можете загрузить отладочные журналы. Включение отладочного журнала без причины не рекомендуется, так как это замедлит работу вашего устройства и приведет к износу флэш-памяти. Если вы все же решите включить его, вы также сможете загрузить предыдущие и текущие журналы. Имейте в виду, что выход с этой страницы сбросит регистратор и данные журнала.


HTTP-пинг

Введите URL-адрес в соответствующее текстовое поле, чтобы отправить HTTP-запрос с вашего устройства. Веб-интерфейс сообщит вам, был ли запрос успешным или нет.