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

设备识别
- 设备型号:Wave Pro 1
- 澳大利亚零件号 / 订购代码:QPSW-0A1X16AU
- 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 按钮”。
简要描述
Shelly Wave Pro 1 是一款可安装在导轨上的智能开关,具备无源触点功能。它可控制单个电气设备的通断,最大负载可达 16 A。兼容开关(默认)和按钮。
连接至输入端子 SW(SW1)的开关
若将 SW(SW1)配置为开关(默认状态):
- 单次拨动:输出端口 O(O1)状态切换为相反状态 —— 开 → 关,关 → 开,并向组 2 和组 3 中的相关设备发送命令(参见 Z-Wave 关联)。
- 双击(500 毫秒内完成):被解释为双按操作;向组 2 和组 3 中的调光器、遮阳帘等设备发送命令。
连接至输入端子 SW(SW1)的带记忆开关
当将 SW(SW1)配置为带记忆开关时:
- 闭合触点:输出端口 O(O1)开启;向组 2 和组 3 中的设备发送命令。
- 断开触点:输出端口 O(O1)关闭;向组 2 和组 3 中的设备发送命令。
连接至输入端子 SW(SW1)的按钮
若将 SW(SW1)配置为按钮:
- 短按:切换输出端口 O(O1)状态(开 ↔ 关),并向组 2 和组 3 中的设备发送命令。
- 长按:向组 3 中的设备发送命令。
- 松开:向组 3 中的设备发送命令。
连接至输入端子 SW2 的开关/按钮
若将 SW2 配置为开关(默认),每次开关状态变化都会向以下组发送关联命令:
- 组 4(通/断),或
- 组 5(SSLC - 仅根单通道设备)
具体取决于当前开关位置(参见 Z-Wave 关联)。
连接至输入端子 SW2 的带记忆开关
当将 SW2 配置为带记忆开关时,任何状态变化都将向以下组发送关联命令:
- 组 4(通/断),或
- 组 5(SSLC - 仅根单通道设备)
依据断电后最后一次保存的状态。
连接至输入端子 SW2 的按钮
- 短按:切换发送至组 4(通/断)或组 5(SSLC — 仅根单通道设备)的开/关命令。
- 长按:启动对组 5(SSLC — 仅根单通道设备)中设备的级别调节(如调光)。
- 松开:停止对组 5(SSLC — 仅根单通道设备)中设备的级别调节。
通过 O(O1)控制负载的通断
连接至 O(O1)的负载可通过以下方式实现通断控制:
- 通过 Z-Wave 命令
- 通过参数 19 和 20 的自动切换
- 按下开关/按钮 SW(SW1)
每次操作均会切换输出状态。
主要应用场景
- 住宅建筑
- 多户单元(公寓、别墅、酒店等)
- 轻型商业场所(小型办公室、零售店、餐厅、加油站等)
- 政府/市政设施
- 大学/学院
- 农业领域
兼容集成
Shelly Wave 设备基于 Z-Wave 技术,是全球领先的智能家居技术平台。
支持所有符合标准的、支持 Z-Wave 协议的网关。定期进行兼容性测试,确保在各类网关上均可获得完整支持。
简化内部原理图

设备电气接口
输入端口
- 2 个螺钉端子上的开关/按钮输入
- 1 个螺钉端子上的无源触点继电器输入
- 2 个螺钉端子上的电源输入:N、L
输出端口
- 1 个螺钉端子上的无源触点继电器输出
连接方式
- Z-Wave:非安全模式、S0 安全、S2 未认证安全、S2 已认证安全
安全特性
过热保护
- 自动切断继电器
- 向网关发送“检测到过热”通知
- LED 指示灯相应反应(详见下方闪烁模式)
注意:过热保护始终启用,无法禁用。
重置操作包括:
- 断电重启
- 快速按下 S 按钮
- 按下任意开关/按钮(如 SW1、SW2 等)
支持的负载类型
- 电阻性负载(白炽灯、加热器)
- 电容性负载(电容组、电子设备、电机启动电容)
- 带 RC 吸收电路的电感性负载(LED 驱动器、变压器、风扇、冰箱、空调)
用户界面
S 按钮与工作模式
- 正常模式
- “设置中”模式
- 设置模式(通过 S 按钮)
设置模式用于设备包含、排除或恢复出厂设置。完成后,设备将自动返回正常模式。
进入设置模式:
- 快速按下并持续按住 S 按钮,直到 LED 变为稳定的蓝色
- 再次快速按下可循环菜单选项
- 菜单超时时间:10 秒后自动返回正常模式
S 按钮功能
- 手动将设备添加至 Z-Wave 网络
- 手动从 Z-Wave 网络中移除设备
- 恢复设备出厂设置
LED 指示灯信号
| 状态 | LED 表现 |
|---|---|
| 已移除/排除 | 上电或按下 S 按钮后,蓝灯闪烁(模式 1),持续 10 分钟 |
| 已添加/包含 | 上电或按下 S 按钮后,绿灯闪烁(模式 1),持续 10 分钟 |
| 恢复出厂设置并重启 | 绿灯亮起约 1 秒,随后蓝红交替闪烁(0.1 秒亮/灭,持续约 2 秒) |
| 添加/移除过程中 | 蓝灯闪烁(模式 2) |
| OTA 固件更新中 | 蓝红交替闪烁(模式 2) |
| 电源检查中 | 蓝红交替闪烁(模式 5) |
| 菜单选择(添加/移除) | 稳定蓝色(最长 10 秒) |
| 菜单执行中(添加/移除) | 蓝灯闪烁(模式 3) |
| 菜单选择(恢复出厂设置) | 稳定红色(最长 10 秒) |
| 菜单执行中(恢复出厂设置) | 红灯闪烁(模式 3) |
| 检测到过热(报警模式) | 红灯闪烁(0.2 秒亮/0.2 秒灭),每 2 秒重复一次 |
LED 闪烁模式
| 模式 | 描述 |
|---|---|
| 模式 1 | 亮 0.5 秒 / 熄 2 秒 |
| 模式 2 | 亮 0.5 秒 / 熄 0.5 秒 |
| 模式 3 | 亮 0.1 秒 / 熄 0.1 秒 |
| 模式 4 | (1–6 次 0.2 秒亮/灭闪烁)+ 熄 2 秒 |
| 模式 5 | 蓝灯亮 0.2 秒 / 红灯亮 0.2 秒 |
规格参数
⚠️ 错误渲染宏 'excerpt-include':用户无权查看页面 'DEV:Technical Specifications'。
基本接线图

图例
| 端子 | 功能 | 接线 | 用途 |
|---|---|---|---|
| N | 中性端子 | N | 中性线 |
| L | 火线端子(110–240 V AC) | L1(A) | 负载回路火线 |
| SW | 开关/按钮输入(控制 O) | L2(B) | 设备供电火线 |
| SW2 | 开关/按钮输入端子 | — | — |
| I | 负载回路输入端子 | — | — |
| O | 负载回路输出端子 | — | — |
关于 Z-Wave®
将设备添加至 Z-Wave® 网络(包含)
✅ 注意:成功添加或移除后,所有输出端口(O、O1 等)将闪烁 1 秒亮 / 1 秒灭。
🔐 重要提示(S2 安全):使用 S2 包含时,请输入设备或包装上的 DSK 标签上的 5 位数字 PIN 码。请妥善保管,切勿丢失。
SmartStart 包含方式
- 使用支持 SmartStart 的网关扫描设备上的二维码。
- 将设备接入电源。
- 确认蓝灯以模式 1 闪烁 → 表示设备尚未加入。
- 几秒内自动开始包含。
- 包含过程中蓝灯以模式 2 闪烁。
- 成功则绿灯以模式 1 闪烁。
通过 S 按钮包含
- 为设备通电。
- 确认蓝灯以模式 1 闪烁。
- 在网关上启用添加/移除模式。
- 按住 S 按钮,直到 LED 变为稳定蓝色。
- 松开,再次按住(>2 秒),直到蓝灯以模式 3 闪烁 → 进入学习模式。
- 包含过程中蓝灯以模式 2 闪烁。
- 成功则绿灯以模式 1 闪烁。
⏱️ 设置模式超时时间:10 秒后自动返回正常模式。
通过开关/按钮包含
- 为设备通电。
- 确认蓝灯以模式 1 闪烁。
- 在网关上启用添加/移除模式。
- 在任意 SW 端子上快速拨动开关/按钮 3 次,间隔不超过 3 秒(需接收 3 次开/关信号)。
- 包含过程中蓝灯以模式 2 闪烁。
- 成功则绿灯以模式 1 闪烁。
📌 学习模式:允许设备从网关接收网络信息的状态。
从 Z-Wave® 网络中移除设备(排除)
❗ 注意:自定义设置将被保留;仅网络成员身份被移除。
通过 S 按钮排除
- 为设备通电。
- 确认绿灯以模式 1 闪烁 → 表示设备已包含。
- 在网关上启用添加/移除模式。
- 按住 S 按钮,直到 LED 变为稳定蓝色。
- 松开,再次按住(>2 秒),直到蓝灯以模式 3 闪烁 → 进入学习模式。
- 排除过程中蓝灯以模式 2 闪烁。
- 成功则蓝灯以模式 1 闪烁。
⏱️ 超时时间:设置模式下 10 秒。
通过开关/按钮排除
- 为设备通电。
- 确认绿灯以模式 1 闪烁。
- 在网关上启用添加/移除模式。
- 在任意 SW 端子上快速拨动开关/按钮 3 次,间隔不超过 3 秒。
- 排除过程中蓝灯以模式 2 闪烁。
- 成功则蓝灯以模式 1 闪烁。
恢复出厂设置
一般说明
恢复出厂设置后:
- 所有自定义参数、关联关系、路由信息、电能数据将重置为默认值
- HOME ID 与 NODE ID 将被删除
- 仅在网关不可用时使用
通过 S 按钮恢复
- 按住 S 按钮,直到 LED 变为稳定蓝色。
- 快速反复按下 S 按钮,直到 LED 变为稳定红色。
- 持续按住 S 按钮(>2 秒),直到红灯开始以模式 3 闪烁 → 开始恢复。
- 恢复过程中:绿灯亮约 1 秒,随后蓝红交替闪烁(模式 3),持续约 2 秒。
- 蓝灯以模式 1 闪烁 → 表示成功。
通过开关/按钮恢复
⚠️ 仅限通电后第一分钟内有效。
- 为设备通电。
- 在任意 SW 端子上快速拨动开关/按钮 5 次,间隔不超过 3 秒。
- 恢复过程中:绿灯亮约 1 秒,随后蓝红交替闪烁(模式 3),持续约 2 秒。
- 蓝灯以模式 1 闪烁 → 表示成功。
通过参数远程恢复
将 参数编号 120 = 1 设置,即可触发远程恢复出厂设置。
Z-Wave® 安全与设备特定密钥(DSK)
- 支持 安全 2(S2),采用 AES-128 加密 —— 当前最安全的物联网平台。
- S2 支持:
- 未加密
- S2 未认证
- S2 已认证
- 需要支持 S2 的网关才能实现完整安全。
DSK 标签与二维码
- 唯一的 12 位 DSK 印在侧面标签及包装上。
- 前五位数字高亮/下划线标记 = PIN 码。
- 包含二维码,可用于扫描。
🔒 带外(OOB)认证:网关扫描二维码以匹配通过无线射频收到的混淆公钥。
Z-Wave® 参数
| 参数编号 | 描述 | 大小 | 默认值 | 可选值 |
|---|---|---|---|---|
| 1 – SW (SW1) 开关类型 | 定义如何解释 SW1 | 1 字节 | 2 | 0=瞬时,1=切换(闭合=开),2=切换(状态改变) |
| 2 – SW2 开关类型 | 定义如何解释 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=常开,1=常闭 |
| 25 – 计时器单位(秒/毫秒) | 设置参数 19 和 20 的分辨率 | 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 – 序列号部分 | 只读序列号段 | 每个 4 字节 | 设备特定 | 0x00000000 – 0x7FFFFFFF |
💡 参数 201–203 为高级设置,可能隐藏在“高级”选项卡下。
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
[S2]* = 支持安全 2
Z-Wave® 通知命令类
检测到过热
| 字段 | 值 |
|---|---|
| 通知类型名称 | 热报警 |
| 类型(值) | 0x04 |
| 事件 | 状态 |
| 通知名称 | 检测到过热 |
| 名称(值) | 0x02 |
| 版本 | V2 |
| LED 指示 | 参见闪烁表(模式 4) |
| 设备反应 | 切断输出,发送通知 |
| 恢复操作 | 断电重启、按 S 按钮、按开关 |
Z-Wave® 关联关系
| 组 | 用途 | 最大节点数 | 触发条件 | 支持的命令类 |
|---|---|---|---|---|
| 组 1(生命线) | 状态报告,仅网关可用 | 1 | 始终 | INDICATOR_REPORT, DEVICE_RESET_LOCALLY_NOTIFICATION, SWITCH_BINARY_REPORT, NOTIFICATION_REPORT |
| 组 2 | SW1 控制(基本) | 9 | SW1 状态变化 | BASIC_SET |
| 组 3 | SW1 控制(多级) | 9 | SW1 状态变化 | SWITCH_MULTILEVEL_START_LEVEL_CHANGE, STOP_LEVEL_CHANGE |
| 组 4 | SW2 控制(基本) | 9 | SW2 状态变化 | BASIC_SET |
| 组 5 | SW2 控制(多级) | 9 | SW2 状态变化 | SWITCH_MULTILEVEL_START_LEVEL_CHANGE, STOP_LEVEL_CHANGE |
⚠️ 建议每组不超过 5 个设备,以避免延迟。
Z-Wave® 重要免责声明
Z-Wave® 通信并非 100% 可靠。请勿仅依赖此设备用于生命攸关的应用。若设备未被识别或行为异常,请手动验证设备类型,并确保网关支持 Z-Wave Plus™ 多级设备。
故障排除
如需帮助,请访问:Shelly 支持门户
兼容性
| 网关 | 通/断 | SW 通/断 | 备注 |
|---|---|---|---|
| Home Assistant | ✅ | ✅ | |
| Fibaro HC3 / Z-Wave Engine 3 | ✅ | ✅ | |
| Homey | ✅ | ✅ | |
| Homee Cube Gen 7 | ✅ | ✅ | |
| Homee Cube Gen 5 | ✅ | ⚪ | 输出更新但界面不反映 |
| SmartThings | ✅ | ✅ | 需 Shelly Wave Edge Driver |
| Jeedom | TBD | TBD | |
| Hubitat | TBD | TBD |
⚪ = 部分工作
TBD = 待完成
图例
| 符号 | 含义 |
|---|---|
| ✅ | 正常工作 / 可实现 |
| ⚪ | 部分工作 |
| ❌ | 无法工作 / 不可行 |
| TBD | 待完成 |
功能含义
| 功能 | 含义 |
|---|---|
| 通/断 | 响应应用界面的通/断命令 |
| SW 通/断 | 通过 SW 输入报告状态变化 |
| 瓦特 | 无需请求即报告瓦特值 |
| 千瓦时 | 无需请求即报告千瓦时值 |
| 上/下 | 响应应用界面的上/下命令 |
| SW 上/下 | 通过 SW 报告上/下变化 |
| 百叶窗角度 | 响应应用界面的百叶窗角度命令 |
| SW 百叶窗角度 | 通过 SW 报告百叶窗角度变化 |
网关指南
实用指南:Shelly 知识库 – Z-Wave