Руководство по веб-интерфейсу Shelly Plus Wall Dimmer

Обзор

Устройства 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, облака и MQTT. Вот что означают разные цвета состояния:

Тип	Значение
Значок AP	Серый: режим AP отключен. Синий: режим AP включен.
Значок Wi‑Fi	Серый: соединение Wi‑Fi отключено. Белый: соединение Wi‑Fi включено, но не установлено. Синий: устройство подключено к Wi‑Fi.
Значок Bluetooth	Серый: соединение отключено. Синий: соединение включено.
Значок облака	Серый: подключение к облаку Shelly отключено. Белый: подключение к облаку Shelly включено, но не установлено. Синий: устройство подключено к облаку Shelly.
Значок MQTT	Серый: MQTT отключен. Синий: MQTT включен.
Значок обновления прошивки	Синий: для вашего устройства доступна новая стабильная версия прошивки. Не отображается: прошивка устройства обновлена.
Значок подключения WebSocket	Синий: WebSocket подключен. Серый: WebSocket не подключен. На главной странице веб‑интерфейса вы увидите кнопку включения/выключения устройства, а также ползунок регулировки яркости. Есть два меню — одно слева, другое сверху.

Настройки - Настройки освещения

В меню настроек в верхней части главной страницы вы найдете настройки освещения.

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

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

Ночной режим

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

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

Установите действие, которое ваше устройство должно выполнять при включении питания. Вы можете отключить эту настройку или выбрать «Восстановить последнее», чтобы восстановить последнее действие, выполненное вашим устройством.

Светодиодные индикаторы

Светодиодный индикатор Wi-Fi — По умолчанию устройство имеет сигнальный индикатор за кнопкой питания, который отображает его состояние подключения к Wi-Fi. Если устройство подключено, синий индикатор будет гореть постоянно. Вы можете его выключить.
Светодиодный индикатор питания — За кнопкой питания находится белый светодиод, который по умолчанию загорается, когда диммер включен. Эта настройка называется «Соответствие входу». Чтобы настроить включение света при выключенном диммере, выберите параметр «Инвертированный вход». Вы также можете полностью выключить свет или оставить его включенным постоянно.

Действия

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

Расписания

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

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

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

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

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

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

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

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

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

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

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

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

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

Таймеры

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

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

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

Эти настройки находятся в меню слева и относятся к устройству.

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

Точка доступа - Настройте точку доступа устройства, включая ее включение или выключение и установку пароля. Точка доступа устройства по умолчанию является открытой сетью. SSID уникален и не может быть изменен.
Wi-Fi - Зарегистрируйте устройство Shelly для подключения к двум различным сетям Wi-Fi. Введите или выберите сеть Wi-Fi. Можно выбрать открытую сеть, а также установить статический IP-адрес. Включить Wi-Fi 1, Wi-Fi 2 или оба одновременно. Если включены и Wi-Fi 1, и Wi-Fi 2, и устройство Shelly отключается от одной из сетей, оно подключится к другой.
Bluetooth - Включить/отключить Bluetooth, переключив тумблер. Включена настройка Bluetooth по умолчанию.

Подключение

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

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

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

Скрипты

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

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

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

KVS

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

Диагностика

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

HTTP ping

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