Shelly Wave i4
注意：原先被称为“Shelly Qubino Wave”的产品线，现在将统一更名为“Shelly Wave”。此次名称变更不会影响任何设备的功能。唯一的变化是未来所有文档中将使用新名称。
设备：Wave i4
- 美国零件号 / 订购代码：QNSN-0A24XUS
- Z-Wave 产品类型 ID：0x0009
- Z-Wave 产品 ID：0x0081
- 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 还可用于控制窗户电机、投影幕布或任何双向交流电机设备。
简要描述
该设备是一款四路数字输入模块（110–240 V AC），可在 Z-Wave 网络内控制其他设备。它支持通过开关/按钮手动触发或取消场景。
连接至输入端子 SW1 的开关/按钮
该设备支持中央场景命令类（Central Scene Command Class）。当按钮被单击、双击或长按后释放时，会发送对应场景编号（1、2、3 或 4）的场景通知。
注意：不支持通过开关类型触发中央场景通知。
连接至输入端子 SW1 的按钮
若 SW1 配置为按钮：
- 场景编号 =
0x01
动作：
- 短按：发送“按下一次=0x00”，场景编号为
0x01。同时向组 4 中关联的设备发送指令（参见 Z-Wave 关联）。 - 两次短按：发送“按下两次=0x00”。
- 长按：发送“按键持续按下=0x02”，并向组 5 中的设备发送指令。
- 松开：发送“按键释放=0x01”，并向组 5 中的设备发送指令。
若 SW1 配置为开关：
- 切换开关位置一次：向组 4 和组 5 中的设备发送指令。
若 SW1 配置为记忆型开关：
- 切换至闭合触点：根据当前状态向组 4 和组 5 中的设备发送指令。
- 切换至断开触点：根据当前状态向组 4 和组 5 中的设备发送指令。
连接至输入端子 SW2 的开关/按钮
若 SW2 配置为按钮：
- 场景编号 =
0x02
动作：
- 短按：发送“按下一次=0x00”，场景编号为
0x02，然后向组 6 中的设备发送指令。 - 两次短按：发送“按下两次=0x00”。
- 长按：发送“按键持续按下=0x02”，然后向组 7 中的设备发送指令。
- 松开：发送“按键释放=0x01”，然后向组 7 中的设备发送指令。
若 SW2 配置为开关：
- 切换开关位置一次：向组 6 和组 7 中的设备发送指令。
若 SW2 配置为记忆型开关：
- 切换至闭合触点：根据状态向组 6 和组 7 中的设备发送指令。
- 切换至断开触点：根据状态向组 6 和组 7 中的设备发送指令。
连接至输入端子 SW3 的开关/按钮
若 SW3 配置为按钮：
- 场景编号 =
0x03
动作：
- 短按：发送“按下一次=0x00”，场景编号为
0x03，然后向组 8 中的设备发送指令。 - 两次短按：发送“按下两次=0x00”。
- 长按：发送“按键持续按下=0x02”，然后向组 9 中的设备发送指令。
- 松开：发送“按键释放=0x01”，然后向组 9 中的设备发送指令。
若 SW3 配置为开关：
- 切换开关位置一次：向组 8 和组 9 中的设备发送指令。
若 SW3 配置为记忆型开关：
- 切换至闭合触点：根据状态向组 8 和组 9 中的设备发送指令。
- 切换至断开触点：根据状态向组 8 和组 9 中的设备发送指令。
连接至输入端子 SW4 的开关/按钮
若 SW4 配置为按钮：
- 场景编号 =
0x04
动作：
- 短按：发送“按下一次=0x00”，场景编号为
0x04，然后向组 10 中的设备发送指令。 - 两次短按：发送“按下两次=0x00”。
- 长按：发送“按键持续按下=0x02”，然后向组 11 中的设备发送指令。
- 松开：发送“按键释放=0x01”，然后向组 11 中的设备发送指令。
若 SW4 配置为开关：
- 切换开关位置一次：向组 10 和组 11 中的设备发送指令。
若 SW4 配置为记忆型开关：
- 切换至闭合触点：根据状态向组 10 和组 11 中的设备发送指令。
- 切换至断开触点：根据状态向组 10 和组 11 中的设备发送指令。
主要应用场景
- 住宅
- 多户住宅（公寓、联排别墅、酒店等）
- 轻型商业（小型办公室、零售店、餐厅、加油站等）
- 政府/市政
- 大学/学院
兼容性集成
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 按钮后，模式 1 下蓝灯闪烁 10 分钟 |
| 正常模式 – 已添加/包含 | 断电或按下 S 按钮后，模式 1 下绿灯闪烁 10 分钟 |
| 恢复出厂设置并重启 | 绿灯常亮约 1 秒，随后蓝红灯快闪约 2 秒（0.1 秒亮/灭） |
| 添加/移除过程 | 模式 2 下蓝灯闪烁 |
| 固件 OTA 更新 | 模式 2 下蓝红灯交替闪烁 |
| 电源检查（230V AC / 24V DC） | 模式 5 下蓝红灯交替闪烁 |
| 设置模式 – 已选择添加/移除 | 蓝灯常亮（最长 10 秒） |
| 设置模式 – 添加/移除进行中 | 模式 3 下蓝灯闪烁 |
| 设置模式 – 已选择恢复出厂设置 | 红灯常亮（最长 10 秒） |
| 设置模式 – 恢复出厂设置进行中 | 模式 3 下红灯闪烁 |
| 报警模式 – 检测到过热 | 模式 4 下红灯闪烁：(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'：用户无权查看页面 'DEV:Technical Specifications'。
基本接线图
错误渲染宏 'excerpt-include'：用户无权查看页面 'DEV:Wiring diagrams'。
图例
| 端子 | 描述 | 导线 | 描述 |
|---|---|---|---|
| N | 零线端子 | N | 零线 |
| L | 火线端子（110–240 V AC） | L | 火线（110 V AC） |
| SW 1 | 开关/按钮输入端子 | ||
| SW 2 | 开关/按钮输入端子 | ||
| SW 3 | 开关/按钮输入端子 | ||
| SW 4 | 开关/按钮输入端子 |
关于 Z-Wave
将设备添加至 Z-Wave 网络（包含）
注意！ 成功添加或移除后，连接至设备的遮蔽装置将上下移动 2 秒。
注意！ 使用安全 2（S2）包含时，系统会弹出对话框要求输入贴在设备和包装上的 Z-Wave DSK 标签上的五位数字验证码。请勿丢失此标签。
SmartStart 包含
- 使用支持 SmartStart 的网关扫描设备上的二维码。
- 将设备接入电源。
- 若 蓝灯缓慢闪烁，表示设备尚未添加。
- 接电后数秒内自动开始添加。
- 添加过程中蓝灯闪烁加快。
- 成功则绿灯缓慢闪烁。
使用 S 按钮包含
- 将设备接入电源。
- 确认蓝灯缓慢闪烁。
- 在网关上启用添加/移除模式。
- 按住 S 按钮，直至 LED 变为稳定蓝色。
- 快速释放，再按住（>2 秒），直到蓝灯缓慢闪烁 —— 释放以进入学习模式。
- 添加过程中蓝灯闪烁加快。
- 成功后绿灯缓慢闪烁。
注意：设置模式在 10 秒后超时。
使用开关/按钮包含
- 将设备接入电源。
- 确认蓝灯缓慢闪烁。
- 在网关上启用添加/移除模式。
- 在 3 秒内连续切换任意一个 SW 端子的开关/按钮共 3 次（必须接收到 3 次通断信号）。
- 添加过程中蓝灯闪烁加快。
- 成功则绿灯缓慢闪烁。
学习模式：允许设备从网关接收网络信息的状态。
从 Z-Wave 网络中移除设备（排除）
注意：设备将被移除，但自定义配置保留。
注意：成功后遮蔽装置将上下移动 2 秒。
使用 S 按钮排除
- 将设备接入电源。
- 确认绿灯缓慢闪烁。
- 在网关上启用添加/移除模式。
- 按住 S 按钮，直至 LED 变为稳定蓝色。
- 释放，再按住（>2 秒），直到蓝灯缓慢闪烁 —— 释放以进入学习模式。
- 排除过程中蓝灯闪烁加快。
- 成功则蓝灯闪烁变慢。
注意：设置模式在 10 秒后超时。
使用开关/按钮排除
- 将设备接入电源。
- 确认绿灯缓慢闪烁。
- 在网关上启用添加/移除模式。
- 在 3 秒内连续切换任意一个 SW 端子的开关/按钮共 3 次。
- 排除过程中蓝灯闪烁加快。
- 成功则蓝灯闪烁变慢。
恢复出厂设置
通用说明
重置后，所有自定义参数（如用电量、关联关系、路由等）将恢复默认值。HOME ID 与 NODE ID 将被删除。仅当网关缺失或无法工作时才使用。
使用 S 按钮
- 按住 S 按钮，直至 LED 变为稳定蓝色。
- 多次按下 S 按钮，直至 LED 变为稳定红色。
- 继续按住 S 按钮（>2 秒），直到红灯快速闪烁 —— 释放以启动重置。
- 重置期间：LED 先变为绿色常亮（约 1 秒），随后蓝红灯快速闪烁（约 2 秒）。
- 成功后蓝灯缓慢闪烁。
使用开关/按钮
注意：仅在通电后一分钟内有效。
- 将设备接入电源。
- 在 3 秒内连续切换任意一个 SW 端子的开关/按钮共 5 次。
- 重置期间：LED 先变为绿色常亮（约 1 秒），随后蓝红灯快速闪烁（约 2 秒）。
- 成功后蓝灯缓慢闪烁。
Z-Wave 安全与设备特定密钥（DSK）
该设备支持 安全 2（S2），采用强 AES 128 加密，使 Z-Wave 成为最安全的物联网平台。
- 已认证控制：通过外带（带外）DSK 包含
- 支持 S2 已认证、未认证及无安全包含
注意：通过支持 S2 的网关添加时，必须输入设备和包装上 DSK 标签上的五位数字验证码。请勿撕毁标签。
前五位数字已高亮/加下划线。DSK 也以二维码形式呈现。
DSK 混淆处理：加入节点在通过射频传输公钥前，将字节 1–2 设置为零。
DSK 可用于带外（OOB）身份验证。网关可通过扫描二维码匹配通过射频接收到的混淆公钥。
Z-Wave 参数
| 参数编号 | 名称 | 描述 | 值大小 | 默认值 | 取值及说明 |
|---|---|---|---|---|---|
| 1 | SW (SW1) 开关类型 | 定义 SW1 端子开关的行为 | 1 字节 | 0 | 0：瞬时开关（按钮） 1：切换开关（闭合 = ON） 2：切换开关（开关变化时设备状态改变） |
| 2 | SW2 开关类型 | 与上述相同，适用于 SW2 | 1 字节 | 0 | 相同取值 |
| 3 | SW3 开关类型 | 与上述相同，适用于 SW3 | 1 字节 | 0 | 相同取值 |
| 4 | SW4 开关类型 | 与上述相同，适用于 SW4 | 1 字节 | 0 | 相同取值 |
| 105 | LED 亮度调节 | 控制 LED 亮度（0–100%） | 1 字节 | 100 | 0–100（每 1% 递增） |
| 120 | 恢复出厂设置 | 触发恢复出厂设置并从网络中移除 | 1 字节 | 0 | 0：无操作 1：恢复出厂设置 |
| 201 | 序列号 1 | 设备序列号的一部分 | 4 字节 | 设备特定 | 0x00000000 – 0x7FFFFFFF |
| 202 | 序列号 2 | 设备序列号的一部分 | 4 字节 | 设备特定 | 0x00000000 – 0x7FFFFFFF |
| 203 | 序列号 3 | 设备序列号的一部分 | 4 字节 | 设备特定 | 0x00000000 – 0x7FFFFFFF |
重置后，参数值将自动设为 0。
Z-Wave 命令类
端点 1（根）
- 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
与端点 2 相同
Z-Wave 通知命令类
检测到过热
| 字段 | 值 |
|---|---|
| 注释 | 检测到过热 |
| 通知类型名称 | 热警报 |
| 通知类型（值） | 0x04 |
| 通知事件 | 状态 |
| 通知名称 | 检测到过热 |
| 通知名称（值） | 0x02 |
| 版本 | V2 |
| 设备特定 | 是 |
| LED 指示 | 参见 LED 表 |
| 设备反应 | 关闭输出，发送通知 |
| 恢复操作 | 重启供电、短按 S 按钮或按任意 SW 端子 |
Z-Wave 关联关系
关联关系允许设备之间直接通信，无需依赖网关。
- 每组最多 9 个设备
- 推荐最大值：每组 5 个
- “生命线组”专供网关使用（仅 1 个节点）
根设备 – 关联组 1（生命线）
- 报告设备状态
- 支持：
- INDICATOR_REPORT
- DEVICE_RESET_LOCALLY_NOTIFICATION
- SWITCH_BINARY_REPORT（SW1–SW4）
关联组 4（SW1 – 基本命令）
- 由 SW1 触发
- 向关联设备发送 BASIC_SET ON/OFF
- 使用基本命令类
关联组 5（SW1 – 多级）
- 由 SW1 触发
- 发送 SWITCH_MULTILEVEL_START_LEVEL_CHANGE / STOP_LEVEL_CHANGE
- 推荐用于按钮
关联组 6（SW2 – 基本）
- 由 SW2 触发
- 发送 BASIC_SET ON/OFF
关联组 7（SW2 – 多级）
- 由 SW2 触发
- 发送多级命令
- 推荐用于按钮
关联组 8–11（SW3/SW4）
- 结构同上
端点 2–5
每个端点均有类似关联组（组 1 生命线，组 2 基本，组 3 多级）
Z-Wave 重要免责声明
Z-Wave 无线通信可能无法保证 100% 可靠。不要仅依赖此设备用于生命或价值关键应用。若设备未被识别或行为异常，请手动调整设备类型，并确认网关支持 Z-Wave Plus™ 多级设备。
故障排查
访问我们的支持门户：https://support.shelly.cloud/
网关兼容性
| 网关 | D Control 1 | D Control 2 | D Control 3 | D Control 4 | D Binary 1 | D Binary 2 | D Binary 3 | D Binary 4 | 备注 |
|---|---|---|---|---|---|---|---|---|---|
| Home Assistant | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| Fibaro HC3/Z-Wave Engine 3 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| Homey | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | *H |
| Homee Cube Gen 7 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| Homee Cube Gen 5 | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | *1 |
| SmartThings | ✅ | ✅ | ✅ | ✅ | 需使用 Shelly Wave 边缘驱动 | ||||
| Vera Ezlo | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ✅ | ✅ | ✅ | ✅ | *2 |
备注：
- *1：无法使用中央场景或关联功能
- *2：缺少场景控制命令类能力
- *H：报告问题可通过此解决方案解决
功能说明图例
| 功能 | 含义 / 测试情况 |
|---|---|
| 开/关 | 响应应用程序界面的开/关命令 |
| SW 开/关 | 通过 SW 输入报告开/关状态变化 |
| 调光 | 响应应用程序界面调光命令 |
| SW 调光 | 通过 SW 输入报告调光状态 |
| 瓦特 | 无需请求即可报告瓦特数值 |
| 千瓦时 | 无需请求即可报告千瓦时数值 |
| 上/下 | 响应应用程序界面的上/下命令 |
| SW 上/下 | 通过 SW 输入报告上/下状态变化 |
| 百叶角度 | 百叶角度响应应用程序界面命令 |
| SW 百叶角度 | 百叶角度通过 SW 输入报告变化 |
| D Control | 独立模式：报告场景命令（单击/双击等） |
| D Binary | 独立模式：通过 SW 输入报告二进制开/关 |
| 传感器 # | 传感器报告是否可见？类型已注明 |
图例说明
| 符号 | 状态 |
|---|---|
| ✅ | 正常工作 / 可行 |
| ⚠️ | 无法工作 / 不可行 |
| P | 部分 |
| N/T | 未测试 |
| TBD | 待完成 |
网关使用指南
更多实用指南请查阅 Shelly 知识库