Sensor de lluvia Aqualin Mini-Click con ESPHome y Home Assistant

Este artículo puede contener enlaces de afiliado. Si compras desde estos enlaces, el precio para ti es el mismo y la tienda me paga una pequeña comisión que ayuda a mantener Tecnoyfoto.

Albert BarnosellEditor y responsable de Tecnoyfoto

He integrado un sensor de lluvia Aqualin Mini-Click en Home Assistant con un ESP32 y ESPHome para sustituir mi antiguo montaje con placa resistiva. Buscaba reducir los problemas de oxidación y tener un sistema más sencillo. Después de probarlo, mi valoración depende sobre todo de una cuestión: cuánto tiempo podemos aceptar que tarde en detectar la lluvia y en volver al estado seco.

En el vídeo puedes ver la preparación del cable, la programación de la placa y la prueba con agua. Aquí quiero centrarme en la experiencia de uso, las ventajas frente al montaje anterior y las limitaciones que conviene conocer antes de comprarlo. También encontrarás la configuración completa para reproducir mi instalación.

Mi valoración del Aqualin: sencillo, pero con una respuesta lenta

Lo que más me convence es su funcionamiento mecánico. El sensor utiliza dos contactos y no necesita alimentación propia, aplicación del fabricante ni conexión a una nube. La integración la realiza el ESP32, que puede quedarse protegido dentro de casa gracias al cable de unos 7 metros que trae mi unidad.

El compromiso está en la respuesta. No es un detector de las primeras gotas. Incluso en la posición más sensible, marcada como 3 mm, necesita que sus discos absorban suficiente agua para accionar el interruptor. Y una vez activado puede continuar indicando humedad durante muchas horas después de terminar la lluvia.

Por eso lo veo especialmente interesante para automatizaciones de jardín y riego que toleren esos tiempos. Mi valoración cambia si lo que se busca es una reacción inmediata para proteger un toldo, cerrar una ventana o avisar antes de que se moje la ropa.

Por qué sustituí mi sensor de lluvia anterior

Mi montaje anterior detectaba el agua con una placa resistiva expuesta al exterior. Funcionaba y respondía con muy poca agua. Además, su lectura analógica me permitía obtener una estimación de intensidad para mostrarla en Home Assistant.

El problema era mantenerlo: la placa se iba oxidando, podía quedarse indicando lluvia o dejar de responder y acababa necesitando otra sustitución. También decidí usar un ESP32 nuevo porque el del montaje anterior estaba dando problemas de conexión. Quería separar esos problemas de la prueba del nuevo sensor.

Con el Aqualin he renunciado a aquella estimación de intensidad. A cambio, elimino las pistas de detección de una placa resistiva expuesta al agua. Esa simplificación me interesa, aunque todavía no la considero una prueba de durabilidad a largo plazo: eso habrá que comprobarlo con el uso continuado.

Cómo funciona este sensor mecánico de lluvia

El Aqualin Mini-Click está pensado originalmente para sistemas de riego. En su interior hay discos higroscópicos: absorben agua, aumentan de volumen y accionan un pequeño interruptor. Cuando se secan, el mecanismo vuelve a su posición inicial.

Lo que sale por el cable es un contacto seco. En mi unidad, comprobé con un multímetro que el contacto está cerrado cuando el sensor está seco y se abre cuando se moja lo suficiente para activarlo. Esa comprobación es importante para interpretar correctamente el estado que recibirá Home Assistant.

El sensor no incorpora Wi-Fi ni Zigbee. Tampoco entrega un valor analógico de intensidad ni una medición de precipitación. Su función eléctrica consiste en abrir o cerrar el contacto; ESPHome se encarga de comunicar ese estado.

La sensibilidad: qué significa el ajuste de 3 mm

Mi sensor permite seleccionar 3, 6, 12, 19 o 25 mm. He empezado por 3 mm, la posición más sensible, para que se active con la menor cantidad de lluvia que permite su mecanismo.

Como referencia, 3 mm de precipitación equivalen a 3 litros por metro cuadrado. Pero esta escala es un ajuste mecánico de activación: Home Assistant no recibe una lectura de 3 mm ni sabe cuántos litros han caído. Tampoco convierte al dispositivo en un pluviómetro.

Esta diferencia se aprecia en la prueba con agua del vídeo. Unas pocas gotas no bastaron y tuve que añadir más agua para que cambiara de estado. Esa prueba confirma que funciona, pero no sirve para calibrar con precisión la cantidad de lluvia necesaria en una instalación real.

Mi primera experiencia con lluvia real: casi 24 horas para volver a seco

El primer día de lluvia con este sensor fue una buena prueba de su comportamiento. En Girona cayeron unos 50 litros por metro cuadrado, con un periodo de aproximadamente 20 litros en una hora. Con aquel aguacero detectó la lluvia enseguida y mantuvo la indicación durante el episodio.

Lo más revelador llegó después. Había llovido por la tarde y la noche fue muy húmeda, prácticamente al 100 % de humedad. Los discos no se secaron. Al día siguiente amaneció algo nublado; después salió el sol, pero sin viento. En esas condiciones tardó casi 24 horas en volver al estado seco.

No presento esas 24 horas como un tiempo fijo para todos los casos. El secado depende de las condiciones posteriores a la lluvia. Lo que sí demuestra mi experiencia es que el estado húmedo puede durar mucho más que el propio episodio de precipitación.

Para un sistema de riego, seguir bloqueándolo después de un aguacero puede tener sentido. Para un panel que pretenda responder a la pregunta «¿está lloviendo ahora mismo?», esa persistencia necesita una explicación. Es más preciso interpretar la entidad como sensor activado o húmedo, y sensor seco.

Qué me gusta y qué limitaciones he encontrado

Las ventajas que veo en este montaje

• Mecanismo sencillo: dos contactos que se conectan directamente al ESP32.
• Sin alimentación del sensor: no tengo que llevarle 3,3 V ni 5 V.
• Cable largo: los aproximadamente 7 metros de mi unidad facilitan mantener la electrónica dentro de casa.
• Integración local: utilizo ESPHome y Home Assistant sin depender de una aplicación o una cuenta del fabricante.
• Menos problemas asociados a placas resistivas: desaparece la placa de detección cuyas pistas se oxidaban en mi montaje anterior.

Los compromisos que hay que aceptar

• Detección tardía con lluvia ligera: no basta con que caigan las primeras gotas.
• Secado lento: puede mantener el estado húmedo durante horas después de dejar de llover.
• Sin intensidad ni cantidad acumulada: solo obtenemos un estado binario.
• Sin validación de durabilidad a largo plazo: mi experiencia inicial no permite asegurar cuántos años resistirá instalado en el exterior.

Comparación con mi montaje de placa resistiva

Automatizaciones para las que sí lo utilizaría

Su origen como sensor de riego ayuda a entender dónde encaja mejor. Lo utilizaría para inhibir un riego tras detectar lluvia, mostrar el estado húmedo en el dashboard, enviar una notificación de activación o combinarlo con otros datos meteorológicos para decidir qué hacer en el jardín.

Para recoger un toldo o cerrar una ventana al empezar a llover, no lo elegiría como único detector de las primeras gotas. El umbral de activación puede hacer que la actuación llegue cuando ya ha caído bastante agua. Esa limitación es más importante que la facilidad de conectarlo al ESP32.

También puede servir para guardar la fecha de una activación por lluvia. Sin embargo, mientras continúa húmedo no puede identificar por separado un nuevo episodio de lluvia. Conviene tenerlo en cuenta al interpretar un histórico.

Qué he conservado en Home Assistant y qué debo revisar

Mi instalación anterior ya utilizaba el nodo pluja y la entidad binary_sensor.sensor_de_lluvia_esphome. Al incorporar el nuevo ESP32, Home Assistant me ofreció migrar la configuración al nuevo dispositivo. En mi caso mantuvo las referencias existentes al sensor principal, algo útil para el dashboard y las automatizaciones.

También tenía entidades como sensor.fecha_ultimo_dia_con_lluvia y sensor.days_since_last_rain. Esas entidades pertenecen a mi configuración previa de Home Assistant y no se crean con el código de ESPHome que encontrarás más abajo.

Conservar sus nombres no significa que su interpretación siga siendo exactamente igual. Debo revisar si guardan la fecha al pasar a ON, si consultan el estado periódicamente o si consideran cada día húmedo como un día de lluvia. Con un secado de muchas horas, esos criterios pueden producir resultados distintos.

Las entidades de intensidad de mi montaje anterior dejan de tener una base de medida. No tiene sentido mantener una escala de lluvia débil, moderada o fuerte a partir de un contacto que solamente puede estar abierto o cerrado.

Precio y dónde comprar el sensor

El Aqualin Mini-Click que he utilizado tenía un precio de 24,59 € en el momento de preparar este artículo. Por ese importe me parece una opción interesante para aprovechar su contacto mecánico en Home Assistant, siempre que sus tiempos de respuesta encajen con la automatización que queremos hacer.

A ese coste hay que añadir el ESP32 si no tenemos una placa disponible. El sensor por sí solo no se conecta a Home Assistant; necesita el montaje que se muestra en el vídeo y cuya configuración dejo aquí.

El precio puede variar con el tiempo. El enlace anterior es de afiliado y puedo recibir una pequeña comisión si realizas una compra, sin coste adicional para ti.

Conexión al ESP32: el complemento técnico de esta review

En el vídeo muestro la preparación del cable y los conectores. Como referencia para reproducir el montaje, aquí dejo el esquema, la lógica de funcionamiento y el código completo. He utilizado una placa basada en ESP32-D0WD-V3, revisión 3.1, configurada como esp32dev con framework Arduino.

Aqualin, conductor 1 ───────── GPIO25
Aqualin, conductor 2 ───────── GND

No hay polaridad: cualquiera de los dos conductores puede ir a GPIO25 y el otro a GND. El sensor no se conecta a 3,3 V ni a 5 V. Utilizo solamente su interruptor interno; el ESP32 sí necesita su propia alimentación.

GPIO25 permite activar el pull-up interno del ESP32. Así, cuando el contacto está cerrado, la entrada queda a GND; cuando se abre, el pull-up la lleva a nivel alto. Esa es la razón por la que esta configuración no invierte la señal.

Antes de conectar el sensor comprobé esta lógica dejando GPIO25 abierto y después haciendo un puente temporal entre GPIO25 y GND. También comprobé el contacto con un multímetro. Un cable desconectado produce igualmente una entrada HIGH, por lo que una indicación de humedad inesperada también requiere revisar las conexiones.

La configuración de la entrada sigue el esquema de sensor binario GPIO de ESPHome. No todos los GPIO de todas las variantes de ESP32 tienen las mismas funciones: si cambias de placa, comprueba el pin que vas a utilizar.

Código completo de la placa en ESPHome

Esta es la configuración completa de mi placa. El nombre pluja corresponde a mi instalación. Si utilizas otro nombre, ajusta las referencias correspondientes en tu proyecto.

esphome:
  name: pluja
  project:
    name: tecnoyfoto.pluja
    version: "0.2"

esp32:
  board: esp32dev
  framework:
    type: arduino

logger:

api:
  encryption:
    key: !secret pluja_api_encryption_key

ota:
  - platform: esphome
    password: !secret pluja_ota_password

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
  power_save_mode: none

  ap:
    ssid: "Pluja Fallback"
    password: !secret pluja_ap_password

captive_portal:

web_server:
  port: 80
  local: true
  ota: false
  auth:
    username: admin
    password: !secret web_server_password

safe_mode:

button:
  - platform: safe_mode
    name: "Safe Mode Boot"
    entity_category: diagnostic

  - platform: restart
    name: "Reinicio pluja"
    entity_category: diagnostic

binary_sensor:
  - platform: gpio
    pin:
      number: GPIO25
      mode:
        input: true
        pullup: true
    name: "Sensor de lluvia ESPHome"
    device_class: moisture
    filters:
      - delayed_on: 5s
      - delayed_off: 30s

Las claves que necesita secrets.yaml

El código utiliza !secret para separar las credenciales de la configuración. Añade estas seis entradas a tu archivo secrets.yaml, o reutiliza las que ya tengas con esos nombres:

wifi_ssid: "TU_RED_WIFI"
wifi_password: "TU_CONTRASENA_WIFI"
pluja_api_encryption_key: "TU_CLAVE_DE_CIFRADO_GENERADA_POR_ESPHOME"
pluja_ota_password: "TU_CONTRASENA_OTA"
pluja_ap_password: "TU_CONTRASENA_DEL_PUNTO_DE_ACCESO"
web_server_password: "TU_CONTRASENA_DEL_SERVIDOR_WEB"

Los valores anteriores son ejemplos que debes sustituir antes de validar e instalar la configuración. Para pluja_api_encryption_key, utiliza una clave válida generada por ESPHome. El servidor web permite consultar el dispositivo en la red local con el usuario admin y la contraseña que hayas definido.

Qué hacen los filtros de 5 y 30 segundos

La configuración incluye delayed_on: 5s y delayed_off: 30s. El primero exige que la entrada permanezca activada durante cinco segundos seguidos antes de publicar ON. El segundo exige treinta segundos seguidos en estado desactivado antes de publicar OFF. Si la entrada vuelve al estado contrario durante la espera, se cancela ese cambio pendiente.

Estos filtros ayudan a descartar cambios breves del contacto o de la señal eléctrica. No compensan la lentitud del mecanismo ni detectan pausas entre gotas. El sensor ya mantiene el contacto abierto mientras sus discos siguen hinchados: ESPHome no puede acelerar su secado. La documentación de filtros de sensores binarios de ESPHome explica este comportamiento.

He utilizado device_class: moisture porque la entidad refleja mejor un estado húmedo o seco que una afirmación de lluvia instantánea. El nombre de la entidad conserva la referencia a lluvia para mantener la continuidad con mi instalación anterior.

La instalación exterior también cuenta

El sensor debe quedar expuesto a la lluvia en un lugar representativo de la zona que queremos controlar. Un alero, una cubierta o un obstáculo que intercepte el agua puede alterar su respuesta. La exposición al sol y al viento también influirá en el secado y, por tanto, en cuánto tiempo permanece activado.

El cable largo me permite situar el sensor fuera y mantener el ESP32 protegido en el interior. Las uniones y los conectores requieren protección frente al agua y la humedad. Antes de dar el montaje por terminado, conviene comprobar tanto la activación como la vuelta al estado seco con el sensor en su posición definitiva.

El montaje que he probado utiliza el pull-up interno. Si aparecen cambios inesperados con otro recorrido de cable, hay que revisar las conexiones y las posibles interferencias; los filtros de software no sustituyen una instalación eléctrica estable.

Mi veredicto: una opción para el riego, con límites claros

El Aqualin Mini-Click me parece interesante para integrar un contacto de lluvia en Home Assistant con un montaje sencillo y local. Su mayor atractivo es prescindir de la placa resistiva expuesta al agua. Su principal limitación es el tiempo de respuesta: necesita suficiente agua para activarse y puede tardar muchas horas en volver al estado seco.

Lo elegiría para automatizaciones de riego que puedan trabajar con ese comportamiento. Para actuar ante las primeras gotas o saber si está lloviendo en este preciso momento, buscaría un detector adecuado a esa necesidad. Mi experiencia inicial permite valorar su funcionamiento, pero todavía no afirmar cómo responderá tras años a la intemperie.

Continúa leyendo

Siguiente guía relacionada · 12 min de lectura

secrets.yaml en ESPHome: cómo proteger Wi-Fi, API y OTA

Cuando empiezas a utilizar ESPHome, es muy fácil acabar poniendo las contraseñas Wi-Fi, las claves de cifrado de la API y otras credenciales directamente…

Continuar con este artículo↓