> 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/english-pt/primeiros-passos/adicionar-dispositivos/dispositivos-zigbee.md).

# Dispositivos Zigbee

## **1. Instalar Adaptadores Zigbee**

Se tiver seguido os passos opcionais para Zigbee ao instalar o CUBE, pode saltar para [Passo 2](#id-2.-initialize-zigbee) para inicializar o seu dongle como coordenador da sua rede Zigbee.

Antes de adicionar um dispositivo Zigbee, precisa de um adaptador Zigbee, normalmente um dongle USB. Insira o adaptador Zigbee na porta USB do dispositivo que está a executar o CUBE OS.

**Para Utilizadores de Máquinas Virtuais**: Depois de inserir o adaptador Zigbee, adicione-o às definições da máquina virtual e reinicie o CUBE. Os passos detalhados podem ser encontrados no [guia de instalação](/english-pt/primeiros-passos/quickstart/maquina-virtual.md).

### **1.1 Adaptadores Compatíveis**

O CUBE é compatível com vários adaptadores Zigbee de diferentes fabricantes. Atualmente suporta stacks de protocolo como EZSP, Deconz, Zstack e Zigate. Embora possa ser usado qualquer adaptador que suporte estes stacks de protocolo, são recomendados os seguintes:

> SONOFF ZBDongle-MAX\
> SONOFF ZBDongle-PMG24\
> SONOFF ZBDongle-LMG21\
> SONOFF ZBDongle-E\
> SONOFF ZBDongle-P\
> [Outros listados](https://darkxst.github.io/silabs-firmware-builder/) pelo desenvolvedor @darkxst 

## **2. Inicializar Zigbee**

{% stepper %}
{% step %}
Depois de ligar o seu adaptador Zigbee. O CUBE mostra uma janela pop-up, como `Dongle Ligado` quando o adaptador é detetado.

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

{% step %}
Ao usar um **dongle Zigbee SONOFF**, clique em `Iniciar Configuração`.

Se o dongle já estiver a executar uma versão de firmware Zigbee suportada, o CUBE conclui a configuração automaticamente. Se a versão do firmware não for suportada, o CUBE fornece a gravação com um clique para a versão estável recomendada.

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

{% step %}
Ao usar um **adaptador Zigbee não-SONOFF**, clique em `Iniciar Configuração`.

Se o adaptador já estiver a executar uma versão de firmware Zigbee suportada, o CUBE conclui a configuração automaticamente. Se a versão do firmware não for suportada, use a ferramenta de gravação do fabricante para instalar a versão estável recomendada antes de continuar. **Caso contrário**, o CUBE não pode controlar dispositivos Zigbee com esse adaptador.
{% endstep %}

{% step %}
Assim que o adaptador tiver concluído a atualização de firmware e a configuração, pode agora adicionar dispositivos Zigbee.

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

{% step %}
Se o CUBE não detetar o seu adaptador Zigbee, adicione-o manualmente introduzindo as informações necessárias:

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

* **Caminho Serial**: Verifique a secção “Todo o Hardware” na página de definições para obter o caminho da porta série do adaptador Zigbee inserido.

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

* **Tipo de Stack de Protocolo**: O CUBE suporta atualmente EZSP, Deconz, ZStack e Zigate. Verifique a documentação do adaptador ou a página de compra para o tipo correto.
* **Velocidade da Porta**: Opcional. Não é necessária para todos os adaptadores Zigbee.
* **Fluxo de Dados**: Opcional. Não é necessária para todos os adaptadores Zigbee.

Clique em `Confirmar` para guardar a configuração. Se a configuração for bem-sucedida, pode começar a adicionar dispositivos Zigbee. Se falhar, verifique a mensagem de erro e atualize a configuração.

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

{% hint style="info" %}
Como uma rede Zigbee só pode ter uma configuração de adaptador, várias configurações não são suportadas. Se um adaptador configurado for removido e depois inserido novamente, o CUBE detetará automaticamente o dispositivo e orientá-lo-á para restaurar a sua configuração sem necessidade de reconfiguração.
{% endhint %}

## **3. Adicionar Dispositivos Zigbee**

{% stepper %}
{% step %}
Após a configuração, na página de adicionar dispositivo, clique em “Iniciar Emparelhamento” para adicionar automaticamente dispositivos Zigbee em modo de emparelhamento.

{% hint style="info" %}
Se o seu dispositivo Zigbee não for encontrado, certifique-se de que o dispositivo está em modo de configuração de rede e verifique se existe interferência de rádio excessiva nas proximidades.
{% endhint %}

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

{% step %}
Os dispositivos Zigbee detetados serão então adicionados ao seu CUBE OS, prontos para serem atribuídos a uma divisão ou para editar o nome.

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

{% hint style="info" %}
O número total de dispositivos Zigbee que podem ser adicionados é limitado, dependendo do hardware e do firmware do adaptador.

Em certos casos, é necessário adicionar dispositivos router extra (por exemplo, fichas inteligentes, luzes, repetidores de sinal) para adicionar mais dispositivos alimentados por bateria, como sensores.
{% endhint %}

## 4. Compatibilidade Potencial

O CUBE é **compatível com centenas de dispositivos Zigbee**. No entanto, existem diferenças substanciais entre produtos de diferentes fabricantes devido à complexidade e à vasta gama de dispositivos. Isto significa que não é possível garantir compatibilidade com todos os dispositivos, mas serão feitas melhorias de forma iterativa.

Por favor, dirija-se para verificar a <https://cube-web.ewelink.cc/> para verificar a compatibilidade.


---

# 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/english-pt/primeiros-passos/adicionar-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.