Shelly Blu Gateway Gen3 网页界面指南

Shelly BLU Gateway Gen3 网页界面指南

概述

Shelly 设备提供本地网页界面,允许您通过电脑或移动设备上的标准网页浏览器控制和配置您的设备。通过该界面,您可以打开或关闭连接到设备的电器,设置定时任务,并配置在满足特定条件时执行的操作。

请注意,您无需互联网连接或Shelly Cloud即可使用本地网页界面——唯一的要求是您的浏览器必须与您的Shelly设备处于同一Wi-Fi网络。

访问网页界面

访问网页界面的方法:

  1. 将您的设备连接到名称(SSID)符合以下格式的Wi-Fi网络:"DeviceName-XXXXXXXXXX",其中‘DeviceName’是您要连接的设备名称,'XXXXXXXXXX'代表由字母和数字组成的唯一设备ID。

  2. 在建立与设备的连接后,连接到设备的接入点/ AP(在第1步中提到的Wi-Fi网络),访问网页界面的方法是输入所有Shelly设备通用的IP地址 192.168.33.1,然后在浏览器中打开该地址。

您现在已进入设备的网页界面。

将您的设备连接到Wi-Fi网络

网页界面中显示的一些设置仅在设备连接到互联网时可用。请按照以下步骤操作:

  1. 在网页界面中,导航到设置>Wi-Fi。

  2. 输入或选择您首选的Wi-Fi网络,然后输入其密码。或者,您也可以选择连接到开放网络,只需勾选连接到开放Wi-Fi网络的复选框即可。此外,建议设置静态IP地址。

  3. 请等待几秒钟,让您的设备尝试连接到您提供的Wi-Fi网络。如果您输入的密码不正确,或者Wi-Fi网络信号强度或稳定性不足,网页界面会显示一条消息,通知您无法建立连接。成功连接Wi-Fi后,包含新IP地址的链接会以文本形式显示在Wi-Fi设置上方。只需复制并粘贴该链接到您的浏览器即可。

您现在已进入联网设备的网页界面。下次需要访问网页UI时,只需连接到与设备相同的Wi-Fi网络,并输入在第3步获得的新IP地址。建议设置静态IP地址,以确保始终可以通过该地址访问。

了解布局

网页界面可分为四个主要部分——页眉、页脚、主菜单和主内容。

页眉

标题由两个部分组成——左侧是您的设备名称,右侧是一些图标,显示您设备的主要网络和连接功能。这些图标可以包括如Wi-Fi、Bluetooth、MQTT等功能,以及一个显示设备是否有新固件更新的图标。将鼠标悬停在某个图标上时,您会获得更多相关信息。每个设备的网页界面指南中都包含了各个图标含义的图例。请注意,各自的指南只会解释该设备支持的连接功能。

屏幕底部从左到右依次显示设备型号名称、设备ID、网页界面版本、设备固件版本,最后是当前时间。如果时间未同步,屏幕顶部会收到通知,某些计划和操作可能无法正常工作。某些旧版本的网页界面不包含所有这些组件。

主菜单

桌面版网页界面的主菜单位于左侧,而移动版则显示为一个汉堡菜单,图标为三条水平线叠加。菜单内容因设备而异,点击菜单项会跳转到不同页面。您也可以通过点击主页.

返回主页。

主内容

点击主菜单中的项目,您可以在网页界面中导航。屏幕上除页眉、页脚和主菜单外显示的所有内容均视为主内容。

image-20250108-104801.png

*请注意,网页界面指南页面顶部显示的网页界面截图(如有截图)不一定是最新版本。因此,它们可能与最新版本略有不同,且不代表所有设备网页界面的外观。

以下是主菜单中每个设置的说明,包括点击不同设置时主内容的展示内容。首页说明中还简要介绍了本设备专属的顶部图标。请注意,顶部栏在所有页面中都会显示,不仅限于首页。

主菜单

主页

  • 在网页界面的页眉中,您会看到多个图标。它们的含义和状态颜色如下说明:AP

    • 图标:

    • 灰色:AP模式已禁用。

  • Wi-Fi蓝色:AP模式已启用。

    • 灰色:Wi-Fi连接已禁用。

    • 白色:Wi-Fi连接已启用,但尚未建立。

    • 蓝色:设备已连接到Wi-Fi。

  • Bluetooth 图标:

    • 图标:

    • 灰色:连接已禁用。

  • 蓝色:连接已启用。

    • 灰色:已禁用与Shelly Cloud的连接。

    • 白色:已启用与Shelly Cloud的连接,但尚未建立。

    • 蓝色:设备已连接到Shelly Cloud。

  • MQTT 图标:

    • 灰色:MQTT 已禁用。

    • 蓝色:MQTT 已启用。

package.png
  • Firmware 更新 图标:

    • 图标:

    • 蓝色:设备有新的稳定固件版本。

websocket.svg

  • 未显示:设备固件为最新版本。Websocket连接

    • 图标:

    • 蓝色:Websocket已连接。

灰色:Websocket未连接。在主菜单中,您可以通过点击启用配对模式旁边的图标启用网关的配对模式。配对过程将开始,文本会变为配对中

,网关将搜索可配对设备。如果您连接到网关的设备是BLU TRV,它会显示在下方,您创建的任何组件组或BTHome设备也会显示在此菜单中。

对于BLU TRV设备,只需将其置于BLE模式即可——网关会自动与其配对并在网页界面中设置设备。若要添加其他BLE设备,您需要将它们添加为BTHome设备,并设置要显示的传感器。

BLU TRVTRV显示其电池百分比、信号强度、当前温度读数以及阀门开度(0%至100%)。您还可以查看和调整目标温度。要为BLU TRV添加额外传感器,请点击主菜单中设备旁的添加传感器

按钮。点击设备会弹出新的设置菜单,您可以通过滑动带有度数的未闭合圆点,或使用加减图标,将目标温度调整到4°C至30°

C之间。此外,中间的火焰图标是加热按钮,按下后阀门会完全打开(100%),以更快达到目标温度。

下方是BLU TRV的设置:

名称为TRV命名/重命名。点击保存设置

完成命名。

校准TRV点击此设置旁的蓝色校准

按钮开始校准过程。

TRV行为

  • 根据需要勾选/取消勾选以下设置:

  • 地暖——仅外部设置的数据有效,内置传感器读数不计入。

  • 加速加热——通过此设置缩短达到目标温度的时间,加快加热过程。

  • 自动校准——允许设备在必要时自动校正校准。

防堵塞——允许设备确保每周至少移动一次阀门,防止堵塞。

TRV界面选择所需的温度单位,并选择是否让TRV翻转和/或锁定。翻转功能允许设备屏幕根据安装方式旋转180°

,锁定功能则通过锁定显示屏增加安全性。此外,有一个亮度滑块,可在0到7共8个级别调整屏幕亮度。

启用TRV

通过切换此设置启用TRV(默认开启),仅当您打算使用高级API调用手动控制阀门位置时才禁用它。否则,不建议禁用阀门的自动开关。

温度偏移

允许您调整设备温度传感器的读数,以补偿设备自身发热。设置温度偏移后,可确保读数更准确,反映环境的实际温度。

默认开窗目标温度

启用开窗时的温度覆盖,选择温度值及覆盖持续时间(分钟)。

TRV加热持续时间覆盖

设置加热持续时间(分钟),即按下加热按钮后阀门保持100%开启的时间,以更快达到目标温度。

TRV更新

检查并安装固件更新,保持TRV最新。您可以在此设置中查看当前固件和引导程序版本。

附加传感器

监控连接到TRV的任何传感器——温度或门窗传感器。如果没有传感器,设置中会显示提示信息。

删除TRV点击蓝色删除

按钮,将TRV从配对设备中移除。若要重新添加,需重新进行配对。

操作

配置设备操作——创建新操作、编辑现有操作或删除操作。创建操作时需指定触发条件。您还可以设置操作持续时间及满足条件时触发的URL。

计划

此功能需要设备连接互联网以同步时间。允许您创建、查看、编辑和删除计划。计划分为两种类型:基础.

高级创建基础

  • 计划:

  • 选择星期几。

  • 选择时间区间:时间、日出或日落。

    • 设置指定日期的时间:

    • 日落/日出:Shelly 设备可以在日出或日落时自动开启/关闭(或执行指定操作),也可以在日出/日落前后指定的时间自动执行。点击上下按钮或输入数字,即可设置以小时和分钟为单位的时间。

时间:点击上下按钮或输入数字,设置小时和分钟。创建高级

计划:高级计划功能使用cron

通过单个计划执行任务,而非多个基础计划。创建高级计划与基础计划不同,因其包含执行时间

菜单。您需选择一个或多个值、值范围或步长(通过点击选择范围步长

  • 按钮选择)用于:

  • 秒(0-59)

  • 分钟(0-59)

  • 小时(0-23)

  • 日期(1-31)

  • 月份(1月-12月)

星期几(日-六)

若要创建每秒/分钟/小时/天/月/星期几执行的计划,只需勾选所需部分(秒、分钟、小时、天、月或星期几)下方的框。您还可以通过勾选日出/日落偏移框启用偏移,弹出小时和分钟菜单。保持小时和分钟不变并选择日出或日落,计划将在日出或日落时执行。修改小时和分钟值将创建偏移,输入负值表示计划在日出/日落前[设定小时和/或分钟]执行,输入正值表示在日出/日落后[设定小时和/或分钟]执行。不能对小时和分钟分别输入正负值。之后,在执行操作部分指定设备执行的操作。完成后点击保存

保存新计划。

在计划菜单中,您可以查看所有计划。可选择以基础或高级时间查看。基础时间显示计划执行的时间和日期,高级时间则在计划卡片中显示提示,点击可查看更多信息。

两种视图均显示操作。若操作超过三个,显示为+n,n为未显示的操作数量。使用右侧切换按钮可开启/关闭计划。

设置

  • 网络设置接入点

  • Wi-Fi - 注册Shelly设备以连接最多2个不同的Wi-Fi网络。

    可以通过在文本框中输入或点击下拉箭头图标浏览所有可用网络来选择Wi-Fi网络。可以选择开放网络,也可以设置静态IP地址。

    启用Wi-Fi 1、Wi-Fi 2,或同时启用两者(通过每个旁边的切换开关)。如果同时启用Wi-Fi 1和Wi-Fi 2,并且Shelly设备从其中一个网络断开连接,它会自动连接到另一个网络。只有在设置了网络名称(SSID)后,才能启用Wi-Fi。如果设备没有其他可用连接(AP、Bluetooth、以太网(如适用)或第二个Wi-Fi网络),尝试禁用Wi-Fi时会弹出提示,询问您是否继续。

  • Bluetooth - 通过切换开关来禁用/启用Bluetooth。设备的默认Bluetooth设置为启用。

——配置设备的AP,包括开关(通过切换按钮)和设置密码。设备的接入点默认是开放网络。SSID唯一且不可更改。

连接性RPC通信注意事项

  • :当RPC调用执行失败时,会出现横幅消息,通知您设备未及时响应且连接丢失。连接恢复后,请求将重新发送。-将您的 Shelly 连接到云端后,您可以远程控制设备,并接收设备的通知和更新。此设置默认启用云端功能。如果您禁用设备的云端支持,将无法在本地网络外连接到您的设备!

  • MQTT - 配置 Shelly 设备通过 MQTT 执行操作。默认情况下,MQTT 是禁用的,但您可以通过切换开关来启用它。更改这些设置会导致设备重启。还有其他一些设置,例如 通过MQTT进行RPC状态通知通过MQTT进行通用状态更新(允许通过RPC通知与设备通信)和

  • (获取整体状态更新),可通过右侧开关启用/禁用。您还可以启用SSL并输入服务器、用户名和密码,但启用SSL会影响电池寿命,可能缩短一半。 - 指定当 HTTP 通道在 servlet 仍在使用时关闭入站连接时,是否创建 I/O 异常。默认情况下,此设置处于禁用状态。要启用它,请点击旁边的切换开关出站Websocket启用。在文本框中输入服务地址,并在SSL连接*下拉菜单中选择ca.pem.

  • user_ca.pem信号扩展器 该功能会创建一个热点,您可以将Wi-Fi设备连接到该热点。如果启用了范围扩展器的Shelly设备已连接到Wi-Fi路由器和互联网,则所有连接到它的设备也会连接到路由器和互联网。
    即使Shelly设备未连接到Wi-Fi路由器,所有连接到它的设备仍然可以与它以及彼此通信。下方显示了已连接AP客户端的信息——数量,以及它们的IP配置、MAC地址、内部和外部IP地址。

  • ——开启信号扩展器

    RPC通过UDP

    ——通过用户数据报协议(UDP)服务器使用远程过程调用(RPC)与设备通信并发送请求。此功能有助于远程控制和监控设备,无需专用服务器或连接。

使用此设置时,需输入UDP服务器的监听端口和目标地址。监听端口是设备监听传入请求的端口号,目标地址是请求发送的服务器IP地址。

  • 输入所需信息后,您可以使用RPC通过UDP协议向设备发送请求并接收响应。- 查看您的设备ID、所连接的Wi-Fi以及Wi-Fi RSSI设备设置

  • 设备名称(信息)重启——点击重启按钮后,系统会询问您是否确认重启设备。点击确定重启设备,点击

  • 取消则不重启。恢复出厂设置——点击重置按钮,设备设置将恢复为默认值,所有更改将被撤销。弹窗中点击确定确认恢复出厂设置,点击

  • 取消取消。位置和时区——设备会自动检测时区和位置,您也可以手动更改,选择下拉菜单中的时区并输入经纬度。还有一个

如果设备时间未与当前时间同步,计划和操作可能无法按预期运行。若时间未同步,系统会显示提示信息。

  • 自动检测位置按钮,若上次检测失败,可再次自动检测。

  • Firmware 认证——启用认证后,访问设备网页界面时需输入密码。启用后,若要禁用,点击切换按钮并在提示时输入认证密码。——此设置中可查看设备ID、固件版本、构建ID和网页构建ID。点击固件ID或网页构建ID上方的

  • 用户证书(TLS 配置)复制按钮将内容复制到剪贴板。您还可以查看可用新版本、检查更新并轻松更新设备。也可上传自定义固件,但刷写自定义固件将永久失去设备保修。——通过拖放文件或点击指定按钮浏览文件,上传自定义证书颁发机构、客户端证书和客户端密钥。点击上传上传文件,点击

  • 清除移除不想上传的文件。节能模式——通过降低CPU频率和调制解调器活动减少设备能耗。启用此设置,点击启用节能模式旁的切换开关,然后点击

  • 应用保存更改。调试.

  • 系统LED - 通过选中或取消选中旁边的复选框来启用/禁用设备的系统LED——包含Mqtt、Websocket和Udp调试。启用任一项,点击对应设置旁的切换开关。启用Udp调试时,还需输入.

Udp地址

本设备支持脚本功能。您可以利用该功能根据用户的具体需求自定义和增强设备功能。这些脚本可以考虑设备状态、与其他设备通信,或从天气预报等外部服务获取数据。脚本是一种用 JavaScript 子集编写的程序。

启用脚本在网页界面中,进入

脚本菜单,您将看到现有脚本,若无脚本,可创建新脚本或打开库浏览已有脚本。每个脚本旁显示其状态(运行或停止)及启动时运行的切换开关。若脚本有错误,最后保存的错误会显示在脚本名称下方。编辑脚本时,控制台显示在下方,任何错误也会弹出。代码区上方有保存启动/停止删除脚本的选项。您还可以点击对应标签访问代码片段

文档

组件创建组件组件设置允许用户创建

动态组件

  • ,这些组件最初不在设备中。虚拟组件是一种动态组件,用于在脚本或运行间存储或传输数据,并在主页显示脚本功能。组件可分组,只有组及其内组件会在主页显示。不属于任何组的组件不会显示。每个设备的组件和组件组数量有限制。创建组件步骤:点击创建新建按钮,位于

  • 用户定义组件旁。选择要创建的组件类型——布尔型、数字型、文本型、枚举型或按钮型。创建后,每种组件类型都有名称视图自定义图标URL字段,需填写。

自定义图标URL

字段非必填,但可用于自定义主页中组件的外观。您可以重命名或删除组件,也可以为其创建操作,按钮位于每个组件旁。不同组件类型可能有特定的附加字段,详见下文。布尔型