Instalar Shelly Wave con Z-Wave LR en Home Assistant

Publicado el 20-10-2026

Para instalar un Shelly Wave en Home Assistant hacen falta un adaptador USB Z-Wave como el Home Assistant Connect ZWA-2 y el complemento Z-Wave JS UI [1][2]. Son siete pasos: conectar el adaptador, instalar el complemento, añadir la integración Z-Wave, incluir el módulo por SmartStart o de forma manual, verificar las entidades, conectar la carga y crear una automatización. Los modelos LR hablan directamente con el coordinador, sin repetidores [3].

Antes de empezar: ten a mano los módulos Shelly Wave y el adaptador Home Assistant Connect ZWA-2, con Home Assistant ya en marcha. Más abajo están la configuración de Z-Wave JS, la inclusión por SmartStart y manual, la estructura de entidades del Wave 1PM LR, el Wave 2PM LR y el Wave Shutter, y ejemplos de automatizaciones YAML. Para decidir entre Shelly Wave y Shelly Gen4, consulta la guía Shelly Gen4 vs Wave: cuándo elegir cada uno.

Qué necesitas

El ZWA-2 y el Z-Stick Gen5+ usan el mismo complemento Z-Wave JS UI; la diferencia es que el Gen5+ tiene un botón físico para incluir dispositivos sin tener el software activo, útil en la puesta en marcha in situ [6].

Pasos

  1. Conectar el ZWA-2. Enchufa el ZWA-2 a un puerto USB del servidor de Home Assistant. Si corre en una Raspberry Pi o en un NUC, usa un cable alargador para alejarlo de la placa y evitar interferencias de USB 3.0 [1].
  1. Instalar Z-Wave JS UI. En Home Assistant ve a Ajustes → Complementos → Tienda de complementos y busca Z-Wave JS UI. Instálalo, activa «Arrancar al inicio» y «Mostrar en barra lateral». El complemento detecta automáticamente el dongle ZWA-2 en el puerto USB [2].
  1. Añadir la integración Z-Wave en HA. Tras arrancar Z-Wave JS UI, Home Assistant muestra una notificación para añadir la integración Z-Wave JS. Acepta la integración o ve a Ajustes → Dispositivos y servicios → Añadir integración → Z-Wave. Apunta la integración al socket del complemento Z-Wave JS UI (normalmente ws://localhost:3000) [2].
  1. Incluir el primer módulo Wave. Hay dos métodos:
  1. Verificar entidades en Home Assistant. Una vez incluido, el módulo aparece en Ajustes → Dispositivos y servicios → Z-Wave con sus entidades. Verifica que el nombre es descriptivo y renómbralo si es necesario antes de continuar.
  1. Conectar la carga. Con el diferencial del circuito cortado, conecta la carga al terminal de salida del módulo según su manual. Vuelve a energizar y prueba el encendido y apagado desde Home Assistant.
  1. Crear las primeras automatizaciones. Con el dispositivo funcionando, añade al menos una automatización para verificar el control automatizado (ver sección más abajo).

Entidades por modelo

Wave 1PM LR — relé 1 canal con medición

El Wave 1PM LR genera tres entidades principales en HA [3]:

Admite hasta 16 A (neutro obligatorio). Cada canal funciona de forma completamente independiente.

Wave 2PM LR — relé 2 canales con medición

El Wave 2PM LR genera entidades para cada canal por separado [4]. Cada canal aguanta hasta 10 A; la carga total entre ambos canales no puede superar 16 A:

Para conectar dos cargas distintas (por ejemplo, dos luminarias en dos habitaciones), cada una va al terminal del canal correspondiente (L1 OUT / L2 OUT). Los dos canales son completamente independientes y se pueden automatizar por separado o de forma conjunta.

Wave Shutter LR — persiana motorizada

El Wave Shutter LR se incluye en HA como entidad de tipo cover una vez calibrado [5]. Sin calibración solo responde a comandos de subida y bajada, pero no reporta posición:

Calibración: desde la interfaz del dispositivo en Z-Wave JS UI, activa el parámetro de calibración automática (el módulo sube y baja la persiana para medir los tiempos). Tras calibrar, el cover reporta la posición real y acepta el set_position.

Inversión de polaridad: si la persiana sube cuando HA pide bajar (cableado invertido), activa el parámetro de inversión de dirección en la configuración del nodo Z-Wave JS UI sin necesidad de repasar el cableado.

Automatizaciones YAML

Encender a una hora fija

Enciende el Wave 1PM LR (o cualquier switch) a las 7:00 todos los días laborables:

alias: "Wave 1PM — encender a las 7:00"
trigger:
  - platform: time
    at: "07:00:00"
condition:
  - condition: time
    weekday: [mon, tue, wed, thu, fri]
action:
  - action: switch.turn_on
    target:
      entity_id: switch.wave_1pm_cocina
mode: single

Apagar si no hay movimiento

Con un sensor de presencia o movimiento Zigbee o Z-Wave ya integrado en HA, apagar el Wave 1PM LR si no hay movimiento en los últimos 15 minutos:

alias: "Wave 1PM — apagar sin movimiento"
trigger:
  - platform: state
    entity_id: binary_sensor.sensor_movimiento_cocina
    to: "off"
    for:
      minutes: 15
action:
  - action: switch.turn_off
    target:
      entity_id: switch.wave_1pm_cocina
mode: single

Posicionar persiana según hora

Con el Wave Shutter LR calibrado, bajar la persiana al 30 % al mediodía en verano:

alias: "Wave Shutter — bajar al 30% al mediodía"
trigger:
  - platform: time
    at: "13:00:00"
condition:
  - condition: sun
    after: sunrise
    after_offset: "04:00:00"
action:
  - action: cover.set_cover_position
    target:
      entity_id: cover.wave_shutter_salon
    data:
      position: 30
mode: single

Rango Z-Wave LR y límites de red

Los módulos LR (los que llevan «LR» en el nombre) usan Z-Wave Long Range: se comunican directamente con el coordinador sin necesitar repetidores intermedios. El chip S800 del Wave LR tiene un alcance declarado de hasta 1.200 m en campo abierto sin obstáculos [3]; en interiores con muros gruesos el alcance real es significativamente menor, pero sigue superando al Z-Wave clásico de malla.

Los módulos LR y los de malla estándar conviven en la misma red sin configuración especial: el ZWA-2 gestiona ambos tipos en paralelo [1].

El límite estándar de una red Z-Wave es 232 nodos por controlador. En instalaciones domésticas y pequeño comercio este límite rara vez se alcanza.

Preguntas frecuentes

¿El Wave necesita hub adicional o cuenta en la nube de Shelly? No. El ZWA-2 actúa como coordinador local. Los módulos Wave no requieren ni internet ni servidor externo para funcionar; toda la automatización corre en Home Assistant en local [2].

¿Funciona sin internet? Sí. Z-Wave es un protocolo completamente local: los módulos Wave responden a comandos, ejecutan temporizaciones y reportan su estado aunque no haya conexión a internet. Solo el acceso remoto (app fuera de casa) requiere que HA esté accesible desde exterior, por ejemplo mediante Nabu Casa [2].

¿Cuántos dispositivos Wave por controlador? El límite de la red Z-Wave es 232 nodos por controlador. Para la mayoría de instalaciones domésticas o de pequeño comercio este límite no se alcanza; una vivienda típica tiene entre 10 y 40 módulos. Si el proyecto supera los 200 dispositivos, se estudia un segundo controlador o se valora fragmentar la instalación [2].

¿SmartStart funciona con el ZWA-2 o solo con el Z-Stick Gen5+? Con ambos. SmartStart es una función del estándar Z-Wave S800 y está disponible en el ZWA-2 y en el Z-Stick Gen5+. Se activa desde la interfaz Z-Wave JS UI sin diferencias entre los dos dongles [1][6].

¿Puedo usar el Wave 2PM LR para controlar una persiana? El 2PM LR tiene dos canales de relé pero no incluye lógica de interbloqueo automática entre ellos (que impide subir y bajar a la vez). Para persianas motorizadas con CA, usa el Wave Shutter LR, que tiene el interbloqueo y la calibración de posición integrados [4][5].

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.