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 知识库 中获取。