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

设备识别
- 设备名称:Wave 1 Mini
- 美国型号 / 订购代码:QMSW-0A1X8US
- 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® 智能家居网络的中心枢纽。本文档中统一使用“网关”一词。
- S 按钮:位于 Z-Wave® 设备上的 Z-Wave® 服务按钮,用于执行包括添加、移除和恢复出厂设置等功能。本文档中统称为“S 按钮”。
简要说明
若将 SW(SW1)配置为开关(默认状态),每次切换会将输出端口 O(O1)的状态反转 —— 开 → 关 → 开 → 依此类推。
若将 SW(SW1)在设备设置中配置为按钮,则每次按下都会切换输出端口 O(O1)的状态 —— 开 → 关 → 开 → 依此类推。
连接到输入端子 SW(SW1)的开关
当配置为开关(默认)时:
- 单次切换:改变输出端口 O(O1)的状态并发送命令至组 2 和组 3 中的相关设备。
(参见:Z-Wave 关联)
连接到输入端子 SW(SW1)的带记忆开关
当配置为带记忆开关时:
- 触点闭合:输出端口 O(O1)开启 → 向组 2 和组 3 的设备发送命令。
- 触点断开:输出端口 O(O1)关闭 → 向组 2 和组 3 的设备发送命令。
(参见:Z-Wave 关联)
连接到输入端子 SW(SW1)的按钮
当配置为按钮时:
- 单击一次:切换输出端口 O(O1)状态;向组 2 和组 3 的相关设备发送命令。
- 双击一次(500ms 内完成):解释为双击 → 向组 2 和组 3 中关联的设备(调光器、百叶窗等)发送命令。
- 长按:向组 3 的设备发送命令。
- 松开:向组 3 的设备发送命令。
(参见:Z-Wave 关联)
主要应用场景
- 住宅
- 多户住宅(公寓、联排别墅、酒店等)
- 轻型商业(小型办公室、零售店、餐厅、加油站等)
- 政府/市政设施
- 大学/学院
集成支持
Shelly Qubino Wave 设备基于 Z-Wave——全球领先的智能家居技术。
这意味着它们可与所有经过认证且支持 Z-Wave 协议的网关兼容。
我们定期对多种 Z-Wave 网关进行兼容性测试,以确保功能完整。
简化内部原理图

设备电气接口
输入
- 1 个螺丝端子上的开关/按钮输入
- 1 个螺丝端子上的无源触点继电器输入
- 2 个螺丝端子上的电源输入:N、L
输出
- 1 个螺丝端子上的无源触点继电器输出
扩展接口
- 不适用
连接方式
- Z-Wave:非安全模式、S0 安全模式、S2 未认证安全模式、S2 认证安全模式
安全特性
过热保护
- 自动关闭继电器
- 向网关发送“通知报告”(“检测到过热”)
- LED 根据过热检测的闪烁模式作出反应
✅ 以下任意操作均可复位报警:
- 断电重启
- 短按 S 按钮
- 按下任意连接至 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 下蓝红交替闪烁
电源检查(230V AC / 24V DC)
LED 在模式 5 下蓝红交替闪烁
通过 S 按钮进入设置模式
菜单选中(添加/移除)
LED 持续显示稳定蓝色,最长可达 10 秒添加/移除过程中
LED 在模式 3 下闪烁蓝色
菜单选中(恢复出厂设置)
LED 持续显示稳定红色,最长可达 10 秒恢复出厂设置过程中
LED 在模式 3 下闪烁红色
报警模式
- 检测到过热
LED 在模式 4 下闪烁红色: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秒亮(红) |
规格参数
访问受限。权限不足,无法查看页面:DEV:技术规格
基本接线图
|
|
|
图例
| 端子 | 功能 | 电缆 | 功能 |
|---|---|---|---|
| N | 中性端子 | N | 中性线 |
| L | 火线端子(110–240 V AC) | L | 火线(110–240 VAC) |
| SW | 开关/按钮输入端子(控制输出 O) | — | — |
| I | 负载电路输入端子 | S | S 按钮 |
| O | 负载电路输出端子 | — | — |
关于 Z-Wave®
将设备添加至 Z-Wave® 网络(加入)
🔔 注意:如果设备成功添加/移除,所有输出端口(O、O1 等)将短暂地各亮灭 1 秒。
🔐 注意:对于 安全 2(S2) 加入,需输入设备或包装上 DSK 标签中的 5 位数字 PIN 码。
❗ 请勿丢失此 PIN 码。
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 下闪烁。
恢复出厂设置
通用说明
重置后:
- 所有自定义参数被清除
- 千瓦时(kWh)、关联关系、路由数据被清空
- HOME ID 与 NODE ID 被删除
- 仅当网关缺失或无法工作时才使用
通过 S 按钮
- 按住 S 按钮,直到 LED 变为稳定蓝色。
- 重复按下 S 按钮,直到 LED 变为稳定红色。
- 按住 S 按钮超过 2 秒,直到红色 LED 在 模式 3 下闪烁 → 松开 → 开始重置。
- LED:稳定绿色(约 1 秒),然后蓝红快速闪烁(约 2 秒)。
- 成功后,蓝色 LED 在 模式 1 下闪烁。
通过开关/按钮
⚠️ 仅在通电后第一分钟内有效。
- 将设备接入电源。
- 在 3 秒内将连接至 SW 端子的开关/按钮切换 5 次。
- LED:稳定绿色(约 1 秒),然后蓝红快速闪烁(约 2 秒)。
- 成功后,蓝色 LED 在 模式 1 下闪烁。
通过网关参数远程重置
使用 参数编号 120 触发远程恢复出厂设置。
Z-Wave® 安全与设备特定密钥(DSK)
该设备支持 安全 2(S2),采用 AES-128 加密,使 Z-Wave 成为最安全的物联网平台之一。
- 支持认证控制
- 支持外带式 DSK 用于加入
- 支持 S2 认证、未认证及非安全加入
🔐 通过支持 S2 的网关添加时,必须提供设备或包装上 DSK 标签中的 5 位数字 PIN。
🖼️ DSK 标签包含二维码,便于扫描。

✅ 前五位数字已高亮/加下划线,便于识别。
🛡️ 加入节点在无线传输前会将公钥的第 1-2 字节设为零以实现混淆。
🔍 网关可通过扫描二维码匹配通过射频接收到的混淆公钥。
Z-Wave® 参数
| 参数 | 描述 | 大小 | 默认值 | 取值及说明 |
|---|---|---|---|---|
| 1 – SW (SW1) 开关类型 | 定义 SW1 输入的行为 | 1 字节 | 2 | 0 = 瞬时开关 1 = 切换(触点闭合 = 开) 2 = 切换(开关状态变化时触发) |
| 17 – 断电后恢复 O (O1) | 电源故障后保存/恢复上次状态 | 1 字节 | 0 | 0 = 恢复上次状态 1 = 保持关闭 |
| 19 – 自动关机计时器 (O1) | 开启后定时自动关闭 | 2 字节 | 0 | 0 = 禁用 1–32535 = 秒或毫秒(参见参数 25) |
| 20 – 自动开机计时器 (O1) | 关闭后定时自动开启 | 2 字节 | 0 | 0 = 禁用 1–32535 = 秒或毫秒 |
| 23 – 触点类型 (NO/NC) | 继电器触点类型 | 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 – 序列号部分 | 只读序列号部分 | 每个 4 字节 | 设备特定 | 0x00000000 – 0x7FFFFFFF |
💡 参数 201–203 为只读,可能在“高级”标签下隐藏。
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 按钮、或按下任意 SW 按钮 |
Z-Wave® 关联
关联组 1 – 生命线组
- 最多 9 个节点
- 专用于控制器(网关、遥控器)
- 触发事件:
INDICATOR_REPORT:LED 状态DEVICE_RESET_LOCALLY_NOTIFICATION:请求时SWITCH_BINARY_REPORT:O(O1)状态变化NOTIFICATION_REPORT:检测到过热
关联组 2
- 最多 9 个节点
- 与 SW(SW1)输入关联
- 使用 BASIC_SET 命令类
- 触发条件:来自 SW(开关或按钮)的开/关信号
- 向关联设备发送
BASIC_SET ON或BASIC_SET 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 HC3 / Z-Wave Engine 3 | ✅ | ✅ | |
| Homey | ✅ | ✅ | |
| Homee Cube Gen 7 | ✅ | ✅ | |
| Homee Cube Gen 5 | ✅ | ⚪ | 部分支持 |
| SmartThings | ✅ | ✅ | 需使用 Shelly Wave 边缘驱动程序 |
| Vera Ezlo | ✅ | ✅ | |
| Cozify | ✅ | ✅ |
📌 图例:
- ✅ 正常工作 / 可行
- ⚪ 部分支持
- ❌ 无法工作 / 不可行
- N/T 未测试
- TBD 待完成
功能含义
| 功能 | 含义 / 测试结果 |
|---|---|
| 开/关 | 响应应用界面的开/关命令 |
| SW 开/关 | 通过 SW 输入报告开/关状态变化 |
| 调光 | 响应应用界面的调光命令 |
| SW 调光 | 通过 SW 报告调光状态变化 |
| 功率(瓦特) | 未经请求主动报告功率 |
| 千瓦时(kWh) | 未经请求主动报告用电量 |
| 上/下 | 响应应用界面的上/下命令 |
| SW 上/下 | 通过 SW 报告上/下状态变化 |
| 百叶窗角度 | 响应百叶窗角度命令 |
| SW 百叶窗角度 | 通过 SW 报告百叶窗角度变化 |
| D 控制 | 独立模式:报告单击/双击等 |
| D 二进制 | 独立模式:通过 SW 报告二进制开/关 |
| 传感器 # | 传感器报告是否可见?在备注中注明类型 |
网关指南
在 Shelly 知识库 获取有用指南