Skip to content

Shelly Wave i4

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

wave-i4-320x300.jpg

设备: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 按钮与工作模式

  1. 正常模式
  2. 设置进行中模式
  3. 设置模式(通过 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 闪烁模式

模式描述
模式 10.5 秒开 / 2 秒关
模式 20.5 秒开 / 0.5 秒关
模式 30.1 秒开 / 0.1 秒关
模式 4(1 至 6 次 - 0.2 秒开 / 0.2 秒关) + 2 秒关
模式 50.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 的网关添加。

  1. 扫描设备标签上的二维码,并将 DSK 添加至网关的预配置列表。
  2. 将设备接入电源。
  3. 检查 蓝色 LED 是否缓慢闪烁 —— 若是,则尚未完成添加。
  4. 接通电源后数秒内,添加过程将自动开始。
  5. 添加期间,LED 闪烁加快。
  6. 成功添加后,绿色 LED 将缓慢闪烁。

通过 S 按钮添加

  1. 将设备接入电源。
  2. 确认 蓝色 LED 缓慢闪烁。
  3. 在网关上启用添加/移除模式。
  4. 按住 S 按钮,直到 LED 变为常亮 蓝色
  5. 松开,再按住 (>2 秒),直到 LED 缓慢闪烁 —— 松开即启动学习模式。
  6. 添加期间,LED 闪烁加快。
  7. 成功添加:绿色 LED 缓慢闪烁。

注意:设置模式 10 秒后自动返回正常模式。

通过开关/按钮添加

  1. 将设备接入电源。
  2. 确认 蓝色 LED 缓慢闪烁。
  3. 在网关上启用添加/移除模式。
  4. 在 3 秒内快速切换任意一个 SW 端子上的开关/按钮 3 次(3 个开/关信号)。
  5. 添加期间,LED 闪烁加快。
  6. 成功添加:绿色 LED 缓慢闪烁。

学习模式:允许设备从网关接收网络信息的状态。


从 Z-Wave® 网络中移除设备(排除)

注意:设备将被移除,但自定义配置保持不变。

注意:移除时,遮蔽装置将上下移动 2 秒。

通过 S 按钮移除

  1. 将设备接入电源。
  2. 确认 绿色 LED 缓慢闪烁。
  3. 在网关上启用添加/移除模式。
  4. 按住 S 按钮,直到 LED 变为常亮 蓝色
  5. 松开,再按住 (>2 秒),直到 LED 缓慢闪烁 —— 松开即启动学习模式。
  6. 移除期间,LED 闪烁加快。
  7. 成功移除:蓝色 LED 缓慢闪烁。

注意:设置模式 10 秒后自动返回。

通过开关/按钮移除

  1. 将设备接入电源。
  2. 确认 绿色 LED 缓慢闪烁。
  3. 在网关上启用添加/移除模式。
  4. 在 3 秒内快速切换任意一个 SW 端子上的开关/按钮 3 次。
  5. 移除期间,LED 闪烁加快。
  6. 成功移除:蓝色 LED 缓慢闪烁。

恢复出厂设置

通用说明

重置后,所有自定义参数(如电能、关联关系、路由等)将恢复默认值。HOME ID 与 NODE ID 将被删除。仅在网关缺失或无法工作时使用。

通过 S 按钮

  1. 按住 S 按钮,直到 LED 变为常亮 蓝色
  2. 快速多次按下 S 按钮,直到 LED 变为常亮 红色
  3. 按住 (>2 秒),直到 LED 快速闪烁 —— 松开开始重置。
  4. 重置过程中:LED 先常亮 绿色(约 1 秒),然后 蓝色和红色 快速闪烁(约 2 秒)。
  5. 成功重置:蓝色 LED 缓慢闪烁。

通过开关/按钮

仅在通电后前一分钟内有效。

  1. 将设备接入电源。
  2. 在 3 秒内快速切换任意一个 SW 端子上的开关/按钮 5 次。
  3. 重置过程中:LED 先常亮 绿色(约 1 秒),然后 蓝色和红色 快速闪烁(约 2 秒)。
  4. 成功重置:蓝色 LED 缓慢闪烁。

Z-Wave 安全与设备特定密钥(DSK)

该设备支持 安全 2(S2),采用强 AES 128 加密,使 Z-Wave® 成为最安全的物联网平台之一。

  • 已认证控制
    • 包含时使用外带式 DSK
    • 与大多数实现兼容

支持:

  • S2 已认证
  • S2 未认证
  • 不安全包含

注意:通过支持 S2 的网关添加时,需提供 DSK PIN。5 位数字的 PIN 印在设备侧边标签和包装上,不可撕掉标签。

DSK 示例

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_CHANGESTOP_LEVEL_CHANGE

组 6–11(SW2–SW4)

逻辑同上,对应各自端子。

端点 2–5

每个端点均模拟 SW1–SW4 的行为,拥有类似的关联组。


Z-Wave 重要免责声明

Z-Wave® 无线通信可能无法 100% 可靠。切勿在生命攸关或高价值场景中使用此设备。若网关无法识别,请手动更改设备类型,并确保网关支持 Z-Wave Plus™ 多级设备。


故障排查

如需帮助,请访问:https://support.shelly.cloud/


网关兼容性

网关D Control 1D Control 2D Control 3D Control 4D Binary 1D Binary 2D Binary 3D 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 知识库 中获取。


合规性声明


打印用户手册

Wave_i4_multilang_2023_V3.pdf