[Modul] NRG-Stack WPHub - Wärmepumpen-Cloud-Anbindung für IP-Symcon (Panasonic Comfort Cloud + Vaillant myVAILLANT), Cloud-Alternative zu HeishaMon

[Bricoleur]

Hallo zusammen,

wie im Teaser zum NRG-Stack (Vorankündigung) angekündigt, stelle ich die Module einzeln vor - hier WPHub, die Cloud-Anbindung für Wärmepumpen-Hersteller.

Worum geht es?

WPHub verbindet IP-Symcon mit Wärmepumpen-Herstellerclouds und stellt gefundene Geräte dem NRG-Stack-Verbund (z. B. dem EMS) zur Verfügung. Eine Hersteller-Auswahl je Instanz schaltet zwischen den unterstützten Clouds um - Stand heute:

• Panasonic Comfort Cloud (dasselbe Konto wie die offizielle App) - an meiner eigenen Aquarea-Anlage seit Wochen im Live-Betrieb verifiziert.
• Vaillant myVAILLANT (aroTHERM/aroTHERM plus) - gerade neu dazugekommen, aber noch nie gegen ein echtes Konto gelaufen (ich habe keine Vaillant-Anlage). Bewusst nur lesend, keine Steuerbefehle. Wer eine Vaillant-Wärmepumpe mit myVAILLANT-App hat und beim ersten Test helfen möchte: siehe Feedback unten, das wäre riesig hilfreich.

Gedacht ist WPHub vor allem für alle, die keine HeishaMon-Platine verbaut haben - für die war eine Panasonic-Aquarea bisher praktisch nicht ins Symcon-Energiemanagement eingebunden.

Das erklärte Ziel: wir wollen nach und nach weitere Wärmepumpen-Hersteller in WPHub integrieren - so wie InverterHub heute schon mehrere Wechselrichter-Hersteller in einem Modul bündelt. Panasonic und Vaillant sind der Anfang, nicht das Ziel. Als Nächstes im Blick: Mitsubishi MELCloud, Viessmann ViCare, Stiebel Eltron, NIBE, Daikin Onecta, Bosch/Buderus - jeder Hersteller hat aber sein eigenes, meist undokumentiertes Auth-/API-Schema, deshalb geht das nur Stück für Stück und vor allem nur mit echten Testern: ohne jemanden mit passender Anlage kann ich einen Treiber bestenfalls nach einer Referenz bauen, aber nie verifizieren (siehe Vaillant oben). Wer also eine Wärmepumpe eines anderen Herstellers hat und mittun möchte - immer gerne melden, auch ohne dass schon ein Treiber existiert.

Abgrenzung zu HeishaMon

HeishaMon bindet Panasonic-Wärmepumpen lokal per MQTT an - schneller, unabhängig vom Internet, aber nur mit einer zusätzlichen HeishaMon-Platine an der Anlage. WPHub geht denselben Weg über die Herstellercloud, ganz ohne Zusatzhardware - dafür mit den üblichen Cloud-Nachteilen (Internetabhängigkeit, Panasonic-Server als zusätzliches Glied). Wer bereits HeishaMon hat, braucht WPHub nicht zusätzlich. Wer beide parallel an derselben Anlage betreiben will oder muss (z. B. während einer Umstellung), kann das: WPHub erkennt eine aktive HeishaMon-Instanz und lässt sich je Gerät auf „nur lesen, HeishaMon regelt“ umschalten, damit sich beide nicht in die Quere kommen.

Funktionsumfang

• Anmeldung wie in der offiziellen App (Auth0-Handshake). Das Passwort wird nur für die einmalige Anmeldung verwendet und danach automatisch geleert - gespeichert bleibt nur der Zugangsschlüssel. Konten mit Zwei-Faktor-Authentifizierung werden aktuell noch nicht unterstützt.
• Automatische Gerätesuche: Aquarea-Wärmepumpen des Kontos werden gefunden; Klimageräte bindet WPHub bewusst nicht ein.
• Reichhaltige Messwerte je Wärmepumpe: Erreichbarkeit, Betriebsart, Außentemperatur, Warmwasser (Ist/Soll), Heizzonen (Ist/Soll), Flüsterbetrieb, Leistungsbetrieb, Eco-/Komfortmodus, Abtaubetrieb, Urlaubstimer, Notbetrieb, Fehleranzahl/-text sowie Tagesenergie (Heizen/Kühlen/Warmwasser/Gesamt).
• Externe Sensoren/Zähler optional verknüpfbar: Die Cloud liefert keine echte Leistung/Energie und keine Vor-/Rücklauf-/Puffertemperatur - dafür lässt sich eine beliebige vorhandene Symcon-Variable zuordnen (z. B. ein Shelly, MeterHub-Zähler, eigener Fühler).
• NRG-Stack-Vertrag: WPHUB_GetFunctions() liefert jede gefundene Wärmepumpe in derselben Form wie HeishaMon - Verbund-Module (EMS, Dashboard) behandeln beide Anbindungsarten identisch.

Voraussetzungen

• IP-Symcon 9.0 oder neuer
• Panasonic: ein Comfort-Cloud-Konto ohne Zwei-Faktor-Authentifizierung (dasselbe wie in der App). Vaillant: ein myVAILLANT-Konto. Beides mit Internetzugang.

Einrichtung in Kürze

1. Modulverwaltung → Modul-Store → ggf. erst „Beta-Module anzeigen" aktivieren → nach „NRG-Stack WPHub" suchen → hinzufügen.
2. Instanz „NRG-Stack WPHub" anlegen, im Panel „ Hersteller" Panasonic oder Vaillant wählen.
3. E-Mail und Passwort (bei Vaillant zusätzlich das Land des Kontos) eintragen, übernehmen.
4. „Anmelden und Wärmepumpen/Anlagen suchen" klicken, dann „WPHub aktiv" einschalten und übernehmen.

Lizenz

Lizenz: PolyForm Noncommercial 1.0.0 - private/nicht-kommerzielle Nutzung ist frei, gewerbliche Nutzung erfordert eine gesonderte Lizenz vom Rechteinhaber (DG65). Der vollständige Lizenztext liegt im Repo (LICENSE). Spenden sind willkommen: paypal.me/DietmarGureth.

Feedback

Das Modul ist neu - über Rückmeldungen, Fehler oder Wünsche freue ich mich hier im Thread. Besonders gesucht: jemand mit einer Vaillant-Wärmepumpe (myVAILLANT-App) für den ersten echten Test der Vaillant-Anbindung- die ist bislang nur nach der Referenzbibliothek gebaut, nie an einem echten Konto verifiziert. Und auch für weitere Herstellerclouds (Mitsubishi, Viessmann, Stiebel Eltron, …) gilt: wer passende Hardware hat und beim Testen helfen möchte, gerne melden - die Modularchitektur ist dafür vorbereitet.

Viele Grüße
Dietmar

[sunnyww]

Hey Dietmar,
ich könnte mit einer Samsung Samsung EHS Mono HT Quiet dienen.
Angebunden über die Samsung API und zusätzlich per „Waveshare Industrial RS232/RS485 to Ethernet Converter“

GitHub - echoDaveD/ehs_sentinel_hacs_integration

[Bricoleur]

Hey sunnyww,

dein Tipp zur Samsung-EHS-Anbindung hat es tatsächlich in die Tat umgesetzt - daraus sind sogar zwei neue Module geworden:

• SamsungEhs - genau dein Fall: RS485-Adapter + internes Protokoll, ohne Samsungs offizielles Modbus-Modul.
• WPModbusHub - falls doch mal das offizielle MIM-B19N-Modbus-Modul ins Spiel kommt (oder du NIBE-/Stiebel-Eltron-/LG-Besitzer in deinem Bekanntenkreis hast).

Für dich dürfte SamsungEhs das richtige sein, mit deinem Waveshare-Adapter.

Kurzer Hinweis zur Einordnung: Beide Module liefern nur die reine Datenverbindung zur Wärmepumpe, keine eigene Visualisierung. Die Anzeige (Diagramme, Kennzahlen wie COP) übernimmt unser Dashboard-Modul automatisch über den gemeinsamen Datenvertrag, sobald eine Instanz aktiv Werte liefert - dafür ist nichts weiter einzurichten.

Beide Module sind bewusst nur nach bestem Wissen gebaut, aber an keiner echten Anlage getestet - und jetzt, wo es dank deines Anstoßes existiert, bist du natürlich auch offiziell in der Bringschuld: Berichtspflicht, ob es bei dir läuft

Viele Grüße
Dietmar

[ArMu]

Hallo Bricoleur,

ich habe eine Fujitsu Waterstage WSYK160DG9 mit der Siemens-Steuerung RVS21.831/127. Die Wärmepumpe ist bei mir bereits über einen BSB-LAN-Adapter mit ESP32 in IP-Symcon integriert. Die Kommunikation ist über MQTT, JSON oder HTTP möglich.

Wäre es eventuell möglich, diese Anbindung in dein Modul mit aufzunehmen?

Beste Grüße

Lütfü

[Bricoleur]

Hallo Lütfü,

danke für den Hinweis, klingt interessant! Kurz zur Einordnung: WPHub bindet ausschließlich Wärmepumpen-Herstellerclouds über das Internet an (Panasonic Comfort Cloud, Vaillant myVAILLANT) - dein BSB-LAN-Adapter ist dagegen eine rein lokale Anbindung ohne Cloud, technisch näher an meinen anderen beiden Wärmepumpen-Modulen (WPModbusHub für Modbus, SamsungEhs für Samsungs NASA-Protokoll) als an WPHub. Das würde also eher ein eigenes, neues Modul werden als eine Erweiterung von WPHub.

Bevor ich das seriös einschätzen kann, ein paar konkrete Fragen zu deiner Anbindung:

1. Nutzt du BSB-LANs HTTP/JSON-Schnittstelle (z. B. /JQ?...) oder eher MQTT? Magst du mir ein Beispiel für eine tatsächliche Antwort/Nachricht schicken - am liebsten für Außentemperatur, Vorlauf-/Rücklauftemperatur, Warmwasser Ist/Soll und Betriebsart?
2. Welche BSB-LAN-Parameternummern nutzt du für genau diese Werte an deiner RVS21.831/127?
3. Ist deine Anbindung bei dir rein lesend, oder liest/schreibst du darüber auch (z. B. Sollwerte)?
4. Wärst du bereit, bei einem ersten Modul als Tester zu helfen (ähnlich wie bei WPModbusHub/SamsungEhs, wo ich ohne echte Anlage nichts verifizieren kann)?

Mit diesen Infos kann ich einschätzen, ob und wie sich das sauber bauen lässt.

Viele Grüße
Dietmar

[ArMu]

Hallo Dietmar,

danke für deine Rückmeldung.

Die BSB-LAN-Anbindung läuft bei mir erst seit etwa drei Wochen. Ich habe sie gerade neu eingerichtet und erkunde selbst noch die Möglichkeiten.

Zu deinen Fragen:

1. Ich nutze aktuell hauptsächlich die HTTP/JSON-Schnittstelle von BSB-LAN. Die Werte lassen sich beispielsweise über /JQ=<Parameternummer> abrufen.

Ein paar aktuelle Antworten meiner Anlage:

Außentemperatur – Parameter 8700

{
  "8700": {
    "Name": "Außentemperatur",
    "dataType_name": "TEMP",
    "Fehler": 0,
    "Wert": "11,9",
    "Genauigkeit": 0,1,
    "readwrite": 1,
    "Einheit": "°C"
  }
}

Vorlauftemperatur Wärmepumpe – Parameter 8412

{
  "8412": {
    "name": "Vorlauftemperatur Wärmepumpe",
    "dataType_name": "TEMP",
    "error": 0,
    "value": "23.8",
    "precision": 0.1,
    "readwrite": 1,
    "unit": "°C"
  }
}

Rücklauftemperatur Wärmepumpe – Parameter 8410

{
  "8410": {
    "name": "Rücklauftemperatur Wärmepumpe",
    "dataType_name": "TEMP",
    "error": 0,
    "value": "33.4",
    "precision": 0.1,
    "readwrite": 1,
    "unit": "°C"
  }
}

2. Bei der Einrichtung hatte ich Unterstützung von Frederik aus dem BSB-LAN-Projekt. Ich habe ihm die Rohdaten meiner RVS21.831F/127 zur Verfügung gestellt. Daraus hat er die passende Parameterdefinition für meinen Regler erstellt.

Es stehen ca. 6.000 Parameter für meine RVS21.831F/127 zur Verfügung. Natürlich habe ich davon bisher noch nicht alles getestet.

3. Aktuell nutze ich die BSB-LAN-Anbindung nur lesend. Schreibzugriffe auf Sollwerte habe ich bisher noch nicht umgesetzt bzw. getestet.

4. Ja, ich wäre gerne bereit, bei einem ersten Modul als Tester zu unterstützen.

Viele Grüße
Lütfü

[Bricoleur]

Hallo Lütfü,

danke für die Beispiele - ich habe inzwischen selbst in der offiziellen BSB-LAN-Dokumentation und der technischen API-Beschreibung des Projekts nachgesehen: Zwei deiner drei Beispiele (Vorlauf-/Rücklauftemperatur) entsprechen genau dem aktuellen, offiziellen Format, das dauerhaft stabil bleibt (unabhängig von deiner Anlage) - da brauche ich also nichts weiter von dir. Damit ist das für mich geklärt, du musst dich um dieses Detail nicht weiter kümmern.

Ich bin außerdem auf einen Blog eines anderen Fujitsu-Waterstage-Besitzers mit BSB-LAN gestoßen, der eine Parameterliste für genau diese Baureihe veröffentlicht hat. Deine eigenen Werte für Vorlauf (8412) und Rücklauf (8410) tauchen dort exakt genauso auf - das spricht dafür, dass die restliche Liste für dich ebenfalls passt, sicher weiß ich es aber erst, wenn du es an deiner Anlage geprüft hast.

Magst du bitte diese drei Adressen in deinem Browser aufrufen (die IP/den Hostnamen deines BSB-LAN-Adapters wie gewohnt einsetzen) und mir kurz sagen, ob die Werte plausibel aussehen (z. B. im Vergleich zur App/zum Display deiner Anlage)?

• http://<deine-bsb-lan-adresse>/JQ=8830 (vermutlich Warmwassertemperatur Ist)
• http://<deine-bsb-lan-adresse>/JQ=8831 (vermutlich Warmwassertemperatur aktueller Sollwert)
• http://<deine-bsb-lan-adresse>/JQ=700 (vermutlich Betriebsart)

Einfach das, was im Browser erscheint, hier reinkopieren - mehr brauche ich nicht. Falls einer der drei nicht plausibel aussieht oder eine Fehlermeldung kommt, auch das gerne einfach so schicken, wie es kommt.

Viele Grüße
Dietmar

[ArMu]

Hallo,

hier sind die drei Rückmeldungen der Parameter. Die Werte sind identisch mit den Werten, die die Anlage auf dem Display anzeigt.

{
  "8830": {
    "name": "Trinkwassertemperatur-Istwert Oben (B3)",
    "dataType_name": "TEMP",
    "dataType_family": "VALS",
    "destination": 0,
    "error": 0,
    "value": "52.5",
    "desc": "",
    "payload": "000D1E",
    "precision": 0.1,
    "dataType": 0,
    "readwrite": 1,
    "unit": "°C"
  }
}

{
  "8831": {
    „name“: „Trinkwassertemperatur-Sollwert aktuell“,
    "dataType_name": "TEMP",
    "dataType_family": "VALS",
    "Ziel": 0,
    "Fehler": 0,
    "Wert": "55,0",
    "desc": "",
    "Nutzlast": "000DC0",
    "Genauigkeit": 0,1,
    "Datentyp": 0,
    "readwrite": 1,
    "Einheit": "°C"
  }
}

{
  "700": {
    "Name": "Betriebsart",
    "dataType_name": "ENUM",
    "dataType_family": "ENUM",
    "Ziel": 0,
    "Fehler": 0,
    "Wert": "0",
    "desc": "Schutzbetrieb",
    "Nutzlast": "0000",
    "Datentyp": 1,
    "readwrite": 1,
    "Einheit": ""
  }
}

[ArMu]

Hallo Dietmar,

ich habe inzwischen auch einen Schreibtest über BSB-LAN durchgeführt. Der Parameter 1200 (Betriebsartumschaltung) ließ sich erfolgreich von „Reduziert“ auf „Komfort“ ändern und anschließend wieder korrekt auslesen.

[Bricoleur]

Hallo Lütfü,

danke, die Werte passen exakt - damit sind jetzt alle sechs Werte, die ich brauche, an deiner Anlage bestätigt.

Ich habe daraus ein neues, eigenständiges Modul gebaut: WPBsbLan. Anders als bei meinen anderen Wärmepumpen-Modulen gibt es hier keine feste Registerliste je Hersteller - BSB-LAN-Parameternummern sind ja individuell für jede Anlage. Stattdessen trägt man die Parameternummern für Außentemperatur, Vorlauf, Rücklauf, Warmwasser Ist/Soll und Betriebsart selbst ins Formular ein, vorbelegt mit genau den Werten, die du mir bestätigt hast.

Du bekommst es im Symcon Module Store unter „NRG-Stack WPBsbLan" zum Installieren. Du bist wie besprochen somit der erste Tester für dieses Modul.

Viele Grüße
Dietmar

[Bricoleur]

Hallo Lütfü,

danke für den Test - gut zu wissen, dass Schreiben über BSB-LAN bei dir zuverlässig funktioniert, und interessant, dass die Betriebsartumschaltung (1200) ein eigener Parameter ist, getrennt vom nur lesbaren Statuswert (700).

WPBsbLan bleibt in der ersten Version trotzdem bewusst nur lesend, wie meine anderen Wärmepumpen-Module auch - Schreibzugriff auf eine Heizung ist etwas, das ich mir für eine spätere Version aufhebe, nicht spontan aus einem einzelnen Test heraus einbaue. Deine Rückmeldung habe ich mir aber notiert, falls das später kommt.

Viele Grüße
Dietmar

[ArMu]

Hallo Diemar,

ich habe das Modul installiert und getestet. Die Werte werden alle korrekt angezeigt und sind identisch mit den Werten auf dem Display meiner Anlage.

Damit scheint das Modul bei meiner Fujitsu Waterstage WSYK160DG9 schon einmal einwandfrei zu funktionieren.

Beste Grüße
Lütfü

[ArMu]

Hallo Dietmar,

ich habe inzwischen noch etwas weiter getestet. Dabei zeigt sich, dass 700, 1200 und 1201 tatsächlich unterschiedliche Parameter sind.

• 700 – Betriebsart, Heizkreis 1: ließ sich von 0 = Schutzbetrieb auf 3 = Komfort schreiben.

• 1200 – Betriebsartumschaltung: ließ sich ebenfalls schreiben. Ich hatte ihn zunächst von 2 = Reduziert auf 3 = Komfort gesetzt. BSB-LAN bezeichnet den Parameter beim Schreiben als Heizkreis 2 – Betriebsartumschaltung.

• 1201 – Betriebsart: ließ sich ebenfalls schreiben. Der Schreibvorgang wurde von BSB-LAN als Kühlkreis 2 – Betriebsart: 3 = Komfort bestätigt.

Interessant ist dabei, dass sich die Werte nicht automatisch gegenseitig ändern. Nachdem ich 700 auf Komfort gesetzt hatte, blieb 1200 weiterhin auf Reduziert.

Beste Grüße

Lütfü

[Bricoleur]

Hallo Lütfü,

danke für die genaue Aufschlüsselung - sehr hilfreich, dass 700/1200/1201 tatsächlich getrennte Kreise sind und sich nicht gegenseitig mitändern.

Magst du Heizkreis 2 (1200) und Kühlkreis 2 (1201) als zusätzliche, eigene Felder im Formular haben? Falls ja: Hat deine Anlage diese Kreise überhaupt real im Einsatz, oder sind das bei dir nur technisch vorhandene, aber ungenutzte Parameter? Das würde mir helfen einzuschätzen, ob sich zwei weitere Felder lohnen oder ob 700 (Heizkreis 1) für den Alltag ohnehin reicht.

Viele Grüße
Dietmar

[ArMu]

Hallo Dietmar,

bei meiner Anlage sind Heizkreis 2 (1200) und Kühlkreis 2 (1201) zwar vorhanden, werden aber aktuell nicht genutzt. Bei mir ist nur Heizkreis 1 (700) tatsächlich im Einsatz.

Du kannst aber gerne noch 901 = Kühlkreis 1 – Betriebsart als eigenes Feld ins Formular aufnehmen. Diesen Parameter benutze ich gelegentlich, wenn der Kühlbetrieb aktiviert bzw. angepasst werden soll.

Die beiden zusätzlichen Felder für Heizkreis 2 und Kühlkreis 2 würde ich dagegen nicht unbedingt benötigen.

Viele Grüße
Lütfü

[Bricoleur]

Hallo Lütfü,

901 ist jetzt als eigenes Feld „Betriebsart Kühlkreis 1“ drin (Version 0.2.0), genau wie Heizkreis 1 mit Code und Klartext. Heizkreis 2/Kühlkreis 2 lasse ich wie besprochen erstmal draußen.

Viele Grüße
Dietmar

[ArMu]

Hallo Dietmar,

perfekt, vielen Dank! Ich habe die Version 0.2.0 installiert und „Betriebsart Kühlkreis 1“ wird bei mir korrekt angezeigt.

Damit passt es für meine Anlage genau so.

Beste Grüße
Lütfü

[Bricoleur]

Hallo zusammen,

ein Wort an alle, die bei einem meiner „Sondermodule“ mitgeholfen haben - @kollaps Christian (IDM ALM), @Ghostraider (Proxon T300), @sunnyww Simon (Samsung EHS über NASA) und @ArMu Lütfü (Fujitsu Waterstage über BSB-LAN): Danke nochmal für eure Geduld beim Testen und die genauen Rückmeldungen. Ohne echte Anlagen hätte ich keines dieser Module verifizieren können.

Kurz zur Einordnung, was das jetzt für euch bedeutet: Sobald ein Modul Werte liefert (Temperaturen, Betriebsart usw.), taucht eure Wärmepumpe automatisch im NRG-Stack Dashboard auf - in den Diagrammen und der Übersichtsgrafik, ohne dass ihr etwas zusätzlich verknüpfen müsst. Das gilt jetzt für alle vier Module - WPModbusHub, WPModbusHubGateway, SamsungEhs und WPBsbLan sind im Dashboard hinterlegt.

Ein Hinweis zur Ehrlichkeit: Nur Werte, die euer Modul tatsächlich liefert, tauchen auch auf - keine Wärmepumpe dieser Liste liefert eine echte Momentanleistung, deshalb bleibt der Energiefluss-Teil der Kachel (die Pfeile zwischen PV/Batterie/Haus) bei euch leer. Die eigentlichen Wärmepumpen-Diagramme (Temperaturverläufe, Betriebsart usw.) sind davon nicht betroffen.

Viele Grüße
Dietmar

[kollaps]

Hallo Dietmar,
vielen Dank für deine super Arbeit.
Die Module sind super geworden.

Hier noch eine kleine Idee für die Visualisierung. Mir ist aber auch klar, dass man da nicht
alle Möglichkeiten mit integrieren kann, was es auf dem Markt gibt.

Ich habe bei mir einen z.B. einen Kombi-Speicher verbaut.
Wäre cool, wenn man beim Anlageschema evtl auswählen könnte welchen Typ man nutzt.
Also, Puffer, Kombispeicher, Puffer+Warmwasserspeicher.
Mein Anlageschema sieht z.B. so aus was sich bis auf den Speicher ganz gut bei dir abbilden lässt.

Wäre ja fast das gleiche Schaubild, nur mit 3 Abgängen. Oben für das Warmwasser, Mitte für das Heizen VL und unten für den Rücklauf. Ich habe da auch 3 bzw. 4 Temperaturen. WW oben, WW unten, Wärmespeicher und Rücklauf.
Und die Detla T wären auch toll, wenn man die bei den Temperaturen mit anzeigen lassen könnte wie beim Split-Schema das auch gemacht wird. auch.

Ich weiß ja leider auch nicht, wie aufwendig so eine Visualisierung ist.

Viele Grüße
Christian

[cbeham]

Hi, gerade installiert. Ich sehe aber nur „Panasonic“ keine Vaillant
Ansonsten würde ich gerne testen…
Im Moment ist sie über ein ise Smart Connect eingebunden.
lg