Zigbee en Home Assistant en la nube: conecta un SLZB-06M y olvídate de los cambios de IP

Miles de bombillas, enchufes, sensores, mandos y termostatos hablan Zigbee, de marcas como Aqara, Philips Hue, IKEA, SONOFF, Tuya y muchas otras: una red de radio de bajo consumo que necesita un coordinador cerca de los dispositivos, es decir, en tu casa. Si tu Home Assistant está en la nube, la pieza que une las dos cosas es un coordinador Zigbee de red, como el SMLIGHT SLZB-06M: se conecta por cable a tu router y Home Assistant habla con él a través de internet. Aquí te contamos cómo montarlo para que no se corte cuando cambia la IP de tu casa y sin dejar la puerta abierta a cualquiera.

Cómo funciona y qué hay que resolver

La integración Zigbee Home Automation (ZHA) de Home Assistant se conecta al coordinador por un puerto TCP, el 6638. Con Home Assistant en la nube, esa conexión llega a la dirección pública de tu casa y el router la pasa al coordinador. Eso plantea dos problemas:

La IP de tu casa cambia. Casi todas las operadoras dan una IP pública que cambia de vez en cuando. Si ZHA apunta a la IP, cada cambio lo deja sin conexión hasta que lo vuelves a configurar.
Un puerto abierto es una puerta. Quien llegue al puerto 6638 puede hablar con tu red Zigbee. No se puede dejar abierto para todo internet.

El propio coordinador resuelve las dos cosas: su firmware (SLZB-OS) actualiza un nombre de DNS dinámico cada vez que cambia la IP, y solo acepta conexiones de la dirección que tú le digas.

Qué necesitas

Un coordinador SMLIGHT SLZB-06M (u otro de la serie SLZB-06) con el firmware de coordinador Zigbee, conectado por cable de red.
Acceso a la configuración de tu router, para reservar una IP local y abrir un puerto.
Una cuenta gratuita de DNS dinámico. En el ejemplo usamos DuckDNS.
Tu Home Assistant en la nube.

Si tu operadora usa CGNAT (tu router no tiene una IP pública propia), abrir puertos no funciona. Estamos preparando una forma de conectar el coordinador sin abrir puertos; la contaremos en el blog.

¿Qué dispositivos funcionan?

Zigbee es un estándar, así que no dependes de una marca: la gran mayoría de los dispositivos Zigbee 3.0 funcionan con ZHA, y el SLZB-06M admite hasta 200. Antes de comprar uno, busca el modelo exacto en la base de compatibilidad de Zigbee, que indica si funciona con ZHA.

Un aviso si compras en IKEA: su gama nueva, como las bombillas KAJPLATS, usa Matter sobre Thread en lugar de Zigbee. El SLZB-06M también puede hacer de radio Thread por red, igual que con Zigbee; estamos probando si funciona con Home Assistant en la nube y lo contaremos en el blog. Si hoy quieres ir sobre seguro, los productos TRÅDFRI anteriores son Zigbee.

Paso 1: prepara el coordinador

Entra en la web del coordinador (su IP local) y actualiza SLZB-OS a la última versión estable desde el apartado de actualizaciones. El DNS dinámico y la lista de IP permitidas necesitan una versión reciente.
Comprueba que el modo de trabajo es coordinador Zigbee y que el puerto es el 6638.
En tu router, reserva una IP local fija para el coordinador (en la configuración de DHCP), para que el reenvío del puerto no se rompa.

Paso 2: un nombre que siga a tu IP

Crea un subdominio en DuckDNS, por ejemplo micasa.duckdns.org, y copia tu token.
En la web del coordinador, abre el apartado DDNS, activa Enable DDNS client y rellena estos tres campos:

Public IP provider request URL (dónde consultar tu IP pública): https://api.ipify.org
DDNS provider request URL (la dirección que actualiza tu nombre): https://www.duckdns.org/update?domains=micasa&token=TU_TOKEN&ip={{ip}}
Update interval (cada cuántos segundos comprueba): 300.

A partir de ahí, cuando cambie la IP de tu casa, el propio coordinador actualiza el nombre en unos minutos. Si tu router ya trae un cliente de DNS dinámico, también puedes usar ese.

Paso 3: cierra la puerta a los demás

En la web del coordinador, en el apartado Security, activa Enable IP whitelist for socket y, en Allowed IP, añade la dirección IP de tu instancia de Coiaca Cloud HA, que te damos nosotros. Si no la encuentras, escríbenos a support@coiaca.com y te la enviamos. Así, aunque alguien encuentre el puerto abierto, el coordinador rechaza la conexión. No abras el puerto sin este paso.

Paso 4: abre el puerto en el router

En el router, busca el apartado de reenvío de puertos (puede llamarse port forwarding, NAT o servidores virtuales) y crea una regla: protocolo TCP, puerto externo 6638, hacia la IP local del coordinador, puerto 6638. Si tu router permite limitar la regla por IP de origen, pon también ahí la IP de tu instancia: es una segunda cerradura.

Paso 5: conecta Zigbee Home Automation

En Home Assistant, ve a Ajustes → Dispositivos y servicios → Añadir integración → Zigbee Home Automation, y elige introducir la conexión a mano.
Tipo de radio: EZSP (el SLZB-06M lleva un chip de Silicon Labs).
Ruta: socket://micasa.duckdns.org:6638, con el nombre en vez de la IP. Velocidad: 115200.

Si ya tenías ZHA funcionando con la IP, no hace falta empezar de cero: desde las opciones de la integración se cambia la ruta del adaptador y tu red Zigbee se conserva.

Paso 6: compruébalo y añade tus dispositivos

Reinicia el router para forzar un cambio de IP. En nuestra prueba, a los 5 minutos (el intervalo que pusiste) el nombre ya apuntaba a la IP nueva. Mientras tanto, ZHA aparece con error en Integraciones; no toques nada: en cuanto el nombre se actualiza, vuelve a conectar solo. Después, en ZHA pulsa Añadir dispositivo y pon cada bombilla, mando o sensor en modo de emparejamiento, como explique su manual. Se emparejan igual que con un coordinador en casa.

Lo que conviene saber

La documentación de ZHA no recomienda usar el coordinador a través de internet, por la latencia y los cortes. En nuestra instalación funciona estable, pero una conexión muy inestable se va a notar.
Si se corta internet en tu casa, Home Assistant deja de controlar tus dispositivos Zigbee hasta que vuelve.
El cambio de IP no es instantáneo: entre que cambia y el nombre se actualiza pueden pasar hasta 5 minutos sin Zigbee (como mucho, el intervalo que configuraste). Si bajas el intervalo a 60 segundos, el corte es más corto.

Zigbee en tu Home Assistant en la nube

Coiaca Cloud HA es el Home Assistant oficial, sin modificar, en tu propia instancia privada, con ZHA disponible como en cualquier Home Assistant y Zigbee2MQTT activable con un botón. Llega listo en unos 15 minutos, con dirección HTTPS para la app y un broker MQTT con TLS ya configurado.

Con los 30 días de prueba gratis puedes conectar tu coordinador y tus primeros dispositivos Zigbee sin pagar nada. Si no es para ti, cancelas antes del día 31.

Prueba Coiaca Cloud HA 30 días gratis

Fuentes

Coiaca no está afiliada a SMLIGHT, Aqara, Signify (Philips Hue), IKEA, SONOFF, Tuya, Open Home Foundation ni Nabu Casa. Las marcas citadas son de sus titulares.