Shelly Wave 1 Mini（欧盟版）
注意：原先称为“Shelly Qubino Wave”的产品系列，现在将更名为“Shelly Wave”。此次更名不会影响任何设备的功能。唯一的变化是未来所有文档中将使用新名称。
设备识别信息
- 设备名称：Wave 1 Mini
- 欧盟型号 / 订购代码：QMSW-0A1X8EU
- Z-Wave 产品类型 ID：0x0002
- Z-Wave 产品 ID：0x008E
- Z-Wave 制造商：Shelly Europe Ltd.
- Z-Wave 制造商 ID：0x0460
术语说明
- 设备 – 在本文档中，“设备”指本指南所讨论的 Shelly Qubino 产品。
- 网关 – 指 Z-Wave® 网关，也称为 Z-Wave® 控制器、主控制器、主控设备或中枢等，是智能家庭网络中的中央枢纽。本文档中统称“网关”。
- S 按钮 – 位于 Z-Wave® 设备上的服务按钮，用于执行多种功能，如添加（包含）、移除（排除）及恢复出厂设置。本文档中使用“S 按钮”这一术语。
简要说明
如果将 SW（SW1）配置为开关（默认设置），每次切换开关状态时，输出端口 O（O1）的状态将切换至相反状态——开、关、开，依此类推。如果在设备设置中将 SW（SW1）配置为按钮，则每次按下按钮时，输出端口 O（O1）的状态也将切换至相反状态——开、关、开，依此类推。
开关连接至输入端子 SW（SW1）
若将 SW（SW1）配置为开关（默认设置），每次切换开关位置，输出端口 O（O1）的状态即变为相反状态。
- 切换一次开关位置：将输出端口 O（O1）状态切换为相反状态，并向组 2 和组 3 中关联的设备发送命令（详见 Z-Wave 关联）。
开关记忆型连接至输入端子 SW（SW1）
若将 SW（SW1）配置为开关记忆型：
- 闭合开关记忆触点：将输出端口 O（O1）状态设为“开”，并向组 2 和组 3 中关联的设备发送命令（详见 Z-Wave 关联）。
- 断开开关记忆触点：将输出端口 O（O1）状态设为“关”，并向组 2 和组 3 中关联的设备发送命令（详见 Z-Wave 关联）。
按钮连接至输入端子 SW（SW1）
若在设备设置中将 SW（SW1）配置为按钮，则每次按下按钮，输出端口 O（O1）状态将切换为相反状态——开、关、开，依此类推。
- 单击一次：将输出端口 O（O1）状态切换为相反状态，并向组 2 和组 3 中关联的设备发送命令（详见 Z-Wave 关联）。
- 双击一次：若两次点击之间的时间间隔小于 500 毫秒，则视为双击。向组 2 和组 3 中关联的设备（调光器、遮阳帘等）发送命令（详见 Z-Wave 关联）。
- 长按：向组 3 中关联的设备发送命令（详见 Z-Wave 关联）。
- 松开：向组 3 中关联的设备发送命令（详见 Z-Wave 关联）。
主要应用场景
- 住宅
- 多住户单元（公寓、别墅、酒店等）
- 轻型商业场所（小型办公楼、小型零售店/餐厅/加油站等）
- 政府/市政机构
- 大学/学院
兼容性集成
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 秒亮 / 0.1 秒灭）约 2 秒。
- 添加/移除：在模式 2 下，LED 以蓝色闪烁。
- OTA 固件更新：在模式 2 下，LED 以蓝红交替闪烁。
- 检查电源供应（230 V AC 频率或 24 V DC 电压）：在模式 5 下，LED 以蓝红交替闪烁。
通过 S 按钮进入设置模式
- 选择添加/移除菜单：LED 持续显示蓝色，最长可达 10 秒。
- 选择添加/移除流程：在模式 3 下，LED 以蓝色闪烁。
- 选择恢复出厂设置菜单：LED 持续显示红色，最长可达 10 秒。
- 选择恢复出厂设置流程：在模式 3 下，LED 以红色闪烁。
报警模式
- 检测到过热：在模式 4 下，LED 以红色闪烁——0.2 秒亮 / 0.2 秒灭，重复序列（0.2 秒亮 / 0.2 秒灭 × 1–6 + 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 |
| 最大交流开关电流 | 8 A |
| 最大交流开关功率 | 2000 W |
| 最大直流开关电压 | 30 V |
| 最大直流开关电流 | 5 A |
| 过热保护 | 是 |
| 通信距离 | 室内最远达 40 米（131 英尺），具体取决于本地环境 |
| Z-Wave® 中继器 | 是 |
| 处理器 | Z-Wave® S800 |
| Z-Wave® 频段 | 868.4 MHz |
| 最大射频发射功率 | < 25 mW |
| 尺寸（高 × 宽 × 深） | 29 × 35 × 16 ±0.5 毫米 / 1.11 × 1.35 × 0.63 ±0.02 英寸 |
| 重量 | 19 ±1 克 / 0.65 ±0.04 盎 |
| 安装方式 | 壁装盒安装 |
| 螺丝端子最大扭矩 | 0.4 牛·米 / 3.54 磅·英寸 |
| 导线截面积 | 0.5 至 1.5 毫米² / 20 至 16 AWG |
| 导线剥线长度 | 5 至 6 毫米 / 0.20 至 0.24 英寸 |
| 外壳材料 | 塑料 |
| 颜色 | 蓝色 |
| 环境温度 | -20℃ 至 40℃ / -5℉ 至 105℉ |
| 湿度 | 30% 至 70% 相对湿度 |
| 最大海拔高度 | 2000 米 / 6562 英尺 |
基础接线图
图例说明
| 端子 | 描述 | 电缆 | 描述 |
|---|---|---|---|
| N | 零线端子 | N | 零线 |
| L | 火线端子（110–240 V AC） | L | 火线（110–240 V AC） |
| SW | 开关/按钮输入端子（控制输出端口 O） | — | — |
| I | 负载电路输入端子 | S | S 按钮 |
| O | 负载电路输出端子 | — | — |
关于 Z-Wave®
将设备添加至 Z-Wave® 网络（包含）
注意！ 若设备成功添加/移除，所有输出端口（O、O1、O2 等）将短暂通断一次。
注意！ 使用安全 2（S2）包含时，系统会提示您输入设备上标签和包装内印有的 5 位数字 PIN 码。
重要提醒：请妥善保管该 PIN 码。
SmartStart 包含
支持 SmartStart 的产品可通过网关扫描设备上的 Z-Wave® 二维码完成添加。无需额外操作，设备在上电后 10 分钟内自动完成添加。
- 通过网关应用扫描设备标签上的二维码，并将 DSK 添加至预配置列表。
- 将设备接入电源。
- 检查蓝色 LED 是否在模式 1 下闪烁 → 表示尚未添加。
- 上电后数秒内自动开始添加。
- 添加过程中，蓝色 LED 在模式 2 下闪烁。
- 成功添加后，绿色 LED 在模式 1 下闪烁。
通过 S 按钮添加
- 将设备接入电源。
- 确认蓝色 LED 在模式 1 下闪烁 → 表示尚未添加。
- 在网关上启用添加/移除模式。
- 按住 S 按钮，直至 LED 变为稳定蓝色（进入设置模式）。
- 快速释放，再按住 >2 秒，直到蓝色 LED 在模式 3 下闪烁 → 启动学习模式。
- 添加过程中，蓝色 LED 在模式 2 下闪烁。
- 成功后，绿色 LED 在模式 1 下闪烁。
注意：设置模式在 10 秒后自动超时，返回正常模式。
通过开关/按钮添加
- 将设备接入电源。
- 确认蓝色 LED 在模式 1 下闪烁 → 表示尚未添加。
- 在网关上启用添加/移除模式。
- 在 3 秒内快速切换连接至任意 SW 端子（SW、SW1 等）的开关/按钮共 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 下闪烁。
恢复出厂设置
通用说明
恢复出厂设置后，所有自定义参数（如电能计量、关联关系、路由表等）将恢复为默认值。家庭 ID 与节点 ID 将被删除。仅当网关缺失或无法使用时才建议执行。
通过 S 按钮恢复
注意：可随时操作。
- 按住 S 按钮，直到 LED 变为稳定蓝色（进入设置模式）。
- 快速连续按下 S 按钮，直至 LED 变为稳定红色。
- 按住 S 按钮超过 2 秒，直到红色 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® 成为最安全的物联网平台之一。
- 认证控制
- 通过带外（OOB）DSK 进行包含
- 与大多数实现兼容
该设备支持 S2 已认证、未认证和未加密包含。
注意：通过支持 S2 的网关添加时，必须输入设备标签和包装内标注的 5 位数字 PIN 码。DSK 标签位于设备侧面及包装内，请勿移除。请保留备份副本。
前五位数字已高亮/加下划线，便于识别。DSK 也以二维码形式呈现。
混淆机制：加入节点在无线传输前，将公钥的第 1-2 字节设置为 0（0x00）以实现混淆。
DSK 使用：可用于带外（OOB）身份验证。网关可扫描二维码，匹配通过无线接收的混淆公钥。
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
| par-NO/NC | 命令 | 输出状态 |
|---|---|---|
| NO (0) | OFF | OFF (0 V) |
| NO (0) | ON | ON (230 V) |
| NC (1) | OFF | ON (230 V) |
| NC (1) | ON | OFF (0 V) |
参数编号 25 – 输出端口 O（O1）定时器单位设置（秒或毫秒）
选择定时器分辨率：秒或毫秒。
- 大小：1 字节
- 默认值：0
- 取值：
- 0：秒
- 1：毫秒
参数编号 91 – 水浸报警
定义对水浸报警帧的响应。
- 大小：4 字节
- 默认值：0
- 取值：
- 0：无操作
- 1：打开继电器
- 2：关闭继电器
参数编号 92 – 烟雾报警
同上，适用于烟雾报警。
- 默认值：0
- 取值：0（无操作）、1（打开）、2（关闭）
参数编号 93 – 一氧化碳报警
同上，适用于一氧化碳报警。
- 默认值：0
- 取值：0（无操作）、1（打开）、2（关闭）
参数编号 94 – 高温报警
同上，适用于高温报警。
- 默认值：0
- 取值：0（无操作）、1（打开）、2（关闭）
参数编号 120 – 恢复出厂设置
将设备重置为出厂默认值，并从 Z-Wave 网络中移除。
- 大小：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（SW、SW1、SW2...）的开关/按钮 | 是 |
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（开/关）
- 根据 SW 输入状态向关联设备发送开/关命令
关联组 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 知识库。