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 Kesselhaus und Altbau. 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

Wärmequellen ohne Anschluss an die Steuerung

Eine Solaranlage, ein Heizstab oder eine Fernwärmeübergabe meldet der Windhager-Steuerung nichts. Wer solche Werte in Home Assistant hat, legt sie unter Einstellungen → Geräte & Dienste → HeatNexus → Gerät hinzufügen an — bis zu acht je Anlage. Jede Quelle wird ein eigenes Gerät; „Ändern” auf ihrer Geräteseite öffnet dieselben Angaben wieder, „Löschen” entfernt sie.

Je Quelle werden angegeben:

• Name und Bauart (Solaranlage, Heizstab, Fernwärme oder sonstige Quelle). Die Bauart wählt das Symbol und den Platz im Schaubild: Der Heizstab liegt auf der Pufferzeichnung, alles Übrige bekommt einen eigenen Kasten.
• Bedingung, wann die Quelle Wärme liefert — ein Zustand („an”), eine Schwelle (ab diesem Wert) oder die Differenz zweier Entitäten, etwa Kollektor minus Puffer — und die Entität, die darüber entscheidet.

Der zweite Schritt fragt nur ab, was zur gewählten Bedingung gehört:

• Beim Zustand die Zustände, die als an gelten. Meldet die Entität Klartext statt „an” und „aus”, ist die Auswahl Pflicht: „Solaranlage aktiv” gilt dann als liefernd, jeder andere Text als aus. Fehlt ein Zustand in der Liste, lässt er sich eintragen.
• Bei Schwelle und Differenz den Ein- und den Ausschaltwert getrennt. Bleibt der Ausschaltwert leer, gilt derselbe Wert für beides; im Grenzbereich flattert die Anzeige dann.

Daraus entsteht je Quelle ein eigenes Gerät mit einer Entität Wärmelieferung. Sie erscheint im Schaubild, in der Übersicht der eigenen Oberfläche und lässt sich wie jede andere Entität in Automationen verwenden.

Darstellung

• Sprache wirkt auf zweierlei. Die Namen der Datenpunkte kommen dann aus dem Textwerk der Steuerung oder aus den Herstellerdaten. Die eigene Oberfläche, das Dashboard, das Schaubild und die Störungstexte gibt es auf Deutsch, Englisch und Niederländisch; in jeder anderen Sprache von Home Assistant erscheinen sie englisch. Automatisch lässt die Datenpunkte deutsch und richtet die Oberfläche nach Home Assistant.

  Zwei Dinge ändern sich dabei nicht. Die Bezeichner der Entitäten (sensor.kesseltemperatur_ist) vergibt Home Assistant einmal und behält sie; daran hängen Verlauf und Automationen. Wer einen davon übersetzt haben will, ändert ihn einzeln in den Entitätseinstellungen. Und die neuen Namen der Datenpunkte erscheinen erst nach einem Neustart — die Oberfläche dagegen sofort.

• 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 und gilt für die Kessel dieser Steuerung. Automatisch leitet sie je Kessel aus Brennstoff und Funktionsnamen ab. Mit der Auswahl lässt sich eine falsch erkannte Zeichnung korrigieren.
• 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; unter Windows genügt ein Doppelklick auf tools/probe.cmd. Die Ergebnisse landen als JSON, CSV und Bericht im Ordner probe/.

Die Sonde braucht dieselbe IP-Adresse und dasselbe Service-Passwort wie die Integration, nicht das Passwort von Windhager Connect. Meldet sie „Struktur nicht lesbar“, nennt sie den Grund:

Anders als der Diagnose-Export enthält der Abzug die Kennung und die Seriennummer der Anlage. Wer ihn nicht öffentlich anhängen will, sagt es im Issue.

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 oder an der Freigabe der Einmalladung. Die Freigabe steht bis zum Ende der Ladung auf Ja, auch wenn eine Vorgabe auf Zeit die Betriebsart belegt.

Automatik. Ein Sonnentag im Winter: Die Automatik hat um 07:00 die Sonnenquote geprüft und den Sollwert bis zum Nachmittag abgesenkt. Die Kacheln zeigen Außentemperatur, Sonne und die Räume gegen ihr Ziel. Darunter steht der Tagesverlauf mit Stundenraster und Vorschau auf morgen und übermorgen.

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. „Aktivieren“ stellt die zugehörige Auswahl nach einer Rückfrage auf dieses Programm. Beim Bearbeiten lässt sich eine eigene Bezeichnung wie „Übergangszeit“ vergeben. Sie steht hinter dem Namen des Programms. In der Leseansicht ist die Zeile hervorgehoben, die gerade gilt.

Automatik

Der Reiter Automatik zeigt je Heizkreis Zustand, Begründung, Tagesverlauf, Protokoll und Einstellungen. Wie sie entscheidet und was sie an die Steuerung schreibt, steht unter Automatik.

Eigene Werte über Labels

Auch Werte, die nicht von der Heizung stammen, lassen sich anzeigen. Vergib der Entität in Home Assistant ein Label (Einstellungen → Bereiche, Labels & Zonen) und wähle dieses Label in den Einstellungen der Integration unter „Labels in der Oberfläche zeigen”. Jedes gewählte Label wird zu einer eigenen Karte in der Übersicht. Sie lässt sich verschieben, verbreitern und ausblenden wie jede andere Karte.

Was jemand in einer Karte sieht, hängt an seinen Rechten in Home Assistant: Werte, die er nicht lesen darf, stehen nicht darin.

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.

Automatik

Der Außenfühler der Anlage hängt meist auf der Nordseite. An einem sonnigen Tag in der Übergangszeit misst er wenig, während die Räume nach Süden warm werden – und der Heizkreis heizt weiter. Die Automatik nimmt dafür Temperaturfühler aus Home Assistant, die Wetterprognose und auf Wunsch eine PV-Prognose dazu. Sie regelt nicht selbst, sondern verschiebt, was die Anlage ohnehin tut:

• Sonnentag. Zur Entscheidungszeit prüft sie die Sonnenquote des Tages. Ist sie hoch genug und der Raum warm genug, senkt sie den Sollwert befristet ab, auf demselben Weg wie Eco in der Steuerung. Die Absenkung endet an der Anlage von selbst, spätestens zwei Stunden vor Sonnenuntergang. Fällt der Raum unter die Rückkehrschwelle, beendet die Automatik sie vorher.
• Übergangszeit. Sagt die Prognose für heute und morgen im Mittel mindestens die Heizgrenze voraus, oder liegt die gedämpfte Außentemperatur um die Hysterese darüber, schaltet sie den Heizkreis auf nur Warmwasser. Voraussetzung ist eine milde Nacht: Weder die aktuelle Außentemperatur noch die Stundenprognose bis 9 Uhr am nächsten Morgen darf unter die Einschaltschwelle fallen. Sonst bräuchte der Heizkreis am Morgen wieder Wärme. Zurück geht es, wenn es kühler wird und die Räume auskühlen. Eine Hysterese und eine Mindestdauer verhindern häufiges Umschalten. Liegt die aktuelle Außentemperatur unter der Einschaltschwelle der Steuerung und fordern die Thermostate Wärme an, geht der Heizkreis sofort zurück ins Programm.
• Abwesenheit und Fenster sind freiwillig. Sind alle Personen weg, senkt sie ab. Ein offenes Fenster setzt die Entscheidungen aus.

Die Heizgrenze der Steuerung

Die Automatik führt keine eigene Heizgrenze. Sie liest TA Heizbetrieb der Steuerung und richtet sich danach, an jedem Heizkreis und mit jedem Kessel. Die Steuerung selbst schaltet nach der aktuellen Außentemperatur; die Automatik schaltet nach Prognose und gedämpfter Außentemperatur und ist damit vorausschauend. Liefert ein Heizkreis die Heizgrenze nicht, rechnet sie mit 17 °C und sagt das in der Außen-Kachel.

Unter den Kacheln stehen die Heizgrenzen der Steuerung für Heiz- und Absenkbetrieb. Sie lassen sich dort ändern; das ist eine Einstellung von Hand, kein Eingriff der Automatik, und zählt nicht zum Budget.

Einrichten

Eingerichtet wird im Reiter Automatik je Heizkreis: Heizflächen, Räume, Wetter und optional PV-Prognose, Personen und Fenster. Die Art der Heizflächen wählt eines von drei Profilen – Schnell für Heizkörper, Standard für gemischt, Träge für Fußboden- und Wandheizung. Die Ausrichtung verschiebt diese Werte und legt fest, wie weit die Automatik von der Heizgrenze der Steuerung abweicht:

• Eco greift früher und kräftiger ein: 2 K unter der Heizgrenze der Steuerung, Sonnentag ab 15 % weniger Sonnenquote, 0,5 K mehr Absenkung, „sehr sonnig“ schon ab 0,5 K über Ziel, Räume nach einer Stunde ohne Wärmeanforderung ruhig.
• Ausgewogen nimmt die Werte der Heizflächen unverändert.
• Komfort greift später und sanfter ein: 1 K über der Heizgrenze der Steuerung, Sonnentag erst ab 10 % mehr Sonnenquote, 0,5 K weniger Absenkung, kein „sehr sonnig“, Räume erst nach drei Stunden ruhig.

Unter „Erweitert“ lässt sich jeder Wert einzeln ändern; eigene Werte gehen der Ausrichtung vor.

Beobachten, schalten, Grenzen

Die Automatik beginnt im Beobachtungsmodus. Dann schreibt sie nichts an die Steuerung, und das Protokoll zeigt, was sie getan hätte. Erst „Schalten“ macht sie wirksam. Weitere Regeln:

• Eine Bedienung von Hand hat Vorrang und pausiert die Automatik bis 05:00 am nächsten Morgen.
• Fährt die Steuerung ein eigenes Programm – Urlaub, Estrich, Hand-, Test- oder Kaminkehrerbetrieb –, greift die Automatik nicht ein.
• Höchstens vier Eingriffe am Tag gehen an die Steuerung; die Zahl lässt sich einstellen.
• Unter 16 °C im Raum nimmt sie jeden eigenen Eingriff sofort zurück. Unter 3 °C außen schaltet sie „nur Warmwasser“ sofort zurück. Den Frostschutz der Anlage ersetzt sie nicht.
• Wird die Automatik ausgeschaltet, nimmt sie ihre eigenen Eingriffe zurück.

Prognose an den Standort anpassen

Die Wetterprognose gilt für den Ort, nicht für den Fühler an der Nordwand. Die Automatik vergleicht deshalb jede Stunde, was die Prognose vorhergesagt hat, mit dem Messwert des Außenfühlers. Aus der Abweichung je Tageszeit wird ein Versatz, zum Beispiel „Außen angepasst −1,4 K“. Mit einem Zähler für den tatsächlichen PV-Ertrag vergleicht sie ebenso die PV-Prognose mit dem Ertrag und bildet einen Faktor, etwa „Sonne angepasst −12 %“. Das Verfahren entspricht der Prognoseanpassung von evcc.

• Die Korrektur wirkt nach sieben Tagen mit Daten. Unter „Erweitert“ lässt sich das Lernfenster auf 3, 7 oder 14 Tage stellen; bei 3 Tagen wirkt sie nach drei Tagen.
• Der Schalter Prognose anpassen schaltet die Korrektur für Anzeige und Entscheidung ab. Gelernt wird weiter.
• Als PV-Prognose dient immer der Ertrag des ganzen Tages. Ein Wert für den Rest des Tages schrumpft im Lauf des Tages und wird nicht angeboten.

Heute, morgen, übermorgen

Das Stundenraster zeigt je Stunde von 06 bis 22 Uhr das Wetter, die angepasste Außentemperatur, was die Automatik in dieser Stunde tut, und den Raum gegen das Soll. Darunter zeigt ein Diagramm die Sonne, die Außentemperatur gemessen und laut Prognose, die gedämpfte Außentemperatur und die Heizgrenze. Die schon vergangenen Stunden von heute liest die Automatik beim Start aus der Aufzeichnung von Home Assistant nach.

Für morgen und übermorgen rechnet sie mit derselben Regel vor, was sie voraussichtlich tun wird. Dabei nimmt sie an, dass die Räume ihr Ziel halten.

Räume und ihr Ziel

Ohne Raumfühler am Heizkreis regelt die Steuerung nur nach der Außentemperatur. Der Raumsollwert verschiebt dann nur die Heizkurve und sagt nichts darüber, wie warm ein Raum sein soll. Die Automatik vergleicht deshalb jeden Raum mit seinem eigenen Ziel:

• Thermostate wie tado lassen sich direkt als Raum wählen. Sie liefern Ist, Ziel und ob sie gerade heizen. Senkt ein Thermostat nachts ab, sinkt das Ziel mit.
• Ein ausgeschaltetes Thermostat, etwa beim Lüften oder im Sommer, zählt als Raum ohne Bedarf: Es fordert keine Wärme an und geht nicht in die Abweichung ein. Sein Ist-Wert zählt weiter für die Sicherheit unter 16 °C. Ein nicht erreichbares Thermostat zählt gar nicht.
• Für reine Temperaturfühler gilt die Wunschtemperatur aus der Einrichtung. Bleibt das Feld leer, gilt der Raumsollwert des Heizkreises. Das passt nur, wenn der Heizkreis selbst einen Raumfühler hat.
• Nur Warmwasser setzt mit Thermostaten zusätzlich voraus, dass seit zwei Stunden kein Raum Wärme angefordert hat.
• Mit Thermostaten ist der Sonnentag ab Werk aus. Die Thermostate öffnen bei abgesenktem Sollwert nur weiter. Unter „Erweitert“ lässt er sich einschalten.

Die Raum-Kachel zeigt dann die Abweichung der Räume von ihrem Ziel, im Mittel oder für den kältesten Raum.

Wärmequellen mit Vorrang

In der Einrichtung lassen sich Wärmequellen von HeatNexus wählen, deren Wärme Vorrang vor dem Kessel hat, etwa eine Solaranlage oder ein Heizstab am PV-Überschuss. Ob eine Quelle Vorrang bekommt, entscheidet jede Anlage selbst; ab Werk ist keine gewählt.

• Liefert eine gewählte Quelle zur Entscheidungszeit, gilt der Tag als Sonnentag, auch wenn die Prognose vorsichtiger ist.
• Beginnt eine gewählte Quelle zu liefern, entscheidet die Automatik sofort neu, einmal am Tag, statt bis zur nächsten Entscheidungszeit zu warten.
• Hat vier Stunden nach Beginn einer Absenkung keine gewählte Quelle Wärme geliefert, beendet die Automatik die Absenkung.
• Die Sonnen-Kachel nennt, ob eine Quelle liefert oder wie lange heute schon. Im Stundenraster tragen diese Stunden oben einen Strich.

Die Auswahl zeigt zu jedem Fühler den aktuellen Wert. Ein ausgefallener Fühler meldet in Home Assistant oft weiter seinen letzten Wert. Zeigt ein Raumfühler über Stunden denselben Wert, gilt er als veraltet und zählt nicht zum Raumwert; die Raum-Kachel nennt ihn dann ausdrücklich.

Geräte und Sensoren

Mit der ersten Automatik entsteht das Gerät HeatNexus Automatik. Es bündelt alle Automatiken des Eintrags:

• Status: aus, beobachten, aktiv, Eingriff aktiv, pausiert oder Störung, der schwerste Zustand aller Heizkreise; je Heizkreis als Attribut,
• Automatiken, Eingriffe heute, Letzter Eingriff mit Grund und Heizkreis, Nächste Entscheidung,
• Störung und Wetterprognose (an, solange jede Automatik eine Prognose hat, die jünger als sechs Stunden ist).

Darunter steht je Heizkreis das Gerät **Automatik **. Es führt:

• den Schalter Automatik und die Auswahlen Automatik-Modus und Automatik-Ausrichtung,
• den Sensor Automatik-Zustand mit der Begründung als Attribut,
• die Werte, mit denen sie rechnet: Gedämpfte Außentemperatur, Heizgrenze (die der Steuerung samt Ausrichtung), Räume zum Ziel, Sonnenquote heute,
• Eingriffe heute mit dem Budget als Attribut, Letzter Eingriff mit dem Grund, Nächste Entscheidung,
• Störung: an, solange die Steuerung Eingriffe ablehnt oder die Sicherheitsregel greift.

Damit lässt sich die Automatik auch in Automationen und Dashboards verwenden. Der Diagnose-Export der Integration enthält je Automatik Einstellungen, wirksame Werte, die letzte Lage, das Protokoll und den Verlauf des Tages.

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. Jeder Kessel wird einzeln erkannt: 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.

Die Heizgrenze des Heizkreises

Der Heizkreis schaltet sich über die Außentemperatur selbst ab. Maßgeblich ist TA Heizbetrieb (Werkseinstellung 20 °C) mit 1 K Hysterese:

• Liegt die aktuelle Außentemperatur 1 K über dem eingestellten Wert, geht der Heizkreis auf Standby.
• Fällt sie 1 K darunter, heizt er wieder. Eine gedämpfte oder gemittelte Außentemperatur verwendet die Steuerung dafür nicht.
• Nach dem Abschalten läuft die Heizkreispumpe noch einige Minuten nach. Der Mischer regelt in dieser Zeit weiter auf den letzten Vorlauf-Sollwert; das gilt auch beim Wechsel auf WW-Betrieb.

An einem warmen Tag in der Übergangszeit schaltet der Heizkreis deshalb mittags ab und abends wieder ein, sobald es kühler wird.

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. Links und Zurück-Pfeile der Kopie führen weiter zu /heatnexus/. Liegt die Kopie unter einer anderen Adresse, ersetze /heatnexus/ im Text durch diese Adresse.

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 geraete/ (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)