La columna vertebral de una casa inteligente no debería depender de la nube de un fabricante ni de su conexión a internet. Para lograr un sistema domótico profesional, privado y rápido, el estándar a seguir es zigbee.
En esta guía técnica explico la arquitectura, el hardware necesario y el proceso paso a paso para desplegar tu propia red zigbee local utilizando Home Assistant y Zigbee2MQTT.
Por qué elegir zigbee frente a wifi
A diferencia del wifi, que está diseñado para mover grandes paquetes de datos, zigbee está optimizado para enviar tramas de información minúsculas (estados binarios, lecturas de sensores). Esto ofrece dos ventajas críticas:
- Consumo energético mínimo: los sensores de batería pueden funcionar durante años sin mantenimiento.
- Red en malla (mesh): cada dispositivo alimentado por corriente (enchufes, bombillas) actúa como repetidor. Esto extiende y fortalece la señal automáticamente, eliminando los puntos muertos de cobertura en la vivienda.
Arquitectura del sistema
Para integrar este protocolo en Home Assistant sin depender de hubs propietarios (como los de Philips Hue o Xiaomi), implementaremos la siguiente pila tecnológica:
- Coordinador (hardware): el dispositivo físico que actúa como antena y cerebro de la red.
- Mosquitto broker: el servidor MQTT que actúa como intermediario de mensajería.
- Zigbee2mqtt: el software que gestiona la red zigbee y traduce los estados a mensajes MQTT.
- Home assistant: el orquestador que lee estos mensajes y ejecuta las automatizaciones.
Hardware recomendado para la instalación
La estabilidad de la red depende casi exclusivamente de la calidad del coordinador y de los routers (repetidores). A continuación, listo los componentes probados que utilizo en mi infraestructura para garantizar compatibilidad total con Zigbee2MQTT.
Infraestructura base
Estos son los elementos obligatorios para iniciar la red. El coordinador debe conectarse siempre con un cable de extensión USB para evitar interferencias electromagnéticas del puerto USB 3.0.
Sensores y actuadores
Una vez establecida la malla, estos son los sensores finales que recomiendo por su relación calidad-precio y velocidad de respuesta.
Configuración paso a paso
Sigue este proceso secuencial para evitar errores de comunicación entre los servicios.
1. Creación del usuario mqtt
Home Assistant necesita un usuario específico para gestionar el tráfico de mensajes.
- Ve a Ajustes > Personas y crea un nuevo usuario (ej:
mqtt-user). - Es imperativo marcar la opción para permitir el inicio de sesión solo desde la red local por seguridad.
2. Identificación del puerto serial
Necesitamos la ruta absoluta del coordinador USB.
- Conecta el coordinador al puerto USB.
- Ve a Ajustes > Sistema > Hardware > Todo el hardware.
- Busca en la lista el dispositivo que coincida con tu coordinador.
- Copia la línea que comienza por
/dev/serial/by-id/.... No uses la ruta corta (/dev/ttyUSB0) ya que puede cambiar al reiniciar.
3. Instalación del broker (mosquitto)
- En la tienda de complementos (Add-ons), busca e instala Mosquitto Broker.
- Inicia el complemento.
- Ve a Dispositivos y servicios, la integración MQTT debería aparecer como descubierta. Configúrala para finalizar la vinculación.
4. Despliegue de zigbee2mqtt
Este software no está en los repositorios oficiales por defecto, deberás añadir el repositorio de Zigbee2MQTT primero.
- Instala el complemento pero no lo inicies aún.
- Ve a la pestaña Configuración del complemento.
- En la sección
mqtt, introduce el usuario y contraseña creados en el paso 1. - En la sección
serial, pega la ruta/dev/serial/by-id/...obtenida en el paso 2. - Guarda e inicia el complemento. Revisa los registros (logs) para confirmar que no hay errores de conexión.
Vinculación de dispositivos
Para añadir un nuevo dispositivo:
- Abre la interfaz web de Zigbee2MQTT desde la barra lateral.
- Pulsa el botón «Permitir unión (todos)».
- Pon tu dispositivo físico en modo emparejamiento (generalmente manteniendo pulsado el botón de reset 5 segundos).
El sistema detectará el dispositivo, intercambiará las claves de encriptación y lo expondrá automáticamente en Home Assistant. Es recomendable renombrar el dispositivo inmediatamente dentro de Zigbee2MQTT y marcar la opción de actualizar el ID de la entidad en Home Assistant para mantener el orden.