Shelly Wave i4
注意:原先被称为“Shelly Qubino Wave”的产品线,现将更名为“Shelly Wave”。此次更名不会影响任何设备的功能。唯一的变化是未来所有文档中将使用新名称。

设备:Wave i4
- 欧洲型号 / 订购代码:QNSN-0A24XEU
- 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
操作行为:
- 短按:发送中央场景通知“按键按下 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 配置为开关:
- 切换一次开关位置:向组 8 和 9 中关联的设备发送命令(参见 Z-Wave 关联)。
如果 SW4 配置为记忆开关:
- 切换至闭合触点:根据开关状态向组 10 和 11 中关联的设备发送命令。
- 切换至断开触点:根据开关状态向组 10 和 11 中关联的设备发送命令。
主要应用场景
- 住宅
- 多户单元(公寓、别墅、酒店等)
- 轻型商业(小型办公楼、小型零售/餐厅/加油站等)
- 政府/市政机构
- 大学/学院
集成支持
Shelly Qubino Wave 设备基于全球领先的智能家居技术——Z-Wave 构建。
这意味着 Shelly Qubino Wave 可与所有已认证且支持 Z-Wave 通信协议的网关兼容。
为确保完整功能,请查阅 与网关的兼容性 部分以获取详细的兼容性报告。
简化内部原理图
无
设备电气接口
输入
- 1 个螺丝端子上的开关/按钮输入
- 2 个螺丝端子上的开关/按钮输入
- 3 个螺丝端子上的开关/按钮输入
- 4 个螺丝端子上的开关/按钮输入
- 3 个螺丝端子上的电源输入:N、L
输出
无
连接方式
Z-Wave – 无安全、S0 安全、S2 未认证安全、S2 已认证安全
安全特性
过热保护
- 自动关闭自身继电器
- 向网关发送“检测到过热”通知
- LED 指示灯按指定模式反应(检查过热检测的闪烁模式)
以下任一操作均可复位此报警:
- 断电重启
- 快速按下 S 按钮
- 按下任意连接至任何 SW(SW、SW1、SW2…)端子的开关/按钮
注意:过热保护始终启用,无法禁用。
更多详情请参见 过热检测通知
支持的负载类型
无
用户界面
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 秒开(红色) |
规格参数
| 参数 | 值 |
|---|---|
| 电源输入(交流) | 110 – 240 V AC,50/60 Hz |
| 电源输入(直流) | 不支持 |
| 功耗 | < 0.2 W |
| 过载保护 | 无 |
| 电力测量 | 无 |
| 无需中性线工作 | 否 |
| 输入数量 | 4 |
| 传输距离 | 室内最大 40 米(131 英尺),受本地条件影响 |
| Z-Wave® 中继器 | 支持 |
| 处理器 | Z-Wave® S800 |
| Z-Wave® 频段 | 868.4 MHz |
| 最大射频功率 | < 25 mW |
| 尺寸(高 × 宽 × 深) | 37 × 42 × 16 ±0.5 毫米 / 1.46 × 1.65 × 0.63 ±0.02 英寸 |
| 重量 | 17 克 / 0.6 盎司 |
| 安装方式 | 壁挂式底座 |
| 螺丝端子最大扭矩 | 0.4 牛·米 / 3.5 英磅·英寸 |
| 导线截面积 | 0.5 至 1.5 毫米² / 20 至 16 AWG |
| 导线剥皮长度 | 5 至 6 毫米 / 0.20 至 0.24 英寸 |
| 外壳材料 | 塑料 |
| 颜色 | 橙色 |
| 环境温度 | -20℃ 至 40℃ / -5℉ 至 105℉ |
| 湿度 | 30% 至 70% 相对湿度 |
基本接线图


图例
| 端子 | 描述 |
|---|---|
| N | 中性线端子 |
| L | 火线端子(110–240 V AC) |
| SW 1 | 开关/按钮输入端子 |
| SW 2 | 开关/按钮输入端子 |
| SW 3 | 开关/按钮输入端子 |
| SW 4 | 开关/按钮输入端子 |
关于 Z-Wave
将设备添加至 Z-Wave® 网络(包含)
注意! 如果设备成功添加/移除至 Z-Wave® 网络,连接到该设备的遮蔽装置将向上/向下移动 2 秒。
注意! 对于安全 2(S2)包含,系统会弹出对话框要求输入设备上及包装内标签印有的 5 位数 PIN 码。
重要提示:请勿丢失此 PIN 码。
SmartStart 包含
- 使用支持 SmartStart 的网关扫描设备上的 Z-Wave QR 码。
- 无需进一步操作 —— 在通电后 10 分钟内自动完成包含。
- 扫描二维码并将 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 包含时,需要使用设备标签上印有的 5 位数 PIN 码。标签位于设备上及包装内。切勿撕掉。

前五位数字被高亮/加下划线。DSK 也以二维码形式呈现。
加入节点在无线传输前将公钥的字节 1–2 设置为零(0x00)以混淆。
DSK 可用于外带(OOB)身份验证。
网关可通过扫描二维码匹配通过无线接收的混淆公钥。
Z-Wave 参数
参数 1 – SW(SW1)开关类型
- 定义设备如何处理 SW(SW1)上的开关
- 大小:1 字节
- 默认值:0
- 取值:
- 0:瞬时开关(按钮)
- 1:切换开关(闭合 = 开 / 断开 = 关)
- 2:切换开关(设备状态随开关变化而改变)
参数 2 – SW2 开关类型
- 同上
- 默认值:0
参数 3 – SW3 开关类型
- 同上
- 默认值:0
参数 4 – SW4 开关类型
- 同上
- 默认值:0
参数 105 – LED 信号强度
- 控制 LED 亮度(0–100%)
- 2024 年起应用于 Wave 1、Wave 1PM、Wave 2PM、Plug US、Plug UK
- 大小:1 字节
- 默认值:100
- 取值:0–100(每 1% 递增)
参数 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:
- 与根设备相同,但不含 SWITCH_BINARY_V2 等
(端点 3、4、5 类似)
Z-Wave 通知命令类
检测到过热
| 字段 | 值 |
|---|---|
| 通知类型名称 | 热警报 |
| 通知类型(值) | 0x04 |
| 通知事件 | 状态 |
| 通知名称 | 检测到过热 |
| 通知名称(值) | 0x02 |
| 版本 | V2 |
| 设备特定 | 是 |
| 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 – 多级命令)
- 由 SW1 触发
- 推荐用于按钮
- 命令:SWITCH_MULTILEVEL_START_LEVEL_CHANGE, STOP_LEVEL_CHANGE
组 6–11(SW2–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 |
说明:
- 1:无法使用中央场景或关联自动化
- 2:缺少 CC 控制场景功能
- H:报告存在问题 —— 参见 解决方案
功能含义表
| 功能 | 含义 / 测试情况 |
|---|---|
| 开/关 | 响应应用界面的开/关命令 |
| SW 开/关 | 通过 SW 输入报告开/关状态变化 |
| 调光 | 响应应用界面调光命令 |
| SW 调光 | 通过 SW 输入报告调光状态 |
| 瓦特 | 未经请求地报告瓦特数值 |
| 千瓦时 | 未经请求地报告千瓦时数值 |
| 上/下 | 响应应用界面的上/下命令 |
| SW 上/下 | 通过 SW 输入报告上/下状态变化 |
| 百叶角度 | 百叶角度响应应用界面命令 |
| SW 百叶角度 | 百叶角度通过 SW 报告变化 |
| D 控制 | 报告场景命令(单击/双击等) |
| D 二进制 | 通过 SW 输入报告二进制开/关状态 |
| 传感器 # | 传感器在网关中可见;注明类型 |
图例
| 符号 | 状态 |
|---|---|
| ✅ | 正常工作 / 可行 |
| ⚪ | 无法工作 / 不可行 |
| P | 部分 |
| N/T | 未测试 |
| TBD | 待完成 |
网关指南
有用的指南可在 Shelly 知识库 中找到。