# Zigbee 设备
## **1. 安装 Zigbee 适配器**
如果您在安装 CUBE 时已按照可选步骤设置了 Zigbee，可以跳到 [第 2 步](#id-2.-initialize-zigbee) 以将您的加密狗初始化为 Zigbee 网络协调器。
在添加 Zigbee 设备之前，您需要一个 Zigbee 适配器，通常为 USB 加密狗。将 Zigbee 适配器插入运行 CUBE OS 的设备的 USB 端口。
**针对虚拟机用户**：插入 Zigbee 适配器后，将其添加到虚拟机设置并重启 CUBE。详细步骤请参阅虚拟机 [安装指南](https://cube.ewelink.cc/english-zh/ru-men-zhi-nan/quickstart/xu-ni-ji).
### **1.1 兼容的适配器**
CUBE 与来自不同厂商的多种 Zigbee 适配器兼容。目前支持如 EZSP、Deconz、Zstack 和 Zigate 等协议栈。虽然任何支持这些协议栈的适配器均可使用，但推荐如下：
## **2. 初始化 Zigbee**
{% stepper %}
{% step %}
要添加设备，请在设备主页上点击“添加设备”按钮。
{% endstep %}
{% step %}
开始配对，并在弹出窗口中选择“继续设置”以自动检测您插入的 Zigbee 适配器。
适配器被自动发现后，从列表中选择您希望使用的 Zigbee 适配器并点击“确认”以完成配置。
{% endstep %}
{% step %}
如果未检测到您的 Zigbee 适配器，您可以通过输入必要信息手动添加：
* **串口路径**：在设置页面的“所有硬件”部分查看所插入 Zigbee 适配器的串口路径。
* **协议栈类型**：目前支持 EZSP、Deconz、ZStack 和 Zigate。请在适配器的购买页面查看对应的协议栈类型。
* **端口速率**：可选，并非适用于所有 Zigbee 适配器。
* **数据流**：可选，并非适用于所有 Zigbee 适配器。
{% endstep %}
{% step %}
点击确认提交配置。如果成功，您即可添加 Zigbee 设备。如失败，请查看具体错误信息。
{% endstep %}
{% endstepper %}
{% hint style="info" %}
由于每个 Zigbee 网络只能有一个适配器配置，因此不支持多个设置。如果已配置的适配器被移除后重新插入，它会尝试自动恢复，无需重新配置。
{% endhint %}
## **3. 添加 Zigbee 设备**
{% stepper %}
{% step %}
配置完成后，在添加设备页面点击“开始配对”以自动添加处于配对模式的 Zigbee 设备。
{% hint style="info" %}
如果未找到您的 Zigbee 设备，请确保设备处于网络配置模式，并检查周围是否存在过多的射频干扰。
{% endhint %}
{% endstep %}
{% step %}
被发现的 Zigbee 设备随后将被添加到您的 CUBE OS，您可以为其分配房间或编辑名称。
{% endstep %}
{% endstepper %}
{% hint style="info" %}
可添加的 Zigbee 设备总数受限，取决于适配器的硬件和固件。
在某些情况下，您需要添加额外的路由器设备（例如智能插座、灯具、信号中继器）来添加更多的电池供电设备（如传感器）。
{% endhint %}
## 4. 潜在兼容性
CUBE 与 **数百种 Zigbee 设备兼容**。然而，由于设备种类繁多且复杂，不同厂商的产品之间存在较大差异。这意味着无法保证与所有设备完全兼容，但会通过迭代不断改进。
请前往查看 以检查兼容性。