Kbuca Shelly Blu 助手批量设置工具

Shelly BLU Assistant-批量设置工具

B&W.png

秒级批量配置您的Shelly设备

该Shelly BLU Assistant是一款紧凑型、USB供电设备，专为快速简便地配置、设置和控制Shelly Gen2+ 设备。由Shelly Script引擎驱动，并配备两个可编程按钮，可实现多种自动化设备管理流程，非常适合小规模和大规模部署。可以将其视为Generation‑2（及更新）Shelly设备的专属“批量配置”遥控器。

抬头显示该助手无法为独立的 Shelly BLU 传感器进行配置。但它可以通过 BTHome 连接这些传感器，并实时查看其数据。

适合谁使用？

  • 安装人员在新建筑中大规模部署设备。

  • 智能家居爱好者精细调整每个细节。

  • 现场技术人员需要可靠且无需笔记本电脑的配置工具。

  • 教育工作者和创客几分钟内搭建教室套件或工作坊演示。

硬件快速一览

Assistant设计简洁。以下是您将使用的功能：

USB-A 插头 - 只需插入任何5V 1A USB端口即可开机。

按钮1 - 您的第一个魔法按钮！可为短按、长按或双击分配任意脚本。

按钮2 - 第二个魔法按钮，同样可自定义。

LED - 指示BLE连接状态。

内部技术

  • 连接方式：内置 Wi‑Fi 无线电（802.11 b/g/n @ 2.4 GHz）可创建专属配置热点或加入您的网络，同时 Bluetooth 5.1 LE 向附近的 Shelly 设备发送配网指令。

安全第一：请保持助手干燥，远离高温环境，并仅将其插入标准5 V USB端口。

快速上手

开始使用很简单：

  1. 开机：将 Shelly BLU Assistant 插入 USB-A 接口。大约等待 5 秒钟让其启动。

  2. 连接到其Wi-Fi： 在您的手机或笔记本电脑上，查找名为 的Wi-Fi网络 ShellyBLUAssist-xxxxxx并连接。无需密码。

  3. 启动网页界面：打开浏览器，访问 http://192.168.33.1。就这么简单！您已进入界面。

可选 – 将助手添加到您的LAN

在网页控制台，进入设置 ▸ Wi‑Fi，选择您的2.4 GHz网络并输入密码。Assistant将作为客户端设备出现在您的家庭网络中。喜欢独立工具？只需保持接入点模式即可。

您的控制面板：网页UI

网页UI是您的任务控制中心，分为四个部分。

  • 收藏夹：经常使用的设备？在结果列表中标星，它们将显示在这里。最多可固定六个收藏，给它们起易记的名字，甚至为每个设备创建最多四个自定义操作按钮。

  • 查找Shelly设备：这里是您开始大多数任务的地方。

    • 筛选器：快速找到所需内容。您可以按型号ID筛选，按设备名称搜索，或设置RSSI阈值（dBm）以忽略距离过远的设备。

    • 排序：按信号强度（RSSI）或设备名称字母顺序排列列表。扫描：.

    • 点击此按钮开始发现附近设备。发送RPC：

  • 这里进行批量管理。您可以同时更新/通信多个设备。只需勾选想要操作的设备旁的框。

    • 开始输入命令。界面智能，会

    • 自动建议有效命令，确保您不会出错。如有需要，可用JSON格式添加参数。

    • 点击

    • 发送，Assistant将同时连接多个设备。最多支持同时操作5台设备。结果面板：

  • 每个发现的设备以卡片形式显示关键数据。发送命令时，进度条显示每台设备状态；展开卡片查看成功/失败详情。您能用它做什么？

您想做的事

Shelly BLU Assistant 是一个问题解决者。以下是一些入门建议：

Assistant如何简化操作

适合人群...

设置一箱新设备

加载

专业安装人员添加Wi-Fi 脚本，走到您的新设备旁，只需按下一个按钮。助手会找到它们并将其连接到您的Wi-Fi网络。完成。

一次更新所有设备

使用网页UI选择所有设备并发送

命令。去喝杯咖啡，Assistant会确保所有设备运行最新固件。Shelly.Update智能家居爱好者，安装人员

现场工作

将Assistant和移动电源放入包中。现在您拥有一套强大便携的工具包，可现场配置设备，即使无网络。

现场技术人员

创建库存标签

想象一个脚本能找到设备，获取其唯一ID，并指示网络打印机打印格式完美的库存标签。Assistant能做到。

仓库，制造业

“克隆”您的完美配置

将“黄金配置”保存为脚本。添加新设备时，只需运行脚本即可立即应用模板，实现完美一致的设置。

安装人员，IT专业人士

管理访客访问

物业管理

无论是Airbnb还是办公室，您都可以使用脚本在Shelly设备上设置临时访问权限。客人离开时，只需再次按下按钮即可重置所有设置，方便下一个人使用。

秘密武器：脚本

（基于Espruino）让您几乎自动化所有操作：

Shelly BLU Assistant 的卓越之处在于其内置功能。Shelly Script引擎您可以直接访问：

通过RPC配置任何设置

  • 通过Bluetooth扫描附近的设备

  • 在闪存中存储和检索数据

  • 响应按钮1/按钮2的短按、长按或双击

  • 所有脚本都存放在网页UI的

脚本标签页。您甚至可以在UI中创建虚拟按钮和文本字段，供脚本交互，打造专属定制仪表盘。链接

在这里您可以找到Shelly脚本的所有详细信息：这里有我们的示例仓库：

链接启发您的示例脚本

为了激发您的灵感，我们预装了一些脚本。它们是您创作的良好起点。您可以修改它们以满足需求，比如扫描所有设备，而非特定设备。

将脚本导入设备

准备好试用了吗？将这些脚本导入Assistant很简单：

连接Assistant

  1. 并打开网页UI。进入

  2. 脚本部分。点击创建

  3. 新脚本并命名。复制粘贴

  4. 您想添加的脚本代码，然后点击保存从UI运行或按分配的物理按钮启动！.

  5. 第一部分：演示脚本

虚拟组件自动设置（

这四个脚本构成了核心演示。首先运行自动设置，然后你将使用Wi-Fi配网、完整配置和MQTT配置来操作新创建的虚拟字段/按钮。

create-demo-virtual-components.js功能)

此一次性设置脚本创建

所有其他脚本依赖的虚拟按钮和文本字段。无需手动UI操作，运行一次即可准备就绪。使用方法

打开网页UI，进入

  1. 脚本创建名为“虚拟组件自动设置”的新脚本。.

  2. 粘贴create-demo-virtual-components代码。

  3. 保存并

  4. 运行完成后脚本会自动停止，您将在主页看到如下分组和组件：.

网络设置

  • （ID：text:200, text:201, text:202, button:200, text:211）设备配置

  • （text:200–204, button:201, text:211）（text:200,205–211, button:202）

  • MQTT 配置add-to-wifi.js

Wi-Fi 配置（功能：)

  • 优势：它会查找附近的Shelly设备，并将其连接到您在界面中指定的Wi-Fi网络。

  • 它以小批量智能处理设备，若设备首次未连接成功还会重试。预设为按钮1的短按。.

  • 使用方法：运行虚拟组件设置脚本后，输入：

    • Wi-Fi 名称（SSID）到关联text:201.

    • Wi-Fi 密码的字段，到关联.

    • text:202的字段，设备BLE ID（例如0x1800.

）到关联text:200!

的字段。然后按系统按钮（按钮1）或关联)

  • button:200（连接WiFi） 此脚本是多步骤工作流程的绝佳示例。它会找到最近的特定设备，将其连接到Wi-Fi，等待其上线，重命名，设置时区，最后检查是否需要固件更新。

  • 的虚拟按钮。完整设备配置与更新（

  • full-config.js功能：

    • 优势：展示如何串联命令，有序或同时执行，提升效率。使用方法：直接编辑脚本设置所需值：目标设备BLE ID（例如0x1018.

    • ）在FILTERED_BLE_ID对应text:200新设备名称.

    • Wi-Fi 网络 SSID在DEVICE_NAME对应text:203.

    • Wi-Fi 密码WiFi名称在WIFI_SSID对应.

    • text:201WiFi密码在WIFI_PASS对应text:202设备时区.

（例如Europe/Sofia!

MQTT 配置（）在)

  • LOCATION_TZ这个高级脚本会找到具有特定BLE ID的最近Shelly设备，并将其完全配置为与MQTT代理（本例中为AWS）通信，同时配备所需的安全证书。

  • 对应text:204

  • 然后按系统按钮（按钮1）或关联button:201（配置设备）的虚拟按钮触发脚本。 将您的CA捆绑包、客户端证书和客户端私钥文件托管在Shelly设备可访问的Web服务器上，然后直接编辑脚本以设置您的自定义信息：

    • config-mqtt.js功能：优势：展示Assistant的强大功能，处理复杂流程，包括网络获取文件并分段上传到目标设备。使用方法：运行前，您必须.

    • MQTT 服务器地址和端口设置：目标设备BLE ID（例如0x1018.

    • MQTT 客户端 ID）在FILTERED_BLE_ID对应text:200.

    • MQTT 主题前缀MQTT服务器在text:205MQTT客户端ID.

    • 在text:206

      • MQTT前缀在text:207

      • 证书文件URL（CA_BUNDLE

      • 对应text:208CLIENT_CERT

对应button:202(MQTT 配置)!

text:209

CLIENT_KEY

对应text:210），然后按系统按钮（按钮1）或虚拟按钮触发。第二部分：更多示例脚本⚠️ ID冲突：

以下所有脚本均假设演示中的虚拟字段/按钮已就位。若复制/自定义示例，务必)

  • 更新文本：向您想要清除的所有特定附近Shelly设备发出出厂重置命令。

  • 或按钮： 与Wi-Fi脚本类似，它非常可靠，内置重试逻辑。它已预设为短按 引用，避免两个脚本同时使用同一UI组件。.

  • 恢复出厂设置（factory-reset-device.js

    • 功能：优势：按钮2使用方法：运行设置脚本后，输入：.

设备BLE ID（例如!

Gen3 Matter 更新（1800)

  • ）到关联这是一个强大的全能脚本，可让您的Gen3 Shelly设备全面升级并准备好支持Matter。它会自动完成整个流程：连接Wi-Fi、检查当前固件、如有需要则进行更新、重启，最后启用Matter支持。

  • text:200 这是真正的“即装即用”解决方案。它可以同时在多台设备上运行，智能检测是否需要更新，并在出现问题时重试每一步。这是为您的整个Gen3设备群执行复杂多步骤升级的最简单方式。

  • 的字段。然后按系统按钮（按钮2）或关联button:201（重置）的虚拟按钮。gen3-update-matter.js功能：

优势：使用方法：)

  • 调整脚本顶部的此脚本可将您的 Shelly BLU Assistant 转变为移动标签站！它会查找附近的 Shelly 设备，获取其指定数据，将其放入 ZPL 模板，并发送到联网的标签打印机，立即生成实体标签。

  • WIFI_SSID和

  • WIFI_PASS以匹配您的网络。然后按分配的按钮。脚本将找到所有信号强的附近设备并开始自动化流程。网络打印机打印库存标签（print_script.js

  • 功能：优势：

    • 这对专业安装人员或管理大量设备的人来说是革命性工具。每台设备都能获得完美且可扫描的标签，极大简化后续设置和库存管理。这是您手中的自动化。使用方法：首先确保运行了虚拟组件自动设置脚本以创建必要的UI字段。然后在网页UI中输入支持ZPL的打印机IP地址（许多Argox或Zebra型号兼容）。编辑模板内容并触发脚本。使用方法：运行虚拟组件自动设置：.

    • 确保已运行初始设置脚本创建必要的UI输入字段。ZPL兼容网络打印机的HTTP/IP地址输入目标设备BLE ID.

    • （例如0x1018）到关联text:200

的字段。输入!

到关联text:204)

  • 的字段。 此脚本可将您的 Shelly BLU Assistant 变成智能家居桥接器。它会“监听”您的 Shelly BLU Door/Window 传感器的开关状态，并通过您的 Wi-Fi 立即向其他设备（如灯光开关、智能插座或警报器）发送命令（webhook）。

  • （可选）自定义标签：您可以直接编辑脚本中的

  • zpl_template变量，调整标签布局或内容。

    • 最后按系统按钮（按钮1）或关联button:202触发脚本。BLU门窗传感器到Webhook桥接（bthome-webhook.js

    • 获取您想要控制的设备的webhook URL。大多数Shelly设备都很容易找到——开关的开关URL就在设备设置中。

    • 功能：优势：无需复杂智能家居中心或云端，轻松创建简单强大的自动化。例如：“后门打开时，打开露台灯。”或“药柜打开时，触发铃声。”所有逻辑本地即时运行于Assistant。使用方法：设置简单。

    • 找到BLU门窗传感器的

ID

Shelly BLU Assistant 省去了繁琐重复的工作，让你可以快速完成任务，专注于更具挑战性的部分。它能一键配置所有设备，同时也是一个随时随地可用的指挥中心——无论在线还是完全离线，都能让你随时掌控工作进度。