Инструмент массовой настройки Shelly BLU Assistant

Быстрая массовая настройка устройств Shelly

«Помощник Shelly BLU» — это компактное устройство с питанием от USB, предназначенное для быстрой и простой настройки, конфигурации и управления устройствами Shelly Gen2+. Работая на основе движка Shelly Script и оснащенное двумя программируемыми кнопками, оно позволяет создавать широкий спектр автоматизированных рабочих процессов управления устройствами, идеально подходящих как для небольших, так и для массовых развертываний. Рассматривайте его как ваш персональный пульт дистанционного управления для «массовой настройки» устройств Shelly второго поколения (и более новых).

«Внимание» Помощник не настраивает автономные датчики Shelly BLU. Однако он использует BTHome для подключения к ним и проверки их показаний в режиме реального времени.

==== Для кого это предназначено? ====\n

• Установщики развертывают целые парки устройств в новых зданиях.

• Поклонники умного дома тонко настраивают каждую деталь своих систем.

• Техники на местах, которым нужен надежный гаджет для настройки без ноутбука.

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

Краткий обзор оборудования

Ассистент прост по своей конструкции. Вот с чем вы будете работать:

USB-A штекер - Просто подключите его к любому USB-порту 5 В 1 А для питания.

BTN 1 - Ваша первая волшебная кнопка! Вы можете назначить любой скрипт на ее короткое, длительное или двойное нажатие.

BTN 2 — Ваша вторая волшебная кнопка, такая же настраиваемая, как и первая.

Светодиод — Индикатор подключения BLE.

==== Технические характеристики ====\n

• Подключение: Встроенный модуль Wi-Fi (802.11b/g/n @2.4GHz) создает собственную точку доступа или подключается к вашей сети, а Bluetooth 5.1LE передает команды настройки ближайшим устройствам Shelly.

Безопасность прежде всего:  Храните Assistant в сухом месте, вдали от источников сильного нагрева, и подключайте его только к стандартному USB-порту 5 В.

Начало работы

Начать работу легко:

1. Включение: Подключите Shelly BLU Assistant к порту USB-A. Подождите около 5 секунд, пока он включится.

1. Подключение к Wi-Fi: На телефоне или ноутбуке найдите сеть Wi-Fi с названием ShellyBLUAssist-xxxxxx и подключитесь к ней. Пароль не потребуется.

1. Запуск веб-интерфейса: Откройте браузер и перейдите по адресу http://192.168.33.1. Вот и все! Вы вошли.

Необязательно — добавьте Ассистента в вашу локальную сеть В веб-консоли перейдите в Настройки ▸ Wi-Fi , выберите свою сеть 2,4 ГГц и введите ее пароль. Ассистент появится в вашей домашней сети как клиентское устройство. Предпочитаете автономный инструмент в дороге? Просто оставьте его в режиме точки доступа.

Ваша панель управления: Веб-интерфейс

Веб-интерфейс — это ваш центр управления, состоящий из четырех разделов.

• Избранное: Есть устройства, которые вы часто используете? Отметьте их звездочкой в ​​списке результатов, и они будут отображаться здесь. Вы можете закрепить до шести избранных устройств, дать им легко запоминающиеся имена и даже создать до четырех пользовательских кнопок действий для каждого из них.

• Поиск устройств Shelly: Здесь вы начнете большинство задач. Фильтры: Быстро находите то, что ищете. Вы можете фильтровать по ID модели, искать по Имени устройства или установить порог RSSI (дБм), чтобы игнорировать устройства, находящиеся слишком далеко. Сортировка: Отсортируйте список по уровню сигнала ( RSSI ) или в алфавитном порядке по Имени устройства . Сканирование: Нажмите эту кнопку, чтобы начать поиск ближайших устройств.

• Отправить RPC: Здесь происходит пакетное управление. Вы можете обновлять/взаимодействовать с несколькими устройствами одновременно. Просто отметьте галочками устройства, которым хотите отдать команду. Начните вводить команду. Интерфейс интеллектуальный, он будет автоматически предлагать допустимые команды для выбранного типа устройства, поэтому вы не ошибетесь. При необходимости добавьте параметры в формате JSON. Нажмите «Отправить», и помощник подключится к нескольким устройствам одновременно. Мы можем работать с 5 устройствами одновременно.

• Панель результатов: Каждое обнаруженное устройство отображается в виде карточки с ключевыми статистическими данными. При отправке команды индикатор выполнения показывает статус каждого устройства; разверните карточку для получения подробной информации об успехе/неудаче.

Что с ним можно делать?

Ассистент Shelly BLU — это помощник в решении проблем. Вот несколько идей для начала:

Что вы хотите сделать	Как Ассистент упрощает задачу	Идеально подходит для...
Настройка нового блока устройств	Загрузите скрипт добавления Wi-Fi, подойдите к новым устройствам и нажмите одну кнопку. Ассистент найдет их и подключит к вашей сети Wi-Fi. Готово.	Профессиональные установщики
Обновление всего сразу	Используйте веб-интерфейс, чтобы выбрать все ваши устройства и отправить команду Shelly.Update. Сходите выпить кофе, пока Ассистент проверяет, работает ли все устройства с последней версией прошивки.	Энтузиасты умного дома, установщики
Работа на выезде	Положите в сумку Assistant и внешний аккумулятор. Теперь у вас есть мощный портативный набор инструментов для настройки устройств на месте, даже без интернета.	Выездные техники
Создание инвентарных этикеток	Представьте себе скрипт, который находит устройство, получает его уникальный идентификатор и дает указание сетевому принтеру распечатать идеально отформатированную инвентарную этикетку. Assistant может это сделать.	Склады, производство
«Клонируйте» свою идеальную конфигурацию	Сохраните «золотую конфигурацию» в виде скрипта. При добавлении нового устройства просто запустите скрипт, чтобы мгновенно применить свой шаблон для идеально согласованной настройки.	Монтажники, ИТ-специалисты
Управление гостевым доступом	Для вашего Airbnb или офиса используйте скрипт для установки временного доступа к устройствам Shelly. Когда ваши гости уходят, еще одно нажатие кнопки может сбросить все для следующего человека.	Управление недвижимостью

Секретный ингредиент: Скриптинг

Вот что делает Shelly BLU Assistant великолепным. Встроенный Shelly Script Engine (на базе Espruino) позволяет автоматизировать практически все: У вас есть прямой доступ к:

• Сканированию ближайших устройств по Bluetooth
• Настройке любых параметров через RPC
• Хранению и извлечению данных во флэш-памяти
• Реагированию на короткие, длинные или двойные нажатия кнопок BTN 1 / BTN 2

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

Здесь вы найдете все подробности о скриптах Shelly: ссылка Здесь вы найдете наш репозиторий с примерами: ссылка

==== Примеры скриптов для вдохновения ====\n Чтобы разбудить ваше воображение, мы включили несколько готовых скриптов. Они станут отличной отправной точкой для ваших собственных разработок. Вы можете модифицировать их в соответствии со своими потребностями, например, для сканирования всех устройств, а не только определенного.

Установка скриптов на ваше устройство Готовы попробовать? Установить эти скрипты на ваш Assistant очень просто:

1. Подключитесь к Assistant и откройте веб-интерфейс.

1. Перейдите в раздел «Скрипты».

1. Нажмите, чтобы создать «Новый скрипт» и дайте ему имя.

1. Скопируйте и вставьте код скрипта, который хотите добавить, затем нажмите «Сохранить».

1. Запустите его из пользовательского интерфейса или нажав физическую кнопку, к которой он привязан!

Часть 1: Демонстрационные скрипты

Эти четыре скрипта составляют основу демонстрации. Сначала вы запускаете автоматическую настройку, затем используете настройку Wi-Fi, полную конфигурацию и конфигурацию MQTT для этих вновь созданных виртуальных полей/кнопок.

==== Автоматическая настройка виртуальных компонентов (create-demo-virtual-components.js) ====\n «Что он делает» Этот скрипт одноразовой настройки создает «все» виртуальные кнопки и текстовые поля, от которых зависят другие ваши скрипты. Никакой ручной работы с пользовательским интерфейсом — просто запустите один раз, и всё готово.

Как использовать

1. Откройте веб-интерфейс и перейдите в раздел «Скрипты».

1. Создайте новый скрипт с именем «Автоматическая настройка виртуальных компонентов».

1. Вставьте код из скрипта create-demo-virtual-components.

1. Сохраните и запустите.

После завершения скрипт автоматически остановится, и на главном экране вы увидите группы и компоненты, такие как:

• Настройка сети (IDs: text:200, text:201, text:202, button:200, text:211)
• Конфигурация устройства (text:200–204, button:201, text:211)
• Конфигурация MQTT (text:200,205–211, button:202)

==== Настройка Wi-Fi ( add-to-wifi.js ) ====\n

• Что делает: Находит находящиеся поблизости устройства Shelly и подключает их к сети Wi-Fi, указанной в пользовательском интерфейсе.

• Почему это круто: Он обрабатывает устройства небольшими, интеллектуальными партиями и даже повторяет попытку, если устройство не подключается с первого раза. Его действие предварительно назначено на короткое нажатие кнопки 1.

• Как использовать: После запуска скрипта настройки виртуального компонента просто введите: Имя Wi-Fi (SSID) в поле, связанном с text:201 . Пароль Wi-Fi в поле, связанном с text:202 . Идентификатор BLE устройства (например, 0x 1800) в поле, связанном с text:200 .

Затем нажмите системную кнопку (Кнопка 1) или виртуальную кнопку, связанную с кнопкой:200 (Подключиться к Wi-Fi)

==== Полная настройка и обновление устройства (full-config.js) ====\n

• Что делает: Этот скрипт — отличный пример многоэтапного рабочего процесса. Он находит ближайшее конкретное устройство, подключает его к Wi-Fi, ждет, пока оно подключится к сети, переименовывает его, устанавливает часовой пояс и, наконец, проверяет, требуется ли обновление прошивки.

• Почему это круто: Он показывает, как объединять команды, некоторые по порядку, некоторые одновременно, для максимальной эффективности.

• Как использовать: Отредактируйте скрипт напрямую, чтобы установить желаемые значения: Идентификатор BLE целевого устройства (например, 0x1018) в FILTERED_BLE_ID, связанный с text:200 . Новое имя устройства в DEVICE_NAME, связанный с text:203 . SSID сети Wi-Fi в WIFI_SSID, связанный с text:201 . Пароль Wi-Fi в WIFI_PASS, связанный с text:202 . Часовой пояс устройства (например, Европа/София) в LOCATION_TZ, связанный с text:204 .

Затем запустите скрипт, нажав системную кнопку (Кнопка 1) или виртуальную кнопку, связанную с кнопка:201(Настройка устройства)

!

==== Конфигурация MQTT ( config-mqtt.js ) ====\n

• Что делает: Этот продвинутый скрипт находит ближайшее устройство Shelly с указанным BLE ID и полностью настраивает его для взаимодействия с MQTT-брокером, в данном случае AWS, включая необходимые сертификаты безопасности.

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

• Как использовать: Перед запуском необходимо разместить файлы пакета CA, клиентского сертификата и закрытого ключа клиента на веб-сервере, доступном для устройства Shelly, на котором запущен этот скрипт. Затем отредактируйте скрипт напрямую, чтобы задать свои пользовательские параметры: Идентификатор BLE целевого устройства (например, 0x1018) в FILTERED_BLE_ID, связанный с text:200 . Адрес и порт MQTT-сервера в MQTT_SERVER, связанный с text:205 . Идентификатор MQTT-клиента в MQTT_CLIENT_ID, связанный с text:206 . Префикс темы MQTT в MQTT_PREFIX, связанный с text:207 . URL-адреса ваших файлов сертификатов ( CA_BUNDLE, связанный с text:208 CLIENT_CERT, связанный с text:209 CLIENT_KEY, связанный с text:210

Наконец, запустите скрипт, нажав системную кнопку (Кнопка 1) или виртуальную кнопку, связанную с кнопкой:202 (Конфигурация MQTT) !

Часть 2: Дополнительные примеры скриптов

⚠️ Коллизии идентификаторов: Все приведенные ниже скрипты предполагают наличие виртуальных полей/кнопок из демонстрации. Если вы копируете/изменяете какой-либо пример, всегда обновляйте текст:

или кнопку:

чтобы два скрипта не пытались использовать один и тот же компонент пользовательского интерфейса одновременно.

==== Сброс к заводским настройкам ( factory-reset-device.js ) ====\n

• Что делает: Выдает команду сброса до заводских настроек всем конкретным находящимся поблизости устройствам Shelly, которые вы хотите очистить.

• Почему это круто: Как и скрипт Wi-Fi, он надежен, со встроенной логикой повторных попыток. Он предварительно назначен на короткое нажатие кнопки 2.

• Как использовать: После запуска скрипта настройки просто введите свой: ID BLE устройства (например, 1800) в поле, связанное с text:200.

Затем нажмите системную кнопку (кнопка 2) или виртуальную кнопку, связанную с кнопкой:201 (Сброс) !

==== Обновление Gen3 Matter ( gen3-update-matter.js ) ====\n

• Что делает: Это мощный универсальный скрипт для полной модернизации ваших устройств Shelly Gen3 и подготовки их к работе с Matter. Он автоматизирует весь процесс: подключение к Wi-Fi, проверку текущей прошивки, запуск обновления при необходимости, перезагрузку и, наконец, включение поддержки Matter.

• Почему это круто: Это действительно решение «запустил и забыл». Он работает на нескольких устройствах одновременно, интеллектуально проверяет, требуется ли обновление вообще, и повторяет каждый шаг, если что-то пошло не так. Это самый простой способ выполнить сложное многоэтапное обновление всего вашего парка устройств Gen3.

• Как использовать: Измените значения WIFI_SSID и WIFI_PASS в верхней части скрипта в соответствии с вашей сетью. Затем просто нажмите назначенную вам кнопку. Скрипт найдет все ближайшие устройства с сильным сигналом и начнет автоматизированный процесс.

==== Инвентаризация Наклейки с сетевым принтером (print_script.js) ====\n

• Что делает: Этот скрипт превращает ваш Shelly BLU Assistant в мобильную станцию ​​для нанесения этикеток! Он находит ближайшее устройство Shelly, получает указанные данные, помещает их в шаблон ZPL и отправляет на подключенный к сети принтер этикеток для мгновенного создания физической наклейки.

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

• Как использовать: Сначала убедитесь, что вы запустили скрипт автоматической настройки виртуальных компонентов для создания необходимых полей пользовательского интерфейса. Затем в веб-интерфейсе введите IP-адрес вашего ZPL-совместимого принтера (подходят многие модели Argox или Zebra). Отредактируйте шаблон, указав необходимые данные, и запустите скрипт.

• Как использовать: Запустите автоматическую настройку виртуальных компонентов: Убедитесь, что вы запустили скрипт первоначальной настройки для создания необходимых полей ввода пользовательского интерфейса. Введите Идентификатор BLE целевого устройства (например, 0x1018) в поле, связанное с text:200. Введите HTTP/IP-адрес вашего сетевого принтера, совместимого с ZPL в поле, связанное с text:204. (Необязательно) Настройка метки: Вы можете напрямую редактировать переменную zpl_template в скрипте, чтобы настроить макет или содержимое метки.

Наконец, запустите скрипт, нажав системную кнопку (Кнопка 1) или виртуальную кнопку, связанную с button:202 !

==== Мост веб-перехватчика для датчика двери/окна BLU (bthome-webhook.js) ====\n

• Что делает: Этот скрипт превращает ваш Shelly BLU Assistant в мост для умного дома. Он «слушает» открытие или закрытие датчика двери/окна Shelly BLU, а затем мгновенно отправляет команду (веб-хук) по Wi-Fi на другое устройство, например, выключатель света, умную розетку или сирену.

• Почему это круто: Он позволяет создавать простые, но мощные автоматизации без необходимости использования сложного центра управления умным домом или облачных сервисов. Например: «Когда открывается задняя дверь, включить свет на террасе» или «Если открывается аптечка, включить звонок». Вся логика выполняется локально и мгновенно на вашем Assistant.

• Как использовать: Настроить его очень просто. Найдите ID вашего датчика двери/окна BLU и введите его в поле WINDOW_SENSOR_ID. Получите URL-адреса веб-хуков для устройства, которым вы хотите управлять. Подходит для большинства устройств Shelly. Сделайте это проще — URL-адреса для включения или выключения выключателя находятся прямо в настройках устройства. Вставьте эти URL-адреса в поля WINDOW_OPEN_WEBHOOK и WINDOW_CLOSE_WEBHOOK. Загрузите скрипт в свой Ассистент, и ваша новая автоматизация будет запущена!

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