Como Migrar o Seu Coordenador Zigbee para o Novo Dongle SONOFF?

Visão geral

Nas gateways Zigbee tradicionais, as barreiras entre ecossistemas de diferentes marcas tornam frequentemente a migração um verdadeiro desafio. Mudar para uma nova gateway normalmente significa voltar a adicionar um grande número de subdispositivos desde o início.

No entanto, no caso dos coordenadores Zigbee sob a forma de Dongles — normalmente utilizados com plataformas de código aberto —, a situação é bastante diferente. Se precisar de substituir o seu Dongle, tanto o ZHA como o Z2M disponibilizam funcionalidades de migração do coordenador Zigbee que permitem transferir a sua configuração de forma rápida e simples, com um esforço mínimo. Isto torna a atualização para um novo Dongle muito mais fácil e conveniente.

Após várias rondas de iteração e atualizações, a linha de Dongles SONOFF 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 baseiam-se na solução Ember e suportam funcionalidades de migração, permitindo transferir dados do seu Dongle antigo e continuar a utilizar o seu ecossistema Zigbee sem interrupções.

Neste artigo, utilizaremos o Dongle-M como exemplo e explicaremos como migrar a sua configuração — quer de um Dongle baseado em Z-Stack, quer de outro Dongle baseado em Ember — para um novo Dongle SONOFF (Dongle-M, Dongle-PMG24 e Dongle-LMG21) utilizando o ZHA ou o 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 da migração:

1. Aceda à 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. Desligue o Dongle antigo e ligue o Dongle-M à porta USB do anfitrião ou à rede local.

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

• Ligação USB: Selecione diretamente o dispositivo série e estabeleça a ligação.
  
• Ligação TCP: Selecione Enter Manually, depois selecione manualmente o tipo de dispositivo EZSP e defina o caminho série como: tcp://Dongle-M.local.
  

Configuração manual:

6. Escolha restaurar a partir da cópia de segurança automática.

7. Migração concluída com êxito.

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

Passos:

1. Pare o suplemento Zigbee2MQTT.

2. Utilize o suplemento 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 guarde (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 realizados indicam que não é necessário reconfigurar os dispositivos

Passos:

1. Pare o suplemento Zigbee2MQTT.

2. Utilize o suplemento File Editor para aceder a /homeassistant/zigbee2mqtt/.

3. Faça uma cópia de segurança de configuration.yaml, coordinator_backup.json e database.db no seu computador local (caso seja necessário restaurar).

4. Modifique /homeassistant/zigbee2mqtt/configuration.yaml e introduza o caminho série do Dongle-M, por exemplo, tcp://Dongle-M.local:6638. Certifique-se de que altera o controlador para ezsp e, em seguida, guarde (Ctrl + S).

5. Elimine /homeassistant/zigbee2mqtt/coordinator_backup.json.

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

7. Quando a rede Zigbee for iniciada com êxito e a consola do Zigbee2MQTT estiver acessível, pare o suplemento. Volte a /homeassistant/zigbee2mqtt/, elimine o novo ficheiro database.db e mude o nome do ficheiro database.db.backup original para database.db.

8. Modifique também configuration.yaml para definir o adaptador como ember e, em seguida, guarde (Ctrl + S).  

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

Por fim, independentemente do método utilizado para migrar o seu coordenador Zigbee, se encontrar algum problema, visite a secção Dongle do fórum. Os nossos  programadores de Dongles estão disponíveis para responder às suas perguntas e garantir uma transição suave e simples para o seu novo Dongle SONOFF.