[Modul] NRG-Stack HeishaMon / Panasonic Aquarea Wärmepumpe in IP-Symcon

[Bricoleur]

Nachtrag vom 19.09.2026 (aktueller Stand v1.30.0): Seit diesem Beitrag im Juni ist viel passiert, das Modul ist inzwischen auch im Symcon Store gelistet. Alle Neuerungen habe ich in einem Nachtragspost gesammelt: Zum Nachtrag

Worum geht es?

HeishaMon ist eine kleine Platine, die am CN-CNT-Bus einer Panasonic Aquarea Wärmepumpe (H/J/K/L/M-Serie) mitliest und über 150 Datenpunkte per MQTT bereitstellt - komplett lokal, ohne Cloud, ohne Abo. Dieses Modul bindet den HeishaMon vollständig in IP-Symcon ein: alle Datenpunkte als Variablen, schaltbare Werte direkt bedienbar, dazu eine ganze Reihe Funktionen, die deutlich über das reine Anzeigen hinausgehen.

Was das Modul von anderen Anbindungen unterscheidet

Alle anderen SmartHome-Anbindungen für HeishaMon (Home Assistant, openHAB, Domoticz, ioBroker, Node-RED) sind reine Datenpunkt-Mapper. Dieses Modul kann vier Dinge, die es dort nicht gibt:

• Energiespar-Prüfung - bewertet die von der Anlage empfangenen Service-Einstellungen (Warmwasser-Sollwert, Heizstab-Freigaben, Heizgrenze, Heizkurve, Pumpenansteuerung) und das echte Taktverhalten (Laufzeit je Verdichterstart aus den Betriebszählern) anhand von Richtwerten aus den dokumentierten HeishaMon-Referenz-Regelwerken und dem Panasonic-Servicehandbuch. Konkrete Sparhinweise direkt in der Konfiguration - reine Anzeige, verändert nichts.
• Taktschutz per Knopfdruck - das Modul spielt ein parametrisiertes Schutz-Regelwerk (Wiederanlauf-Sperre nach Verdichterstopp, mit Kälte-Override) direkt auf die HeishaMon-Platine. Es läuft dort autonom weiter, selbst wenn WLAN oder IP-Symcon ausfallen. Sperrzeit und Temperaturschwelle sind einstellbar, optional auch für den Kühlbetrieb (eigener Regelzweig, da die Anlage Heiz- und Kühlanforderung getrennt führt); die Firmware validiert jeden Upload selbst.
• Neustart-Watchdog + Platinen-Diagnose - hängt MQTT länger als eingestellt, startet das Modul die Platine über deren Reboot-Schnittstelle neu (Opt-in, mit Schleifenschutz). Und die Diagnose-Gruppe (WLAN-Qualität, Laufzeit, MQTT-Neuverbindungen, Bus-Lesequalität, Firmware-Version) zeigt bei Verbindungsproblemen die Ursache statt nur das Symptom - WLAN-Qualität und Neuverbindungen werden automatisch archiviert.
• NRG-Stack-Verbund - andere Module der NRG-Stack-Familie (Energiemanagement, Anlagenschema-Kachel, Wärmepumpen-Monitor) finden die Wärmepumpe automatisch über HEISHA_GetFunctions() - ohne manuelle Variablen-Zuweisung, inklusive gemessenem COP, Tages-Arbeitszahl, herstellerneutraler Betriebsart und Heizstab-Status. Ist bereits ein MeterHub-Zähler mit Funktionszuordnung „Wärmepumpe" vorhanden, schlägt das Modul ihn automatisch vor. Wer zusätzlich WPHub (Panasonic Comfort Cloud) für dieselbe Anlage nutzt, bekommt einen Hinweis, damit beide Kanäle nicht gleichzeitig schreiben.

Funktionsumfang im Überblick

Datenpunkte & Bedienung

• 151+ Datenpunkte, automatisch angelegt sobald die Anlage sie sendet; Spalte „Empfangen" zeigt, was die eigene Anlage tatsächlich liefert
• Schaltbare Werte (Betriebsart, Solltemperaturen, Flüstermodus, Powerful, Force-DHW, Heizkurven u. v. m.) direkt aus Symcon
• Auswahl und Reihenfolge der Datenpunkte frei konfigurierbar (Ziehen mit der Maus); Abwählen blendet aus, Archivdaten bleiben
• Optionale Verknüpfungsstruktur: gruppierter Kategoriebaum (Betrieb/Heizen/Warmwasser/…) für eine aufgeräumte WebFront-Navigation

COP & Arbeitszahl

• COP aus den Anlagen-Schätzwerten und echt gemessen über einen externen Zähler (z. B. Shelly 3EM auf der WP-Phase - oder ein direkt an der Platine angeschlossener S0-Zähler, ganz ohne Zusatzaktor)
• Tages-Arbeitszahl aus Wärmemenge und kWh-Zählerstand, mit Mitternachts- und Zählertausch-Logik
• Thermische Gesamtleistung als eigene Variable - zusammen mit der elektrischen Leistung die Basis für Monitoring-Charts

Erweiterte Hardware-Unterstützung

• 1-Wire-Temperatursensoren (z. B. DS18B20 am Puffer): automatische Erkennung beim ersten Messwert, Benennung im Formular
• S0-Zähler an der Platine: Leistung + Gesamtenergie (kWh) je Port
• Relais der großen Platine und SmartGrid-Modus als digitaler SG-Ready-Ersatz (die vier Betriebsstufen Normal/Überhöhung 1+2/WP+Heizstab aus per MQTT statt Trockenkontakt)

Komfort & Betrieb

• Automatische Archivierung aller Monitoring-Datenpunkte (einmalig, Nutzer-Abwahl wird respektiert) - Zeitreihen-Kacheln funktionieren ohne Handarbeit
• Ausführliche Dokumentation & Hilfe direkt im Formular, ?-Hilfen an allen erklärungsbedürftigen Feldern
• Vollständig deutsch übersetzt; über 260 automatisierte Tests sichern jede Version ab

Voraussetzungen

• IP-Symcon ab Version 9.0
• HeishaMon-Platine (Original oder Nachbau) am CN-CNT-Port der Wärmepumpe, mit MQTT verbunden
• Ein MQTT-Server/-Broker in Symcon (Kern-Instanz oder extern)

Installation & Einrichtung

1. Modulverwaltung → Symcon Store → „NRG-Stack HeishaMon" suchen und hinzufügen, dabei den Beta-Kanal wählen (führt den aktuellen Funktionsstand; der Stable-Kanal folgt zu gegebener Zeit).
2. HeishaMon-Instanz unter dem MQTT-Server anlegen
3. MQTT-Basistopic eintragen (muss exakt dem in der HeishaMon-Weboberfläche entsprechen, Standard panasonic_heat_pump) - fertig, die Variablen entstehen von selbst

Alles Weitere (Zähler, Verknüpfungsstruktur, Regelwerke, Watchdog) ist optional und im Formular ausführlich dokumentiert.

Lizenz

Wie alle Module des NRG-Stack:

Lizenz: PolyForm Noncommercial 1.0.0 — private/nicht-kommerzielle Nutzung ist frei, gewerbliche Nutzung erfordert eine gesonderte Lizenz vom Rechteinhaber (DG65). Der Wechsel wirkt nur nach vorn: bereits unter MIT veröffentlichte Altversionen (bis Version 1.2.0) bleiben MIT. Der vollständige Lizenztext liegt im Repo (LICENSE). Spenden sind willkommen: paypal.me/DietmarGureth.

Für die Symcon-Hobby-Community ändert sich damit nichts — private Nutzung bleibt komplett frei. Gewerbliche Interessenten (Integratoren/Dienstleister) melden sich einfach per PN.

Haftung

Das Modul steuert eine reale Heizungsanlage. Alle Schreibbefehle nutzen die offiziellen HeishaMon-Kommandos, dennoch gilt: Nutzung auf eigene Verantwortung, keine Gewähr für Schäden an der Anlage. Service-Einstellungen (Heizkurven, Heizstab-Freigaben etc.) bitte bewusst ändern — im Zweifel mit dem Fachbetrieb.

Dank & Feedback

Ein großer Teil der letzten Versionen geht direkt auf Rückmeldungen aus diesem Thread zurück (1-Wire-Erkennung, Relais, SmartGrid-Modus, Mobile-App-Fix — danke, Wuwu!). Fehler, Wünsche und Anlagen-Erfahrungen gerne hier in den Thread.

[Wuwu]

Moin Bricoleur,

vielen Dank für Dein Modul!
Hab es gerade bei meinen Eltern installiert, da Panasonic Wärmepumpe neu montiert wurde.
Eine große HeishaMon Platine v6 tut da jetzt Ihren Dienst.

Kannst Du mir noch sagen, wie ich am elegantesten 2 zusätzliche DS18B20 Sensoren vom 1-Wire Bus ins IPS bekomme? Hab sie manuell als MQTT Client angelegt, aber das scheint nicht so richtig zu sein, da die Variable zwar angezeigt wird, aber als veränderbar???

Die Listenstruktur wird bei mir auch nicht angezeigt. Hab sie auch erst nachträglich in der Instanzkonfiguration aktiviert. Gibt es da einen Trick?

[Bricoleur]

Moin Wuwu,

danke für den ausführlichen Bericht — beides war ein echter Gewinn, ich hab’s direkt gefixt.

1) Verknüpfungsstruktur

Das war tatsächlich eine Lücke im Formular, kein Fehler bei Dir. Die Verknüpfungsstruktur ist genau dafür gedacht, im WebFront eine übersichtliche, gruppierte Navigation zu ergeben — sonst liegen ja alle Datenpunkte flach und in einer langen Liste unter der Instanz. Zwei Dinge könnten bei Dir gefehlt haben:

• Ohne ausgewählte Zielkategorie legt das Modul bisher stillschweigend nichts an — keine Fehlermeldung, es passiert einfach nichts. Prüf, ob im Bereich „Verknüpfungsstruktur“ neben der Checkbox auch eine Zielkategorie gesetzt ist.
• Damit die Struktur im WebFront auftaucht, sollte die gewählte Zielkategorie selbst an einer Stelle liegen, die im WebFront sichtbar ist (also nicht irgendwo versteckt im Objektbaum) — dann erscheint darunter automatisch der Kategoriebaum mit allen Deinen aktiven Datenpunkten, gruppiert nach Betrieb/Heizen/Warmwasser/etc., als Verknüpfungen auf die eigentlichen Variablen (inklusive Bedienbarkeit — ein Link auf die Warmwasser-Solltemperatur bleibt z. B. ein Schieberegler).

Beides steht jetzt klarer im Formulartext.

2) DS18B20 / 1-Wire-Sensoren

Hier war kein Bedienfehler, sondern eine echte Lücke im Modul: HeishaMon sendet 1-Wire-Sensoren auf einem dynamischen Topic pro Sensor-Adresse (.../1wire/<Adresse>), nicht über die feste Themenliste, die das Modul bisher kannte. Deshalb ging es nur über den Umweg der manuellen MQTT-Client-Variable — und die zeigte sich als „veränderbar“, weil generisch angelegte MQTT-Variablen ohne weiteres Zutun keine reinen Anzeigewerte sind.

Das habe ich nachgerüstet: ab sofort erkennt das Modul 1-Wire-Sensoren automatisch, sobald der erste Messwert eintrifft, und legt sie in einem neuen Bereich „1-Wire-Sensoren (optional)“ an. Dort siehst Du die Bus-Adresse, kannst jedem Sensor einen sprechenden Namen geben (z. B. „Vorlauf Pufferspeicher“) und ihn wie die übrigen Datenpunkte aktivieren/deaktivieren. Aktivierte Sensoren erscheinen automatisch auch in der Verknüpfungsstruktur, falls Du die nutzt — landen also ganz von selbst im WebFront.

Update & Umstellung

Der Stand liegt auf dem beta-Branch, also einfach über die Modulverwaltung aktualisieren. Danach:

1. Deine manuell angelegte MQTT-Client-Variable für die beiden Sensoren kannst Du löschen (Archivdaten der alten Variable bleiben davon unberührt, laufen aber getrennt weiter).
2. Nach dem ersten neuen Messwert tauchen die Sensoren im Bereich „1-Wire-Sensoren“ auf — dort einfach benennen und übernehmen.

Falls noch was hakt, meld Dich gern wieder — genau solche Rückmeldungen bringen das Modul voran.

Viele Grüße
Bricoleur

[Wuwu]

Cool, vielen vielen Dank!!
Die 1-Wire Sensoren waren sofort da, klappt.
Die Linkstruktur brauche ich nicht in der Visualisierung, damit würde ich meinen Vater Überfordern. Da stelle ich nur ein paar wenige aber wichtige Schalter und Werte dar.
In dem Bild hier ganz oben sieht das so aus, als ob die Struktur im normalen Objektbaum ist. Aber vermutlich ist direkt über “HeishaMon” noch die Kategorie für die Visualisierung…

Viele Grüße,
Wuwu

[Wuwu]

zwei Punkte sind mir noch aufgefallen:

1. kannst Du die Steuerung der beiden Relais der großen HeishaMon Platine auch integrieren?

2. die SG Ready Signale tauchen in der Liste nicht auf, auch nach der Aktivierung im Service-Bereich und Neustart von Heizung/HeishaMon nicht. Hast Du eine Idee?

[Wuwu]

[Bricoleur]

Moin Wuwu,

wieder zwei gute Punkte — Nummer 1 habe ich direkt eingebaut, bei Nummer 2 steckt eine technische Überraschung dahinter.

1) Relais der großen Platine — ist jetzt drin

Ab v1.10.0 (gerade auf beta veröffentlicht) gibt es in der Instanz-Konfiguration den neuen Bereich „Zusätzliche Befehle“. Dort die Checkbox aktivieren, übernehmen — dann erscheinen Relais 1 und Relais 2 als Schaltvariablen. Ein Hinweis dazu: HeishaMon meldet den Relaiszustand nicht zurück (das sind reine Schreibbefehle der Firmware), die Anzeige zeigt also den zuletzt gesendeten Befehl, keine Rückmeldung von der Platine.

2) SG Ready — die erscheinen prinzipbedingt nie in der Liste

Das ist kein Fehler bei Dir und lässt sich auch durch keinen Neustart beheben: Die native „SG ready“-Funktion (Servicepunkt 16, wie in Deinem Screenshot) läuft über zwei physische Klemmenkontakte direkt am Gerät (Vcc-Bit1/Vcc-Bit2). Diese Kontaktzustände werden auf dem CN-CNT-Bus, den HeishaMon mitliest, schlicht nicht übertragen — die Wärmepumpe meldet sie nicht ins Protokoll. Deshalb kann weder HeishaMon noch mein Modul sie jemals anzeigen.

Aber es gibt einen digitalen Ersatzweg, und der ist ab v1.10.0 ebenfalls im Bereich „Zusätzliche Befehle“ eingebaut: der SmartGrid-Modus. Der bildet exakt dieselben vier Betriebsarten ab wie die SG-Ready-Tabelle in Deinem Screenshot (Normal / Wärmepumpe+Heizstab aus / Überhöhungsstufe 1 / Überhöhungsstufe 2) — nur als MQTT-Befehl statt über die Klemmkontakte. Wichtige Voraussetzung: In den Service-Einstellungen der Wärmepumpe muss „Optional PCB“ auf JA stehen (das ist ein anderer Menüpunkt als „16. SG ready“!). Ohne diese Einstellung ignoriert die Anlage den Befehl kommentarlos. Und auch hier gilt: reiner Schreibbefehl, die Anzeige spiegelt den zuletzt gesendeten Modus, keine Bestätigung der Anlage.

Praktisch heißt das: Wenn Du bei Deinen Eltern PV-Überschuss oder dynamische Tarife nutzen willst, kannst Du die Überhöhungsstufen jetzt direkt aus IP-Symcon heraus schalten — dafür brauchst Du die physischen SG-Ready-Klemmen gar nicht mehr.

Viele Grüße
Bricoleur

[Wuwu]

Moin Bricoleur,
Du bist echt klasse!

Relais funktionieren super und auch der SmartGrid Modus ist da.
Im IPS kann ich ja viel besser entscheiden, wann genug Strom vorhanden ist, als nur durch ein SG-Signal des Wechselrichters.

Vielen Vielen Dank!!

[Bricoleur]

Moin Wuwu,

freut mich riesig, dass beides bei Deinen Eltern läuft — und genau der Gedanke, den Du beschreibst, ist der Punkt: In IP-Symcon weißt Du viel mehr über Deine Anlage (PV-Ertrag, Speicherstand, Strompreis, Verbrauchsprognose) als ein Wechselrichter mit seinem einen SG-Kontakt je wissen kann. Der SmartGrid-Modus ist dafür bewusst nur der Stellhebel — die Intelligenz dahinter gehört nach IPS.

Kleiner Ausblick: Das HeishaMon-Modul ist Teil einer größeren Modulfamilie, an der ich gerade arbeite — da wird in absehbarer Zeit noch einiges dazukommen, gerade in Richtung „automatisch entscheiden, wann genug Strom da ist“, damit man solche Logiken nicht mehr selbst skripten muss. Mehr dazu, sobald es rund läuft.

Danke Dir fürs Testen und die klasse Rückmeldungen — die letzten drei Versionen gehen direkt auf Deine Funde zurück!

Viele Grüße
Bricoleur

[Wuwu]

immer gerne.
Ein Problem habe ich noch entdeckt.
Auf dem Desktop wird die SmartGrid Auswahl richtig dargestellt,
auf dem iPad kommt aber diese Fehlermeldung:

[Wuwu]

[Bricoleur]

Moin Wuwu,

guter Fund — und ein kniffliger: Die Kachel-Konfiguration enthielt einen falsch benannten Farb-Parameter, den Desktop und Web-Oberfläche stillschweigend verdauen, an dem sich die Mobile-App aber verschluckt. Deshalb der Unterschied zwischen Desktop und iPad. Betroffen waren neben dem SmartGrid-Modus potenziell alle Auswahl-Kacheln des Moduls.

Ist in v1.5.4 behoben (gerade auf beta) — einfach das Modul aktualisieren und danach einmal in der Instanz „Änderungen übernehmen“ klicken bzw. IPS das Update durchziehen lassen, dann werden auch die bestehenden Variablen automatisch auf die korrigierte Darstellung umgestellt. Danach sollte die SmartGrid-Auswahl auch auf dem iPad sauber erscheinen.

Danke Dir — Du hast damit nebenbei einen Fehler gefunden, der noch in ganz anderen Modulen schlummern dürfte.

Viele Grüße
Bricoleur

[Wuwu]

… wie nicht anders zu erwarten, nun klappt es.
Vielen vielen Dank!!

[Bricoleur]

Moin zusammen,

seit dem ersten Beitrag im Juni ist eine Menge passiert. Damit niemand die Änderungen einzeln zusammensuchen muss, hier die Übersicht. Aktueller Stand ist v1.30.0, das Update kommt wie gewohnt über die Modulverwaltung (Symcon Store, Kanal Beta). Getestet ist alles mit inzwischen über 300 automatisierten Tests.

Juli

• Die Lizenz ist auf PolyForm Noncommercial umgestellt: privat und nicht-kommerziell bleibt alles frei, gewerblich braucht eine eigene Lizenz. Ältere Versionen bis 1.2.0 bleiben MIT.
• Die Konfigurationsmaske folgt jetzt der einheitlichen Optik meiner Module: „Neu in Version" (pro Version bestätigbar), „Dokumentation & Hilfe" ganz oben und ein ausblendbarer Forum-Hinweis.
• Alle Texte sind durchgängig deutsch (Verknüpfung statt Link, Schaltfläche statt Button und so weiter).

August

• 1-Wire-Sensoren (z. B. DS18B20) werden automatisch erkannt, sobald der erste Messwert eintrifft, und lassen sich im Formular benennen. Anregung von Wuwu.
• Relais der großen Platine und SmartGrid-Modus als digitaler Ersatz für die SG-Ready-Klemmen, ebenfalls von Wuwu angeregt.
• Mobile-App-Absturz behoben (iPad/iPhone bei Auswahl-Variablen). Bestehende Variablen werden beim Update automatisch umgestellt.
• Automatische Archivierung der Monitoring-Datenpunkte, damit Zeitreihen-Kacheln ohne Handarbeit funktionieren.
• Energiespar-Prüfung: bewertet die Service-Einstellungen der Anlage und das echte Taktverhalten und gibt konkrete Sparhinweise. Reine Anzeige, es wird nichts verändert.
• Taktschutz per Knopfdruck: ein Schutz-Regelwerk gegen Verdichter-Takten wird direkt auf die HeishaMon-Platine gespielt und läuft dort auch weiter, wenn WLAN oder IP-Symcon ausfallen. Auf Wunsch auch für den Kühlbetrieb.
• Neustart-Watchdog: hängt MQTT länger als eingestellt, startet das Modul die Platine neu (optional, mit Schleifenschutz).
• Platinen-Diagnose (WLAN-Qualität, Laufzeit, MQTT-Neuverbindungen, Bus-Lesequalität, Firmware-Version) und S0-Zähler direkt an der Platine, brauchbar als Quelle für den gemessenen COP ganz ohne Zusatzaktor.
• Die Dokumentation im Formular ist deutlich ausgebaut.
• Für die Kacheln des NRG-Stack (Anlagenschema, Wärmepumpen-Monitor) meldet das Modul jetzt viel mehr: gemessener und geschätzter COP, Tages-Arbeitszahl, thermische Gesamtleistung, herstellerneutrale Betriebsart, Heizstab-Status, Pumpen, Ventile und Verdichterfrequenz.

September

• Hinweis im Formular, wenn zusätzlich WPHub (Panasonic Comfort Cloud) für dieselbe Anlage aktiv ist, damit beide Kanäle nicht gleichzeitig schreiben.
• Hat MeterHub schon einen Zähler mit der Funktion „Wärmepumpe", schlägt das Modul ihn beim externen Stromzähler automatisch vor (Übernahme per Klick).
• Neue Bereiche im Formular: „Wozu dieses Modul?" für die erste Einrichtung und „Über dieses Modul" mit Lizenzhinweis und freiwilligem Spendenlink. Der Forum-Hinweis führt jetzt direkt in diesen Thread.
• Die Hilfe-Schaltflächen zeigen die konkrete Frage, die sie beantworten, statt nur eines „?".
• Das Modul ist im Symcon Store gelistet (Kanal Beta). Der Stable-Kanal folgt zu gegebener Zeit.
• Unter der Haube habe ich Darstellungs-Parameter bereinigt, die Symcon bisher still ignoriert hat. Eine strengere Prüfung in einer der nächsten Symcon-Versionen hätte sonst Probleme machen können. Sichtbar ändert sich nichts.
• Heizkurven und Bedienung (v1.29.0 und v1.30.0): Für den Wärmepumpen-Monitor im NRGDashboard gibt es jetzt eine strukturierte Schnittstelle. Damit lassen sich die Heizkurven je Zone und Modus (Heizen/Kühlen) lesen und setzen, die Verschiebung der Heizanforderung, dazu Flüsterbetrieb, Leistungsbetrieb, Urlaub, Notbetrieb (Heizstab) und Warmwasser-Solltemperatur. Der Heizkurven-Reiter im Dashboard nutzt das bereits, die weiteren Bedienelemente folgen dort. Für Skripte stehen HEISHA_GetHeatingCurve, HEISHA_SetHeatingCurve, HEISHA_SetHeatingCurveShift, HEISHA_GetOperations und HEISHA_SetOperation zur Verfügung.

Zwei Dinge dazu, die ich ehrlich dazusagen möchte:

• Die Wärmepumpe bestätigt Befehle nicht. Ob etwas übernommen wurde, zeigt erst der Wert, den die Anlage danach zurückmeldet. Einen Urlaubszeitraum kennt HeishaMon nicht, es gibt nur an/aus.
• Wer den Taktschutz auf der Platine nutzt: Das Regelwerk arbeitet selbst mit der Verschiebung der Heizanforderung (0 und -5) und kann eine von Hand gesetzte Verschiebung überschreiben. Bei einer Verschiebung ungleich 0 greift der Taktschutz außerdem nicht.

Fehler, Wünsche und Anlagen-Erfahrungen gerne wie bisher hier im Thread. Vieles davon geht direkt auf Rückmeldungen von hier zurück.

Viele Grüße Bricoleur