Shelly Wave 电动百叶窗控制器
注意：原名为“Shelly Qubino Wave”的产品系列现已更名为“Shelly Wave”。此次名称变更不会影响任何设备的功能。唯一的变化是未来所有文档中将使用新名称。
设备：Wave Shutter
- 澳大利亚型号 / 订购代码：QNSH-001P10AU
- Z-Wave 产品类型 ID：0x0003
- Z-Wave 产品 ID：0x0082
- Z-Wave 制造商：Shelly Europe Ltd.
- Z-Wave 制造商 ID：0x0460
术语解释
- 设备 – 在本文档中，“设备”指本指南所涵盖的 Shelly Qubino 设备。
- 网关 – Z-Wave® 网关（也称为 Z-Wave® 控制器、主控制器、主控设备或中心主机），是 Z-Wave® 智能家居网络的中央枢纽。本文档中统一使用“网关”一词。
- S 按钮 – Z-Wave® 设备上的服务按钮，用于设备加入/移除及恢复出厂设置。本文档中统称为“S 按钮”。
- 添加/加入 – 通过网关将 Z-Wave 设备添加到网络中的过程。文中“加入”、“添加”等词语可互换使用。
- 移除/排除 – 将 Z-Wave 设备从网络中移除的过程。“排除”、“移除”等词语可互换使用。
- 百叶帘 – 指各类遮阳装置，包括百叶帘、卷帘/屏幕、卷闸、竖向百叶、窗帘、内置百叶、褶皱帘、遮阳篷等。此外，Wave Shutter 还可控制窗户电机、投影幕布或任何双向交流电机。
简要说明
该设备支持远程控制电动百叶帘、卷帘、百叶帘、遮阳篷等系统，同时可测量连接负载的功耗。
✅ 建议：仅使用配备电子式或机械式限位开关的电机。在连接设备前，请确保限位开关已正确设定。
百叶帘的手动操作
使用瞬时开关（参数 71 = 0，参数 1 = 0）
| 按钮操作 | 百叶帘静止时 | 百叶帘向上移动中 | 百叶帘向下移动中 | 百叶叶片倾斜（百叶帘） |
|---|---|---|---|---|
| 短按（< 0.5秒）↑ | 开始向上移动 | 停止移动 | 停止移动 | 无动作 |
| 短按（< 0.5秒）↓ | 开始向下移动 | 停止移动 | 停止移动 | 无动作 |
| 长按（> 0.5秒）↑ | 开始向上移动；若为百叶帘则同时倾斜叶片 | 正在移动 | 正在移动 | 叶片倾斜 → 向上移动 |
| 长按（> 0.5秒）↓ | 开始向下移动；若为百叶帘则同时倾斜叶片 | 正在移动 | 正在移动 | 叶片倾斜 → 向下移动 |
| 长按后松开 | 无动作 | 停止移动 | 停止移动 | 停止倾斜 |
使用切换开关（参数 71 = 0，参数 1 = 1）
- 按下 SW1 上侧切换开关：启动向上移动，直到释放。
- 按下 SW2 下侧切换开关：启动向下移动，直到释放。
使用百叶帘 + 瞬时开关（参数 71 = 1，参数 1 = 0）
- 短按（< 0.5秒）：触发百叶帘移动。
- 长按（> 0.5秒）：触发叶片旋转（0–100% 或 100–0%）。
| 按钮操作 | 百叶帘静止时 | 百叶帘向上移动中 | 百叶帘向下移动中 | 百叶叶片倾斜（百叶帘） |
|---|---|---|---|---|
| 短按 ↑ | 开始向上移动 | 停止移动 | 停止移动 | 停止倾斜 |
| 短按 ↓ | 开始向下移动 | 停止移动 | 停止移动 | 停止倾斜 |
| 长按 ↑ | 开始倾斜叶片 | 无动作 | 无动作 | 叶片倾斜至末端 |
| 长按 ↓ | 开始倾斜叶片 | 无动作 | 无动作 | 叶片倾斜至末端 |
| 长按后松开 | 无动作 | 停止移动 | 停止移动 | 停止倾斜 |
使用百叶帘 + 切换开关（参数 71 = 1，参数 1 = 1）
- 按下切换开关 SW1（向上）：持续向上移动直至释放。
- 按下切换开关 SW2（向下）：持续向下移动直至释放。
- 若叶片处于 100% 位置且快速按下 ↑：向上移动。
- 若叶片处于 0% 位置且快速按下 ↓：向下移动。
叶片定位
实现精确叶片定位的方法：
- 设置中间位置时，叶片先旋转至 100%，再返回目标位置。
- 向下移动过程中：达到限位或停止时，叶片先旋转至 100%，再返回之前位置。
- 向上移动过程中：停止后，叶片返回先前位置。
主要应用场景
- 住宅
- 多户住宅（公寓、联排别墅、酒店等）
- 轻型商业（小型办公室、零售店、餐厅、加油站）
- 政府/市政机构
- 大学/学院
兼容性集成
Shelly Qubino Wave 设备基于 Z-Wave 技术——全球领先的智能家居技术。
它们可与所有支持 Z-Wave 通信的 认证网关 配合使用。
我们定期测试与多种 Z-Wave 网关的兼容性，以确保完全功能正常。
简化内部电路图
设备电气接口
输入端口
- 两个螺钉端子上的开关/按钮输入
- 三个螺钉端子上的电源输入：N 和 L
输出端口
- 两个带功率测量功能的继电器输出，通过螺钉端子连接
连接方式
Z-Wave：非安全模式、S0 安全模式、S2 未认证安全模式、S2 已认证安全模式
安全特性
- 过载检测
- 过热检测
支持的负载类型
- 电阻性负载（白炽灯、加热设备）
- 容性负载（电容组、电子设备、电机启动电容）
- 带 RC 阻容吸收器的感性负载（LED 驱动器、变压器、风扇、冰箱、空调）
用户界面
S 按钮与工作模式
- 正常模式
- 设置进行中模式
- 设置模式（通过 S 按钮）
- 执行加入、排除或恢复出厂设置等操作所需。
- 时间限制：10 秒后自动返回正常模式。
- 进入方法：长按 S 按钮直至指示灯变为稳定蓝色。
- 快速短按可循环菜单（无限循环）。
- 超时：10 秒后自动返回正常状态。
S 按钮功能
- 手动将设备加入 Z-Wave 网络
- 手动将设备从 Z-Wave 网络中移除
- 恢复设备出厂设置
功能说明
自动校准
设备在校准过程中会学习限位开关的位置。
⚠️ 重要提示：为确保正常运行，必须执行自动校准！
⚠️ 关键要求：校准前，电机必须配备电子或机械限位开关，并已正确设置。
百叶帘位置校准（百叶帘模式）
设置参数 71 = 0
通过网关进行校准
- 将设备加入 Z-Wave 网络（通过加入操作）。
- 将参数 78（强制百叶帘校准）设置为
1。 - 设备执行完整循环：上 → 下 → 上 → 下至 50%。
- 检查参数 78 的值应为
2（成功）、3（未校准）或4（错误）。 - 确认黄色指示灯不闪烁。
❗ 若值为 3 或 4：请确认完整循环已完成，限位开关设置正确，接线无误。
通过推杆按钮（SW1）校准
- 将百叶帘移至顶部（最高）位置。
- 在 3 秒内连续按下 SW1 四次。
- 设备开始校准并完成 4 个循环（上、下、上、下至 50%）。
- 无时间限制，可重复操作。
通过 S 按钮校准
- 进入设置模式：短按 S 按钮。
- 按住 S 按钮直到黄色指示灯亮起（选择校准）。
- 按住 S 按钮超过 2 秒以启动校准。
- 确认黄色指示灯不闪烁。
❗ 若黄色指示灯仍在闪烁：检查完整循环、限位开关和接线是否正确。
叶片倾斜位置校准（百叶帘模式）
设置参数 71 = 1
启用百叶帘模式后，校准叶片倾斜位置：
- 先执行标准百叶帘校准（如上所述）。
- 设置参数 71 =
1（“百叶帘”）。 - 默认旋转时间为 1.5 秒。
- 过长？→ 减小参数 72。
- 过短？→ 增大参数 72。
- 重复步骤 3，直至叶片位置准确。
✅ 提示：正确的旋转时间可防止叶片旋转时带动百叶帘上下移动。
指示灯信号说明
通用规则
- 单击 S 按钮可在正常模式与设置模式之间切换。
- 常亮指示灯 = 设置模式（10 秒后自动退出）。
- 30 分钟后指示灯熄灭（除非被 S 按钮唤醒或断电重启）。
正常模式下的指示灯状态
| 条件 | 指示灯行为 |
|---|---|
| 已移除/排除 / 未校准 | 闪烁 蓝色（通电或按下 S 按钮后 10 分钟） |
| 已移除/排除 / 已校准 | 闪烁 蓝+黄（通电后 30 分钟，按下 S 按钮后 10 分钟） |
| 已添加/加入 / 未校准 | 闪烁 绿色（通电或按下 S 按钮后 10 分钟） |
| 已添加/加入 / 已校准 | 闪烁 绿+黄（通电后 30 分钟，按下 S 按钮后 10 分钟） |
设置进行中状态
| 操作 | 指示灯行为 |
|---|---|
| 恢复出厂设置并重启 | 绿色常亮（约 1 秒），随后蓝红闪烁（0.1 秒亮/灭，约 2 秒） |
| 添加/移除 | 闪烁 蓝色（模式 2） |
| 百叶帘校准 | 闪烁 黄色（模式 2） |
通过 S 按钮进入设置模式
| 菜单选项 | 指示灯行为 |
|---|---|
| 添加/移除 | 常亮 蓝色（最长 10 秒） |
| 添加/移除（过程中） | 闪烁 蓝色（模式 3） |
| 恢复出厂设置 | 常亮 红色（最长 10 秒） |
| 恢复出厂设置（过程中） | 闪烁 红色（模式 3） |
| 校准 | 常亮 黄色（最长 10 秒） |
| 校准（过程中） | 闪烁 黄色（模式 3） |
报警模式
| 报警类型 | 指示灯行为 |
|---|---|
| 检测到过流 | 红色闪烁：1 次（0.2 秒亮/灭），2 秒灭（重复） |
| 检测到过热 | 红色闪烁：2 次（0.2 秒亮/灭），2 秒灭（重复） |
| 电源故障 | 红色闪烁：3 次（0.2 秒亮/灭），2 秒灭（重复） |
指示灯闪烁模式
| 模式 | 闪烁模式 |
|---|---|
| 模式 1 | 亮 0.5 秒 / 灭 2 秒 |
| 模式 2 | 亮 0.5 秒 / 灭 0.5 秒 |
| 模式 3 | 亮 0.1 秒 / 灭 0.1 秒 |
| 模式 4 | （1–6 次：0.2 秒亮/灭）+ 灭 2 秒 |
| 模式 5 | 蓝色 0.2 秒 / 红色 0.2 秒 |
规格参数
| 特性 | 参数值 |
|---|---|
| 供电电压 | 110–240 V AC，50/60 Hz |
| 功耗 | < 0.3 W |
| 功率测量 | 支持 |
| 最大开关电压（交流） | 240 V |
| 最大开关电流（交流） | 每通道 10 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 英寸） |
| 重量 | 29 克 |
| 安装方式 | 壁挂式底座 |
| 螺钉端子扭矩 | 0.4 牛·米 / 3.5 英磅·英寸 |
| 导线截面积 | 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） |
| O1 | 电机向上输出（开路） | — | — |
| O2 | 电机向下输出（闭路） | — | — |
| SW1 | 开关/按钮向上输入（开路） | — | — |
| SW2 | 开关/按钮向下输入（闭路） | — | — |
关于 Z-Wave
加入 Z-Wave 网络（加入）
🔔 注意：成功添加或移除后，百叶帘将自动上下移动 2 秒。
🔐 安全 2（S2）：需要从设备或包装上的 DSK 标签中获取五位数字的 PIN 码。
SmartStart 加入方式
- 使用网关应用扫描设备上的二维码。
- 将设备专用密钥（DSK）添加到配置列表。
- 将设备连接电源。
- 若蓝色指示灯缓慢闪烁 → 未加入。
- 设备将在几分钟内自动加入。
- 加入过程中蓝色指示灯闪烁加快。
- 成功后绿色指示灯缓慢闪烁。
使用 S 按钮加入
- 接通电源。
- 检查蓝色指示灯是否缓慢闪烁 → 未加入。
- 在网关上启用“添加/移除”模式。
- 按住 S 按钮直至指示灯变为稳定蓝色。
- 释放后，再次按住（>2 秒）直至蓝色指示灯缓慢闪烁 → 进入学习模式。
- 加入过程中蓝色指示灯闪烁加快。
- 成功后绿色指示灯缓慢闪烁。
⏱️ 设置模式超时时间：10 秒。
使用开关/按钮加入
- 接通电源。
- 检查蓝色指示灯是否缓慢闪烁。
- 在网关上启用“添加/移除”模式。
- 在 3 秒内快速切换连接至 SW 端子的开关/按钮共 3 次 → 进入学习模式。
- 加入过程中蓝色指示灯闪烁加快。
- 成功后绿色指示灯缓慢闪烁。
📌 学习模式：允许设备接收来自网关的网络信息的状态。
从 Z-Wave 网络中移除（排除）
🛑 注意：移除后自定义参数保持不变。
使用 S 按钮排除
- 接通电源。
- 检查绿色指示灯是否缓慢闪烁 → 已加入。
- 在网关上启用“添加/移除”模式。
- 按住 S 按钮直至指示灯变为稳定蓝色。
- 释放后，再次按住（>2 秒）直至蓝色指示灯缓慢闪烁 → 进入学习模式。
- 排除过程中蓝色指示灯闪烁加快。
- 成功后蓝色指示灯闪烁变慢。
使用开关/按钮排除
- 接通电源。
- 检查绿色指示灯是否缓慢闪烁。
- 在网关上启用“添加/移除”模式。
- 在 3 秒内快速切换连接至 SW 端子的开关/按钮共 3 次 → 进入学习模式。
- 排除过程中蓝色指示灯闪烁加快。
- 成功后蓝色指示灯闪烁变慢。
恢复出厂设置
💡 恢复出厂设置后：所有自定义设置、关联关系、累计电量数据、路由信息等均恢复默认值。HOME ID 和 NODE ID 将被删除。
使用 S 按钮
- 按住 S 按钮直至指示灯变为稳定蓝色。
- 多次按下直至指示灯变为稳定红色。
- 按住（>2 秒）直至红色指示灯快速闪烁 → 开始重置。
- 指示灯变为稳定绿色（约 1 秒），然后蓝红快速闪烁（约 2 秒）。
- 成功后蓝色指示灯缓慢闪烁。
使用开关/按钮
⚠️ 仅在通电后第一分钟内有效。
- 接通电源。
- 在 3 秒内快速切换开关/按钮共 5 次。
- 指示灯变为稳定绿色（约 1 秒），然后蓝红快速闪烁（约 2 秒）。
- 成功后蓝色指示灯缓慢闪烁。
Z-Wave 安全与设备专用密钥（DSK）
- 支持最新的 安全 2（S2），采用 AES-128 加密。
- S2 提供物联网网络最高级别的安全保障。
- 需要支持 S2 的网关。
认证方式
- 通过外带方式提供 DSK 用于加入
- 与大多数实现兼容
DSK 标签与二维码
- 唯一的 DSK 印在设备侧面及包装内。
- 前五位数字加粗/下划线 → 作为 PIN 码。
- 标签上可见二维码。
🔒 切勿撕下 DSK 标签！ 请保留备用副本于包装内。
Z-Wave 参数
无法渲染
{include}– 页面未找到。
Z-Wave 命令类
COMMAND_CLASS_ZWAVEPLUS_INFO_V2COMMAND_CLASS_SWITCH_MULTILEVEL_V4COMMAND_CLASS_ASSOCIATION_3COMMAND_CLASS_MULTI_CHANNEL_ASSOCIATION_V4COMMAND_CLASS_ASSOCIATION_GRP_INFO_V3COMMAND_CLASS_NOTIFICATION_V9COMMAND_CLASS_TRANSPORT_SERVICE_V2COMMAND_CLASS_VERSION_V3COMMAND_CLASS_MANUFACTURER_SPECIFIC_V2COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1COMMAND_CLASS_INDICATOR_V4COMMAND_CLASS_POWERLEVEL_V1COMMAND_CLASS_SECURITY_V1COMMAND_CLASS_SECURITY_2_V1COMMAND_CLASS_MULTI_CHANNEL_V4COMMAND_CLASS_SUPERVISION_V2COMMAND_CLASS_FIRMWARE_UPDATE_MD_V7COMMAND_CLASS_CONFIGURATION_V4COMMAND_CLASS_SWITCH_BINARY_V2COMMAND_CLASS_APPLICATION_STATUS_V2COMMAND_CLASS_METER_V6
端点 1
- 设备类别：BASIC_TYPE_ROUTING_SLAVE, GENERIC_TYPE_SWITCH_MULTILEVEL, SPECIFIC_TYPE_CLASS_B_MOTOR_CONTROL
- 支持命令类：以上全部
端点 2
- 仅在参数 71 = 1 时激活
- 与端点 1 具有相同的设备类别和命令类
Z-Wave 通知命令类
| 通知类型 | 事件 |
|---|---|
| 电力管理 (0x08) | 检测到过载 (0x08) |
| 过热报警 (0x04) | 检测到过热 (0x02) |
🚨 一旦检测到过载或过热，将自动关闭输出并发送通知。
Z-Wave 关联设置
关联组 1 – 生命线
- 最多节点数：1（仅允许网关）
- 报告状态变化、过载、过热和电表读数。
- 触发条件：
DEVICE_RESET_LOCALLY_NOTIFICATION,SWITCH_BINARY_REPORT,NOTIFICATION_REPORT,METER_REPORT
关联组 2
- 最多节点数：9
- 在 SW1/SW2 输入时触发（百叶帘模式）
- 命令：
SWITCH_MULTILEVEL_START_LEVEL_CHANGE,SWITCH_MULTILEVEL_STOP_LEVEL_CHANGE - 推荐：使用按钮
关联组 3
- 最多节点数：9
- 在 SW1/SW2 输入时触发（百叶帘模式）
- 命令同组 2
- 推荐：使用按钮
关联组 4
- 最多节点数：16
- 向上移动时发送
BASIC_SET ON，向下移动时发送OFF - 用于触发相关设备（如灯光）
关联组 5
- 最多节点数：16
- 在顶部发送
BASIC_SET OFF，在底部发送ON - 用于状态反馈
关联组 6 和 7
- 分别与组 2 和 3 相同
- 适用于百叶帘和百叶帘模式
重要免责声明
Z-Wave 无线通信并非始终 100% 可靠。请不要仅依赖此设备用于生命攸关或高价值的应用场景。
若设备未被识别或行为异常，请手动调整设备类型，并确认网关支持 Z-Wave Plus™ 多通道设备。
故障排查
访问我们的支持门户：https://support.shelly.cloud/
与网关的兼容性
| 网关 | 上升 | 下降 | 上升按钮 | 下降按钮 | 通断 | 电能 | 叶片 | 叶片按钮 | 备注 |
|---|---|---|---|---|---|---|---|---|---|
| Home Assistant | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| Fibaro HC 3 / Z-Wave 引擎 3 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| Homey | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| Homee Cube Gen 7 | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ⚠️ | ⚠️ | *1 |
| Homee Cube Gen 5 | ✅ | ✅ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | *1, *2, *3 |
| Smart Things | ✅ | ✅ | ✅ | ❌ | ⚠️ | ⚠️ | 需使用 Shelly Wave 边缘驱动程序 *4 | ||
| Vera Ezlo | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| Cozify | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
备注
- *1：无控件可调节叶片
- *2：界面仅通过按钮报告状态；滑块无法刷新状态
- *3：状态更新仅在按下停止按钮后发生
- *4：设备已发送至目标位置，但位置未报告
图例说明
| 符号 | 含义 |
|---|---|
| ✅ | 正常工作 / 可行 |
| ⚠️ | 部分支持 |
| ❌ | 无法工作 / 不可行 |
| N/T | 未测试 |
| TBD | 待定 |
功能含义
| 功能 | 含义 |
|---|---|
| 开/关 | 响应应用程序界面上的开/关命令 |
| 按钮开/关 | 通过按钮输入报告开/关状态 |
| 调光 | 响应应用程序界面上的调光命令 |
| 按钮调光 | 通过按钮输入报告调光状态 |
| 瓦特 | 无需请求即上报瓦特值 |
| 千瓦时 | 无需请求即上报千瓦时值 |
| 上/下 | 响应应用程序界面上的上下命令 |
| 按钮上/下 | 通过按钮输入报告上下状态 |
| 叶片 | 响应应用程序界面上的叶片命令 |
| 按钮叶片 | 通过按钮输入报告叶片变化 |
| D 控制 | 脱机模式：上报场景命令 |
| D 二进制 | 脱机模式：通过按钮上报二进制开/关 |
| 传感器 # | 传感器在网关中可视化；注意类型 |
组件与 API
取决于所使用的网关。