Migrar red Zigbee del Sonoff Dongle-P a Home Assistant Connect ZBT-2 sin volver a enlazarlo todo

En casa tenía una zona donde la cobertura Zigbee me estaba dando bastantes problemas. Para solucionarlo llevaba más o menos un año usando el Aeotec Extender de Rango Zigbee, pero terminó averiándose. Además, por lo que he ido viendo, no parece un caso aislado, suele fallar cuando pasa un año. Por suerte, Amazon me devolvió el dinero integro, así que decidí aprovechar para buscar otra solución.

Investigando un poco, vi que podía utilizar mi Sonoff Dongle-P como repetidor dentro de la red Zigbee, así que me pareció buen momento para comprar el Home Assistant Connect ZBT-2 y usarlo como nuevo coordinador. Todo este proceso lo he hecho en Home Assistant con Zigbee2MQTT, así que este tutorial está basado en mi instalación real y en lo que me ha funcionado a mí, no en una prueba teórica.

La parte complicada no era conectar un pincho nuevo y ya está. Lo difícil era intentar traspasar la red Zigbee del Sonoff al ZBT-2 sin tener que volver a enlazar todos los dispositivos uno por uno, teniendo en cuenta que tengo ahora mismo 57 dispositivos zigbee. Precisamente por eso he querido hacer este tutorial de cómo lo he hecho, qué pasos seguí y qué problemas me encontré por el camino.

Antes de tocar nada, eso sí, conviene dejar una advertencia clara. Aquí se modifican ajustes importantes de Zigbee2MQTT y se escriben datos internos en el nuevo coordinador. Si algo sale mal, la responsabilidad es de quien lo hace. Yo cuento exactamente los pasos que me han funcionado a mí, pero no puedo garantizar que en todas las instalaciones vaya a salir igual.

Lo primero que conviene tener claro antes de empezar

Antes de tocar la red Zigbee, lo aconsejable es hacer una copia de seguridad completa de Home Assistant y, como mínimo, guardar también una copia de la carpeta /config/zigbee2mqtt/. Ahí están archivos importantes como configuration.yaml, coordinator_backup.json y database.db, y si algo se tuerce durante la migración es lo que te puede salvar de tener que empezar desde cero.

También vas a tener que editar archivos, por lo que es recomendable que tengas instalado el file editor o similar.

Copiar la IEEE del coordinador antiguo

El primer paso real de la migración fue sacar la IEEE de mi coordinador antiguo, en este caso la del Sonoff Dongle-P. Esto es importante. Algunos dispositivos Zigbee memorizan esa dirección del coordinador, así que si cambias a otro stick con una IEEE distinta, pueden no reconocer la red igual que antes y ahí es donde empiezan los problemas.

Para verla fui a Zigbee2MQTT, entré en Configuración, luego en Acerca de, y en la parte derecha aparece la información del coordinador. Ahí copié la IEEE Address, que empieza por 0x,

Ese valor es el que luego escribí en el Home Assistant Connect ZBT-2.

Cómo escribí la IEEE del Sonoff en el ZBT-2 desde Windows

Con la IEEE antigua ya copiada, conecté el ZBT-2 al PC con Windows. Aquí es donde se hace la parte más delicada del proceso, porque toca escribir esa dirección en el nuevo coordinador.

Abrí PowerShell e instalé la herramienta Universal Silicon Labs Flasher con este comando:

pip install universal-silabs-flasher

Ver el puerto COM que está usando el ZBT-2 en Windows

Con el Home Assistant Connect ZBT-2 conectado al ordenador, el siguiente paso es comprobar qué puerto COM le ha asignado Windows. Para verlo, hay que abrir el Administrador de dispositivos. Puedes hacerlo con clic derecho en el botón de inicio de Windows y entrando en Administrador de dispositivos. Una vez dentro, despliega el apartado Puertos (COM y LPT). Ahí debería aparecer el coordinador con un nombre similar y, al final, el puerto asignado, por ejemplo COM3 o COM4. Ese es el valor que luego tendrás que usar en los comandos de PowerShell.

Con ese dato, primero probé si el sistema detectaba bien el coordinador, para ello lo primero que hice es actualizar Python desde Windows con estos comandos:

py -m pip install --upgrade pip
py -m pip install universal-silabs-flasher

Y después probé si el sistema detectaba bien el coordinador con este comando (sustituye com3 por tu puerto):

py -m universal_silabs_flasher --device COM3 probe

Tras comprobar que funcionaba correctamente, el siguiente paso fue escribir la IEEE del Sonoff en el ZBT-2. Ten en cuenta que hay que introducirla sin el 0x al principio. Para esto usaremos este comando:

py -m universal_silabs_flasher --device COM3 write-ieee --ieee 00124b0xxxxxxxx

Con eso la IEEE quedará actualizada correctamente en el ZBT-2.

El primer paso en Home Assistant es conectar el ZBT-2 y dejar que lo detecte

Una vez hecha esa parte, quité el ZBT-2 del ordenador y lo llevé al equipo donde tengo Home Assistant. En ese momento, paré Zigbee2MQTT y retiré el Sonoff Dongle-P para no dejar los dos a la vez conectados al mismo sistema. Para pararlo simplemente ves a configuración, aplicaciones, Zigbee2MQTT, y dale a detener.

Después conecté el Home Assistant Connect ZBT-2 al equipo con Home Assistant y esperé un poco. En mi caso, Home Assistant lo detectó automáticamente y me mostró el asistente de configuración.

En ese asistente elegí el protocolo, que puede ser Zigbee o Thread, en este caso debemos usar Zigbee. Después marqué la opción de configuración Zigbee personalizada y, en el método Zigbee, elegí otro, porque iba a seguir usando Zigbee2MQTT y no otro sistema distinto.

A partir de ahí, el propio sistema instaló el firmware correspondiente para ese uso, elegí la ubicación y terminé la instalación.

Sacar la ruta correcta del puerto en Home Assistant

Una vez añadido el ZBT-2 en Home Assistant, el siguiente paso fue comprobar qué rutas estaba usando el sistema para ese coordinador. Para verlo fui a Configuración, después a Sistema, entré en Hardware y luego en Todo el hardware.

Ahí es donde puedes localizar tanto la ruta corta como la ruta estable del dispositivo. En mi caso aparecían referencias como ttyACM0 y también la ruta completa de /dev/serial/by-id/…, que es la realmente interesante para Zigbee2MQTT. Para buscarlo, una vez dentro de Todo el Hardware, pulsa ctrl+g y escribe usb, con eso llegarás enseguida

La ruta que yo utilicé fue esta:

/dev/serial/by-id/usb-Nabu_Casa_ZBT-2_DCB4D9XXXXXXX

Aquí hay un detalle importante: esa ruta incluye el número de serie de mi dispositivo, así que en tu instalación no tiene por qué coincidir exactamente. Lo importante no es copiar mi cadena tal cual, sino sacar la tuya desde Configuración > Sistema > Hardware > Todo el hardware.

El cambio en Zigbee2MQTT dentro de Home Assistant

Con esa información ya clara, entonces edité el archivo:

/config/zigbee2mqtt/configuration.yaml

Hasta entonces yo tenía algo tan simple como esto:

serial:
  port: /dev/ttyUSB0

Ese valor puede cambiar según cada instalación, así que no hay que copiarlo tal cual a ciegas. En el caso del ZBT-2, yo lo dejé así:

serial:
  port: /dev/serial/by-id/usb-Nabu_Casa_ZBT-2_DCB4Dxxxxxxx
  adapter: ember
  baudrate: 460800
  rtscts: true

Adapter, baudrate y rtcts si debes copiarlo igual, solo cambiará port.

Renombrar coordinator_backup

Este paso, en principio, no tendría por qué ser necesario. De hecho, puedes probar primero sin hacerlo. En mi caso, Zigbee2MQTT no llegó a arrancar correctamente con el nuevo coordinador hasta que renombré este archivo, así que lo incluyo como una posible solución si te encuentras con el mismo problema.

Después fui a la carpeta:

/config/zigbee2mqtt

Y renombré el archivo:

coordinator_backup.json

por otro nombre, por ejemplo:

coordinator_backup.sonoff-old.json

En mi caso, este paso fue el que evitó los errores al arrancar Zigbee2MQTT con el nuevo coordinador. Lo importante aquí es hacerlo con el add-on parado, para que no vuelva a generar ni a tocar archivos mientras estás haciendo cambios.

El momento de la verdad al arrancar Zigbee2MQTT

Con todo eso ya preparado, fui a Aplicaciones, entré en Zigbee2MQTT y le di a iniciar.

Aquí era donde realmente se veía si la migración había salido bien o no. En mi caso, el resultado fue bueno y se pasaron todos los dispositivos, o al menos todos los que tenía enlazados en ese momento. Esa era justo la parte que más me preocupaba, porque la idea era evitar tener que rehacer toda la red manualmente, y funcionó.

Eso sí, conviene tener paciencia. Los dispositivos no siempre reaparecen todos al instante. Algunos pueden tardar unos minutos en volver a anunciarse en la red, así que yo no daría la migración por fallida a los diez segundos.

Qué revisé después para asegurarme de que todo estaba bien

Aunque Zigbee2MQTT arrancó y la red pasó al nuevo coordinador, eso no significa que todo quede perfecto al primer intento. Después conviene revisar si algún dispositivo concreto se ha quedado raro.

En mi caso, el único que me dio guerra fue la lámpara de mesa de Philips Hue. No tuve que volver a enlazarla, pero sí tuve que entrar y darle a entrevistar dispositivo. Después de eso volvió a funcionar sin problema. El resto siguió funcionando bien.

Por eso, si haces esta migración, no me limitaría a comprobar que Zigbee2MQTT inicia. También revisaría algunos dispositivos importantes, sobre todo bombillas, enchufes y sensores que tengas metidos en automatizaciones.

Mi experiencia después de hacer el cambio

Después de pelearme con ello, la conclusión que saco es que migrar de un Sonoff Dongle-P al Home Assistant Connect ZBT-2 en Home Assistant con Zigbee2MQTT se puede hacer sin volver a enlazar todo, pero no es algo que yo presentaría como un proceso automático o libre de problemas. Hay varios puntos delicados, sobre todo con la IEEE, con la configuración del puerto serie y con el primer arranque del nuevo coordinador.

Aun así, en mi caso el resultado ha sido bueno y me ha permitido mantener la red Zigbee funcionando sin empezar desde cero, que al final era justo lo que buscaba.

Debo admitir, que me ha merecido la pena el cambio al ZBT-2, ahora me llega más fuerte la señal en todas las habitaciones, y eso que aún no he puesto el Sonoff Dongle-P como repetidor, no obstante, será el siguiente paso que haga, y os lo traeré en el próximo tutorial que voy a realizar los pasos a seguir para usarlo como repetidor.

También podría interesarte:

Home Assistant Connect ZBT-2: el nuevo adaptador Zigbee y Thread oficial para tu servidor

Análisis de la Govee Table Lamp 2 Pro x Sound by JBL tras más de 3 meses de uso

Aqara Sensor Multiestado P100: nuevo sensor con Matter, Thread y Zigbee