# Dispositivos Zigbee

## **1. Instalar adaptadores Zigbee**

Si ha seguido los pasos opcionales para Zigbee al instalar CUBE, puede saltar a [Paso 2](#id-2.-initialize-zigbee) para inicializar su dongle como el coordinador de su red Zigbee. 

Antes de añadir un dispositivo Zigbee, necesita un adaptador Zigbee, normalmente un dongle USB. Inserte el adaptador Zigbee en el puerto USB del dispositivo que ejecuta CUBE OS.

**Para usuarios de máquinas virtuales**: Después de insertar el adaptador Zigbee, añádalo a la configuración de la máquina virtual y reinicie CUBE. Los pasos detallados pueden encontrarse en la [guía de instalación](https://cube.ewelink.cc/cube-os-es/primeros-pasos/quickstart/maquina-virtual).

### **1.1 Adaptadores compatibles**

CUBE es compatible con varios adaptadores Zigbee de diferentes fabricantes. Actualmente admite pilas de protocolo como EZSP, Deconz, Zstack y Zigate. Aunque se puede usar cualquier adaptador que sea compatible con estas pilas de protocolo, se recomiendan los siguientes:

## **2. Inicializar Zigbee**

{% stepper %}
{% step %}
Para añadir un dispositivo, haga clic en el botón “Añadir dispositivo” en la página principal del dispositivo.

<img src="https://1438513814-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 %}
Inicie el emparejamiento y seleccione “Continuar configuración” en la ventana emergente para detectar automáticamente el adaptador Zigbee insertado.&#x20;

<img src="https://1438513814-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 vez que el adaptador se detecte automáticamente, seleccione el adaptador Zigbee que desea usar de la lista y haga clic en “Confirmar” para completar la configuración.

<img src="https://1438513814-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 %}
Si su adaptador Zigbee no se detecta, puede añadirlo manualmente introduciendo la información necesaria:

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

* **Ruta serial**: Consulte la sección “Todo el hardware” en la página de ajustes para la ruta del puerto serial del adaptador Zigbee insertado.

<img src="https://1438513814-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 de pila de protocolo**: Actualmente admite EZSP, Deconz, ZStack y Zigate. Consulte el sitio de compra del adaptador para conocer el tipo de pila de protocolo correspondiente.
* **Velocidad del puerto**: Opcional, no aplicable a todos los adaptadores Zigbee.
* **Flujo de datos**: Opcional, no aplicable a todos los adaptadores Zigbee.
  {% endstep %}

{% step %}
Envíe la configuración haciendo clic en confirmar. Si tiene éxito, podrá añadir dispositivos Zigbee. En caso de fallo, compruebe el mensaje de error específico.

<img src="https://1438513814-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" %}
Dado que una red Zigbee solo puede tener una configuración de adaptador, no se admiten configuraciones múltiples. Si se retira un adaptador configurado y luego se vuelve a insertar, intentará restaurarse automáticamente sin necesidad de reconfiguración.
{% endhint %}

## **3. Añadir dispositivos Zigbee**

{% stepper %}
{% step %}
Tras la configuración, en la página de añadir dispositivo, haga clic en “Iniciar emparejamiento” para añadir automáticamente los dispositivos Zigbee que estén en modo de emparejamiento.

{% hint style="info" %}
Si no se encuentra su dispositivo Zigbee, asegúrese de que el dispositivo esté en modo de configuración de red y verifique que no haya interferencias de radio excesivas en los alrededores.
{% endhint %}

<img src="https://1438513814-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 %}
Los dispositivos Zigbee detectados se añadirán a su CUBE OS, listos para asignar una habitación o editar el nombre.

<img src="https://1438513814-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" %}
El número total de dispositivos Zigbee que se pueden añadir es limitado, dependiendo del hardware y firmware del adaptador.&#x20;

En ciertos casos, necesita añadir dispositivos enrutadores adicionales (p. ej., enchufes inteligentes, luces, repetidores de señal) para poder añadir más dispositivos alimentados por batería como sensores.
{% endhint %}

## 4. Compatibilidad potencial

CUBE es **compatible con cientos de dispositivos Zigbee**. Sin embargo, existen diferencias sustanciales entre productos de diferentes fabricantes debido a la complejidad y la amplia variedad de dispositivos. Esto significa que no se puede garantizar la compatibilidad con todos los dispositivos, pero se realizarán mejoras de forma iterativa.

Por favor, consulte <https://cube-web.ewelink.cc/> para comprobar la compatibilidad.