Nivel del aljibe en Homematic: conectar el sensor de nivel a la CCU3 con CCU-Jack

Nivel del aljibe en Homematic: conectar el sensor de nivel a la CCU3 con CCU-Jack

Probado con la Homematic CCU3 y CCU-Jack · Sensor de nivel Senvolon LD y RD a partir del firmware 4.2.6 · Noviembre de 2026

Esta guía describe cómo conectar el sensor de nivel Senvolon LD o RD a una Homematic CCU3. El sensor se monta en la parte superior del aljibe, por ejemplo en el pozo de acceso, y mide la distancia a la superficie del agua: el LD con luz láser (LiDAR), el RD con radar. A partir de esa distancia y de la forma del aljibe guardada en el sensor, calcula el llenado en porcentaje y la cantidad de líquido en litros y envía ambos valores por MQTT. El complemento gratuito CCU-Jack recibe estos mensajes en la CCU3 y pone los valores a disposición como dispositivo virtual. Los valores pueden utilizarse en programas como los de cualquier otro dispositivo Homematic, por ejemplo para apagar una bomba cuando el nivel es bajo.

Esta guía es válida para la Homematic CCU3. Esta conexión no es posible con un Homematic IP Access Point ni con la Homematic IP Home Control Unit (HCU).

Contenido

Requisitos

Paso 1: instalar CCU-Jack en la CCU3

CCU-Jack es un complemento para la CCU3 de Mathias Dzionsko. Incluye un broker MQTT y puede crear con él dispositivos virtuales que aparecen en la CCU3 como dispositivos Homematic reales.

  1. Descargue la versión más reciente de github.com/mdzio/ccu-jack/releases. Para la CCU3 es el archivo ccu-jack-ccu3-rm-rp2+3-<versión>.tar.gz. No lo descomprima.
  2. Instale el archivo en la interfaz web de la CCU3, en Settings → Control panel → Additional software (Ajustes → Panel de control → Software adicional). La interfaz de la CCU3 está en alemán e inglés; aquí usamos los nombres en inglés.
  3. En Settings → Control panel → Configure firewall (configurar el cortafuegos), introduzca en el campo Port opening (apertura de puertos) los puertos 1883 (MQTT) y 2121 (interfaz web de CCU-Jack).
  4. Abra CCU-Jack en el navegador en http://<IP de la CCU3>:2121/ui. Su interfaz web solo está en alemán, por eso indicamos los nombres tal como aparecen, con su traducción. En Konfiguration → CCU-Anbindung (configuración, conexión con la CCU), active la opción Virtuelle Geräte aktivieren (activar dispositivos virtuales), guarde y reinicie la CCU3.

Paso 2: conectar el sensor de nivel a CCU-Jack por MQTT

Abra la interfaz web del sensor de nivel, elija en Conexiones el tipo de conexión Broker MQTT e introduzca:

Campo Valor
Servidor dirección IP de la CCU3
Puerto 1883
Tema principal p. ej. aljibe

Todo lo demás se queda como está. Después de pulsar Guardar, la página muestra abajo «conectado» al poco tiempo.

Paso 3: crear el dispositivo en la CCU3

  1. En CCU-Jack, en Virtuelle Geräte (dispositivos virtuales), haga clic en Virtuelles Gerät erstellen (crear dispositivo virtual). Con Kanal hinzufügen (añadir canal) añada tres canales en este orden: dos MQTT Analogwertempfänger (receptor de valor analógico MQTT) y un MQTT Kommunikationsstörung (fallo de comunicación MQTT). Haga clic en Erstellen (crear) y después en Konfiguration speichern (guardar configuración).
  2. En la CCU3, haga clic arriba a la derecha en Teach-in devices (aprender dispositivos), después en Inbox (bandeja de entrada), y acepte el dispositivo con Done.
  3. En Settings → Devices (Ajustes → Dispositivos), abra el nuevo dispositivo con Set (ajustar) e introduzca en cada canal:
Canal Ajuste
1 Llenado TOPIC stat/aljibe/REL_LEVEL, EXTRACTOR ALL
2 Líquido TOPIC stat/aljibe/FILLING, EXTRACTOR ALL
3 Disponibilidad TOPIC tele/aljibe/LWT, ERROR_PATTERN Offline, OK_PATTERN Online, ERROR_DELAY 60, OK_DELAY 20

En lugar de aljibe, escriba su tema principal del paso 2, respetando mayúsculas y minúsculas. Cambie el nombre del dispositivo y de los canales, por ejemplo a «Aljibe», «Llenado», «Líquido» y «Disponibilidad».

Los valores aparecen enseguida en Status and control → Devices (Estado y control → Dispositivos). La CCU3 los denomina «Input voltage» (tensión de entrada). La denominación se debe al tipo de canal y no influye en los valores. La disponibilidad está en «closed» (cerrado) mientras el sensor está conectado, y en «open» (abierto) si falta durante más de un minuto.

Paso 4: controlar la bomba con programas de Homematic

Cree los dos ejemplos en Programs and connections → Programs & CCU connection (Programas y conexiones → Programas y conexión con la CCU). Los porcentajes son ejemplos; adáptelos a su aljibe. La bomba está conectada a un actuador de conmutación Homematic, aquí llamado «Bomba».

Sacar agua y proteger la bomba contra el funcionamiento en seco

La bomba se bloquea por debajo del 15 % y se vuelve a habilitar a partir del 25 %. Coloque el umbral de apagado con margen suficiente por encima del punto de aspiración.

Condición Actividad
Si Llenado mayor que 25 y Disponibilidad cerrada Bomba: encendida
Si no, si Llenado menor que 15 o Disponibilidad abierta Bomba: apagada

Ajuste todas las condiciones a trigger when changed (activar al cambiar). Con un grupo de presión con presostato propio, la CCU3 solo habilita así la corriente, y es el presostato el que sigue decidiendo cuándo funciona la bomba. Si, en cambio, la bomba se enciende por horario o a mano, deje vacía la actividad en «Si». Entonces el programa solo apaga.

Gracias a la condición «Disponibilidad abierta», la bomba también se apaga si el sensor falla o se pierde el WiFi. Sin esta condición, la CCU3 seguiría trabajando con el último llenado conocido.

Rellenar el aljibe

Si rellena el aljibe desde otra fuente, por ejemplo un pozo, la bomba llena por debajo del 20 % y se detiene al 80 %.

Condición Actividad
Si Llenado menor que 20 y Disponibilidad cerrada Bomba: encendida
Si no, si Llenado mayor que 80 o Disponibilidad abierta Bomba: apagada

También aquí, ajuste todas las condiciones a trigger when changed (activar al cambiar). Un tiempo de encendido en el actuador, por ejemplo 30 minutos, limita además el tiempo de funcionamiento.

Comprobar el funcionamiento

Desconecte el sensor de la corriente con la bomba encendida. Pasado algo más de un minuto, la bomba debe apagarse. Vuelva a conectarlo: la disponibilidad pasa a «cerrada» y la bomba vuelve a conmutar según lo que pida el nivel. Si los umbrales son correctos lo verá cuando el aljibe los alcance por primera vez en funcionamiento, porque los programas solo reaccionan cuando cambia el llenado.

El control mediante la CCU3 no sustituye la protección contra funcionamiento en seco de la bomba ni un dispositivo contra sobrellenado.

Si algo no funciona

Observación Solución
El sensor muestra «desconectado» Compruebe la dirección IP de la CCU3 y el puerto 1883, compruebe el cortafuegos de la CCU3
Sensor conectado, pero ningún valor en la CCU3 Compruebe cómo está escrito el tema principal en los campos TOPIC
La disponibilidad sigue «abierta» aunque el sensor está conectado Reinicie el sensor en Sistema → Reiniciar
Los valores solo llegan una vez por hora Desactive el modo de ahorro de energía del sensor; no es adecuado para controlar una bomba

Si el sensor tiene mala recepción WiFi en el pozo de acceso, le ayudará Garantizar la recepción WiFi del sensor de nivel en el aljibe. Para otras consultas, puede contactar con nuestro servicio de asistencia en support@senvolon.de.

Qué mide un sensor sin contacto en el aljibe y cuál se adapta a su depósito lo encontrará en controlar el nivel del aljibe. Si usa Home Assistant en lugar de Homematic, lea nuestro artículo sobre la protección contra funcionamiento en seco para la bomba de riego.

Preguntas frecuentes

¿Funciona con Homematic IP?

Con la CCU3 sí, aunque el resto de sus dispositivos sean Homematic IP. Con el Homematic IP Access Point o la Home Control Unit (HCU), no.

¿Funciona también con RaspberryMatic u OpenCCU?

Esta guía es válida para la CCU3. No la hemos comprobado con RaspberryMatic ni con OpenCCU.

¿Necesito mi propio broker MQTT?

No. CCU-Jack incluye un broker MQTT, y el sensor de nivel se conecta directamente a la CCU3 en el puerto 1883.

¿Necesita el sensor internet o una nube para esto?

No. El sensor y la CCU3 se comunican directamente por MQTT en su red.