Lokale Integration von EEBUS-faehigen Waermepumpen in Home Assistant ueber das EEBUS-Protokoll (SHIP + SPINE) -- ohne Cloud, ohne mypyllant-Abhaengigkeit fuer Lastmanagement.

• Leistungsbegrenzung (LPC) -- Paragraph-14a-konforme Laststeuerung via EEBUS
• Leistungsmessung -- Elektrische Verbrauchsdaten der Waermepumpe in Echtzeit
• Discovery & Pairing -- mDNS-Erkennung und SKI-basiertes Pairing ueber den HA Config Flow
• Heartbeat-Ueberwachung -- Sicherheitsrelevanter EEBUS-Heartbeat mit Failsafe-Fallback
• Energy Dashboard -- Volle Integration mit dem HA Energy Dashboard
• Erweiterbar -- Architektur vorbereitet fuer zukuenftige EEBUS-HVAC-Use-Cases

Home Assistant                    eebus-bridge (Go)         Vaillant VR940f
+----------------+    gRPC    +------------------+   SHIP   +--------------+
| eebus custom   |<---------->| gRPC Server      |<-------->| aroTHERM plus|
| integration    |            | eebus-go (SHIP/  |          | (EEBUS CS)   |
| (Python)       |            | SPINE embedded)  |          |              |
+----------------+            +------------------+          +--------------+

1. HACS in Home Assistant oeffnen
2. Integrations > drei Punkte oben rechts > Custom repositories
3. Repository-URL einfuegen: https://github.com/volschin/eebus-ha-bridge
4. Kategorie: Integration > Add
5. Nach "EEBUS" suchen und Download klicken
6. Home Assistant neustarten

1. Neuestes Release von der Releases-Seite herunterladen
2. Den Ordner eebus nach custom_components/eebus/ kopieren
3. Home Assistant neustarten

Der Go-basierte Bridge-Dienst muss separat laufen (Docker empfohlen):

docker-compose up -d eebus-bridge

Alternativ als Binary:

./eebus-bridge --config config.yaml

1. Settings > Devices & Services > Add Integration
2. Nach EEBUS suchen
3. Bridge-Host und Bridge-Port eingeben (Standard: localhost:50051)
4. Die Integration testet die Verbindung zur Bridge
5. Geraete-SKI eingeben (wird in der Bridge-Log beim Discovery angezeigt)
6. In der myVaillant-App das Pairing bestaetigen

Bridge-Adresse aendern: Settings > Devices & Services > EEBUS > Configure

Settings > Devices & Services > EEBUS > Delete

Die Integration nutzt gRPC Streaming (Server-Sent Events) fuer Echtzeit-Updates. Bei Stream-Abbruch wechselt sie automatisch auf Polling (30s Intervall) und verbindet den Stream im Hintergrund neu.

• Leistungsmessung: Event-basiert (ca. alle 60s vom Inverter)
• LPC-Limits: Event-basiert (bei Aenderung)
• Heartbeat: Alle 4 Sekunden (im Bridge, nicht in HA)

• Vaillant Gateway (VR920/VR921/VR940f) mit aktiviertem EEBUS
• Gateway und eebus-bridge im selben Netzwerk
• Docker oder Go 1.22+ fuer den Bridge-Dienst

• HVAC-Steuerung (Betriebsmodi, Sollwerte) -- Vaillant exponiert diese nicht ueber EEBUS
• Geraete ohne EEBUS-Schnittstelle

automation:
  - alias: "PV-Ueberschuss an Waermepumpe"
    trigger:
      - platform: numeric_state
        entity_id: sensor.pv_ueberschuss
        above: 2000
    action:
      - service: number.set_value
        target:
          entity_id: number.eebus_lpc_limit
        data:
          value: "{{ states('sensor.pv_ueberschuss') | float }}"
      - service: switch.turn_on
        target:
          entity_id: switch.eebus_lpc_active

automation:
  - alias: "Paragraph 14a Leistungsbegrenzung"
    trigger:
      - platform: state
        entity_id: binary_sensor.netzbetreiber_signal
        to: "on"
    action:
      - service: number.set_value
        target:
          entity_id: number.eebus_lpc_limit
        data:
          value: 4200
      - service: switch.turn_on
        target:
          entity_id: switch.eebus_lpc_active

• Keine HVAC-Steuerung: Vaillant exponiert Betriebsmodi und Sollwerte nicht ueber EEBUS. Dafuer weiterhin mypyllant nutzen.
• Kein Auto-Discovery in HA: Die Bridge-Adresse muss manuell eingegeben werden. Die EEBUS-Discovery (mDNS) findet Waermepumpen, aber die Bridge selbst wird nicht von HA entdeckt.
• Re-Pairing bei Zertifikatsverlust: Wird das Bridge-Zertifikat geloescht, aendert sich der SKI. Erneutes Pairing in der myVaillant-App noetig.
• Heartbeat bei Bridge-Ausfall: Die Waermepumpe erkennt den Heartbeat-Timeout (max 2 min) und faellt auf den Failsafe-Wert zurueck.

MIT License -- siehe LICENSE.