Shelly Plus Uni 网页界面指南

Shelly Plus Uni 网页界面指南

概述

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、网页界面版本、设备固件版本,最后是当前时间。如果时间未同步,屏幕顶部会收到通知,某些计划和操作可能无法正常工作。某些旧版本的网页界面不包含所有这些组件。

主菜单

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

返回主页。

主内容

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

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

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

主菜单

在网页界面中,您会在标题栏看到五个图标,包括AP、Wi-Fi、Bluetooth、云端和MQTT连接。不同状态颜色的含义如下:

  • 主页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未连接。

您将在主页看到输出和输入。输出旁边(标记为输出,但名称可在设置中更改)有一个电源按钮,用于控制输出,输出下方是连接的输入。分离的输入和外设也会显示在此页面。

输出设置

点击主页显示的输出,将进入特定于输出的设置菜单。

名称

为输出命名/重命名。

输入/输出设置

  • 选择输入模式:按钮

  • - 每次按下按钮切换设备输出状态。开关

  • - 开关位置对应设备输出状态。模拟

(并非所有设备均有此选项)- 使用模拟输入,设备根据输入百分比确定亮度百分比。:

  • 设置输出类型切换开关(仅限开关) - 设备作为翻转开关,具有一个 状态和一个

  • 状态。如果输入为模拟模式,设备将跟随模拟输入状态。瞬时开关(仅限按钮) - 每次按下按钮切换设备输出状态。如果开关为 ,则切换为

  • ,反之亦然。边缘开关(仅限开关)

  • - 每次切换开关位置都会切换设备输出状态。分离开关

- 输入与输出分离(分开),不影响输出。基本上,您无法通过输入控制灯光。:

上电动作

  • 此设置通常用于停电后恢复供电时的设备行为。开机

  • - 供电时设备将开启。关机

  • - 供电时设备将关闭。恢复输出/继电器的最后已知状态

  • - 供电时输出状态恢复为设备上次开机时的状态(断电前)。开关当前状态(仅限切换开关) - 跟随开关状态,若切换至 ,设备开启;切换至 .

,设备关闭。

当您使用第三方智能家居系统控制您的设备时,建议参考其文档或用户指南,以确定此字段需要输入什么内容。第三方系统的文档通常会说明建立与 Shelly 设备通信所需的参数、凭证或其他详细信息。

然而,如果您仅通过 Shelly 应用使用该设备,则可以忽略消耗类型此设置在将设备集成到第三方智能家居系统时相关。目的是指定外部系统与设备交互所需的信息或配置。

外部消耗类型 字段。应用程序无需额外配置,因为它内置了与设备通信和控制的机制。如果您希望删除设备设置中的外部消耗类型,只需将 外部消耗类型按钮。这样做会有效禁用外部用电类型,并恢复设备的默认行为,或仅依赖 Shelly 应用进行控制和自动化。

字段留空并点击

保存设置

自动化:

动作

配置设备动作——创建新动作、编辑现有动作或删除动作。创建动作时需指定动作触发条件。您还可以设置动作持续时间及满足条件时触发的URL。计划此功能需要设备连接互联网以同步时间。允许您创建、查看、编辑和删除计划。计划分为两种类型:.

基础高级

  • 创建

  • 基础

  • 计划:

    • 选择星期几。

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

选择时间区间:时间、日出或日落。设置指定日期的时间:时间:点击上下按钮或输入数字,设置小时和分钟。

创建 高级 计划:

高级计划功能使用 cron 通过单个计划执行任务,而非多个基础计划。

创建高级计划与基础计划不同,因其包含 执行时间 菜单。您需选择一个或多个值、值范围或步长(通过点击每个值的 选择范围

  • 步长

  • 按钮选择)用于:

  • 秒(0-59)

  • 分钟(0-59)

  • 小时(0-23)

日期(1-31)

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

部分指定设备执行的动作。完成后点击

保存

保存新计划。

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

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

  • 允许您自动管理电源。您可以使用:自动开启:

关闭后,继电器输出将在预设时间(秒)后自动开启。

自动关闭:

开启后,继电器输出将在预设时间(秒)后自动关闭。

输入设置

名称

  • 为输入命名/重命名。输入/输出设置

  • 选择输入模式:按钮

  • - 每次按下按钮切换设备输出状态。开关

- 开关位置对应设备输出状态。:

  • 模拟(并非所有设备均有此选项)- 使用模拟输入,设备根据输入百分比确定亮度百分比。设置输出类型切换开关(仅限开关) - 设备作为翻转开关,具有一个

  • 状态和一个 状态。如果输入为模拟模式,设备将跟随模拟输入状态。瞬时开关(仅限按钮) - 每次按下按钮切换设备输出状态。如果开关为

  • ,则切换为

  • ,反之亦然。边缘开关(仅限开关)

- 每次切换开关位置都会切换设备输出状态。:

分离开关

  • - 输入与输出分离(分开),不影响输出。基本上,您无法通过输入控制灯光。上电动作

  • 此设置通常用于停电后恢复供电时的设备行为。开机

  • - 供电时设备将开启。关机

  • - 供电时设备将关闭。恢复输出/继电器的最后已知状态 - 供电时输出状态恢复为设备上次开机时的状态(断电前)。开关当前状态(仅限切换开关) - 跟随开关状态,若切换至 .

,设备开启;切换至 ,设备关闭。反转此设置允许您反转输入信号的逻辑,实质上是反转设备行为。默认情况下,输入信号为

时设备开启,输入信号为 时设备关闭。启用“反转输入”后,情况相反:输入信号为

时设备关闭,输入信号为

时设备开启。此设置适用于需要反转设备行为的情况。

分离输入设置

分离输入与连接输入的设置不同。

名称

上报阈值是设备在通过 webhooks、操作、MQTT 或其他渠道发送报告前所计数的脉冲次数。

为输入命名/重命名。

启用

启用/禁用分离输入。

输入一个百分比值。当频率变化达到设定值时,设备将通过 webhooks、操作、MQTT 或其他渠道发送报告。

报告阈值

频率窗口设置设备测量脉冲频率的时间间隔(秒)。频率报告阈值自定义计数表达式设置自定义数学表达式(公式)和自定义单位。当前值为 x

X

,可用于表达式生成自定义值。表达式和自定义单位均需设置。点击文本框下方的 示例公式 可查看不同用法。自定义频率表达式设置自定义数学表达式(公式)和自定义单位。当前值为 x

X

,可用于表达式生成自定义值。表达式和自定义单位均需设置。点击文本框下方的

示例公式

可查看不同用法。重置计数器将所有输入读数设为0。+添加外设添加外设请进入设备网页UI中的 外设 设置,点击 按钮。随后选择要添加的外设类型。正确连接外设并选择正确类型后,外设将显示在所选类型下。点击所选外设类型下的 重新扫描 可再次扫描该类型。勾选要添加的外设,点击

添加

  • 按钮添加,或点击

  • 添加并重启

  • 添加后触发设备重启。

  • 外设列表包括:

  • 温湿度传感器(DHT22)

如果您的设备需要重启,屏幕顶部会弹出一条通知消息,内容为温度传感器(DS18B20)数字输入

模拟输入

电压表重启 按钮。

plusuniperipherals.png

外设菜单成功添加所有外设后,外设

菜单将显示它们。界面类似下图,替换为您添加的外设。每个外设旁有垃圾桶图标,点击可删除外设及其所有动作。删除后可重新添加,但无法恢复之前的动作或自定义设置。铅笔图标用于编辑外设。

每个外设有独特设置,详见下文。点击

  • 外设

  • 菜单中的外设即可访问。

  • 偏移量 - 一个数值,如果为正则加到温度读数上,如果为负则减去,以使温度读数更准确。

温湿度传感器(DHT22)

  • 温度设置

  • 名称 - 设置外设显示名称。

  • 偏移量 - 一个数值,如果为正则加到湿度读数上,如果为负则减去,以使湿度读数更准确。

变化阈值 - 温度变化超过指定摄氏度触发传感器数据报告。最小0.1℃,最大5℃。

湿度设置

  • 活动时间 - 指一天24小时内允许触发该操作的时间段。

  • 名称 - 设置外设显示名称。

  • 变化阈值 - 相对湿度变化超过指定值触发传感器数据报告。最小1%,最大20%。动作创建和编辑动作。创建动作时需指定:执行时机 - 仅在温度变化后或每60秒执行。条件 - 指定动作触发条件。可选择

  • 小于

大于 某值,使动作在温度低于或高于该值时触发。

执行操作 - 使用URL和本地动作,指定条件满足时设备执行的操作。可发送内部或外部URL,意味着可发送URL至本设备或其他设备。

编辑或创建动作后,请务必点击 保存动作

按钮。

  • 温度传感器(DS18B20)

  • 概述

  • 偏移量 - 一个数值,如果为正则加到温度读数上,如果为负则减去,以使温度读数更准确。

- 显示传感器读数(温度)。

温度设置

  • 活动时间 - 指一天24小时内允许触发该操作的时间段。

  • 名称 - 设置外设显示名称。

  • 变化阈值 - 温度变化超过指定摄氏度触发传感器数据报告。最小0.1℃,最大5℃。动作创建和编辑动作。创建动作时需指定:执行时机 - 仅在温度变化后或每60秒执行。条件 - 指定动作触发条件。可选择

  • 小于

大于 某值,使动作在温度低于或高于该值时触发。

执行操作 - 使用URL和本地动作,指定条件满足时设备执行的操作。可发送内部或外部URL,意味着可发送URL至本设备或其他设备。

编辑或创建动作后,请务必点击 保存动作

按钮。

  • 数字输入

  • 概述 - 显示读数。输入设置名称 - 更改输入名称。.

  • 模式 - 选择

  • 开关

按钮

  • 活动时间 - 指一天24小时内允许触发该操作的时间段。

  • 反转 - 启用反转输入。开状态视为关,反之亦然。恢复出厂设置 - 允许通过附加数字输入恢复设备出厂设置。动作创建和编辑动作。创建动作时需指定:.

  • 执行时机 - 输入切换

时执行动作。

执行操作 - 使用URL和本地动作,指定条件满足时设备执行的操作。可发送内部或外部URL,意味着可发送URL至本设备或其他设备。编辑或创建动作后,请务必点击

保存动作

  • 按钮。

  • 模拟输入

概述

- 显示模拟输入的百分比读数。

  • 活动时间 - 指一天24小时内允许触发该操作的时间段。

  • 设置

  • 名称 - 设置外设显示名称。变化阈值 - 输入百分比变化超过指定值触发数据报告。最小1%,最大50%。动作创建和编辑动作。创建动作时需指定:执行时机 - 仅在模拟状态变化时执行动作。

  • 条件 - 指定动作触发条件。可选择

小于大于

某值,使动作在百分比低于或高于该值时触发。

执行操作 - 使用URL和本地动作,指定条件满足时设备执行的操作。可发送内部或外部URL,意味着可发送URL至本设备或其他设备。编辑或创建动作后,请务必点击

保存动作

  • 按钮。

  • 电压表

概述

- 显示电压。

  • 活动时间 - 指一天24小时内允许触发该操作的时间段。

  • 设置

  • 名称 - 设置外设显示名称。变化阈值 - 电压变化超过指定值触发数据报告。最小0.1,最大5。动作创建和编辑动作。创建动作时需指定:执行时机 - 每60秒执行或电压状态变化时执行。

  • 条件 - 指定动作触发条件。可选择

小于大于

某值,使动作在电压低于或高于该值时触发。

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

执行操作 - 使用URL和本地动作,指定条件满足时设备执行的操作。可发送内部或外部URL,意味着可发送URL至本设备或其他设备。编辑或创建动作后,请务必点击 保存动作

按钮。脚本在网页UI中,进入 脚本 菜单,您将看到现有脚本,若无脚本,可创建新脚本或打开库浏览已有脚本。每个脚本旁显示其状态(运行或停止)及启动时运行的切换开关。若脚本有错误,最后保存的错误会显示在脚本名称下方。编辑脚本时,控制台和错误信息显示在下方。代码区上方有 保存启动/停止删除

选项。您还可点击对应标签访问

代码片段

  • 文档

  • 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设置为启用。

设置网络设置

  • 接入点-将您的 Shelly 连接到云端后,您可以远程控制设备,并接收设备的通知和更新。该设置默认启用云端。如果您禁用设备的云端支持,将无法在本地网络外连接到您的设备!

  • MQTT - 配置 Shelly 设备通过 MQTT 执行操作。默认情况下,MQTT 是禁用的,但您可以通过切换开关来启用它。更改这些设置会导致设备重启。还有其他一些设置,例如 通过 MQTT 发送 RPC 状态通知 - 配置设备AP,包括开关(通过切换开关)和设置密码。设备接入点默认是开放网络。SSID唯一且不可更改。通过 MQTT 发送通用状态更新RPC通信注意事项

  • :当RPC调用执行失败时,会出现横幅消息,通知设备响应超时并断开连接。连接恢复后,请求将重新发送。 - 指定当HTTP通道在servlet仍在使用时关闭入站连接时,是否创建I/O异常。默认情况下,此设置处于禁用状态。要启用它,请点击旁边的切换开关。(允许通过RPC通知与设备通信)和(获取整体状态更新),可通过右侧开关启用/禁用。您还可启用SSL并输入服务器、用户名和密码,但启用SSL会影响电池寿命,可能缩短一半。出站Websocket*启用。在文本框中输入服务地址,并在SSL连接下拉菜单中选择.

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

  • user_ca.pem

    信号放大器

    - 开启

信号放大器

  • RPC通过UDP- 查看您的设备ID、所连接的Wi-Fi以及Wi-Fi RSSI - 通过用户数据报协议(UDP)服务器使用远程过程调用(RPC)与设备通信并发送请求。此功能适合远程控制和监控设备,无需专用服务器或连接。

  • 使用此设置需输入UDP服务器的监听端口和目标地址。监听端口是设备监听传入请求的端口号,目标地址是请求发送的服务器IP地址。输入所需信息后,您可使用RPC over UDP协议向设备发送请求并接收响应。设备设置设备名称(信息)重启 - 点击重启

  • 按钮后,系统会询问是否确认重启设备。点击确定重启设备,点击取消则不重启。恢复出厂设置 - 点击重置

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

如果设备时间未与当前时间同步,计划和操作可能无法按预期运行。如果时间未同步,系统会弹出消息提醒您。

  • 取消操作。位置和时区

  • Firmware - 时区和位置将自动检测,您也可手动从下拉菜单选择时区并输入经纬度。还有一个自动检测位置按钮,若上次检测失败,可再次自动检测位置。

  • 用户证书(TLS 配置)认证 - 启用认证后,访问设备网页UI需输入密码。启用后,禁用需点击切换开关并在提示时输入认证密码。 - 此设置显示设备ID、固件版本、构建ID和网页构建ID。可点击固件ID或网页构建ID上方的复制按钮复制内容。您还可查看新版本、检查更新并轻松更新设备。也可上传自定义固件,但刷写自定义固件将永久失去设备保修。

  • - 通过拖放文件或点击指定按钮浏览文件,上传自定义证书颁发机构、客户端证书和客户端密钥。点击上传上传文件,点击清除移除不想上传的文件。节能模式

  • - 通过降低CPU频率和调制解调器活动减少设备能耗。启用此设置请点击启用节能模式旁的切换开关,然后点击.

  • 应用保存更改。

调试

- 包含Mqtt、Websocket和Udp调试。启用任一项请点击对应切换开关。启用Udp调试时需输入

Udp地址

单位 - 选择测量数据的显示单位。高级设置点击此设置旁的箭头可展开高级设置,详见下文。KVSKVS代表键值存储,是一种非关系型数据库,使用简单的键值方法存储数据。单个设备最多可存储50个键值对。点击添加值按钮进入值创建界面,提示输入键(最多42字符)和值(最多253字符)。值文本框下方显示当前值类型。默认值类型为数字,输入文本时类型变为字符串。点击保存适用于 Shelly 设备。

保存键值。编辑现有值只需点击它。删除键值对点击编辑时出现的

删除

HTTP ping

在指定的文本字段中输入一个URL,以便从您的设备向其发送HTTP请求。网页界面随后会告知您请求是否成功或失败。