cantabile_edge, cantabile_modbus, cantabile_eebus 0.1.400: full source
This commit is contained in:
1 parent
343331d234
commit
d5fbcacaa4
176 files changed
+32511
-19
No files matched your search
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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"]
|
||||
@@ -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 |
@@ -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.
|
||||
@@ -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.
|
||||
Reference in new issue
Block a user