Geräteprofil · Heizungs- und Lüftungsregler

RESOL DeltaSol über Kommunikationsmodul KM2 / Datalogger DL2 Plus

Hinweis: Dieses Profil beruht auf der JSON-RPC-Schnittstelle /cgi-bin/resol-webservice von KM2 und DL2 Plus, auf der VBus-Spezifikation und auf echten Antworten eines KM2.

Für die Datalogger DL2 und DL3 gibt es ein eigenes, einfacheres Add-on: RESOL DeltaSol über Datalogger DL2 / DL3.

Voraussetzungen

1. RESOL-Solar- oder Heizungsregler mit VBus (Vorgabe: DeltaSol CS Plus, andere Regler siehe unten), per VBus-Leitung an ein
2. RESOL Kommunikationsmodul KM2 oder einen RESOL Datalogger DL2 Plus angeschlossen. Das Gerät braucht eine feste IP-Adresse (DHCP-Reservierung).
3. Benutzername und Passwort des lokalen Webinterfaces – beim KM2 Benutzer admin, das Passwort steht auf dem Typenschild des Moduls („Web-Interface“). Die Zugangsdaten von VBus.net funktionieren hier nicht. Das Passwort darf kein Anführungszeichen " und keinen Backslash \ enthalten.
4. Ein nomos Controller mit Daemon 1.2.9 / Backend 0.3.51 oder neuer (das Add-on sendet HTTP-POST-Anfragen).
5. Test: Im Browser http://<IP>/ öffnen und mit denselben Zugangsdaten am Webinterface anmelden; die Livewerte des Reglers müssen dort sichtbar sein.

Einrichtung

1. nomos Config Panel öffnen
2. Das RESOL-Profil KM2 / DL2 Plus unter Skills → Add-ons importieren
3. Gerät hinzufügen
4. IP-Adresse des KM2 bzw. DL2 Plus, Benutzername und Passwort eintragen
5. Paketnummer und Feldnummern prüfen (nächster Abschnitt) – ohne diese Prüfung können Werte vertauscht sein

Paket- und Feldnummern prüfen

KM2 und DL2 Plus liefern die Werte im selben Aufbau wie die Datalogger DL2/DL3: nicht mit Namen, sondern als nummerierte Liste. Unter headers stehen die Pakete und ihre Felder (mit Namen), unter headersets → packets die Werte mit header_index (Paketnummer, ab 0) und field_index (Feldnummer, ab 0). Das Add-on liest raw_value des Feldes FIELD_… im Paket PACKET_INDEX.

Die Reihenfolge stammt aus der VBus-Spezifikation (VSF), die im KM2/DL2 Plus installiert ist. Die Vorgaben entsprechen dem DeltaSol CS Plus mit aktueller Spezifikation (21 Felder):

Die Nummern für ältere Spezifikationen und für andere Regler (DeltaSol BS Plus, BS 2009, BS/DrainBack) stehen in der Anleitung des DL2/DL3-Profils; sie gelten hier unverändert. Beispiel aus der Praxis: Ein DeltaSol CS2 am KM2 liefert 17 Felder – Sensor 1–4 = 0–3, Drehzahl Relais = 6, Betriebsstunden Relais = 7, ErrorMask = 9, Wärmemenge = 15.

Die Feldliste lässt sich im Webinterface des KM2/DL2 Plus ablesen (Livedaten des Reglers, in der angezeigten Reihenfolge ab 0 zählen) oder beim nomos Support erfragen.

Datenbereich

Das Add-on fragt alle 60 Sekunden ab, in zwei Schritten (beide POST /cgi-bin/resol-webservice, JSON-RPC 2.0):

1. login mit Benutzername und Passwort – das Gerät antwortet mit einer Sitzungskennung (authId).
2. Sofort danach dataGetCurrentData mit dieser authId – das Gerät antwortet mit allen Livewerten.

Die authId merkt sich der Controller in einer temporären Systemvariablen (TMP-<Klasse>-AUTHID); weil jede Abfrage neu anmeldet, spielt die Gültigkeitsdauer einer Sitzung keine Rolle.

• Temperaturen: Kollektor (S1), Speicher unten (S2), Speicher oben (S3), Sensor S4 (ausgeblendet)
• Pumpen: Drehzahl Relais 1 und 2 in %, Betriebsstunden Relais 1 und 2
• Solarpumpe läuft (active): Drehzahl Relais 1 größer 0
• Wärmemenge in kWh (Rohwert in Wh, durch 1000 geteilt)
• Störung (malfunction): Fehlermaske ungleich 0 (Sensorbruch/-kurzschluss); die Fehlermaske selbst ist ausgeblendet verfügbar (Bit 1 = S1, 2 = S2, 4 = S3, 8 = S4 defekt)
• Erreichbarkeit (reachable): ob das KM2/DL2 Plus auf die Anmeldung antwortet

Hinweise

• Nur lesend: Die Schnittstelle liefert nur Livewerte; Reglereinstellungen kann das Add-on nicht ändern.
• Falsche Zugangsdaten fallen nur indirekt auf: reachable bleibt 1 (das Gerät antwortet ja), die Werte werden aber nie aktualisiert. Bleiben die Werte nach der Einrichtung leer, zuerst Benutzername und Passwort prüfen.
• Falsche Feldnummern fallen nicht auf: Das Add-on liest dann einfach ein anderes Feld. Hat das Paket weniger Felder als die eingestellte Nummer, wird der Wert aus dem nächsten Paket gelesen. Nach einem Firmware- oder VSF-Update des KM2/DL2 Plus die Nummern erneut prüfen.
• Anmeldung jede Minute: Das Add-on meldet sich bei jeder Abfrage neu an (ohne Abmeldung). Das Add-on passt sich automatisch an die Schreibweise der JSON-Antwort an (mit oder ohne Leerzeichen um den Doppelpunkt).
• Sensorfehler: Ein offener oder kurzgeschlossener Fühler meldet RESOL als 888.8 °C bzw. -888.8 °C. Nicht angeschlossene Fühler (oft S4) zeigen daher dauerhaft 888,8 °C.
• Welcher Fühler Kollektor bzw. Speicher ist, hängt vom im Regler gewählten Anlagenschema ab; die Bezeichnungen gelten für das Standard-Solarsystem (System 1).
• Nicht unterstützt: KM1 und VBus/LAN-Adapter (nur binäres VBus-Protokoll über TCP-Port 7053).