注意事项
产品系列“Shelly Qubino Wave”将更名为“Shelly Wave”。此次更名不会影响任何设备的功能。唯一的变化是在未来所有文档中使用新名称。
设备：Wave i4 DC
- 美国型号/订购代码：QNSN-0D24XUS
- Z-Wave 产品类型 ID：0x0009
- Z-Wave 产品 ID：0x0082
- Z-Wave 制造商：Shelly Europe Ltd.
- Z-Wave 制造商 ID：0x0460
术语说明
- 设备 – 在本文档中，“设备”指本指南所描述的 Shelly Qubino 产品。
- 网关 – 指 Z-Wave® 网关，也称为 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 中关联的设备发送命令。
- 松开：发送中央场景通知“按键释放 = 0x01”，并向组 5 中关联的设备发送命令。
若 SW1 配置为开关：
- 切换一次开关位置：向组 4 和组 5 中关联的设备发送命令。
若 SW1 配置为记忆型开关：
- 闭合触点：根据开关状态向组 4 和组 5 中关联的设备发送命令。
- 断开触点：根据开关状态向组 4 和组 5 中关联的设备发送命令。
连接至输入端子 SW2 的开关/按钮
若 SW2 配置为按钮：
- 场景编号 =
0x02
动作：
- 短按：发送中央场景通知“按键按下 1 次=0x00”，场景编号为
0x02，并向组 6 中关联的设备发送命令。 - 双击短按：发送中央场景通知“按键按下 2 次=0x00”。
- 长按：发送中央场景通知“按键按下 = 0x02”，并向组 7 中关联的设备发送命令。
- 松开：发送中央场景通知“按键释放 = 0x01”，并向组 7 中关联的设备发送命令。
若 SW2 配置为开关：
- 切换一次开关位置：向组 6 和组 7 中关联的设备发送命令。
若 SW2 配置为记忆型开关：
- 闭合触点：根据开关状态向组 6 和组 7 中关联的设备发送命令。
- 断开触点：根据开关状态向组 6 和组 7 中关联的设备发送命令。
连接至输入端子 SW3 的开关/按钮
若 SW3 配置为按钮：
- 场景编号 =
0x03
动作：
- 短按：发送中央场景通知“按键按下 1 次=0x00”，场景编号为
0x03，并向组 8 中关联的设备发送命令。 - 双击短按：发送中央场景通知“按键按下 2 次=0x00”。
- 长按：发送中央场景通知“按键按下 = 0x02”，并向组 9 中关联的设备发送命令。
- 松开：发送中央场景通知“按键释放 = 0x01”，并向组 9 中关联的设备发送命令。
若 SW3 配置为开关：
- 切换一次开关位置：向组 8 和组 9 中关联的设备发送命令。
若 SW3 配置为记忆型开关：
- 闭合触点：根据开关状态向组 8 和组 9 中关联的设备发送命令。
- 断开触点：根据开关状态向组 8 和组 9 中关联的设备发送命令。
连接至输入端子 SW4 的开关/按钮
若 SW4 配置为按钮：
- 场景编号 =
0x04
动作：
- 短按：发送中央场景通知“按键按下 1 次=0x00”，场景编号为
0x04，并向组 10 中关联的设备发送命令。 - 双击短按：发送中央场景通知“按键按下 2 次=0x00”。
- 长按：发送中央场景通知“按键按下 = 0x02”，并向组 11 中关联的设备发送命令。
- 松开：发送中央场景通知“按键释放 = 0x01”，并向组 11 中关联的设备发送命令。
若 SW4 配置为开关：
- 切换一次开关位置：向组 8 和组 9 中关联的设备发送命令。
若 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 变为常亮蓝色。
- 再次快速按下可循环切换菜单。
- 菜单状态的 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 闪烁模式
| 模式 | 闪烁模式 |
|---|---|
| 模式 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® 网络（包含）
注意！ 若设备成功添加/移除至 Z-Wave® 网络，连接至设备的遮蔽装置将上下移动 2 秒。
注意！ 对于安全 2（S2）包含，系统会弹出对话框，要求您输入贴在设备侧面的 Z-Wave® DSK 标签以及包装盒内的 5 位数字 PIN 码。
重要提示：请勿丢失该 PIN 码。
SmartStart 包含
支持 SmartStart 的产品可通过扫描设备上的 Z-Wave® 二维码由支持 SmartStart 的网关添加。无需额外操作，设备在通电后 10 分钟内自动完成添加。
- 使用网关应用扫描设备标签上的二维码。
- 将安全 2（S2）设备特定密钥（DSK）添加至配置列表。
- 将设备连接电源。
- 检查 蓝色 LED 是否缓慢闪烁——若是，则设备尚未添加。
- 通电后数秒内开始添加。
- 添加过程中，蓝色 LED 闪烁加快。
- 成功时，绿色 LED 缓慢闪烁。
使用 S 按钮添加
- 将设备连接电源。
- 确认 蓝色 LED 缓慢闪烁（未添加）。
- 在网关上启用添加/移除模式。
- 按住 S 按钮，直到 LED 变为常亮蓝色。
- 快速松开，然后按住 (>2 秒)，直到 蓝色 LED 缓慢闪烁——松开以进入学习模式。
- 添加过程中，蓝色 LED 闪烁加快。
- 成功时，绿色 LED 缓慢闪烁。
注意：在设置模式下，设备将在 10 秒后超时并返回正常模式。
使用开关/按钮添加
- 将设备连接电源。
- 确认 蓝色 LED 缓慢闪烁。
- 在网关上启用添加/移除模式。
- 在 3 秒内快速切换任意一个 SW 端子（SW1–SW4）的开关/按钮共 3 次（进入学习模式）。
- 添加过程中，蓝色 LED 闪烁加快。
- 成功时，绿色 LED 缓慢闪烁。
学习模式 – 一种允许设备从网关接收网络信息的状态。
从 Z-Wave® 网络中移除设备（排除）
注意！ 设备将从您的 Z-Wave® 网络中移除，但自定义配置将保留。
注意！ 成功移除后，遮蔽装置将上下移动 2 秒。
使用 S 按钮移除
- 将设备连接电源。
- 确认 绿色 LED 缓慢闪烁（设备已添加）。
- 在网关上启用添加/移除模式。
- 按住 S 按钮，直到 LED 变为常亮蓝色。
- 快速松开，然后按住 (>2 秒)，直到 蓝色 LED 缓慢闪烁——松开以进入学习模式。
- 排除过程中，蓝色 LED 闪烁加快。
- 成功时，蓝色 LED 闪烁变慢。
注意：设置模式下 10 秒超时。
使用开关/按钮移除
- 将设备连接电源。
- 确认 绿色 LED 缓慢闪烁。
- 在网关上启用添加/移除模式。
- 在 3 秒内快速切换任意一个 SW 端子的开关/按钮共 3 次。
- 排除过程中，蓝色 LED 闪烁加快。
- 成功时，蓝色 LED 闪烁变慢。
恢复出厂设置
通用说明
恢复出厂设置后，所有自定义参数（如用电量、关联、路由等）将恢复默认值。HOME ID 和 NODE ID 将被删除。仅在网关缺失或无法使用时才使用。
使用 S 按钮
- 按住 S 按钮，直到 LED 变为常亮蓝色。
- 多次按下 S 按钮，直到 LED 变为常亮红色。
- 按住 (>2 秒) S 按钮，直到红色 LED 闪烁加快——松开以开始重置。
- 重置过程中：LED 先变为常亮 绿色（约 1 秒），然后 蓝色和红色 快速闪烁（约 2 秒）。
- 成功时，蓝色 LED 闪烁变慢。
使用开关/按钮
注意：仅在通电后第一分钟内有效。
- 将设备连接电源。
- 在 3 秒内快速切换任意一个 SW 端子的开关/按钮共 5 次。
- 重置过程中：LED 先变为常亮 绿色（约 1 秒），然后 蓝色和红色 快速闪烁（约 2 秒）。
- 成功时，蓝色 LED 闪烁变慢。
Z-Wave 安全与设备特定密钥（DSK）
该设备支持最新的 安全 2（S2） 功能，采用强 AES-128 加密，使 Z-Wave® 成为最安全的物联网平台。
- 认证控制
- 包含时使用带外 DSK
- 与大多数实现兼容
该设备还支持 S2 认证、未认证及未加密包含。
注意：通过支持 S2 的网关添加时，需提供 DSK PIN 码。该码印在设备的 DSK 标签上，并包含在包装内。请勿撕下标签。
前五位数字被高亮/加下划线——即为 PIN 码。DSK 也以二维码形式呈现。
DSK 标签与二维码（示例）：
- 加入节点在射频传输前对公钥进行混淆（字节 1–2 设为零）。
- DSK 可用于带外（OOB）认证。
- 网关可扫描二维码以匹配通过射频接收的混淆密钥。
Z-Wave 参数
参数编号 1 – SW (SW1) 开关类型
- 定义设备如何处理连接至 SW（SW1）端子的开关。
- 值大小：1 字节
- 默认值：0
- 取值：
- 0：瞬时开关（按钮）
- 1：切换开关（闭合 = ON，断开 = OFF）
- 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。
- 值大小：1 字节
- 默认值：100
- 范围：0–100（0%–100%）
参数编号 120 – 恢复出厂设置
- 高级参数。
- 值大小：1 字节
- 默认值：0
- 取值：
- 0：无操作
- 1：恢复出厂设置（执行后自动重置为 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]
- 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 通知类型名称 | 热警报 |
| 通知类型 – 值 | 0x04 |
| 通知类型 – 事件 | 状态 |
| 通知名称 | 检测到过热 |
| 通知名称 – 值 | 0x02 |
| 通知名称 – 版本 | V2 |
| 设备特定 | 是 |
| LED 指示 | 查看 LED 表 |
| 设备反应 | 关闭所有输出并发送通知 |
| 恢复操作 | 断电重启、短按 S 按钮或按下任意 SW 端子 |
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_CHANGE
- SWITCH_MULTILEVEL_STOP_LEVEL_CHANGE
关联组 6–11
- 结构类似：SW2（组 6 & 7）、SW3（组 8 & 9）、SW4（组 10 & 11）
（详细信息遵循上述模式）
端点 1（根镜像）
- 组 1：生命线（与根设备相同）
- 组 2 & 3：SW1 关联的镜像
端点 2
- 组 1：生命线（SW1 状态报告）
- 组 2：基本命令（SW1）
- 组 3：多级命令（SW1）
端点 3
- 组 1：生命线（SW2 状态）
- 组 2：基本命令（SW2）
- 组 3：多级命令（SW2）
端点 4
- 组 1：生命线（SW3 状态）
- 组 2：基本命令（SW3）
- 组 3：多级命令（SW3）
端点 5
- 组 1：生命线（SW4 状态）
- 组 2：基本命令（SW4）
- 组 3：多级命令（SW4）
Z-Wave 重要免责声明
Z-Wave 无线通信并非总是 100% 可靠。此设备不应用于生命攸关或高价值场景。若设备未被识别或显示异常，请手动更改设备类型，并确认您的网关支持 Z-Wave Plus™ 多级设备。
故障排查
如需故障排查，请访问我们的支持门户：
👉 支持
网关兼容性
| 网关 | 开/关 1 | 开/关 2 | 开/关 3 | 开/关 4 | 备注 |
|---|---|---|---|---|---|
| Home Assistant | ✅ | ✅ | ✅ | ✅ | |
| Fibaro HC3 / Z-Wave 引擎 3 | ✅ | ✅ | ✅ | ✅ | |
| Homey | ✅ | ✅ | ✅ | ✅ | 解决方案 |
| Homee Cube Gen 7 | ✅ | ✅ | ✅ | ✅ | |
| Homee Cube Gen 5 | ⚪ | ⚪ | ⚪ | ⚪ | 无法使用中央场景或关联 |
| Smart Things | ✅ | ✅ | ✅ | ✅ | 使用 Shelly Wave 边缘驱动 |
| Jeedom | 待定 | 待定 | 待定 | 待定 | |
| Hubitat | 待定 | 待定 | 待定 | 待定 |
图例：
- ✅ = 正常 / 可行
- ⚪ = 部分支持
- ❌ = 不可行 / 不可用
- TBD = 待完成
- N/T = 未测试
功能含义
| 功能 | 含义 |
|---|---|
| 开/关 | 测试设备是否响应应用界面的开/关命令 |
| SW 开/关 | 测试设备是否通过 SW 输入报告开/关状态变化 |
| 瓦特 | 测试瓦特是否主动上报 |
| 千瓦时 | 测试千瓦时是否主动上报 |
| 上/下 | 测试设备是否响应应用界面的上/下命令 |
| SW 上/下 | 测试设备是否通过 SW 输入报告上/下状态变化 |
| 百叶角度 | 测试百叶角度是否响应应用界面命令 |
| SW 百叶角度 | 测试百叶角度是否通过 SW 输入报告变化 |
网关指南
更多实用指南请查阅 Shelly 知识库