Home Assistant Z-Wave JS: Guía Definitiva 2026

Actualizado el 20 de enero de 2026

Z-Wave sigue siendo uno de los protocolos más robustos y fiables para la domótica en 2026. Si utilizas Home Assistant y quieres construir una red de dispositivos estable, la integración Z-Wave Home Assistant a través de Z-Wave JS es, sin duda, el camino a seguir. Lo que comenzó como una revolución en la comunidad en 2021 es hoy el estándar de oro, consolidado y optimizado para ofrecer un rendimiento excepcional.

Este artículo es tu guía definitiva. Te explicaré desde los conceptos básicos hasta cómo instalar, configurar y solucionar los problemas más comunes para que domines tu red Z-Wave como un profesional.

¿Qué es Z-Wave JS y por qué es la integración definitiva?

Z-Wave JS es la integración oficial y recomendada para conectar dispositivos Z-Wave con Home Assistant. A diferencia de las antiguas integraciones que ya han sido eliminadas, Z-Wave JS funciona con una arquitectura desacoplada, lo que se traduce en mayor estabilidad y rendimiento.

Funciona así:

1. Controlador Z-Wave (Hardware): Un pincho USB (o «stick») que se conecta a tu servidor de Home Assistant y emite la señal de radio Z-Wave.
2. Add-on Z-Wave JS UI (Software): Es el cerebro. Este complemento de Home Assistant se comunica directamente con el controlador USB. Gestiona toda la red Z-Wave: inclusión de dispositivos, rutas de malla, parámetros de configuración, etc. Funciona de manera independiente a Home Assistant.
3. Integración Z-Wave JS (Conexión): Es el puente que conecta Home Assistant con el Add-on Z-Wave JS UI. Permite que tus dispositivos Z-Wave aparezcan como entidades en Home Assistant para que puedas controlarlos y usarlos en automatizaciones.

Esta separación es clave: si reinicias Home Assistant, tu red Z-Wave sigue funcionando sin interrupciones. Además, el equipo de Z-Wave JS puede lanzar actualizaciones y mejoras de compatibilidad con dispositivos de forma mucho más ágil.

Mejor Controlador Z-Wave para Home Assistant en 2026

La elección de un buen controlador USB es el primer paso y el más crucial para una red Z-Wave fiable. En 2026, la mayoría de los controladores de calidad utilizan los chipsets de la serie 800 de Silicon Labs, que ofrecen un rango mejorado, mayor seguridad y un menor consumo energético. He probado varios y aquí te presento mis recomendaciones:

Guía de Instalación: Configurar Z-Wave JS en Home Assistant

Con tu controlador en mano, vamos a ver el proceso paso a paso para tener tu red funcionando. Es más sencillo de lo que parece.

Paso 1: Conectar el Hardware

Conecta tu controlador Z-Wave a un puerto USB de la máquina que ejecuta Home Assistant (Raspberry Pi, NUC, etc.). Mi recomendación personal: utiliza siempre un cable alargador USB de al menos 1 metro. Esto aleja la antena del controlador de posibles interferencias generadas por el propio hardware del servidor, mejorando drásticamente la cobertura.

Paso 2: Instalar el Add-on Z-Wave JS UI

La comunidad ha adoptado Z-Wave JS UI como el add-on de referencia por su fantástica interfaz web que permite un control total sobre la red. Para instalarlo:

1. Ve a Ajustes > Complementos > Tienda de Complementos.
2. Busca «Z-Wave JS UI» y haz clic en él.
3. Pulsa Instalar y espera a que finalice el proceso.
4. Una vez instalado, activa las opciones «Iniciar en el arranque» y «Vigilante».

Paso 3: Configurar el Add-on

Antes de iniciar el add-on, debemos configurarlo:

1. Ve a la pestaña Configuración dentro del complemento.
2. En la sección «Serial Port», selecciona el dispositivo correspondiente a tu controlador. Normalmente será algo como /dev/ttyACM0 o similar.
3. ¡MUY IMPORTANTE! En la misma pestaña, desplázate hacia abajo hasta encontrar las claves de seguridad (S0_Legacy, S2_AccessControl, S2_Authenticated, S2_Unauthenticated). Haz clic en los iconos del dado para generar claves aleatorias y seguras.
4. Guarda estas claves en un lugar seguro (un gestor de contraseñas, por ejemplo). Si algún día tienes que migrar tu instalación, las necesitarás para que tus dispositivos de seguridad (cerraduras, sensores) sigan funcionando.
5. Guarda los cambios y arranca el complemento desde la pestaña «Información».

Paso 4: Añadir la Integración Z-Wave JS

Con el servidor ya funcionando, es hora de conectarlo a Home Assistant:

1. Ve a Ajustes > Dispositivos y Servicios.
2. Home Assistant debería haber descubierto automáticamente tu servidor Z-Wave JS. Verás una tarjeta pidiéndote configurar. Haz clic en Configurar.
3. Si no lo descubre, pulsa en Añadir Integración, busca «Z-Wave JS» y selecciónalo.
4. Te pedirá la URL del servidor. Desmarca la casilla y usa la URL por defecto: ws://a0d7b954-zwavejs-ui:3000. Esta es la dirección interna para comunicarse con el add-on.
5. ¡Listo! Tus dispositivos Z-Wave comenzarán a aparecer en Home Assistant a medida que los vayas añadiendo.

Cómo Migrar Z-Wave a Z-Wave JS (Desde la antigua integración)

Aunque la antigua integración zwave basada en OpenZWave 1.4 fue eliminada del código de Home Assistant hace años, es posible que alguna instalación muy antigua aún la conserve. Si es tu caso, la migración es delicada pero factible.

1. Haz una copia de seguridad completa: Es el paso más importante. Usa la función de copias de seguridad de Home Assistant y guárdala en un lugar externo. Para automatizar este proceso, puedes integrar Google Drive para copias de seguridad avanzadas.
2. Encuentra tu clave de red (Network Key): La antigua integración guardaba una clave de seguridad de 16 bytes. Búscala en tu archivo configuration.yaml o, más probablemente, en un archivo llamado options.xml dentro de tu carpeta de configuración. Tendrá un formato como 0xAB, 0xCD, 0xEF.... Necesitarás esta clave.
3. Detén Home Assistant: Apaga completamente la instancia de Home Assistant.
4. Elimina la configuración antigua: Comenta o elimina la línea zwave: de tu archivo configuration.yaml.
5. Sigue la guía de instalación anterior: Realiza los pasos 1, 2 y 3 de la guía de instalación de Z-Wave JS UI. La única diferencia es que, en el Paso 3, en el campo de configuración S0_Legacy, deberás introducir la clave de red que recuperaste en el punto 2. Esto es VITAL para que los dispositivos de seguridad sigan funcionando.
6. Inicia todo y renombra entidades: Arranca el add-on y luego Home Assistant. La integración Z-Wave JS debería tomar el control. Es casi seguro que los nombres de las entidades habrán cambiado. Tendrás que revisar tus automatizaciones, scripts y paneles para adaptarlos a las nuevas IDs.

Preguntas Frecuentes (FAQ) sobre Home Assistant Z-Wave JS

¿Mi dispositivo Z-Wave no se incluye (empareja)?

Primero, intenta excluir el dispositivo desde la interfaz de Z-Wave JS UI (incluso si nunca fue incluido). A veces los dispositivos vienen «pre-incluidos» de fábrica. Acerca el dispositivo al controlador (a 1-2 metros) durante la inclusión. Si sigue fallando, consulta el manual del dispositivo; algunos requieren una secuencia específica de pulsaciones.

¿Por qué algunos de mis dispositivos aparecen como «Unknown» o «Dispositivo Desconocido»?

Esto suele significar que el dispositivo no ha completado su «entrevista» (el proceso donde informa de todas sus capacidades). Si es un dispositivo a pilas, asegúrate de despertarlo manualmente (normalmente pulsando un botón) para que pueda comunicarse. Desde la interfaz de Z-Wave JS UI, puedes forzar una re-entrevista del nodo.

¿Qué es la interfaz de Z-Wave JS UI y para qué la necesito?

Es el panel de control avanzado de tu red Z-Wave. Mientras que la integración en Home Assistant te permite el control diario, la Z-Wave JS UI te da acceso a herramientas de diagnóstico, visualización de la malla de red, configuración de parámetros avanzados de cada dispositivo, actualizaciones de firmware y mucho más. Es una herramienta indispensable para un administrador de domótica serio.

¿Z-Wave o Zigbee? ¿Cuál es mejor en 2026?

No hay un «mejor», son diferentes y se complementan. Z-Wave opera en la banda sub-GHz (868 MHz en Europa), lo que evita interferencias con el Wi-Fi de 2.4 GHz y ofrece una mejor penetración en paredes. Es un estándar más estricto, lo que garantiza mayor compatibilidad. Zigbee, por otro lado, tiene un ecosistema de dispositivos mucho más amplio y económico. Mi recomendación es usar ambos. Puedes aprender a configurar Zigbee con nuestra guía definitiva de ZHA o la guía completa de Zigbee2MQTT.

Conclusión

La combinación de Home Assistant y Z-Wave JS representa la cúspide de la domótica de código abierto en 2026. Ofrece una plataforma increíblemente potente, rápida y fiable para construir una red Z-Wave robusta. Aunque la configuración inicial requiere atención al detalle, especialmente con las claves de seguridad, el resultado es un sistema que te dará el control total sobre tu hogar inteligente, libre de nubes y suscripciones.