3.6 KiB
Cantabile EEBUS
The add-on speaks EEBUS with the devices in your home: the grid operator's control box (§14a EnWG), heat pumps (Vaillant, Viessmann, Bosch and others), wallboxes and inverters. It shows them in Home Assistant under Cantabile's names and units, so the Cantabile agent maps them exactly, and it hands the grid operator's limit to the agent.
Your consent
In the add-on's configuration, Cantabile may control devices is your consent (the same text as Cantabile's other add-ons and the Cantabile Hub's setup). Without it the add-on pairs and reads your devices, shows them in Home Assistant and tells the Cantabile agent about the grid operator's limit, but writes nothing to them: no command, and not the grid operator's limit either. The page says so at the top. You can give or take back the consent there at any time; the add-on restarts with it and records when.
The add-on sends nothing out of your home: its values go to Home Assistant, the grid operator's limit to the Cantabile agent on the same Home Assistant (which shares data with Cantabile only with your consent in its own configuration).
Pairing
EEBUS devices trust each other by their SKI (a fingerprint of the device's certificate). Open the add-on's page (Cantabile EEBUS):
- Switch EEBUS on in the device's app or menu (for example the myVAILLANT or ViCare app, or the wallbox's web page). The device appears under Found on the network, or asks to be paired.
- Compare the SKI on the page with the one the device shows (its app, display or label; for the control box, the installer or the grid operator gives it).
- Pair. In the device's app, trust "Cantabile EEBUS bridge" if it asks. The page shows the bridge's own two SKIs at the bottom: one for heat pumps, wallboxes and inverters, one for the grid operator's control box (give that one to the installer).
Each device is paired once; the add-on keeps its own certificate in its
data, so the pairing survives updates. A device's page opens with a link
#<device> (from Cantabile's dashboard).
The grid operator's limit (§14a)
A paired control box is sealed: nothing in Home Assistant or Cantabile lifts its limit, and it can't be unpaired on the page (only the grid operator, through Cantabile). While it limits the home, the add-on passes the limit on to the heat pumps and wallboxes at once and the Cantabile agent plans within it. Without the control box's heartbeat for two minutes the failsafe limit holds (4.2 kW unless the control box set another) for its failsafe time.
Protection
Every control of a heat pump or wallbox starts protected: Cantabile never sets a heat pump to 0 W or a wallbox to 0 A. Only you lift a protection, on the add-on's page, one control at a time; every change is logged with who and when.
Options
- Cantabile may control devices: your consent, above (off until you give it).
- Simulate: a simulated control box, heat pump and wallbox, with buttons on the page to send a limit or lose the heartbeat.
- Read only: commands are checked and logged, never written.
- Pass on the grid operator's limit: on by default.
The add-on uses the host's network: EEBUS devices find it by mDNS and connect to TCP ports 4712 (the control box) and 4713 (the other devices). The devices' support differs by model and firmware; the profiles are untested on real hardware so far.
Open-source components and their licences: see
/usr/share/doc/cantabile-eebus/THIRD-PARTY-NOTICES.md in the image.
© 2026 Setti Solutions S.R.L, www.setti.md. All rights reserved.