Shelly Wave 1PM Mini – 设备文档
注意：原先被称为“Shelly Qubino Wave”的产品线，现在将统一更名为“Shelly Wave”。此次更名不会影响任何设备的功能。唯一的变化是在未来所有文档中使用新名称。
设备识别
- 设备名称：Shelly Wave 1PM Mini
- 美国型号 / 订购代码：QMSW-0A1P8US
- Z-Wave 产品类型 ID：0x0002
- Z-Wave 产品 ID：0x008F
- Z-Wave 制造商：Shelly Europe Ltd.
- Z-Wave 制造商 ID：0x0460
术语说明
- 设备 – 在本文档中，“设备”指本指南所描述的 Shelly Wave 设备。
- 网关 – 一个 Z-Wave® 网关（也称为控制器、主控设备或中枢），作为 Z-Wave® 智能家居网络的中央枢纽。本文档中均使用“网关”一词。
- S 按钮 – 位于 Z-Wave® 设备上的服务按钮（Service Button）。用于执行包含/排除操作以及恢复出厂设置等任务。本文档中使用“S 按钮”这一术语。
简要描述
Shelly Wave 1PM Mini 是一款紧凑型智能开关，具备电量测量功能。它可控制一台额定电流最高达 8 A AC（例如灯泡、吊扇、红外加热器）的电器设备的通断状态。支持开关（默认模式）和按钮两种工作方式。
连接至输入端子 SW（SW1）的开关 / 按钮
连接至输入端子 SW（SW1）的开关
若配置为开关（默认）模式，每次切换都会改变输出端口 O（O1）的状态：
- 单次切换：切换输出状态（开 ↔ 关），并向组 2 和组 3 中的相关设备发送命令（参见 Z-Wave 关联）。
连接至输入端子 SW（SW1）的带记忆开关
当配置为带记忆开关时：
- 闭合触点：输出端口 O（O1）开启，并向组 2 和组 3 中的设备发送命令。
- 断开触点：输出端口 O（O1）关闭，并向组 2 和组 3 中的设备发送命令。
连接至输入端子 SW（SW1）的按钮
若配置为按钮模式：
- 单击一次：切换输出端口 O（O1）状态（开 ↔ 关），并向组 2 和组 3 发送命令。
- 双击一次（在 500 毫秒内完成）：解释为双击 → 向组 2 和组 3 中的调光器/遮阳帘设备发送命令。
- 长按：向组 3 发送命令。
- 松开：向组 3 发送命令。
主要应用场景
- 住宅
- 多户单元（公寓、联排别墅、酒店等）
- 轻型商业场所（小型办公室、零售店、餐厅、加油站等）
- 政府/市政设施
- 大学/学院
兼容集成
Shelly Wave 设备基于 Z-Wave 技术，该技术是全球领先的智能家居解决方案。
这意味着它们可与所有通过 认证 的、支持 Z-Wave 协议的网关兼容。
我们定期测试与各类 Z-Wave 网关的兼容性，以确保功能完整。
简化内部电路图
设备电气接口
输入端口
- 1 个螺丝端子连接的开关/按钮输入端口
- 2 个螺丝端子连接的电源输入端口：N（零线）、L（火线）
输出端口
- 1 个带有电量测量功能的继电器输出端口（螺丝端子）
扩展接口
- 不适用
连接方式
- Z-Wave：非安全模式、S0 安全、S2 未认证安全、S2 已认证安全
安全特性
过热保护
- 自动断开继电器
- 向网关发送“通知报告”（“检测到过热”）
- LED 按照相应模式闪烁（请参阅过热闪烁模式）
复位触发条件：重启电源、短按 S 按钮，或按下任意连接至 SW 接线端的开关/按钮。
✅ 注意：过热保护始终启用，无法禁用。
详情请参见章节 检测到过热的通知。
过流保护
- 若电流持续超过 16A + 10%（>17.6A）超过 5 秒：
- 断开继电器
- 发送“检测到过流”通知
- LED 响应相应状态
复位触发条件：重启电源、短按 S 按钮，或按下任意连接至 SW 接线端的开关/按钮。
✅ 注意：过流保护始终启用，无法禁用。
详情请参见 检测到过流的通知。
过压保护
- 适用于标准 230 V AC 供电。
- 若电压持续超过 278 V AC（240V + 15%）超过 5 秒：
- 断开继电器
- 发送“检测到过压”通知
- LED 按照相应模式闪烁
复位触发条件：重启电源、短按 S 按钮，或按下任意连接至 SW 接线端的开关/按钮。
✅ 注意：过压保护始终启用，无法禁用。
详情请参见 检测到过压的通知。
支持的负载类型
- 阻性负载（白炽灯、加热设备）
- 容性负载（电容组、电子设备、电机启动电容）
- 带 RC 阻容吸收器的感性负载（LED 驱动器、变压器、风扇、冰箱、空调）
用户界面
S 按钮与工作模式
- 正常模式
- 设置进行中模式
- 设置模式（需按 S 按钮）
- 用于包含、排除、恢复出厂设置等操作。
- 超时时间：10 秒 → 自动返回正常模式。
- 进入设置模式：
- 快速按住 S 按钮，直到 LED 变为稳定的蓝色。
- 多次快速点击可循环浏览菜单（无限循环）。
- 菜单状态在 10 秒后自动失效。
S 按钮功能
- 手动将设备添加至 Z-Wave 网络（包含）
- 手动从 Z-Wave 网络移除设备（排除）
- 对设备执行恢复出厂设置
LED 信号指示
正常模式
| 状态 | LED 表现 |
|---|---|
| 已移除/排除 | 上电或按下 S 按钮后，持续 10 分钟内以 蓝色 闪烁（模式 1） |
| 已添加/包含 | 上电或按下 S 按钮后，持续 10 分钟内以 绿色 闪烁（模式 1） |
设置进行中
| 操作 | LED 表现 |
|---|---|
| 恢复出厂并重启 | 绿色常亮约 1 秒，随后蓝红快速交替闪烁（0.1 秒亮/灭）约 2 秒 |
| 添加/移除 | 以 蓝色 闪烁（模式 2） |
| 固件 OTA 升级 | 以 蓝红交替 闪烁（模式 2） |
| 电源检查（230V AC / 24V DC） | 以 蓝红交替 闪烁（模式 5） |
设置模式（已选择 S 按钮）
| 操作 | LED 表现 |
|---|---|
| 添加/移除菜单已选中 | 蓝色 常亮（最长 10 秒） |
| 添加/移除正在执行 | 以 蓝色 闪烁（模式 3） |
| 恢复出厂菜单已选中 | 红色 常亮（最长 10 秒） |
| 恢复出厂正在执行 | 以 红色 闪烁（模式 3） |
报警模式
| 报警类型 | LED 闪烁模式 |
|---|---|
| 检测到过流 | 1 次：0.2 秒亮 / 0.2 秒灭 / 2 秒灭 → 循环 |
| 检测到过热 | 2 次：0.2 秒亮 / 0.2 秒灭 → 循环（2 次脉冲） |
| 电源故障 | 3 次：0.2 秒亮 / 0.2 秒灭 → 循环（3 次脉冲） |
📌 请参阅下方“LED 闪烁模式表”获取视觉参考。
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 V AC） |
| SW | 开关/按钮输入端子（控制输出 O） | — | — |
| I | 负载电路输入端子 | S | S 按钮 |
| O | 负载电路输出端子 | — | — |
关于 Z-Wave®
将设备添加至 Z-Wave® 网络（包含）
⚠️ 注意：如果设备成功添加或移除，所有输出端口（O、O1 等）会短暂地打开或关闭。
🔑 重要提示：对于 安全 2 (S2) 包含，请输入设备或包装上的 DSK 标签中的 5 位数字 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 次。
- 添加过程中，蓝色 LED 在模式 2 下闪烁。
- 若成功，绿色 LED 在模式 1 下闪烁。
💡 学习模式：允许设备接收来自网关的网络信息的状态。
从 Z-Wave® 网络中移除设备（排除）
⚠️ 注意：自定义设置将保留；仅网络关联被移除。
使用 S 按钮排除
- 将设备接入电源。
- 确认绿色 LED 在模式 1 下闪烁 → 表示设备已添加。
- 在网关上启用添加/移除模式。
- 按住 S 按钮，直到 LED 变为稳定蓝色。
- 松开，然后再次按住（>2 秒），直到 LED 在模式 3 下闪烁 → 松开 → 学习模式启动。
- 排除过程中，蓝色 LED 在模式 2 下闪烁。
- 若成功，蓝色 LED 在模式 1 下闪烁。
使用开关/按钮排除
- 将设备接入电源。
- 确认绿色 LED 在模式 1 下闪烁。
- 在网关上启用添加/移除模式。
- 在 3 秒内快速切换连接至 SW 端子的开关/按钮共 3 次。
- 排除过程中，蓝色 LED 在模式 2 下闪烁。
- 若成功，蓝色 LED 在模式 1 下闪烁。
恢复出厂设置
通用说明
恢复出厂设置后：
- 所有自定义参数（如总用电量 kWh、关联关系、路由等）将恢复为默认值
- HOME ID 与 NODE ID 被删除
- 仅当网关缺失或无法使用时才应执行
使用 S 按钮（随时可用）
- 按住 S 按钮，直到 LED 变为稳定蓝色。
- 快速多次按下 S 按钮，直到 LED 变为稳定红色。
- 按住 S 按钮（>2 秒），直到红色 LED 在模式 3 下闪烁 → 松开 → 开始重置。
- 重置过程中：绿色常亮约 1 秒，随后蓝红在模式 3 下快速闪烁约 2 秒。
- 蓝色 LED 在模式 1 下闪烁 → 表示成功。
使用开关/按钮（仅限上电后前一分钟内）
- 将设备接入电源。
- 在 3 秒内快速切换开关/按钮共 5 次。
- 重置过程中：绿色常亮约 1 秒，随后蓝红在模式 3 下快速闪烁约 2 秒。
- 蓝色 LED 在模式 1 下闪烁 → 表示成功。
通过网关远程触发（参数编号 120）
将参数 120 设置为 1 → 触发恢复出厂设置。
Z-Wave® 安全性与设备特定密钥（DSK）
- 支持 安全 2 (S2)，采用 AES-128 加密。
- 需要 支持 S2 的网关才能实现完整安全性。
- 支持通过外带方式（带外）使用 DSK 实现 已认证控制。
🔐 需要输入 PIN 码：请输入设备侧标或包装上打印的 DSK 的前 5 位数字。
🖼️ DSK 标签包含可扫描的二维码。
📎 混淆处理：通过无线传输的公钥，其字节 1–2 被设为 0（0x00），以增强安全性。
🔍 认证机制：网关可扫描二维码，并与通过无线接收的混淆公钥进行匹配。
Z-Wave® 参数
| 参数编号 | 名称 | 大小 | 默认值 | 取值及说明 |
|---|---|---|---|---|
| 1 | SW (SW1) 开关类型 | 1 字节 | 2 | 0 = 瞬时开关 1 = 切换开关（闭合=开） 2 = 切换开关（状态变化） |
| 17 | 断电后恢复状态 | 1 字节 | 0 | 0 = 恢复上次状态 1 = 保持关闭 |
| 19 | 自动关机定时器 (O1) | 2 字节 | 0 | 0 = 禁用 1–32535 = 秒或毫秒（参见参数 25） |
| 20 | 自动开机定时器 (O1) | 2 字节 | 0 | 0 = 禁用 1–32535 = 秒或毫秒（参见参数 25） |
| 23 | O (O1) 触点类型 (NO/NC) | 1 字节 | 0 | 0 = NO（常开） 1 = NC（常闭） |
| 25 | 定时器单位 (秒/毫秒) | 1 字节 | 0 | 0 = 秒 1 = 毫秒 |
| 36 | 功率报告变化百分比 (%) | 1 字节 | 50 | 0 = 禁用 1–100 = 百分比阈值 |
| 39 | 报告间隔最小时间 (O1) | 1 字节 | 30 | 0 = 禁用 1–120 秒 |
| 91 | 水浸报警响应 | 4 字节 | 0 | 0 = 无动作 1 = 打开继电器 2 = 关闭继电器 |
| 92 | 烟雾报警响应 | 4 字节 | 0 | 同上 |
| 93 | 一氧化碳报警响应 | 4 字节 | 0 | 同上 |
| 94 | 高温报警响应 | 4 字节 | 0 | 同上 |
| 120 | 恢复出厂设置 | 1 字节 | 0 | 0 = 不重置 1 = 执行重置 |
| 201–203 | 序列号部分 | 4 字节 | 设备特定 | 只读，隐藏于高级标签下 |
⚠️ 注意：参数 39 若小于 30 秒，可能导致网络拥塞。
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]METER_V6[S0, S2]MULTI_CHANNEL_ASSOCIATION_V3[S0, S2]NOTIFICATION_V8[S0, S2]POWERLEVEL_V1[S0, S2]SECURITY_V1SECURITY_2_V1SUPERVISION_V1TRANSPORT_SERVICE_V2VERSION_V3[S0, S2]ZWAVEPLUS_INFO_V2
[S2]*= 安全 2 命令类
Z-Wave® 通知命令类
检测到过热
- 类型：高温报警（0x04）
- 事件：状态（0x02）
- 版本：V2
- LED：参见信号指示表
- 动作：继电器关闭，发送通知
- 恢复：重启电源、按下 S 按钮或按下 SW 输入
检测到过流（O1）
- 类型：电力管理（0x08）
- 事件：状态（0x06）
- 版本：V3
- LED：参见信号指示表
- 动作：继电器关闭，发送通知
- 恢复：同上
交流主电源断开
- 类型：电力管理（0x08）
- 事件：状态（0x02）
- 版本：V2
- LED：参见信号指示表
- 动作：继电器关闭，发送通知
- 恢复：同上
检测到过压
- 类型：电力管理（0x08）
- 事件：状态（0x07）
- 版本：V3
- LED：参见信号指示表
- 动作：继电器关闭，发送通知
- 恢复：同上
Z-Wave® 关联设置
组 1 – 生命线（Lifeline）
- 最多 9 个节点
- 发送给控制设备（网关、遥控器）
- 触发条件：
INDICATOR_REPORT：LED 状态DEVICE_RESET_LOCALLY_NOTIFICATIONSWITCH_BINARY_REPORT：O1 状态变化NOTIFICATION_REPORT：过热、过流、过压、主电源断开METER_REPORT：功耗数据（基于参数 36 和 39）
组 2
- 最多 9 个节点
- 由 SW（SW1）触发
- 使用
BASIC_SET（开/关）控制关联设备
组 3
- 最多 9 个节点
- 由 SW（SW1）触发
- 推荐用于按钮
- 使用：
SWITCH_MULTILEVEL_START_LEVEL_CHANGESWITCH_MULTILEVEL_STOP_LEVEL_CHANGE
⚠️ 建议每组不超过 5 个设备，以避免网络延迟。
Z-Wave® 重要免责声明
Z-Wave® 通信可能无法 100% 可靠。请勿仅依赖此设备用于生命攸关或高价值应用。若设备未被识别，请手动调整设备类型，并确认网关支持 Z-Wave Plus™ 多级设备。
故障排查
如需帮助，请访问：Shelly 支持门户
兼容性
| 网关 | 开关/关闭 | SW 开关/关闭 | 备注 |
|---|---|---|---|
| Home Assistant | ✅ | ✅ | |
| Fibaro HC3 / Z-Wave Engine 3 | ✅ | ✅ | |
| Homey | ✅ | ✅ | |
| Homee Cube Gen 7 | ✅ | ✅ | |
| Homee Cube Gen 5 | ✅ | ⚪ | 部分支持 |
| SmartThings | ✅ | ✅ | 需 Shelly Wave 边缘驱动 |
| Vera Ezlo | ✅ | ✅ | |
| Cozify | ✅ | ✅ |
📝 图例：
- ✅ 正常工作 / 可行
- ⚪ 无法工作 / 不可行
- P 部分支持
- N/T 未经测试
- TBD 待完成
功能含义
| 功能 | 含义 |
|---|---|
| 开/关 | 响应应用程序界面的开/关命令 |
| SW 开/关 | 通过 SW 输入报告开/关状态变化 |
| 调光 | 响应应用程序界面的调光命令 |
| SW 调光 | 通过 SW 报告调光状态 |
| 瓦特 | 无需请求即可报告功率消耗 |
| 千瓦时 | 无需请求即可报告用电量 |
| 上/下 | 响应应用程序界面的上/下命令 |
| SW 上/下 | 通过 SW 报告上/下状态变化 |
| 百叶窗角度 | 响应百叶窗角度命令 |
| SW 百叶窗角度 | 通过 SW 报告百叶窗角度变化 |
| D 控制 | 离散模式：报告场景事件（单击、双击等） |
| D 二进制 | 离散模式：通过 SW 报告二进制开/关状态 |
| 传感器 # | 网关中显示传感器；注明类型 |
网关使用指南
在 Shelly 知识库 中查找实用指南。