Qué es "incluir" un módulo Z-Wave
En Z-Wave, incluir (o empairejar) un módulo significa añadirlo a la red del controlador. Hasta que no está incluido, el módulo no recibe ni envía ninguna orden: es un dispositivo ciego. El controlador —en una instalación con Home Assistant, el adaptador Z-Wave USB o de PCIe gestionado por Z-Wave JS— es el nodo primario de la red. Todo lo que quieres automatizar tiene que ser incluido primero.
El proceso implica dos partes: poner el controlador en modo de inclusión y, al mismo tiempo, activar el modo de inclusión en el módulo. Si ambos coinciden en ese estado en el momento adecuado, el emparejamiento se completa en segundos. Si no coinciden, no pasa nada. Sin aviso de error. Sin explicación. Simplemente no pasa.
Ese silencio es lo que desorienta la primera vez.
El proceso paso a paso
- Entra en Z-Wave JS en Home Assistant (Configuración → Integraciones → Z-Wave → Configurar).
- Haz clic en «Añadir dispositivo». El controlador entra en modo de inclusión: tiene un tiempo limitado para detectar nuevos módulos.
- En el módulo que quieres incluir, activa su modo de inclusión. Cómo se hace depende del modelo: en los módulos Fibaro (Grupo Nice) suele ser pulsar el botón de configuración un número específico de veces seguido; en la documentación de cada modelo está indicado.
- Si el controlador detecta el módulo, aparece en pantalla y te pide confirmar. Si es compatible con S2 (el marco de seguridad actual de Z-Wave), te pedirá el DSK o PIN del módulo, que viene impreso en la caja o en la pegatina del dispositivo.
- Una vez incluido, Home Assistant hace la entrevista: descubre las capacidades del módulo (qué comandos acepta, qué reporta, qué parámetros tiene). Este paso puede tardar entre unos segundos y varios minutos. No lo interrumpas.
La entrevista inicial es el paso que más confunde: el módulo aparece en la lista pero durante un rato muestra datos incompletos o no responde a las órdenes. No está roto. Está terminando de reportar sus capacidades. Espera a que la entrevista se marque como completada en Z-Wave JS antes de probarlo.
Por qué los primeros módulos cuestan más
El proceso es técnicamente simple, pero tiene tres detalles que no son obvios hasta que te los has encontrado:
1. La secuencia de pulsaciones varía por modelo
No todos los módulos Z-Wave usan la misma secuencia para entrar en modo de inclusión. Algunos requieren tres pulsaciones cortas, otros una pulsación larga, otros una combinación. El manual del dispositivo específico es la única fuente fiable. Intentar hacerlo por intuición o por analogía con otro módulo que ya incluiste lleva directo a perder el tiempo.
2. La distancia al controlador importa en la inclusión inicial
Z-Wave es una red de malla: una vez instalada, los dispositivos conectados a la corriente actúan como repetidores y extienden la cobertura. Pero en el momento de la inclusión, el módulo tiene que comunicarse directamente con el controlador o a través de los nodos que ya están en la red. Si la red todavía es pequeña (pocos módulos incluidos) y el nuevo módulo está lejos, puede que la señal no llegue.
La práctica habitual es incluir el módulo estando cerca del controlador, y luego instalarlo en su posición definitiva. Una vez en sitio, se lanza la curación de red (Network Heal) para que el módulo descubra sus vecinos reales y actualice las rutas.
3. El módulo puede estar ya incluido en otra red
Los módulos Z-Wave no se pueden incluir en dos redes a la vez. Si el módulo ya estaba en otra instalación, hay que excluirlo primero. La exclusión se hace igual que la inclusión: controlador en modo de exclusión + secuencia de pulsaciones en el módulo. La exclusión borra la configuración de red del módulo y lo deja listo para incluirse en la tuya.
Tabla: causas frecuentes y qué hacer
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| El módulo no aparece durante la inclusión | Secuencia de pulsaciones incorrecta o timing desfasado | Consultar el manual del modelo exacto y repetir con cuidado |
| El módulo tampoco aparece estando cerca del controlador | Módulo ya incluido en otra red | Excluirlo primero: controlador en modo exclusión + pulsaciones en el módulo |
| La inclusión se completa pero el módulo no responde | Entrevista no terminada o ruta subóptima | Esperar a que la entrevista se complete; después lanzar Network Heal |
| Home Assistant pide un PIN o DSK que no encuentro | Seguridad S2 activa (correcto) | Buscar el código QR o la pegatina en la caja o lateral del módulo |
| El módulo aparece pero con entidades incompletas | Entrevista en curso | No hacer nada: esperar a que Z-Wave JS marque la entrevista como completada |
| Módulo en posición definitiva pierde señal | Red de malla no actualizada tras el montaje | Lanzar Network Heal desde Z-Wave JS |
La curación de red: cuándo y cómo
Cuando incluyes el primer o los primeros módulos cerca del controlador y luego los instalas en su sitio, la red «recuerda» las rutas del momento de la inclusión, no las definitivas. La curación de red (Network Heal) pide a cada nodo que redescubra sus vecinos y actualice sus tablas de enrutamiento.
Cuándo lanzarla:
- Después de instalar todos los módulos en su posición definitiva.
- Si mueves un módulo de sitio.
- Si añades módulos nuevos a una red ya existente.
La curación se lanza desde la interfaz de Z-Wave JS: panel de Z-Wave → opciones avanzadas → Network Heal. Tarda varios minutos dependiendo del número de dispositivos. No hay que hacer nada durante ese tiempo.
Cómo funciona la red de malla: por qué Z-Wave mejora con más módulos
Cada módulo Z-Wave conectado a la corriente actúa como nodo repetidor: recibe la señal del controlador y la reenvía al siguiente nodo. Esto significa que cuantos más módulos tiene la red, más rutas alternativas existen y más robusta es la cobertura. Una vivienda con diez módulos distribuidos en diferentes habitaciones tiene mucha más cobertura efectiva que la misma vivienda con dos módulos en puntos opuestos.
Los dispositivos de batería (sensores de puerta, detectores de movimiento, mandos) no repiten señal: solo la emiten cuando se activan. Para la malla importan los módulos de persiana, luz o enchufe que están siempre conectados.
Puedes leer más sobre cómo funciona el protocolo en nuestra página sobre la red Z-Wave y compararlo con Zigbee, Matter y WiFi en este artículo.
La diferencia entre S0 y S2 (y por qué no saltarte el PIN)
Z-Wave tiene dos marcos de seguridad para cifrar las comunicaciones entre el módulo y el controlador:
- S0: el estándar anterior, más antiguo. Funciona, pero genera tráfico adicional en la red.
- S2: el estándar actual. Más eficiente y más seguro. La mayoría de módulos fabricados en los últimos años lo soportan.
Durante la inclusión con S2, Home Assistant pide el DSK (un código de 40 dígitos, a veces presentado como QR) para verificar que el módulo que estás incluyendo es realmente el tuyo y no un dispositivo de un vecino. Si saltas ese paso, la inclusión se completa sin S2; el módulo funciona, pero sin el cifrado más reciente. No es urgente, pero conviene hacerlo bien desde el principio.
Si pierdes la caja del módulo y no tienes el DSK a mano: en algunos modelos Fibaro el código aparece en una pegatina en el lateral del módulo, dentro de la caja de mecanismos. Con una linterna se puede leer sin desmontar nada.
Si prefieres no pasar por este proceso
El proceso de inclusión no es difícil, pero tiene una curva de aprendizaje real. Si lo que quieres es que la domótica funcione desde el primer día, sin pasar por la fase de «¿por qué no aparece?», la opción son los packs Z-Wave de Comfortek: el material llega programado, con los módulos ya incluidos en el controlador y las escenas configuradas. Tu electricista lo monta; Comfortek acompaña en remoto. No hay que aprender el proceso de inclusión antes de que nada funcione.
Si tienes una vivienda sin obra donde la domótica inalámbrica es la única opción viable, puedes ver más en domótica inalámbrica sin obra.
Preguntas frecuentes
¿Qué significa incluir un módulo Z-Wave?
Incluir un módulo Z-Wave es el proceso de emparejarlo con el controlador (el hub, en este caso Home Assistant con Z-Wave JS). Hasta que no está incluido, el módulo no forma parte de la red y no recibe ni envía órdenes. El proceso requiere poner el controlador en modo de inclusión y activar el mismo modo en el módulo (normalmente pulsando su botón de configuración un número de veces seguido). Una vez completado, el módulo aparece en Home Assistant como una entidad lista para automatizar.
¿Por qué no se detecta el módulo Z-Wave al incluirlo?
Las causas más frecuentes son: (1) el módulo no está en modo de inclusión cuando el controlador lo busca —la secuencia exacta de pulsaciones varía según el fabricante y el modelo; (2) el módulo está demasiado lejos del controlador o del nodo repetidor más cercano —para incluir, conviene hacerlo cerca del controlador y luego moverlo al lugar definitivo; (3) el módulo ya está incluido en otra red y hay que excluirlo primero. En Z-Wave, la exclusión se hace igual que la inclusión pero poniendo el controlador en modo de exclusión.
¿Qué es la seguridad S2 en Z-Wave y tengo que activarla?
S2 (Security 2) es el marco de seguridad actual de Z-Wave. Cifra las comunicaciones entre el módulo y el controlador durante la inclusión. Z-Wave JS en Home Assistant lo activa por defecto si el dispositivo lo soporta. Durante la inclusión, Home Assistant puede pedirte el PIN o DSK del módulo (un código impreso en la caja o en el lateral del dispositivo) para verificar que el emparejamiento es con el módulo correcto. Si lo saltas, la inclusión se completa sin seguridad S2 (S0 o sin cifrado), lo que es funcional pero menos seguro. Lo recomendable es introducir el DSK cuando se pida.
¿Hace falta hacer una curación de red (network heal) después de incluir módulos?
Sí, especialmente si has incluido los módulos cerca del controlador y luego los has instalado en su posición definitiva. La curación de red (Network Heal en Z-Wave JS) obliga a cada nodo a redescubrir sus vecinos y a actualizar las rutas de comunicación. Si no la haces, algunos módulos pueden seguir usando rutas largas o subóptimas que calcularon durante la inclusión. La curación se lanza desde la interfaz de Z-Wave JS en Home Assistant; suele tardar varios minutos dependiendo del número de dispositivos.
¿Cuántos módulos Z-Wave puede tener una red en Home Assistant?
Z-Wave soporta hasta 232 nodos por red en la especificación estándar, suficiente para cualquier vivienda. En una instalación doméstica habitual con Home Assistant nunca se acerca a ese límite. Cada dispositivo conectado a la red eléctrica actúa además como repetidor (router), lo que mejora la cobertura en viviendas grandes. Los dispositivos de batería (sensores, mandos) no repiten señal.
¿Puedo incluir un módulo Z-Wave sin tocar el cuadro eléctrico?
Depende del tipo de módulo. Los módulos de carril DIN van en el cuadro eléctrico y los instala un electricista. Los módulos de micro formato (Fibaro Single Switch, Roll Control) van dentro de las cajas de mecanismos, detrás del interruptor o del mecanismo de persiana existente: no requieren tocar el cuadro, solo abrir la caja de empotrar. La inclusión en la red Z-Wave se hace igual en ambos casos: botón de configuración del módulo + controlador en modo inclusión.
¿En qué se diferencia incluir un módulo Z-Wave en Loxone del proceso en Home Assistant?
Loxone tiene su propio protocolo inalámbrico (Loxone Air) para sus dispositivos de radiofrecuencia, que se gestiona desde Loxone Config con un proceso de aprendizaje diferente. Z-Wave en Home Assistant usa el stack Z-Wave JS y el proceso de inclusión estándar del protocolo. Son ecosistemas distintos: los módulos Z-Wave no se incluyen en una central Loxone estándar, y los dispositivos Loxone Air no se añaden a Home Assistant de forma nativa.