Shelly X MOD1 web interface guide

КомпонентыСоздание компонентаНастройка «Компоненты» позволяет пользователю создавать динамические компоненты, которые изначально не существуют на устройстве. Виртуальные компоненты, тип динамических компонентов, используются для хранения или передачи данных между скриптами или запусками и отображения функциональности скрипта на главной странице. Компоненты можно группировать; на главной странице будут отображаться только группы и компоненты внутри них. Компоненты, не входящие в группу, там отображаться не будут. Количество компонентов и групп компонентов на устройстве ограничено.Чтобы создать компонент:Нажмите кнопку «Создать новый» рядом с «Пользовательские компоненты».Выберите тип компонента, который вы хотите создать — логический, числовой, текстовый, перечисление или кнопка. После создания каждый тип компонента имеет поля «Имя», «Вид» и «URL-адрес пользовательского значка», которые необходимо заполнить. Поле «URL-адрес пользовательского значка» не является обязательным, но его можно использовать для настройки внешнего вида ваших компонентов на главной странице. Вы можете переименовывать или удалять компоненты, а также создавать для них действия, используя кнопки, расположенные рядом с каждым компонентом. Различные типы компонентов могут иметь дополнительные поля, специфичные для этого типа. Они описаны ниже. Компонент типа Boolean хранит значение true/false и имеет два разных заголовка, которые пользователь может ввести в зависимости от того, истинно или ложно его значение, а также два отдельных значка. Выпадающее меню для значения по умолчанию будет включать различные состояния вашего устройства. Варианты отображения: Hidden, Toggle и Label. В режиме Toggle отображается кнопка-переключатель, поэтому значение компонента изменяется при каждом нажатии. В режиме Label отображается заголовок значения компонента. Компонент типа Number хранит значения от -999999999999999 до 9999999999999999. Значение по умолчанию должно быть числом в этом диапазоне. Вы также можете изменить единицу измерения и шаг. Варианты отображения: Hidden, Field, Slider, Progress bar и Label. Компонент FieldView отображает поле ввода, компонент LabelView отображает значение, компонент ProgressBarView визуально отображает прогресс, а компонент SliderView отображает интерфейс слайдера для взаимодействия. Компонент TextView хранит строку длиной до 255 символов. Варианты отображения: Hidden, Field, Label и Image. Компонент FieldView отображает поле ввода, компонент LabelView отображает заголовок, а компонент ImageView требует URL-адрес, который используется для отображения изображения. Компонент EnumView хранит группу именованных констант. Варианты отображения: Hidden, Dropdown и Label. Если вы выберете LabelView, компонент по умолчанию будет отображать заголовок, но если указано изображение, оно будет иметь приоритет и будет отображаться вместо заголовка. Компонент ButtonView предоставляет имитированный виртуальный ввод, который позволяет пользователям взаимодействовать с пользовательским интерфейсом, регистрируя и сообщая о кликах. Затем он отправляет уведомления через подключенные каналы и может использоваться для запуска автоматизации и активации веб-хуков. Доступны два варианта отображения: «Кнопка», при котором компонент кнопки отображается на главной странице, и «Скрытый». Если компонент установлен в значение «Скрытый», он не будет отображаться на главной странице. В противном случае группы компонентов будут отображаться под входами и/или выходами вашего устройства и будут отображать компоненты, входящие в эти группы. Создание группы компонентов. Чтобы создать группу: Щелкните значок «+» рядом с «Пользовательские группы», и вы перейдете в меню создания группы. Введите название группы. Выберите необходимые компоненты, которые вы хотите включить в эту группу. Редактирование меню групп осуществляется с помощью значка карандаша рядом со значком «+», и вы можете изменить порядок групп, щелкая стрелки вверх и вниз, чтобы переместить группу вверх или вниз. Действия с компонентами. Меню «Действия» теперь структурировано по типу компонента. Таким образом, вы можете создавать действия для своих компонентов, и они будут разделены на пять вышеупомянутых категорий. Компоненты можно включать в скрипты и программировать на изменение значений в зависимости от условия. Чтобы указать компонент в скрипте, вам нужно использовать его идентификатор. Идентификаторы компонентов начинаются с 200 и ограничены 299. Вы сможете увидеть идентификатор своего компонента в меню «Компоненты». Компоненты BTHome позволяют создавать виртуальные/динамические компоненты, сопряженные с реальными устройствами, излучающими пакеты BTHome, такими как устройства Shelly BLU. Для использования компонентов BTHome необходимо сначала установить успешное соединение Bluetooth. Появится сообщение, информирующее вас о том, отключен ли наблюдатель Bluetooth, а также кнопка для его включения и перезагрузки устройства. После установления соединения, чтобы добавить устройство BTHome (Bluetooth), нажмите на знак «+» рядом с компонентами BTHome. Устройство будет сканировать доступные устройства Bluetooth, но вы можете нажать кнопку «Сканировать», чтобы выполнить сканирование еще раз. Все найденные устройства отобразятся под этой кнопкой. Для того чтобы устройство было обнаружено во время сканирования, оно должно находиться в режиме сопряжения, что достигается удерживанием кнопки устройства. Другой вариант добавления устройства — использование MAC-адреса. Для этого нажмите «Добавить устройство по MAC-адресу» и введите MAC-адрес устройства, которое вы хотите добавить. Чтобы добавить датчики, нажмите «Настроить» рядом с выбранным вами устройством Bluetooth. На этом экране вы можете присвоить имя своему устройству BTHome (Bluetooth), добавить ключ шифрования, а также ввести URL-адрес пользовательского значка, чтобы настроить внешний вид компонента BTHome на главной странице. Ключ шифрования используется для расшифровки пакетов и может быть получен с помощью приложения Shelly BLU Debug. Ниже поля ключа шифрования указаны поддерживаемые датчики, которые вы можете добавить, нажав знак «+» рядом с теми, которые вы хотите добавить. После добавления рядом с датчиком появляется значок карандаша, и, щелкнув по нему, вы можете изменить его имя, добавить URL-адрес пользовательского значка или использовать значок корзины для полного удаления датчика. Чтобы сохранить компонент BTHome, нажмите «Сохранить настройки». Чтобы удалить компонент, щелкните значок корзины над текстовыми полями. Чтобы отредактировать компонент BTHome, щелкните значок шестеренки. Вы перейдете к его настройкам, которые представляют собой тот же экран, что и при добавлении компонента. Расширенные настройки. Щелкнув стрелку рядом с этой настройкой, вы увидите расширенные настройки. Они описаны ниже. KVSKVS расшифровывается как Key-Value Storage (хранилище ключ-значение) и представляет собой тип нереляционной базы данных, которая работает с использованием простого метода ключ-значение для хранения данных. В одном устройстве можно хранить до 50 пар ключ-значение. После нажатия кнопки «Добавить значение» вы перейдете на экран создания значения, где вам будет предложено ввести ключ (до 42 символов) и значение (до 253 символов). Под текстовым полем для значения вы увидите текущий тип значения. По умолчанию тип значения — «Число», но при вводе текста тип изменится на «Строка». Чтобы сохранить ключ, просто нажмите кнопку «Сохранить». Чтобы отредактировать существующее значение, просто щелкните по нему. Чтобы удалить пару ключ-значение, нажмите кнопку «Удалить», которая появится под ним при редактировании ключа. Нажатие на вопросительный знак рядом с названием параметра переведет вас к документации API, которая предоставит вам дополнительную информацию о том, как работает KVS для устройств Shelly. == Диагностика == Из этого параметра вы можете загрузить журналы отладки. Включение журнала отладки без причины не рекомендуется, так как это замедлит работу вашего устройства и приведет к старению флэш-памяти. Если вы решите включить эту функцию, вы также сможете загрузить предыдущие и текущие журналы. Имейте в виду, что при выходе с этой страницы данные журнала будут сброшены. === HTTP-пинг === Введите URL-адрес в соответствующее текстовое поле, чтобы отправить HTTP-запрос с вашего устройства. Веб-интерфейс сообщит вам, был ли запрос успешным или нет. Клиенты устройства. Просмотрите устройства, подключенные к вашему устройству, отсортированные по категориям. Для большинства устройств есть два варианта: клиенты Bluetooth — устройства, подключенные к вашему устройству через Bluetooth; клиенты AP — устройства, подключенные к точке доступа вашего устройства. В этом меню вы сможете увидеть информацию о клиентах.