Shelly Dimmer Gen3 web interface guide: различия между версиями

Текущая версия от 14:10, 10 марта 2026

Обзор

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

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

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

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

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

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

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

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

В веб-интерфейсе перейдите в «Настройки» > «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, Ethernet и MQTT, а также значок, указывающий на наличие новой версии прошивки. Вот что означают разные цвета состояния:

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

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

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

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

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

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

При нажатии на значок светильника на главной странице вы перейдете к некоторым настройкам, специфичным для светильника, которые описаны здесь:

Название светильника

Назовите/переименуйте светильник.

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

Выберите режим ввода:

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

Установить тип выхода:

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

Действие при включении питания:

Этот параметр обычно используется при отключении электроэнергии, а «включение питания» означает восстановление электроснабжения и повторное включение устройства.

Включить - При включении питания устройство включится.
Выключить - При включении питания устройство выключится.
Восстановить последнее известное состояние выхода/реле - При включении питания состояние выхода будет таким же, каким оно было в последний раз, когда устройство было включено (до отключения электроэнергии).
Текущее состояние переключателя (только тумблер) - Отслеживает состояние переключателя, поэтому, если он установлен в положение «ВКЛ», устройство включится, и то же самое происходит, когда переключатель установлен в положение «ВЫКЛ».

Ночной режим

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

Минимальная/максимальная яркость

Диапазон по умолчанию составляет 0%-100%, но вы можете настроить его с помощью этой настройки. Изменение этих значений изменит диапазон выходного сигнала с точностью до 0,1. Минимальное значение должно быть меньше максимального, равные значения вводить нельзя. Изменение этого параметра требует перезагрузки устройства.

Скорость затухания кнопки

Управляет скоростью затемнения при удерживании кнопки. Выберите значение от 1x до 5x, где 5x — самая быстрая скорость, 3x — значение по умолчанию, а 1x — самая медленная.

Калибровка

Нажмите «Старт», чтобы начать процесс калибровки. Поскольку разные лампы имеют разный уровень яркости, калибровка затемнения необходима для обеспечения наилучшего качества работы и определения минимальной яркости конкретной лампы.

Длительность перехода

Этот параметр определяет время, необходимое устройству для регулировки яркости от 0% до 100% при включении и от 100% обратно до 0% при выключении. Введите длительность от 1 до 5 секунд.

Минимальная яркость при переключении

Установка процентного значения в этом поле гарантирует, что яркость устройства не упадет ниже указанного минимума при переключении. Если уровень яркости после переключения ниже указанного минимума, устройство автоматически отрегулирует яркость до этого минимального значения.

Предустановки кнопок

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

Защита

«Перегрузка в ваттах» — настройте реле переключателя Shelly на отключение при достижении определенного значения энергопотребления. Максимально допустимое значение мощности равно максимальному току, умноженному на максимальное напряжение.

Перегрузка по току в амперах - Если ток питания превысит определенное значение, канал будет выключен.

Перенапряжение в вольтах - Если напряжение питания превысит определенное значение, канал будет выключен.

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

Действия

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

Расписания

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

Существует два типа расписаний: «Базовое» и «Расширенное».

Чтобы создать «базовое» расписание:

Выберите день(ы) недели.
Выберите временной интервал: время, восход или закат.
Установите время для указанного дня(дней):
Время: Нажмите кнопку вверх/вниз или введите число, чтобы установить время в часах и минутах.
Закат/Восход: Устройство Shelly может автоматически включаться/выключаться (или выполнять указанное действие) на восходе/закате солнца или в указанное время до или после восхода/захода солнца. Нажмите кнопку вверх/вниз или введите число, чтобы установить время в часах и минутах.

Чтобы создать расширенное расписание:

Функция расширенного расписания использует «cron» для выполнения заданий с помощью одного расписания, вместо использования нескольких базовых расписаний.

Создание расширенного расписания отличается от создания базового расписания наличием меню «Когда выполнять».

Оно предлагает вам выбрать одно или несколько значений, диапазон значений или шаг между значениями (выберите один из трех вариантов, нажав кнопку «Выбрать», «Диапазон» или «Шаг» для каждого значения) для:

Секунд (0-59)
Минут (0-59)
Часов (0-23)
Дней (1-31)
Месяцев (январь-декабрь)
Дней недели (ВС-СБ)

Чтобы создать расписание, которое будет выполняться каждую секунду/минуту/час/день/месяц/будний день, просто поставьте галочку под значениями в нужном разделе (секунды, минуты, часы, дни, месяцы или будние дни). Кроме того, вы можете использовать смещение восхода/захода солнца, поставив галочку рядом с этой опцией. Это откроет новое меню с часами и минутами. Если оставить часы и минуты и выбрать восход или закат солнца, расписание будет выполняться точно в момент восхода или заката. Изменение значений часов и минут создаст смещение, поэтому ввод отрицательных значений приведет к выполнению расписания ровно за [установленное количество часов и/или минут] до восхода/захода солнца, а ввод положительных значений — за [установленное количество часов и/или минут] после восхода/захода солнца. Вы не можете ввести положительное значение для одного (часы/минуты) и отрицательное значение для другого.

После этого просто укажите действие, которое должно выполняться вашим устройством, в разделе «Действия». После завершения нажмите «Сохранить», чтобы сохранить новое расписание.

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

В обоих режимах отображаются действия сверху. Если действий больше трех, они отображаются как +n, где n — оставшееся количество не отображаемых действий. Чтобы включить/выключить расписание, используйте переключатель справа.

Таймеры

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

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

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

Имя

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

Включить

Установите флажок рядом с «Включить вход», чтобы иметь возможность использовать вход.

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

Выберите режим ввода:

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

Установка типа выхода:

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

Действие при включении питания:

Этот параметр обычно используется при отключении электроэнергии, а «включение питания» означает восстановление электроснабжения и повторное включение устройства.

Включить - При включении питания устройство включится.
Выключить - При включении питания устройство будет выключено.
Восстановить последнее известное состояние выхода/реле - При включении питания состояние выхода будет таким же, как и в последний раз, когда устройство было включено (до отключения электроэнергии).
Текущее состояние переключателя (только тумблерный переключатель) - Отслеживает состояние переключателя, поэтому, если он переключен в положение Если переключатель находится в положении «ВКЛ», устройство включится, и то же самое происходит, когда переключатель переведён в положение «ВЫКЛ».

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

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

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

Сброс к заводским настройкам

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

Настройки

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

Точка доступа — Настройте точку доступа (AP) устройства, установив флажок «Включить точку доступа» и задав пароль для защиты вашей сети от несанкционированного доступа. Точка доступа устройства по умолчанию является открытой сетью. SSID уникален и не может быть изменен.
Wi-Fi — Зарегистрируйте устройство Shelly для подключения к двум различным сетям Wi-Fi. Введите название сети 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.

Подключение

Примечание по связи 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.

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

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

Компоненты

Создание компонента

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

Чтобы создать компонент:

Нажмите кнопку «Создать новый» рядом с «Пользовательские компоненты».
Выберите тип компонента, который вы хотите создать — логический, числовой, текстовый, перечисление или кнопка. После создания каждый тип компонента будет иметь поля «Имя», «Вид» и «URL-адрес пользовательской иконки», которые необходимо заполнить. Поле «URL-адрес пользовательской иконки» не является обязательным, но его можно использовать для настройки внешнего вида компонентов на главной странице. Вы можете переименовать или удалить компонент, а также создать для него действия, используя кнопки, расположенные рядом с каждым компонентом.

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

Тип компонента «Boolean» хранит значение true/false и имеет два разных заголовка, которые пользователь может ввести в зависимости от того, истинно или ложно значение, а также два отдельных значка. Выпадающее меню для значения по умолчанию будет включать различные состояния вашего устройства. Варианты отображения: «Скрытый», «Переключатель» и «Метка». В режиме «Переключатель» отображается кнопка переключения, поэтому значение компонента изменяется при каждом нажатии. В режиме «Метка» отображается заголовок значения компонента.

Тип компонента «Number» хранит значения от -999999999999999 до 9999999999999999. Значение по умолчанию должно быть числом в этом диапазоне. Вы также можете изменить единицу измерения и шаг. Доступны следующие варианты отображения: «Скрытое», «Поле», «Ползунок», «Панель прогресса» и «Метка». Вариант «Поле» отображает поле ввода, вариант «Метка» — значение, вариант «Панель прогресса» — визуальное отображение прогресса, а вариант «Ползунок» — интерфейс ползунка для взаимодействия. Компонент типа «Текст» хранит строку длиной до 255 символов. Доступны следующие варианты отображения: «Скрытое», «Поле», «Метка» и «Изображение». Вариант «Поле» отображает поле ввода, вариант «Метка» — заголовок, а вариант «Изображение» требует указания URL-адреса для отображения изображения. Компонент типа «Перечисление» хранит группу именованных констант. Доступны следующие варианты отображения: «Скрытый», «Выпадающий список» и «Метка». Если вы выберете вариант «Метка», компонент по умолчанию будет отображать заголовок, но если указано изображение, оно будет иметь приоритет и отображаться вместо заголовка.

Компонент типа «Кнопка» предоставляет имитированный виртуальный ввод, позволяющий пользователям взаимодействовать с пользовательским интерфейсом, регистрируя и сообщая о кликах. Затем он отправляет уведомления через подключенные каналы и может использоваться для запуска автоматизации и активации веб-хуков. Он имеет два варианта отображения: «Кнопка», которая отображает компонент кнопки на главной странице, и «Скрытый».

Если компоненту установлен режим «Скрытый», он не будет отображаться на главной странице. В противном случае ваши группы компонентов будут отображаться под входами и/или выходами вашего устройства и будут отображать компоненты, входящие в эти группы.

Создание группы компонентов

Чтобы создать группу:

Щелкните значок «+» рядом с «Пользовательские группы», и вы перейдете в меню создания группы.
Введите имя группы.
Выберите необходимые компоненты, которые вы хотите включить в эту группу.

Редактирование меню групп осуществляется с помощью значка карандаша рядом со значком «+», и вы можете изменить порядок групп, щелкая стрелки вверх и вниз, чтобы переместить группу вверх или вниз.

Действия с компонентами

Меню «Действия» теперь структурировано по типу компонента. Таким образом, вы можете создавать действия для своих компонентов, и они будут разделены на пять вышеупомянутых категорий.

Скриптинг

Компоненты можно включать в скрипты и программировать на изменение значений в зависимости от условия. Чтобы указать компонент в скрипте, вам нужно использовать его идентификатор (ID). Идентификаторы компонентов начинаются с 200 и ограничены 299. Вы сможете увидеть идентификатор вашего компонента в меню «Компоненты».

Компоненты BTHome

Компоненты BTHome позволяют создавать виртуальные/динамические компоненты, сопряженные с реальными устройствами, излучающими пакеты BTHome, такими как устройства Shelly BLU. Для использования компонентов BTHome необходимо сначала установить успешное соединение Bluetooth. Если наблюдатель Bluetooth отключен, появится сообщение с информацией о том, что он отключен, а также кнопка для его включения и перезагрузки устройства.

После установления соединения, чтобы добавить устройство BTHome (Bluetooth), нажмите на знак «+» рядом с «Компонентами BTHome». Устройство выполнит поиск доступных устройств Bluetooth, но вы можете нажать кнопку «Сканировать», чтобы выполнить сканирование еще раз. Все найденные устройства отобразятся под этой кнопкой. Для того чтобы устройство было об В разделе «Настройки многоадресной рассылки» введите IP-адрес (обозначаемый как «Адрес») группы многоадресной рассылки, в которой должно работать ваше устройство. Диапазон адресов — от 224.0.0.0 до 239.255.255.255. Параметр «Порт» указывает номер порта в этой группе многоадресной рассылки, через который происходит обмен данными. Вместе они определяют место назначения многоадресных сообщений в сети.

Входы

В зависимости от устройства количество входов в этом меню будет различаться. Для каждого входа выберите «Состояние входа», которое может быть «Переключатель», «Кнопка» или, специально для устройств с регулировкой яркости, «Регулировка яркости одной кнопкой» или «Регулировка яркости двумя кнопками». В зависимости от ранее выбранного состояния входа, вы увидите один или несколько объектов, а также текст справа от объекта, указывающий его размер и тип данных. Для различных режимов входа они следующие:

«Переключатель» — имеет один объект, называемый «Объект переключателя», размером 1 бит и DPT (тип точки данных) 1.001, что означает тип переключателя с двумя состояниями — включено/выключено (1/0). С помощью кнопки «Добавить» можно добавить до трех объектов Switch.
«Кнопка» — Сначала выберите функцию для кнопки: «ВКЛ», «ВЫКЛ» или «Переключение». Состояние ввода кнопки имеет два объекта: объект «Однократное нажатие» и объект «Обратная связь». С помощью кнопки «Добавить» можно добавить до трех объектов «Однократное нажатие» и один объект «Обратная связь». Оба объекта имеют тип Switch, размер 1 бит и DPT (тип точки данных) 1.001, что означает тип переключателя с двумя состояниями — включено/выключено (1/0). Объект «Обратная связь» может совпадать с объектом «Однократное нажатие», или для него можно ввести другой адрес, что делается путем снятия флажка с параметра «Тот же, что и объект «Однократное нажатие»» и ввода нового адреса.
«Однократное затемнение» — Сначала выберите шаг затемнения в диапазоне от «полного затемнения» до «затемнения 1/64». Это изменяет скорость затемнения. Полное затемнение будет самым быстрым, поскольку оно будет затемнять от 0 до 100% с заданной скоростью, тогда как затемнение 1/64 будет затемнять на 1/64 от полного затемнения в течение того же времени. Это состояние ввода имеет три объекта — объект «Однократное нажатие», объект «Длительное нажатие» и объект «Обратная связь». С помощью кнопки «Добавить» можно добавить до трех объектов «Одиночное нажатие» и «Длительное нажатие», а также один объект «Обратная связь», который может быть идентичен объекту «Одиночное нажатие» или для него можно ввести другой адрес, сняв флажок «Идентичен объекту «Одиночное нажатие»» и введя новый адрес. Объекты «Одиночное нажатие» и «Обратная связь» имеют тип «Переключатель» размером 1 бит и DPT (тип точки данных) 1.001, что означает тип переключателя с двумя состояниями — включено/выключено (1/0). Объект «Длительное нажатие» предназначен для управления затемнением, имеет размер 4 бит и DPT (тип точки данных) 3.007. Объект «Управление затемнением» состоит из двух значений — одно указывает на увеличение (1) или уменьшение (0), а другое соответствует шагу затемнения.
«Двухкнопочное затемнение» — Сначала выберите шаг затемнения, от «полного затемнения» до «затемнения 1/64». Это изменяет скорость затемнения. Полное затемнение будет самым быстрым, поскольку оно будет затемнять от 0 до 100% с заданной скоростью, тогда как затемнение 1/64 будет затемнять на 1/64 от полного затемнения за то же время. Затем выберите направление затемнения — вверх/включить или вниз/выключить. Это состояние ввода имеет два объекта — объект «Однократное нажатие» и объект «Длительное нажатие». Вы можете добавить до трех объектов «Однократное нажатие» и «Длительное нажатие», используя кнопку «Добавить». Объект «Одиночное нажатие» имеет тип «Переключатель», размер 1 бит и DPT (тип точки данных) 1.001, что означает тип переключателя с двумя состояниями — включено/выключено (1/0). Объект «Длительное нажатие» предназначен для управления затемнением, имеет размер 4 бит и DPT (тип точки данных) 3.007. Объект «Управление затемнением» состоит из двух значений — одно для обозначения увеличения (1) или уменьшения (0), и одно, соответствующее шагу.

Выходы

Меню выходов разделено на три раздела — «Команды», «Обратная связь» и «Измерения». Для каждого типа объекта в разделе «Команды» можно иметь до пяти объектов. Вот типы объектов, которые есть в каждом разделе:

Команды:

Объект переключателя — имеет размер 1 бит и DPT 1.001, что означает тип переключателя с двумя состояниями — включено/выключено (1/0).

Обратная связь:

Объект обратной связи — имеет размер 1 бит и DPT 1.001, что означает тип переключателя с двумя состояниями — включено/выключено (1/0). Объект «Обратная связь» используется для сообщения о состоянии устройства.

Измерения (Размер этих типов объектов составляет 4 байта):

Объект «Напряжение» — имеет DPT 14.027, что соответствует объекту «Электрический потенциал» типа Double с тремя значениями.
Объект «Ток» — имеет DPT 14.019, что соответствует объекту «Электрический ток» типа Double с тремя значениями.
Объект «Активная мощность» — имеет DPT 14.056, что соответствует объекту «Мощность» типа Double с тремя значениями.
Объект «Активная энергия» — имеет DPT 13.010, что соответствует объекту «Активная энергия» типа long, измеряемому в ватт-часах.

В зависимости от устройства в разделах могут присутствовать дополнительные типы объектов, такие как как:

Команды:

Объект относительного затемнения — имеет размер 4 бита и DPT 3.007, что означает объект «Управление затемнением», состоящий из двух значений — одно для обозначения увеличения (1) или уменьшения (0), и одно, соответствующее шагу.
Объект абсолютного затемнения — имеет размер 1 байт и DPT 5.001, что означает объект «Масштабирование», состоящий из значения от 1 до 100, представляющего проценты.

Измерения(Эти типы объектов имеют размер 4 байта.):

Объект генерируемой энергии — имеет DPT 13.010, что означает объект «Активная энергия» типа long, измеряемая в ватт-часах.

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

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

KVS

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

Диагностика

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

HTTP-пинг

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

Клиенты устройств

Просмотрите устройства, подключенные к вашему устройству, отсортированные по соответствующим категориям. Для большинства устройств есть два варианта:

Клиенты Bluetooth - устройства, подключенные к вашему устройству через Bluetooth.
Клиенты AP - устройства, подключенные к точке доступа вашего устройства.

В этом меню вы сможете увидеть информацию о клиентах."""