Guía para integrar persianas automáticas en Home Assistant

Integrar persianas automáticas en Home Assistant es uno de esos proyectos que parecen sencillos sobre el papel y que, en la práctica, acumulan horas de búsquedas, cables sueltos y configuraciones que no arrancan. El problema no es la plataforma —Home Assistant es potente y flexible— sino entender qué hardware tienes, qué protocolo usa y cómo hacer que todo hable el mismo idioma sin que la persiana se quede a medias a las tres de la tarde.

Si vives en Valencia o en cualquier municipio cercano, probablemente ya tienes instalado un motor tubular de alguna marca conocida: Somfy, Nice, Came, Faac o Cherubini son las más habituales por aquí. El reto es que muchos de esos motores llevan años funcionando con un mando de radio de 433 MHz y sin ningún módulo WiFi o Zigbee de serie. No están pensados para domótica, pero eso no significa que no se puedan integrar. Significa que hay que saber qué pieza añadir y dónde.

En esta guía encontrarás los requisitos reales de hardware y software, los protocolos que mejor funcionan con Home Assistant, cómo configurar las entidades de cobertura (cover) paso a paso, los errores más comunes y cuándo tiene sentido llamar a un instalador en lugar de seguir peleando con el YAML un sábado por la mañana.

Requisitos previos: hardware, red y versión de Home Assistant

Antes de tocar ningún archivo de configuración, hay que tener claro qué tienes instalado y qué necesitas añadir. Saltarse este paso es la causa número uno de frustraciones en este tipo de proyectos.

El motor y su tipo de control

Los motores tubulares para persianas enrollables, toldos y cierres se controlan de tres formas distintas:

• Radio de 433 MHz o 868 MHz: el más extendido en instalaciones residenciales de Valencia. El motor no tiene conectividad nativa; necesitas un puente como el Somfy Connexoon, el Nice Home o un receptor universal con módulo WiFi.
• Cable de control (normalmente 5 hilos: fase, neutro, tierra, subir, bajar): permite conectar directamente un relé inteligente o un microcontrolador sin tocar el motor.
• Bus propietario (io-homecontrol de Somfy, BUS2 de Nice): requiere pasarela oficial o módulo de integración específico. No todos son compatibles con Home Assistant de forma nativa.

Lo primero es identificar el modelo del motor. Está grabado en la etiqueta lateral del tubo o en la documentación de la instalación. Con ese modelo puedes buscar en la lista oficial de integraciones de Home Assistant si existe soporte directo.

La red local

Home Assistant funciona mejor con dispositivos en la misma red local de 2,4 GHz para WiFi, o con un coordinador Zigbee o Z-Wave conectado al servidor. Si tu router separa la red de invitados de la principal, asegúrate de que el servidor de Home Assistant y los módulos de las persianas están en la misma VLAN. Parece obvio, pero es uno de los fallos más frecuentes.

Versión de Home Assistant

Usa siempre Home Assistant OS o Home Assistant Supervised si puedes elegir. Las integraciones de persianas (especialmente las que usan HACS) se actualizan con frecuencia y algunas dependen de add-ons que no están disponibles en Home Assistant Core. La versión mínima recomendable para trabajar con comodidad es la 2023.x o superior.

Protocolos de comunicación: Zigbee, Z-Wave, WiFi y radio 433 MHz

Elegir el protocolo correcto desde el principio te ahorra cambiar hardware a mitad del proyecto. Cada uno tiene ventajas claras y limitaciones reales.

Zigbee

Zigbee es la opción más recomendable para instalaciones nuevas o cuando se añaden varios dispositivos. Funciona en malla —cada dispositivo activo refuerza la señal— y consume muy poca energía. Necesitas un coordinador Zigbee conectado al servidor de Home Assistant: el Sonoff Zigbee 3.0 USB Dongle Plus o el HUSBZB-1 son dos opciones solventes por menos de 25 €.

Para persianas, los módulos más usados con Zigbee son el Zemismart ZM25TQ y los módulos de la serie Tuya Zigbee. Funcionan con la integración Zigbee2MQTT (add-on de Home Assistant) o con ZHA (integración nativa). Zigbee2MQTT tiene mejor soporte para motores menos conocidos.

Z-Wave

Z-Wave trabaja en la banda de 868 MHz en Europa, lo que reduce las interferencias con el WiFi doméstico. Es más caro que Zigbee pero históricamente más estable. Si ya tienes una instalación Z-Wave en casa, añadir persianas con módulos como el Fibaro FGR-223 o el Qubino ZMNHCD es una opción muy robusta. El Fibaro FGR-223 permite además calibrar el tiempo de apertura y cierre para controlar la posición exacta de la persiana en porcentaje.

WiFi con firmware Tasmota o ESPHome

Si tienes módulos baratos basados en ESP8266 o ESP32 (Sonoff Dual R2, Shelly 2.5, etc.), puedes flashearlos con Tasmota o ESPHome y controlarlos directamente desde Home Assistant sin necesidad de cloud externo. El Shelly 2.5 merece mención especial: tiene dos canales de relé, entrada para los finales de carrera, protección contra corriente inversa y se integra de forma nativa en Home Assistant vía la integración oficial de Shelly.

Radio 433 MHz con puente

Si el motor existente solo acepta radio y no quieres tocarlo, la solución más limpia es añadir un receptor externo que emule los mandos de radio y que a su vez tenga conectividad WiFi o Zigbee. El módulo Dooya DT52E o los receptores Connexoon de Somfy hacen exactamente eso. La integración de Somfy con Home Assistant se realiza a través de la integración oficial overkiz (antes tahoma), que soporta tanto la Somfy TaHoma como la Connexoon.

Configuración paso a paso en Home Assistant

Una vez tienes el hardware correcto instalado y conectado a la red, la configuración en Home Assistant sigue un proceso bastante parecido independientemente del protocolo.

1. Añade la integración: ve a Ajustes → Dispositivos y servicios → Añadir integración y busca la correspondiente a tu dispositivo (Zigbee2MQTT, Shelly, Somfy Overkiz, Z-Wave JS, etc.).
2. Empareja el dispositivo: cada protocolo tiene su propio proceso de emparejamiento. En Zigbee debes poner el coordinador en modo de emparejamiento y activar el modo de unión en el módulo (normalmente pulsando el botón de reset 3 veces). En Shelly, el dispositivo aparece automáticamente si está en la misma red.
3. Revisa las entidades creadas: Home Assistant debería crear una entidad de tipo cover para cada persiana. Si aparece como switch, necesitas definir la entidad manualmente en configuration.yaml usando la plataforma cover con los servicios de subir (open_cover), bajar (close_cover) y parar (stop_cover).
4. Calibra los finales de carrera: en motores con posicionamiento por tiempo (sin encoder), debes indicar el tiempo en segundos que tarda la persiana en abrirse y cerrarse completamente. El Shelly 2.5 lo hace desde la propia interfaz del dispositivo antes de integrarlo.
5. Añade la tarjeta a tu dashboard: usa la tarjeta Entities o la tarjeta Cover nativa. Si quieres control visual con porcentaje de apertura, la tarjeta custom:button-card disponible en HACS da más flexibilidad.
6. Crea automatizaciones: ejemplos útiles son bajar las persianas al atardecer usando el sensor solar de Home Assistant, subirlas cuando la temperatura interior supera un umbral, o vincularlas con el modo «fuera de casa» del sistema de alarma.

Fragmento de configuración YAML para cover con relé genérico

Si usas un relé doble genérico controlado por MQTT, este es un ejemplo de configuración en configuration.yaml:

cover:
  - platform: mqtt
    name: "Persiana salón"
    command_topic: "cmnd/persiana_salon/POWER"
    position_topic: "stat/persiana_salon/position"
    set_position_topic: "cmnd/persiana_salon/position"
    payload_open: "OPEN"
    payload_close: "CLOSE"
    payload_stop: "STOP"
    optimistic: false
    device_class: shutter

Ajusta los topics MQTT según la configuración de tu dispositivo Tasmota o ESPHome.

Errores comunes y cómo evitarlos

Estos son los problemas que aparecen con más frecuencia cuando se integran persianas en Home Assistant, especialmente en instalaciones antiguas.

• La persiana sube cuando debería bajar: los cables de subir y bajar están invertidos en el módulo. Solución: intercambiar los terminales en el módulo de control, no en el motor.
• La persiana no para en los finales de carrera: el módulo no detecta el aumento de consumo que indica que el motor ha llegado al límite. Comprueba que los finales de carrera mecánicos del motor están bien ajustados. Si el motor no tiene finales de carrera internos (algunos motores muy económicos no los llevan), el módulo necesita trabajar en modo temporizado.
• Pérdidas de señal WiFi: los módulos instalados dentro de cajas de registro metálicas pierden señal. Usa módulos Zigbee o Z-Wave en esos casos, ya que penetran mejor en entornos con obstáculos metálicos.
• El porcentaje de apertura no es preciso: ocurre cuando el tiempo de calibración no está ajustado con exactitud. Mide con un cronómetro el tiempo real de apertura y cierre completos e introdúcelo en la configuración del módulo.
• Conflicto entre el mando de radio original y Home Assistant: si usas un receptor de radio externo emulado por software (RTL-SDR + un script de transmisión), puede haber colisiones. Usa siempre el módulo receptor dedicado del fabricante para evitar este problema.
• El motor se calienta en exceso: no es un problema de domótica, es un problema de instalación. Si el motor funciona más allá de sus límites de ciclo de trabajo, se sobrecalienta independientemente de cómo lo controles. Llama a un instalador.

Automatizaciones prácticas con persianas en Home Assistant

La integración no termina cuando la persiana sube y baja desde el teléfono. El valor real está en las automatizaciones que hacen que el sistema trabaje solo.

Control solar y ahorro energético

Home Assistant incluye integración con la posición solar. Puedes crear una automatización que baje las persianas de las habitaciones orientadas al sur cuando la irradiación supere un nivel determinado, reduciendo el uso del aire acondicionado en verano. En Valencia, con más de 300 días de sol al año, este tipo de automatización tiene un impacto real en el consumo eléctrico.

Integración con alarma y simulación de presencia

Conecta las persianas al modo de alarma de Home Assistant: cuando activas el modo «fuera de casa», las persianas bajan automáticamente. Para simulación de presencia, puedes programar subidas y bajadas aleatorias dentro de un rango horario cuando estás de vacaciones.

Control por voz con Google Home o Amazon Alexa

Si ya tienes Google Home o Alexa configurados en Home Assistant vía Nabu Casa o la integración manual con el componente emulated_hue, las persianas configuradas como entidades cover aparecen automáticamente como persianas controlables por voz. Solo asegúrate de que el nombre de la entidad es descriptivo: «Persiana salón» es mejor que «cover.entity_01».

Cuándo llamar a un instalador profesional

Hay situaciones en las que seguir con el bricolaje domótico no es la decisión correcta. No porque no seas capaz, sino porque el riesgo eléctrico o mecánico supera lo razonable para una instalación doméstica.

• El motor no responde ni a los mandos originales antes de intentar integrarlo en Home Assistant. El problema es el motor, no la domótica.
• La caja de registro donde está el motor tiene cables sin identificar y no hay plano de la instalación. Tocar cables sin identificar en circuitos de 230 V es peligroso.
• La persiana es un cierre comercial o persiana metálica de más de 40 kg. Los motores de estos cierres trabajan a corrientes más altas y los módulos domésticos no están diseñados para esas cargas.
• Necesitas integrar más de 6-8 persianas de forma coordinada con temp