Shelly Wave Pro 1PM
注意：原先称为“Shelly Qubino Wave”的产品系列，现将更名为“Shelly Wave”。此次更名不会影响任何设备的功能。唯一的变化是在所有未来的文档中使用新名称。
设备识别
- 设备型号：Wave Pro 1PM
- 美国零件号 / 订购代码：QPSW-0A1P16US
- Z-Wave 产品类型 ID：0x0002
- Z-Wave 产品 ID：0x008B
- Z-Wave 制造商：Shelly Europe Ltd.
- Z-Wave 制造商 ID：0x0460
术语说明
- 设备 – 在本文档中，“设备”指本指南所描述的 Shelly Qubino 产品。
- 网关 – 一个 Z-Wave® 网关，也称为 Z-Wave® 控制器、主控制器、主要控制器或 Z-Wave® 中心等，是用于构建 Z-Wave® 智能家居网络的中央枢纽设备。本文档中统一使用“网关”一词。
- S 按钮 – 位于 Z-Wave® 设备上的服务按钮，用于执行添加（包含）、移除（排除）及恢复出厂设置等操作。本文档中使用“S 按钮”这一术语。
简要说明
该设备是一款可安装于导轨的智能开关，并具备电量测量功能。它能够控制单个额定负载最高达 16 A 的电器设备的通断状态。支持与普通开关（默认）和按钮的连接。
连接到输入端子 SW（SW1）的开关
如果将 SW（SW1）配置为开关（默认）：
- 单次切换开关位置：将输出端口 O（O1）的状态切换至相反状态，并向组 2 和组 3 中关联的设备发送命令（参见 Z-Wave 关联）。
- 快速连续两次切换开关位置：若第一次与第二次点击之间的时间间隔小于 500 毫秒，则被解释为“双击”。向组 2 和组 3 中的关联设备（调光器、百叶窗等）发送命令。
连接到输入端子 SW（SW1）的开关记忆型（Switch-Memory）
如果将 SW（SW1）配置为开关记忆型：
- 闭合开关记忆触点时：将输出状态 O（O1）设为开启，并向组 2 和组 3 中的关联设备发送命令。
- 断开开关记忆触点时：将输出状态 O（O1）设为关闭，并向组 2 和组 3 中的关联设备发送命令。
连接到输入端子 SW（SW1）的按钮
如果将 SW（SW1）配置为按钮：
- 短按：将输出端口 O（O1）的状态切换为相反状态，并向组 2 和组 3 中的关联设备发送命令。
- 长按：向组 3 中的设备发送命令。
- 松开：向组 3 中的设备发送命令。
控制连接在 O（O1）上的负载的通断
通过以下方式可对连接在 O（O1）上的负载进行通断控制：
- 使用 Z-Wave 命令
- 启用参数 19 和 20 设置的自动切换功能
- 按下开关/按钮 SW（SW1）：改变连接负载的状态为相反状态
主要应用场景
- 住宅
- 多住户单元（公寓、联排别墅、酒店等）
- 轻型商业场所（小型办公楼、小零售店/餐厅/加油站等）
- 政府/市政机构
- 大学/学院
兼容性集成
Shelly Qubino Wave 设备基于全球领先的智能家居技术——Z-Wave开发。
这意味着 Shelly Qubino Wave 可与所有经过认证且支持 Z-Wave 通信协议的网关兼容。
为确保完整功能，我们定期测试与不同 Z-Wave 网关的兼容性。
简化内部电路图
设备电气接口
输入端口
- 2 个螺丝端子上的开关/按钮输入
- 2 个螺丝端子上的电源输入：2 个接线端子分别为 2 N (+) 与 3 L (−)
- 1 个继电器输入端子（螺丝端子）
输出端口
- 1 个带电量测量功能的继电器输出端子（螺丝端子）
连接方式
Z-Wave —— 不安全、S0 安全、S2 未认证安全、S2 已认证安全
安全特性
过热保护
- 当温度超过 80°C 并持续超过 5 秒时，设备将：
- 自动切断自身继电器
- 向网关发送“过热检测到”通知报告
- LED 按规定方式响应（请参考过热检测时的 LED 闪烁模式）
- 重置触发条件：重新上电、短按 S 按钮，或按下任意连接至 SW（SW、SW1、SW2…）的开关/按钮
- 注意：过热保护始终启用，无法禁用。
详细信息：过热检测通知
过流保护
- 当电流超过 16 A + 10%（最大开关电流 +10%）并持续超过 5 秒时，设备将：
- 切断自身继电器
- 向网关发送“过流检测到”通知报告
- LED 按规定方式响应（请参考过流检测时的 LED 闪烁模式）
- 重置触发条件：重新上电、短按 S 按钮，或按下任意连接至 SW（SW、SW1、SW2…）的开关/按钮
- 注意：过流保护始终启用，无法禁用。
详细信息：过流检测通知
过压保护
- 适用于标准 230 V AC 供电。当电压超过 240 V AC +15%（即 278 V AC）并持续超过 5 秒时，设备将：
- 切断自身继电器
- 向网关发送“过压检测到”通知报告
- LED 按规定方式响应（请参考过压检测时的 LED 闪烁模式）
- 重置触发条件：重新上电、短按 S 按钮，或按下任意连接至 SW（SW、SW1、SW2…）的开关/按钮
- 注意：过压保护始终启用，无法禁用。
详细信息：过压检测通知
支持的负载类型
- 阻性负载（白炽灯泡、加热设备）
- 容性负载（电容器组、电子设备、电机启动电容）
- 带 RC 保护器的感性负载（LED 灯驱动器、变压器、风扇、冰箱、空调）
用户界面
S 按钮与工作模式
- 正常模式
- 设置进行中模式
- 设置模式（使用 S 按钮）
- 用于启动包含、排除或恢复出厂设置等操作。具有有限的操作时间。完成后自动返回正常模式。
- 进入设置模式：
- 快速按下并长按 S 按钮，直到 LED 变为常亮蓝色
- 再次快速按下可切换菜单（无限循环）
- 菜单状态下的 LED 有 10 秒超时，之后自动返回正常状态
S 按钮功能
- 手动将设备添加至 Z-Wave 网络
- 手动从 Z-Wave 网络中移除设备
- 恢复设备出厂设置
LED 指示信号
正常模式
已移除/排除：断电或按下 S 按钮后，LED 在模式 1 下以蓝色闪烁 10 分钟
已添加/包含：断电或按下 S 按钮后，LED 在模式 1 下以绿色闪烁 10 分钟
设置进行中
- 恢复出厂设置并重启：LED 先变为常亮绿色（约 1 秒），然后蓝红交替闪烁 0.1 秒开/关（约 2 秒）
- 添加/移除：在模式 2 下，LED 以蓝色闪烁
- OTA 固件更新：在模式 2 下，LED 以蓝红交替闪烁
- 检查电源供应（230V AC 频率或 24V DC 电压）：在模式 5 下，LED 以蓝红交替闪烁
使用 S 按钮的设置模式
- 选择添加/移除菜单：LED 在最多 10 秒内保持常亮蓝色
- 正在执行添加/移除过程：在模式 3 下，LED 以蓝色闪烁
- 选择恢复出厂设置菜单：LED 在最多 10 秒内保持常亮红色
- 正在执行恢复出厂设置过程：在模式 3 下，LED 以红色闪烁
报警模式
- 检测到过流：在模式 4 下，LED 以红色闪烁（1 次：0.2 秒开/0.2 秒关，2 秒关）
- 检测到过热：在模式 4 下，LED 以红色闪烁（2 次：0.2 秒开/0.2 秒关，重复）
- 电源故障：在模式 4 下，LED 以红色闪烁（3 次：0.2 秒开/0.2 秒关，重复）
- 检测到过压：在模式 4 下，LED 以红色闪烁（7 次：0.2 秒开/0.2 秒关，重复）
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'：用户 '712020:515aa595-e304-41f3-886a-d9b6b0b7f5a3' 无权查看页面 'DEV:Technical Specifications'。
基本接线图
图例
| 接线端子 | 描述 | 线缆 | 描述 |
|---|---|---|---|
| N | 零线端子 | N | 零线 |
| L | 火线端子（110–240 V AC） | L | 火线（110–240 VAC） |
| SW 1 | 开关/按钮输入端子（控制输出 O） | ||
| SW 2 | 开关/按钮输入端子 | ||
| I | 负载电路输入端子 | ||
| O | 负载电路输出端子 |
关于 Z-Wave®
将设备添加至 Z-Wave® 网络（包含）
注意！ 成功添加或移除设备后，所有输出端口（O、O1、O2 等）会短暂通断一次（1 秒通/1 秒断）。
注意！ 对于安全 2（S2）包含，需输入设备或包装上的 DSK 标签上的 5 位数字 PIN 码。请务必妥善保管此代码。
SmartStart 包含
- 使用支持 SmartStart 的网关扫描设备上的 Z-Wave 二维码。
- 给设备供电。
- 检查蓝色 LED 是否在模式 1 下闪烁（表示尚未添加）。
- 几秒内自动开始添加流程。
- 添加过程中，蓝色 LED 在模式 2 下闪烁。
- 成功添加后，绿色 LED 在模式 1 下闪烁。
使用 S 按钮添加
- 给设备供电。
- 确认蓝色 LED 在模式 1 下闪烁。
- 在网关上启用添加/移除模式。
- 按住 S 按钮，直至 LED 变为常亮蓝色。
- 松开，再次按住（>2 秒），直到蓝色 LED 在模式 3 下闪烁 → 释放即启动学习模式。
- 添加过程中，蓝色 LED 在模式 2 下闪烁。
- 若成功，绿色 LED 在模式 1 下闪烁。
注意：设置模式 10 秒后超时。
使用开关/按钮添加
- 给设备供电。
- 确认蓝色 LED 在模式 1 下闪烁。
- 在网关上启用添加/移除模式。
- 在 3 秒内快速切换任意一个 SW 端子的开关/按钮共 3 次 → 进入学习模式。
- 添加过程中，蓝色 LED 在模式 2 下闪烁。
- 若成功，绿色 LED 在模式 1 下闪烁。
学习模式：允许设备从网关接收网络信息的状态。
从 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 下闪烁。
使用开关/按钮
仅限上电后 1 分钟内有效
- 给设备供电。
- 在 3 秒内快速切换任意一个 SW 端子的开关/按钮共 5 次。
- 重置过程中：LED 先变常亮绿色（约 1 秒），随后蓝红交替闪烁（模式 3，约 2 秒）。
- 若成功，蓝色 LED 在模式 1 下闪烁。
通过参数远程触发
将参数编号 120 设置为 1431655765（十六进制 0x55555555）以触发远程恢复出厂设置。
Z-Wave® 安全与设备特定密钥（DSK）
该设备支持 安全 2（S2），采用强大的 AES-128 加密，使 Z-Wave 成为最安全的物联网平台之一。
- 认证控制：通过外部渠道的 DSK 进行包含
- 支持 S2 已认证、未认证和不安全包含
重要提示：使用支持 S2 的网关添加设备时，必须提供设备或包装上 DSK 标签中的 5 位数字 PIN 码。请保留标签完好。建议使用包装内的备份副本。
- 前五位数字高亮/加下划线
- DSK 以二维码形式呈现
加入节点在无线传输前会将字节 1–2 设置为零，以混淆公钥。
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 = 1 时为毫秒）
参数编号 20 – O（O1）定时自动开启
- 大小：2 字节
- 默认值：0
- 取值：
- 0：自动开启功能禁用
- 1–32535：时间（秒，或当参数 25 = 1 时为毫秒）
参数编号 23 – O（O1）触点类型 – 常开/常闭
- 大小：1 字节
- 默认值：0
- 取值：
- 0：常开（NO）
- 1：常闭（NC）
| 参数 | 命令 | 输出状态 |
|---|---|---|
| 常开（0） | 关闭 | 关闭（0 V） |
| 常开（0） | 开启 | 开启（230 V） |
| 常闭（1） | 关闭 | 开启（230 V） |
| 常闭（1） | 开启 | 关闭（0 V） |
参数编号 25 – 设置 O（O1）计时单位为秒或毫秒
- 大小：1 字节
- 默认值：0
- 取值：
- 0：秒
- 1：毫秒
参数编号 36 – 电量变化时报告（%）
- 大小：1 字节
- 默认值：50
- 取值：
- 0：报告功能禁用
- 1–100：最小百分比变化值以触发报告
注意：电量报告包含电压（V）和电流（A）。
注意：不能超过参数 39 设置的时间间隔。
参数编号 39 – 最小报告间隔（O1）
- 大小：1 字节
- 默认值：30
- 取值：
- 0：报告功能禁用
- 1–120：间隔（秒）
注意：与参数 36 相关。设置低于 30 秒可能导致网络拥塞。
参数编号 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 – 恢复出厂设置
- 大小：4 字节
- 默认值：0
- 取值：
- 0：不重置
- 1431655765（
0x55555555）：执行恢复出厂设置重置后，该值将自动重置为 0。
参数编号 201 – 序列号 1
- 只读，高级
- 大小：4 字节
- 范围：0x00000000 – 0x7FFFFFFF
参数编号 202 – 序列号 2
- 只读，高级
- 大小：4 字节
- 范围：0x00000000 – 0x7FFFFFFF
参数编号 203 – 序列号 3
- 只读，高级
- 大小：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]*
- METER_V6 [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] = 安全 2 命令类
Z-Wave® 通知命令类
检测到过热
| 说明 | 检测到过热 |
|---|---|
| 通知类型名称 | 热力报警 |
| 数值 | 0x04 |
| 事件 | 状态 |
| 通知名称 | 检测到过热 |
| 数值 | 0x02 |
| 版本 | V2 |
| 设备特定 | 是 |
| LED 指示 | 参见 LED 表格 |
| 设备反应 | 切断所有输出，发送通知 |
| 恢复操作 | 重新上电、按下 S 按钮、按下开关 |
检测到过流（O）
| 说明 | 检测到过流（O1） |
|---|---|
| 通知类型名称 | 电力管理 |
| 数值 | 0x08 |
| 事件 | 状态 |
| 通知名称 | 检测到过流 |
| 数值 | 0x06 |
| 版本 | V3 |
| 设备特定 | 是 |
| LED 指示 | 参见 LED 表格 |
| 设备反应 | 切断输出端口 O（O1），发送通知 |
| 恢复操作 | 重新上电、按下 S 按钮、按下开关 |
交流电源断开
| 说明 | 交流电源断开 |
|---|---|
| 通知类型名称 | 电力管理 |
| 数值 | 0x08 |
| 事件 | 状态 |
| 通知名称 | 交流电源断开 |
| 数值 | 0x02 |
| 版本 | V2 |
| 设备特定 | 是 |
| LED 指示 | 参见 LED 表格 |
| 设备反应 | 切断所有输出，发送通知 |
| 恢复操作 | 重新上电、按下 S 按钮、按下开关 |
Z-Wave® 关联关系
根设备
关联组 1 – 生命线组
- 允许节点数：1（默认为网关）
- 支持的命令类：
- INDICATOR_REPORT
- DEVICE_RESET_LOCALLY_NOTIFICATION
- SWITCH_BINARY_REPORT
- NOTIFICATION_REPORT（过热）
- NOTIFICATION_REPORT（过流）
- NOTIFICATION_REPORT（过压）
- NOTIFICATION_REPORT（交流电源断开）
- METER_REPORT（基于参数 36 与 39）
关联组 2
- 允许节点数：9
- 触发条件：SW（SW1）
- 命令：BASIC_SET ON/OFF
- 支持：BASIC_SET
关联组 3
- 允许节点数：9
- 触发条件：SW（SW1）
- 命令：SWITCH_MULTILEVEL_START_LEVEL_CHANGE / STOP
- 支持：SWITCH_MULTILEVEL_START_LEVEL_CHANGE, SWITCH_MULTILEVEL_STOP_LEVEL_CHANGE
关联组 4
- 允许节点数：9
- 触发条件：SW（SW1）
- 命令：BASIC_SET ON/OFF
- 支持：BASIC_SET
关联组 5
- 允许节点数：9
- 触发条件：SW（SW1）
- 命令：SWITCH_MULTILEVEL_START_LEVEL_CHANGE / STOP
- 支持：SWITCH_MULTILEVEL_START_LEVEL_CHANGE, SWITCH_MULTILEVEL_STOP_LEVEL_CHANGE
Z-Wave® 重要免责声明
Z-Wave® 无线通信并非始终 100% 可靠。本设备不应用于生命关键或高价值场景。若网关无法识别，请手动确认设备类型，并确保网关支持 Z-Wave Plus™ 多级设备。
故障排查
有关故障排查，请访问：支持门户
与网关的兼容性
| 网关 | 通断 | SW 通断 | W | kWh | 备注 |
|---|---|---|---|---|---|
| Home Assistant | ✅ | ✅ | ✅ | ✅ | |
| Fibaro HC 3 / Z-Wave 引擎 3 | ✅ | ✅ | ✅ | ✅ | |
| Homey | ✅ | ✅ | ✅ | ✅ | |
| Homee Cube Gen 7 | ✅ | ✅ | ✅ | ✅ | |
| Homee Cube Gen 5 | ✅ | P*1 | ⚪*2 | ⚪*2 | *1, *2 |
| Smart Things | ✅ | ✅ | ✅ | ✅ | 需使用 Shelly Wave 边缘驱动程序 |
| Vera Ezlo | ✅ | ✅ | ✅ | ✅ | |
| Cozify | ✅ | ✅ | ✅ | ✅ |
备注：
*1：输出状态改变，但界面无法反映更新
*2：瓦特和千瓦时不显示在界面上
功能图例
| 功能 | 含义 / 测试情况 |
|---|---|
| 通断 | 响应应用界面的通断命令 |
| SW 通断 | 通过 SW 输入报告通断变化 |
| 调光 | 响应应用界面的调光命令 |
| SW 调光 | 通过 SW 输入报告调光状态 |
| 瓦特 | 无需请求即上报瓦特数值 |
| 千瓦时 | 无需请求即上报千瓦时数值 |
| 上/下 | 响应应用界面的上/下命令 |
| SW 上/下 | 通过 SW 输入报告上/下变化 |
| 百叶窗角度 | 百叶窗响应应用界面命令 |
| SW 百叶窗角度 | 百叶窗通过 SW 报告变化 |
| D 控制 | 在独立模式下报告场景命令（单击/双击等） |
| D 二进制 | 在独立模式下通过 SW 输入报告二进制通断 |
| 传感器 # | 传感器在网关中可见；类型列于备注中 |
符号图例
| 符号 | 状态 |
|---|---|
| ✅ | 正常工作 / 可实现 |
| ⚪ | 无法工作 / 不可实现 |
| P | 部分支持 |
| N/T | 未测试 |
| TBD | 待完成 |
网关指南
更多实用指南可在 Shelly 知识库 中获取。