Como Migrar Seu Coordenador Zigbee para o Novo Dongle SONOFF?

Visão geral

Para gateways Zigbee tradicionais, as barreiras entre os ecossistemas das marcas muitas vezes tornam a migração uma verdadeira dor de cabeça. Trocar para um novo gateway geralmente significa adicionar novamente um grande número de subdispositivos do zero.

No entanto, para coordenadores Zigbee na forma de Dongles — comumente usados com plataformas de código aberto — a situação é bem diferente. Se você precisar substituir seu Dongle, tanto o ZHA quanto o Z2M oferecem recursos de migração do coordenador Zigbee que permitem transferir sua configuração de forma rápida e simples, com o mínimo de esforço. Isso torna a atualização para um novo Dongle muito mais fácil e conveniente.

Após várias rodadas de iterações e atualizações, a linha de Dongles SONOFF evoluiu e agora inclui o Dongle-M, o Dongle-PMG24 e o Dongle-LMG21 — cada um desenvolvido para diferentes usuários e cenários. Os três são baseados na solução Ember e oferecem suporte a recursos de migração, permitindo transferir os dados do seu Dongle antigo e continuar usando seu ecossistema Zigbee sem interrupções.

Neste artigo, usaremos o Dongle-M como exemplo e mostraremos como migrar sua configuração — seja de um Dongle baseado em Z-Stack ou de outro Dongle baseado em Ember — para um novo Dongle SONOFF (Dongle-M, Dongle-PMG24 e Dongle-LMG21) usando o ZHA ou Z2M.

ZHA: Migração do coordenador Zigbee  

Tutorial oficial do ZHA: https://www.home-assistant.io/integrations/zha/#migrating-to-a-new-zigbee-coordinator-adapter-inside-zha

Resultado:

Não é necessário reconfigurar os dispositivos  

Etapas da migração:

1. Acesse a página de configuração do ZHA e clique no botão Migrate Radio.

2. Selecione Migrate to new radio.

3. Confirme as informações da migração e clique em Submit.

4. Desconecte o Dongle antigo e conecte o Dongle-M à porta USB do host ou à rede local.

5. Confirme o método de conexão do Dongle-M:

• Conexão USB: Selecione diretamente o dispositivo serial e conecte-o.
  
• Conexão TCP: Selecione Enter Manually, depois selecione manualmente o tipo de dispositivo EZSP e defina o caminho serial como: tcp://Dongle-M.local.
  

Configuração manual:

6. Escolha restaurar a partir do backup automático.

7. Migração concluída com sucesso.

Z2M:  Migração do coordenador Zigbee  

Tutorial oficial do Zigbee2MQTT: Como migrar de um adaptador para outro

Migração de um coordenador Ember para o Dongle-M

Resultado:

Não é necessário reconfigurar os dispositivos

Etapas:

1. Pare o complemento Zigbee2MQTT.

2. Use o complemento File Editor para acessar /homeassistant/zigbee2mqtt/configuration.yaml.

3. Altere a porta para o caminho do Dongle-M, por exemplo, tcp://Dongle-M.local:6638, e salve (Ctrl + S).

4. Reinicie o Zigbee2MQTT.

Migração de um coordenador Z-Stack para o Dongle-M (recomendação não oficial)

Resultado: 
Os testes indicaram que não é necessário reconfigurar os dispositivos

Etapas:

1. Pare o complemento Zigbee2MQTT.

2. Use o complemento File Editor para acessar /homeassistant/zigbee2mqtt/.

3. Faça backup de configuration.yaml, coordinator_backup.json e database.db no seu computador local (caso seja necessário restaurá-los).

4. Modifique /homeassistant/zigbee2mqtt/configuration.yaml e insira o caminho serial do Dongle-M, por exemplo, tcp://Dongle-M.local:6638. Altere também o driver para ezsp e salve (Ctrl + S).

5. Exclua /homeassistant/zigbee2mqtt/coordinator_backup.json.

6. Inicie o complemento Zigbee2MQTT. O Zigbee2MQTT recriará a rede Zigbee com base no arquivo YAML. O pan_id e o extended_pan_id corresponderão à rede original, enquanto a lista de dispositivos estará vazia.

7. Depois que a rede Zigbee for iniciada com sucesso e o console do Zigbee2MQTT estiver acessível, pare o complemento. Acesse novamente /homeassistant/zigbee2mqtt/, exclua o database.db recém-gerado e renomeie o database.db.backup original para database.db.

8. Além disso, modifique configuration.yaml para definir o adaptador como ember e salve (Ctrl + S).  

9. Reinicie o Zigbee2MQTT. A lista original de dispositivos será restaurada a partir do database.db.  

Por fim, independentemente do método usado para migrar seu coordenador Zigbee, se você tiver algum problema, visite a seção Dongle do fórum. Nossos desenvolvedores de Dongle estão disponíveis para ajudar a responder às suas perguntas e garantir uma transição tranquila e simples para o seu novo Dongle SONOFF.