# Dispositivos Zigbee
## **1. Instalar Adaptadores Zigbee**
Se você seguiu as etapas opcionais para Zigbee ao instalar o CUBE, pode pular para [Etapa 2](#id-2.-initialize-zigbee) para inicializar seu dongle como o coordenador da sua rede Zigbee.
Antes de adicionar um dispositivo Zigbee, você precisa de um adaptador Zigbee, tipicamente um dongle USB. Insira o adaptador Zigbee na porta USB do dispositivo que executa o CUBE OS.
**Para Usuários de Máquina Virtual**: Após inserir o adaptador Zigbee, adicione-o às configurações da máquina virtual e reinicie o CUBE. Etapas detalhadas podem ser encontradas no [guia de instalação](https://cube.ewelink.cc/english-pt/introducao/quickstart/maquina-virtual).
### **1.1 Adaptadores Compatíveis**
O CUBE é compatível com vários adaptadores Zigbee de diferentes fabricantes. Atualmente suporta pilhas de protocolo como EZSP, Deconz, Zstack e Zigate. Embora qualquer adaptador que suporte essas pilhas de protocolo possa ser usado, os seguintes são recomendados:
## **2. Inicializar Zigbee**
{% stepper %}
{% step %}
Para adicionar um dispositivo, clique no botão “Adicionar Dispositivo” na página inicial do dispositivo.
{% endstep %}
{% step %}
Inicie o emparelhamento e selecione “Continuar Configuração” na janela pop-up para detectar automaticamente o adaptador Zigbee inserido.
Uma vez que o adaptador seja detectado automaticamente, selecione o adaptador Zigbee que deseja usar na lista e clique em “Confirmar” para concluir a configuração.
{% endstep %}
{% step %}
Se o seu adaptador Zigbee não for detectado, você pode adicioná-lo manualmente inserindo as informações necessárias:
* **Caminho Serial**: Verifique a seção “Todos os Hardwares” na página de configurações para o caminho da porta serial do adaptador Zigbee inserido.
* **Tipo de Pilha de Protocolo**: Atualmente suporta EZSP, Deconz, ZStack e Zigate. Verifique no site de compra do adaptador o tipo de pilha de protocolo correspondente.
* **Velocidade da Porta**: Opcional, não aplicável a todos os adaptadores Zigbee.
* **Fluxo de Dados**: Opcional, não aplicável a todos os adaptadores Zigbee.
{% endstep %}
{% step %}
Envie a configuração clicando em confirmar. Se for bem-sucedido, você poderá adicionar dispositivos Zigbee. Em caso de falha, verifique a mensagem de erro específica.
{% endstep %}
{% endstepper %}
{% hint style="info" %}
Como uma rede Zigbee só pode ter uma configuração de adaptador, múltiplas configurações não são suportadas. Se um adaptador configurado for removido e depois reinserido, ele tentará restaurar-se automaticamente 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 dispositivos Zigbee que estejam em modo de emparelhamento automaticamente.
{% hint style="info" %}
Se o seu dispositivo Zigbee não for encontrado, verifique se o dispositivo está em modo de configuração de rede e verifique se não há interferência de rádio excessiva ao redor.
{% endhint %}
{% endstep %}
{% step %}
Os dispositivos Zigbee descobertos serão então adicionados ao seu CUBE OS, prontos para atribuir um cômodo ou editar o nome.
{% 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, você precisa adicionar dispositivos roteadores extras (por exemplo, tomadas inteligentes, lâmpadas, repetidores de sinal) para adicionar mais dispositivos alimentados por bateria, como sensores.
{% endhint %}
## 4. Potencial Compatibilidade
O CUBE é **compatível com centenas de dispositivos Zigbee**. No entanto, existem diferenças substanciais entre produtos de diferentes fabricantes devido à complexidade e à ampla variedade de dispositivos. Isso significa que a compatibilidade com todos os dispositivos não pode ser garantida, mas melhorias serão feitas iterativamente.
Por favor consulte para verificar a compatibilidade.