Geräteprofil · Heizungs- und Lüftungsregler

OpenTherm Gateway (OTGW)

Hinweis: Dieses Profil beruht auf der Topic-Liste der OTGW-Firmware selbst (docs/api/MQTT.md im Projekt rvdbreemen/OTGW-firmware, Version 2.x).

Voraussetzungen

1. Ein OpenTherm Gateway zwischen Thermostat und Kessel, mit der ESP-Firmware 2.x von rvdbreemen/OTGW-firmware (die Nodoshop-Bauform). Das reine PIC-Gateway ohne ESP spricht kein MQTT.
2. In der Weboberfläche des Gateways unter Settings → MQTT:
   • den Broker eintragen, den auch nomos nutzt
   • MQTT Top Topic: frei wählbar, voreingestellt OTGW
   • MQTT Unique ID: muss otgw lauten ⚠️ wichtig, siehe Hinweise
3. Das Gateway muss im Gateway-Modus laufen, nicht im Monitor-Modus, sonst werden Schreibbefehle ignoriert (Settings → Gateway mode bzw. der Befehl GW=1).

Einrichtung

1. Skills → Add-ons: Profil importieren

2. Gerät anlegen und als MQTT-Topic das Top Topic eintragen, also meist OTGW — nicht den vollen Pfad.

   Das Profil setzt daraus selbst OTGW/value/otgw/<Wert> für die Messwerte und OTGW/set/otgw/<Befehl> für die Befehle zusammen.

Datenbereich

Die Werte kommen, sobald das Gateway sie veröffentlicht – es wird nichts abgefragt.

• Brenner läuft (active, zusätzlich als burner), Heizung aktiv (heating_active), Warmwasserbereitung aktiv (dhw_active)
• Störung (malfunction) aus dem Fehlerbit des Kessels, dazu der OEM-Fehlercode (ausgeblendet)
• Raumtemperatur und Raum-Solltemperatur des Thermostats
• Vorlauf, Rücklauf, Vorlauf-Soll und Außentemperatur
• Warmwasser: Temperatur und Solltemperatur
• Anlagendruck (bar) und Brennermodulation (%)
• Maximale Modulation, maximale Vorlauftemperatur, Warmwasser-Durchfluss, Abgastemperatur, Gebläsedrehzahl, Flammenstrom und die Kühl-/Diagnosebits (ausgeblendet)
• Erreichbar (reachable): das Lebenszeichen der Firmware am Broker (siehe Hinweise)
• Ob Kessel und Thermostat am Gateway erkannt werden, steht in boiler_connected und thermostat_connected (ausgeblendet)

Schreibbar sind Raum-Solltemperatur, Warmwasser-Betriebsart, Warmwasser-Solltemperatur, maximale Vorlauftemperatur und maximale Modulation. Ausgeblendet dazu: dauerhafte Raum-Solltemperatur, Außentemperatur, Heizungsfreigabe und der Gateway-Modus.

Hinweise

• Die Unique ID muss otgw heißen. Die Firmware baut ihre Topics als <Top Topic>/value/<Unique ID>/<Wert> und <Top Topic>/set/<Unique ID>/<Befehl>. Zwischen Top Topic und Unique ID steht also einmal value und einmal set — ein Profil hat aber nur eine Topic-Variable und kann diese Stelle nicht überspringen. Deshalb ist die Unique ID im Profil fest auf die Werksvoreinstellung otgw gesetzt. Steht in Ihrem Gateway etwas anderes (ältere Installationen tragen dort manchmal den Hostnamen mit MAC-Adresse), kommt kein einziger Wert an; dann die Unique ID in Settings → MQTT auf otgw ändern.
• Firmware 2.x ist Voraussetzung. Version 1.x veröffentlicht andere Topics; mit ihr bleibt das Gerät leer.
• Das Thermostat behält das Kommando. Die geschriebene Raum-Solltemperatur ist ein vorübergehender Vorrang (OTGW-Befehl TT): das Thermostat überschreibt ihn beim nächsten Programmwechsel. Wer dauerhaft vorgeben will, nutzt die ausgeblendete dauerhafte Raum-Solltemperatur (TC).
• Erreichbarkeit stammt vom Lebenszeichen. Die Firmware hinterlegt beim Broker auf <Top Topic>/value/otgw/ die Worte online und offline; nomos wandelt sie in Ja/Nein um. Das sagt, ob das Gateway am Broker ist — nicht, ob der Kessel antwortet. Dafür gibt es boiler_connected.
• Welche Werte Ihre Anlage liefert, hängt vom Kessel ab. Das Gateway reicht nur durch, was Kessel und Thermostat über OpenTherm austauschen; was Ihre Anlage nicht sendet, bleibt in nomos leer.
• Die Außentemperatur lässt sich ins Thermostat schreiben. Wer in nomos einen eigenen Außenfühler hat, kann ihn dem Kessel über die ausgeblendete outdoor_temperature vorgeben (OTGW-Befehl OT).
• Nicht im Profil enthalten: die S0- und 1-Wire-Eingänge der Firmware, Lüftungs- und Wärmerückgewinnungswerte, der Solarspeicher-Block, die rohen OpenTherm-Nachrichten (otmessage), die Befehle für alternative und unbekannte Message-IDs sowie die LED- und GPIO-Konfiguration des Gateways.