Shelly Pro 1 web interface guide

Обзор. Устройства Shelly предоставляют локальный веб-интерфейс, позволяющий управлять устройствами и настраивать их через стандартный веб-браузер на компьютере или мобильном устройстве. С его помощью вы можете включать и выключать подключенные к вашему устройству приборы, устанавливать расписания и настраивать действия, которые будут выполняться при выполнении определенных условий. Обратите внимание, что для использования локального веб-интерфейса вам не требуется подключение к интернету или Shelly Cloud — единственное требование заключается в том, что ваш браузер должен находиться в той же сети Wi-Fi, что и ваше устройство Shelly. Доступ к веб-интерфейсу Чтобы получить доступ к веб-интерфейсу: Подключите ваше устройство к сети Wi-Fi с именем (SSID), соответствующим следующему формату: "DeviceName-XXXXXXXXXX", где «DeviceName» — это имя устройства, к которому вы хотите подключиться, а «XXXXXXXXXX» представляет собой уникальную комбинацию букв и цифр, составляющую идентификатор устройства. После установления соединения с точкой доступа/AP устройства (сетью Wi-Fi, упомянутой в шаге 1) доступ к веб-интерфейсу осуществляется путем ввода универсального IP-адреса для всех устройств Shelly: 192.168.33.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 и многое другое, а также значок, показывающий наличие новых обновлений прошивки для вашего устройства. Наведение курсора мыши на значок предоставит вам дополнительную информацию. Легенду со значением каждого значка вы найдете в руководстве по веб-интерфейсу каждого устройства. Обратите внимание, что отдельные руководства описывают только функции подключения, доступные для конкретного устройства. Внизу экрана слева направо по порядку отображаются название модели устройства, его идентификатор, версия веб-интерфейса, версия прошивки устройства и, наконец, текущее время. Если время не синхронизировано, вы получите уведомление в верхней части экрана, и некоторые расписания и действия могут работать некорректно. Некоторые предыдущие версии веб-интерфейса не содержат всех этих компонентов. Главное меню. Главное меню в настольной версии веб-интерфейса находится слева, тогда как на мобильном устройстве оно выглядит как меню-гамбургер с иконкой из трех горизонтальных линий, расположенных друг над другом. Меню содержит разные пункты в зависимости от устройства, но щелчок по пункту переводит вас на другую страницу. Вы также можете использовать его, чтобы вернуться на главную страницу, щелкнув «Главная». Основное содержимое. Щелкнув по пункту главного меню, вы сможете перемещаться по веб-интерфейсу. Всё, что вы видите на экране, за исключением заголовка, нижнего колонтитула и главного меню, считается основным содержимым.*Обратите внимание, что не все скриншоты веб-интерфейса, отображаемые вверху каждой страницы руководства по веб-интерфейсу (где есть скриншот), относятся к последней версии. Поэтому они могут немного отличаться от последней версии и не отражать внешний вид веб-интерфейса каждого устройства.

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

== Домашняя страница

== В веб-интерфейсе вы увидите пять значков в заголовке, включая значки для точки доступа, Wi-Fi, Bluetooth, облака и подключения MQTT. Вот что означают разные цвета состояния: APicon: Серый: Режим точки доступа отключен. Синий: Режим точки доступа включен. Wi-Fiicon: Серый: Wi-Fi-соединение отключено. Белый: Wi-Fi-соединение включено, но не установлено. Синий: Устройство подключено к Wi-Fi. Bluetoothicon: Серый: Соединение отключено. Синий: Соединение включено. Cloudicon: Серый: Соединение с Shelly Cloud отключено. Белый: Соединение с Shelly Cloud включено, но не установлено. Синий: Устройство подключено к Shelly Cloud. Etherneticon: Серый: Соединение с проводной сетью Ethernet отключено. Белый: Соединение с проводной сетью Ethernet включено, но не установлено. Синий: Устройство подключено к проводной сети Ethernet. MQTTicon: Серый: MQTT отключен. Синий: MQTT включен. Firmware updateicon: Синий: Для вашего устройства доступна новая стабильная версия прошивки. Не отображается: Прошивка устройства обновлена до... Дата. Значок подключения Websocket: Синий: Websocket подключен. Серый: Websocket не подключен. На главной странице вы увидите переключатель и кнопку рядом с ним, которую можно использовать для включения и выключения переключателя. Под ним находится соответствующий вход, рядом с которым нет кнопки. Вместо этого его состояние отображается справа (ВКЛ или ВЫКЛ). При нажатии на выход или вход вы перейдете в меню, содержащее конкретные настройки для этого выхода/входа, которые не относятся ко всему устройству.

== Настройки выхода

== Имя: Назовите/переименуйте выход. Действие при включении питания: Установите действие, которое ваше устройство должно выполнить при включении питания. Вы можете отключить эту настройку или выбрать «Восстановить последнее», чтобы восстановить последнее действие, выполненное вашим устройством. Кроме того, вы можете выбрать «Соответствие входу», которое управляет вашим устройством в соответствии с состоянием переключателя или кнопки, подключенной к нему.

== Тип устройства

== Выберите из списка тип устройства, к которому подключено ваше устройство, включая: Общие, Реле, Освещение, Розетка, Отопление и Развлечения. Настройки входа/выхода. Выберите режим входа: Кнопка — каждое нажатие кнопки переключает состояние выхода устройства. Переключатель — положение переключателя соответствует состоянию выхода устройства. Аналоговый (доступен не во всех устройствах) — при использовании аналогового входа устройство определяет процент яркости в зависимости от процента входного сигнала. Установите тип выхода: Переключатель (только переключатель) — устройство будет работать как переключатель с одним состоянием «ВКЛ» и одним «ВЫКЛ». Если вход находится в аналоговом режиме, устройство будет следовать состоянию аналогового входа. Кнопочный переключатель (только кнопка) — каждое нажатие кнопки переключает состояние выхода устройства. Если ваш выключатель находится в положении «ВКЛ», он выключится, и наоборот. Переключатель по фронту (только переключатель) — каждое изменение положения переключателя переключает состояние выхода устройства. Отсоединенный переключатель — вход отсоединяется (отделяется) от выхода и не оказывает на него влияния. По сути, вы не сможете управлять освещением через вход. Действие при включении питания: этот параметр обычно используется при отключении электроэнергии, а «включение питания» означает, что электричество восстанавливается и устройство снова получает питание. Включить — при включении питания устройство включится. Выключить — при включении питания устройство выключится. Восстановить последнее известное состояние выхода/реле — при включении питания состояние выхода будет таким же, каким оно было в последний раз, когда устройство было включено (до отключения электроэнергии). Текущее состояние переключателя (только тумблер) — следует за состоянием переключателя, поэтому, если он переведён в положение «ВКЛ», устройство включится, и то же самое происходит, когда переключатель переведён в положение «ВЫКЛ». Тип потребления. Этот параметр актуален при интеграции устройства с системами домашней автоматизации сторонних производителей. Его цель — указать необходимую информацию или конфигурацию, требуемую внешней системой для взаимодействия с устройством. При использовании систем домашней автоматизации сторонних производителей для управления устройством рекомендуется обратиться к их документации или руководству пользователя, чтобы определить, что необходимо ввести в это поле. В документации сторонней системы обычно указываются необходимые параметры, учетные данные или любые другие сведения, которые должны быть предоставлены для установления связи между ней и устройством Shelly. Однако, если вы используете устройство исключительно с приложением Shelly, вы можете игнорировать поле «Внешний тип потребления». Приложение не требует дополнительной настройки в этом отношении, поскольку имеет собственные встроенные механизмы для связи с устройством и управления им. Если по какой-либо причине вы хотите удалить внешний тип потребления из настроек устройства, вы можете сделать это, просто оставив поле «Внешний тип потребления» пустым и нажав кнопку «Сохранить настройки». Таким образом, вы фактически отключаете внешний тип потребления и возвращаетесь к поведению устройства по умолчанию или полагаетесь исключительно на приложение Shelly для управления и автоматизации. Действия. Настройте действия для вашего устройства — создавайте новые действия, редактируйте существующие или удаляйте действия. При создании действий для вашего устройства вам необходимо указать условие, при котором происходит действие. Вы также можете установить продолжительность для ваших действий, а также URL-адрес, который будет вызываться при выполнении условия для действия.

== Расписания

== Для этой функции требуется работающее подключение к Интернету, чтобы устройство могло синхронизировать время. Она позволяет создавать, просматривать, редактировать и удалять расписания. Существует два типа расписаний: базовое и расширенное. Чтобы создать базовое расписание:

Выберите день(а) недели.
Выберите временной интервал: время, восход или закат солнца.
Установите время для указанного(ых) дня(дней): Время: Нажмите кнопку вверх/вниз или введите число, чтобы установить время в часах и минутах. Закат/Восход: Устройство Shelly может автоматически включаться/выключаться (или выполнять указанное действие) на восходе/закате солнца или в указанное время до или после восхода/захода солнца. Нажмите кнопку вверх/вниз или введите число, чтобы установить время в часах и минутах. Для создания расширенного расписания: Функция расширенного расписания использует cron для выполнения заданий с помощью одного расписания, вместо использования нескольких базовых расписаний. Создание расширенного расписания отличается от создания базового расписания из-за меню «Когда выполнять». Вам будет предложено выбрать одно или несколько значений, диапазон значений или шаг между значениями (выберите один из трех вариантов, нажав кнопку «Выбрать», «Диапазон» или «Шаг» для каждого значения) для:
Секунд (0-59)
Минут (0-59)
Часов (0-23)
Дней (1-31)
Месяцев (январь-декабрь)
Дней недели (воскресенье-суббота) Чтобы создать расписание, которое будет выполняться каждую секунду/минуту/час/день/месяц/день недели, просто отметьте галочкой поле под значениями в нужном разделе (секунды, минуты, часы, дни, месяцы или дни недели). Кроме того, вы можете использовать смещение восхода/захода солнца, отметив галочкой поле рядом с этой опцией. Это откроет новое меню с часами и минутами. Если оставить часы и минуты и выбрать восход или закат солнца, расписание будет выполняться точно в момент восхода или заката солнца. Изменение значений часов и минут создаст смещение, поэтому ввод отрицательных значений приведет к тому, что расписание будет выполнено ровно за [установленное количество часов и/или минут] до восхода/захода солнца, а ввод положительных значений — после восхода/захода солнца. Вы не можете ввести положительное значение для одного параметра (часы/минуты) и отрицательное для другого. После этого просто укажите действие, которое должно выполнить ваше устройство, в разделе «Действия». После завершения нажмите «Сохранить», чтобы сохранить новое расписание. В меню «Расписания» вы можете просмотреть все свои расписания. Вы можете выбрать просмотр каждого из них с использованием базового или расширенного времени. Базовое время показывает время и дни, когда выполняется расписание, а расширенное время отображает текст в карточке расписания, который указывает, на что нужно нажать для получения дополнительной информации. В обоих режимах отображаются действия сверху. Если действий больше трех, они отображаются как +n, где n — оставшееся количество действий, которые не отображаются. Чтобы включить/выключить расписание, используйте переключатель справа.

== Таймеры

== Позволяет автоматически управлять питанием. Вы можете использовать:

Автоматическое включение: После выключения релейный выход автоматически включится через заданный промежуток времени (в секундах).
Автоматическое выключение: После включения релейный выход автоматически выключится через заданный промежуток времени (в секундах).

== Настройки входа

== Имя

== Назовите/переименуйте вход.

== Режим входа

== Выберите один из следующих вариантов:

Кнопка — каждое нажатие кнопки переключает состояние выхода устройства.
Переключатель — положение переключателя соответствует состоянию выхода устройства. Для некоторых устройств этот параметр также может называться «Режим переключения».

== Подключено к выходу

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

== Инвертировать

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

== Действия

== Настройка действий ввода.

== Настройки

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

==

Точка доступа — Настройте точку доступа (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.pemoruser_ca.pem.
Расширитель диапазона — включение функции расширителя диапазона создает точку доступа, к которой можно подключать устройства Wi-Fi. Если устройство Shelly с включенным расширителем диапазона подключено к маршрутизатору Wi-Fi и Интернету, все подключенные к нему устройства также подключаются к маршрутизатору и Интернету. Даже если устройство Shelly не подключено к маршрутизатору Wi-Fi, все подключенные к нему устройства все равно могут взаимодействовать с ним и друг с другом. Ниже представлена информация о подключенных клиентах AP — их количестве, а также IP-адресах, MAC-адресах и внутренних и внешних IP-адресах.
RPC через UDP — обмен данными с вашим устройством и отправка запросов через удаленный вызов процедур (RPC) по протоколу UDP (User Datagram Protocol). Это может быть полезно для удаленного управления и мониторинга вашего устройства без необходимости использования выделенного сервера или подключения. Для использования этой настройки вам потребуется ввести порт прослушивания и адрес назначения для UDP-сервера. Порт прослушивания — это номер порта, на котором устройство будет принимать входящие запросы, а адрес назначения — это IP-адрес сервера, на который будут отправляться запросы. После ввода необходимой информации вы можете использовать протокол RPC через UDP для отправки запросов на ваше устройство и получения ответов.

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

==

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

== Скрипты

== Это устройство обладает возможностями написания скриптов. Вы можете использовать их для настройки и расширения функциональности устройства в соответствии с конкретными потребностями пользователя. Эти скрипты могут учитывать состояние устройства, взаимодействовать с другими устройствами или получать данные из внешних сервисов, таких как прогнозы погоды. Скрипт — это программа, написанная на подмножестве JavaScript. В веб-интерфейсе, перейдя в меню «Скрипты», вы увидите существующие скрипты. Если у вас их нет, вы можете создать новый или открыть библиотеку, чтобы изучить уже доступные скрипты. Рядом с каждым скриптом отображается его статус (выполняется или остановлен), а также переключатель, позволяющий запускать скрипт при запуске системы. Если в вашем скрипте есть ошибки, под именем скрипта будет отображаться последняя сохраненная ошибка. В режиме редактирования скрипта вы увидите консоль, а также любые возникающие ошибки. Над полем кода расположены параметры «Сохранить», «Запустить/Остановить» или «Удалить» ваш скрипт. Вы также можете получить доступ к «Фрагментам кода» и «Документации», щелкнув соответствующие метки. Расширенные настройки. Щелкнув стрелку рядом с этой настройкой, вы увидите расширенные настройки. Они описаны ниже. KVS расшифровывается как Key-Value Storage (хранилище ключ-значение) и представляет собой тип нереляционной базы данных, которая использует простой метод «ключ-значение» для хранения данных. На одном устройстве можно хранить до 50 пар ключ-значение. После нажатия кнопки «Добавить значение» вы перейдете на экран создания значения, где вам будет предложено ввести ключ (до 42 символов) и значение (до 253 символов). Обратите внимание, что под текстовым полем для значения указан текущий тип значения. По умолчанию тип значения — Number (число), но при вводе текста тип изменится на String (строка). Чтобы сохранить ключ, просто нажмите кнопку «Сохранить». Чтобы отредактировать существующее значение, просто щелкните по нему. Чтобы удалить пару ключ-значение, нажмите кнопку «Удалить», которая появится под ним при редактировании ключа. Нажатие на вопросительный знак рядом с названием параметра переведет вас к документации API, которая предоставит вам дополнительную информацию о том, как работает KVS на устройствах Shelly. Диагностика. В этом разделе можно загрузить отладочные журналы. Включение отладочного журнала без причины не рекомендуется, так как это замедлит работу устройства и приведет к износу флэш-памяти. Если вы все же решите включить его, вы также сможете загрузить предыдущие и текущие журналы. Имейте в виду, что при выходе с этой страницы данные журнала будут сброшены. HTTP-пинг. Введите URL-адрес в соответствующее текстовое поле, чтобы отправить HTTP-запрос с вашего устройства. Веб-интерфейс сообщит вам, был ли запрос успешным или нет.