# Urządzenia Zigbee

## **1. Zainstaluj adaptery Zigbee**

Jeśli podczas instalacji CUBE postępowałeś zgodnie z opcjonalnymi krokami dotyczącymi Zigbee, możesz przejść do [Kroku 2](#id-2.-initialize-zigbee) aby zainicjalizować dongle jako koordynator sieci Zigbee. 

Przed dodaniem urządzenia Zigbee potrzebny jest adapter Zigbee, zazwyczaj dongle USB. Włóż adapter Zigbee do portu USB urządzenia z uruchomionym systemem CUBE OS.

**Dla użytkowników maszyn wirtualnych**: Po włożeniu adaptera Zigbee dodaj go w ustawieniach maszyny wirtualnej i zrestartuj CUBE. Szczegółowe kroki można znaleźć w [instrukcji instalacji](https://cube.ewelink.cc/english-pl/rozpoczecie/quickstart/maszyna-wirtualna).

### **1.1 Kompatybilne adaptery**

CUBE jest kompatybilny z różnymi adapterami Zigbee od różnych producentów. Obecnie obsługuje stosy protokołów takie jak EZSP, Deconz, Zstack i Zigate. Chociaż można używać dowolnego adaptera obsługującego te stosy protokołów, zalecane są następujące:

## **2. Zainicjalizuj Zigbee**

{% stepper %}
{% step %}
Aby dodać urządzenie, kliknij przycisk „Dodaj urządzenie” na stronie głównej urządzenia.

<img src="https://2450271282-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 %}
Rozpocznij parowanie i w wyskakującym oknie wybierz „Kontynuuj konfigurację”, aby automatycznie wykryć włożony adapter Zigbee.&#x20;

<img src="https://2450271282-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">

Po automatycznym wykryciu adaptera wybierz z listy adapter Zigbee, którego chcesz użyć, i kliknij „Potwierdź”, aby zakończyć konfigurację.

<img src="https://2450271282-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 %}
Jeśli adapter Zigbee nie zostanie wykryty, możesz dodać go ręcznie, wprowadzając niezbędne informacje:

<img src="https://2450271282-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">

* **Ścieżka szeregowa**: Sprawdź sekcję „Wszystkie urządzenia” na stronie ustawień, aby znaleźć ścieżkę portu szeregowego włożonego adaptera Zigbee.

<img src="https://2450271282-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">

* **Typ stosu protokołu**: Obecnie obsługiwane są EZSP, Deconz, ZStack i Zigate. Sprawdź stronę zakupu adaptera, aby poznać odpowiadający mu typ stosu protokołu.
* **Prędkość portu**: Opcjonalne, nie dotyczy wszystkich adapterów Zigbee.
* **Przepływ danych**: Opcjonalne, nie dotyczy wszystkich adapterów Zigbee.
  {% endstep %}

{% step %}
Zatwierdź konfigurację, klikając potwierdź. Jeśli operacja zakończy się sukcesem, możesz dodać urządzenia Zigbee. W przypadku niepowodzenia sprawdź szczegółowy komunikat o błędzie.

<img src="https://2450271282-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" %}
Ponieważ sieć Zigbee może mieć tylko jedną konfigurację adaptera, nie obsługuje się wielu konfiguracji. Jeśli skonfigurowany adapter zostanie usunięty, a następnie ponownie włożony, spróbuje automatycznie się przywrócić bez potrzeby ponownej konfiguracji.
{% endhint %}

## **3. Dodawanie urządzeń Zigbee**

{% stepper %}
{% step %}
Po konfiguracji na stronie dodawania urządzenia kliknij „Rozpocznij parowanie”, aby automatycznie dodać urządzenia Zigbee znajdujące się w trybie parowania.

{% hint style="info" %}
Jeśli urządzenie Zigbee nie zostanie znalezione, upewnij się, że urządzenie jest w trybie konfiguracji sieci i sprawdź, czy wokół nie ma nadmiernych zakłóceń radiowych.
{% endhint %}

<img src="https://2450271282-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 %}
Wykryte urządzenia Zigbee zostaną następnie dodane do twojego CUBE OS, gotowe do przypisania do pokoju lub edycji nazwy.

<img src="https://2450271282-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" %}
Całkowita liczba urządzeń Zigbee, które można dodać, jest ograniczona i zależy od sprzętu i oprogramowania układowego adaptera.&#x20;

W niektórych przypadkach konieczne jest dodanie dodatkowych urządzeń routera (np. inteligentne gniazdka, lampy, repeatery sygnału), aby dodać więcej urządzeń zasilanych bateryjnie, takich jak czujniki.
{% endhint %}

## 4. Potencjalna kompatybilność

CUBE jest **kompatybilny ze setkami urządzeń Zigbee**. Jednakże istnieją istotne różnice między produktami różnych producentów z powodu złożoności i szerokiego zakresu urządzeń. Oznacza to, że nie można zagwarantować kompatybilności ze wszystkimi urządzeniami, lecz będą dokonywane iteracyjne usprawnienia.

Prosimy o sprawdzenie <https://cube-web.ewelink.cc/> aby sprawdzić kompatybilność.