• OTA - 空中固件更新。

• FW - Firmware

• ZAF - Z-Wave® 协议

• NIF - 节点信息帧；每次添加（包含）时发送的帧，用于向网关展示/宣传设备的能力，以便网关调整其操作能力。

• CC - 命令类（ZAF互操作性的核心）。决定数据如何发送和处理/接收的文件/流程。命令类在发送数据时包含其签名，以便识别哪个流程正在向目标设备发送数据。

• 开关 -A：切换开关或双稳态开关。

• 按钮 -A：瞬时开关或单稳态开关。

• 开关/按钮 - 它可以是开关或按钮。

• 双击 - 如果开关/按钮的第一次和第二次按压之间的延迟小于500毫秒，则解释为双击。

• 网关（GW） - A Z-Wave® 网关，也称为 Z-Wave® 控制器、Z-Wave® 主控制器、Z-Wave® 主控器或 Z-Wave® 中枢等，是作为 Z-Wave® 智能家居网络。本文档中使用术语“网关”。

• 网状网络 - 设备除了与网关通信外，还可以相互通信。设备（仅限主电源供电）可以作为中继器扩展网络。

• 长距离网络 - 设备只能与网关通信（无中继功能）。

• S按钮 - 的中心枢纽的设备。®Z-Wave® 设备上的按钮，用于多种功能，如添加（包含）、移除（排除）、恢复出厂设置以及开关电源输出（仅适用于Wave插头）。本文档中使用术语“S按钮”。

• 设备 - 本文档中使用术语“设备” 用于指代本指南中涉及的 Shelly Wave 设备。

• 终端设备 - 服务按钮位于 Z-Wave

• 节点ID - Z-Wave 终端设备是 Z-Wave 网络中的节点，但不是网关，例如开关、门锁、传感器等。节点IDZ-Wave

• 家庭ID - 是在设备加入（包含）到 Z-Wave 网络时分配给每个设备的唯一标识符，使网络能够识别并与该设备通信。家庭ID Z-Wave

• 添加/包含 - 是分配给每个 Z-Wave 网络及其内每个设备的唯一标识符。它将您的 Z-Wave 网络与其他网络区分开来，并确保您的 Z-Wave 设备只与您自己网络中的设备通信。 包含、添加、等术语用于此。

• 移除/排除 - 将 Z-Wave 设备添加到 Z-Wave 网络（网关）的过程。 排除、移除、等术语用于此。

• 恢复出厂设置 -恢复出厂设置后，所有自定义参数和已存储的数值（kWh、关联、路由等）都将恢复为默认状态。分配给设备的HOME ID和NODE ID将被删除。仅当网关丢失或无法操作时才使用此重置流程。

• 正常模式 - 指设备在正常条件下运行的状态（开关、调光等），无论是主动使用还是待机但仍通电。

• SmartStart -将 Z-Wave 设备从 Z-Wave 网络（网关）中移除的过程。

• 必须 - 必须实现

• 可选 - 如果时间/预算允许则实现

• 关联 -支持 SmartStart 的设备可通过使用支持 SmartStart 加入的网关扫描设备上的 Z-Wave 二维码，自动加入（包含）到 Z-Wave 网络中。SmartStart 设备在通电并靠近 Z-Wave 网络时会在 10 分钟内自动加入。

• 电源循环 - 设备重启/设备电源开关

• 盲点 - 指任何类型的窗户遮阳产品，如百叶窗、卷帘（屏幕）、卷帘门、垂直百叶窗、窗帘、一体式百叶窗、蜂巢帘、遮阳篷等。此外，Wave Shutter 还可以控制窗户电机、投影幕布或任何类型的双向AC电机。

• 功耗（W） - 指的是电气设备或系统消耗或使用能量的速率。其单位为瓦特（W）。

• 能耗（kWh）-指设备或系统在特定时间段内消耗的电能总量。其单位为千瓦时（kWh）。

• 订购代码 - 订购代码与零件号（PN）相同。若空间不足，使用缩写PN。PN标注在每个设备的DSK标签上。

通用规则

• 通过按住S按钮切换正常模式和设置模式。

• LED常亮 表示您处于 设置模式。进入设置模式后，10秒后自动切换回正常模式。

• 按下S按钮可唤醒LED 1秒，设备电源循环可唤醒LED 10秒。

• 模块启动期间，LED将以模式5闪烁（0.2秒蓝色亮/0.2秒红色亮），持续4-5秒。

正常模式LED状态：正常模式指设备功能稳定，可无限期保持。

已移除/排除

LED将闪烁蓝色 在模式1中，每次电源循环后30秒，按下S按钮后30秒。

已添加/包含

LED将闪烁绿色 在模式1中，每次电源循环后10秒，按下S按钮后1秒。

恢复出厂设置并重启

恢复出厂设置期间，LED将变为纯色绿色 约500毫秒，然后 蓝色LED将在模式1下闪烁。

添加/移除

添加或移除期间，LED将闪烁蓝色 在模式2中。

OTA固件更新

OTA更新期间，LED将闪烁蓝色 和 红色 在模式2中。

S按钮设置模式

选择添加/移除菜单（*长距离不支持添加）

菜单被选中时，LED将点亮蓝色，最长10秒。

按住S按钮选择添加/移除过程（*长距离不支持添加）

菜单执行时，LED将闪烁蓝色 在模式3中。

选择恢复出厂设置菜单

菜单被选中时，LED将点亮红色，最长10秒。

按住S按钮选择恢复出厂设置过程

菜单执行时，LED将闪烁红色 在模式3中。

报警模式

不适用

空气温湿度报告

设备将根据参数161（温度）和163（湿度）中定义的阈值传输温度和湿度信息。

OTA - 空中固件更新

OTA代表空中传输，指对终端设备的无线固件更新

Z-Wave

非安全、S0安全、S2未认证安全、S2认证安全

固件版本

固件版本存储在设备中，即使通过OTA更新。网关可读取固件版本。

设备序列号

设备序列号在生产测试后存储于设备中。网关可读取设备序列号。

设备零件号（PN）

设备零件号在生产测试后存储于设备中。网关可读取设备零件号。

将设备添加和移除到 Z-Wave® 网络

注意！ 将设备添加到 Z-Wave® 网络（包含）
重要：PIN码不得丢失。

SmartStart添加（包含）

如采用 Security 2（S2）方式添加（包含），系统会弹出对话框，要求您输入设备侧面和包装内 Z-Wave® DSK 标签上标注的相应 PIN 码（5 位下划线数字）。

1. 通过网关应用扫描设备标签上的二维码，将安全2（S2）设备专用密钥（DSK）添加到网关的配置列表。

2. 唤醒设备

3. 检查蓝色LED是否闪烁一次。如果是，说明该设备尚未加入Z-Wave®网络。

4. 支持 SmartStart 的产品可通过使用支持 SmartStart 加入的网关扫描设备上的 Z-Wave® 二维码，自动加入 Z-Wave® 网络。无需其他操作，SmartStart 设备在电池设备唤醒并靠近网络时会自动加入。

5. 添加过程中，蓝色LED将在模式2下闪烁。

6. 如果设备已成功加入Z-Wave®网络，绿色LED将在模式1下闪烁。

使用S按钮添加（包含）（*长距离不支持）

1. 单击并检查蓝色LED是否闪烁一次。如果是，说明该设备尚未加入Z-Wave®网络。

2. 在网关上启用添加/移除模式。

3. 要进入设置模式，长按设备上的S按钮（>0.5秒），直到LED变为纯蓝色。

4. 松开后再次长按（>2秒）设备上的S按钮，直到蓝色LED开始以模式3闪烁。松开S按钮将进入学习模式。

5. 添加过程中，蓝色LED将在模式2下闪烁。

6. 设备成功加入Z-Wave®网络后，LED将保持关闭。要确认设备已加入，再次按下S按钮；绿色LED将闪烁一次，表示已成功加入。

注意！ 在设置模式下，设备有10秒超时后自动返回正常模式。

设备唤醒后几秒钟内将自动启动加入流程，设备会自动加入 Z-Wave® 网络。

注意！ 将设备从 Z-Wave® 网络中移除（排除）

使用S按钮移除（排除）

1. 单击并检查绿色LED是否闪烁一次。如果是，说明该设备已加入Z-Wave®网络。

2. 在网关上启用添加/移除模式。

3. 要进入设置模式，长按设备上的S按钮（>0.5秒），直到LED变为纯蓝色。

4. 松开后再次长按（>2秒）设备上的S按钮，直到蓝色LED开始以模式3闪烁。松开S按钮将进入学习模式。

5. 移除过程中，蓝色LED将在模式2下闪烁。

6. 如果设备已成功从Z-Wave®网络中移除，蓝色LED将在模式1下闪烁。

注意！ 在设置模式下，设备有10秒超时后自动返回正常模式。

恢复出厂设置

恢复出厂设置概述

恢复出厂设置后，所有自定义参数和已存储的数值（kWh、关联、路由等）都将恢复为默认状态。分配给设备的HOME ID和NODE ID将被删除。仅当网关丢失或无法操作时才使用此重置流程。

使用S按钮恢复出厂设置

注意！使用S按钮随时可恢复出厂设置。

1. 要进入设置模式，长按设备上的S按钮（>0.5秒），直到LED变为纯蓝色。

2. 按下S按钮直到LED变为纯红色。

3. 长按（>2秒）设备上的S按钮，直到红色LED开始以模式3闪烁。松开S按钮将开始恢复出厂设置。

4. 恢复出厂设置期间，LED会短暂变为纯绿色。

5. 如果恢复出厂设置成功，蓝色LED将在模式1下闪烁。

通过参数和网关远程恢复出厂设置

可通过参数120设置远程恢复出厂设置。

Z-Wave® 安全与设备专用密钥（DSK）

认证控制

• 用于添加（包含）的带外DSK

• 大多数实现可使用

设备还支持安全2认证、未认证和非安全添加（包含）。

注意该设备支持最新的 Security 2（S2）功能。S2 由强大的 AES 128 加密协议处理，这意味着 S2 让 Z-Wave® 成为最安全的物联网（IoT）安全平台。要充分利用产品及其 Security 2 功能，必须使用支持 Security 2 的 Z-Wave® 网关。

密钥的前五位数字被高亮或下划线标记，帮助用户识别DSK文本中的PIN码部分。DSK还以二维码形式表示，如图所示。

! 当使用支持 Security 2（S2）的网关将设备添加到 Z-Wave® 网络时，需要输入 Z-Wave® 设备专用密钥（DSK）的 PIN 码。您可以在设备侧面的标签上找到该码，包装内也有一份副本，请勿丢失。请勿将 Z-Wave® DSK 标签从设备上移除。作为备份，请使用包装内的标签。

A：请求加入S2访问控制类或S2认证类的加入节点，在通过射频传输其密钥之前，会将其公钥的第1..2字节设置为零（0x00）以进行混淆。

DSK可用于带外（OOB）认证。

• 包含网关可使用二维码扫描设备读取加入设备的完整DSK，并与通过射频接收的混淆公钥匹配。

参数117 - 远程设备重启

此参数允许在无需物理干预的情况下重启设备。仅用于故障排除。设备重启后参数值自动恢复默认。

值大小：1字节

默认值：0

值及说明：

• 0 - 功能无效

• 1 - 远程设备重启

参数119 - 电源选择

定义设备是电池供电还是外部电源供电。

值大小：1字节

默认值：0

值及说明：

• 0 - 电池

• 1 - 外部

参数120 - 恢复出厂设置

Z-Wave® 参数

该参数为高级参数，可能隐藏在高级标签下。

值大小：4字节

默认值：0

值及说明：

• 0 - 无操作

• 1 - 恢复出厂设置

执行重置后，参数值自动设为0。

参数161 - 温度阈值

当测量差值超过定义阈值时报告温度值。

值大小：1字节

默认值：5

值及说明：

• 1 - 50（1代表0.1°C，50代表5.0°C）

参数162 - 温度偏移

通过此参数设置的值将加到或减去实际测量值，以调整温度报告。

值大小：2字节

默认值：0

值及说明：

• 最小值：-500

• 最大值：+500

注意：1=1/10° [°C/°F]。该数值会加到当前测量值上，用于传感器校准。

参数163 - 湿度阈值

当测量差值超过定义阈值时报告湿度值。

值大小：1字节

默认值：1

值及说明：

• 1 - 50（1代表1%相对湿度，50代表50%相对湿度）

参数164 - 湿度偏移

通过此参数设置的值将加到或减去实际测量值，以调整湿度报告。

值大小：2字节

默认值：0

值及说明：

• 最小值：-50

• 最大值：+50

注意：1=1%相对湿度。该值用于传感器校准，添加到当前测量值。

参数201 - 序列号1

包含设备序列号的一部分。

只读参数，无法更改。
该参数为高级参数，可能隐藏在高级标签下。

值大小：4字节

默认值：设备特定

值及说明：

· 0x00000000 - 0x7FFFFFFF

参数202 - 序列号2

包含设备序列号的一部分。

只读参数，无法更改。
该参数为高级参数，可能隐藏在高级标签下。

值大小：4字节

默认值：设备特定

值及说明：

· 0x00000000 - 0x7FFFFFFF

参数203 - 序列号3

包含设备序列号的一部分。

只读参数，无法更改。
该参数为高级参数，可能隐藏在高级标签下。

值大小：4字节

默认值：设备特定

值及说明：

· 0x00000000 - 0x7FFFFFFF

1. ASSOCIATION_V2 [S0, S2]*

2. ASSOCIATION_GRP_INFO_V3 [S0, S2]*

3. BATTERY_V3 [S0, S2]*

4. CONFIGURATION_V4 [S0, S2]*

5. DEVICE_RESET_LOCALLY_V1 [S0, S2]*

6. FIRMWARE_UPDATE_MD_V5 [S0, S2]*

7. INDICATOR_V3 [S0, S2]*

8. MANUFACTURER_SPECIFIC_V2 [S0, S2]*

9. MULTI_CHANNEL_ASSOCIATION_V3 [S0, S2]*

10. POWERLEVEL_V1 [S0, S2]*

11. SECURITY_V1

12. SECURITY_2_V1

13. SENSOR_MULTILEVEL_V11 [S0, S2]*

14. SUPERVISION_V1

15. TRANSPORT_SERVICE_V2

16. VERSION_V3 [S0, S2]*

17. WAKE_UP_V2 [S0, S2]*

18. ZWAVEPLUS_INFO_V2

电池命令类

设备使用电池命令类管理电池电量报告。

通过电池获取命令可获得电池电量百分比报告。值范围为0x00至0x64（十六进制），即0至100（十进制）。

低电量警告

当电池电量接近0时，设备会向控制器发送自动报告，值为0xFF，表示低电量警告。

注意！由于无法确定每块电池的化学性质和放电特性，且电压较低，低电量警告可能差异较大。

唤醒命令类

设备进入睡眠模式以限制电池功耗。该命令类让设备告知控制器其睡眠和唤醒状态。设备睡眠时不会接收或处理任何命令。

设备会自动唤醒，向网关报告其存活状态。默认间隔为43200秒（12小时），即设备每天自动唤醒两次。

该间隔可通过唤醒间隔设置调整，接受0至86400秒（24小时）之间的值。

警告！较低的间隔值会导致设备快速耗电。

设备唤醒时，会向网关发送唤醒通知，告知其已唤醒并准备接收命令。

设备唤醒条件：

• 按下S按钮

• 设备通电时

• 设定的唤醒间隔到达时

设备唤醒时，重置间隔计时器并发送唤醒通知给网关。此时，所有排队的命令将发送给设备。命令接收完毕后，网关会发送“唤醒无更多信息”命令，通知设备可再次进入睡眠。

警告！若设备未收到“唤醒无更多信息”命令，设备将至少保持唤醒10秒后自行进入睡眠。

支持的命令类指示器

设备支持命令类指示器V3（ID 0x50）。当设备收到指示器设置时，LED会根据收到的指示器设置闪烁。

请参阅LED信号指示章节。

不适用

Z-Wave® 关联
每组最大关联设备数为9。此值固定不可配置。
每个关联组支持最多关联9个设备（节点）。为避免网络延迟，建议每组关联设备不超过5个。“生命线组”保留给控制设备，如网关和遥控器，或能解释报告的设备。关联组1 – “生命线组”向控制设备发送其命令类通知和/或命令类报告，当相关命令类被触发时。最多允许9个节点：

根设备

根设备 - 关联组1 - 生命线

1. INDICATOR_REPORT：LED状态

2. 设备本地重置通知：请求触发时

3. 电池报告：必须定期发送以报告当前电池电量，频率由实现决定

4. 电池报告：“当节点电池电量低且用户需更换电池时，必须发送此命令。电池电量字段必须设为0xFF，表示低电量警告。”

5. 多级传感器报告：温度和湿度