Shelly Wave 1 - 设备文档
注意：原先称为“Shelly Qubino Wave”的产品线，现将统一更名为“Shelly Wave”。此次更名不会影响任何设备的功能。唯一的变化是未来所有文档中将使用新名称。
设备识别
- 设备名称：Wave 1
- 澳大利亚零件号 / 订购代码：QNSW-001X16AU
- Z-Wave 产品类型 ID：0x0002
- Z-Wave 产品 ID：0x0083
- Z-Wave 制造商：Shelly Europe Ltd.
- Z-Wave 制造商 ID：0x0460
术语说明
- 设备：本文档中，“设备”指本指南所讨论的 Shelly Qubino 型号。
- 网关：Z-Wave® 网关（也称作 Z-Wave® 控制器、主控制器、主要控制器或中枢）作为智能家庭网络的中心枢纽。本文档中统称“网关”。
- S 按钮：位于 Z-Wave® 设备上的服务按钮，用于执行添加（包含）、移除（排除）及恢复出厂设置等操作。本文档中使用“S 按钮”一词。
简要描述
该设备控制单个电气设备的通断功能（例如灯泡、吊扇、红外加热器、电锁、车库门、灌溉系统等）。输出触点为无源干接点，可连接不同电源负载（最大达 16 A），默认兼容按钮和开关。
当开关连接至输入端子 SW（SW1）
若将 SW（SW1）配置为开关（默认状态）：
- 每次切换开关位置，都会使输出状态 O（O1）反转——即 ON、OFF、ON，依此类推。
操作行为：
- 切换开关一次：将输出状态 O（O1）切换至相反状态，并向组 2 和组 3 中关联的设备发送命令（参见 Z-Wave 关联）。
- 切换开关两次：如果两次点击之间的时间间隔小于 500 毫秒，则视为双击操作，向组 2 和组 3 中关联的调光器、百叶窗等设备发送命令。
主要应用场景
- 住宅
- 多住户单元（公寓、公寓楼、酒店等）
- 轻型商业（小型办公楼、零售店、餐厅、加油站等）
- 政府/市政单位
- 大学/学院
兼容集成
Shelly Qubino Wave 设备基于全球领先的智能家居技术——Z-Wave。
这意味着它们可与所有支持 Z-Wave 通信协议的认证网关协同工作。
为确保完整功能，我们定期测试与各类 Z-Wave 网关的兼容性。
简化内部原理图
设备电气接口
输入端口
- 1 个螺丝端子上的开关/按钮输入
- 1 个螺丝端子上的无源触点继电器输入
- 2 个螺丝端子上的电源输入：N 和 L
输出端口
- 1 个螺丝端子上的无源触点继电器输出
连接方式
Z-Wave – 不安全、S0 安全、S2 未认证安全、S2 已认证安全
安全特性
过热保护
- 自动关闭自身继电器
- 向网关发送 通知报告（“检测到过热”）
- LED 根据指定闪烁模式响应（参见“LED 信号指示”）
以下任一操作可重置警报：
- 断电重启
- 短按 S 按钮
- 按下任意连接在任一 SW（SW、SW1、SW2…）端子上的开关/按钮
注意：过热保护始终启用，无法禁用。
更多详情请参阅 Z-Wave 通知命令类
支持的负载类型
- 阻性负载（白炽灯、加热设备）
- 容性负载（电容组、电子设备、电机启动电容）
- 带 RC 吸收电路的感性负载（LED 灯驱动器、变压器、风扇、冰箱、空调）
用户界面
S 按钮与工作模式
- 正常模式
- 设置进行中模式
- 设置模式（通过 S 按钮）
- 用于启动包含、排除、恢复出厂设置等流程
- 时间有限；完成操作后自动返回正常模式
- 进入设置模式：
- 快速按下并长按 S 按钮，直到 LED 变为常亮蓝色
- 再次快速按下可循环菜单（无限循环）
- 菜单状态在 10 秒后超时，返回正常状态
S 按钮功能
- 手动将设备添加至 Z-Wave 网络
- 手动从 Z-Wave 网络中移除设备
- 将设备恢复出厂设置
- 手动开关负载的通断
LED 信号指示
正常模式
- 已移除/排除：断电或按下 S 按钮后，LED 在模式 1 中持续闪烁蓝色，共持续 10 分钟
- 已添加/包含：断电或按下 S 按钮后，LED 在模式 1 中持续闪烁绿色，共持续 10 分钟
设置进行中
- 恢复出厂并重启：
- 绿色常亮约 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.3 W |
| 最大开关电压（交流） | 240 V |
| 最大开关电流（交流） | 16 A |
| 过热保护 | 是 |
| 通信范围 | 室内最大 40 米（131 英尺）——受本地环境影响 |
| Z-Wave® 中继器 | 是 |
| 处理器 | Z-Wave® S800 |
| Z-Wave® 频段 | 919.8 MHz |
| 最大射频功率 | < 25 mW |
| 尺寸（高 × 宽 × 深） | 37 × 42 × 16 ±0.5 毫米 / 1.46 × 1.65 × 0.63 ±0.02 英寸 |
| 重量 | 26 克 / 0.92 盎 |
| 安装方式 | 壁挂式底座 |
| 螺丝端子扭矩 | 0.4 牛·米 / 3.5 英寸·磅 |
| 导线截面积 | 0.5 至 1.5 毫米² / 20 至 16 AWG |
| 导线剥皮长度 | 5 至 6 毫米 / 0.20 至 0.24 英寸 |
| 外壳材质 | 塑料 |
| 颜色 | 蓝色 |
| 环境温度 | -20°C 至 40°C / -5°F 至 105°F |
| 湿度 | 30% 至 70% 相对湿度 |
| 最大海拔高度 | 2000 米 / 6562 英尺 |
基础接线图
| 图 1 | 图 2 |
|---|---|
 |  |
图例说明
| 端子 | 描述 | 电缆 | 描述 |
|---|---|---|---|
| N | 零线端子 | N | 零线 |
| L | 火线端子（110–240 V AC） | L | 火线（110–240 VAC） |
| SW | 开关/按钮输入端子（控制输出 O） | — | — |
| I | 负载电路输入端子 | — | — |
| O | 负载电路输出端子 | — | — |
关于 Z-Wave®
将设备添加至 Z-Wave® 网络（包含）
注意！ 若设备成功添加/移除，所有输出端口（O、O1 等）将短暂开启/关闭各 1 秒。
重要提示：对于安全 2（S2）包含，请输入设备及包装上贴纸的 Z-Wave® DSK 标签中的 5 位数字验证码。请勿丢失此代码。
SmartStart 包含方式
- 使用支持 SmartStart 的网关扫描设备上的 Z-Wave® 二维码。
- 接通设备电源。
- 确认蓝色 LED 在模式 1 中闪烁（表示尚未添加）。
- 设备将在数秒内自动完成包含。
- 包含过程中，蓝色 LED 在模式 2 中闪烁。
- 成功添加后，绿色 LED 在模式 1 中闪烁。
通过 S 按钮添加
- 接通设备电源。
- 确保蓝色 LED 在模式 1 中闪烁。
- 在网关上启用添加/移除模式。
- 按住 S 按钮，直至 LED 变为常亮蓝色。
- 松开，再按住 >2 秒，直至 LED 在模式 3 中闪烁 → 进入学习模式。
- 包含过程中，蓝色 LED 在模式 2 中闪烁。
- 成功后，绿色 LED 在模式 1 中闪烁。
注意：设置模式在 10 秒后超时。
通过开关/按钮添加
- 接通设备电源。
- 确认蓝色 LED 在模式 1 中闪烁。
- 在网关上启用添加/移除模式。
- 在 3 秒内连续切换任意一个 SW 端子上的开关/按钮 3 次（必须接收到 3 个开/关信号）。
- 包含过程中，蓝色 LED 在模式 2 中闪烁。
- 成功后，绿色 LED 在模式 1 中闪烁。
学习模式：使设备能够接收来自网关的网络信息。
从 Z-Wave® 网络中移除设备（排除）
注意：设备从网络中被移除，但自定义配置将保留。
通过 S 按钮移除
- 接通设备电源。
- 确认绿色 LED 在模式 1 中闪烁（表示已添加）。
- 在网关上启用添加/移除模式。
- 按住 S 按钮，直至 LED 变为常亮蓝色。
- 松开，再按住 >2 秒，直至 LED 在模式 3 中闪烁 → 进入学习模式。
- 排除过程中，蓝色 LED 在模式 2 中闪烁。
- 成功后，蓝色 LED 在模式 1 中闪烁。
注意：设置模式在 10 秒后超时。
通过开关/按钮移除
- 接通设备电源。
- 确认绿色 LED 在模式 1 中闪烁。
- 在网关上启用添加/移除模式。
- 在 3 秒内连续切换任意一个 SW 端子上的开关/按钮 3 次。
- 排除过程中，蓝色 LED 在模式 2 中闪烁。
- 成功后，蓝色 LED 在模式 1 中闪烁。
恢复出厂设置
通用说明
恢复出厂设置后，所有自定义设置、关联关系、用电量数据、路由信息等将恢复为默认值。HOME ID 与 NODE ID 将被删除。仅当网关缺失或无法使用时才建议使用。
通过 S 按钮
- 按住 S 按钮，直至 LED 变为常亮蓝色。
- 快速重复按下 S 按钮，直至 LED 变为常亮红色。
- 长按 S 按钮 (>2 秒)，直至红色 LED 在模式 3 中闪烁 → 开始重置。
- LED 变为常亮绿色（约 1 秒），随后蓝红快速闪烁（约 2 秒）。
- 若成功，蓝色 LED 在模式 1 中闪烁。
通过开关/按钮
仅在通电后前 1 分钟内有效
- 接通设备电源。
- 在 3 秒内连续切换任意一个 SW 端子上的开关/按钮 5 次。
- LED 变为常亮绿色（约 1 秒），随后蓝红快速闪烁（约 2 秒）。
- 若成功，蓝色 LED 在模式 1 中闪烁。
通过网关远程恢复出厂设置
使用 参数编号 120 触发远程恢复出厂设置。
Z-Wave® 安全与设备特定密钥（DSK）
该设备支持 安全 2（S2），采用强 AES-128 加密，使 Z-Wave® 成为目前最安全的物联网平台。
- 支持：S2 已认证、S2 未认证、不安全包含
- 需要 支持 S2 的网关
注意：在进行 S2 包含时，必须提供设备及包装标签上的 5 位数字验证码（DSK）。请妥善保存标签。
- 前五位数字以加粗/下划线标出（即验证码）
- DSK 也以二维码形式呈现
外部带外（OOB）认证
- 网关通过扫描二维码读取完整 DSK
- 与通过无线射频接收的混淆公钥匹配
- 加入节点在发送密钥前将字节 1–2 设置为
0x00
Z-Wave® 参数
| 参数编号 | 描述 | 大小 | 默认值 | 可选值及说明 |
|---|---|---|---|---|
| 1 | SW (SW1) 开关类型 | 1 字节 | 2 | 0 = 瞬时式 1 = 切换式（闭合=开） 2 = 切换式（开关变化时状态改变） |
| 17 | 断电后恢复输出 O (O1) | 1 字节 | 0 | 0 = 恢复上次状态 1 = 断电后保持关闭 |
| 19 | 输出 O (O1) 自动关闭定时器 | 2 字节 | 0 | 0 = 禁用 1–32535 = 秒（或毫秒，若参数 25 = 1） |
| 20 | 输出 O (O1) 自动开启定时器 | 2 字节 | 0 | 0 = 禁用 1–32535 = 秒（或毫秒，若参数 25 = 1） |
| 23 | 输出 O (O1) 触点类型（常开/常闭） | 1 字节 | 0 | 0 = 常开（NO） 1 = 常闭（NC） |
| 25 | 定时器单位（秒或毫秒） | 1 字节 | 0 | 0 = 秒 1 = 毫秒 |
| 91 | 水浸报警响应 | 4 字节 | 0 | 0 = 无操作 1 = 打开继电器 2 = 闭合继电器 |
| 92 | 烟雾报警响应 | 4 字节 | 0 | 0 = 无操作 1 = 打开继电器 2 = 闭合继电器 |
| 93 | 一氧化碳报警响应 | 4 字节 | 0 | 0 = 无操作 1 = 打开继电器 2 = 闭合继电器 |
| 94 | 高温报警响应 | 4 字节 | 0 | 0 = 无操作 1 = 打开继电器 2 = 闭合继电器 |
| 120 | 恢复出厂设置（远程） | 1 字节 | 0 | 0 = 不重置 1 = 恢复出厂 |
| 201–203 | 序列号（第1–3部分） | 4 字节 | 设备特定 | 只读；隐藏于高级标签下 |
继电器逻辑表（适用于参数 23）：
| 常开/常闭 | 命令 | 输出状态 |
|---|---|---|
| 常开 (0) | 关 | 0 伏 |
| 常开 (0) | 开 | 230 伏 |
| 常闭 (1) | 关 | 230 伏 |
| 常闭 (1) | 开 | 0 伏 |
Z-Wave® 命令类
- ASSOCIATION_V2 [S0, S2]*
- ASSOCIATION_GRP_INFO_V3 [S0, S2]*
- BASIC_V2 [S0, S2]*
- SWITCH_BINARY_V2 [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_ASSOCIATION_V3 [S0, S2]*
- NOTIFICATION_V8 [S0, S2]*
- POWERLEVEL_V1 [S0, S2]*
- SECURITY_V1
- SECURITY_2_V1
- SUPERVISION_V1
- TRANSPORT_SERVICE_V2
- VERSION_V3 [S0, S2]*
- ZWAVEPLUS_INFO_V2
在 S0/S2 模式下支持
Z-Wave® 通知命令类
| 字段 | 值 |
|---|---|
| 注释 | 检测到过热 |
| 通知类型名称 | 高温报警 |
| 通知类型值 | 0x04 |
| 通知事件 | 状态 |
| 通知名称 | 检测到过热 |
| 通知名称值 | 0x02 |
| 通知版本 | V2 |
| 设备特定 | 是 |
| LED 信号指示 | 参见 LED 表 |
| 设备反应 | 关闭所有输出 + 发送通知 |
| 恢复操作 | 断电重启、短按 S 按钮或按下开关 |
Z-Wave® 关联
关联组 1 – 生命线组
- 专供网关使用（最多 1 个节点）
- 报告设备状态
- 支持：
INDICATOR_REPORT：LED 状态DEVICE_RESET_LOCALLY_NOTIFICATION：请求触发SWITCH_BINARY_REPORT：输出 O (O1) 状态变化NOTIFICATION_REPORT：过热时触发
关联组 2
- 最多 9 个节点
- 由 SW (SW1) 输入触发
- 使用
BASIC_SET命令（开/关） - 向关联设备发送
BASIC_SET ON或OFF
关联组 3
- 最多 9 个节点
- 由 SW (SW1) 输入触发
- 使用
SWITCH_MULTILEVEL_START_LEVEL_CHANGE与STOP_LEVEL_CHANGE - 向关联设备发送级别变化命令
⚠️ 建议：每组限制 ≤5 个设备，避免网络延迟。
Z-Wave® 重要免责声明
Z-Wave® 无线通信并非始终 100% 可靠。切勿仅依赖此设备用于生命攸关或高价值场景。若设备未被识别或行为异常，请手动更改设备类型，并验证网关与 Z-Wave Plus™ 多级设备的兼容性。
故障排查
如需帮助，请访问：支持门户
兼容性
| 网关 | 开/关 | SW 开/关 | 备注 |
|---|---|---|---|
| Home Assistant | ✅ | ✅ | |
| Fibaro HC 3 / Z-Wave Engine 3 | ✅ | ✅ | |
| Homey | ✅ | ✅ | |
| Homee Cube Gen 7 | ✅ | ✅ | |
| Homee Cube Gen 5 | ✅ | ✅ | |
| SmartThings | ✅ | ✅ | 需使用 Shelly Wave 边缘驱动 |
| Vera Ezlo | ✅ | ✅ | |
| Cozify | ✅ | ✅ | |
| Hubitat | ✅ | ✅ |
图例：
- ✅ = 正常工作 / 可实现
- ❌ = 无法工作 / 不可行
- P = 部分支持
- N/T = 未测试
- TBD = 待定
功能含义
| 功能 | 含义 / 测试情况 |
|---|---|
| 开/关 | 响应应用界面的开/关命令 |
| SW 开/关 | 通过 SW 输入报告开/关状态变化 |
| 调光 | 响应应用界面的调光命令 |
| SW 调光 | 通过 SW 报告调光状态变化 |
| 瓦特 | 无需请求即可报告瓦特数 |
| 千瓦时 | 无需请求即可报告千瓦时 |
| 上/下 | 响应应用界面的上/下命令 |
| SW 上/下 | 通过 SW 报告上/下状态变化 |
| 百叶窗角度 | 百叶窗响应应用界面命令 |
| SW 百叶窗角度 | 百叶窗报告由 SW 引起的变化 |
| D 控制 | 在脱机模式下报告场景命令（单击/双击） |
| D 二进制 | 在脱机模式下通过 SW 输入报告二进制开/关状态 |
| 传感器 # | 传感器在网关中报告；注明类型 |
网关使用指南
实用指南：Shelly 知识库 – Z-Wave