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

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 „:factory: 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