Shelly Wave i4
注意：此前称为“Shelly Qubino Wave”的产品系列，现将统一更名为“Shelly Wave”。此次更名不会影响任何设备的功能。唯一的变化是在未来所有文档中使用新名称。
设备：Wave i4
- 澳大利亚零件编号 / 订购代码：QNSN-0A24XAU
- Z-Wave 产品类型 ID：0x0009
- Z-Wave 产品 ID：0x0081
- 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 设备从其所属的网络中移除的过程。文中使用“排除”、“移除”等词语。
- 遮蔽装置 – 泛指各种窗户遮挡装置，例如百叶窗、卷帘（遮光帘）、卷闸、竖直窗帘、帷幕、内置百叶窗、褶皱帘、遮阳篷等。此外，Wave Shutter 还可控制窗户电机、投影幕布或任何双向交流电机。
简要说明
该设备是一款 4 路数字输入模块（110–240 V AC），用于在 Z-Wave 网络内控制其他设备。它支持通过开关/按钮手动触发或取消场景。
连接至输入端子 SW1 的开关/按钮
该设备支持中央场景命令类（Central Scene Command Class）。当按下按钮时：
- 单击 → 发送场景通知，场景编号为
0x01 - 双击 → 再次发送场景编号为
0x01的场景通知 - 长按 → 发送“按键按下 = 0x02”
- 释放 → 发送“按键释放 = 0x01”
注意：不支持通过开关类型触发中央场景通知。
连接至 SW1 的按钮
若 SW1 配置为按钮：
- 场景编号：
0x01
动作：
- 短按：发送“按键按下 1 次 = 0x00”，并附带场景编号
0x01。同时向组 4 中关联的设备发送指令（参见 Z-Wave 关联）。 - 双击：发送“按键按下 2 次 = 0x00”。
- 长按：发送“按键持续按下 = 0x02”，并向组 5 中关联的设备发送指令。
- 释放：发送“按键释放 = 0x01”，并向组 5 中关联的设备发送指令。
连接至 SW1 的开关
若 SW1 配置为开关：
- 切换一次开关位置：向组 4 和组 5 中的关联设备发送指令。
连接至 SW1 的记忆开关
若 SW1 配置为记忆开关：
- 闭合触点：根据当前状态向组 4 和组 5 中的关联设备发送指令。
- 断开触点：根据当前状态向组 4 和组 5 中的关联设备发送指令。
连接至输入端子 SW2 的开关/按钮
若 SW2 配置为按钮：
- 场景编号：
0x02
动作：
- 短按：发送“按键按下 1 次 = 0x00”，附带场景编号
0x02。同时向组 6 中的设备发送指令。 - 双击：发送“按键按下 2 次 = 0x00”。
- 长按：发送“按键持续按下 = 0x02”，并向组 7 中的设备发送指令。
- 释放：发送“按键释放 = 0x01”，并向组 7 中的设备发送指令。
连接至 SW2 的开关
若 SW2 配置为开关：
- 切换一次开关位置：向组 6 和组 7 中的设备发送指令。
连接至 SW2 的记忆开关
若 SW2 配置为记忆开关：
- 闭合触点：根据状态向组 6 和组 7 中的设备发送指令。
- 断开触点：根据状态向组 6 和组 7 中的设备发送指令。
连接至输入端子 SW3 的开关/按钮
若 SW3 配置为按钮：
- 场景编号：
0x03
动作：
- 短按：发送“按键按下 1 次 = 0x00”，附带场景编号
0x03。同时向组 8 中的设备发送指令。 - 双击：发送“按键按下 2 次 = 0x00”。
- 长按：发送“按键持续按下 = 0x02”，并向组 9 中的设备发送指令。
- 释放：发送“按键释放 = 0x01”，并向组 9 中的设备发送指令。
连接至 SW3 的开关
若 SW3 配置为开关：
- 切换一次开关位置：向组 8 和组 9 中的设备发送指令。
连接至 SW3 的记忆开关
若 SW3 配置为记忆开关：
- 闭合触点：根据状态向组 8 和组 9 中的设备发送指令。
- 断开触点：根据状态向组 8 和组 9 中的设备发送指令。
连接至输入端子 SW4 的开关/按钮
若 SW4 配置为按钮：
- 场景编号：
0x04
动作：
- 短按：发送“按键按下 1 次 = 0x00”，附带场景编号
0x04。同时向组 10 中的设备发送指令。 - 双击：发送“按键按下 2 次 = 0x00”。
- 长按：发送“按键持续按下 = 0x02”，并向组 11 中的设备发送指令。
- 释放：发送“按键释放 = 0x01”，并向组 11 中的设备发送指令。
连接至 SW4 的开关
若 SW4 配置为开关：
- 切换一次开关位置：向组 10 和组 11 中的设备发送指令。
连接至 SW4 的记忆开关
若 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 等）的开关/按钮
注意：过热保护始终启用，无法禁用。
更多信息请参考 Z-Wave 通知命令类。
支持的负载类型
无
用户界面
S 按钮与工作模式
- 正常模式
- 设置进行中模式
- 设置模式（通过 S 按钮）
- 用于启动添加（包含）、移除（排除）、恢复出厂设置等操作。
- 有时间限制；操作完成后自动返回正常模式。
- 进入设置模式：
- 快速按住 S 按钮，直到 LED 变为常亮蓝色。
- 再快速按一次可切换菜单（无限循环）。
- 菜单状态的 LED 会在 10 秒后超时返回正常状态。
S 按钮功能
- 手动将设备添加到 Z-Wave 网络
- 手动将设备从 Z-Wave 网络中移除
- 恢复设备出厂设置
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）闪烁：
(1 至 6 次 - 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'：用户无权查看页面 '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）包含时，网关会弹出对话框，要求输入印在设备标签和包装上的 5 位数字 PIN 码。
重要提示：请务必妥善保管该 PIN 码。
SmartStart 包含
支持 SmartStart 的产品可通过扫描设备标签上的二维码，由支持 SmartStart 的网关添加。
- 扫描设备标签上的二维码，并将 DSK 添加至网关的预配置列表。
- 将设备接入电源。
- 检查 蓝色 LED 是否缓慢闪烁 —— 若是，则尚未完成添加。
- 接通电源后数秒内，添加过程将自动开始。
- 添加期间，LED 闪烁加快。
- 成功添加后，绿色 LED 将缓慢闪烁。
通过 S 按钮添加
- 将设备接入电源。
- 确认 蓝色 LED 缓慢闪烁。
- 在网关上启用添加/移除模式。
- 按住 S 按钮，直到 LED 变为常亮 蓝色。
- 松开，再按住 (>2 秒)，直到 LED 缓慢闪烁 —— 松开即启动学习模式。
- 添加期间，LED 闪烁加快。
- 成功添加：绿色 LED 缓慢闪烁。
注意：设置模式 10 秒后自动返回正常模式。
通过开关/按钮添加
- 将设备接入电源。
- 确认 蓝色 LED 缓慢闪烁。
- 在网关上启用添加/移除模式。
- 在 3 秒内快速切换任意一个 SW 端子上的开关/按钮 3 次（3 个开/关信号）。
- 添加期间，LED 闪烁加快。
- 成功添加：绿色 LED 缓慢闪烁。
学习模式：允许设备从网关接收网络信息的状态。
从 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 秒)，直到 LED 快速闪烁 —— 松开开始重置。
- 重置过程中：LED 先常亮 绿色（约 1 秒），然后 蓝色和红色 快速闪烁（约 2 秒）。
- 成功重置：蓝色 LED 缓慢闪烁。
通过开关/按钮
仅在通电后前一分钟内有效。
- 将设备接入电源。
- 在 3 秒内快速切换任意一个 SW 端子上的开关/按钮 5 次。
- 重置过程中：LED 先常亮 绿色（约 1 秒），然后 蓝色和红色 快速闪烁（约 2 秒）。
- 成功重置：蓝色 LED 缓慢闪烁。
Z-Wave 安全与设备特定密钥（DSK）
该设备支持 安全 2（S2），采用强 AES 128 加密，使 Z-Wave® 成为最安全的物联网平台之一。
- 已认证控制：
- 包含时使用外带式 DSK
- 与大多数实现兼容
支持：
- S2 已认证
- S2 未认证
- 不安全包含
注意：通过支持 S2 的网关添加时，需提供 DSK PIN。5 位数字的 PIN 印在设备侧边标签和包装上，不可撕掉标签。
DSK 标签与二维码（示例）：加入节点在射频传输前将字节 1–2 设置为零，以混淆公钥。DSK 可用于外带身份验证。
Z-Wave 参数
参数 1 – SW (SW1) 开关类型
- 大小：1 字节
- 默认值：0
- 取值：
- 0：瞬时开关（按钮）
- 1：切换开关（闭合 = ON，断开 = OFF）
- 2：切换开关（当开关状态改变时，设备状态随之改变）
参数 2 – SW2 开关类型
- 与上述相同。
参数 3 – SW3 开关类型
- 与上述相同。
参数 4 – SW4 开关类型
- 与上述相同。
参数 105 – LED 亮度调节
- 控制 LED 亮度（0–100%）。
- 大小：1 字节
- 默认值：100
- 取值：0–100（每 1% 递增）
2024 年起适用于 Wave 1、Wave 1PM、Wave 2PM、Plug US、Plug UK。
参数 120 – 恢复出厂设置
- 高级参数，可能隐藏在“高级”标签下。
- 大小：1 字节
- 默认值：0
- 取值：
- 0：无操作
- 1：恢复出厂设置
重置后，该值将自动重置为 0。
参数 201–203 – 序列号部分
- 只读，不可更改。
- 大小：每项 4 字节
- 取值：0x00000000 至 0x7FFFFFFF
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–5
每个端点支持：
- 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
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与STOP_LEVEL_CHANGE
组 6–11（SW2–SW4）
逻辑同上，对应各自端子。
端点 2–5
每个端点均模拟 SW1–SW4 的行为，拥有类似的关联组。
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 HC 3 / Z-Wave 引擎 3 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| Homey | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | *H |
| Homee Cube Gen 7 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| Homee Cube Gen 5 | ⚪ | ⚪ | ⚪ | ⚪ | ⚪ | ⚪ | ⚪ | ⚪ | *1 |
| Smart Things | ✅ | ✅ | ✅ | ✅ | 配合 Shelly Wave 边缘驱动 | ||||
| Vera Ezlo | ⚪ | ⚪ | ⚪ | ⚪ | ✅ | ✅ | ✅ | ✅ | *2 |
| Cozify | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
备注：
- *1：无法使用中央场景或关联功能。
- *2：缺少场景命令类功能。
- *H：通过此解决方案提交修复报告。
功能含义
| 功能 | 含义 / 测试结果 |
|---|---|
| 开/关 | 响应应用程序界面的开/关命令 |
| SW 开/关 | 通过 SW 输入报告开/关状态变化 |
| 调光 | 响应应用程序界面的调光命令 |
| SW 调光 | 通过 SW 输入报告调光状态 |
| 功率 | 无需请求即上报功率值 |
| 千瓦时 | 无需请求即上报千瓦时 |
| 上/下 | 响应应用程序界面的上/下命令 |
| SW 上/下 | 通过 SW 输入报告上/下动作 |
| 百叶角度 | 响应应用程序界面的百叶角度命令 |
| SW 百叶角度 | 通过 SW 输入报告百叶角度变化 |
| D 控制 | 检测场景命令（单击/双击等） |
| D 二进制 | 通过 SW 输入报告二进制开/关状态 |
| 传感器 # | 传感器在网关中可见；注明类型 |
图例
| 符号 | 状态 |
|---|---|
| ✅ | 正常工作 / 可行 |
| ⚪ | 无法工作 / 不可行 |
| P | 部分支持 |
| N/T | 未测试 |
| TBD | 待定 |
网关指南
更多实用指南可在 Shelly 知识库 中获取。