Shelly Wave Pro 2 - 设备指南
注意：此前被称为“Shelly Qubino Wave”的产品系列，现将统一更名为“Shelly Wave”。此次更名不会影响任何设备的功能。唯一的变化是未来所有文档中将使用新名称。
设备识别
- 设备型号：Wave Pro 2
- 美国零件号 / 订购代码：QPSW-0A2X16US
- Z-Wave 产品类型 ID：0x0002
- Z-Wave 产品 ID：0x008C
- Z-Wave 制造商：Shelly Europe Ltd.
- Z-Wave 制造商 ID：0x0460
术语说明
- 设备 – 在本文档中，“设备”一词指代本指南所描述的 Shelly Qubino 型号设备。
- 网关 – 一个 Z-Wave® 网关（也称为 Z-Wave® 控制器、主控制器、主控设备或中心枢纽），作为 Z-Wave® 智能家居网络的中央枢纽。本文档中统一使用“网关”一词。
- S 按钮 – 安装在 Z-Wave® 设备上的服务按钮，用于执行添加（包含）、移除（排除）及恢复出厂设置等操作。本文档中统称其为“S 按钮”。
简要说明
Shelly Wave Pro 2 是一款可安装于标准 DIN 导轨的双通道智能开关，具备无源触点功能。它可控制两个独立的电气负载，每通道最大支持 16 A（总计 25 A）。该设备同时支持普通开关（默认）和按钮两种模式。
连接至输入端子 SW（SW1）的开关
若将 SW（SW1）配置为 开关（默认）：
- 单次拨动：切换输出端口 O1 的状态（开 ↔ 关），并向关联设备组 2 和 3 发送命令（参见 Z-Wave 关联）。
- 快速两次拨动（间隔 ≤500ms）：被解释为双动作操作，向组 2 和 3 中的调光器、百叶窗等设备发送命令。
连接至输入端子 SW（SW1）的开关记忆型输入
若将 SW（SW1）配置为 开关记忆型：
- 闭合触点：输出端口 O1 打开，并向组 2 和 3 中的关联设备发送命令。
- 断开触点：输出端口 O1 断开，并向组 2 和 3 中的关联设备发送命令。
连接至输入端子 SW（SW1）的按钮
若将 SW（SW1）配置为 按钮：
- 短按：切换输出端口 O1 的状态（开 ↔ 关），并向组 2 和 3 中的关联设备发送命令。
- 长按：向组 3 中的设备发送命令。
- 松开：向组 3 中的设备发送命令。
连接至输入端子 SW2 的开关
若将 SW2 配置为 开关（默认）：
- 单次拨动：切换输出端口 O2 的状态（开 ↔ 关），并向组 4 和 5 中的关联设备发送命令。
- 快速两次拨动（间隔 ≤500ms）：被解释为双动作操作，向组 4 和 5 中的调光器、百叶窗等设备发送命令。
连接至输入端子 SW2 的开关记忆型输入
若将 SW2 配置为 开关记忆型：
- 闭合触点：输出端口 O2 打开，并向组 4 和 5 中的关联设备发送命令。
- 断开触点：输出端口 O2 断开，并向组 4 和 5 中的关联设备发送命令。
连接至输入端子 SW2 的按钮
若将 SW2 配置为 按钮：
- 短按：切换输出端口 O2 的状态（开 ↔ 关），并向组 4 和 5 中的关联设备发送命令。
- 长按：向组 4 中的设备发送命令。
- 松开：向组 5 中的设备发送命令。
控制连接至输出端口 O（O1）的负载
连接至 O1 的负载可通过以下方式控制：
- Z-Wave 命令
- 通过参数 19 和 20 启用的自动切换功能
- 按下开关/按钮 SW（SW1）：切换所连负载的状态
控制连接至输出端口 O2 的负载
连接至 O2 的负载可通过以下方式控制：
- Z-Wave 命令
- 通过参数 21 和 22 启用的自动切换功能
- 按下开关/按钮 SW2：切换所连负载的状态
主要应用场景
- 住宅
- 多户单元（公寓、联排别墅、酒店等）
- 轻型商业（小型办公室、零售店、餐厅、加油站）
- 政府/市政机构
- 大学/学院
- 农业领域
兼容集成
Shelly Wave 设备基于全球领先的智能家居技术 Z-Wave，可与所有支持 Z-Wave 协议的 认证网关 兼容。
我们定期测试与各类 Z-Wave 网关的兼容性，以确保功能完整。
简化内部原理图
设备电气接口
输入端口
- 2 个螺丝端子上的开关/按钮输入
- 2 个螺丝端子上的无源触点继电器输入
- 2 个螺丝端子上的电源输入：N、L
输出端口
- 2 个螺丝端子上的无源触点继电器输出
连接方式
- Z-Wave：非安全连接、S0 安全、S2 未认证安全、S2 已认证安全
安全特性
过热保护
- 自动切断继电器供电
- 向网关发送 通知报告（“检测到过热”）
- LED 根据报警模式闪烁（详见下文）
复位条件：断电重启、短按 S 按钮，或按下任意开关/按钮（SW1、SW2 等）
✅ 注意：过热保护始终启用，不可关闭。
🔗 详情请参阅 过热检测通知
支持的负载类型
- 电阻型（白炽灯泡、加热设备）
- 容性（电容组、电子设备、电机启动电容）
- 感性带 RC 抑制电路（LED 驱动器、变压器、风扇、冰箱、空调）
用户界面
S 按钮与工作模式
- 正常模式
- “设置进行中”模式
- 设置模式（通过 S 按钮）
- 必须进入此模式才能执行包含、排除或恢复出厂设置等操作。
- 操作完成后自动退出。
- 进入设置模式方法：
- 快速按住 S 按钮，直至 LED 变为常亮蓝色。
- 再次快速点击可循环菜单（无限循环）。
- 菜单超时时间：10 秒后返回正常模式。
S 按钮功能
- 手动将设备添加至 Z-Wave 网络
- 手动从 Z-Wave 网络中移除设备
- 恢复设备出厂设置
LED 指示灯信号
| 状态 | LED 表现 |
|---|---|
| 已移除/排除 | 模式 1 下蓝色闪烁（通电或按下 S 按钮后 10 分钟内） |
| 已添加/包含 | 模式 1 下绿色闪烁（通电或按下 S 按钮后 10 分钟内） |
| 恢复出厂设置并重启 | 常亮绿色（约 1 秒），随后蓝红交替闪烁（0.1 秒亮/灭）约 2 秒 |
| 添加/移除过程中 | 模式 2 下蓝色闪烁 |
| 固件升级中 | 模式 2 下蓝红交替闪烁 |
| 电源检查中 | 模式 5 下蓝红交替闪烁 |
| 菜单选中（添加/移除） | 常亮蓝色（最长 10 秒） |
| 菜单执行中（添加/移除） | 模式 3 下蓝色闪烁 |
| 菜单选中（恢复出厂设置） | 常亮红色（最长 10 秒） |
| 菜单执行中（恢复出厂设置） | 模式 3 下红色闪烁 |
| 检测到过热 | 模式 4 下红色闪烁：2 次（0.2 秒亮/灭），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) | 负载回路 1 火线（110–240 V AC） |
| SW | 开关/按钮输入端子（控制 O1） | L2(B) | 负载回路 2 火线（110–240 V AC） |
| SW2 | 开关/按钮输入端子（控制 O2） | L3(C) | 设备供电火线（110–240 V AC） |
| I1 | 负载回路输入端子 1 | — | — |
| I2 | 负载回路输入端子 2 | — | — |
| O1 | 负载回路输出端子 1 | — | — |
| O2 | 负载回路输出端子 2 | — | — |
关于 Z-Wave®
将设备添加至 Z-Wave® 网络（包含）
💡 注意：成功添加或移除后，所有输出端口（O、O1、O2）会短暂开启/关闭一次（各持续 1 秒）。
SmartStart 包含方式
- 使用网关应用程序扫描 Z-Wave 二维码。
- 将设备的 DSK 添加至配置列表。
- 接通设备电源。
- 若蓝色 LED 在模式 1 下闪烁 → 表示尚未完成添加。
- 设备将在数秒内自动加入网络。
- 添加过程中，蓝色 LED 在模式 2 下闪烁。
- 成功后，绿色 LED 在模式 1 下闪烁。
通过 S 按钮添加
- 接通设备电源。
- 确认蓝色 LED 在模式 1 下闪烁。
- 在网关上启用“添加/移除”模式。
- 按住 S 按钮，直到 LED 变为常亮蓝色。
- 松开后再次按住（>2 秒），直到 LED 在模式 3 下闪烁 → 进入学习模式。
- 添加过程中，蓝色 LED 在模式 2 下闪烁。
- 成功后，绿色 LED 在模式 1 下闪烁。
⏱️ 设置模式超时时间：10 秒
通过开关/按钮添加
- 接通设备电源。
- 确认蓝色 LED 在模式 1 下闪烁。
- 在网关上启用“添加/移除”模式。
- 在 3 秒内快速拨动开关/按钮 3 次 → 进入学习模式。
- 添加过程中，蓝色 LED 在模式 2 下闪烁。
- 成功后，绿色 LED 在模式 1 下闪烁。
🔑 学习模式：允许设备接收来自网关的网络信息的状态。
从 Z-Wave® 网络中移除设备（排除）
💡 注意：自定义配置保持不变，仅解除网络成员关系。
通过 S 按钮移除
- 接通设备电源。
- 确认绿色 LED 在模式 1 下闪烁 → 表示设备已加入网络。
- 在网关上启用“添加/移除”模式。
- 按住 S 按钮，直到 LED 变为常亮蓝色。
- 松开后再次按住（>2 秒），直到 LED 在模式 3 下闪烁 → 进入学习模式。
- 移除过程中，蓝色 LED 在模式 2 下闪烁。
- 成功后，蓝色 LED 在模式 1 下闪烁。
通过开关/按钮移除
- 接通设备电源。
- 确认绿色 LED 在模式 1 下闪烁。
- 在网关上启用“添加/移除”模式。
- 在 3 秒内快速拨动开关/按钮 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 秒内快速拨动开关/按钮 5 次。
- 重置期间：LED 先常亮绿色（约 1 秒），然后蓝红交替闪烁（模式 3，约 2 秒）。
- 成功后，蓝色 LED 在模式 1 下闪烁。
通过参数编号 120 远程触发
将参数 120 设置为 1，即可远程触发恢复出厂设置。
Z-Wave® 安全性与设备特定密钥（DSK）
该设备支持 安全 2（S2），采用 AES-128 加密，是目前最安全的物联网平台。
- 已认证控制：包含时需使用外带的 DSK
- 支持：S2 已认证、S2 未认证、非安全包含
🔑 重要提示：通过启用了 S2 的网关添加设备时，必须输入设备标签上的 5 位数字 PIN（设备及包装上均有标注）。请勿撕下标签。
前五位数字以高亮/下划线标出。DSK 也以二维码形式呈现。
对于 S2 访问控制类或已认证类，加入节点会在射频传输前将字节 1–2 设置为零，以混淆其公钥。
网关可通过扫描二维码匹配该混淆后的公钥。
Z-Wave® 参数
| 参数 | 描述 | 大小 | 默认值 | 取值与说明 |
|---|---|---|---|---|
| 1 – SW (SW1) 开关类型 | 定义如何解释 SW1 | 1 字节 | 2 | 0：瞬时开关，1：拨动开关（闭合=开），2：拨动开关（状态改变） |
| 2 – SW2 开关类型 | 定义如何解释 SW2 | 1 字节 | 2 | 同上 |
| 6 – 输入端子 SW1 & SW2 互换 | 交换 SW1/SW2 的操作逻辑 | 1 字节 | 0 | 0：默认（SW1→O1，SW2→O2），1：互换（SW1→O2，SW2→O1） |
| 16 – 输出端子 O1 & O2 互换 | 交换继电器输出 | 1 字节 | 0 | 0：默认（O1=开，O2=闭），1：相反 |
| 17 – 断电后恢复 O1 状态 | 保存/恢复 O1 状态 | 1 字节 | 0 | 0：恢复上次状态，1：保持关闭 |
| 18 – 断电后恢复 O2 状态 | 保存/恢复 O2 状态 | 1 字节 | 0 | 同上 |
| 19 – O1 自动关机计时器 | 经过指定时间后自动关闭 | 2 字节 | 0 | 0：禁用，1–32535：秒数（若参数 25 = 1，则为毫秒） |
| 20 – O1 自动开机计时器 | 经过指定时间后自动开启 | 2 字节 | 0 | 同上 |
| 21 – O2 自动关机计时器 | 经过指定时间后自动关闭 | 2 字节 | 0 | 同上 |
| 22 – O2 自动开机计时器 | 经过指定时间后自动开启 | 2 字节 | 0 | 同上 |
| 23 – O1 触点类型（常开/常闭） | 继电器触点类型 | 1 字节 | 0 | 0：常开（NO），1：常闭（NC） |
| 24 – O2 触点类型（常开/常闭） | 继电器触点类型 | 1 字节 | 0 | 0：常开（NO），1：常闭（NC） |
| 25 – O1 计时器单位（秒/毫秒） | 设置计时精度 | 1 字节 | 0 | 0：秒，1：毫秒 |
| 26 – O2 计时器单位（秒/毫秒） | 设置计时精度 | 1 字节 | 0 | 0：秒，1：毫秒 |
| 91 – 水浸报警响应 | 对水浸报警帧的响应 | 4 字节 | 0 | 0：无操作，1：打开继电器，2：关闭继电器 |
| 92 – 烟雾报警响应 | 对烟雾报警帧的响应 | 4 字节 | 0 | 同上 |
| 93 – 一氧化碳报警响应 | 对一氧化碳报警帧的响应 | 4 字节 | 0 | 同上 |
| 94 – 高温报警响应 | 对高温报警帧的响应 | 4 字节 | 0 | 同上 |
| 120 – 恢复出厂设置 | 触发恢复出厂设置 | 1 字节 | 0 | 0：不重置，1：重置 |
| 201–203 – 序列号部分 | 只读序列号部分 | 每个 4 字节 | 设备特有 | 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_V1SECURITY_2_V1SUPERVISION_V1TRANSPORT_SERVICE_V2VERSION_V3[S0, S2]ZWAVEPLUS_INFO_V2
端点 1
ASSOCIATION_V2[S0, S2]ASSOCIATION_GRP_INFO_V3[S0, S2]BASIC_V2[S0, S2]MULTI_CHANNEL_V4[S0, S2]NOTIFICATION_V8[S0, S2]SECURITY_V1SECURITY_2_V1SUPERVISION_V1ZWAVEPLUS_INFO_V2
端点 2
ASSOCIATION_V2[S0, S2]ASSOCIATION_GRP_INFO_V3[S0, S2]BASIC_V2[S0, S2]SWITCH_BINARY_V2[S0, S2]MULTI_CHANNEL_V4[S0, S2]NOTIFICATION_V8[S0, S2]SECURITY_V1SECURITY_2_V1SUPERVISION_V1ZWAVEPLUS_INFO_V2
[S2]* = 安全 2 命令类
Z-Wave® 通知命令类
检测到过热
| 字段 | 值 |
|---|---|
| 通知类型名称 | 热警报 |
| 通知类型 - 值 | 0x04 |
| 通知事件 | 状态 |
| 通知名称 | 检测到过热 |
| 通知名称 - 值 | 0x02 |
| 版本 | V2 |
| LED 信号 | 参见 LED 表 |
| 设备反应 | 切断所有输出 + 发送通知 |
| 恢复操作 | 断电重启、短按 S 按钮，或拨动任一开关 |
Z-Wave® 关联设置
关联允许设备之间直接通信，无需网关介入。
- 每组最多 9 个设备（建议 ≤5 个）
- 生命线组（组 1）：专供网关使用（仅允许 1 个节点）
关联组 1（生命线）
- 端点 1（O1）：
SWITCH_BINARY_REPORT、NOTIFICATION_REPORT、INDICATOR_REPORT、DEVICE_RESET_LOCALLY_NOTIFICATION - 端点 2（O2）：
SWITCH_BINARY_REPORT
关联组 2（基本命令）
- 分配给 SW1（端点 2 为 SW2）
- 根据开关状态触发
BASIC_SET ON/OFF
关联组 3（多级命令）
- 分配给 SW1（端点 2 为 SW2）
- 推荐用于按钮
- 触发：
SWITCH_MULTILEVEL_START_LEVEL_CHANGE、SWITCH_MULTILEVEL_STOP_LEVEL_CHANGE
关联组 4（基本命令）
- 分配给 SW2（端点 2）
- 触发
BASIC_SET ON/OFF
关联组 5（多级命令）
- 分配给 SW2（端点 2）
- 触发与组 3 相同的多级命令
Z-Wave® 重要免责声明
Z-Wave® 无线通信并非 100% 可靠。切勿在涉及生命安全的情况下依赖此设备。若设备无响应或行为异常，请手动设置设备类型，并确认网关支持 Z-Wave Plus™ 多级设备。
故障排除
如需帮助，请访问我们的支持门户：支持
兼容性表格
| 网关 | 开/关 1 | 开/关 2 | SW 开/关 1 | SW 开/关 2 | 备注 |
|---|---|---|---|---|---|
| Home Assistant | ✅ | ✅ | ✅ | ✅ | |
| Fibaro HC3 / Z-Wave 引擎 3 | ✅ | ✅ | ✅ | ✅ | |
| Homey | ✅ | ✅ | ✅ | ✅ | *H |
| Homee Gen 7 | ✅ | ✅ | ✅ | ✅ | |
| Homee Gen 5 | ❌ P | ❌ P | ⚠️ 蓝星 | ⚠️ 蓝星 | *1, *2 |
| SmartThings | ✅ | ✅ | ✅ | ✅ | 需要边缘驱动程序 |
| Vera Ezlo | ✅ | ✅ | ✅ | ✅ | |
| Cozify | ✅ | ✅ | ✅ | ✅ |
备注：
*1：网关使用标准生命线；UI 中仅支持对两个输出进行单一控制。
*2：输出状态已更改，但 UI 不反映更新。
*H：可通过 此解决方案 修复问题。
功能含义
| 功能 | 含义 / 测试情况 |
|---|---|
| 开/关 | 响应应用界面的开/关指令 |
| SW 开/关 | 通过 SW 输入报告开/关状态变化 |
| 调光 | 响应应用界面的调光指令 |
| SW 调光 | 通过 SW 输入报告调光状态变化 |
| 瓦特 | 无需请求即主动上报瓦特数 |
| 千瓦时 | 无需请求即主动上报千瓦时数 |
| 上/下 | 响应应用界面的上/下指令 |
| SW 上/下 | 通过 SW 输入报告上/下状态变化 |
| 百叶窗角度 | 百叶窗响应应用界面指令 |
| SW 百叶窗角度 | 百叶窗通过 SW 报告状态变化 |
| D 控制 | 报告场景命令（单击/双击等） |
| D 二进制 | 通过 SW 报告二进制开/关状态 |
| 传感器 # | 在网关中可视化；注意传感器类型 |
图例说明
| 符号 | 状态 |
|---|---|
| ✅ | 正常工作 / 可实现 |
| ⚠️ | 无法工作 / 不可实现 |
| P | 部分支持 |
| N/T | 未测试 |
| TBD | 待定 |
网关指南
更多实用指南请查阅 Shelly 知识库