> For the complete documentation index, see [llms.txt](https://cube.ewelink.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cube.ewelink.cc/cube-os-es/primeros-pasos/anadir-dispositivos/dispositivos-zigbee.md).

# Dispositivos Zigbee

## **1. Instalar adaptadores Zigbee**

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

Antes de añadir un dispositivo Zigbee, necesitas un adaptador Zigbee, normalmente un dongle USB. Inserta 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ñádelo a la configuración de la máquina virtual y reinicia CUBE. Los pasos detallados se pueden encontrar en la [guía de instalación](/cube-os-es/primeros-pasos/quickstart/maquina-virtual.md).

### **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 admita estas pilas de protocolo, se recomiendan los siguientes:

## **2. Inicializar Zigbee**

{% stepper %}
{% step %}
Después de conectar tu adaptador Zigbee. CUBE muestra una ventana emergente, como `Dongle conectado` cuando se detecta el adaptador.

<div align="left"><figure><img src="/files/dc2a49f23b4b4172182c12a8602dda64c2fdd94a" alt="" width="277"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Usando un **dongle Zigbee SONOFF**, haz clic en `Iniciar configuración`.

Si el dongle ya ejecuta una versión de firmware Zigbee compatible, CUBE completa la configuración automáticamente. Si la versión de firmware no es compatible, CUBE ofrece flasheo con un solo clic a la versión estable recomendada.

<div align="left"><figure><img src="/files/d1521fa3fa9809c4ab3336974c17909bf626522b" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Usando un **adaptador Zigbee que no sea SONOFF**, haz clic en `Iniciar configuración`.

Si el adaptador ya ejecuta una versión de firmware Zigbee compatible, CUBE completa la configuración automáticamente. Si la versión de firmware no es compatible, usa la herramienta de flasheo del fabricante para instalar la versión estable recomendada antes de continuar. **De lo contrario**, CUBE no puede controlar dispositivos Zigbee con ese adaptador.
{% endstep %}

{% step %}
Una vez que el adaptador haya completado su actualización de firmware y configuración, ya puedes añadir dispositivos Zigbee.

<div align="left"><figure><img src="/files/786ff7d9bea901ec0378c10226d1040825ea9169" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Si CUBE no detecta tu adaptador Zigbee, añádelo manualmente introduciendo la información requerida:

<img src="/files/c73500be97485da629ea89c1787bf489fd8c84f8" alt="" data-size="original">

* **Ruta serie**: Consulta la sección “Todo el hardware” en la página de configuración para ver la ruta del puerto serie del adaptador Zigbee insertado.

<img src="/files/7878a63df753f20cc15bdf4a52fb30d3cb574d17" alt="" data-size="original">

* **Tipo de pila de protocolo**: CUBE actualmente admite EZSP, Deconz, ZStack y Zigate. Consulta la documentación del adaptador o la página de compra para conocer el tipo correcto.
* **Velocidad del puerto**: Opcional. No requerida para todos los adaptadores Zigbee.
* **Flujo de datos**: Opcional. No requerida para todos los adaptadores Zigbee.

Haz clic en `Confirmar` para guardar la configuración. Si la configuración se realiza correctamente, puedes empezar a añadir dispositivos Zigbee. Si falla, revisa el mensaje de error y actualiza la configuración.

<img src="/files/fe23a3ec86d3a8301d41a5a72b093af36364b5bd" 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 varias configuraciones. Si un adaptador configurado se retira y luego se vuelve a insertar, CUBE detectará automáticamente el dispositivo y te guiará para restaurarlo sin necesidad de reconfiguración.
{% endhint %}

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

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

{% hint style="info" %}
Si no se encuentra tu dispositivo Zigbee, asegúrate de que esté en modo de configuración de red y comprueba que no haya interferencia de radio excesiva alrededor.
{% endhint %}

<img src="/files/d4095049a7330ba358d327e4b644431bb79a31e4" alt="" data-size="original">
{% endstep %}

{% step %}
Los dispositivos Zigbee detectados se añadirán entonces a tu CUBE OS, listos para asignar una habitación o editar el nombre.

<img src="/files/b33493bbd806b4631076ebfdad302a2ad894571e" 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 el firmware del adaptador.

En ciertos casos, necesitas añadir dispositivos enrutadores adicionales (p. ej., enchufes inteligentes, luces, repetidores de señal) para 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 distintos 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 harán mejoras de forma iterativa.

Por favor, te indico que consultes la <https://cube-web.ewelink.cc/> para comprobar la compatibilidad.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cube.ewelink.cc/cube-os-es/primeros-pasos/anadir-dispositivos/dispositivos-zigbee.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.