EMS-ESP Gaskessel — Bosch, Buderus, Junkers

EMS-ESP Gaskessel (Bosch, Buderus, Junkers, Nefit)

Packet Parser → HTTP

Eingereicht von

Zuletzt aktualisiert: 10. 2026

Erfordert externes Gateway
BBQKees Electronics Gateway E32 V2 (EMS-ESP 3.8.6 firmware) — Produktseite

Dieses Gerät unterstützt mDNS
Anstelle einer IP-Adresse können Sie das Gerät unter folgender Adresse erreichen:
ems-esp.local
Ersetzen Sie {MAC} durch die MAC-Adresse des Geräts (Großbuchstaben, ohne Doppelpunkte).
TapHome unterstützt mDNS — die Verwendung eines Hostnamens ist zuverlässiger als eine statische IP.

EMS-ESP Gaskessel (Bosch, Buderus, Junkers, Nefit)

Die Vorlage EMS-ESP Gas Boiler verbindet TapHome mit einem Gaskessel von Bosch, Buderus, Junkers oder Nefit über ein EMS-ESP-Gateway — ein BBQKees Electronics Gateway E32 V2, auf dem die quelloffene Firmware EMS-ESP läuft und das am EMS-Bus des Kessels angeschlossen wird. TapHome kommuniziert mit dem Gateway über dessen lokale HTTP-REST-API (Port 80, JSON); eine Cloud-Verbindung ist nicht nötig. In EMS-ESP erscheint der Kessel als Gerätetyp boiler und sein Regler als Gerätetyp thermostat.

Die Vorlage liest, ob der Kessel heizt oder Warmwasser bereitet, die Vorlauftemperatur und ihren Zielwert, die Brennerleistung, den letzten vom Kessel gespeicherten Fehlercode, den Anlagendruck, die Brennerstarts, die Außentemperatur sowie Raum- und Warmwassertemperatur. Mit einem Zugangstoken stellt sie außerdem den Modus des Heizkreises 1 (Aus, Manuell, Auto), den Raumsollwert und den Warmwassersollwert ein.

Community-Vorlage — noch nicht mit TapHome getestet. Die Vorlage wurde im TapHome-Portal erstellt und für EMS-ESP 3.8.6 geschrieben; an einer realen Installation wurde sie noch nicht überprüft. Sie erhalten sie im TapHome-Portal: EMS-ESP Gas Boiler — Community-Vorlage (XML herunterladen — ohne Anmeldung — und als neues Modul importieren).

Kompatible Kessel und Regler

Zwei Dinge entscheiden, ob ein Kessel mit dieser Vorlage funktioniert: EMS-ESP muss den Kessel unterstützen, und Kessel und Regler müssen die Werte senden, die die Vorlage liest.

Von der Vorlage abgedeckte Kessel:

Buderus GB125, GB135, GB162, GBx72, GB192, GB192i.2, Logamax Plus GB022, U122
Bosch / Junkers Cerapur GC2200W, Cerapur Top, Condens 2500, GC9000
Nefit Topline, Trendline
Worcester Greenstar Si, 30Ri Compact, 8000

Die EMS-ESP-Liste unterstützter Kessel nennt weitere Modelle, zum Beispiel Logano, Nefit Proline und Smartline, Condens 2300 und 5000i.

Das Gateway funktioniert mit den Busvarianten EMS, EMS Plus (EMS+), EMS2 und Heatronic 3. Ältere Kessel mit iRT-Bus wie der Nefit Ecomline oder der Buderus GB112 können das Gateway erst nach dem Einbau eines Bosch EasyControlAdapter nutzen. OpenTherm gehört nicht zu den Bustypen, die das Gateway unterstützt.

Welche Werte ein bestimmter Kessel sendet, ist nicht pro Modell dokumentiert. Die Seite Devices in der Weboberfläche von EMS-ESP zeigt nur Entitäten mit einem Wert; eine Entität, die in EMS-ESP existiert, aber keinen Wert hat, wird von der Firmware unterstützt, nicht vom angeschlossenen Kessel. Dieselbe Liste gibt es unter http://<gateway-ip>/api/boiler/entities und http://<gateway-ip>/api/thermostat/entities.

Der Heizkreismodus hängt vom Regler ab, weil jede Reglerfamilie ihre eigene Liste von Modi hat:

Regler	Modi in EMS-ESP	Heizkreismodus
RC300, RC310, RC100, HMC310, Rego 2000 / 3000	manual, auto	Manuell und Auto; die Auswahl Aus endet mit einem Schreibfehler
BC400, UI800, CR120	off, manual, auto	Aus, Manuell und Auto
RC35, Junkers-Regler und andere Modelle	andere Listen (zum Beispiel RC35: night, day, auto; Junkers: nofrost, eco, heat, auto)	nicht unterstützt — das Gerät endet mit einem Fehler, löschen Sie es

Kessel von Junkers und Nefit sind oft mit Reglern von Junkers oder Nefit kombiniert, die eine andere Modusliste haben. Die Kesselgeräte der Vorlage hängen nicht vom Regler ab und funktionieren weiter.

Einige Regler nehmen keine EMS-Schreibbefehle an und erscheinen in EMS-ESP als reine Lesegeräte: Buderus Logamatic TC100, Bosch EasyControl CT200, Junkers CT100, Moduline Easy, Junkers FW / FR mit Baujahr vor 9/2008 und Tado-Thermostate. Mit ihnen lassen sich Modus und Raumsollwert nicht aus TapHome ändern.

Hardware-Anschluss

Das BBQKees Gateway E32 V2 KIT enthält das Gateway, ein 150 cm langes EMS-Servicekabel, ein 100 cm langes Kabel für die EMS-Schraubklemmen, einen Adapterstecker für den EMS-Serviceanschluss, ein Netzteil (12 V DC mit Hohlstecker oder 5 V USB-C, je nach Produktionscharge) und ein JST-ZH-Kabel für eigene Temperatursensoren DS18B20. Das Gateway wird auf eine von drei Arten an den Kessel angeschlossen:

Anschluss am Kessel	Kabel	Stromversorgung
EMS-Servicebuchse (3,5 mm)	150 cm EMS-Servicekabel	aus der Servicebuchse
EMS-Servicebuchse (3,5 mm)	150 cm EMS-Servicekabel	externes Netzteil
Schraubklemmen des EMS-Busses	100 cm Kabel für EMS-Schraubklemmen	externes Netzteil (12 V DC oder 5 V USB-C)

Die Servicebuchse kommt nur in Frage, wenn der Kessel eine hat. Gateways, die ab Sommer 2025 verkauft werden, akzeptieren beide Netzteiltypen. Das BBQKees EMS Gateway Wiki zeigt, wie das Gateway an einen bestimmten Kessel angeschlossen wird.

Netzwerk: Ethernet (RJ45) oder WLAN. EMS-ESP verbindet sich nur mit 2,4-GHz-WLAN-Netzen mit WPA2, nicht mit 5 GHz.
Firmware: EMS-ESP. Das Gateway E32 V2 (verkauft ab Januar 2024) hat PSRAM und verwendet die Firmware-Variante ESP32-16MB+. Die Firmware wird in der Weboberfläche von EMS-ESP unter Settings → Version aktualisiert.

Konfiguration

Ersteinrichtung von EMS-ESP

Beim ersten Start öffnet EMS-ESP einen WLAN-Zugangspunkt ems-esp (WPA-Passwort ems-esp-neo). Ein Gateway am Ethernet ist unter der IP-Adresse erreichbar, die ihm der Router zugewiesen hat.
Melden Sie sich mit dem Standardbenutzer admin / admin an und ändern Sie das Passwort.
Verbinden Sie das Gateway unter Settings → Network mit dem Heimnetz (WLAN oder Ethernet).
Reservieren Sie im Router eine feste IP-Adresse für das Gateway (DHCP-Reservierung) — die Vorlage spricht das Gateway über seine IP-Adresse an.

Wichtige Einstellungen in EMS-ESP

Temperaturen in °C — lassen Sie „Convert temperature values to Fahrenheit“ unter Settings → Application ausgeschaltet. Das Modul prüft dies alle 60 s und zeigt einen Fehler, wenn EMS-ESP °F meldet.
Language: English — lassen Sie die Sprache unter Settings → Application auf English. Das Gerät Heizkreismodus erkennt den Modus an seinem Optionstext (off, manual, auto), und EMS-ESP übersetzt diese Texte in die gewählte Sprache; mit einer anderen Sprache endet das Gerät mit einem Fehler, der den gemeldeten Text nennt. Schreibzugriffe verwenden die englischen Texte, die EMS-ESP in jeder Sprache akzeptiert, und die anderen Geräte hängen nicht von der Sprache ab.
Boolean Format und Enum Format spielen keine Rolle. Die Vorlage liest die Schlüssel index und bool und den numerischen value aus dem Entitätsdetail von EMS-ESP, die von diesen Einstellungen nicht abhängen.
Firmware 3.8 — das Modul zeigt eine Warnung, wenn das Gateway eine Version außerhalb der Reihe 3.8 meldet. In 3.7.0 wanderten die Warmwasser-Entitäten vom Präfix ww in das verschachtelte Objekt dhw, und EMS-ESP bekam eine eigene Modusliste für Regler vom Typ BC400; zwischen 3.8.0 und 3.8.6 haben sich die von der Vorlage verwendeten Entitäten nicht geändert.

Zugangstoken für Schreibzugriffe

Lesen braucht keine Authentifizierung. Schreiben — Heizkreismodus, Raum- und Warmwassersollwert — braucht das EMS-ESP-Zugangstoken eines Benutzers mit Administratorrechten:

Öffnen Sie die Weboberfläche von EMS-ESP → Settings → Security → Manage Users.
Klicken Sie auf das Schlüsselsymbol eines Benutzers mit Administratorrechten und kopieren Sie das Token. Das Token hat kein Ablaufdatum.
Fügen Sie das Token beim Import der Vorlage in den Importparameter AccessToken ein.

Ohne Token ist die Integration nur lesend und jeder Schreibzugriff endet mit Fehler 401. Schalten Sie stattdessen nicht „Bypass Access Token authorization on API calls“ in EMS-ESP ein — die API wird dadurch offen, und die EMS-ESP-Dokumentation rät davon ab.

Importparameter

Parameter	Beschreibung
`IpAddress`	IP-Adresse des EMS-ESP-Gateways
`AccessToken`	EMS-ESP-Zugangstoken eines Benutzers mit Administratorrechten — nur für Schreibzugriffe nötig; für eine rein lesende Integration leer lassen

Gerätefunktionen

Heizkreis 1

Heizkreismodus — Aus, Manuell oder Auto für Heizkreis 1. Das Gerät liest die Position in der Modusliste des Reglers, sucht ihren Optionstext und zeigt Aus, Manuell oder Auto; es schreibt den englischen Optionstext. Welche Modi funktionieren, hängt vom Regler ab (siehe Tabelle oben).
Raumthermostat — aktuelle und gewählte Raumtemperatur des Heizkreises 1, wie sie der Regler meldet. Der Sollwertbereich des Geräts ist 0–30 °C. EMS-ESP führt den Raumsollwert in Schritten von 0,5 °C; die Vorlage sendet den Wert unverändert.

Kesselstatus

Heizen aktiv — aktiv, solange der Kessel für die Raumheizung läuft.
Warmwasserbereitung aktiv — aktiv, solange der Kessel Trinkwasser erwärmt.

Temperaturen

Vorlauftemperatur — aktuelle Vorlauftemperatur des Kessels mit einer Auflösung von 0,1 °C.
Vorlauf-Zieltemperatur — die Vorlauftemperatur, die der Kessel anstrebt (0–90 °C), vom Regler vorgegeben. Das Gerät ist bewusst nur lesbar: EMS-ESP könnte diesen Wert schreiben, aber eine geschriebene Vorlauftemperatur würde den Raumregler übersteuern.
Außentemperatur — Außentemperatur, wie sie der Kessel meldet, mit einer Auflösung von 0,1 °C.

Brenner und Anlagendruck

Brennerleistung — aktuelle Brennerleistung in Prozent. Das Gerät liest außerdem den letzten vom Kessel gespeicherten Fehlercode und zeigt ihn als Infomeldung „Last error code (stored by the boiler): …“, zum Beispiel 2E(207) 100.75.2000 65:00 (0 min). Das ist der Code, den der Kessel zuletzt gespeichert hat, mit Datum und Dauer — nicht unbedingt eine aktive Störung; die Meldung bleibt auch nach Behebung der Störung bestehen. Wenn der Fehlercode nicht gelesen werden kann, zeigt das Gerät eine Warnung und die Brennerleistung bleibt verfügbar.
Brennerstarts — Gesamtzahl der vom Kessel gezählten Brennerstarts.
Anlagendruck — Wasserdruck der Heizungsanlage in bar mit einer Auflösung von 0,1 bar.

Warmwasser

Warmwasser — aktuelle und gewählte Warmwassertemperatur des Kessels. Der Sollwertbereich des Geräts ist 10–70 °C, der Sollwert wird in ganzen Grad gesendet und der Kessel wendet seine eigenen Grenzen an.

Die Vorlage schreibt den Warmwassersollwert des Kessels (dhw.seltemp), nicht die Warmwassereinstellungen des Reglers (dhw.settemp, dhw.mode). Die EMS-ESP-Dokumentation weist darauf hin, dass vom Regler verwaltete Kesseleinstellungen von ihm überschrieben werden; ein Regler, der das Warmwasser verwaltet, kann den in TapHome gesetzten Sollwert also überschreiben. An einer realen Installation wurde das noch nicht überprüft.

So kommuniziert die Vorlage mit EMS-ESP

Jedes Gerät liest seine eigenen Werte mit einer HTTP-GET-Anfrage pro Entität auf /api/<device>/[hc1/|dhw/]<entity> und nimmt den Schlüssel value, index oder bool aus der Antwort. Die meisten Geräte fragen alle 30 s ab; Anlagendruck und Außentemperatur alle 60 s und Brennerstarts alle 5 Minuten. Das Modul liest /api/system/info alle 60 s. Schreibzugriffe sind HTTP-POST-Anfragen mit einem JSON-Body und dem Zugangstoken im Header Authorization: Bearer.

EMS-ESP 3.8.3 und neuer antwortet mit 429 Too Many Requests auf eine GET-Anfrage, die weniger als 50 ms nach dem vorherigen API-Aufruf eintrifft. Die Vorlage wartet deshalb vor jeder GET-Anfrage 60 ms und wiederholt sie bei 429 einmal nach 200 ms. Ein anderer Client, der die EMS-ESP-API zur gleichen Zeit abfragt (zum Beispiel ein zweites Hausautomationssystem), kann trotzdem gelegentlich eine Wiederholung auslösen.

Warum REST und nicht Modbus. EMS-ESP bietet auch Modbus TCP, aber seine Registeroffsets haben sich zwischen den stabilen Versionen 3.8.0 und 3.8.6 verschoben, daher würde eine Modbus-Vorlage nach einem Firmware-Update des Gateways stillschweigend andere Werte lesen. Die REST-API spricht Werte über ihren Namen an — eine umbenannte Entität endet in einem sichtbaren Gerätefehler.

Fehlerbehebung

Gerätefehler „no value from the gateway“

Die Meldung „no value from the gateway — this controller or unit does not report it; delete this device“ bedeutet, dass der angeschlossene Kessel oder Regler diese Entität nicht sendet. Prüfen Sie die Seite Devices von EMS-ESP oder http://<gateway-ip>/api/boiler/entities und http://<gateway-ip>/api/thermostat/entities und löschen Sie das Gerät nach dem Import — die anderen Geräte funktionieren weiter.

Gerätefehler 404

Ein 404 mit einer Meldung wie no 'xyz' in thermostat bedeutet, dass EMS-ESP die Entität unter diesem Pfad nicht kennt — Regler oder Kessel haben sie nicht, oder die Firmware verwendet einen anderen Namen. unknown device bedeutet, dass EMS-ESP am EMS-Bus keinen Kessel und keinen Regler dieses Typs erkannt hat.

Heizkreismodus meldet einen anderen Text

Der Fehler „hc1.mode reports ‘…’“ erscheint, wenn EMS-ESP einen anderen Modustext als off, manual oder auto meldet. Entweder ist die EMS-ESP-Sprache nicht English (unter Settings → Application auf English stellen), oder der Regler verwendet eine andere Modusliste (zum Beispiel RC35 oder ein Junkers-Regler) — löschen Sie dann das Gerät Heizkreismodus.

Die Auswahl Aus endet mit einem Schreibfehler

Regler der RC300-Familie (RC300, RC310, RC100, HMC310, Rego 2000 / 3000) haben keinen Aus-Modus. EMS-ESP lehnt einen Wert ab, der nicht in der Liste des Reglers steht, daher zeigt das Gerät einen Schreibfehler (hc1.mode write: HTTP …). Verwenden Sie bei diesen Reglern Manuell oder Auto.

Schreibzugriff endet mit Fehler 401

Das Zugangstoken fehlt oder ist falsch. Kopieren Sie es erneut unter Settings → Security → Manage Users → Schlüsselsymbol eines Benutzers mit Administratorrechten und tragen Sie es in die Variable AccessToken des Moduls ein. Das Token wird aus dem Benutzernamen und dem Super-User-Passwort unter Settings → Security → Security Settings abgeleitet.

Fehler 429

Ein anderer Client fragt die EMS-ESP-API im selben Moment ab. Die Vorlage verteilt ihre eigenen Anfragen bereits zeitlich und wiederholt sie einmal; verringern Sie die Abfragerate des anderen Clients, wenn der Fehler wiederkehrt.

Fehler oder Warnung des Moduls

„EMS-ESP reports °F“ — schalten Sie Fahrenheit unter Settings → Application aus.
„Template written for EMS-ESP 3.8.6, gateway reports …“ — das Gateway läuft mit einer Firmware außerhalb der Reihe 3.8. Aktualisieren Sie EMS-ESP unter Settings → Version.

Gateway nicht erreichbar

Prüfen Sie die LED des Gateways: 1 blaues Blinken beim Start = EMS-Bus noch nicht verbunden (Kabel und Einstellung EMS Tx Mode prüfen), 2 rote Blinksignale = Netzwerk verbindet sich noch (Settings → Network prüfen; WLAN muss 2,4 GHz WPA2 sein), Dauerlicht = EMS-Daten fließen.
Öffnen Sie http://<gateway-ip>/api/system/info im Browser — wenn es antwortet, ist das Gateway erreichbar.
Wenn sich die IP-Adresse geändert hat, finden Sie das Gateway über den mDNS-Namen http://ems-esp.local und richten Sie dann im Router eine DHCP-Reservierung ein.
Verwenden Sie http:// — die EMS-ESP-API unterstützt kein HTTPS mit selbstsignierten Zertifikaten.

Verfügbare Geräte

EMS-ESP-Gateway Modul

Benutzerdefinierte Variablen

AccessToken (string)

EMS-ESP-Zugangstoken eines Benutzers mit Administratorrechten, wird bei jedem Schreibzugriff (Heizkreismodus, Raum- und Warmwassersollwert) als Bearer-Header gesendet; Lesen funktioniert ohne, ein leeres Token ergibt also eine rein lesende Integration

EMS-ESP web interface → Settings → Security → Manage Users → key icon of a user with admin rights; paste the token into the AccessToken import parameter. The token has no expiry date.

EMS-ESP Gateway

Lesen (Modul)

SLEEP(60);
VAR r := SENDHTTPREQUEST("/api/system/info");
IF r.StatusCode = 429
    SLEEP(200);
    r := SENDHTTPREQUEST("/api/system/info");
END
IF r.IsSuccess = false
    ADDERROR("system/info: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
ELSE
    VAR fahrenheit := PARSEJSON(r.Content, "settings.fahrenheit", true);
    IF fahrenheit
        ADDERROR("EMS-ESP reports \u00b0F \u2014 switch Fahrenheit off in EMS-ESP Settings \u2192 Application");
    END
    VAR version := PARSEJSON(r.Content, "system.version", true);
    IF !ISNULL(version)
        IF INDEXOF(TOSTRING(version), "3.8.") != 0
            ADDWARNING("Template written for EMS-ESP 3.8.6, gateway reports " + version);
        END
    END
END

Heizkreismodus Mehrwertschalter

Betriebsmodus des Heizkreises 1 — Aus, Manuell oder Auto; Regler der RC300-Familie bieten nur Manuell und Auto, BC400 / UI800 / CR120 auch Aus; erfordert EMS-ESP-Sprache English

enum json_path

Werte / Zustände: Off · Manual · Auto

Heizkreismodus

Schaltzustand lesen

SLEEP(60);
VAR r := SENDHTTPREQUEST("/api/thermostat/hc1/mode");
IF r.StatusCode = 429
    SLEEP(200);
    r := SENDHTTPREQUEST("/api/thermostat/hc1/mode");
END
IF r.IsSuccess = false
    ADDERROR("hc1.mode: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
    RETURN(NaN);
END
VAR enumList := PARSEJSON(r.Content, "enum", true);
VAR idx := PARSEJSON(r.Content, "index", true);
IF ISNULL(enumList) OR ISNULL(idx)
    ADDERROR("hc1.mode: no value from the gateway \u2014 this controller or unit does not report it; delete this device");
    RETURN(NaN);
END
VAR text := PARSEJSON(r.Content, "$.enum[" + TOSTRING(idx) + "]", true);
IF ISNULL(text)
    ADDERROR("hc1.mode: no value from the gateway \u2014 this controller or unit does not report it; delete this device");
    RETURN(NaN);
END
IF text = "off"
    RETURN(0);
ELSEIF text = "manual"
    RETURN(1);
ELSEIF text = "auto"
    RETURN(2);
ELSE
    ADDERROR("hc1.mode reports '" + text + "': this template supports controllers with off / manual / auto and needs EMS-ESP Language = English (Settings \u2192 Application)");
    RETURN(NaN);
END

Schaltzustand schreiben

VAR modeName := IF(Mu = 0, "off", IF(Mu = 1, "manual", "auto"));
VAR body := "{\"value\":\"" + modeName + "\"}";
VAR r := SENDHTTPREQUEST("/api/thermostat/hc1/mode", "POST", body, "Content-Type: application/json", "Authorization: Bearer " + AccessToken);
IF r.IsSuccess = false
    IF r.StatusCode = 401
        ADDERROR("hc1.mode write: access token missing or wrong (EMS-ESP Settings \u2192 Security \u2192 Manage Users \u2192 key icon of an admin user)");
    ELSE
        ADDERROR("hc1.mode write: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
    END
END

Raumthermostat Thermostat

Aktuelle und gewählte Raumtemperatur des Heizkreises 1 vom Regler; Sollwert 0–30 °C, von EMS-ESP in Schritten von 0,5 °C geführt

numeric Einheit: °C

Raumthermostat

Temperatur lesen

SLEEP(60);
VAR r := SENDHTTPREQUEST("/api/thermostat/hc1/currtemp");
IF r.StatusCode = 429
    SLEEP(200);
    r := SENDHTTPREQUEST("/api/thermostat/hc1/currtemp");
END
IF r.IsSuccess = false
    ADDERROR("hc1.currtemp: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
    RETURN(NaN);
END
VAR v := PARSEJSON(r.Content, "value", true);
IF ISNULL(v)
    ADDERROR("hc1.currtemp: no value from the gateway \u2014 this controller or unit does not report it; delete this device");
    RETURN(NaN);
END
RETURN(v);

Solltemperatur lesen

SLEEP(60);
VAR r := SENDHTTPREQUEST("/api/thermostat/hc1/seltemp");
IF r.StatusCode = 429
    SLEEP(200);
    r := SENDHTTPREQUEST("/api/thermostat/hc1/seltemp");
END
IF r.IsSuccess = false
    ADDERROR("hc1.seltemp: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
    RETURN(NaN);
END
VAR v := PARSEJSON(r.Content, "value", true);
IF ISNULL(v)
    ADDERROR("hc1.seltemp: no value from the gateway \u2014 this controller or unit does not report it; delete this device");
    RETURN(NaN);
END
RETURN(v);

Solltemperatur schreiben

VAR body := "{\"value\":" + Se + "}";
VAR r := SENDHTTPREQUEST("/api/thermostat/hc1/seltemp", "POST", body, "Content-Type: application/json", "Authorization: Bearer " + AccessToken);
IF r.IsSuccess = false
    IF r.StatusCode = 401
        ADDERROR("hc1.seltemp write: access token missing or wrong (EMS-ESP Settings \u2192 Security \u2192 Manage Users \u2192 key icon of an admin user)");
    ELSE
        ADDERROR("hc1.seltemp write: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
    END
END

Heizen aktiv Reed-Kontakt Nur lesen

Aktiv, solange der Kessel für die Raumheizung läuft

boolean

Heizen aktiv

Lesen

SLEEP(60);
VAR r := SENDHTTPREQUEST("/api/boiler/heatingactive");
IF r.StatusCode = 429
    SLEEP(200);
    r := SENDHTTPREQUEST("/api/boiler/heatingactive");
END
IF r.IsSuccess = false
    ADDERROR("heatingactive: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
    RETURN(NaN);
END
VAR v := PARSEJSON(r.Content, "bool", true);
IF ISNULL(v)
    ADDERROR("heatingactive: no value from the gateway \u2014 this controller or unit does not report it; delete this device");
    RETURN(NaN);
END
RETURN(v);

Warmwasserbereitung aktiv Reed-Kontakt Nur lesen

Aktiv, solange der Kessel Trinkwasser erwärmt

boolean

Warmwasserbereitung aktiv

Lesen

SLEEP(60);
VAR r := SENDHTTPREQUEST("/api/boiler/tapwateractive");
IF r.StatusCode = 429
    SLEEP(200);
    r := SENDHTTPREQUEST("/api/boiler/tapwateractive");
END
IF r.IsSuccess = false
    ADDERROR("tapwateractive: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
    RETURN(NaN);
END
VAR v := PARSEJSON(r.Content, "bool", true);
IF ISNULL(v)
    ADDERROR("tapwateractive: no value from the gateway \u2014 this controller or unit does not report it; delete this device");
    RETURN(NaN);
END
RETURN(v);

Vorlauftemperatur Temperatursensor Nur lesen

numeric Einheit: °C

Vorlauftemperatur

Temperatur lesen

SLEEP(60);
VAR r := SENDHTTPREQUEST("/api/boiler/curflowtemp");
IF r.StatusCode = 429
    SLEEP(200);
    r := SENDHTTPREQUEST("/api/boiler/curflowtemp");
END
IF r.IsSuccess = false
    ADDERROR("curflowtemp: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
    RETURN(NaN);
END
VAR v := PARSEJSON(r.Content, "value", true);
IF ISNULL(v)
    ADDERROR("curflowtemp: no value from the gateway \u2014 this controller or unit does not report it; delete this device");
    RETURN(NaN);
END
RETURN(v);

Vorlauf-Zieltemperatur Variable Nur lesen

Vorlauftemperatur, die der Kessel anstrebt (0–90 °C), vom Regler vorgegeben; nur lesbar, damit TapHome den Regler nie übersteuert

numeric Einheit: °C

Vorlauf-Zieltemperatur

Lesen

SLEEP(60);
VAR r := SENDHTTPREQUEST("/api/boiler/selflowtemp");
IF r.StatusCode = 429
    SLEEP(200);
    r := SENDHTTPREQUEST("/api/boiler/selflowtemp");
END
IF r.IsSuccess = false
    ADDERROR("selflowtemp: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
    RETURN(NaN);
END
VAR v := PARSEJSON(r.Content, "value", true);
IF ISNULL(v)
    ADDERROR("selflowtemp: no value from the gateway \u2014 this controller or unit does not report it; delete this device");
    RETURN(NaN);
END
RETURN(v);

Brennerleistung Variable Nur lesen

Aktuelle Brennerleistung in Prozent; zeigt außerdem den letzten vom Kessel gespeicherten Fehlercode als Infomeldung — nicht unbedingt eine aktive Störung

numeric Einheit: %

Brennerleistung

Lesen

SLEEP(60);
VAR r := SENDHTTPREQUEST("/api/boiler/curburnpow");
IF r.StatusCode = 429
    SLEEP(200);
    r := SENDHTTPREQUEST("/api/boiler/curburnpow");
END
IF r.IsSuccess = false
    ADDERROR("curburnpow: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
    RETURN(NaN);
END
VAR v := PARSEJSON(r.Content, "value", true);
IF ISNULL(v)
    ADDERROR("curburnpow: no value from the gateway \u2014 this controller or unit does not report it; delete this device");
    RETURN(NaN);
END
RETURN(v);

Lesen (Modul)

SLEEP(60);
VAR rlc := SENDHTTPREQUEST("/api/boiler/lastcode");
IF rlc.StatusCode = 429
    SLEEP(200);
    rlc := SENDHTTPREQUEST("/api/boiler/lastcode");
END
IF rlc.IsSuccess = false
    ADDWARNING(1, "lastcode: HTTP " + rlc.StatusCode + IF(ISNULL(PARSEJSON(rlc.Content, "message", true)), "", ": " + PARSEJSON(rlc.Content, "message", true)));
ELSE
    VAR lc := PARSEJSON(rlc.Content, "value", true);
    IF !ISNULL(lc)
        ADDINFO(1, "Last error code (stored by the boiler): " + lc);
    END
END

Anlagendruck Variable Nur lesen

Wasserdruck der Heizungsanlage in bar

numeric Einheit: bar

Anlagendruck

Lesen

SLEEP(60);
VAR r := SENDHTTPREQUEST("/api/boiler/syspress");
IF r.StatusCode = 429
    SLEEP(200);
    r := SENDHTTPREQUEST("/api/boiler/syspress");
END
IF r.IsSuccess = false
    ADDERROR("syspress: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
    RETURN(NaN);
END
VAR v := PARSEJSON(r.Content, "value", true);
IF ISNULL(v)
    ADDERROR("syspress: no value from the gateway \u2014 this controller or unit does not report it; delete this device");
    RETURN(NaN);
END
RETURN(v);

Brennerstarts Variable Nur lesen

Gesamtzahl der vom Kessel gezählten Brennerstarts

numeric

Brennerstarts

Lesen

SLEEP(60);
VAR r := SENDHTTPREQUEST("/api/boiler/burnstarts");
IF r.StatusCode = 429
    SLEEP(200);
    r := SENDHTTPREQUEST("/api/boiler/burnstarts");
END
IF r.IsSuccess = false
    ADDERROR("burnstarts: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
    RETURN(NaN);
END
VAR v := PARSEJSON(r.Content, "value", true);
IF ISNULL(v)
    ADDERROR("burnstarts: no value from the gateway \u2014 this controller or unit does not report it; delete this device");
    RETURN(NaN);
END
RETURN(v);

Warmwasser Thermostat

Aktuelle und gewählte Warmwassertemperatur des Kessels; der Sollwert wird in ganzen Grad gesendet und der Kessel wendet seine eigenen Grenzen an

numeric Einheit: °C

Warmwasser

Temperatur lesen

SLEEP(60);
VAR r := SENDHTTPREQUEST("/api/boiler/dhw/curtemp");
IF r.StatusCode = 429
    SLEEP(200);
    r := SENDHTTPREQUEST("/api/boiler/dhw/curtemp");
END
IF r.IsSuccess = false
    ADDERROR("dhw.curtemp: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
    RETURN(NaN);
END
VAR v := PARSEJSON(r.Content, "value", true);
IF ISNULL(v)
    ADDERROR("dhw.curtemp: no value from the gateway \u2014 this controller or unit does not report it; delete this device");
    RETURN(NaN);
END
RETURN(v);

Solltemperatur lesen

SLEEP(60);
VAR r := SENDHTTPREQUEST("/api/boiler/dhw/seltemp");
IF r.StatusCode = 429
    SLEEP(200);
    r := SENDHTTPREQUEST("/api/boiler/dhw/seltemp");
END
IF r.IsSuccess = false
    ADDERROR("dhw.seltemp: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
    RETURN(NaN);
END
VAR v := PARSEJSON(r.Content, "value", true);
IF ISNULL(v)
    ADDERROR("dhw.seltemp: no value from the gateway \u2014 this controller or unit does not report it; delete this device");
    RETURN(NaN);
END
RETURN(v);

Solltemperatur schreiben

VAR body := "{\"value\":" + ROUND(Se) + "}";
VAR r := SENDHTTPREQUEST("/api/boiler/dhw/seltemp", "POST", body, "Content-Type: application/json", "Authorization: Bearer " + AccessToken);
IF r.IsSuccess = false
    IF r.StatusCode = 401
        ADDERROR("dhw.seltemp write: access token missing or wrong (EMS-ESP Settings \u2192 Security \u2192 Manage Users \u2192 key icon of an admin user)");
    ELSE
        ADDERROR("dhw.seltemp write: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
    END
END

Außentemperatur Temperatursensor Nur lesen

Außentemperatur, wie sie der Kessel meldet

numeric Einheit: °C

Außentemperatur

Temperatur lesen

SLEEP(60);
VAR r := SENDHTTPREQUEST("/api/boiler/outdoortemp");
IF r.StatusCode = 429
    SLEEP(200);
    r := SENDHTTPREQUEST("/api/boiler/outdoortemp");
END
IF r.IsSuccess = false
    ADDERROR("outdoortemp: HTTP " + r.StatusCode + IF(ISNULL(PARSEJSON(r.Content, "message", true)), "", ": " + PARSEJSON(r.Content, "message", true)));
    RETURN(NaN);
END
VAR v := PARSEJSON(r.Content, "value", true);
IF ISNULL(v)
    ADDERROR("outdoortemp: no value from the gateway \u2014 this controller or unit does not report it; delete this device");
    RETURN(NaN);
END
RETURN(v);

Verbindung: Packet Parser → HTTP • Hostname: ems-esp.local

Mögliche Verbesserungen (17)

Writing the selected flow temperature — Writable in EMS-ESP (0–90 °C), deliberately left out: a written flow temperature overrides the room controller; the template only reads it (Flow Temperature Target)
Heating circuits 2–8 — Same entities as hc1 under the hc2…hc8 path prefix; the template covers heating circuit 1 only — devices for further circuits would be copies with a different path
Summer / winter switchover — winter / auto / summer, RC100 and RC300
Further heating circuit settings — Comfort / eco / manual setpoints, summer and frost thresholds, flow temperature limits, heating curve design temperature, offset, room influence, control mode and time program (RC100 / RC300 and others); the docs mark the command table as incomplete and model-dependent
Controller-side domestic hot water settings — DHW mode (off / on / auto), DHW set temperatures, one-time charge and circulation mode on RC100 / RC300 — the template reads and writes the boiler DHW entities instead
Boiler-side hot water functions — Hot water enable, one-time charge, circulation pump and mode, flow temperature offset and maximum power for hot water; some of them are overwritten by the thermostat (docs Boilers)
Boiler comfort mode, heating enable and heating temperature limit — comfort hot / eco / intelligent; heatingactivated and heatingtemp are not changeable on some systems (for example with an MC10 rotary control)
Burner and pump parameters — Burner hysteresis, minimum burner period, modulation limits and pump settings — installer parameters, the allowed ranges depend on the boiler type
Maintenance message and error reset — Set or reset the maintenance message; reset error should be used only with an active error (docs Boilers) — candidates for service actions
EMS-ESP firmware version — Already fetched by the module for the version warning; could be exposed as a module service attribute
Restart EMS-ESP — GET with access token; candidate for a module service action
Refresh all device values — Forces EMS-ESP to re-read all values from the EMS bus; no authentication
Temperature sensors on the gateway (DS18B20) — The kit includes a JST ZH cable for own DS18B20 sensors; their readings are available over the same REST API
Analog sensors and outputs of the gateway — Readings and setvalue for gateway analog inputs, counters and output pins
Custom entities — User-defined entities for EMS telegrams EMS-ESP does not decode yet
Entity discovery lists — Not a device — the live list of entities a given installation reports; the way to check which template devices will work before importing
Other EMS-ESP interfaces — EMS-ESP also offers Modbus TCP (since 3.7.0) and MQTT / MQTT Discovery; the template uses the REST API by entity name because Modbus register offsets move between firmware releases

Vorlage herunterladen

Quellen

EMS-ESP 3.8.6 REST API facts (TapHome digest of the firmware at tag v3.8.6)
github.com 2026-10-18
EMS-ESP documentation — Commands and API Reference
docs.emsesp.org 2026-10-18
EMS-ESP documentation — Configuring EMS-ESP
docs.emsesp.org 2026-10-18
EMS-ESP documentation — Supported Boilers
docs.emsesp.org 2026-10-18
EMS-ESP documentation — Supported Thermostats
docs.emsesp.org 2026-10-18
EMS-ESP documentation — Installing
docs.emsesp.org 2026-10-18
EMS-ESP documentation — Getting Started
docs.emsesp.org 2026-10-18
EMS-ESP changelog 3.7.0 – 3.8.6
github.com 2026-10-18
BBQKees Gateway E32 V2 KIT (Ethernet + WiFi Edition V2 KIT) — product page
bbqkees-electronics.nl 2026-10-18

Haben Sie ein Problem mit dieser Gerätevorlage gefunden?

Sagen Sie uns, was nicht funktioniert, was fehlt oder wie sich die Vorlage verhalten sollte. Ihr Feedback hilft uns, den Katalog genau zu halten.

Community — ungeprüft

Möchtest du das in deinem TapHome Core verwenden?

Öffne diese Vorlage im Kundenportal, um sie auf eine deiner Wohnungen anzuwenden, oder entwirf eine Anpassung und reiche sie an den Katalog ein.

Im Portal öffnen