Shelly Wave i4 DC
注意：原先称为“Shelly Qubino Wave”的产品系列，现将更名为“Shelly Wave”。此次更名不会影响任何设备的功能。唯一的变化是在所有未来文档中使用新名称。
设备：Wave i4 DC
- 澳大利亚零件号 / 订购代码：QNSN-0D24XAU
- Z-Wave 产品类型 ID：0x0009
- Z-Wave 产品 ID：0x0082
- Z-Wave 制造商：Shelly Europe Ltd.
- Z-Wave 制造商 ID：0x0460
术语解释
- 设备 – 在本文档中，“设备”一词指代本指南所讨论的 Shelly Qubino 设备。
- 网关 – 也称为 Z-Wave® 控制器、主控制器、主要控制器或中枢等，是一种作为 Z-Wave® 智能家居网络中心枢纽的设备。本文档中使用“网关”一词。
- S 按钮 – 位于 Z-Wave® 设备上的服务按钮，用于执行各种功能，如添加（包含）、移除（排除）以及将设备恢复到出厂默认设置。本文档中使用“S 按钮”一词。
- 添加/包含 – 将一个 Z-Wave 设备添加到 Z-Wave 网络（网关）的过程。文中使用“包含”、“添加”等词语。
- 移除/排除 – 将一个 Z-Wave 设备从 Z-Wave 网络（网关）中移除的过程。文中使用“排除”、“移除”等词语。
- 百叶窗 – 泛指各类窗帘装置，如百叶帘、卷帘（屏幕）、卷闸、垂直窗帘、窗帘、集成式百叶帘、褶皱帘、遮阳篷等。此外，Wave Shutter 还可控制窗户电机、投影幕布或任何双向交流电机。
简要描述
该设备是一款 4 路数字输入模块（5–24 V DC），用于在 Z-Wave 网络内控制其他设备。它支持通过开关/按钮进行手动触发或关闭场景。
连接到输入端子 SW1 的开关/按钮
该设备支持中央场景命令类（Central Scene Command Class）。当按钮被单击、双击、长按并释放时，会发送带有场景编号（1、2、3 或 4）的场景通知。
注意：不支持通过开关类型触发中央场景通知。
连接到输入端子 SW1 的按钮
如果 SW1 配置为按钮：
- 场景编号 =
0x01
操作说明：
- 短按：发送中央场景通知“按键按下 1 次=0x00”，场景编号为
0x01；向关联组 4 中的关联设备发送命令（参见 Z-Wave 关联）。 - 双击：发送中央场景通知“按键按下 2 次=0x00”。
- 长按：发送中央场景通知“按键按下 = 0x02”；向关联组 5 中的关联设备发送命令（参见 Z-Wave 关联）。
- 松开：发送中央场景通知“按键释放 = 0x01”；向关联组 5 中的关联设备发送命令（参见 Z-Wave 关联）。
如果 SW1 配置为开关：
- 切换一次开关位置：向关联组 4 和 5 中的关联设备发送命令（参见 Z-Wave 关联）。
如果 SW1 配置为带记忆的开关：
- 切换至闭合触点：根据开关状态向关联组 4 和 5 中的关联设备发送命令。
- 切换至断开触点：根据开关状态向关联组 4 和 5 中的关联设备发送命令。
连接到输入端子 SW2 的开关/按钮
如果 SW2 配置为按钮：
- 场景编号 =
0x02
操作说明：
- 短按：发送中央场景通知“按键按下 1 次=0x00”，场景编号为
0x02；向关联组 6 中的关联设备发送命令（参见 Z-Wave 关联）。 - 双击：发送中央场景通知“按键按下 2 次=0x00”。
- 长按：发送中央场景通知“按键按下 = 0x02”；向关联组 7 中的关联设备发送命令（参见 Z-Wave 关联）。
- 松开：发送中央场景通知“按键释放 = 0x01”；向关联组 7 中的关联设备发送命令（参见 Z-Wave 关联）。
如果 SW2 配置为开关：
- 切换一次开关位置：向关联组 6 和 7 中的关联设备发送命令（参见 Z-Wave 关联）。
如果 SW2 配置为带记忆的开关：
- 切换至闭合触点：根据开关状态向关联组 6 和 7 中的关联设备发送命令。
- 切换至断开触点：根据开关状态向关联组 6 和 7 中的关联设备发送命令。
连接到输入端子 SW3 的开关/按钮
如果 SW3 配置为按钮：
- 场景编号 =
0x03
操作说明：
- 短按：发送中央场景通知“按键按下 1 次=0x00”，场景编号为
0x03；向关联组 8 中的关联设备发送命令（参见 Z-Wave 关联）。 - 双击：发送中央场景通知“按键按下 2 次=0x00”。
- 长按：发送中央场景通知“按键按下 = 0x02”；向关联组 9 中的关联设备发送命令（参见 Z-Wave 关联）。
- 松开：发送中央场景通知“按键释放 = 0x01”；向关联组 9 中的关联设备发送命令（参见 Z-Wave 关联）。
如果 SW3 配置为开关：
- 切换一次开关位置：向关联组 8 和 9 中的关联设备发送命令（参见 Z-Wave 关联）。
如果 SW3 配置为带记忆的开关：
- 切换至闭合触点：根据开关状态向关联组 8 和 9 中的关联设备发送命令。
- 切换至断开触点：根据开关状态向关联组 8 和 9 中的关联设备发送命令。
连接到输入端子 SW4 的开关/按钮
如果 SW4 配置为按钮：
- 场景编号 =
0x04
操作说明：
- 短按：发送中央场景通知“按键按下 1 次=0x00”，场景编号为
0x04；向关联组 10 中的关联设备发送命令（参见 Z-Wave 关联）。 - 双击：发送中央场景通知“按键按下 2 次=0x00”。
- 长按：发送中央场景通知“按键按下 = 0x02”；向关联组 11 中的关联设备发送命令（参见 Z-Wave 关联）。
- 松开：发送中央场景通知“按键释放 = 0x01”；向关联组 11 中的关联设备发送命令（参见 Z-Wave 关联）。
如果 SW4 配置为开关：
- 切换一次开关位置：向关联组 10 和 11 中的关联设备发送命令（参见 Z-Wave 关联）。
如果 SW4 配置为带记忆的开关：
- 切换至闭合触点：根据开关状态向关联组 10 和 11 中的关联设备发送命令。
- 切换至断开触点：根据开关状态向关联组 10 和 11 中的关联设备发送命令。
主要应用场景
- 住宅
- 多户住宅（公寓、联排别墅、酒店等）
- 轻型商业（小型办公楼、小型零售店/餐厅/加油站等）
- 政府/市政
- 大学/学院
兼容性集成
Shelly Qubino Wave 设备基于全球领先的智能家居技术——Z-Wave。
这意味着 Shelly Qubino Wave 可与所有经过认证且支持 Z-Wave 通信协议的网关兼容。
为确保您的网关完全支持各项功能，我们定期测试与不同 Z-Wave 网关的兼容性。请参考 网关兼容性 部分了解详细兼容状态。
简化内部原理图
无
设备电气接口
输入
- 1 个开关/按钮输入端子（螺丝端子）
- 2 个开关/按钮输入端子（螺丝端子）
- 3 个开关/按钮输入端子（螺丝端子）
- 4 个开关/按钮输入端子（螺丝端子）
- 3 个电源输入端子（螺丝端子）：N、L
输出
无
连接方式
Z-Wave – 不安全、S0 安全、S2 未认证安全、S2 已认证安全
安全特性
过热保护
- 自动关闭自身继电器
- 向网关发送“检测到过热”通知报告
- LED 按指定模式反应（查看过热检测的闪烁模式）
以下任一操作可复位此报警：
- 重启供电
- 快速按一次 S 按钮
- 按任意连接到 SW（SW1、SW2…）端子的开关/按钮
注意：过热保护始终启用，无法禁用。
更多详情请见 过热检测通知
支持的负载类型
无
用户界面
S 按钮和工作模式
- 正常模式
- 设置进行中模式
- 设置模式（需按 S 按钮）
- 用于启动包含、排除、出厂重置等操作。
- 有时间限制；完成后自动返回正常模式。
- 进入设置模式：快速按下并持续按住 S 按钮，直到 LED 变为稳定的蓝色。
- 再次快速按下可切换菜单（无限循环）。
- 菜单超时时间：10 秒后返回正常状态。
S 按钮功能
- 手动将设备添加到 Z-Wave 网络
- 手动将设备从 Z-Wave 网络中移除
- 对设备执行出厂重置
LED 指示信号
点击查看 LED 指示信号
正常模式
已移除/排除：上电或按下 S 按钮后，LED 在模式 1 下以蓝色闪烁 10 分钟。
已添加/包含：上电或按下 S 按钮后，LED 在模式 1 下以绿色闪烁 10 分钟。
设置进行中
- 出厂重置并重启：
- LED 先变为稳定绿色（约 1 秒），然后蓝红快速闪烁（0.1秒开 / 0.1秒关）约 2 秒。
- 添加/移除：LED 在模式 2 下以蓝色闪烁。
- OTA 固件更新：LED 在模式 2 下以蓝红闪烁。
- 检查电源（230V AC / 24V DC）：LED 在模式 5 下以蓝红闪烁。
带 S 按钮的设置模式
- 菜单选择（添加/移除）：LED 保持稳定蓝色（最多 10 秒）。
- 添加/移除过程中：LED 在模式 3 下以蓝色闪烁。
- 菜单选择（出厂重置）：LED 保持稳定红色（最多 10 秒）。
- 出厂重置过程中：LED 在模式 3 下以红色闪烁。
报警模式
- 检测到过热：LED 在模式 4 下以红色闪烁：2 次（0.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'：用户 '712020:515aa595-e304-41f3-886a-d9b6b0b7f5a3' 无权查看页面 'DEV:Technical Specifications'。
基本接线图
错误渲染宏 'excerpt-include'：用户 '712020:515aa595-e304-41f3-886a-d9b6b0b7f5a3' 无权查看页面 'DEV:Wiring diagrams'。
图例
| 端子 | 描述 | 导线 | 描述 |
|---|---|---|---|
ꓕ | 5–24 V DC 接地端子 | GND | 5–24 V DC 接地线 |
+ | 5–24 V DC 正极端子 | + | 5–24 V DC 正极线 |
SW 1 | 开关/按钮输入端子 | — | — |
SW 2 | 开关/按钮输入端子 | — | — |
SW 3 | 开关/按钮输入端子 | — | — |
SW 4 | 开关/按钮输入端子 | — | — |
关于 Z-Wave
将设备添加到 Z-Wave® 网络（包含）
注意！ 如果设备成功添加或移除，连接到设备的百叶窗将上下移动 2 秒。
注意！ 使用安全 2（S2）包含时，会弹出对话框要求输入设备和包装上标签上的 5 位数字 PIN 码。
重要提示：请勿丢失此 PIN 码。
SmartStart 包含
支持 SmartStart 的产品可通过网关扫描设备上的 Z-Wave 二维码完成添加。无需额外操作。
- 使用网关应用扫描二维码，并将 DSK 添加到配置列表。
- 将设备接入电源。
- 检查蓝色 LED 是否缓慢闪烁 → 表示设备尚未添加。
- 上电后数秒内自动开始添加。
- 添加过程中 LED 闪烁加快。
- 成功添加后，绿色 LED 缓慢闪烁。
使用 S 按钮添加
- 将设备接入电源。
- 确认蓝色 LED 缓慢闪烁。
- 在网关上启用添加/移除模式。
- 按住 S 按钮直至 LED 变为稳定蓝色。
- 快速释放，然后按住超过 2 秒，直到 LED 缓慢闪烁 → 释放即进入学习模式。
- 添加过程中 LED 闪烁加快。
- 成功添加：绿色 LED 缓慢闪烁。
注意：设置模式 10 秒后自动返回正常模式。
使用开关/按钮添加
- 将设备接入电源。
- 确认蓝色 LED 缓慢闪烁。
- 在网关上启用添加/移除模式。
- 在 3 秒内快速切换任意一个 SW 端子（SW1–SW4）的开关/按钮共 3 次 → 设备进入学习模式。
- 添加过程中 LED 闪烁加快。
- 成功添加：绿色 LED 缓慢闪烁。
学习模式：允许设备从网关接收网络信息的状态。
从 Z-Wave® 网络中移除设备（排除）
注意：设备将被移除，但自定义配置保持不变。
注意：移除时百叶窗将上下移动 2 秒。
使用 S 按钮移除
- 将设备接入电源。
- 确认绿色 LED 缓慢闪烁 → 表示设备已添加。
- 在网关上启用添加/移除模式。
- 按住 S 按钮直至 LED 变为稳定蓝色。
- 释放，然后按住超过 2 秒，直到 LED 缓慢闪烁 → 释放即进入学习模式。
- 移除过程中 LED 闪烁加快。
- 成功移除：蓝色 LED 缓慢闪烁。
注意：设置模式 10 秒后自动返回。
使用开关/按钮移除
- 将设备接入电源。
- 确认绿色 LED 缓慢闪烁。
- 在网关上启用添加/移除模式。
- 在 3 秒内快速切换任意一个 SW 端子的开关/按钮共 3 次 → 进入学习模式。
- 移除过程中 LED 闪烁加快。
- 成功移除：蓝色 LED 缓慢闪烁。
出厂重置
通用说明
重置后，所有自定义参数（如用电量、关联、路由等）将恢复为默认值。家庭 ID 和节点 ID 将被删除。仅在网关缺失或失效时使用。
使用 S 按钮
注意：可随时执行。
- 按住 S 按钮直至 LED 变为稳定蓝色。
- 多次按下 S 按钮，直至 LED 变为稳定红色。
- 持续按住超过 2 秒，直到红色 LED 闪烁加快 → 释放开始重置。
- 重置过程中：LED 先变为稳定绿色（约 1 秒），然后蓝红快速闪烁（约 2 秒）。
- 成功重置：蓝色 LED 缓慢闪烁。
使用开关/按钮
注意：仅在通电后第一分钟内有效。
- 将设备接入电源。
- 在 3 秒内快速切换任意一个 SW 端子的开关/按钮共 5 次。
- 重置过程中：LED 先变为稳定绿色（约 1 秒），然后蓝红快速闪烁（约 2 秒）。
- 成功重置：蓝色 LED 缓慢闪烁。
Z-Wave 安全与设备特定密钥（DSK）
该设备支持 安全 2（S2），采用强 AES-128 加密，使 Z-Wave 成为最安全的物联网平台。
- 已认证控制：
- 包含时使用外部通道（OOB）DSK
- 与大多数实现兼容
支持 S2 已认证、未认证及不安全包含。
注意：使用 S2 支持的网关时，必须输入设备或包装标签上的 5 位数字 PIN。请勿撕下标签，并保留一份备份。
- 前五位数字高亮/下划线 → 即为 PIN 码。
- DSK 也可通过二维码表示。
加入节点 在射频传输前将字节 1–2 设置为
0x00，以隐藏其公钥。
DSK 可用于外部通道（OOB）认证。
Z-Wave 参数
参数编号 1 – SW (SW1) 开关类型
- 定义设备如何处理 SW1 端子上的开关。
- 大小：1 字节
- 默认值：
0 - 取值：
0：瞬时开关（按钮）1：切换开关（闭合 = 开启，断开 = 关闭）2：切换开关（开关状态改变时设备状态随之变化）
参数编号 2 – SW2 开关类型
- 与上述相同，适用于 SW2。
- 默认值：
0
参数编号 3 – SW3 开关类型
- 与上述相同，适用于 SW3。
- 默认值：
0
参数编号 4 – SW4 开关类型
- 与上述相同，适用于 SW4。
- 默认值：
0
参数编号 105 – LED 亮度调节
- 控制 LED 亮度（调光）。
- 适用于 Wave 1、Wave 1PM、Wave 2PM、Plug US、Plug UK。
- 当前部分型号尚未实现（预计 2024 年）。
- 大小：1 字节
- 默认值：
100 - 取值：
0–100（0% 至 100%，每 1% 递增）
参数编号 120 – 出厂重置
- 将设备恢复为出厂默认值并从 Z-Wave 网络中移除。
- 高级参数（可能隐藏在“高级”选项中）。
- 大小：1 字节
- 默认值：
0 - 取值：
0：无操作1：出厂重置
重置后，该值将自动重置为
0。
参数编号 201 – 序列号 1
- 包含设备序列号的一部分。
- 只读，不可更改。
- 高级参数。
- 大小：4 字节
- 范围：
0x00000000–0x7FFFFFFF
参数编号 202 – 序列号 2
- 与上述相同。
- 范围：
0x00000000–0x7FFFFFFF
参数编号 203 – 序列号 3
- 与上述相同。
- 范围：
0x00000000–0x7FFFFFFF
Z-Wave 命令类
根设备
- ASSOCIATION_V2 [S0, S2]
- ASSOCIATION_GRP_INFO_V3 [S0, S2]
- BASIC_V2 [S0, S2]
- SWITCH_BINARY_V2 [S0, S2]
- CENTRAL_SCENE_V3 [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_V4 [S0, S2]
- MULTI_CHANNEL_ASSOCIATION_V3 [S0, S2]
- SWITCH_MULTILEVEL_V4 [S0, S2]
- NOTIFICATION_V8 [S0, S2]
- POWERLEVEL_V1 [S0, S2]
- SECURITY_V1
- SECURITY_2_V1
- SUPERVISION_V1
- VERSION_V3 [S0, S2]
- ZWAVEPLUS_INFO_V2
端点 2
- ASSOCIATION_V2 [S0, S2]
- ASSOCIATION_GRP_INFO_V3 [S0, S2]
- SWITCH_BINARY_V2 [S0, S2]
- MULTI_CHANNEL_ASSOCIATION_V3 [S0, S2]
- SECURITY_V1
- SECURITY_2_V1
- SUPERVISION_V1
- ZWAVEPLUS_INFO_V2
（端点 3–5 遵循相同模式。）
Z-Wave 通知命令类
检测到过热
| 说明 | 检测到过热 |
|---|---|
| Z-Wave 通知类型名称 | 热警报 |
| Z-Wave 通知类型 – 值 | 0x04 |
| Z-Wave 通知类型 – 事件 | 状态 |
| Z-Wave 通知名称 | 检测到过热 |
| Z-Wave 通知名称 – 值 | 0x02 |
| Z-Wave 通知名称 – 版本 | V2 |
| Z-Wave 设备专属 | 是 |
| LED 信号 | 参见 LED 表 |
| 设备反应 | 关闭输出并发送通知 |
| 恢复操作 | 重启供电、短按 S 按钮或按任意开关 |
Z-Wave 关联
关联可实现设备间直接通信，无需网关参与。
- 每组最多 9 个设备（建议每组 ≤5 个）。
- “生命线组”专供网关使用（仅 1 个节点）。
根设备 – 关联组 1（生命线）
- 报告设备状态。
- 支持：
- INDICATOR_REPORT（LED 状态）
- DEVICE_RESET_LOCALLY_NOTIFICATION
- SWITCH_BINARY_REPORT（SW1–SW4）
关联组 4
- 分配给 SW1（基本命令类）。
- 由 SW1 触发。
- 向关联设备发送
BASIC_SET ON/OFF。
关联组 5
- 分配给 SW1（多级开关命令类）。
- 推荐用于按钮。
- 发送：
SWITCH_MULTILEVEL_START_LEVEL_CHANGESWITCH_MULTILEVEL_STOP_LEVEL_CHANGE
关联组 6–11
- 遵循相同模式：SW2（组 6–7）、SW3（组 8–9）、SW4（组 10–11）。
端点 2–5
每个端点均包含：
- 生命线（组 1）
- 基本（组 2）
- 多级开关（组 3）
Z-Wave 重要免责声明
Z-Wave 无线通信可能无法 100% 可靠。切勿在生命关键或高价值场景中仅依赖此设备。若设备未被识别或行为异常，请手动调整设备类型，并确认网关支持 Z-Wave Plus™ 多级设备。
故障排查
如需帮助，请访问：支持门户
网关兼容性
| 网关 | 开/关 1 | 开/关 2 | 开/关 3 | 开/关 4 | 备注 |
|---|---|---|---|---|---|
| Home Assistant | ✅ | ✅ | ✅ | ✅ | |
| Fibaro HC3 / Z-Wave Engine 3 | ✅ | ✅ | ✅ | ✅ | |
| Homey | ✅ | ✅ | ✅ | ✅ | 解决方案 |
| Homee Cube Gen 7 | ✅ | ✅ | ✅ | ✅ | |
| Homee Cube Gen 5 | ⚠️ | ⚠️ | ⚠️ | ⚠️ | 无法使用中央场景或关联 |
| Smart Things | ✅ | ✅ | ✅ | ✅ | Shelly Wave edge driver |
| Jeedom | 待定 | 待定 | 待定 | 待定 | |
| Hubitat | 待定 | 待定 | 待定 | 待定 |
图例：
- ✅ 正常/可行
- ⚠️ 部分支持
- ❌ 无效/不可行
- N/T：未测试
- TBD：待定
功能含义
| 功能 | 含义 |
|---|---|
| 开/关 | 测试设备是否响应应用界面的开/关命令 |
| SW 开/关 | 测试设备是否通过 SW 输入报告开/关状态变化 |
| 瓦特 | 测试瓦特是否主动上报 |
| 千瓦时 | 测试千瓦时是否主动上报 |
| 上/下 | 测试设备是否响应应用界面的上/下命令 |
| SW 上/下 | 测试设备是否通过 SW 输入报告上/下状态变化 |
| 板条 | 测试板条是否响应应用界面命令 |
| SW 板条 | 测试板条是否通过 SW 输入报告变化 |
网关指南
更多实用指南可在 Shelly 知识库 中获取。