Einrichtung

Was beim Hinzufügen abgefragt wird, was später unter Konfigurieren noch umstellbar ist, und was die einzelnen Schalter bewirken.

Zugang

Gebraucht werden die IP der Steuerung und der Zugang zu ihrer Weboberfläche. Es ist derselbe Zugang, mit dem man sich auch im Browser an der Anlage anmeldet — kein Konto bei Windhager, kein Portal.

Ob der Weg frei ist, zeigt ein Blick in den Browser: Unter http://<IP der Anlage> muss die Weboberfläche des InfoWIN Touch erscheinen. Kommt sie, stimmen IP und Zugang.

Welches Passwort

Ab Werk kennt die Steuerung zwei Zugänge:

An der geprüften Anlage sehen beide über die Schnittstelle dasselbe, auch die Fachparameter. Die Trennung in Bedienebenen gilt am Bediengerät; was in Home Assistant erscheint, entscheiden die Bedienebenen weiter unten. USER genügt also. Für andere Baureihen ist das nicht belegt, deshalb bleibt der Zugang wählbar — ein abweichender Benutzername lässt sich eintippen.

Passwort herausfinden

Wurde das Passwort einmal geändert, gilt das neue sofort auch für die Schnittstelle. Drei Wege, es wiederzufinden:

1. Am Gerät nachsehen. Am InfoWIN Touch unter Passwort. Dort steht es im Klartext und lässt sich auch neu setzen.
2. In der Weboberfläche der Anlage. http://<IP der Anlage> öffnen, anmelden, unter Passwort nachsehen. Führt zum selben Parameter wie der Weg über das Gerät.

3. Über Windhager Connect, falls die Anlage dort registriert ist. Anmelden, Anlage auswählen — die Adresse endet dann auf /management. Dieses Wort durch settings ersetzen:

   https://connect.windhager.com/systems/<Kennung der Anlage>/management
   https://connect.windhager.com/systems/<Kennung der Anlage>/settings
   

   Auf der Einstellungsseite steht das Webserver-Passwort im Klartext und lässt sich dort auch ändern.

Passwort ändern

Am InfoWIN Touch oder in dessen Weboberfläche unter Passwort — beide Wege führen zum selben Parameter. Ein dort gesetztes Passwort gilt sofort auch für die Schnittstelle. Danach muss es in Home Assistant über Neu anmelden nachgezogen werden, sonst meldet die Integration eine abgelehnte Anmeldung.

Nach dem Verbinden mit myComfort geht nichts mehr? Windhager vergibt dabei ein eigenes Passwort, die Werksangabe gilt dann nicht mehr. Kein dauerhafter Ausschluss: auf einem der drei Wege oben ablesen oder neu setzen, danach laufen App und HeatNexus wieder.

Ein Konfigurationseintrag kann mehrere Anlagen führen — bis zu sechs. Jede bekommt eine eigene Bezeichnung, etwa Heizhaus und Wohnhaus. Diese Bezeichnung erscheint überall dort, wo sonst zweimal dasselbe stünde: Zwei Steuerungen melden beide ein B-PLMi PUFFER, und ohne Bezeichnung wäre nicht zu erkennen, welcher gemeint ist.

Bedienebenen

Die Steuerung ordnet jeden Datenpunkt einer Ebene zu — dieselben Ebenen, die auch das InfoWIN Touch kennt. Die Auswahl entscheidet, was HeatNexus überhaupt anlegt.

Die Serviceebene ist ein Sonderfall: Sie wird mitgelesen, ihre Entitäten entstehen aber deaktiviert. Sie tauchen in der Geräteübersicht auf, kosten aber keinen einzigen Abruf, solange niemand sie einschaltet. Erst beim Aktivieren meldet sich die Entität beim Abfragezyklus an.

Zwei Haken steuern diesen Sonderfall:

• Fortgeschrittene Werte aktivieren legt Service- und Werksebene sofort aktiv an, statt deaktiviert.
• Fortgeschrittene Werte bedienbar machen erlaubt das Schreiben auf diesen Ebenen. Ohne den Haken bleiben sie lesbar, aber unveränderlich.

Eine abgewählte Ebene wird gelöscht, nicht deaktiviert. Wer die Werksebene wieder abwählt, hat sich entschieden — die Einträge verschwinden aus der Registrierung, statt als deaktivierte Zeilen liegen zu bleiben. Anders liegt der Fall, wenn die Anlage einen Datenpunkt nicht mehr liefert: Dann wird die Entität nur deaktiviert, damit Name, Bereich und Verlauf erhalten bleiben.

Abfrageintervall

Einstellbar zwischen 30 und 300 Sekunden, Vorgabe 30. Der Wert ist die Untergrenze, kein Multiplikator: Nicht jeder Datenpunkt wird in jedem Takt gelesen.

Welcher Klasse ein Wert zufällt, entscheidet die Art des Werts: Plattform, Name, Zustandsklasse und Einheit. Die Bedienebene spielt dabei keine Rolle. Betriebsstunden ändern sich nicht in dreißig Sekunden, egal wo sie stehen.

Ein kürzeres Intervall bringt deshalb wenig und kostet: Die Steuerung beantwortet Anfragen nacheinander, mehr Gleichzeitigkeit verkürzt einen Durchlauf nicht.

Was zusätzlich angelegt wird

Darstellung

• Sprache der Bezeichnungen, die die Steuerung selbst führt. Automatisch folgt Home Assistant; Deutsch, Englisch, Französisch und Italienisch lassen sich erzwingen.
• Außentemperatur — welche Entität in der Kopfzeile der eigenen Oberfläche gilt. Leer heißt: HeatNexus sucht sie sich in der Anlage. Nötig, weil der Außenfühler oft an einem anderen Gerät hängt als an dem, das ihn meldet.
• Kesselart wirkt nur auf die Zeichnung im Schaubild. Automatisch leitet sie aus Brennstoff und Funktionsnamen ab; die Auswahl ist dafür da, dass eine falsch erkannte Anlage trotzdem richtig aussieht.
• Zweiter Kesselwert im Schaubild: Kesselleistung oder Brennkammertemperatur.

Eco und Comfort

Beides ist dieselbe befristete Übersteuerung, die auch das Bediengerät schreibt. Die Anlage kennt nur einen Übersteuerungswert; ob er Eco oder Comfort heißt, entscheidet sie daran, ob er unter oder über dem Sollwert des Zeitprogramms liegt. Einstellbar sind je eine Temperatur und eine Dauer — Vorgabe 10 °C und 22 °C, jeweils 180 Minuten.

Wenn sich die Anlage ändert

Der Erkennungsstand wird gespeichert und in dieser Reihenfolge wiederverwendet: Arbeitsspeicher, dann Platte, dann vollständige Neuerkennung. Verworfen wird er bei geändertem Umfang, bei einem Alter über 30 Tagen oder durch den Dienst heatnexus.rediscover.

Nach einer Aktualisierung ist nichts zu tun. Eine neue Fassung verwirft den Stand bewusst nicht — das kostete jedes Mal einen vollen Neuabzug. Stattdessen wird der gespeicherte Stand sofort hergestellt und im Hintergrund abgeglichen; neue Entitäten melden sich, sobald sie da sind.

heatnexus.rediscover braucht es nur nach einem Umbau an der Heizung — ein neuer Heizkreis, ein neues Modul. Der Dienst meldet danach je Anlage zurück, was gefunden wurde.

Fehlersuche

Die Fälle, die in den Diskussionen immer wieder auftauchen — nach Symptom sortiert.

Die Einrichtung schlägt fehl

„Anmeldung abgelehnt” — gefragt ist der Zugang der Weboberfläche der Anlage, nicht der eines Portals. Ab Werk sind das USER und Service, beide mit dem Passwort 123. Wurde es einmal geändert, gilt das neue sofort auch hier — dann in Home Assistant über Neu anmelden nachziehen.

Wie man ein unbekanntes Passwort wiederfindet — am Gerät, in der Weboberfläche oder über Windhager Connect — steht mit allen Schritten unter Passwort herausfinden.

„Verbindung nicht möglich” — vorher im Browser prüfen: Unter http://192.0.2.10 (die IP der eigenen Anlage) muss die Weboberfläche des InfoWIN Touch erscheinen. Kommt dort nichts, liegt es nicht an HeatNexus. Häufigste Ursachen: Die Steuerung hängt in einem anderen Netzsegment, oder das Netzwerkmodul ist nicht freigeschaltet.

„Einrichtung noch nicht bereit” — der erste Durchlauf liest Struktur und Kernwerte und darf dafür bis zu zwei Minuten brauchen. Bricht er ab, versucht Home Assistant es von selbst erneut. Bleibt es dabei, antwortet die Steuerung zu langsam — meist, weil parallel noch etwas anderes auf sie zugreift.

Es fehlen Entitäten

Erst die deaktivierten einblenden. Die Serviceebene wird gelesen, ihre Entitäten entstehen aber deaktiviert. In der Geräteansicht steht dafür ein Filter Deaktivierte Entitäten anzeigen. Wer sie dauerhaft aktiv haben will, setzt in den Optionen den Haken Fortgeschrittene Werte aktivieren.

Dann die Bedienebenen prüfen. Die Werksebene ist ab Werk aus. Was in keiner Ebene der mitgelieferten Datenbank steht, gilt als Werksebene und erscheint nur mit dieser Auswahl.

Nach einem Umbau an der Heizung — neuer Heizkreis, neues Modul — den Dienst heatnexus.rediscover aufrufen. Er verwirft den gespeicherten Stand und liest alles neu.

Nach einer Aktualisierung ist nichts zu tun. Der gespeicherte Stand wird sofort hergestellt und im Hintergrund abgeglichen. Neue Entitäten melden sich von selbst.

Entitäten ohne Datenpunkt

Liefert die Anlage einen Wert nicht mehr, werden die betroffenen Entitäten abgeschaltet und bleiben stehen. Name, Symbol, Bereich und Verlauf bleiben damit erhalten. Kommt der Wert zurück, sind sie sofort wieder da.

Sollen sie ganz verschwinden, steht unter Einstellungen → System → Reparaturen ein Eintrag mit ihrer Anzahl. Auf Bestätigung löscht er sie samt Verlauf.

Eine abgewählte Bedienebene ist etwas anderes: Das ist eine Entscheidung, ihre Entitäten werden gleich entfernt und beim Wiederdazuwählen neu angelegt.

Ein Wert bleibt leer

Antwortet die Steuerung auf einen Datenpunkt mit 404 oder mit 409 und „invalid Identifier”, gibt es ihn auf dieser Anlage nicht — die Entität wird gar nicht erst angelegt. Das ist kein Fehler, sondern die Antwort der Anlage.

Bleibt eine vorhandene Entität leer, steht dort None und nicht 0. Das ist Absicht: Eine fehlende Messung ist keine Null. Wer in einer Automation darauf prüft, prüft auf unavailable oder unknown, nicht auf den Zahlenwert.

Schreibbare Datenpunkte, die sich nicht lesen lassen, bleiben trotzdem bedienbar. Sie zeigen keinen Zustand an, nehmen aber Befehle an.

Etwas lässt sich nicht verstellen

Der Datenpunkt ist schreibgeschützt. Meldet die Steuerung writeProt, legt HeatNexus statt des Bedienelements den lesenden Zwilling an. Das ist eine Auskunft der Anlage, keine Entscheidung der Integration.

Die Ebene ist nicht freigegeben. Service- und Werksebene sind ohne den Haken Fortgeschrittene Werte bedienbar machen nur lesbar.

Der Heizkreis ist aus. Eine Solltemperatur lässt sich in den Betriebsarten Standby und WW-Betrieb nicht setzen. Die Anlage würde dabei nur einen Timer stellen, ohne zu heizen — deshalb wird der Schreibversuch abgelehnt statt still verschluckt.

Die Änderung springt zurück. Geschriebene Werte werden sofort angezeigt und erst durch den nächsten Abruf bestätigt. Nimmt die Anlage den Wert nicht an, fällt die Anzeige nach kurzer Zeit auf den echten Stand zurück.

Dashboard oder Oberfläche fehlen

Beide sind Schalter in den Optionen. Das mitgelieferte Dashboard wird bei jedem Öffnen neu gebaut und lässt sich deshalb nicht bearbeiten. Wer ein eigenes will, ruft den Dienst heatnexus.dashboard_ausgeben auf, legt ein neues Dashboard an und fügt den Text im Rohkonfigurations-Editor ein.

Meldungen stehen noch da

Die Störungsanzeige wird gelesen, nicht quittiert. Verschwindet die Meldung an der Anlage, verschwindet auch die Anzeige. Der Dienst heatnexus.meldungen_loeschen leert nur die von HeatNexus geführte Liste in Home Assistant — der Störspeicher am Bediengerät bleibt unberührt und wird wie gewohnt dort zurückgesetzt.

Etwas melden

Zum Melden gehören zwei Dinge:

1. Der Diagnose-Export. In der Geräteansicht der Integration unter den drei Punkten → Diagnose herunterladen. Darin steht, was HeatNexus gefunden hat, ohne Passwort.
2. Was die Anlage ist — Baureihe des Kessels und welche Module dranhängen.

Beides in ein Issue oder in die Diskussionen.

Für Anlagen, die noch nicht abgedeckt sind, gibt es ein Sondenwerkzeug. Es ist eine einzelne Python-Datei, braucht nichts außer der Standardbibliothek, verändert nichts an der Anlage und läuft im Betrieb nicht mit:

python tools/heatnexus_probe.py all 192.0.2.10

Ohne Argument startet es geführt. Die Ergebnisse landen als JSON, CSV und Bericht im Ordner probe/.

Die Oberfläche

HeatNexus bringt eine eigene Seite in der Seitenleiste von Home Assistant mit. Hier steht, was darauf zu sehen ist — damit man es beurteilen kann, ohne die Integration erst installieren zu müssen.

Alle Werte im Bild sind erfunden, der Aufbau ist echt: Aufgenommen wird die ausgelieferte Oberfläche selbst.

Was der Rundgang zeigt

Übersicht. Oben die Heizungsübersicht: je Anlagenteil ein Leitwert, so wie das Bediengerät der Anlage ihn zeigt — am Kessel die Kesseltemperatur, am Puffer die obere, am Heizkreis die Raumtemperatur. Darunter das Anlagenschaubild, dann der Systemstatus mit Betriebszustand, Außentemperatur, Kesselleistung, Brennstoff, Vorratsbehälter und den Restlaufzeiten.

Schaubild in Bewegung. Die Pumpen drehen sich, solange sie fördern, und die Bänder auf Vor- und Rücklauf zeigen die Richtung. Im Rundgang läuft neben Kessel, Puffer und Heizkreis auch die Zirkulation — an den senkrechten Stichleitungen sieht man, wohin die Wärme gerade geht.

Störung. Liegt eine Meldung an, wechselt der Balken oben von „Anlage in Ordnung” auf „Störung anliegend”, und die Störungskarte nennt den Klartext des Herstellers samt Abhilfe. Verschwindet die Meldung an der Anlage, verschwindet auch die Anzeige — sie wird nicht quittiert, sondern gelesen.

Steuerung. Was man an der Anlage wirklich verstellt: Sollwert des Heizkreises, Eco und Comfort als befristete Übersteuerung, die Betriebswahl, Warmwasser mit Sollwert und Einmalladung, dazu die Tasten am Kessel. Wo ein Fehlgriff Arbeit macht oder Brennstoff kostet, kommt vorher eine Rückfrage.

Im Bild läuft dabei beides mit: Am Heizkreis steht „Vorgabe noch bis 10:09” samt „abbrechen” — ein von Hand verschobener Sollwert überstimmt das Zeitprogramm nur auf Zeit. Und die Warmwasserkarte zeigt eine laufende Einmalladung: Die Betriebsart meldet „Warmwasser Einmalladung”, die Taste heißt so lange „Warmwasser laden abbrechen”. Erkannt wird das an der Betriebsart, nicht am Auslöser — der fällt zurück, sobald die Anlage den Auftrag angenommen hat.

Wartung. Restlaufzeiten bis Ascheentleerung, Hauptreinigung und Wartung, der Brennstoff, die Zählerstände.

Zeitprogramme. Je Programm ein Wochenraster: Blöcke wie „Mo–Fr” und „Sa, So”, darin die Schaltzeiten als Balken, darunter als Text. Bearbeitet wird in Blöcken und gespeichert als ganzes Programm — so, wie die Anlage es führt.

Der Reiter Verlauf fehlt im Rundgang. Er benutzt die Verlaufskarte von Home Assistant, und die zeichnet nur mit einer laufenden Anlage dahinter. Eine leere Karte im Bild würde also etwas Falsches zeigen.

Wie das Bild entsteht

Es ist kein Nachbau. Aufgenommen wird frontend/heatnexus-panel.js selbst, mit frontend/stil.js, in einem kopflosen Browser:

• Die Aufteilung rechnet panel.panel_daten über eine Beispielanlage (tools/beispielanlage.py) — dieselbe, aus der auch das Anlagenschaubild im README entsteht.
• Die Zustandstabelle von Home Assistant wird nachgebildet. Je Auftritt lassen sich einzelne Zustände überschreiben; so entsteht die Störung.
• Die Oberfläche hängt an genau einem fremden Element, ha-icon. Es wird mit den Symbolpfaden bedient, die das installierte Home-Assistant-Frontend mitbringt — die Symbole sind also die echten, nicht nachgezeichnet.

python tools/build_panel_rundgang.py

Damit kann das Bild nicht veralten wie ein von Hand gemachter Bildschirmabzug: Ändert sich die Oberfläche, ändert sie sich beim nächsten Lauf mit.

Erfundene Werte, echte Struktur. Kein Datenpunkt im Bild stammt von einer Anlage; Namen und Adressen sind die der Geräte-Datenbank, die Zahlen sind gewählt.

Anlagenschaubild als Karte

Das Anlagenschaubild gibt es nicht nur in der mitgelieferten Oberfläche, sondern auch als Lovelace-Karte. Damit lässt es sich in ein selbst gebautes Dashboard hängen – mit Werten, laufenden Pumpen und Glutbett wie in der Oberfläche.

Einrichten

Die Karte steht ohne Zutun bereit, sobald HeatNexus eingerichtet ist. Kein Eintrag unter Einstellungen → Dashboards → Ressourcen nötig.

Dashboard bearbeiten → Karte hinzufügen → nach „HeatNexus” suchen.

Oder in YAML:

type: custom:heatnexus-schaubild

Einstellungen

auto folgt dem Erscheinungsbild von Home Assistant. Die Schrift der Marken wächst mit der Kartenbreite; schrift verschiebt das Maß nach oben oder unten.

Ein Farbsatz färbt Gehäuse, Rahmen und Schrift. Vor- und Rücklauf bleiben in jedem Satz rot und blau — das ist eine Auskunft, keine Gestaltung.

Alles davon lässt sich im Karteneditor einstellen, YAML ist nicht nötig.

Beispiel mit zwei Anlagen nebeneinander:

type: horizontal-stack
cards:
  - type: custom:heatnexus-schaubild
    anlage: Heizhaus
    farbsatz: petrol
  - type: custom:heatnexus-schaubild
    anlage: Wohnhaus
    farbsatz: petrol

Eigene Zeichnungen

Welche Zeichnung ein Anlagenteil bekommt, entscheidet die Erkennung — Hackgut, Pellets, Scheitholz, Gas/Öl, Wärmepumpe. Wer eine andere will, wählt sie im Editor unter Werte im Schaubild → Zeichnungen; Warmwasser und Zirkulation stehen dort ebenfalls.

zeichnungen:
  PuroWIN: kessel-pellets
  UML Heizkreis-zirkulation: modul

Die Werteliste

Neben dem Bild steht eine Liste, die frei zusammengestellt wird — Werte der Anlage und beliebige andere Entitäten nebeneinander. Im Karteneditor führt ein Klick auf eine Zeile zu ihren Einzelheiten: Name, Symbol, Aufbau und wo das Anlagenteil steht.

Je Eintrag lässt sich das überschreiben, dazu kommen name, beschriftung (das Anlagenteil), symbol, farbe, einheit und klick. Ein Eintrag ist entweder die Entität allein oder ein Satz eigener Angaben:

type: custom:heatnexus-schaubild
zeilen:
  aufbau: name_links
  teil: unter_wert
zusatzwerte:
  - sensor.purowin_kesseltemperatur
  - entity: sensor.heizkreis_vorlauftemperatur
    name: Vorlauf oben
    symbol: mdi:radiator
    teil: aus
  - entity: sensor.pv_ertrag_heute
    name: PV heute
    beschriftung: Heizhaus
    symbol: mdi:solar-power
    einheit: false

Das Symbol kommt ohne Angabe von HeatNexus: Flamme am Kessel, Heizkörper am Vorlauf, Tank am Puffer. Fremde Entitäten behalten ihr eigenes.

Was die Karte zeigt

Dieselbe Zeichnung wie die Oberfläche: Kessel, Puffer, Heizkreise, Warmwasser und Zirkulation in der Reihenfolge des Wärmeflusses, dazu die Messwerte an ihren Kästen. Ein Klick auf einen Wert öffnet die Detailansicht der Entität.

Die Zeichnung entsteht aus dem, was die Anlage meldet – es gibt kein festes Bild und keine Rollenliste, in die eine Anlage passen müsste. Was fehlt, erscheint nicht.

Farben

Der Server schickt die Zeichnung einmal und dazu je Farbsatz eine Tabelle; umgefärbt wird im Browser. Ein weiterer Farbsatz kostet dadurch nichts – und das Umschalten des Erscheinungsbildes wirkt sofort, ohne dass etwas nachgeladen wird.

Wenn nichts erscheint

• „Custom element doesn’t exist: heatnexus-schaubild” – Home Assistant hat das Modul noch nicht geladen. Einmal die Seite neu laden. Bleibt es dabei, hilft ein Neustart von Home Assistant.
• „Noch keine Anlage eingelesen.” – Die Erkennung läuft noch. Nach dem ersten Einlesen steht das Bild von selbst da.
• „Diese Anlage gibt es nicht mehr.” – Der Wert unter anlage passt zu keiner vorhandenen Anlage. Ohne Angabe nimmt die Karte die erste.

Nach einer Aktualisierung von HeatNexus zeigt eine bereits offene Seite weiterhin die alte Fassung der Karte: Ein Browser nimmt einen Kartentyp je Seitensitzung nur einmal an, und der Typ heißt in jeder Fassung gleich – er steht so in den Dashboards der Nutzer. Ein Neuladen mit Strg+Umschalt+R (macOS: Cmd+Umschalt+R) holt die neue.

Regelung

Warum wird der Kessel auf 76 °C geheizt, wenn für den Puffer 60 °C eingestellt sind? Warum bleibt die Pufferladung aus, obwohl unten nur 40 °C gemessen werden?

Die Anlage zeigt viele Temperaturen, aber nicht, wie sie zusammenhängen. Dahinter stehen wenige Rechenregeln. Dieser Abschnitt erklärt sie und zeigt, welche Einstellung was bewirkt.

Alle genannten Zahlen sind Werkseinstellungen. Was an einer Anlage wirklich eingestellt ist, führt HeatNexus als Entität; die Adresse steht jeweils dabei.

Der Sollwert wird aus dem Bedarf berechnet

Für den Pufferspeicher ist keine feste Temperatur eingestellt. Die Regelung berechnet seinen Sollwert aus dem, was gerade gebraucht wird — meist aus dem Warmwasserkreis oder einem Heizkreis. Auf diesen Bedarf kommen zwei Aufschläge:

Warmwasser-Sollwert                50 °C
+ WW-Überhöhung        16/5/1     +10 K
= Puffer-Sollwert      16/1/15     60 °C

+ Hysterese            16/9/35     +16 K
= Kessel-Sollwert      14/1/7      76 °C

Der erste Aufschlag hält den Puffer wärmer als das Warmwasser. Ohne ihn ließe sich der Boiler nicht aufheizen. Der zweite hebt die Kesseltemperatur darüber hinaus an, damit nicht bei jeder kleinen Abweichung nachgeheizt werden muss.

Ohne Bedarf beträgt der Puffer-Sollwert 0. Dann findet keine Ladung statt, unabhängig von der Speichertemperatur. Das ist der häufigste Grund für die Frage, warum die Anlage nicht anspringt.

Wann geladen wird

Die Ladung beginnt nicht beim Sollwert, sondern eine halbe Hysterese darunter:

Puffer-Sollwert  60 °C
− Hysterese/2    − 8 K
= Einschaltpunkt 52 °C   am oberen Fühler (TPE)

Sinkt der obere Fühler unter diesen Wert, wird Wärme angefordert. Der untere Fühler (TPA) hat auf den Beginn der Ladung keinen Einfluss.

HeatNexus legt beide Größen als eigene Werte an: Einschaltpunkt ist die Temperatur aus der Rechnung oben, Einschaltpunkt Delta der Abstand des Fühlers dahin in Kelvin. Das Delta ist der Wert, auf den sich eine Automation setzen lässt: „in zwei Kelvin fordert die Anlage an”.

Wann die Ladung endet

Sobald der Bedarf gedeckt ist. Nicht, wenn der Puffer voll ist.

Erreicht das Warmwasser seine Solltemperatur, sinkt der Puffer-Sollwert auf 0 und die Ladung endet. Im unteren Speicherbereich kann es dann noch kalt sein.

Für die Nutzung als Wärmevorrat ist das der entscheidende Punkt: Im Automatikbetrieb wird der Puffer nie durchgeladen. Maßgeblich ist der Bedarf des Augenblicks, ein Vorratsziel gibt es nicht.

Wann der Brenner startet

Der Brenner startet, sobald die Kesseltemperatur unter den Sollwert minus Hysterese sinkt:

Kessel-Sollwert            76 °C
+ Hysterese Brenner EIN    − 5 K     Adresse 9/21, negativ angegeben
= Brenner startet bei      71 °C

Zwei Werte begrenzen das Ergebnis nach oben:

12/39 ist eine harte Obergrenze. Liegt sie unter dem berechneten Sollwert, wird gekappt. Eine höhere Überhöhung oder Hysterese bleibt dann wirkungslos.

Was welche Einstellung bewirkt

Die Betriebswahl entscheidet über alles

Am Pufferspeicher steht eine Auswahl, die leicht übersehen wird:

Bei 1 bleibt das Zeitprogramm des Puffers ohne Wirkung. Einstellen lässt es sich, ausgewertet wird es nicht. Erst bei 4 bestimmt es den Sollwert, und zwar unabhängig vom aktuellen Bedarf.

Anwendungsfälle

Puffer gezielt durchladen

Zum Beispiel abends, wenn für den nächsten Tag wenig Sonne gemeldet ist und von der Solaranlage kein Beitrag zu erwarten ist.

1. Betriebswahl 16/20/15 auf 4 — Auto mit Zeitprogramm setzen
2. Im Zeitprogramm des Puffers die gewünschte Temperatur eintragen, über den Dienst heatnexus.set_time_program
3. Am nächsten Morgen zurück auf 1 — Automatikbetrieb

Damit richtet sich die Ladung nach dem Plan statt nach dem Bedarf. Für eine Automation, die eine Solarprognose auswertet und die Betriebswahl umstellt, genügt ein einziger Schreibvorgang.

Anforderung unterbinden

Betriebswahl auf 0 — Standby setzen. Danach wird keine Wärme mehr angefordert.

Damit entfällt allerdings auch die Notversorgung. Um lediglich die Ladung zu begrenzen, eignen sich die WW-Überhöhung oder die Maximaltemperatur besser.

Warmwasser wärmer, ohne den Puffer stärker zu heizen

Getrennt geht das nicht. Der Puffer-Sollwert wird aus dem Warmwasser-Bedarf berechnet und steigt bei gleichbleibender Überhöhung mit. Für einen wärmeren Boiler bei gleicher Puffertemperatur muss die Überhöhung im selben Zug gesenkt werden.

Wärme von Hand anfordern

Einen Datenpunkt „jetzt anfordern” gibt es nicht. Ein Eingriff läuft über die Bedingungen, unter denen die Regelung selbst anfordert:

Zwei Anlagen im Verbund

Steht der Kessel im Nebengebäude und versorgt beide Häuser, arbeiten zwei Regelkreise zusammen. Die Verständigung läuft über ein Pumpen- und Relaismodul, bei Windhager ZSP genannt.

Auf der anfordernden Seite schaltet der Brenner-Ausgang 16/1/100, sobald die Puffertemperatur unter die Schaltschwelle sinkt. Das ist ein Relais und kein Messwert; in HeatNexus erscheint es als Ja/Nein-Sensor.

Auf der liefernden Seite nimmt das ZSP die Anforderung an. Die Kesseltemperatur wird daraus mit der vollen Hysterese berechnet:

Solltemperatur ext. Wärmeanforderung   16/9/57    60 °C
+ Hysterese                            16/9/35   +16 K
= Analog-Sollwert am ZSP               20/0/95    76 °C

Beide Seiten rechnen also unterschiedlich. Auf der anfordernden Seite beginnt die Ladung bei Sollwert minus halber Hysterese, auf der liefernden gilt Sollwert plus voller Hysterese.

Dazwischen liegt eine dritte Stufe, die leicht übersehen wird: Die Anforderung wird zuerst aus dem Vorrat des liefernden Puffers gedeckt. Erst wenn dessen oberer Fühler unter Sollwert minus halbe Hysterese sinkt, wird der Kessel angefordert.

Die vollständige Kette hat damit vier Stufen:

Verbraucher meldet Bedarf
  → anfordernder Puffer schaltet seinen Brenner-Ausgang
    → ZSP überträgt den Sollwert
      → liefernder Puffer fordert den Kessel an
        → Brenner startet

Das Pumpen- und Relaismodul

Ein ZSP ist ein Schaltgerät ohne feste Aufgabe. Vier Ja/Nein-Schalter legen fest, was es tut, und sie schließen einander nicht aus:

HeatNexus wertet diese Schalter aus. Steht 29/1 auf Nein, erscheinen Pumpendrehzahl und Kesseltemperatur des Moduls gar nicht erst. Diese Abhängigkeit steht in den Herstellerunterlagen und wird beim Einlesen ausgewertet. Was an einer Anlage keine Aufgabe hat, wird also auch nicht als Entität angelegt.

Drei Sollwerte für drei Anforderungsarten

Steht 29/2 auf Ja, führt das Modul drei Sollwerte nebeneinander:

Welcher davon gilt, hängt an der Verdrahtung; das Modul hat getrennte Eingänge für Heizung und Warmwasser. Im Betrieb zeigt 0/95 den gerade angeforderten Wert und ist damit der zuverlässigste Anzeiger für eine anliegende Anforderung.

Der Pumpenausgang

Bei aktivem 29/1 gibt das Modul eine Drehzahl aus. Eine eigene Regelgröße liegt dabei nicht vor, deshalb läuft die Pumpe mit der eingestellten Mindestdrehzahl 20/14. Sie schaltet mit der Anforderung ein und aus, ohne zu modulieren.

Zusätzlich führt das Modul einen eigenen Fühler 0/7. Er sitzt an der Übergabestelle und steigt, sobald gefördert wird.

Vorlagen und Dienste

HeatNexus liefert sechs Automations-Vorlagen und sechs Dienste mit. Die Vorlagen landen bei der Einrichtung unter blueprints/automation/heatnexus/ und werden mit jeder neuen Fassung aufgefrischt; welche mitkommen, steht in den Optionen.

Automations-Vorlagen

Störung melden

Meldet sich, sobald die Anlage eine Störung anzeigt, wiederholt die Meldung auf Wunsch und meldet die Entwarnung.

Ausgewertet wird der Sensor Störung gemeldet, nicht der angezeigte Text. Damit hängt die Automation nicht an einer Formulierung und läuft auch bei mehreren gleichzeitigen Meldungen richtig. Jeder Anlagenteil hat einen eigenen Sensor dieser Art; für den Kessel genügt meist einer.

In der Aktion stehen stoerungstext, anzahl und anlagenteil bereit.

Wartungswarnung mit Erinnerung

Dreistufige Warnung für eine Restlaufzeit: Vorwarnung bei der ersten Schwelle, Warnung bei der zweiten, danach Erinnerung in festem Abstand. Erledigt ist die Sache, sobald die Restlaufzeit wieder über der Rückstellschwelle liegt — den Zähler setzt die Anlage nach der Arbeit selbst zurück.

Je Zähler eine Automation. Am PuroWIN sind das Laufzeit bis Ascheentleerung, Laufzeit bis Hauptreinigung und Laufzeit bis Wartung. Helfer werden keine gebraucht, den Zustand hält die Automation selbst.

Brennstoffvorrat niedrig

Meldet sich, wenn der Vorratsbehälter leer ist, und erinnert daran, solange sich nichts ändert.

Ausgewertet wird der Sensor Vorratsbehälter Status. Er ist keine Füllstandszahl, sondern eine Zustandsmeldung — am PuroWIN voll, teilgefüllt, leer und Fehler Vorratsbehälter. Welche davon eine Meldung wert sind, wird als Text eingetragen, genau so, wie der Sensor sie anzeigt.

Heizkreis bei Abwesenheit absenken

Senkt einen Heizkreis ab, sobald niemand mehr zu Hause ist, und stellt bei der Rückkehr den vorherigen Betrieb wieder her. Die Betriebsart wird vor dem Absenken gemerkt. Zur Auswahl stehen Absenkbetrieb, Standby und Heizbetrieb.

Betriebsdauer erfassen

Zählt, wie lange die Anlage tatsächlich gelaufen ist — anhand der Betriebsart und der Zustände, die als Ruhe gelten.

Legionellenschutz nachbilden

Führt den Warmwasserspeicher in festem Turnus auf eine erhöhte Temperatur, indem die Einmalladung dafür benutzt wird. Gedacht für Anlagen, deren Regler die eingebaute Funktion nicht führt — dort gibt es keinen Datenpunkt, den man einschalten könnte. Nach dem Lauf wird alles zurückgestellt: Ladung aus, Ladetemperatur zurück, Betriebswahl zurück.

Verbrühungsgefahr. Wasser mit 60 °C verbrüht die Haut in wenigen Sekunden. Diese Vorlage nur einsetzen, wenn hinter dem Speicher eine thermostatische Verbrühschutz-Armatur sitzt und die Zapftemperatur begrenzt. Nachtstunden als Vorgabe sind kein Ersatz dafür.

Kein zertifizierter Legionellenschutz. Die Vorlage ahmt nach, was der Regler sonst selbst täte. Sie prüft nicht, ob jede Leitung die Temperatur erreicht, und ersetzt keine Anlage nach DVGW W 551.

Dienste

Befristete Vorgabe

Temperatur zwischen 10 und 30 °C, Dauer bis 400 Minuten. 0 beendet eine laufende Vorgabe sofort. Danach stellt die Anlage von selbst auf die Betriebswahl zurück, die Zeitprogramme bleiben unverändert. Steht der Kreis auf Standby oder WW-Betrieb, wird für die Dauer in ein Heizprogramm geschaltet und anschließend zurückgesprungen.

action: heatnexus.set_vorgabe
target:
  entity_id: climate.heizkreis_erdgeschoss
data:
  temperature: 21.5
  duration: 180

Behaglichkeitskorrektur

Für Fühler, die dauerhaft zu warm oder zu kalt messen, weil sie ungünstig hängen. Der Betrag liegt zwischen −3 und +3 K und wird auf die gemessene Raumtemperatur aufgeschlagen.

Zeitprogramm setzen

Zwei Wege. Vereinfacht über switch_points — mit weekdays, sonst gilt es täglich:

action: heatnexus.set_time_program
target:
  entity_id: sensor.heizkreis_erdgeschoss_zeitprogramm
data:
  weekdays: ["Mo", "Di", "Mi", "Do", "Fr"]
  switch_points:
    - { time: "06:00", value: 21 }
    - { time: "22:00", value: 18 }

Oder über blocks mit voller Kontrolle über mehrere Wochentag-Gruppen:

action: heatnexus.set_time_program
target:
  entity_id: sensor.heizkreis_erdgeschoss_zeitprogramm
data:
  blocks:
    - weekdays: ["Mo", "Di", "Mi", "Do", "Fr"]
      switch_points:
        - { time: "06:00", value: 21 }
        - { time: "22:00", value: 18 }
    - weekdays: ["Sa", "So"]
      switch_points:
        - { time: "07:00", value: 21 }
        - { time: "23:00", value: 18 }

blocks überschreibt switch_points und weekdays, wenn beides angegeben ist. Geschrieben wird nur der Inhalt: HeatNexus liest das Objekt vorher, tauscht den Wert aus und lässt die Hülle der Anlage unangetastet.

Dashboard ausgeben

Das mitgelieferte Dashboard wird bei jedem Öffnen neu gebaut und ist deshalb nicht bearbeitbar. Der Dienst gibt es als YAML zurück — damit lässt sich ein eigenes Dashboard anlegen: neues Dashboard erstellen, Rohkonfigurations-Editor öffnen, Text einfügen. Ab da gehört es dir und ändert sich nicht mehr mit.

Datenpunkte

Erzeugt aus device_db.json – nicht von Hand ändern. Neu erzeugen mit python tools/build_datenpunkte_doku.py.

Die Integration erkennt Datenpunkte auf zwei Wegen: über kuratierte Tabellen in const.py (fester Name, Einheit, Kategorie, Symbol) und über diese Geräte-Datenbank, die die Bedienebenen je Funktionstyp beschreibt. Welche davon tatsächlich angelegt werden, entscheidet die Anlage: Nicht vorhandene werden entfernt, schreibgeschützte nur lesend angelegt.

Eine OID ist <gn>/<mn>; die vollständige Adresse lautet /1/<nodeId>/<fctId>/<gn>/<mn>/0. Siehe Geräteschnittstelle.

Funktionstypen

Die Anlage meldet je Funktion nur eine Zahl. Was sie bedeutet, ist aus der Parameterliste des Herstellers abgeleitet – welche Datenpunkte ein Typ führt, sagt, was er ist. Nicht aus dem Namen raten, den ein Installateur vergeben hat.

fctType -1 sind die internen Netzwerkvariablen (NV's); sie tragen keine Datenpunkte und werden übersprungen.

Bedienebenen

• Info – Messwerte und Zustände, immer aktiv.
• Betreiber – bedienbare Parameter, als Select, Number, Switch, Time oder Date, aktiv.
• Service – Fachparameter (Heizkurve, Grenzwerte, Estrichprogramm). Angelegt, aber deaktiviert; je Entität in Home Assistant aktivierbar.
• Werk – Herstellerparameter. Nur sichtbar, wenn ausdrücklich gewählt.

Datenpunkte je Funktionstyp

fctType 1 – Heizkreis (Infinity PLUS)

fctType 2 – Warmwasser

fctType 4 – Kaskade / hydraulische Weiche

fctType 5 – Solar

fctType 6 – Kessel (Gas / Öl)

fctType 7 – Wärmepumpe

fctType 8 – E-Heizung / Zusatzheizung

fctType 9 – Kessel (BioWIN)

fctType 10 – Kessel (Automatik-/Zusatzkessel)

fctType 14 – Heizkreis (UML / UMLZ)

fctType 15 – Umschaltung

fctType 16 – Puffer (B-PLMi)

fctType 20 – ZSP Pumpen-/Relaismodul

fctType 21 – Puffer

fctType 24 – Pumpe Wärmeerzeuger / Schichtladung

fctType 25 – Kessel (PuroWIN)