Skip to content

Shelly Wave 设备文档

注意:原先被称为“Shelly Qubino Wave”的产品系列,现将统一更名为“Shelly Wave”。此次更名不会影响任何设备的功能。唯一的变化是在未来的所有文档中使用新名称。

Shelly Wave


设备识别

错误渲染宏 'excerpt-include':用户 '712020:515aa595-e304-41f3-886a-d9b6b0b7f5a3' 无权查看页面 'DEV:Z-Wave man.info, product type, product ID'。


术语解释

  • 设备 – 在本文档中,“设备”一词指代本指南所讨论的 Shelly Qubino 设备。
  • 网关(GW) – Z-Wave™ 网关,也称为 Z-Wave™ 控制器、Z-Wave™ 主控制器、Z-Wave™ 主控设备或 Z-Wave™ 中心等,是作为 Z-Wave™ 智能家居网络中央枢纽的设备。本文档中使用“网关”一词。
  • S 按钮 – 位于 Z-Wave™ 设备上的服务按钮,用于执行多种功能,如添加(包含)、移除(排除)以及将设备重置为出厂默认设置。本文档中使用“S 按钮”一词。

简要说明

错误渲染宏 'excerpt-include':用户 '712020:515aa595-e304-41f3-886a-d9b6b0b7f5a3' 无权查看页面 'DEV:About the Device'。


连接到输入端子 SW(SW1)的开关/按键

错误渲染宏 'excerpt-include':用户 '712020:515aa595-e304-41f3-886a-d9b6b0b7f5a3' 无权查看页面 'DEV:Basic Functions'。


主要应用场景

错误渲染宏 'excerpt-include':用户 '712020:515aa595-e304-41f3-886a-d9b6b0b7f5a3' 无权查看页面 'DEV:Main applications'。


集成支持

Shelly Qubino Wave 设备基于全球领先的智能家居技术——Z-Wave® 开发。

这意味着 Shelly Qubino Wave 可与所有经过认证并支持 Z-Wave 通信协议的网关兼容。

为确保您的网关能够完整支持 Shelly Qubino Wave 的各项功能,我们定期对设备与不同型号的 Z-Wave 网关进行兼容性测试。


简化内部电路图

Shelly Plus 1 内部电路图


设备电气接口

输入

错误渲染宏 'excerpt-include':用户 '712020:515aa595-e304-41f3-886a-d9b6b0b7f5a3' 无权查看页面 'DEV:Device electrical interfaces'。

输出

错误渲染宏 'excerpt-include':用户 '712020:515aa595-e304-41f3-886a-d9b6b0b7f5a3' 无权查看页面 'DEV:Device electrical interfaces'。


连接方式

Z-Wave – 不安全、S0 安全、S2 未认证安全、S2 认证安全


安全特性

过热保护

  • 自动关闭继电器
  • 向网关发送通知报告(检测到过热)
  • LED 指示灯按上述规定闪烁(检查过热检测时的闪烁模式)

以下任一操作可清除该报警:

  • 重启电源
  • 短按 S 按钮
  • 按下任意连接至任意 SW(SW、SW1、SW2……)端子的开关/按钮

注意:过热保护始终启用,无法禁用。
更多详细信息请参见章节 过热检测通知


支持的负载类型

错误渲染宏 'excerpt-include':用户 '712020:515aa595-e304-41f3-886a-d9b6b0b7f5a3' 无权查看页面 'DEV:Supported load types'。


用户界面

无法渲染 {include} – 找不到包含的页面。

LED 信号指示

点击以查看 LED 信号指示

正常模式

  • 已移除/排除
    每次断电后或按下 S 按钮后,LED 会在模式 1 下持续闪烁蓝色 10 分钟。
    模式 1 - 蓝色

  • 已添加/包含
    每次断电后或按下 S 按钮后,LED 会在模式 1 下持续闪烁绿色 10 分钟。
    模式 1 - 绿色

设置进行中

  • 出厂重置并重启
    出厂重置期间,LED 会先亮起约 1 秒的绿色,随后蓝灯和红灯将以 0.1 秒开 / 0.1 秒关的方式闪烁约 2 秒。

  • 添加 / 移除
    在添加或移除过程中,LED 会在模式 2 下闪烁蓝色
    模式 2 - 蓝色

  • OTA 固件更新
    在 OTA 升级过程中,LED 会在模式 2 下闪烁蓝灯和红灯
    模式 2 - 蓝红

  • 检查电源(230 V AC 频率或 24 V DC 电压)
    在检测电源期间,LED 会在模式 5 下闪烁蓝灯和红灯
    模式 5 - 蓝红

使用 S 按钮进入设置模式

  • 选择添加/移除菜单
    当菜单被选中时,LED 将保持蓝色点亮,最长不超过 10 秒。

  • 添加/移除 – 按住 S 按钮 – 添加/移除过程被选中
    当菜单执行时,LED 将在模式 3 下闪烁蓝色
    模式 3 - 蓝色

  • 选择出厂重置菜单
    当菜单被选中时,LED 将保持红色点亮,最长不超过 10 秒。

  • 出厂重置 – 按住 S 按钮 – 出厂重置过程被选中
    当菜单执行时,LED 将在模式 3 下闪烁红色
    模式 3 - 红色

报警模式

  • 检测到过热
    LED 将在模式 4 下闪烁红色:0.2 秒开 / 0.2 秒关 ×(1–6 次)+ 2 秒关,重复此序列。
    报警模式 4

LED 闪烁模式

点击以查看 LED 闪烁模式
模式描述
模式 10.5 秒开 / 2 秒关
模式 20.5 秒开 / 0.5 秒关
模式 30.1 秒开 / 0.1 秒关
模式 4(1–6 次:0.2 秒开 / 0.2 秒关)+ 2 秒关
模式 50.2 秒开(蓝)/ 0.2 秒开(红)

规格参数

参数
电源110–240 V AC / 24–48 V DC / 12 V DC ±10%
功耗< 0.3 W
最大交流开关电压240 V
最大交流开关电流16 A
最大直流开关电压30 V
最大直流开关电流10 A
过热保护
传输距离室内最大 40 米(131 英尺)(受当地环境影响)
Z-Wave® 中继器
处理器Z-Wave® S800
Z-Wave® 频段868.4 MHz
最大无线发射功率< 25 mW
尺寸(高 × 宽 × 深)37 × 42 × 16 ±0.5 毫米 / 1.46 × 1.65 × 0.63 ±0.02 英寸
重量26 克 / 0.92 盎司
安装方式壁挂式底座
接线端子最大扭矩0.4 牛·米 / 3.5 英寸·磅
导线截面积0.5 至 1.5 平方毫米 / 20 至 16 AWG
导线剥线长度5 至 6 毫米 / 0.20 至 0.24 英寸
外壳材质塑料
颜色蓝色
环境温度-20℃ 至 40℃ / -5℉ 至 105℉
湿度30% 至 70% 相对湿度
最大海拔高度2000 米 / 6562 英尺

基本接线图

图 1图 2图 3
图 1图 2图 3

图例说明

端子描述电缆描述
N中性端子N中性线
L火线端子(110–240 V AC)L火线(110–240 VAC)
SW开关/按钮输入端子(控制输出 O)+12 / 24–48 VDC 正极线
I负载电路输入端子GND12 / 24–48 VDC 接地线
O负载电路输出端子
12V+12 V DC 正极端子
+24–48 VDC 正极端子
12 / 24–48 VDC 接地端子

关于 Z-Wave®

将设备添加至 Z-Wave® 网络(包含)

注意! 若设备成功添加或从 Z-Wave® 网络中移除,所有设备输出端口(O、O1、O2 等,视设备类型而定)将自动执行 1 秒开/关 → 1 秒开/关的操作。

注意! 若使用安全 2(S2)方式添加(包含),网关将弹出对话框要求输入对应的安全码(5 位下划线数字),该码印在设备侧面的 Z-Wave® DSK 标签上,以及包装盒内的 DSK 标签上。
重要提示:请务必妥善保管该安全码。

SmartStart 添加(包含)

支持 SmartStart 的产品可通过网关扫描设备上的 Z-Wave® 二维码进行添加。无需额外操作,设备在通电后 10 分钟内将自动完成添加。

  1. 在网关应用中扫描设备标签上的二维码,并将安全 2(S2)设备特定密钥(DSK)添加至网关的预配列表。
  2. 将设备连接至电源。
  3. 检查蓝色 LED 是否在模式 1 下闪烁。若闪烁,则表示设备尚未加入 Z-Wave® 网络。
  4. 连接电源后数秒内,系统将自动启动添加流程,设备将自动加入网络。
  5. 添加过程中,蓝色 LED 将在模式 2 下闪烁。
  6. 若设备成功加入网络,绿色 LED 将在模式 1 下闪烁。

使用 S 按钮添加(包含)

  1. 将设备连接至电源。
  2. 检查蓝色 LED 是否在模式 1 下闪烁。若是,则表示设备未加入网络。
  3. 在网关上启用添加/移除模式。
  4. 快速按下并长按 S 按钮,直至 LED 变为稳定的蓝色,进入设置模式。
  5. 快速松开,然后再次长按 S 按钮超过 2 秒,直到蓝色 LED 开始在模式 3 下闪烁。松开按钮将启动学习模式。
  6. 添加过程中,蓝色 LED 将在模式 2 下闪烁。
  7. 若设备成功加入网络,绿色 LED 将在模式 1 下闪烁。

注意! 在设置模式下,设备将在 10 秒后自动返回正常模式。

使用开关/按钮添加(包含)

  1. 将设备连接至电源。
  2. 检查蓝色 LED 是否在模式 1 下闪烁。若是,则表示设备未加入网络。
  3. 在网关上启用添加/移除模式。
  4. 在 3 秒内快速切换连接至任意 SW 端子(SW、SW1、SW2 等)的开关/按钮共 3 次(此操作使设备进入学习模式)。设备必须接收到 3 次开/关信号,即按动瞬时开关 3 次,或开关开启/关闭各 3 次。
  5. 添加过程中,蓝色 LED 将在模式 2 下闪烁。
  6. 若设备成功加入网络,绿色 LED 将在模式 1 下闪烁。

学习模式:一种允许设备从网关接收网络信息的状态。


从 Z-Wave® 网络中移除设备(排除)

注意! 设备将从您的 Z-Wave® 网络中移除,但自定义配置参数不会被清除。

注意! 若设备成功添加或从网络中移除,所有设备输出端口(O、O1、O2 等,视设备类型而定)将自动执行 1 秒开/关 → 1 秒开/关的操作。

使用 S 按钮移除(排除)

  1. 将设备连接至电源。
  2. 检查绿色 LED 是否在模式 1 下闪烁。若是,则表示设备已加入网络。
  3. 在网关上启用添加/移除模式。
  4. 快速按下并长按 S 按钮,直至 LED 变为稳定的蓝色,进入设置模式。
  5. 快速松开,然后再次长按 S 按钮超过 2 秒,直到蓝色 LED 开始在模式 3 下闪烁。松开按钮将启动学习模式。
  6. 移除过程中,蓝色 LED 将在模式 2 下闪烁。
  7. 若设备成功移除,蓝色 LED 将在模式 1 下闪烁。

注意! 在设置模式下,设备将在 10 秒后自动返回正常模式。

使用开关/按钮移除(排除)

  1. 将设备连接至电源。
  2. 检查绿色 LED 是否在模式 1 下闪烁。若是,则表示设备已加入网络。
  3. 在网关上启用添加/移除模式。
  4. 在 3 秒内快速切换连接至任意 SW 端子(SW、SW1、SW2 等)的开关/按钮共 3 次(此操作使设备进入学习模式)。设备必须接收到 3 次开/关信号,即按动瞬时开关 3 次,或开关开启/关闭各 3 次。
  5. 移除过程中,蓝色 LED 将在模式 2 下闪烁。
  6. 若设备成功移除,蓝色 LED 将在模式 1 下闪烁。

出厂重置

通用说明

出厂重置后,所有自定义参数和存储值(如累计电量、关联关系、路由等)将恢复为默认状态。分配给设备的 HOME ID 和 NODE ID 将被删除。仅当网关缺失或无法使用时才建议使用此操作。

使用 S 按钮重置

注意! 可随时通过 S 按钮进行出厂重置。

  1. 快速按下并长按 S 按钮,直到 LED 变为稳定蓝色,进入设置模式。
  2. 多次按下 S 按钮,直到 LED 变为稳定红色。
  3. 长按 S 按钮超过 2 秒,直到红色 LED 开始在模式 3 下闪烁。松开按钮将启动出厂重置。
  4. 重置过程中,LED 会先亮起约 1 秒的绿色,随后蓝灯和红灯将在模式 3 下闪烁约 2 秒。
  5. 若重置成功,蓝色 LED 将在模式 1 下闪烁。

使用开关/按钮重置

注意! 使用开关/按钮进行出厂重置仅限设备通电后的前 1 分钟内有效。

  1. 将设备连接至电源。
  2. 在 3 秒内快速切换连接至任意 SW 端子(SW、SW1、SW2 等)的开关/按钮共 5 次。设备必须接收到 5 次开/关信号,即按动按钮 5 次,或开关开启/关闭各 5 次。
  3. 重置过程中,LED 会先亮起约 1 秒的绿色,随后蓝灯和红灯将在模式 3 下闪烁约 2 秒。
  4. 若重置成功,蓝色 LED 将在模式 1 下闪烁。

通过网关远程重置

可通过设置参数编号 120 实现远程出厂重置。


Z-Wave® 安全与设备特定密钥(DSK)

本设备支持最新的安全 2(S2)功能。S2 采用强 AES 128 加密协议,使 Z-Wave® 成为目前最安全的物联网(IoT)安全平台之一。为充分发挥产品及其 S2 功能,必须使用支持 S2 的 Z-Wave® 网关。

  • 认证控制
    • 包含时使用带外(OOB)DSK
    • 可被大多数实现方式使用

本设备还支持安全 2 认证、未认证及不安全包含。

注意! 使用支持 S2 的网关添加设备时,需提供设备特定密钥(DSK)的验证码。唯一标识码打印在设备侧边的 DSK 标签上,且包装内附有一份副本,切勿丢失。请勿移除产品上的 DSK 标签。建议保留包装内的备份标签。

DSK 示例

密钥的前五位数字以加粗或下划线标出,便于用户识别验证码部分。该 DSK 也以二维码形式展示,如图所示。

请求加入 S2 访问控制类或 S2 认证类的节点,在通过射频传输其公钥前,会将字节 1-2 设置为零(0x00)以隐藏其公钥。

DSK 可用于带外(OOB)认证。

  • 包含网关可使用二维码扫描设备读取整个 DSK,并与通过射频接收到的混淆公钥匹配。

Z-Wave® 参数

参数编号 1 – SW(SW1)开关类型

定义设备如何处理连接至 SW(SW1)端子的开关。

  • 数值大小:1 字节
  • 默认值:2
  • 取值与说明
    • 0 – 瞬时开关
    • 1 – 切换开关(触点闭合 = ON / 触点断开 = OFF)
    • 2 – 切换开关(设备状态随开关状态变化)

参数编号 17 – 断电后恢复输出端口 O(O1)状态

决定是否在断电后保存并恢复连接至 O(O1)的负载的开/关状态。

  • 数值大小:1 字节
  • 默认值:0
  • 取值与说明
    • 0 – 保存最后的开/关状态并在断电后恢复
    • 1 – 不保存也不恢复;保持关闭

参数编号 19 – 输出端口 O(O1)定时自动关闭

设定负载 O(O1)在设定时间后自动关闭。每次接收到开命令时,计时器将重置。

  • 数值大小:2 字节
  • 默认值:0
  • 取值与说明
    • 0 – 自动关闭功能禁用
    • 1–32535 = 1–32535 秒(或毫秒,详见参数编号 25)

参数编号 20 – 输出端口 O(O1)定时自动开启

设定负载 O(O1)在设定时间后自动开启。每次接收到关命令时,计时器将重置。

  • 数值大小:2 字节
  • 默认值:0
  • 取值与说明
    • 0 – 自动开启功能禁用
    • 1–32535 = 1–32535 秒(或毫秒,详见参数编号 25)

参数编号 23 – 输出端口 O(O1)触点类型 – 常开/常闭

设置输出端口 O(O1)继电器的触点类型:常开(NO)或常闭(NC)。

  • 数值大小:1 字节
  • 默认值:0
  • 取值与说明
    • 0 – 常开(NO)
    • 1 – 常闭(NC)
触点类型命令设备输出状态
NO (0)OFFOFF (0 V)
NO (0)ONON (230 V)
NC (1)OFFON (230 V)
NC (1)ONOFF (0 V)

参数编号 25 – 设置定时器单位为秒或毫秒(针对输出端口 O(O1))

设置参数编号 19 和 20 的定时器单位为秒或毫秒。

  • 数值大小:1 字节
  • 默认值:0
  • 取值与说明
    • 0 – 定时器单位为秒
    • 1 – 定时器单位为毫秒

参数编号 91 – 水浸报警

决定设备应响应哪些报警帧及其行为。

  • 数值大小:4 字节
  • 默认值:0
  • 取值与说明
    • 0 – 无操作
    • 1 – 打开继电器
    • 2 – 关闭继电器

参数编号 92 – 烟雾报警

同上。

  • 默认值:0
  • 取值与说明
    • 0 – 无操作
    • 1 – 打开继电器
    • 2 – 关闭继电器

参数编号 93 – 一氧化碳报警

同上。

  • 默认值:0
  • 取值与说明
    • 0 – 无操作
    • 1 – 打开继电器
    • 2 – 关闭继电器

参数编号 94 – 热感报警

同上。

  • 默认值:0
  • 取值与说明
    • 0 – 无操作
    • 1 – 打开继电器
    • 2 – 关闭继电器

参数编号 120 – 出厂重置

重置为出厂默认设置并从 Z-Wave 网络中移除。

  • 数值大小:1 字节
  • 默认值:0
  • 取值与说明
    • 0 – 不执行出厂重置
    • 1 – 执行出厂重置

高级参数,可能隐藏在“高级”标签下。

参数编号 201 – 序列号 1

包含设备序列号的一部分。

  • 只读,不可更改
  • 高级,可能隐藏在“高级”标签下
  • 数值大小:4 字节
  • 范围:0x00000000 – 0x7FFFFFFF

参数编号 202 – 序列号 2

同上。

参数编号 203 – 序列号 3

同上。


Z-Wave® 命令类别

  1. ASSOCIATION_V2 [S0, S2]*
  2. ASSOCIATION_GRP_INFO_V3 [S0, S2]*
  3. BASIC_V2 [S0, S2]*
  4. SWITCH_BINARY_V2 [S0, S2]*
  5. CONFIGURATION_V4 [S0, S2]*
  6. DEVICE_RESET_LOCALLY_V1 [S0, S2]*
  7. FIRMWARE_UPDATE_MD_V5 [S0, S2]*
  8. INDICATOR_V3 [S0, S2]*
  9. MANUFACTURER_SPECIFIC_V2 [S0, S2]*
  10. MULTI_CHANNEL_ASSOCIATION_V3 [S0, S2]*
  11. NOTIFICATION_V8 [S0, S2]*
  12. POWERLEVEL_V1 [S0, S2]*
  13. SECURITY_V1
  14. SECURITY_2_V1
  15. SUPERVISION_V1
  16. TRANSPORT_SERVICE_V2
  17. VERSION_V3 [S0, S2]*
  18. ZWAVEPLUS_INFO_V2

Z-Wave® 通知命令类

注释检测到过热
Z-Wave 通知类型名称热感报警
Z-Wave 通知类型 - 值0x04
Z-Wave 通知类型 - 事件状态
Z-Wave 通知名称检测到过热
Z-Wave 通知名称 - 值0x02
Z-Wave 通知名称 - 版本V2
Z-Wave 设备特定
LED 信号指示参考 LED 信号表
设备反应 – 关闭所有输出并发送通知
恢复操作 – 重启电源
恢复操作 – 短按 S 按钮
恢复操作 – 按下任意连接至任意 SW(SW、SW1、SW2……)端子的开关/按钮

Z-Wave® 关联关系

关联用于设备与网内其他设备之间的直接通信,无需依赖网关。

  • 每组最多可关联 9 个设备(固定,不可配置)
  • 建议每组不超过 5 个,避免网络延迟
  • “生命线组”专用于网关(仅允许 1 个节点)

关联组 1 – 生命线组

报告设备状态,并仅允许分配单一设备(默认为网关)。支持:

  • INDICATOR_REPORT:LED 状态
  • DEVICE_RESET_LOCALLY_NOTIFICATION:请求触发
  • SWITCH_BINARY_REPORT:输出端口 O(O1)状态变更报告
  • NOTIFICATION_REPORT:过热事件触发

关联组 2

  • 允许节点:9 个
  • 分配给连接至 SW(SW1)端子的开关(使用 Basic 命令类)
  • 触发条件:由 SW(SW1)触发,向关联设备发送 BASIC_SET ON/OFF
  • 支持:BASIC_SET

关联组 3

  • 允许节点:9 个
  • 分配给连接至 SW(SW1)端子的开关(使用多级启停命令类)
  • 触发条件:由 SW(SW1)触发,发送 SWITCH_MULTILEVEL_START_LEVEL_CHANGE 或 STOP_LEVEL_CHANGE
  • 支持:
    • SWITCH_MULTILEVEL_START_LEVEL_CHANGE
    • SWITCH_MULTILEVEL_STOP_LEVEL_CHANGE

Z-Wave® 重要免责声明

Z-Wave® 无线通信并非总是 100% 可靠。本设备不应用于生命或贵重物品完全依赖其运行的场景。如果设备未被您的网关识别或显示异常,您可能需要手动更改设备类型,并确保您的网关支持 Z-Wave Plus® 多级设备。


故障排查

有关故障排查,请访问我们的支持门户:支持中心


兼容性列表

网关开关控制SW 开关控制备注
Home Assistant
Fibaro HC 3 / Z-Wave 引擎 3
Homey
Homee Cube Gen 7
Homee Cube Gen 5
SmartThings需使用 Shelly Wave 边缘驱动程序
Vera Ezlo
Cozify
Hubitat

图例说明

符号状态
正常工作 / 可行
🌟无法工作 / 不可行
P部分支持
N/T未测试
TBD待完成

功能含义

功能含义 / 测试情况
开关控制响应应用界面的开/关命令
SW 开关控制报告由 SW 输入引起的开/关状态变化
亮度调节响应应用界面的调光命令
SW 亮度调节报告由 SW 输入引起的调光状态变化
功率功率值上报(非请求)
用电量用电量上报(非请求)
上下调节响应应用界面的上下调节命令
SW 上下调节报告由 SW 输入引起的上下调节变化
百叶窗角度百叶窗角度响应应用界面命令
SW 百叶窗角度百叶窗角度报告由 SW 引起的变化
按键控制独立模式:报告场景命令(单击、双击等)
按键二进制独立模式:报告由 SW 输入引发的二进制开/关状态
传感器 #传感器数据在网关中可视化;类型见备注

网关使用指南

您可在 Z-Wave Shelly 知识库 中找到有用的网关使用指南。


合规声明

合规档案 - [Wave 1 多语言欧盟合规声明(2023-07-21)](/wiki/spaces/KB/pages/216662017/Wave+1+EU?preview=%2F216662017%2F1625359220%2FWave+1+multilingual+EU+declaration+of+conformity+8-0+2023-07-21.pdf)

打印用户手册


安装视频指南

安装视频指南