Rainwater tank level in Homematic: connecting the level sensor to the CCU3 via CCU-Jack

Rainwater tank level in Homematic: connecting the level sensor to the CCU3 via CCU-Jack

Tested with the Homematic CCU3 and CCU-Jack · Senvolon level sensor LD and RD from firmware 4.2.6 · As of November 2026

This guide describes how to connect the Senvolon level sensor LD or RD to a Homematic CCU3. The sensor is mounted at the top of the rainwater tank, for example in the access shaft, and measures the distance to the water surface, the LD with laser light (LiDAR), the RD with radar. From this distance and the tank shape stored in the sensor, it calculates the fill level in percent and the amount of liquid in litres and sends both values via MQTT. The free add-on CCU-Jack receives these messages on the CCU3 and provides the values as a virtual device. The values can be used in programs like those of any other Homematic device, for example to switch off a pump when the level is low.

This guide applies to the Homematic CCU3. This connection is not possible with a Homematic IP Access Point or the Homematic IP Home Control Unit (HCU).

Contents

Requirements

  • A level sensor LD or level sensor RD with firmware 4.2.6 or later. You can find the latest firmware under Downloads and firmware updates.
  • The sensor is connected to your Wi-Fi and set up under “Tank” so that it reports percent and litres.
  • A Homematic CCU3 in the same network and its IP address.

Step 1: Install CCU-Jack on the CCU3

CCU-Jack is an add-on for the CCU3 by Mathias Dzionsko. It includes an MQTT broker and can turn it into virtual devices that appear in the CCU3 like real Homematic devices.

  1. Download the latest version from github.com/mdzio/ccu-jack/releases. For the CCU3, this is the file ccu-jack-ccu3-rm-rp2+3-<version>.tar.gz. Do not unpack it.
  2. Install the file in the CCU3 web interface under Settings → Control panel → Additional software.
  3. Under Settings → Control panel → Configure firewall, enter ports 1883 (MQTT) and 2121 (CCU-Jack web interface) in the Port opening field.
  4. Open CCU-Jack in your browser at http://<IP of the CCU3>:2121/ui. Its web interface is only available in German, so the labels are given here as they appear, with a translation. Under Konfiguration → CCU-Anbindung (configuration, CCU connection), enable the option Virtuelle Geräte aktivieren (enable virtual devices), save and restart the CCU3.

Step 2: Connect the level sensor to CCU-Jack via MQTT

Open the level sensor's web interface, select the connection type MQTT Broker under Connections and enter:

Field Entry
Server IP address of the CCU3
Port 1883
Main topic e.g. tank

Leave everything else as it is. After you save, the page shows “connected” at the bottom after a short time.

Step 3: Create the device in the CCU3

  1. In CCU-Jack, under Virtuelle Geräte (virtual devices), click Virtuelles Gerät erstellen (create virtual device). Use Kanal hinzufügen (add channel) to add three channels in this order: two MQTT Analogwertempfänger (MQTT analog value receiver), then one MQTT Kommunikationsstörung (MQTT communication fault). Click Erstellen (create) and then Konfiguration speichern (save configuration).
  2. In the CCU3, click Teach-in devices at the top right, then Inbox, and accept the device with Done.
  3. Under Settings → Devices, open the new device with Set and enter for each channel:
Channel Setting
1 Fill level TOPIC stat/tank/REL_LEVEL, EXTRACTOR ALL
2 Liquid TOPIC stat/tank/FILLING, EXTRACTOR ALL
3 Reachability TOPIC tele/tank/LWT, ERROR_PATTERN Offline, OK_PATTERN Online, ERROR_DELAY 60, OK_DELAY 20

Instead of tank, use your main topic from step 2, with exactly the same upper and lower case. Rename the device and the channels, for example to “Rainwater tank”, “Fill level”, “Liquid” and “Reachability”.

The values appear immediately under Status and control → Devices. The CCU3 labels them “Input voltage”. The label results from the channel type and has no effect on the values. Reachability shows “closed” as long as the sensor is connected, and “open” if it has been missing for more than a minute.

Step 4: Switch the pump with Homematic programs

Create the two examples under Programs and connections → Programs & CCU connection. The percentages are examples; adapt them to your tank. The pump is connected to a Homematic switch actuator, called “Pump” here.

Drawing water and protecting the pump from running dry

The pump is blocked below 15 % and released again from 25 %. Set the switch-off threshold well above the intake.

Condition Activity
If Fill level more than 25 and Reachability closed Pump: On
Else, if Fill level less than 15 or Reachability open Pump: Off

Set all conditions to trigger when changed. With a domestic water system that has its own pressure switch, the CCU3 only releases the power this way, and the pressure switch still decides when the pump runs. If, on the other hand, your pump is switched on by a schedule or by hand, leave the activity for “If” empty. The program then only switches off.

Thanks to the condition “Reachability open”, the pump also switches off if the sensor fails or the Wi-Fi is down. Without this condition, the CCU3 would keep working with the last known fill level.

Refilling the tank

If you refill the tank from another source, such as a well, the pump fills it up below 20 % and stops at 80 %.

Condition Activity
If Fill level less than 20 and Reachability closed Pump: On
Else, if Fill level more than 80 or Reachability open Pump: Off

Here, too, set all conditions to trigger when changed. An on-time set on the actuator, for example 30 minutes, additionally limits the running time.

Checking the function

Disconnect the sensor from power while the pump is running. After a good minute, the pump must switch off. Reconnect it: Reachability changes to “closed”, and the pump switches again as the fill level requires. Whether the thresholds are right becomes clear when the tank reaches them in operation for the first time, because the programs only react when the fill level changes.

Control via the CCU3 does not replace the pump's own dry-run protection or an overfill safeguard.

If something does not work

Observation Remedy
The sensor shows “disconnected” Check the IP address of the CCU3 and port 1883, check the CCU3 firewall
Sensor connected, but no value in the CCU3 Check the spelling of the main topic in the TOPIC fields
Reachability stays “open” although the sensor is connected Restart the sensor under System → Restart
Values only arrive once an hour Switch off the sensor's power saving mode, it is not suitable for pump control

If the sensor has poor Wi-Fi reception in the shaft, Ensuring Wi-Fi reception for the level sensor will help. For further questions, you can reach our support team at support@senvolon.de.

What a contactless sensor measures in a rainwater tank and which one suits your tank is explained under monitoring the rainwater tank level. If you use Home Assistant instead of Homematic, read our separate article on dry-run protection for the garden pump.

Frequently asked questions

Does this work with Homematic IP?

With the CCU3 yes, even if your other devices are Homematic IP. With the Homematic IP Access Point or the Home Control Unit (HCU), no.

Does this also work with RaspberryMatic or OpenCCU?

This guide applies to the CCU3. We have not checked it with RaspberryMatic or OpenCCU.

Do I need my own MQTT broker?

No. CCU-Jack includes an MQTT broker, and the level sensor connects directly to the CCU3 on port 1883.

Does the sensor need the internet or a cloud for this?

No. The sensor and the CCU3 communicate directly via MQTT in your network.