Guia de Integração de Dispositivos Shelly com Zigbee

Requisitos do Sistema

Certifique-se de que possui os seguintes componentes e acessos:

• Um coordenador Zigbee (ex.: Sonoff ZBDongle, ConBee II, SkyConnect) ligado ao seu sistema de casa inteligente

• Software de controlo Zigbee instalado e operacional, como:

  • Home Assistant com integração ZHA, ou

  • Zigbee2MQTT com um broker MQTT devidamente configurado

• Um dispositivo Shelly com suporte Zigbee e acesso físico ao botão

• Um computador ou dispositivo móvel ligado à mesma rede local da sua plataforma de casa inteligente

Configuração Passo a Passo

Passo 1: Mudar para o firmware Zigbee (se aplicável)

Alguns dispositivos Shelly são fornecidos com firmware Wi-Fi/Matter por predefinição. Se o seu dispositivo suportar Zigbee mas não estiver em modo Zigbee, será necessário efetuar a alteração manualmente.

Para versões de firmware inferiores à 1.7.0:

1. Prima rapidamente o botão do dispositivo 5 vezes.

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

Nota: Este procedimento é necessário apenas uma vez, a menos que o firmware seja posteriormente revertido manualmente para o modo Wi-Fi.

Para versões de firmware 1.7.0 e superiores:

A mudança de firmware só pode ser feita através da interface web local:

Settings → Switch to Matter/Zigbee

Passo 2: Ativar o modo de emparelhamento

O dispositivo Shelly deve estar em modo de emparelhamento para se ligar à rede Zigbee.

• Modo de emparelhamento automático: ativado após reposição de fábrica

• Modo de emparelhamento manual: prima rapidamente o botão 3 vezes

Passo 3: Emparelhar o dispositivo com a rede Zigbee

Para Home Assistant (ZHA)

1. Aceda a:
   Settings → Devices & Services → Add Integration → Add Zigbee Device

2. Clique em Add Device.

3. Aguarde até que o dispositivo Shelly seja detetado.

4. Selecione-o e atribua opcionalmente um nome e uma área.

Para Zigbee2MQTT

1. Abra a interface web do Zigbee2MQTT (normalmente http://<seu-ip>:8080).

2. Clique em Permit Join.

3. Aguarde até que o dispositivo Shelly seja descoberto.

4. Renomeie e configure conforme necessário.

Passo 4: Utilizar o dispositivo

Após o emparelhamento bem-sucedido, o dispositivo irá disponibilizar as suas entidades Zigbee, tais como:

• Interruptores

• Sensores

• Indicadores de nível de bateria (se suportado)

Pode agora utilizar o dispositivo em automações, cenas ou controlo manual através da sua plataforma Zigbee.

Passo 5 (Recomendado): Atualizar o firmware Zigbee

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

⚠️ As atualizações de firmware devem atualmente ser realizadas em modo Wi-Fi/BLE. Atualizações OTA via Zigbee não são suportadas neste momento.

Procedimento de atualização

1. Ativar o modo Wi-Fi/BLE
Prima e mantenha premido o botão na parte traseira durante 5 segundos para mudar de modo.

2. Ligar ao ponto de acesso do dispositivo

• Após a reposição, o dispositivo transmite um ponto de acesso Wi-Fi local.

• Ligue-se a esse ponto de acesso e abra http://192.168.33.1 no navegador.

3. Atualizar através da interface web

• Aceda a: Settings → Firmware

• Instale a versão de firmware mais recente disponível que inclua melhorias Zigbee.

4. Confirmar o estado da ligação Zigbee

Se o estado indicar “failed”, prima rapidamente o botão 3 vezes para voltar a entrar em modo de emparelhamento.

Resolução de Problemas