Como Migrar o 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 incómodo. Mudar 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 open-source — a situação é bastante diferente. Se precisar de substituir o seu Dongle, tanto o ZHA como o Z2M oferecem funcionalidades de migração de coordenador Zigbee que permitem transferir a sua configuração de forma rápida e fluida, com o mínimo esforço. Isto torna a atualização para um novo Dongle muito mais fácil e conveniente.

Após várias rondas de iteração e melhorias, a linha SONOFF Dongle evoluiu para incluir o Dongle-M, o Dongle-PMG24 e o Dongle-LMG21 — cada um concebido para diferentes utilizadores e cenários. Os três são baseados na solução Ember e suportam funcionalidades de migração, permitindo-lhe transferir dados do seu Dongle antigo e continuar a operar o seu ecossistema Zigbee sem interrupções.

Neste artigo, vamos usar o Dongle-M como exemplo e guiá-lo no processo de migração da 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á à 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. Desligue o Dongle antigo e ligue o Dongle-M à porta USB do host ou à rede local.

5. Confirme o método de ligação para o Dongle-M:

• Ligação USB: Selecione diretamente o dispositivo serial e ligue.
  
• Ligação TCP: Escolha Introduzir 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 Zigbee2MQTT: https://www.zigbee2mqtt.io/guide/faq/#how-do-i-migrate-from-one-adapter-to-another

Migração de um Coordenador Ember para 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 aceder a /homeassistant/zigbee2mqtt/configuration.yaml.

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

4. Reinicie o Zigbee2MQTT.

Migração de um Coordenador Z-Stack para 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 aceder a /homeassistant/zigbee2mqtt/.

3. Faça backup dos ficheiros configuration.yaml, coordinator_backup.json e database.db para o seu computador local (caso seja necessária restauração).

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, depois guarde (Ctrl + S).

5. Apague /homeassistant/zigbee2mqtt/coordinator_backup.json.

6. Inicie o add-on Zigbee2MQTT. O Zigbee2MQTT irá recriar a rede Zigbee com base no ficheiro 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 a /homeassistant/zigbee2mqtt/, apague 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 adapter como ember, depois guarde (Ctrl + S).  

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

Finalmente, independentemente do método que utilize para migrar o seu coordenador Zigbee, se encontrar algum problema, sinta-se à vontade para visitar a secção Dongle do fórum. Os nossos desenvolvedores de Dongle estão lá para ajudar a responder às suas perguntas e garantir uma transição suave e sem problemas para o seu novo SONOFF Dongle.