Zigbee 设备

这是将 Zigbee 设备添加到您的 CUBE 设置的完整指南。

1. 安装 Zigbee 适配器

如果在安装 CUBE 时已按可选步骤配置 Zigbee，可跳转到 第 2 步 以将您的加密狗初始化为 Zigbee 网络协调器。

在添加 Zigbee 设备之前，您需要一个 Zigbee 适配器，通常为 USB 加密狗。将 Zigbee 适配器插入运行 CUBE OS 的设备的 USB 端口。

虚拟机用户：插入 Zigbee 适配器后，将其添加到虚拟机设置并重启 CUBE。详细步骤可参见虚拟机 安装指南.

1.1 兼容适配器

CUBE 与来自不同厂商的多种 Zigbee 适配器兼容。目前支持 EZSP、Deconz、Zstack 和 Zigate 等协议栈。尽管任何支持这些协议栈的适配器都可使用，但推荐以下几款：

1. SONOFF ZBDongle-MAX

2. SONOFF ZBDongle-PMG24

3. SONOFF ZBDongle-LMG21

4. SONOFF ZBDongle-E

5. SONOF ZBDongle-P

6. SMLIGHT SLZB-06 / 06M

7. SkyConnect Zigbee（EZSP）

其他列出项 由开发者 @darkxst 提供

2. 初始化 Zigbee

1

要添加设备，请在设备主页点击“添加设备”按钮。

2

开始配对，并在弹出窗口中选择“继续设置”以自动检测已插入的 Zigbee 适配器。

适配器自动被发现后，从列表中选择您要使用的 Zigbee 适配器并点击“确认”以完成配置。

3

如果未检测到您的 Zigbee 适配器，您可以手动添加，输入必要的信息：

• 串口路径：在设置页面的“所有硬件”部分查看已插入 Zigbee 适配器的串口路径。

• 协议栈类型：当前支持 EZSP、Deconz、ZStack 和 Zigate。请在适配器购买页面查看对应的协议栈类型。

• 端口速率：可选，不适用于所有 Zigbee 适配器。

• 数据流：可选，不适用于所有 Zigbee 适配器。

4

点击确认提交配置。如果成功，您即可添加 Zigbee 设备。若失败，请查看具体错误信息。

由于一个 Zigbee 网络只能有一套适配器配置，因此不支持多套配置。如果已配置的适配器被移除后再插回，将尝试自动恢复，无需重新配置。

3. 添加 Zigbee 设备

1

配置完成后，在添加设备页面点击“开始配对”以自动添加处于配对模式的 Zigbee 设备。

如果未找到您的 Zigbee 设备，请确保设备处于网络配置模式并检查周围是否有过多的射频干扰。

2

被发现的 Zigbee 设备将被添加到您的 CUBE OS 中，随后可分配房间或编辑名称。

可添加的 Zigbee 设备总数受适配器硬件和固件的限制。

在某些情况下，您需要添加额外的路由设备（例如智能插座、灯具、信号中继器）来添加更多电池供电的设备，如传感器。

4. 潜在兼容性

CUBE 与 数百种 Zigbee 设备兼容。然而，由于设备复杂且类型繁多，不同厂商的产品之间存在显著差异。这意味着无法保证与所有设备兼容，但会通过迭代不断改进。

请前往查看 https://cube-web.ewelink.cc/ 以检查兼容性。