Cómo Integrar los Sensores frient con Home Assistant (ZHA y Zigbee2MQTT)

Dashboard de Home Assistant mostrando sensores frient integrados con mapa de red Zigbee

Ya tienes tus sensores frient en casa. Los has desempaquetado, les has puesto las pilas y ahora viene la pregunta del millón: ¿cómo los conecto a Home Assistant? Tranquilo, que hoy te lo explico paso a paso.

Si aún no conoces la marca, te recomendamos empezar por nuestra introducción a frient y nuestra guía de sensores frient para el hogar. También te puede interesar nuestra guía de seguridad con frient para conocer sus sensores de humo, agua y vibración.

frient se unió al programa “Works with Home Assistant” en septiembre de 2025, lo que significa que estos dispositivos están oficialmente certificados para funcionar sin problemas con nuestra plataforma favorita. No hay que pelearse con configuraciones raras ni andar buscando workarounds por foros oscuros. Conectas y funcionan.

Requisitos previos

Antes de empezar, necesitas un coordinador Zigbee. Es el dispositivo que hará de puente entre tus sensores frient y Home Assistant. Si no tienes claro qué protocolo elegir, consulta nuestra comparativa Zigbee vs WiFi. Las opciones más populares son:

Cualquiera de estas te servirá. Yo personalmente uso el SkyConnect en mi instalación principal y un ZBDongle-P en la casa de mis padres. Ambos van perfectos.

Si quieres comprar los sensores frient directamente, aquí tienes los enlaces:

Dos caminos: ZHA vs Zigbee2MQTT

Home Assistant te ofrece dos formas principales de integrar dispositivos Zigbee. Te las resumo rápido:

ZHA (Zigbee Home Automation)

Es la integración nativa de Home Assistant. La configuras desde la interfaz gráfica, sin tocar archivos de configuración ni instalar addons adicionales. Ideal si quieres algo que “funcione y ya”.

Ventajas:

  • Configuración ultra sencilla
  • Se actualiza con Home Assistant
  • Interfaz gráfica para emparejar dispositivos
  • Soporte oficial de la comunidad HA

Inconvenientes:

  • Menos opciones de configuración avanzada
  • Algunos dispositivos muy nuevos pueden tardar en tener soporte

Zigbee2MQTT

Es un addon más avanzado que expone tus dispositivos Zigbee vía MQTT. Requiere un poco más de configuración inicial, pero te da mucho más control sobre cada dispositivo.

Ventajas:

  • Actualizaciones de firmware OTA para más dispositivos
  • Más opciones de configuración (reporting, bind, grupos…)
  • Suele soportar dispositivos nuevos más rápido
  • Interfaz web muy completa

Inconvenientes:

  • Necesitas configurar MQTT si no lo tienes ya
  • Curva de aprendizaje un poco más pronunciada

Mi recomendación: Si eres principiante, empieza con ZHA. Cuando quieras exprimir más tus dispositivos, prueba Zigbee2MQTT. Los sensores frient funcionan perfectamente con ambos.

Emparejando sensores frient paso a paso

El proceso es muy similar en ambos métodos. Te lo explico con ZHA y luego te señalo las diferencias con Zigbee2MQTT.

Con ZHA:

  1. Ve a Configuración → Dispositivos y servicios → Añadir integración
  2. Busca “ZHA” y selecciona tu coordinador Zigbee
  3. Una vez configurado, haz clic en “Añadir dispositivo”
  4. Pon tu sensor frient en modo emparejamiento:
    • Motion Sensor: Mantén pulsado el botón 10 segundos hasta que el LED parpadee
    • Entry Sensor: Mantén pulsado el botón 5 segundos
    • Humidity Sensor: Pulsa el botón 4 veces en 5 segundos
    • Smoke Alarm: Mantén pulsado el botón de test 10 segundos
  5. Espera a que aparezca en la interfaz (suele tardar 10-30 segundos)
  6. Dale un nombre descriptivo y asigna una zona

Con Zigbee2MQTT:

  1. Abre la interfaz web de Zigbee2MQTT (normalmente en el puerto 8099)
  2. Ve a la pestaña “Touchlink” o haz clic en “Permit join”
  3. Activa el emparejamiento en tu sensor frient (mismos pasos que arriba)
  4. Verás aparecer el dispositivo en la lista con su modelo (ej: “MOSZB-141” para el Motion Sensor)
  5. Renómbralo desde la interfaz y configura sus opciones

Tip importante: Si un sensor no empareja a la primera, quita la pila, espera 5 segundos, vuelve a ponerla e intenta de nuevo. A veces los dispositivos Zigbee se quedan “enganchados” a una red anterior.

¿Qué entidades crea cada sensor?

Una vez emparejados, Home Assistant creará automáticamente estas entidades:

Motion Sensor (MOSZB-141)

  • binary_sensor.frient_motion → Detección de movimiento (on/off)
  • sensor.frient_temperature → Temperatura ambiente
  • sensor.frient_battery → Nivel de batería (%)
  • sensor.frient_linkquality → Calidad de señal Zigbee

Entry Sensor (DWSZB-110)

  • binary_sensor.frient_door → Estado puerta/ventana (on=abierta, off=cerrada)
  • sensor.frient_battery → Nivel de batería
  • sensor.frient_linkquality → Calidad de señal

Humidity Sensor (HMSZB-110)

  • sensor.frient_temperature → Temperatura
  • sensor.frient_humidity → Humedad relativa (%)
  • sensor.frient_battery → Nivel de batería

Smoke Alarm (SMSZB-120)

  • binary_sensor.frient_smoke → Detección de humo (on=alerta)
  • sensor.frient_battery → Nivel de batería
  • sensor.frient_linkquality → Calidad de señal
  • (También expone entidades para silenciar la alarma desde HA)

Automatizaciones prácticas con YAML

Aquí viene lo bueno. Te dejo cuatro automatizaciones listas para copiar y pegar. Si quieres profundizar en automatizaciones con sensores de presencia, no te pierdas nuestra guía completa de sensores de presencia.

1. Encender luces con el Motion Sensor

alias: "Pasillo - Encender luz con movimiento"
trigger:
  - platform: state
    entity_id: binary_sensor.frient_motion
    to: "on"
condition:
  - condition: sun
    after: sunset
    after_offset: "-00:30:00"
action:
  - service: light.turn_on
    target:
      entity_id: light.pasillo
    data:
      brightness_pct: 80
      color_temp_kelvin: 3000
  - wait_for_trigger:
      - platform: state
        entity_id: binary_sensor.frient_motion
        to: "off"
        for: "00:02:00"
  - service: light.turn_off
    target:
      entity_id: light.pasillo

Esta automatización enciende la luz del pasillo cuando detecta movimiento, pero solo 30 minutos después del atardecer. Se apaga automáticamente 2 minutos después de dejar de detectar movimiento.

2. Alerta si la puerta está abierta más de 5 minutos

alias: "Puerta principal - Alerta si abierta"
trigger:
  - platform: state
    entity_id: binary_sensor.frient_door
    to: "on"
    for: "00:05:00"
action:
  - service: notify.mobile_app_telefono
    data:
      title: "🚪 Puerta abierta"
      message: "La puerta principal lleva 5 minutos abierta"
      data:
        priority: high
        ttl: 0
  - service: tts.speak
    target:
      entity_id: tts.google_es_es
    data:
      message: "Atención, la puerta principal está abierta"

Útil para puertas de entrada, neveras o armarios donde no debería haber flujo constante de aire.

3. Activar extractor si la humedad supera el 70%

alias: "Baño - Ventilación por humedad"
trigger:
  - platform: numeric_state
    entity_id: sensor.frient_humidity
    above: 70
condition:
  - condition: state
    entity_id: switch.extractor_bano
    state: "off"
action:
  - service: switch.turn_on
    target:
      entity_id: switch.extractor_bano
  - wait_until:
      - condition: numeric_state
        entity_id: sensor.frient_humidity
        below: 60
    timeout: "00:20:00"
  - service: switch.turn_off
    target:
      entity_id: switch.extractor_bano

Perfecto para baños sin ventana. El extractor se enciende automáticamente cuando la humedad sube y se apaga cuando baja del 60% (con un máximo de 20 minutos por si acaso).

4. Alarma de humo con sirena y notificación

alias: "Seguridad - Alarma de humo"
trigger:
  - platform: state
    entity_id: binary_sensor.frient_smoke
    to: "on"
action:
  - service: notify.mobile_app_telefono
    data:
      title: "🔥 ALERTA DE HUMO"
      message: "Se ha detectado humo en {{ trigger.to_state.attributes.friendly_name }}"
      data:
        priority: high
        ttl: 0
        actions:
          - action: "SILENCE_ALARM"
            title: "Silenciar"
  - service: siren.turn_on
    target:
      entity_id: siren.alarma_casa
  - service: light.turn_on
    target:
      entity_id: group.luces_emergencia
    data:
      color_name: red
      brightness_pct: 100
      effect: strobe

Esta automatización lanza notificación push, activa sirenas y enciende luces de emergencia en rojo intermitente.

Consejos de ubicación y mantenimiento

Para sacar el máximo partido a tus sensores frient, la ubicación es clave. El Motion Sensor funciona mejor montado en una esquina a unos 2 metros de altura, orientado hacia la zona de paso principal. Evita colocarlo cerca de fuentes de calor como radiadores o ventanas con sol directo, ya que el sensor PIR puede generar falsas detecciones.

El Entry Sensor debe instalarse con el imán en la parte móvil (puerta o ventana) y el sensor en el marco fijo. La distancia máxima entre ambas piezas es de unos 15 milímetros cuando la puerta está cerrada. Si tienes marcos metálicos, puede que necesites añadir un pequeño separador de plástico para evitar interferencias.

Para el Humidity Sensor, colócalo a media altura en el baño o cocina, lejos de la ducha directa pero dentro de la misma habitación. Así captará los cambios de humedad de forma representativa sin mojarse.

En cuanto al mantenimiento, los sensores frient usan pilas CR123A o CR2450 según el modelo, con una duración típica de entre uno y tres años. Home Assistant te avisará cuando el nivel baje del 20%, así que no te quedarás sin cobertura de un día para otro.

Compatibilidad con otras plataformas

Aunque este artículo se centra en Home Assistant, frient también juega bien con otras plataformas:

  • Homey: Soportados nativamente, incluso con funciones avanzadas como el “tamper detection”
  • Samsung SmartThings: Compatibles vía drivers de la comunidad (la integración oficial está en desarrollo)
  • Hubitat: Funcionan con drivers genéricos de Zigbee

Si algún día cambias de plataforma, tus sensores frient probablemente te seguirán acompañando.

Y viene lo mejor…

En el próximo y último artículo de esta serie hablaremos del control de energía: el Smart Plug con medición, el Smart Cable para controlar cualquier electrodoméstico y el Range Extender para mejorar la cobertura Zigbee. Son dispositivos que complementan perfectamente a los sensores y te permiten no solo monitorizar tu hogar, sino también controlar y optimizar el consumo eléctrico. Mientras tanto, si te interesa la monitorización energética, echa un vistazo a nuestra guía de monitorización de energía con Home Assistant.

Precios actualizados a fecha de publicación. Pueden variar. Este artículo contiene enlaces de afiliado — si compras a través de ellos, nos ayudas a mantener el blog sin coste adicional para ti.