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
- Un sensor de nivel LD o un sensor de nivel RD con firmware 4.2.6 o posterior. Encontrará el firmware actual en Descargas y actualizaciones de firmware.
- El sensor está conectado a su WiFi y configurado en «Depósito» para que envíe porcentaje y litros.
- Una Homematic CCU3 en la misma red y su dirección IP.
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.
- 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. - 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.
- 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).
- 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
- 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).
- 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.
- 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.