Guia de Integração de Dispositivos Shelly com Zigbee

Requisitos do Sistema

Antes de começar, certifique-se de que você possui:

• Um coordenador Zigbee (ex.: Sonoff ZBDongle, ConBee II, SkyConnect) conectado ao seu sistema de automação

• Um software controlador Zigbee instalado e funcional, como:

  • Home Assistant com integração ZHA

  • Zigbee2MQTT com um broker MQTT

• Um dispositivo Shelly compatível com Zigbee, com acesso físico ao botão

• Um computador ou dispositivo móvel conectado à mesma rede do seu sistema domótico

Passo a Passo para Configuração

Passo 1: Mudar para o firmware Zigbee (se necessário)

Alguns dispositivos Shelly são fornecidos com firmware Wi-Fi/Matter por padrão. Se o seu dispositivo suporta Zigbee, mas ainda está em modo Wi-Fi:

1. Pressione o botão rapidamente 5 vezes

2. Aguarde 5–10 segundos enquanto ele muda para o modo Zigbee

Nota: Esse processo só precisa ser feito uma vez, a menos que você volte manualmente para o modo Wi-Fi.

Passo 2: Entrar no Modo de Pareamento

Para se conectar à rede Zigbee, o dispositivo deve estar em modo de pareamento:

• Modo automático: ativado após um reset de fábrica

• Modo manual: pressione o botão rapidamente 3 vezes

Passo 3: Parear o Dispositivo com sua Rede Zigbee

Usando Home Assistant (ZHA)

1. Vá para:
   Configurações → Dispositivos e Serviços → Adicionar Integração → Adicionar Dispositivo Zigbee

2. Clique em “Adicionar Dispositivo”

3. Aguarde o reconhecimento do dispositivo Shelly

4. Selecione-o e atribua um nome e local, se desejar

Usando Zigbee2MQTT

1. Acesse a interface web do Zigbee2MQTT (geralmente em http://<seu-ip>:8080)

2. Clique em “Permit Join”

3. Aguarde o dispositivo ser descoberto

4. Renomeie e configure conforme necessário

Passo 4: Usar o Dispositivo

Após o pareamento bem-sucedido, o dispositivo disponibilizará suas entidades Zigbee, como:

• Interruptores

• Sensores

• Indicador de bateria (se suportado)

Agora você pode usá-lo em automações, cenas ou controlá-lo manualmente pela sua plataforma Zigbee.

Passo 5 (Recomendado): Atualizar o Firmware Zigbee

Para garantir desempenho ideal e compatibilidade futura, atualize seu dispositivo Shelly para a versão mais recente do firmware Zigbee.

⚠️ Importante: Atualizações OTA via Zigbee ainda não são suportadas. É necessário ativar o modo Wi-Fi/BLE temporariamente.

Como Atualizar

1. Ativar Modo Wi-Fi/BLE
   Pressione e segure o botão traseiro por 5 segundos

2. Conectar-se ao Access Point do dispositivo

   • Após o reset, o dispositivo criará um ponto de acesso Wi-Fi

   • Conecte-se a ele e abra http://192.168.33.1 no navegador

3. Atualizar via Interface Web

   • Vá para Configurações → Firmware

   • Instale a versão mais recente disponível

4. Verificar o Status Zigbee

Se o status exibir “failed”, pressione o botão 3 vezes rapidamente para reiniciar o modo de pareamento.

Soluções de Problemas