# Dispositivi Zigbee

## **1. Installa gli adattatori Zigbee**

Se hai seguito i passaggi opzionali per Zigbee durante l'installazione di CUBE, puoi passare a [Passo 2](#id-2.-initialize-zigbee) per inizializzare il tuo dongle come coordinatore della rete Zigbee. 

Prima di aggiungere un dispositivo Zigbee, è necessario un adattatore Zigbee, tipicamente un dongle USB. Inserisci l'adattatore Zigbee nella porta USB del dispositivo che esegue CUBE OS.

**Per utenti di macchine virtuali**: Dopo aver inserito l'adattatore Zigbee, aggiungilo nelle impostazioni della macchina virtuale e riavvia CUBE. I passaggi dettagliati sono disponibili nella [guida all'installazione](https://cube.ewelink.cc/english-it/primi-passi/quickstart/macchina-virtuale).

### **1.1 Adattatori compatibili**

CUBE è compatibile con vari adattatori Zigbee di diversi produttori. Attualmente supporta stack di protocollo come EZSP, Deconz, Zstack e Zigate. Sebbene qualsiasi adattatore che supporti questi stack di protocollo possa essere utilizzato, si raccomandano i seguenti:

## **2. Inizializza Zigbee**

{% stepper %}
{% step %}
Per aggiungere un dispositivo, fai clic sul pulsante “Aggiungi dispositivo” nella pagina principale del dispositivo.

<img src="https://2847557189-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 %}
Avvia l'accoppiamento e seleziona “Continua configurazione” nella finestra popup per rilevare automaticamente l'adattatore Zigbee inserito.&#x20;

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

Una volta che l'adattatore è stato rilevato automaticamente, seleziona l'adattatore Zigbee che desideri utilizzare dall'elenco e fai clic su “Conferma” per completare la configurazione.

<img src="https://2847557189-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 %}
Se il tuo adattatore Zigbee non viene rilevato, puoi aggiungerlo manualmente inserendo le informazioni necessarie:

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

* **Percorso seriale**: Controlla la sezione “Tutti gli hardware” nella pagina delle impostazioni per il percorso della porta seriale dell'adattatore Zigbee inserito.

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

* **Tipo di stack del protocollo**: Attualmente supporta EZSP, Deconz, ZStack e Zigate. Controlla il sito di acquisto dell'adattatore per il tipo di stack del protocollo corrispondente.
* **Velocità della porta**: Opzionale, non applicabile a tutti gli adattatori Zigbee.
* **Flusso di dati**: Opzionale, non applicabile a tutti gli adattatori Zigbee.
  {% endstep %}

{% step %}
Invia la configurazione facendo clic su conferma. Se avrà successo, potrai aggiungere dispositivi Zigbee. In caso di errore, controlla il messaggio di errore specifico.

<img src="https://2847557189-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" %}
Poiché una rete Zigbee può avere una sola configurazione di adattatore, non sono supportate configurazioni multiple. Se un adattatore configurato viene rimosso e poi reinserito, tenterà di ripristinarsi automaticamente senza necessità di riconfigurazione.
{% endhint %}

## **3. Aggiungi dispositivi Zigbee**

{% stepper %}
{% step %}
Dopo la configurazione, nella pagina di aggiunta dispositivi fai clic su “Avvia accoppiamento” per aggiungere automaticamente i dispositivi Zigbee in modalità di associazione.

{% hint style="info" %}
Se il tuo dispositivo Zigbee non viene trovato, assicurati che il dispositivo sia in modalità di configurazione di rete e verifica che non ci sia un eccessivo interferenza radio circostante.
{% endhint %}

<img src="https://2847557189-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 %}
I dispositivi Zigbee rilevati verranno quindi aggiunti a CUBE OS, pronti per assegnare una stanza o modificare il nome.

<img src="https://2847557189-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" %}
Il numero totale di dispositivi Zigbee che possono essere aggiunti è limitato e dipende dall'hardware e dal firmware dell'adattatore.&#x20;

In alcuni casi, è necessario aggiungere dispositivi router aggiuntivi (ad esempio prese intelligenti, lampade, ripetitori di segnale) per poter aggiungere più dispositivi alimentati a batteria come sensori.
{% endhint %}

## 4. Potenziale compatibilità

CUBE è **compatibile con centinaia di dispositivi Zigbee**. Tuttavia, esistono differenze significative tra i prodotti di diversi produttori a causa della complessità e dell'ampia gamma di dispositivi. Ciò significa che non si può garantire la compatibilità con tutti i dispositivi, ma saranno apportati miglioramenti in modo iterativo.

Ti invitiamo a consultare <https://cube-web.ewelink.cc/> per verificare la compatibilità.