Shelly Wave 1 Mini - 设备指南
注意：原先称为“Shelly Qubino Wave”的产品系列，现将统一更名为“Shelly Wave”。此次更名不会影响任何设备的功能。唯一的变化是在所有未来的文档中使用新名称。
设备识别
- 设备名称：Wave 1 Mini
- 澳大利亚零件号 / 订购代码：QMSW-0A1X8AU
- Z-Wave 产品类型 ID：0x0002
- Z-Wave 产品 ID：0x008E
- Z-Wave 制造商：Shelly Europe Ltd.
- Z-Wave 制造商 ID：0x0460
术语说明
- 设备：本文档中的“设备”指本指南所描述的 Shelly Qubino 产品。
- 网关：Z-Wave® 网关，也称作 Z-Wave® 控制器、Z-Wave® 主控制器、Z-Wave® 主控设备或 Z-Wave® 中心等，是作为 Z-Wave® 智能家居网络核心枢纽的设备。本文档中使用“网关”一词。
- S 按钮：位于 Z-Wave® 设备上的服务按钮，用于执行多种功能，如添加（包含）、移除（排除）以及将设备重置为出厂默认设置。本文档中使用“S 按钮”一词。
简要说明
如果将 SW（SW1）配置为开关（默认状态），每次切换开关位置将使输出端口 O（O1）的状态反转——开启、关闭、开启，依此类推。如果在设备设置中将 SW（SW1）配置为按钮，则每次按下按钮也会使输出端口 O（O1）的状态反转——开启、关闭、开启，依此类推。
开关连接至输入端子 SW（SW1）
若将 SW（SW1）配置为开关（默认）：
- 切换开关一次：将输出端口 O（O1）的状态切换为相反状态，并向组 2 和组 3 中关联的设备发送命令（参见 Z-Wave 关联）。
开关记忆型连接至输入端子 SW（SW1）
若将 SW（SW1）配置为开关记忆型：
- 闭合开关记忆触点：将输出端口 O（O1）状态设为“开”，并向组 2 和组 3 中关联的设备发送命令。
- 断开开关记忆触点：将输出端口 O（O1）状态设为“关”，并向组 2 和组 3 中关联的设备发送命令。
按钮连接至输入端子 SW（SW1）
若在设备设置中将 SW（SW1）配置为按钮：
- 单击：将输出端口 O（O1）状态切换为相反状态，并向组 2 和组 3 中关联的设备发送命令。
- 双击：若第一次和第二次点击之间的时间间隔小于 500 毫秒，则视为双击。向组 2 和组 3 中关联的设备（调光器、遮阳帘等）发送命令。
- 长按：向组 3 中关联的设备发送命令。
- 松开：向组 3 中关联的设备发送命令。
主要应用场景
- 住宅
- 多住户单元（公寓、联排别墅、酒店等）
- 轻型商业（小型办公楼、小型零售店/餐厅/加油站等）
- 政府/市政机构
- 大学/学院
集成支持
Shelly Qubino Wave 设备基于全球领先的智能家居技术——Z-Wave开发。
这意味着 Shelly Qubino Wave 可与所有经过认证并支持 Z-Wave 通信协议的网关兼容。
为确保完整功能支持，我们定期对不同型号的 Z-Wave 网关进行兼容性测试。
简化内部原理图
设备电气接口
输入
- 1 个螺丝端子上的开关/按钮输入
- 1 个螺丝端子上的无源触点继电器输入
- 2 个螺丝端子上的电源输入：N、L
输出
- 1 个螺丝端子上的无源触点继电器输出
扩展接口
无
连接方式
Z-Wave – 未加密、S0 安全、S2 未认证安全、S2 认证安全
安全特性
过热保护
- 自动切断自身继电器
- 向网关发送“过热检测到”通知报告
- LED 指示灯按指定模式反应（请参考“过热检测到”的闪烁模式）
以下任一操作可解除该警报：
- 断电重启
- 短按 S 按钮
- 按下任意连接至任意 SW（SW、SW1、SW2…）端子的开关/按钮
注意：过热保护始终处于激活状态，无法关闭。
更多详细信息请参阅 过热检测通知
支持的负载类型
- 阻性负载（白炽灯泡、加热设备）
- 容性负载（电容组、电子设备、电机启动电容）
- 带 RC 吸收电路的感性负载（LED 驱动器、变压器、风扇、冰箱、空调）
用户界面
S 按钮与工作模式
- 正常模式
- 设置进行中模式
- 设置模式（通过 S 按钮）
- 用于启动包含、排除、恢复出厂设置等操作。
- 操作时间有限；完成后自动返回正常模式。
- 进入设置模式：快速按下并长按 S 按钮，直到 LED 变为稳定蓝色。
- 再次快速按下 → 在菜单间无限循环切换
- 菜单状态下的 LED 有 10 秒超时，之后返回正常模式
S 按钮功能
- 手动将设备添加到 Z-Wave 网络
- 手动从 Z-Wave 网络中移除设备
- 将设备恢复出厂设置
LED 指示信号
正常模式
- 已移除/排除：断电或按下 S 按钮后，LED 在模式 1 下以蓝色闪烁 10 分钟
- 已添加/包含：断电或按下 S 按钮后，LED 在模式 1 下以绿色闪烁 10 分钟
设置进行中
- 恢复出厂设置并重启：LED 先变为稳定绿色（约 1 秒），然后蓝红交替闪烁（0.1 秒通/断）约 2 秒
- 添加/移除：LED 在模式 2 下以蓝色闪烁
- OTA 固件更新：LED 在模式 2 下以蓝红交替闪烁
- 检查电源供应（230 V AC / 24 V DC）：LED 在模式 5 下以蓝红交替闪烁
通过 S 按钮进入设置模式
- 选择添加/移除菜单：LED 保持稳定蓝色，最长可达 10 秒
- 正在执行添加/移除过程：LED 在模式 3 下以蓝色闪烁
- 选择恢复出厂设置菜单：LED 保持稳定红色，最长可达 10 秒
- 正在执行恢复出厂设置过程：LED 在模式 3 下以红色闪烁
报警模式
- 检测到过热：LED 在模式 4 下以红色闪烁 —— （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'。
基础接线图
| 
| 
|
图例
| 端子 | 描述 | 电缆 | 描述 |
|---|---|---|---|
| N | 零线端子 | N | 零线 |
| L | 火线端子（110–240 V AC） | L | 火线（110–240 VAC） |
| SW | 开关/按钮输入端子（控制输出端口 O） | ||
| I | 负载电路输入端子 | S | S 按钮 |
| O | 负载电路输出端子 |
关于 Z-Wave®
将设备添加到 Z-Wave® 网络（包含）
注意！ 若设备成功添加或移除，所有输出端口（O、O1、O2 等）将短暂地开启/关闭 1 秒。
注意！ 对于安全 2（S2）包含，系统会提示您输入贴在设备及包装上的 Z-Wave® DSK 标签上的 5 位数字 PIN 码。
重要提示：请妥善保管此 PIN 码。
SmartStart 包含
支持 SmartStart 的产品可通过兼容网关扫描设备标签上的二维码来添加。
- 扫描设备标签上的二维码，并将 DSK 添加到网关的预配列表中。
- 将设备接入电源。
- 检查蓝色 LED 是否在模式 1 下闪烁（表示设备尚未添加）。
- 设备将在数秒内自动添加。
- 包含过程中，蓝色 LED 在模式 2 下闪烁。
- 成功添加后，绿色 LED 在模式 1 下闪烁。
使用 S 按钮添加
- 将设备接入电源。
- 确认蓝色 LED 在模式 1 下闪烁。
- 在网关上启用添加/移除模式。
- 按住 S 按钮，直到 LED 变为稳定蓝色。
- 松开后，再次按住 >2 秒，直到 LED 在模式 3 下开始闪烁 → 松开即启动学习模式。
- 包含过程中，蓝色 LED 在模式 2 下闪烁。
- 若成功，绿色 LED 在模式 1 下闪烁。
注意：设置模式 10 秒后超时。
使用开关/按钮添加
- 将设备接入电源。
- 确认蓝色 LED 在模式 1 下闪烁。
- 在网关上启用添加/移除模式。
- 在 3 秒内将连接至 SW 端子的开关/按钮切换 3 次 → 进入学习模式。
- 包含过程中，蓝色 LED 在模式 2 下闪烁。
- 若成功，绿色 LED 在模式 1 下闪烁。
学习模式：允许设备接收来自网关的网络信息的状态。
从 Z-Wave® 网络中移除设备（排除）
注意：设备将从网络中移除，但自定义配置仍保留。
注意：移除过程中，输出端口会短暂开启/关闭 1 秒。
使用 S 按钮移除
- 将设备接入电源。
- 确认绿色 LED 在模式 1 下闪烁（表示设备已添加）。
- 在网关上启用添加/移除模式。
- 按住 S 按钮，直到 LED 变为稳定蓝色。
- 松开后，再次按住 >2 秒，直到 LED 在模式 3 下开始闪烁 → 松开即启动学习模式。
- 排除过程中，蓝色 LED 在模式 2 下闪烁。
- 若成功，蓝色 LED 在模式 1 下闪烁。
注意：设置模式 10 秒后超时。
使用开关/按钮移除
- 将设备接入电源。
- 确认绿色 LED 在模式 1 下闪烁。
- 在网关上启用添加/移除模式。
- 在 3 秒内将开关/按钮切换 3 次 → 进入学习模式。
- 排除过程中，蓝色 LED 在模式 2 下闪烁。
- 若成功，蓝色 LED 在模式 1 下闪烁。
恢复出厂设置
通用说明
重置后，所有自定义参数（电量、关联关系、路由等）将恢复为默认值。家庭 ID 与节点 ID 将被删除。仅在网关丢失或无法使用时才应执行此操作。
使用 S 按钮
注意：可随时执行。
- 按住 S 按钮，直到 LED 变为稳定蓝色。
- 多次按下 S 按钮，直到 LED 变为稳定红色。
- 长按 (>2 秒) S 按钮，直到红色 LED 在模式 3 下闪烁 → 松开即启动重置。
- 重置过程中：LED 先变为稳定绿色（约 1 秒），然后蓝红交替闪烁（模式 3，约 2 秒）。
- 若成功，蓝色 LED 在模式 1 下闪烁。
使用开关/按钮
注意：仅在上电后一分钟内有效。
- 将设备接入电源。
- 在 3 秒内将开关/按钮切换 5 次。
- 重置过程中：LED 先变为稳定绿色（约 1 秒），然后蓝红交替闪烁（模式 3，约 2 秒）。
- 若成功，蓝色 LED 在模式 1 下闪烁。
通过网关远程触发（参数设置）
可通过设置 参数编号 120 = 1 实现远程工厂重置。
Z-Wave® 安全与设备特定密钥（DSK）
该设备支持 安全 2（S2），采用强 AES 128 加密，使 Z-Wave 成为最安全的物联网平台之一。
- 认证控制
- 包含时使用带外 DSK
- 与大多数实现兼容
支持 S2 认证、未认证和非加密包含。
注意：通过支持 S2 的网关添加时，需提供 DSK PIN（前 5 位数字）。该信息位于设备及包装上的 DSK 标签上。请勿撕掉标签。
前五位数字已高亮/加下划线。DSK 还包含二维码。
加入节点在无线传输前会将公钥字节 1–2 设置为零（0x00）以混淆其内容。
DSK 可用于带外（OOB）认证：
- 网关扫描二维码读取完整 DSK，与通过射频收到的混淆密钥匹配。
Z-Wave® 参数
参数编号 1 – SW (SW1) 开关类型
定义设备如何处理连接至 SW (SW1) 的开关。
- 大小：1 字节
- 默认值：2
- 取值：
- 0：瞬时开关
- 1：切换开关（触点闭合 = 开 / 断开 = 关）
- 2：切换开关（当开关状态改变时状态随之改变）
参数编号 17 – 断电后恢复 O (O1) 的状态
决定是否在断电后保存并恢复上次的开/关状态。
- 大小：1 字节
- 默认值：0
- 取值：
- 0：保存并恢复上次状态
- 1：不保存；保持关闭
参数编号 19 – O (O1) 自动关闭定时器
设定时间后自动关闭。每次开启命令将重置计时器。
- 大小：2 字节
- 默认值：0
- 取值：
- 0：禁用
- 1–32535：秒（或毫秒——参见参数 25）
参数编号 20 – O (O1) 自动开启定时器
设定时间后自动开启。每次关闭命令将重置计时器。
- 大小：2 字节
- 默认值：0
- 取值：
- 0：禁用
- 1–32535：秒（或毫秒——参见参数 25）
参数编号 23 – O (O1) 触点类型 – NO/NC
设置继电器触点类型：常开（NO）或常闭（NC）。
- 大小：1 字节
- 默认值：0
- 取值：
- 0：NO
- 1：NC
| 触点类型 | 命令 | 设备输出状态 |
|---|---|---|
| NO (0) | 关 | 关（0 V） |
| NO (0) | 开 | 开（230 V） |
| NC (1) | 关 | 开（230 V） |
| NC (1) | 开 | 关（0 V） |
参数编号 25 – 为 O (O1) 设置定时器单位（秒或毫秒）
选择参数 19 和 20 中定时器的单位。
- 大小：1 字节
- 默认值：0
- 取值：
- 0：秒
- 1：毫秒
参数编号 91 – 水浸报警
决定对水浸报警帧的响应。
- 大小：4 字节
- 默认值：0
- 取值：
- 0：无操作
- 1：打开继电器
- 2：关闭继电器
参数编号 92 – 烟雾报警
同上，适用于烟雾报警。
参数编号 93 – 一氧化碳报警
同上，适用于一氧化碳报警。
参数编号 94 – 高温报警
同上，适用于高温报警。
参数编号 120 – 恢复出厂设置
高级参数。触发恢复出厂设置。
- 大小：1 字节
- 默认值：0
- 取值：
- 0：不重置
- 1：执行恢复出厂设置
隐藏于“高级”标签下。
参数编号 201 – 序列号 1
只读部分序列号。
- 大小：4 字节
- 默认值：设备特定
- 范围：0x00000000 – 0x7FFFFFFF
参数编号 202 – 序列号 2
同上。
参数编号 203 – 序列号 3
同上。
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
Z-Wave® 通知命令类
| 注释 | 检测到过热 |
|---|---|
| Z-Wave 通知类型名称 | 高温报警 |
| Z-Wave 通知类型 - 值 | 0x04 |
| Z-Wave 通知类型 - 事件 | 状态 |
| Z-Wave 通知名称 | 检测到过热 |
| Z-Wave 通知名称 - 值 | 0x02 |
| Z-Wave 通知名称 - 版本 | V2 |
| Z-Wave 设备特定 | 是 |
| LED 指示信号 | 参考 LED 指示表 |
| 设备反应 – 关闭所有输出并发送通知 | 是 |
| 恢复操作 – 断电重启 | 是 |
| 恢复操作 – 短按 S 按钮 | 是 |
| 恢复操作 – 按任意连接至 SW 端子的开关/按钮 | 是 |
Z-Wave® 关联
关联功能允许设备间直接通信，无需依赖网关。
- 每组最多 9 个设备（固定，建议每组不超过 5 个）
- “生命线组”保留用于控制设备（网关、远程控制器）
关联组 1 – 生命线
向控制设备发送通知/报告。
- 根设备 – 生命线
- INDICATOR_REPORT：LED 状态
- DEVICE_RESET_LOCALLY_NOTIFICATION：请求触发
- SWITCH_BINARY_REPORT：O (O1) 状态变化
- NOTIFICATION_REPORT：过热触发时
关联组 2
分配给 SW (SW1) 端子（使用 BASIC 命令类）。
- 由 SW (SW1) 触发
- 向关联设备发送
BASIC_SET ON或BASIC_SET OFF - 支持：
BASIC_SET
关联组 3
分配给 SW (SW1) 端子（使用 SWITCH_MULTILEVEL 命令类）。
- 推荐用于按钮
- 支持：
SWITCH_MULTILEVEL_START_LEVEL_CHANGE：启动转换（调光器、遮阳帘）SWITCH_MULTILEVEL_STOP_LEVEL_CHANGE：停止正在进行的转换
Z-Wave® 重要免责声明
Z-Wave 无线通信并非始终 100% 可靠。请不要在涉及生命安全的情况下使用此设备。若您的网关无法识别该设备，请手动更改设备类型，并确保网关支持 Z-Wave Plus™ 多级设备。
故障排查
如有帮助，请访问我们的支持门户：支持
兼容性
| 网关 | 开/关 | SW 开/关 | 备注 |
|---|---|---|---|
| Home Assistant | ✅ | ✅ | |
| Fibaro HC 3 / Z-Wave 引擎 3 | ✅ | ✅ | |
| Homey | ✅ | ✅ | |
| Homee Cube Gen 7 | ✅ | ✅ | |
| Homee Cube Gen 5 | ✅ | ⚪ | |
| Smart Things | ✅ | ✅ | 使用 Shelly Wave 边缘驱动程序 |
| Vera Ezlo | ✅ | ✅ | |
| Cozify | ✅ | ✅ |
图例
| 符号 | 状态 |
|---|---|
| ✅ | 正常工作 / 可行 |
| ⚪ | 部分支持 |
| ❌ | 无法工作 / 不可行 |
| N/T | 未测试 |
| TBD | 待完成 |
功能含义
- 开/关：响应应用界面的开/关命令
- SW 开/关：通过 SW 输入报告开/关状态变化
- 调光：响应调光命令
- SW 调光：通过 SW 输入报告调光状态
- 瓦特：主动上报瓦特数值
- 千瓦时：主动上报千瓦时数值
- 上/下：响应上下命令
- SW 上/下：通过 SW 输入报告上下状态变化
- 叶片角度：响应叶片角度命令
- SW 叶片角度：通过 SW 输入报告叶片角度变化
- D 控制：在独立模式下报告场景命令（单击/双击等）
- D 二进制：在独立模式下通过 SW 输入报告二进制开/关状态
- 传感器 #：在网关中报告的传感器；注明类型
网关指南
更多实用指南请访问 Shelly 知识库