cantabile_edge, cantabile_modbus, cantabile_eebus 0.1.400: full source

This commit is contained in:
Setti Solutions S.R.L committed 2026-10-30 08:26:45 +02:00
1 parent 343331d234
commit d5fbcacaa4
176 files changed
+32511 -19

No files matched your search

+27
View File
@@ -0,0 +1,27 @@
# Changelog
## 0.1.x
- First version (experimental, not yet tried with real devices): pairs
with EEBUS devices on your network on the add-on's page, after you
compare their SKI: the grid operator's control box (§14a), heat pumps
(Vaillant aroTHERM, Viessmann Vitocal, Bosch Compress and others),
wallboxes and inverters.
- Shows each paired device in Home Assistant in the area "Cantabile":
power and energy (kWh), the heat pump's power limit, the wallbox's car,
charging power, energy and current limit, an inverter's solar and
battery, the grid connection point.
- The grid operator's limit: shown on the page, passed on to the heat
pumps and wallboxes at once and handed to the Cantabile agent, which
plans within it. It can't be lifted from Home Assistant.
- Every control starts protected: Cantabile never sets a heat pump to
0 W or a wallbox to 0 A unless you lift that on the page.
- Your consent to control in the add-on's configuration; without it the
add-on only reads.
- A simulator (option "Simulate") with a control box, a heat pump and a
wallbox to try it without devices.
- The page in English or German, light or dark as Home Assistant.
---
© 2026 Setti Solutions S.R.L, [www.setti.md](https://www.setti.md). All rights reserved.
+81
View File
@@ -0,0 +1,81 @@
# 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):
1. 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.
2. 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).
3. **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](https://www.setti.md). All rights reserved.
+23
View File
@@ -0,0 +1,23 @@
# Copyright © 2026 Setti Solutions S.R.L, www.setti.md. All rights reserved.
# The EEBUS bridge add-on's image: the Hub's bridge (one Go binary) and the
# device profiles; -ha reads the add-on's options and the Supervisor's
# broker. Built from the repository's root:
# docker build -f cantabile_eebus/Dockerfile --build-arg VERSION=<v> \
# -t <registry>/cantabile-ha-eebus-amd64:<v> .
FROM docker.io/library/golang:1.26.9-bookworm AS build
WORKDIR /src
COPY src/eebus-bridge/go.mod src/eebus-bridge/go.sum ./
RUN go mod download
COPY src/eebus-bridge/*.go ./
ARG VERSION=0.0.0-dev
RUN CGO_ENABLED=0 go build -trimpath -ldflags="-s -w -X main.version=${VERSION}" -o /cantabile-eebus .
FROM docker.io/library/alpine:3.22
ARG VERSION ARCH=amd64 REVISION
LABEL io.hass.version="${VERSION}" io.hass.type="addon" io.hass.arch="${ARCH}" \
org.opencontainers.image.revision="${REVISION}"
COPY --from=build /cantabile-eebus /usr/bin/cantabile-eebus
COPY src/eebus-bridge/THIRD-PARTY-NOTICES.md /usr/share/doc/cantabile-eebus/
COPY src/profiles/*.json /app/profiles/
ENV DATA_DIR=/data PROFILES_DIR=/app/profiles PAGE_PORT=8099
ENTRYPOINT ["/usr/bin/cantabile-eebus", "-ha"]
+41
View File
@@ -0,0 +1,41 @@
# Copyright © 2026 Setti Solutions S.R.L, www.setti.md. All rights reserved.
# Cantabile's EEBUS bridge as a Home Assistant add-on: the Hub's bridge
# (src/eebus-bridge) with Cantabile's device profiles, for a Home
# Assistant that isn't a Cantabile Hub. Devices are paired on its page
# (ingress), by their SKI.
name: Cantabile EEBUS
version: "0.1.400"
slug: cantabile_eebus
description: Pairs with EEBUS devices (the grid operator's control box, heat pumps, wallboxes, inverters), shows them in Home Assistant under Cantabile's names and hands the grid operator's §14a limit to the Cantabile agent; every control with its protection.
url: https://cantabile.cloud
arch: [amd64]
image: git.setti.solutions/daniel/cantabile-ha-eebus-{arch}
stage: experimental
startup: application
boot: auto
services:
- mqtt:need
# EEBUS: devices find the bridge by mDNS and connect to the address it
# announces (SHIP, TCP 4712); both need the host's network.
host_network: true
ingress: true
ingress_port: 8099
panel_icon: mdi:transmission-tower
panel_title: Cantabile EEBUS
panel_admin: true
# consent_control: the owner's consent, given here when installing: without
# it the add-on reads and writes nothing to the devices (DOCS.md "Your
# consent"). It sends nothing out of the home, so it asks no data consent.
options:
consent_control: false
simulate: false
read_only: false
pass_on_limits: true
schema:
consent_control: bool
simulate: bool
read_only: bool
pass_on_limits: bool
port: "port?"
interfaces:
- str?
Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

+34
View File
@@ -0,0 +1,34 @@
# Copyright © 2026 Setti Solutions S.R.L, www.setti.md. All rights reserved.
configuration:
consent_control:
name: Cantabile darf Geräte steuern
description: >-
Ihre Einwilligung: Cantabile darf die von Ihnen gewählten Geräte
(Heizung, Laden, Batterie, Beschattung) innerhalb der von Ihnen
gesetzten Grenzen steuern. Hier: die gekoppelten Wärmepumpen und
Wallboxen, auch das Weitergeben des Limits des Netzbetreibers. Ohne
sie liest das Add-on sie nur.
simulate:
name: Simulieren
description: >-
Eine simulierte Steuerbox, Wärmepumpe und Wallbox statt des Netzwerks
(zum Ausprobieren: Koppeln, Werte, ein Limit des Netzbetreibers), ohne
echte Geräte zu berühren.
read_only:
name: Nur lesen
description: >-
Befehle werden geprüft und protokolliert, aber nie an die Geräte
geschrieben (Probelauf). Werte werden wie gewohnt gelesen.
pass_on_limits:
name: Limit des Netzbetreibers weitergeben
description: >-
Wenn die Steuerbox das Haus begrenzt (§14a), das Limit sofort an die
gekoppelten Wärmepumpen und Wallboxen weitergeben; der Cantabile-Agent
verteilt es dann innerhalb des Limits.
port:
name: EEBUS-Port
description: Der TCP-Port für EEBUS (SHIP) zur Steuerbox (4712); die anderen Geräte nutzen den nächsten (4713).
interfaces:
name: Netzwerkschnittstellen
description: >-
Nur diese Schnittstellen für mDNS (z. B. eth0); leer: alle.
+33
View File
@@ -0,0 +1,33 @@
# Copyright © 2026 Setti Solutions S.R.L, www.setti.md. All rights reserved.
configuration:
consent_control:
name: Cantabile may control devices
description: >-
Your consent: allow Cantabile to control the devices you choose
(heating, charging, battery, shades) within the limits you set. Here:
the paired heat pumps and wallboxes, including passing the grid
operator's limit on to them. Without it the add-on only reads them.
simulate:
name: Simulate
description: >-
A simulated control box, heat pump and wallbox instead of the network
(for trying the add-on: pairing, values, a grid operator's limit),
never touching real devices.
read_only:
name: Read only
description: >-
Commands are checked and logged but never written to the devices (a
dry run). Values are read as usual.
pass_on_limits:
name: Pass on the grid operator's limit
description: >-
When the control box limits the home (§14a), pass the limit on to the
paired heat pumps and wallboxes at once; the Cantabile agent then
shares it out within the limit.
port:
name: EEBUS port
description: The TCP port for EEBUS (SHIP) toward the control box (4712); the other devices use the next one (4713).
interfaces:
name: Network interfaces
description: >-
Only these interfaces for mDNS (e.g. eth0); empty: all.