Shelly Wave en Home Assistant con Z-Wave JS

Publicado el 19-10-2026

Los módulos Shelly Wave usan Z-Wave Plus 800 con Long Range. Esto significa que no necesitan una red Wi-Fi cerca de cada módulo, no asignan una IP a cada dispositivo y la malla puede cubrir plantas y muros gruesos donde el Wi-Fi llega con dificultad. Para integrarlos en Home Assistant solo hace falta un dongle Z-Wave USB y el complemento Z-Wave JS UI.

Esta guía cubre la integración práctica: qué dongle elegir, cómo incluir el primer módulo, qué entidades genera cada modelo y cuándo elegir Shelly Wave en vez de Shelly Gen4.

Por qué Z-Wave en vez de Wi-Fi

Z-Wave opera a 868,4 MHz en Europa: una frecuencia que penetra mejor en paredes gruesas de ladrillo o piedra que las bandas de 2,4 GHz del Wi-Fi ^[1]. Los módulos forman una malla de repetición: cada módulo activo retransmite señales de los más alejados hacia el controlador, sin configuración manual.

Con Z-Wave Long Range (los modelos LR), los módulos pueden comunicarse directamente con el coordinador sin pasar por repetidores intermedios, lo que es una ventaja en edificios grandes con pocas tomas o en instalaciones donde no quieres añadir más nodos ^[6].

Z-Wave también es interoperable: el Wave 1PM LR se añade a cualquier red Z-Wave EU certificada, no solo a la de Shelly ^[1].

Qué necesitas: dongle Z-Wave y complemento Z-Wave JS UI

Para conectar módulos Z-Wave a Home Assistant necesitas un adaptador USB Z-Wave. Dos opciones disponibles en la tienda:

• Home Assistant Connect ZWA-2: chip ZG23 (serie 800) con Z-Wave y Z-Wave Long Range simultáneos en la misma red; los dispositivos LR y los de malla conviven sin configuración especial ^[6].
• Aeotec Z-Stick Gen5+: chip serie 700 con SmartStart (inclusión por QR) y cifrado S2; tiene un botón físico para incluir dispositivos sin necesitar el software activo ^[7].

Una vez conectado el dongle, en Home Assistant: Ajustes → Complementos → Z-Wave JS UI → instala y arranca. El complemento detecta el puerto USB del dongle y levanta la interfaz de gestión de la red Z-Wave.

Añadir el primer Shelly Wave: inclusión

Desde Z-Wave JS UI, el proceso de inclusión básico:

1. Pulsa Add device en la interfaz del complemento.
2. Z-Wave JS UI activa el modo de inclusión en el controlador.
3. Activa el modo de inclusión del módulo Shelly Wave: en el 1PM LR y el 2PM LR, con el botón de inclusión del módulo según su manual.
4. Si el dispositivo soporta SmartStart y tienes el Z-Stick Gen5+, puedes escanear el código QR del módulo para una inclusión automática sin pulsar botones ^[7].
5. El módulo aparece en la red con su nombre, canales y capacidades.

Para retirar un módulo de una red anterior o restablecer su estado: usa la opción Exclude device antes de incluirlo de nuevo. Sin excluir, el módulo seguirá intentando conectarse a la red anterior y no aceptará la inclusión.

Entidades generadas en Home Assistant

Cada modelo Shelly Wave genera entidades específicas al incluirse ^[5]:

Wave 1PM LR: relé de un canal (16 A máx., neutro requerido) ^[1].

• switch.nombre — enciende o apaga la carga.
• sensor.nombre_power — potencia activa en W.
• sensor.nombre_energy — energía acumulada en kWh.

Wave 2PM LR: dos canales independientes (10 A/canal, máx. 16 A total, neutro requerido) ^[2].

• switch.nombre_canal_1 y switch.nombre_canal_2 — cada canal por separado.
• Sensores de potencia y energía por canal.

Wave Shutter LR: control de persiana con motor de CA (neutro requerido, calibración previa) ^[3].

• cover.nombre — posición de la persiana en porcentaje, una vez calibrado.

Wave Plug S: enchufe interior con medición (Z-Wave Plus 800, controlador Z-Wave necesario) ^[4].

• switch.nombre — enciende o apaga.
• sensor.nombre_power (W), sensor.nombre_current (A), sensor.nombre_voltage (V), sensor.nombre_energy (kWh).

Automatización básica: cortar al superar un umbral de consumo

Con el Wave 1PM LR o el Wave Plug S que miden vatios en tiempo real, puedes crear una automatización que corte la carga si el consumo supera un límite:

• Disparador: sensor de potencia sube por encima de un valor (por ejemplo, 2.000 W durante más de 30 segundos).
• Acción: llamar a switch.turn_off en la entidad del relé del mismo módulo.
• Opcional: notificación urgente al móvil antes del corte.

Esta automatización funciona completamente en local: no requiere internet, ni nube de Shelly, ni conexión activa fuera de la red doméstica ^[5].

Wave vs Gen4: cuándo elegir cada uno

El Gen4 es más fácil de arrancar: se conecta directamente al Wi-Fi de casa sin hardware extra. El Wave es la elección cuando hay muros gruesos, cuando el router no está cerca o cuando la instalación necesita fiabilidad industrial y una malla independiente de la red Wi-Fi del hogar. Más en la guía Shelly Wave modelo a modelo.

Wave LR: sin repetidores en edificios grandes

Los modelos LR (Long Range) del catálogo —1PM LR, 2PM LR, Shutter LR, Plug S— usan el chip S800 que soporta Z-Wave Long Range ^[1][2]. Los dispositivos LR se comunican directamente con el controlador a mayor distancia que los de malla estándar; los de malla conviven en la misma red sin necesidad de elegir ^[6].

En un edificio con varias plantas o con muros de obra gruesa, esto significa que un módulo en el sótano puede ser visto directamente por el controlador sin que haya ningún nodo Z-Wave intermedio en el camino.

Pasos

1. Conecta el dongle Z-Wave (ZWA-2 o Z-Stick Gen5+) a un puerto USB de Home Assistant o del equipo donde corra HA.
2. Instala el complemento Z-Wave JS UI desde la tienda de complementos de Home Assistant.
3. Configura el complemento: apúntalo al puerto USB del dongle y arráncalo.
4. Desde la interfaz de Z-Wave JS UI, activa el modo de inclusión y empareja el primer Shelly Wave pulsando su botón de inclusión.
5. Verifica que el módulo aparece con sus canales y que las entidades son visibles en Home Assistant.
6. Conecta la carga al módulo (con el diferencial del circuito cortado) y prueba el encendido desde HA.
7. Crea la primera automatización: por consumo (1PM LR o Plug S) o por estado (cualquier módulo).

Preguntas frecuentes

¿Pueden convivir Shelly Wave y Shelly Gen4 en el mismo Home Assistant?

Sí. La integración Z-Wave JS gestiona los módulos Wave, y la integración Shelly gestiona los Gen4 por Wi-Fi; son integraciones independientes que coexisten en el mismo panel de Home Assistant sin conflictos ^[5].

¿El Wave necesita un hub o controlador en la nube de Shelly?

No. Los módulos Wave solo necesitan un controlador Z-Wave en la misma red local. Home Assistant con el ZWA-2 o el Z-Stick Gen5+ actúa como ese controlador de forma completamente local, sin pasar por ningún servidor de Shelly ^[1][5].

¿Qué ocurre si se desconecta el dongle Z-Wave?

Z-Wave JS pierde el controlador y todos los módulos Wave quedan sin respuesta hasta que el dongle se vuelve a conectar. La red no se borra: al reconectar, Z-Wave JS recupera el estado de la red automáticamente ^[7].

¿La frecuencia EU es compatible con cualquier instalación?

Solo con instalaciones en Europa. El Wave opera a 868,4 MHz (EU) y no es compatible con controladores o módulos Z-Wave de banda norteamericana (908,4 MHz) ^[1]. Para instalaciones en España no hay restricción.

Fuentes

1. Shelly KB, Wave 1PM LR — https://kb.shelly.cloud/knowledge-base/shelly-wave-1pm-eu-lr (2026-10-01)
2. Shelly KB, Wave 2PM LR — https://kb.shelly.cloud/knowledge-base/shelly-wave-2pm-eu-lr (2026-10-01)
3. Shelly KB, Wave Shutter LR — https://kb.shelly.cloud/knowledge-base/shelly-wave-shutter-lr (2026-10-01)
4. Shelly KB, Wave Plug S LR — https://kb.shelly.cloud/knowledge-base/shelly-wave-plug-s-lr (2026-10-01)
5. Home Assistant, integración Z-Wave JS — https://www.home-assistant.io/integrations/zwave_js/ (2026-10-15)
6. Home Assistant, Connect ZWA-2 — https://www.home-assistant.io/connect/zwa-2/ (2026-10-07)
7. Aeotec, Z-Stick Gen5+ — https://aeotec.com/products/aeotec-z-stick-gen5-plus/ (2026-10-15)

Este artículo se ha elaborado con inteligencia artificial y puede contener errores. Si ves alguno, escríbenos a info@comfortek.es y lo corregimos.