¿Cómo migrar tu coordinador Zigbee al nuevo dongle SONOFF?

Descripción general

En las pasarelas Zigbee tradicionales, las barreras del ecosistema entre marcas suelen hacer que la migración sea un verdadero dolor de cabeza. Cambiar a una nueva pasarela normalmente implica volver a añadir desde cero una gran cantidad de subdispositivos.

Sin embargo, en el caso de los coordinadores Zigbee con formato de Dongles —que se utilizan habitualmente con plataformas de código abierto—, la situación es bastante diferente. Si necesitas sustituir tu Dongle, tanto ZHA como Z2M ofrecen funciones de migración del coordinador Zigbee que permiten transferir tu configuración de forma rápida y sencilla, con un esfuerzo mínimo. Esto hace que actualizar a un nuevo Dongle sea mucho más fácil y cómodo.

Tras varias rondas de iteraciones y actualizaciones, la gama SONOFF Dongle ha evolucionado para incluir Dongle-M, Dongle-PMG24 y Dongle-LMG21 —cada uno diseñado para distintos usuarios y escenarios. Los tres se basan en la solución Ember y admiten funciones de migración, lo que permite transferir los datos desde tu antiguo Dongle y seguir utilizando tu ecosistema Zigbee sin interrupciones.

En este artículo, tomaremos Dongle-M como ejemplo y te explicaremos cómo migrar tu configuración —ya sea desde un Dongle basado en Z-Stack o desde otro Dongle basado en Ember— a un nuevo SONOFF Dongle (Dongle-M, Dongle-PMG24 y Dongle-LMG21) mediante ZHA o Z2M.

ZHA: Migración del coordinador Zigbee

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

Resultado:

No es necesario volver a configurar los dispositivos  

Pasos de la migración:

1. Ve a la página de configuración de ZHA y haz clic en el botón Migrate Radio.

2. Selecciona Migrate to new radio.

3. Confirma la información de la migración y haz clic en Submit.

4. Desconecta el Dongle antiguo y conecta Dongle-M al puerto USB del host o a la red local.

5. Confirma el método de conexión de Dongle-M:

• Conexión USB: Selecciona directamente el dispositivo serie y conéctalo.
  
• Conexión TCP: Selecciona Enter Manually, elige manualmente el tipo de dispositivo EZSP y establece la ruta serie como: tcp://Dongle-M.local.
  

Configuración manual:

6. Elige restaurar desde la copia de seguridad automática.

7. Migración completada correctamente.

Z2M:  Migración del coordinador Zigbee  

Tutorial oficial de Zigbee2MQTT: Cómo migrar de un adaptador a otro

Migración de un coordinador Ember a Dongle-M

Resultado:

No es necesario volver a configurar los dispositivos

Pasos:

1. Detén el complemento Zigbee2MQTT.

2. Utiliza el complemento File Editor para acceder a /homeassistant/zigbee2mqtt/configuration.yaml.

3. Cambia el puerto a la ruta de Dongle-M, por ejemplo, tcp://Dongle-M.local:6638, y guarda los cambios (Ctrl + S).

4. Reinicia Zigbee2MQTT.

Migración de un coordinador Z-Stack a Dongle-M (recomendación no oficial)

Resultado: 
Las pruebas indican que no es necesario volver a configurar los dispositivos

Pasos:

1. Detén el complemento Zigbee2MQTT.

2. Utiliza el complemento File Editor para acceder a /homeassistant/zigbee2mqtt/.

3. Haz una copia de seguridad de configuration.yaml, coordinator_backup.json y database.db en tu ordenador local (por si fuera necesario restaurarlos).

4. Modifica /homeassistant/zigbee2mqtt/configuration.yaml e introduce la ruta serie de Dongle-M, por ejemplo, tcp://Dongle-M.local:6638. Asegúrate de cambiar el controlador a ezsp y, a continuación, guarda los cambios (Ctrl + S).

5. Elimina /homeassistant/zigbee2mqtt/coordinator_backup.json.

6. Inicia el complemento Zigbee2MQTT. Zigbee2MQTT recreará la red Zigbee basándose en el archivo YAML. pan_id y extended_pan_id coincidirán con los de la red original, mientras que la lista de dispositivos estará vacía.

7. Cuando la red Zigbee se haya iniciado correctamente y puedas acceder a la consola de Zigbee2MQTT, detén el complemento. Vuelve a /homeassistant/zigbee2mqtt/, elimina el database.db recién generado y cambia el nombre del database.db.backup original a database.db.

8. Modifica también configuration.yaml para establecer adapter en ember y guarda los cambios (Ctrl + S).  

9. Reinicia Zigbee2MQTT. La lista original de dispositivos se restaurará desde database.db.  

Por último, independientemente del método que utilices para migrar tu coordinador Zigbee, si tienes algún problema, no dudes en visitar la sección Dongle del foro. Nuestros desarrolladores de Dongle están allí para responder a tus preguntas y ayudarte a garantizar una transición fluida y sin interrupciones a tu nuevo SONOFF Dongle.