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

Shelly BLU Assistant — быстрая массовая настройка устройств Shelly

Shelly BLU Assistant — компактное USB-устройство на базе Shelly Script Engine для быстрой настройки, конфигурации и управления устройствами Shelly Gen2+. Оснащён двумя программируемыми кнопками и поддерживает широкий спектр автоматизированных рабочих процессов — от настройки одного устройства до массового развёртывания парка.

Устройство не настраивает автономные датчики Shelly BLU, однако использует протокол BTHome для подключения к ним и проверки показаний в реальном времени.

Для кого предназначен

Установщики — развёртывание парков устройств в новых зданиях.
Энтузиасты умного дома — тонкая настройка каждого элемента системы.
Выездные техники — настройка без ноутбука на месте.
Преподаватели и разработчики — быстрое создание демонстрационных стендов и учебных комплектов.

Оборудование

Компонент	Описание
USB-A штекер	Питание от любого USB-порта 5 В / 1 А
BTN 1	Программируемая кнопка: короткое, длинное или двойное нажатие
BTN 2	Программируемая кнопка: короткое, длинное или двойное нажатие
Светодиод	Индикатор состояния BLE-подключения

Технические характеристики

Wi-Fi: 802.11b/g/n @ 2,4 ГГц — режим точки доступа или клиента.
Bluetooth: 5.1 LE — передача команд настройки ближайшим устройствам Shelly.
Хранить в сухом месте, вдали от источников сильного нагрева; подключать только к стандартному USB-порту 5 В.

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

Подключите Assistant к USB-порту. Подождите ~5 секунд до загрузки.
На телефоне или ноутбуке подключитесь к Wi-Fi сети ShellyBLUAssist-xxxxxx (пароль не требуется).
Откройте браузер и перейдите по адресу 192.168.33.1.

Опционально — подключение к локальной сети: в веб-интерфейсе перейдите в Настройки → Wi-Fi, выберите сеть 2,4 ГГц и введите пароль. Для работы в дороге без интернета оставьте режим точки доступа.

Веб-интерфейс

Веб-интерфейс состоит из четырёх разделов:

Избранное — до 6 часто используемых устройств с пользовательскими именами и до 4 кнопок действий для каждого.
Поиск устройств Shelly — сканирование ближайших устройств с фильтрацией по ID модели, имени и порогу RSSI; сортировка по уровню сигнала или имени.
Отправить RPC — пакетное управление: выберите несколько устройств, введите команду (автодополнение допустимых команд), добавьте параметры JSON и отправьте. Поддерживается одновременная работа с 5 устройствами.
Панель результатов — карточки обнаруженных устройств с ключевыми данными; при отправке команды отображается прогресс и статус выполнения.

Примеры применения

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

Скрипты: движок автоматизации

Встроенный Shelly Script Engine (на базе Espruino) предоставляет доступ к:

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

Все скрипты управляются на вкладке Scripts веб-интерфейса. Можно создавать виртуальные кнопки и текстовые поля для построения пользовательских панелей управления.

Установка скрипта

Подключитесь к Assistant и откройте веб-интерфейс.
Перейдите в раздел Scripts.
Нажмите Новый скрипт, задайте имя.
Вставьте код скрипта и нажмите Сохранить.
Запустите из интерфейса или нажатием физической кнопки.

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

Автоматическая настройка виртуальных компонентов (create-demo-virtual-components.js)

Одноразовый скрипт установки: создаёт все виртуальные кнопки и текстовые поля, необходимые для остальных скриптов. Запустите один раз — и интерфейс готов.

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

Настройка сети (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)

Находит ближайшие устройства Shelly и подключает их к указанной сети Wi-Fi. Обрабатывает устройства партиями с логикой повторных попыток. Назначен на короткое нажатие BTN 1.

Использование: введите SSID (text:201), пароль Wi-Fi (text:202), BLE ID устройства (text:200), затем нажмите BTN 1 или виртуальную кнопку button:200 (Подключиться к Wi-Fi).

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

Многоэтапный рабочий процесс: подключение к Wi-Fi → ожидание соединения → переименование устройства → установка часового пояса → проверка обновления прошивки.

Параметры (редактируются в скрипте или через текстовые поля): BLE ID (text:200), имя устройства (text:203), SSID (text:201), пароль (text:202), часовой пояс (text:204). Запуск: BTN 1 или виртуальная кнопка button:201 (Настройка устройства).

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

Находит устройство по BLE ID и полностью настраивает его для работы с MQTT-брокером (в том числе AWS), включая загрузку сертификатов безопасности с веб-сервера.

Параметры: BLE ID (text:200), адрес MQTT-сервера (text:205), Client ID (text:206), префикс темы (text:207), URL сертификатов CA (text:208), клиентского сертификата (text:209), приватного ключа (text:210). Запуск: BTN 1 или виртуальная кнопка button:202 (Конфигурация MQTT).

Дополнительные скрипты (Часть 2)

Все скрипты ниже используют виртуальные поля из демонстрационного набора. При копировании или изменении скриптов обновляйте идентификаторы text: и button: во избежание конфликтов компонентов.

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

Выполняет сброс к заводским настройкам ближайших устройств с заданным BLE ID. Со встроенной логикой повторных попыток. Назначен на короткое нажатие BTN 2.

Использование: введите BLE ID (text:200), нажмите BTN 2 или виртуальную кнопку button:201 (Сброс).

Обновление Gen3 для Matter (gen3-update-matter.js)

Комплексный скрипт подготовки устройств Gen3 к работе с Matter: подключение к Wi-Fi → проверка прошивки → обновление при необходимости → перезагрузка → включение поддержки Matter. Работает на нескольких устройствах одновременно.

Использование: укажите WIFI_SSID и WIFI_PASS в верхней части скрипта, затем нажмите назначенную кнопку.

Печать инвентарных этикеток (print_script.js)

Превращает Assistant в мобильную станцию маркировки: находит ближайшее устройство, получает данные, формирует ZPL-шаблон и отправляет задание на сетевой ZPL-совместимый принтер (Argox, Zebra и др.).

Использование: запустите скрипт настройки виртуальных компонентов, введите BLE ID устройства (text:200) и IP-адрес принтера (text:204), при необходимости отредактируйте переменную zpl_template. Запуск: BTN 1 или виртуальная кнопка button:202.

Веб-хук мост для датчика двери/окна BLU (bthome-webhook.js)

Превращает Assistant в локальный мост автоматизации: «слушает» события датчика Shelly BLU Door/Window и отправляет веб-хук на другое устройство Shelly (выключатель, розетку, сирену) без облака и сложного центра управления.

Использование: введите ID датчика в WINDOW_SENSOR_ID, URL веб-хуков включения и выключения в WINDOW_OPEN_WEBHOOK и WINDOW_CLOSE_WEBHOOK, загрузите скрипт — автоматизация запущена.