Shelly Wave 设备文档
注意:原先被称为“Shelly Qubino 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 网关进行兼容性测试。
简化内部电路图

设备电气接口
输入
错误渲染宏 '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 分钟。
已添加/包含
每次断电后或按下 S 按钮后,LED 会在模式 1 下持续闪烁绿色 10 分钟。
设置进行中
出厂重置并重启
出厂重置期间,LED 会先亮起约 1 秒的绿色,随后蓝灯和红灯将以 0.1 秒开 / 0.1 秒关的方式闪烁约 2 秒。添加 / 移除
在添加或移除过程中,LED 会在模式 2 下闪烁蓝色。
OTA 固件更新
在 OTA 升级过程中,LED 会在模式 2 下闪烁蓝灯和红灯。
检查电源(230 V AC 频率或 24 V DC 电压)
在检测电源期间,LED 会在模式 5 下闪烁蓝灯和红灯。
使用 S 按钮进入设置模式
选择添加/移除菜单
当菜单被选中时,LED 将保持蓝色点亮,最长不超过 10 秒。添加/移除 – 按住 S 按钮 – 添加/移除过程被选中
当菜单执行时,LED 将在模式 3 下闪烁蓝色。
选择出厂重置菜单
当菜单被选中时,LED 将保持红色点亮,最长不超过 10 秒。出厂重置 – 按住 S 按钮 – 出厂重置过程被选中
当菜单执行时,LED 将在模式 3 下闪烁红色。
报警模式
- 检测到过热
LED 将在模式 4 下闪烁红色:0.2 秒开 / 0.2 秒关 ×(1–6 次)+ 2 秒关,重复此序列。
LED 闪烁模式
点击以查看 LED 闪烁模式
| 模式 | 描述 |
|---|---|
| 模式 1 | 0.5 秒开 / 2 秒关 |
| 模式 2 | 0.5 秒开 / 0.5 秒关 |
| 模式 3 | 0.1 秒开 / 0.1 秒关 |
| 模式 4 | (1–6 次:0.2 秒开 / 0.2 秒关)+ 2 秒关 |
| 模式 5 | 0.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 |
|---|---|---|
![]() | ![]() | ![]() |
图例说明
| 端子 | 描述 | 电缆 | 描述 |
|---|---|---|---|
| N | 中性端子 | N | 中性线 |
| L | 火线端子(110–240 V AC) | L | 火线(110–240 VAC) |
| SW | 开关/按钮输入端子(控制输出 O) | + | 12 / 24–48 VDC 正极线 |
| I | 负载电路输入端子 | GND | 12 / 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 分钟内将自动完成添加。
- 在网关应用中扫描设备标签上的二维码,并将安全 2(S2)设备特定密钥(DSK)添加至网关的预配列表。
- 将设备连接至电源。
- 检查蓝色 LED 是否在模式 1 下闪烁。若闪烁,则表示设备尚未加入 Z-Wave® 网络。
- 连接电源后数秒内,系统将自动启动添加流程,设备将自动加入网络。
- 添加过程中,蓝色 LED 将在模式 2 下闪烁。
- 若设备成功加入网络,绿色 LED 将在模式 1 下闪烁。
使用 S 按钮添加(包含)
- 将设备连接至电源。
- 检查蓝色 LED 是否在模式 1 下闪烁。若是,则表示设备未加入网络。
- 在网关上启用添加/移除模式。
- 快速按下并长按 S 按钮,直至 LED 变为稳定的蓝色,进入设置模式。
- 快速松开,然后再次长按 S 按钮超过 2 秒,直到蓝色 LED 开始在模式 3 下闪烁。松开按钮将启动学习模式。
- 添加过程中,蓝色 LED 将在模式 2 下闪烁。
- 若设备成功加入网络,绿色 LED 将在模式 1 下闪烁。
注意! 在设置模式下,设备将在 10 秒后自动返回正常模式。
使用开关/按钮添加(包含)
- 将设备连接至电源。
- 检查蓝色 LED 是否在模式 1 下闪烁。若是,则表示设备未加入网络。
- 在网关上启用添加/移除模式。
- 在 3 秒内快速切换连接至任意 SW 端子(SW、SW1、SW2 等)的开关/按钮共 3 次(此操作使设备进入学习模式)。设备必须接收到 3 次开/关信号,即按动瞬时开关 3 次,或开关开启/关闭各 3 次。
- 添加过程中,蓝色 LED 将在模式 2 下闪烁。
- 若设备成功加入网络,绿色 LED 将在模式 1 下闪烁。
学习模式:一种允许设备从网关接收网络信息的状态。
从 Z-Wave® 网络中移除设备(排除)
注意! 设备将从您的 Z-Wave® 网络中移除,但自定义配置参数不会被清除。
注意! 若设备成功添加或从网络中移除,所有设备输出端口(O、O1、O2 等,视设备类型而定)将自动执行 1 秒开/关 → 1 秒开/关的操作。
使用 S 按钮移除(排除)
- 将设备连接至电源。
- 检查绿色 LED 是否在模式 1 下闪烁。若是,则表示设备已加入网络。
- 在网关上启用添加/移除模式。
- 快速按下并长按 S 按钮,直至 LED 变为稳定的蓝色,进入设置模式。
- 快速松开,然后再次长按 S 按钮超过 2 秒,直到蓝色 LED 开始在模式 3 下闪烁。松开按钮将启动学习模式。
- 移除过程中,蓝色 LED 将在模式 2 下闪烁。
- 若设备成功移除,蓝色 LED 将在模式 1 下闪烁。
注意! 在设置模式下,设备将在 10 秒后自动返回正常模式。
使用开关/按钮移除(排除)
- 将设备连接至电源。
- 检查绿色 LED 是否在模式 1 下闪烁。若是,则表示设备已加入网络。
- 在网关上启用添加/移除模式。
- 在 3 秒内快速切换连接至任意 SW 端子(SW、SW1、SW2 等)的开关/按钮共 3 次(此操作使设备进入学习模式)。设备必须接收到 3 次开/关信号,即按动瞬时开关 3 次,或开关开启/关闭各 3 次。
- 移除过程中,蓝色 LED 将在模式 2 下闪烁。
- 若设备成功移除,蓝色 LED 将在模式 1 下闪烁。
出厂重置
通用说明
出厂重置后,所有自定义参数和存储值(如累计电量、关联关系、路由等)将恢复为默认状态。分配给设备的 HOME ID 和 NODE ID 将被删除。仅当网关缺失或无法使用时才建议使用此操作。
使用 S 按钮重置
注意! 可随时通过 S 按钮进行出厂重置。
- 快速按下并长按 S 按钮,直到 LED 变为稳定蓝色,进入设置模式。
- 多次按下 S 按钮,直到 LED 变为稳定红色。
- 长按 S 按钮超过 2 秒,直到红色 LED 开始在模式 3 下闪烁。松开按钮将启动出厂重置。
- 重置过程中,LED 会先亮起约 1 秒的绿色,随后蓝灯和红灯将在模式 3 下闪烁约 2 秒。
- 若重置成功,蓝色 LED 将在模式 1 下闪烁。
使用开关/按钮重置
注意! 使用开关/按钮进行出厂重置仅限设备通电后的前 1 分钟内有效。
- 将设备连接至电源。
- 在 3 秒内快速切换连接至任意 SW 端子(SW、SW1、SW2 等)的开关/按钮共 5 次。设备必须接收到 5 次开/关信号,即按动按钮 5 次,或开关开启/关闭各 5 次。
- 重置过程中,LED 会先亮起约 1 秒的绿色,随后蓝灯和红灯将在模式 3 下闪烁约 2 秒。
- 若重置成功,蓝色 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 也以二维码形式展示,如图所示。
请求加入 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) | OFF | OFF (0 V) |
| NO (0) | ON | ON (230 V) |
| NC (1) | OFF | ON (230 V) |
| NC (1) | ON | OFF (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® 命令类别
- ASSOCIATION_V2 [S0, S2]*
- ASSOCIATION_GRP_INFO_V3 [S0, S2]*
- BASIC_V2 [S0, S2]*
- SWITCH_BINARY_V2 [S0, S2]*
- CONFIGURATION_V4 [S0, S2]*
- DEVICE_RESET_LOCALLY_V1 [S0, S2]*
- FIRMWARE_UPDATE_MD_V5 [S0, S2]*
- INDICATOR_V3 [S0, S2]*
- MANUFACTURER_SPECIFIC_V2 [S0, S2]*
- MULTI_CHANNEL_ASSOCIATION_V3 [S0, S2]*
- NOTIFICATION_V8 [S0, S2]*
- POWERLEVEL_V1 [S0, S2]*
- SECURITY_V1
- SECURITY_2_V1
- SUPERVISION_V1
- TRANSPORT_SERVICE_V2
- VERSION_V3 [S0, S2]*
- 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 知识库 中找到有用的网关使用指南。


