Shelly Wave Pro 1 – 设备文档
注意：原名为“Shelly Qubino Wave”的产品系列，现将统一更名为“Shelly Wave”。此次更名不会影响任何设备的功能。唯一的变化是在所有未来文档中使用新名称。
设备识别
- 设备型号：Wave Pro 1
- 美国零件号 / 订购代码：QPSW-0A1X16US
- Z-Wave 产品类型 ID：
0x0002 - Z-Wave 产品 ID：
0x008A - Z-Wave 制造商：Shelly Europe Ltd.
- Z-Wave 制造商 ID：
0x0460
术语说明
- 设备：本文档中的“设备”指本指南所描述的 Shelly Qubino 产品。
- 网关：一种 Z-Wave® 网关（也称为 Z-Wave® 控制器、主控制器、初级控制器或中枢等），是用于构建 Z-Wave® 智能家居网络的中心枢纽。本文档中使用“网关”一词。
- S 按钮：位于 Z-Wave® 设备上的服务按钮，用于执行各种功能，如添加（包含）、移除（排除）和恢复出厂设置。本文档中使用“S 按钮”这一术语。
简要说明
该设备是一款可安装于导轨上的智能开关，具备无源触点。它可控制一个额定负载高达 16 A 的电气设备的通断状态。支持与开关（默认）和按钮连接。
连接到输入端子 SW（SW1）的开关
若将 SW（SW1）配置为开关（默认），每次切换开关位置，输出端口 O（O1）的状态将反转——开、关、开，依此类推。
- 切换开关一次：改变输出端口 O（O1）的状态为相反状态，并向组 2 和组 3 中关联的设备发送命令（详见章节 Z-Wave 关联）。
连接到输入端子 SW（SW1）的带记忆开关
若将 SW（SW1）配置为带记忆开关：
- 闭合记忆触点时：将输出端口 O（O1）设为开启，并向组 2 和组 3 中关联的设备发送命令。
- 断开记忆触点时：将输出端口 O（O1）设为关闭，并向组 2 和组 3 中关联的设备发送命令。
连接到输入端子 SW（SW1）的按钮
若在设备设置中将 SW（SW1）配置为按钮，则每次按下都会切换输出状态 O（O1）：
- 短按：切换输出状态 O（O1），并向组 2 和组 3 中的设备发送命令。
- 长按：向组 3 中的设备发送命令。
- 松开：向组 3 中的设备发送命令。
连接到输入端子 SW2 的开关/按钮
若将 SW2 配置为开关（默认），每当开关状态发生变化时，会向组 4（通断）或组 5（SSLC — 仅根单通道设备）发送关联命令，具体取决于当前开关位置。（参见章节 Z-Wave 关联）
连接到输入端子 SW2 的记忆开关
若将 SW2 配置为记忆开关，任何开关状态变化都会根据上次断电前保存的最后状态，向组 4（通断）或组 5（SSLC — 仅根单通道设备）发送关联命令。（参见 Z-Wave 关联 章节）
连接到输入端子 SW2 的按钮
- 短按：在开/关命令之间切换，向组 4（通断）或组 5（SSLC — 仅根单通道设备）发送命令。
- 长按：向组 5（SSLC — 仅根单通道设备）中的设备发送关联命令以启动亮度调节。
- 松开：向组 5（SSLC — 仅根单通道设备）中的设备发送关联命令以停止亮度调节。
通过 O（O1）端口控制负载的通断
连接到 O（O1）的负载可通过以下方式实现通断控制：
- 通过 Z-Wave 命令
- 通过正确设置参数编号 19 和 20 实现自动通断
- 按下开关/按钮 SW（SW1）：将连接负载的状态切换为相反状态
主要应用场景
- 住宅
- 多户单元（公寓、住宅楼、酒店等）
- 轻型商业（小型办公楼、小型零售/餐厅/加油站等）
- 政府/市政机构
- 大学/学院
- 农业
兼容性集成
Shelly Qubino Wave 设备基于全球领先的智能家居技术——Z-Wave开发。
这意味着 Shelly Qubino Wave 可与所有经过认证且支持 Z-Wave 通信协议的网关配合使用。
为确保完整功能，我们定期对不同类型的 Z-Wave 网关进行兼容性测试。
简化内部原理图
设备电气接口
输入端口
- 2 个接线端子上的开关/按钮输入
- 1 个无源触点继电器输入（接线端子）
- 2 个电源输入接线端子：N（零线）、L（火线）
输出端口
- 1 个无源触点继电器输出（接线端子）
连接方式
Z-Wave – 无安全、S0 安全、S2 未认证安全、S2 已认证安全
安全特性
过热保护
- 自动关闭自身继电器
- 向网关发送 通知报告（“检测到过热”）
- LED 按指定方式响应（查看“过热检测”闪烁模式）
以下任一操作均可复位此报警：
- 重启供电
- 快速按下 S 按钮
- 按下任意连接至任何 SW（SW、SW1、SW2…）端子的开关/按钮
注意：过热保护始终启用，无法禁用。
更多详细信息请参见 Z-Wave™ 通知命令类
支持的负载类型
- 阻性负载（白炽灯泡、加热设备）
- 容性负载（电容组、电子设备、电机启动电容）
- 带 RC 吸收电路的感性负载（LED 灯驱动器、变压器、风扇、冰箱、空调）
用户界面
S 按钮与工作模式
- 正常模式
- “设置进行中”模式
- 设置模式（使用 S 按钮）
- 用于启动包含、排除、恢复出厂设置等操作。
- 限时运行；完成操作后自动返回正常模式。
- 进入设置模式：
- 快速按下并保持 S 按钮，直到 LED 变为稳定的蓝色
- 再次快速按下可切换菜单（无限循环）
- 菜单状态的 LED 有 10 秒超时，之后返回正常状态
S 按钮功能
- 手动将设备添加至 Z-Wave 网络
- 手动从 Z-Wave 网络中移除设备
- 将设备恢复出厂设置
LED 指示灯信号
点击查看 LED 指示灯信号
正常模式
已移除/已排除
在每次上电后及按下 S 按钮后，LED 在模式 1 中以蓝色闪烁 10 分钟。
已添加/已包含
在每次上电后及按下 S 按钮后，LED 在模式 1 中以绿色闪烁 10 分钟。
设置进行中
恢复出厂设置并重启
复位过程中：LED 先变为稳定的绿色（约 1 秒），然后蓝红快速闪烁（0.1 秒亮/灭）约 2 秒。添加/移除
LED 在模式 2 中以蓝色闪烁。
OTA 固件更新
LED 在模式 2 中以蓝红闪烁。
检查电源供应（230 V AC / 24 V DC）
LED 在模式 5 中以蓝红闪烁。
使用 S 按钮的设置模式
选择添加/移除菜单
LED 保持稳定的蓝色，持续时间最长 10 秒。正在执行添加/移除
LED 在模式 3 中以蓝色闪烁。
选择恢复出厂设置菜单
LED 保持稳定的红色，持续时间最长 10 秒。正在执行恢复出厂设置
LED 在模式 3 中以红色闪烁。
报警模式
- 检测到过热
LED 在模式 4 中闪烁：0.2 秒亮 / 0.2 秒灭 × 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 秒红亮 |
规格参数
错误渲染宏 'excerpt-include'：用户无权限查看页面 'DEV:Technical Specifications'。
基础接线图
图例
| 端子 | 描述 | 接线 | 描述 |
|---|---|---|---|
| N | 零线端子 | N | 零线 |
| L | 火线端子（110–240 V AC） | L1(A) | 负载回路火线（110–240 V AC） |
| SW | 开关/按钮输入端子（控制 O） | L2(B) | 设备电源火线（110–240 V AC） |
| SW2 | 开关/按钮输入端子 | ||
| I | 负载回路输入端子 | ||
| O | 负载回路输出端子 |
关于 Z-Wave®
将设备添加至 Z-Wave® 网络（包含）
注意！ 若设备成功添加/移除，所有设备输出（O、O1、O2 等）将短暂通断一次。
注意！ 使用 S2 安全包含时，网关会弹出对话框要求输入贴在设备侧面及包装内的 Z-Wave® DSK 标签上的 5 位数字 PIN 码。
重要提示：请勿丢失该 PIN 码。
SmartStart 添加（包含）
支持 SmartStart 的产品可通过扫描设备上的 Z-Wave® 二维码，由支持 SmartStart 的网关完成添加。
- 在网关应用中扫描二维码，并将 DSK 添加至预配列表。
- 将设备接入电源。
- 检查蓝色 LED 是否在模式 1 中闪烁 → 表示尚未添加。
- 上电后数秒内设备将自动添加。
- 添加过程中蓝色 LED 在模式 2 中闪烁。
- 成功后绿色 LED 在模式 1 中闪烁。
使用 S 按钮添加（包含）
- 将设备接入电源。
- 确认蓝色 LED 在模式 1 中闪烁。
- 在网关上启用添加/移除模式。
- 按住 S 按钮，直到 LED 变为稳定蓝色。
- 释放后，再次按住（>2 秒），直到 LED 在模式 3 中闪烁 → 进入学习模式。
- 添加过程中蓝色 LED 在模式 2 中闪烁。
- 成功后绿色 LED 在模式 1 中闪烁。
注意：设置模式在 10 秒后自动返回正常模式。
使用开关/按钮添加（包含）
- 将设备接入电源。
- 确认蓝色 LED 在模式 1 中闪烁。
- 在网关上启用添加/移除模式。
- 在 3 秒内快速切换任意 SW 端子（SW、SW1、SW2）上的开关/按钮共 3 次 → 设备进入学习模式。
- 添加过程中蓝色 LED 在模式 2 中闪烁。
- 成功后绿色 LED 在模式 1 中闪烁。
学习模式：允许设备接收来自网关的网络信息的状态。
从 Z-Wave® 网络中移除设备（排除）
注意：设备将从您的 Z-Wave® 网络中移除，但自定义配置保持不变。
注意：成功移除后，所有输出将短暂通断一次。
使用 S 按钮移除（排除）
- 将设备接入电源。
- 确认绿色 LED 在模式 1 中闪烁 → 表示已添加。
- 在网关上启用添加/移除模式。
- 按住 S 按钮，直到 LED 变为稳定蓝色。
- 释放后，再次按住（>2 秒），直到 LED 在模式 3 中闪烁 → 进入学习模式。
- 排除过程中蓝色 LED 在模式 2 中闪烁。
- 成功后蓝色 LED 在模式 1 中闪烁。
注意：设置模式在 10 秒后自动返回。
使用开关/按钮移除（排除）
- 将设备接入电源。
- 确认绿色 LED 在模式 1 中闪烁。
- 在网关上启用添加/移除模式。
- 在 3 秒内快速切换任意 SW 端子上的开关/按钮共 3 次 → 进入学习模式。
- 排除过程中蓝色 LED 在模式 2 中闪烁。
- 成功后蓝色 LED 在模式 1 中闪烁。
恢复出厂设置
通用说明
恢复出厂设置后：
- 所有自定义参数和存储值（电能消耗、关联、路由等）将恢复为默认值
- HOME ID 和 NODE ID 将被删除
- 仅在网关缺失或无法使用时使用
使用 S 按钮
- 按住 S 按钮，直到 LED 变为稳定蓝色。
- 多次按下 S 按钮，直到 LED 变为稳定红色。
- 按住 S 按钮（>2 秒），直到红色 LED 在模式 3 中闪烁 → 开始重置。
- 重置过程中：LED 快速闪烁绿色（约 1 秒），随后蓝红在模式 3 中闪烁（约 2 秒）。
- 成功后蓝色 LED 在模式 1 中闪烁。
使用开关/按钮
注意：仅在上电后第一分钟内有效。
- 将设备接入电源。
- 在 3 秒内快速切换任意 SW 端子上的开关/按钮共 5 次。
- 重置过程中：LED 快速闪烁绿色（约 1 秒），随后蓝红在模式 3 中闪烁（约 2 秒）。
- 成功后蓝色 LED 在模式 1 中闪烁。
通过参数远程触发（网关）
可通过设置 参数编号 120 = 1 进行远程恢复出厂设置。
Z-Wave® 安全与设备特定密钥（DSK）
该设备支持 安全 2（S2），采用强 AES-128 加密，使 Z-Wave® 成为最安全的物联网平台之一。
- 已认证控制
- 包含时使用外带 DSK
- 与大多数实现兼容
该设备支持：
- S2 已认证
- S2 未认证
- 无安全包含
注意：当使用支持 S2 的网关添加设备时，需输入贴在设备及包装内的 DSK 标签上的 5 位数字 PIN 码。请勿撕掉标签。
前五位数字已高亮/下划线标注。DSK 也以二维码形式呈现。
DSK 标签与二维码（示例）
- 加入节点在无线传输前将公钥字节 1–2 设置为零 (
0x00) 以隐藏其公钥。 - DSK 可用于带外（OOB）认证。
- 网关可扫描二维码以匹配通过无线接收的混淆密钥。
Z-Wave® 参数
参数编号 1 – SW (SW1) 开关类型
- 数值大小：1 字节
- 默认值：2
- 取值：
- 0：瞬时开关
- 1：切换开关（触点闭合 = 开）
- 2：切换开关（开关状态变化时设备状态改变）
参数编号 2 – SW2 开关类型
- 数值大小：1 字节
- 默认值：2
- 取值：
- 0：瞬时开关（按钮）
- 1：切换开关（触点闭合 = 开）
- 2：切换开关（开关状态变化时设备状态改变）
参数编号 17 – 断电后恢复 O (O1) 状态
- 数值大小：1 字节
- 默认值：0
- 取值：
- 0：保存并恢复最后状态
- 1：不保存；断电后保持关闭
参数编号 19 – O (O1) 带定时器自动关闭
- 数值大小：2 字节
- 默认值：0
- 取值：
- 0：自动关闭功能关闭
- 1–32535：定时器（秒，或毫秒——参见参数 25）
每次接收到开启命令（远程或本地）时，定时器将重置。
参数编号 20 – O (O1) 带定时器自动开启
- 数值大小：2 字节
- 默认值：0
- 取值：
- 0：自动开启功能关闭
- 1–32535：定时器（秒，或毫秒——参见参数 25）
每次接收到关闭命令时，定时器将重置。
参数编号 23 – O (O1) 触点类型 – 常开/常闭
- 数值大小：1 字节
- 默认值：0
- 取值：
- 0：常开（NO）
- 1：常闭（NC）
| par-NO/NC | 命令 | 输出状态 |
|---|---|---|
| NO (0) | 关闭 | 关闭（0 V） |
| NO (0) | 打开 | 打开（230 V） |
| NC (1) | 关闭 | 打开（230 V） |
| NC (1) | 打开 | 关闭（0 V） |
参数编号 25 – 设置定时器单位（秒或毫秒）
- 数值大小：1 字节
- 默认值：0
- 取值：
- 0：秒
- 1：毫秒
参数编号 91 – 水浸报警
- 数值大小：4 字节
- 默认值：0
- 取值：
- 0：无操作
- 1：打开继电器
- 2：关闭继电器
参数编号 92 – 烟雾报警
- 数值大小：4 字节
- 默认值：0
- 取值：
- 0：无操作
- 1：打开继电器
- 2：关闭继电器
参数编号 93 – 一氧化碳报警
- 数值大小：4 字节
- 默认值：0
- 取值：
- 0：无操作
- 1：打开继电器
- 2：关闭继电器
参数编号 94 – 高温报警
- 数值大小：4 字节
- 默认值：0
- 取值：
- 0：无操作
- 1：打开继电器
- 2：关闭继电器
参数编号 120 – 恢复出厂设置
- 数值大小：1 字节
- 默认值：0
- 取值：
- 0：不重置
- 1：执行恢复出厂设置
高级参数；可能在“高级”选项卡中隐藏。
参数编号 201–203 – 序列号部分
- 只读，在高级选项卡中隐藏
- 取值范围：
0x00000000至0x7FFFFFFF
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
[S2] = S2 安全命令类
Z-Wave® 通知命令类
检测到过热
| 注释 | 数值 |
|---|---|
| Z-Wave 通知类型名称 | 热报警 |
| 通知类型 – 数值 | 0x04 |
| 通知事件 | 状态 |
| 通知名称 | 检测到过热 |
| 通知名称 – 数值 | 0x02 |
| 通知版本 | V2 |
| LED 指示灯 | 参见 LED 指示表 |
| 设备反应 | 关闭所有输出 + 发送通知 |
| 恢复操作 | 重启供电、快速按下 S 按钮、按下任意 SW 端子 |
Z-Wave® 关联
关联功能可实现设备间直接通信，无需网关参与。
- 每组最多 9 个设备（固定）
- 推荐每组不超过 5 个，以避免延迟
- 生命线组（组 1）：仅限网关使用（仅允许 1 个节点）
关联组 1 – 生命线组
- 支持：
INDICATOR_REPORT：LED 状态DEVICE_RESET_LOCALLY_NOTIFICATION：请求触发SWITCH_BINARY_REPORT：O（O1）状态变化NOTIFICATION_REPORT：过热触发
关联组 2
- 分配给 SW（SW1）
- 使用 基本命令类
- 由 SW（SW1）触发
- 向关联设备发送
BASIC_SET ON/OFF命令
关联组 3
- 分配给 SW（SW1）
- 使用 多级开关命令类
- 由 SW（SW1）触发
- 推荐用于按钮
- 命令：
SWITCH_MULTILEVEL_START_LEVEL_CHANGESWITCH_MULTILEVEL_STOP_LEVEL_CHANGE
关联组 4
- 分配给 SW2
- 使用 基本命令类
- 向关联设备发送
BASIC_SET ON/OFF命令
关联组 5
- 分配给 SW2
- 使用 多级开关命令类
- 推荐用于按钮
- 命令：
SWITCH_MULTILEVEL_START_LEVEL_CHANGESWITCH_MULTILEVEL_STOP_LEVEL_CHANGE
Z-Wave® 重要免责声明
Z-Wave® 无线通信可能无法做到 100% 可靠。该设备不应用于生命关键或高价值场景。如果设备未被识别或行为异常，请手动更改设备类型，并确认您的网关支持 Z-Wave Plus™ 多级设备。
故障排查
如需帮助，请访问我们的支持门户：支持
兼容性
| 网关 | 开/关 | 开关开/关 | 备注 |
|---|---|---|---|
| Home Assistant | ✅ | ✅ | |
| Fibaro HC 3 / Z-Wave 引擎 3 | ✅ | ✅ | |
| Homey | ✅ | ✅ | |
| Homee Cube Gen 7 | ✅ | ✅ | |
| Homee Cube Gen 5 | ✅ | ⚪ | 1* |
| Smart Things | ✅ | ✅ | 使用 Shelly Wave 边缘驱动程序 |
| Jeedom | 待定 | 待定 | |
| Hubitat | 待定 | 待定 |
1* 输出状态变化，但用户界面未能反映更新。
图例
| 符号 | 状态 |
|---|---|
| ✅ | 正常工作 / 可行 |
| ⚪ | 无法工作 / 不可行 |
| P | 部分 |
| N/T | 未测试 |
| TBD | 待定 |
功能含义
| 功能 | 含义 |
|---|---|
| 开/关 | 测试设备是否响应应用界面的开/关命令 |
| 开关开/关 | 测试设备是否通过开关输入报告开/关状态变化 |
| 瓦特 | 测试瓦特值是否主动上报 |
| 千瓦时 | 测试千瓦时是否主动上报 |
| 上/下 | 测试设备是否响应应用界面的上/下命令 |
| 开关上/下 | 测试设备是否通过开关输入报告上/下状态变化 |
| 百叶窗 | 测试百叶窗是否响应应用界面命令 |
| 开关百叶窗 | 测试百叶窗是否通过开关输入报告变化 |
网关指南
更多实用指南请访问 Shelly 知识库