# Устройства Zigbee

## **1. Установите Zigbee-адаптеры**

Если вы выполнили необязательные шаги для Zigbee при установке CUBE, вы можете перейти к [Шаг 2](#id-2.-initialize-zigbee) чтобы инициализировать ваш донгл как координатор сети Zigbee. 

Перед добавлением Zigbee-устройства вам нужен Zigbee-адаптер, обычно USB-донгл. Вставьте Zigbee-адаптер в USB-порт устройства, на котором работает CUBE OS.

**Для пользователей виртуальной машины**: После вставки Zigbee-адаптера добавьте его в настройки виртуальной машины и перезапустите CUBE. Подробные шаги можно найти в руководстве по установке виртуальной машины [руководстве по установке](https://cube.ewelink.cc/cube-os-ru/nachalo-raboty/quickstart/virtualnaya-mashina).

### **1.1 Совместимые адаптеры**

CUBE совместим с различными Zigbee-адаптерами от разных производителей. В настоящее время он поддерживает стек протоколов, такие как EZSP, Deconz, ZStack и Zigate. Хотя можно использовать любой адаптер, поддерживающий эти стеки протоколов, рекомендуется следующий список:

## **2. Инициализация Zigbee**

{% stepper %}
{% step %}
Чтобы добавить устройство, нажмите кнопку «Добавить устройство» на главной странице устройства.

<img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FdrmISytAApUiRPfkcSKr%2FScreenshot%202024-11-27%20at%2016.27.26.png?alt=media&#x26;token=cfb4a774-b7d2-4a1c-8343-b675cf14ff37" alt="" data-size="original">
{% endstep %}

{% step %}
Начните сопряжение и выберите «Продолжить настройку» в всплывающем окне, чтобы автоматически обнаружить вставленный Zigbee-адаптер.&#x20;

<img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fpei07hfzpgvfRQRAAZKY%2FScreenshot%202024-11-15%20at%2018.10.39.png?alt=media&#x26;token=01f31b8c-c60f-4e53-a6d3-60cca7bfbb44" alt="" data-size="original">

После автоматического обнаружения адаптера выберите в списке Zigbee-адаптер, который вы хотите использовать, и нажмите «Подтвердить», чтобы завершить настройку.

<img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FZrl4qny62yziSbwXvxcM%2FScreenshot%202024-11-15%20at%2018.10.45.png?alt=media&#x26;token=185620a4-750d-45b7-88f8-a1344ee125d8" alt="" data-size="original">
{% endstep %}

{% step %}
Если ваш Zigbee-адаптер не обнаружен, вы можете добавить его вручную, введя необходимую информацию:

<img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FKnWEVsVaFJXSSKMSFZOi%2FScreenshot%202024-11-27%20at%2016.37.09.png?alt=media&#x26;token=cc946496-6b43-444f-a523-af57edd56779" alt="" data-size="original">

* **Путь к последовательному порту**: Проверьте раздел «Все устройства» на странице настроек, чтобы узнать путь к последовательному порту вставленного Zigbee-адаптера.

<img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FpVaENyLH4CszLMlPdb29%2FScreenshot%202024-11-27%20at%2016.38.47.png?alt=media&#x26;token=607a3e56-fcac-46cc-afea-dc1b1f7b58ea" alt="" data-size="original">

* **Тип стека протоколов**: В настоящее время поддерживаются EZSP, Deconz, ZStack и Zigate. Проверьте страницу покупки адаптера для получения информации о соответствующем типе стека протоколов.
* **Скорость порта**: Необязательно, не применяется ко всем Zigbee-адаптерам.
* **Поток данных**: Необязательно, не применяется ко всем Zigbee-адаптерам.
  {% endstep %}

{% step %}
Отправьте конфигурацию, нажав «Подтвердить». В случае успеха вы сможете добавлять Zigbee-устройства. В случае неудачи проверьте конкретное сообщение об ошибке.

<img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fpr3hIv1y4QGmS8HbfD9U%2FScreenshot%202024-11-18%20at%2016.38.47.png?alt=media&#x26;token=836f18b5-0939-4d44-9bf8-750becece0d9" alt="" data-size="original">
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Поскольку в сети Zigbee может быть только одна конфигурация адаптера, поддержка нескольких настроек не предусмотрена. Если настроенный адаптер будет удалён и затем вставлен снова, он попытается автоматически восстановиться без необходимости повторной настройки.
{% endhint %}

## **3. Добавление Zigbee-устройств**

{% stepper %}
{% step %}
После настройки на странице добавления устройств нажмите «Начать сопряжение», чтобы автоматически добавить Zigbee-устройства в режиме сопряжения.

{% hint style="info" %}
Если ваше Zigbee-устройство не найдено, убедитесь, что устройство находится в режиме конфигурации сети, и проверьте наличие сильных радиопомех поблизости.
{% endhint %}

<img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FhumPj2kUuggjxHsDnoj6%2FScreenshot%202024-11-27%20at%2016.42.05.png?alt=media&#x26;token=52b24ea2-ccdc-4070-9603-59d578cec024" alt="" data-size="original">
{% endstep %}

{% step %}
Обнаруженные Zigbee-устройства будут добавлены в вашу CUBE OS, после чего им можно будет назначить комнату или изменить имя.

<img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FwGmUkBGsYaKSimVBqYZA%2FScreenshot%202024-11-15%20at%2018.11.36.png?alt=media&#x26;token=9d0ab73f-ac71-4c35-b96d-b073e8ef3b7d" alt="" data-size="original">
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Общее число добавляемых Zigbee-устройств ограничено и зависит от аппаратного обеспечения и прошивки адаптера.&#x20;

В некоторых случаях вам потребуется добавить дополнительные маршрутизирующие устройства (например, умные розетки, лампы, ретрансляторы сигнала), чтобы добавить больше устройств на батарейном питании, таких как датчики.
{% endhint %}

## 4. Возможная совместимость

CUBE **совместим со стами Zigbee-устройств**. Однако существуют значительные различия между продуктами разных производителей из-за сложности и широкого ассортимента устройств. Это означает, что совместимость со всеми устройствами не может быть гарантирована, но она будет улучшаться итеративно.

Пожалуйста, обратитесь к <https://cube-web.ewelink.cc/> чтобы проверить совместимость.