Como Migrar Seu Coordenador Zigbee para o Novo Dongle SONOFF?

Visão Geral

Para gateways Zigbee tradicionais, as barreiras do ecossistema entre marcas frequentemente tornam a migração um verdadeiro problema. 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 de coordenador Zigbee que permitem transferir sua configuração de forma rápida e tranquila, com esforço mínimo. Isso torna a atualização para um novo Dongle muito mais fácil e conveniente.

Após várias rodadas de iteração e melhorias, a linha SONOFF Dongle evoluiu para incluir o Dongle-M, o Dongle-PMG24 e o Dongle-LMG21 — cada um projetado para diferentes usuários e cenários. Todos os três são baseados na solução Ember e suportam recursos de migração, permitindo que você transfira dados do seu Dongle antigo e continue operando 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 outro Dongle baseado em Ember — para um novo SONOFF Dongle (Dongle-M, Dongle-PMG24 e Dongle-LMG21) usando 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  

Passos para a migração:

1. Vá para a página de configuração do ZHA e clique no botão Migrar Rádio.

2. Selecione Migrar para novo rádio.

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

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 para o Dongle-M:

• Conexão USB: Selecione diretamente o dispositivo serial e conecte.
  
• Conexão TCP: Escolha Inserir Manualmente, depois selecione manualmente o tipo de dispositivo EZSP e defina o caminho serial para: 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: https://www.zigbee2mqtt.io/guide/faq/#how-do-i-migrate-from-one-adapter-to-another

Migrando de um Coordenador Ember para o Dongle-M

Resultado:

Não é necessário reconfigurar os dispositivos

Passos:

1. Pare o add-on Zigbee2MQTT.

2. Use o add-on 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.

Migrando de um Coordenador Z-Stack para o Dongle-M (Recomendação não oficial)

Resultado: 
Testado e não requer reconfiguração dos dispositivos

Passos:

1. Pare o add-on Zigbee2MQTT.

2. Use o add-on File Editor para acessar /homeassistant/zigbee2mqtt/.

3. Faça backup dos arquivos configuration.yaml, coordinator_backup.json e database.db para seu computador local (caso seja necessário restaurar).

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

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

6. Inicie o add-on 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. Assim que a rede Zigbee iniciar com sucesso e o console Zigbee2MQTT estiver acessível, pare o add-on. Volte para /homeassistant/zigbee2mqtt/, exclua o database.db recém-gerado e renomeie o database.db.backup original para database.db.

8. Além disso, modifique o 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, não importa qual método você use para migrar seu coordenador Zigbee, se encontrar algum problema, sinta-se à vontade para visitar a seção Dongle do fórum. Nossos desenvolvedores de Dongle estão lá para ajudar a responder suas dúvidas e garantir uma transição suave e sem complicações para seu novo SONOFF Dongle.