TapHome

Ecoforest HP24

Modbus RTU
Submitted by
Last updated: 03. 2026

Die Ecoforest HP24-Vorlage verbindet Ecoforest ecoGEO- und ecoAIR-Wärmepumpen über Modbus RTU am RS-485 BMS2-Port mit TapHome. Die Vorlage bietet umfassende Überwachung von Temperaturen, Produktionsmodusstatuten, Kompressordiagnose, Ausgangsleistung, Sollwerten und Betriebsprogramm.

Der Wärmepumpenregler (Carel pCOOEM+) verfügt über zwei RS-485-Ports: BMS1 (erfordert optionale Seriellkarte) und BMS2 (standardmäßig verfügbar). Die Kommunikation verwendet standardmäßig Slave ID 17 für Wärmepumpen.

Wichtig — Slave ID

Die Standard-Modbus-Slave-ID für Ecoforest-Wärmepumpen ist 17 (nicht 1). Ändern Sie beim Import der Vorlage in TapHome den Slave-ID-Parameter vom Standardwert 1 auf 17 (oder Ihre konfigurierte Adresse).

Hardwareanschluss

Reglerübersicht

Die Ecoforest-Wärmepumpe verwendet einen Carel pCOOEM+-Regler. Der BMS2-Port (Anschlussgruppe ganz links) ist die primäre RS-485-Schnittstelle für die Modbus RTU-Kommunikation und ist standardmäßig verfügbar — keine zusätzliche Hardware erforderlich.

Carel pCOOEM+ controller board — BMS2 and FieldBus1 on the left, BMS1 Serial Card and pLAN in the center, FieldBus2 on the right

Anschlüsse (von links nach rechts):

  • BMS2 (ganz links) — Primärer RS-485 Modbus-Port (Tx/Rx-, Tx/Rx+, GND) — standardmäßig verfügbar
  • FieldBus1 (links) — Interne Kommunikation
  • BMS1 / Serial Card (Mitte-links) — Sekundärer RS-485-Port — erfordert optionale Seriellkarte
  • pLAN (Mitte) — Controller Area Network
  • FieldBus2 (ganz rechts) — Interne Kommunikation
Technische Spezifikationen
  • Kommunikationsport: BMS2 (RS-485)
  • Protokoll: Modbus RTU (Holding-Register, Funktionscode 0x03 / 0x06 / 0x10)
  • Baudrate: 19200
  • Parität: Keine
  • Stoppbits: 2
  • Datenbits: 8
  • Standard-Slave-ID: 17 (Wärmepumpe)
RS-485-Verdrahtung (BMS2-Port)

Verbinden Sie mit einem 3-adrigen abgeschirmten Twisted-Pair-Kabel:

  • Tx/Rx+ (Pin A+) an BMS2 –> A+/D+ an TapHome RS-485
  • Tx/Rx- (Pin B-) an BMS2 –> B-/D- an TapHome RS-485
  • GND an BMS2 –> GND des TapHome-Netzteils (Pflicht)

Kabelspezifikation:

  • Typ: abgeschirmtes 3-adriges Twisted-Pair-Kabel
  • Schirm mit Erde verbinden, um Störungen zu vermeiden
  • Kabel nicht parallel zu Starkstromleitungen verlegen

Wichtig — Erdung und Kabel

Verwenden Sie ausschließlich abgeschirmte 3-adrige Twisted-Pair-Kabel. Verbinden Sie den Kabelschirm mit Erde. Verlegen Sie das RS-485-Kabel nicht parallel zu Starkstromleitungen. Der GND-Leiter muss zwischen dem Wärmepumpenregler und TapHome verbunden sein.

Modbus-Kommunikation aktivieren

Bevor TapHome mit der Ecoforest-Wärmepumpe kommunizieren kann, muss die BUS-Steuerung im Installationsmenü der Wärmepumpe aktiviert werden. Dies ist ein zweistufiger Prozess: Konfiguration des BMS2-Ports und Aktivierung der BUS-Fernsteuerung.

Schritt 1 — BMS2-Port-Konfiguration überprüfen

Navigieren Sie im Installationsmenü zur BMS2-Konfigurationsmaske:

  1. Gehen Sie zu Installationsmenü –> c. Installation (Seite 6/8)
  2. Wählen Sie f. Fernsteuerung
  3. Blättern Sie zu Seite 3/3 des Untermenüs Fernsteuerung
  4. Wählen Sie c. BUS-Steuerung
  5. Überprüfen Sie, dass die BMS2-Konfiguration folgendes anzeigt:
    • Protokoll: MB Extended
    • Baudrate: 19200
    • Stoppbits: 2
    • Parität: None
    • Adresse: 17
Ecoforest installer menu navigation — Installer menu → Installation (page 6/8) → f.Remote control → page 3/3 → c.BUS Control → BMS2 configuration: Protocol MB Extended, Baudrate 19200, Stop bits 2, Parity None, Address 17
Schritt 2 — BUS-Fernsteuerung aktivieren

Die BUS-Steuerung muss explizit aktiviert werden, damit die Wärmepumpe Modbus-Befehle akzeptiert:

  1. Gehen Sie zu Installationsmenü –> c. Installation (Seite 6/8)
  2. Wählen Sie f. Fernsteuerung
  3. Blättern Sie zu Seite 3/3 des Untermenüs Fernsteuerung
  4. Wählen Sie c. BUS-Steuerung
  5. Aktivieren Sie im Bildschirm BMS remote control das Kontrollkästchen Enable
Ecoforest installer menu navigation — Installer menu → Installation (page 6/8) → f.Remote control → page 3/3 → c.BUS Control → BMS remote control with Enable checkbox checked

BUS-Steuerung ist Option c auf Seite 3/3 des Untermenüs Fernsteuerung. Seiten 1/3 und 2/3 enthalten EVU/SG Control und Services Control — blättern Sie über diese hinaus, um zur BUS-Steuerung zu gelangen.

Gerätefunktionen

Temperaturüberwachung

Die Vorlage bietet umfangreiche Temperaturüberwachung über die hydraulischen Kreise und den Kältemittelkreislauf der Wärmepumpe:

Temperaturen des Hydraulikkreises (alle /10 Umrechnung, °C):

  • Außentemperatur (H:2080) — Umgebungsaußentemperatur, mit Sicherheitsalarmen bei Frost/Überhitzung
  • Vorlauftemperatur Primärkreis (H:2082) — Wassereinlauf quellseitig
  • Rücklauftemperatur Primärkreis (H:2081) — Wasserauslauf quellseitig
  • Vorlauftemperatur Sekundärkreis (H:2085) — Wassereinlauf heizungsseitig
  • Rücklauftemperatur Sekundärkreis (H:2084) — Wasserauslauf heizungsseitig
  • Pufferspeichertemperatur Heizung (H:2132) — Heizungs-Pufferspeicher
  • Pufferspeichertemperatur Kühlung (H:2133) — Kühlungs-Pufferspeicher
  • Warmwasserspeichertemperatur (H:2130) — Trinkwarmwasser-Speicher
  • Warmwasserzirkulationstemperatur (H:2131) — Warmwasser-Zirkulationskreis

Temperaturen des Kältemittelkreislaufs (alle /10 außer Verdampfung, °C):

  • Kompressor-Saugtemperatur (H:2092) — Kältemittel-Saugleitung
  • Kompressor-Drucktemperatur (H:2095) — Kompressordruckseite / Scroll
  • Überhitzung (H:2096) — Kältemittelüberhitzung (Saugung minus Verdampfung)
  • Wechselrichtertemperatur (H:2097) — Kompressor-Wechselrichterelektronik
  • Verdampfungstemperatur (H:2098) — Kältemittelverdampfung (Vorlage verwendet /100)
  • Kondensationstemperatur (H:2099) — Kältemittelkondensation
Sollwertüberwachung

Die Vorlage liest die aktuellen Sollwerte für alle Dienste (alle /10 Umrechnung, °C):

  • Warmwasser-Sollwert (H:2150) — Zieltemperatur Trinkwarmwasser
  • Heizpuffer-Sollwert (H:2152) — Zieltemperatur Heizungs-Pufferspeicher
  • Kühlpuffer-Sollwert (H:2153) — Zieltemperatur Kühlungs-Pufferspeicher
  • HTR-Sollwert (H:2154) — Zieltemperatur Hochtemperaturheizkörper-Kreis
  • Heizungs-Sollwert Gruppe 1 (H:2155) — Heizungs-Zieltemperatur Zone 1
  • Kühlungs-Sollwert Gruppe 1 (H:2156) — Kühlungs-Zieltemperatur Zone 1

Die Sollwert-Register sind in dieser Vorlage schreibgeschützt. Um Sollwerte über Modbus zu schreiben, verwenden Sie die entsprechenden Schreibregister (H:2720 für Warmwasser, H:2722 für Heizpuffer usw.), für die zunächst die BUS-Steuerung je Dienst aktiviert werden muss. Diese können als benutzerdefinierte Modbus-Geräte in TapHome hinzugefügt werden.

Produktionsmodusstatus

Binäre Statusindikatoren, die anzeigen, welche Dienste gerade aktiv sind:

  • Warmwasser-Produktionsmodus (H:2030) — Warmwasserbereitung aktiv
  • Heizungs-Produktionsmodus (H:2031) — Heizungsbetrieb aktiv
  • Aktiver Kühlmodus (H:2032) — aktive Kühlung aktiv
  • Passiver Kühlmodus (H:2033) — passive (freie) Kühlung aktiv
  • Pool-Produktionsmodus (H:2034) — Poolheizung aktiv
  • Frostschutz-Modus (C:2035) — Frostschutz aktiv
  • Fußbodentrocknung-Modus (C:2036) — Fußbodentrocknungsprogramm aktiv
  • Integrierter Zusatzheizer (Aux 1) (C:2046) — elektrischer Backup-Heizer aktiv
  • Externer Zusatzheizer (Aux 2) (C:2047) — externer Zusatzheizer aktiv
Wärmepumpenstatus und Betriebsprogramm
  • Wärmepumpenstatus (H:2045) — Mehrwertsschalter: AUS (0), EIN (1), NOTBETRIEB (2)
  • Betriebsprogramm (H:2044) — Mehrwertsschalter: Winter (0), Sommer (1), Kombiniert (2)

Diese Werte sind in der aktuellen Vorlage schreibgeschützt. Um den Wärmepumpenstatus oder das Betriebsprogramm zu schreiben, verwenden Sie die Schreibregister H:2700 (Status) und H:2701 (Programm) mit unterschiedlicher Wertezuordnung: Für Status schreiben Sie 1=AUS, 2=EIN, 3=Notbetrieb; für Programm schreiben Sie 1=Winter, 2=Sommer, 3=Kombiniert.

Leistungsüberwachung

Die Vorlage überwacht die momentane Ausgangsleistung für jeden Dienst (alle /1000 Umrechnung):

  • Momentanleistung (H:2186) — Gesamtheizleistung
  • Heizleistung (H:2187) — Heizungsdienstleistung
  • Warmwasserleistung (H:2188) — Warmwasserdienstleistung
  • Gesamtkühlleistung (H:2190) — Gesamtkühlleistung
  • Aktive Kühlleistung (H:2191) — aktive Kühldienstleistung
  • Passive Kühlleistung (H:2192) — passive Kühldienstleistung
Energiemessung
  • Gesamter Stromverbrauch (H:2193) — gesamter momentaner Stromverbrauch
  • Stromverbrauch im Überschussmodus (H:2194) — Stromverbrauch im Überschuss- (Photovoltaik-)Modus
Kompressordiagnose
  • Kompressorstarts (H:2103 + H:2104) — Gesamtzahl der Kompressorstarts (hoch × 1000 + niedrig)
  • Kompressorbetriebsstunden (H:2105 + H:2106) — Gesamtbetriebszeit des Kompressors in Stunden (hoch × 1000 + niedrig)
Drucküberwachung

Drei Drucksensoren sind enthalten, erfordern jedoch nach dem Import eine manuelle Readscript-Konfiguration:

  • Primärkreisdruck (H:2083) — Wasserdruck quellseitig
  • Sekundärkreisdruck (H:2086) — Wasserdruck heizungsseitig
  • Kompressor-Saugdruck (H:2093) — Kältemittelsaugdruck
  • Kompressor-Druckdruck (H:2094) — Kältemitteldruckdruck

Die Druckgeräte werden als ModbusAnalogInput ohne Readscript importiert. Um sie zu aktivieren, fügen Sie in den TapHome-Diensteinstellungen folgenden Readscript hinzu: MODBUSR(H, <Adresse>, Int16) / 10 wobei <Adresse> die Registeradresse ist (z. B. 2083 für Primärkreisdruck). Das Ergebnis ist in bar.

Servicediagnose

Das Modul stellt acht Serviceattribute zur Überwachung bereit:

  • Wärmepumpenzeit — formattierter Zeitstempel aus Registern H:2000–H:2004
  • Softwareplattform — Plattformkennung (ESO22, AWD24, WWD24, WWC24)
  • Produktlinie — Produkttyp (HP, PS, EM, SM)
  • Softwareversion — Firmware-Versionsstring
  • Kompilierungstyp-Buchstabe — Unterversionsbuchstabe (A–Z)
  • Softwareversion (Build) — Build-Nummer
  • WP-Modell / Außengerät-Modell — dekodierter Modellcode aus Registern H:2010–H:2015
  • Geräterolle — Installationsrolle (Standalone, Block Master, Block Slave, Supervisor usw.)
Weitere Möglichkeiten

Das Ecoforest API BUS Client-Handbuch dokumentiert weitere Schreibregister, die nicht in dieser Vorlage enthalten sind, darunter WP EIN/AUS-Steuerung (H:2700), Betriebsprogrammauswahl (H:2701), Dienstanforderungsmanagement (H:2705–H:2715), Sollwertsteuerung (H:2720–H:2731), Zonenambientterminalsteuerung (H:2750–H:2759), Alarmmanagement (H:2074), Kompressorgeschwindigkeitsbegrenzung (H:2765) und Überschuss-/PV-Management (H:2775–H:2778). Energiezählerregister (H:2200+) liefern tägliche, monatliche und jährliche Energiezähler. Diese können in einem zukünftigen Vorlagen-Update oder als benutzerdefinierte Modbus-Geräte hinzugefügt werden.

Fehlerbehebung

Keine Modbus-Kommunikation
  1. BUS-Steuerung aktiviert prüfen: Installationsmenü –> Installation –> Fernsteuerung –> BUS-Steuerung –> Enable muss aktiviert sein
  2. BMS2-Port-Einstellungen prüfen: Protokoll muss „MB Extended" sein, Baudrate 19200, Parität None, 2 Stoppbits
  3. Slave-ID prüfen: Standard ist 17 für Wärmepumpen — stellen Sie sicher, dass TapHome mit der richtigen Adresse konfiguriert ist
  4. RS-485-Kabel prüfen:
    • Tx/Rx+ korrekt mit A+/D+ an TapHome verbunden
    • Tx/Rx- korrekt mit B-/D- an TapHome verbunden
    • GND mit Netzteilerde von TapHome verbunden — häufigstes Problem
  5. Abgeschirmtes Twisted-Pair-Kabel verwenden, Schirm mit Erde verbinden
Druckwerte funktionieren nicht

Die Druckgeräte (Primärkreisdruck, Sekundärkreisdruck, Kompressor-Saug-/Druckdruck) werden ohne Readscript importiert. Readscript manuell in TapHome hinzufügen:

  1. Gerät in den TapHome-Diensteinstellungen öffnen
  2. ReadScript hinzufügen: MODBUSR(H, <Register>, Int16) / 10
  3. Werte sind in bar (manometrisch)
Falsche Temperaturmesswerte
  • Die meisten Temperaturen verwenden /10 Umrechnung (Gain 0,1 laut Quelldokumentation)
  • Die Verdampfungstemperatur verwendet in der Vorlage /100 — falls Messwerte falsch erscheinen, versuchen Sie auf /10 zu ändern
  • Der doppelte Heizpufferspeicher-Temperatureintrag verwendet /100 statt /10 — verwenden Sie den primären Eintrag mit /10 Umrechnung
Falsche Leistungsmesswerte

Die Vorlage verwendet eine feste /1000-Umrechnung für Leistungsregister, aber die tatsächliche Umrechnung hängt vom Leistungseinheitenregister H:2185 ab (10=W, 20=kW, 30=MW). Überprüfen Sie die Leistungseinheiteneinstellung Ihrer Wärmepumpe. Wenn die Wärmepumpe Leistung in W (Wert 10 bei H:2185) meldet, ist die /1000-Umrechnung korrekt. Für kW (Wert 20) sind die Messwerte 10× zu groß.

Verfügbare Geräte

Ecoforest HP24 Modul
Serviceattribute
Wärmepumpenzeitreads H:2000–H:2004 (year/month/day/hour/minute) and formats as \'YYYY/MM/DD HH:MM\' timestamp
Softwareplattformreads H:2005 (Int16); maps to platform name: 7=ESO22, 12=AWD24, 13=WWD24, 14=WWC24
Produktreihereads H:2006 (Int16); maps to product type: 1=HP, 2=PS, 3=EM, 4=SM
Softwareversionreads H:2007 (Int16); formats as \'V0XX\' version string
Kompilierungstyp-Buchstabereads H:2008 (Int16); maps 1–26 to A–Z subversion letter
Softwareversion (Build)reads H:2009 (Int16); build number as string
WP-Modell / Außengerätemodellreads H:2010–H:2015 (6 × Int16); decodes model code digits to character string
Geräterollereads H:2026 (Int16); 0=None, 1=Individual master/Stand alone, 2=ecoGEO block master, 3=Block slave, 4=Supervisor, 5=Individual slave, 6=ecoAIR block master

HP24

Serviceattribute
Heat pump time
var year := "20" + tostring(modbusr(H, 2000, int16));
var month := tostring(modbusr(H, 2001, int16));
var day := tostring(modbusr(H, 2002, int16));
var hour := tostring(modbusr(H, 2003, int16));
var minute := tostring(modbusr(H, 2004, int16));

if length(month) <= 1
	month := "0" + month;
end

if length(day) <= 1
	day := "0" + day;
end

if length(hour) <= 1
	hour := "0" + hour;
end

if length(minute) <= 1
	minute := "0" + minute;
end
return(
	year
	+ "/"
	+ month
	+ "/"
	+ day
	+ " "
	+ hour
	+ ":"
	+ minute
);
Software platform
SWITCH( modbusr(H, 2005, int16), 
	7, return("ESO22"),
	12, return("AWD24"),
	13, return("WWD24"),
	14, return("WWC24"),
	NaN
);
Product range
SWITCH( MODBUSR(H, 2006, int16),
	1, return("HP"),
	2, return("PS"),
	3, return("EM"),
	4, return("SM"),
	NaN
);
Software version
return(
	"V0" +
	tostring(modbusr(H, 2007, int16))
);
Compilation type letter (subversion)
switch(modbusr(H, 2008, int16),
  1, "A",
  2, "B",
  3, "C",
  4, "D",
  5, "E",
  6, "F",
  7, "G",
  8, "H",
  9, "I",
  10, "J",
  11, "K",
  12, "L",
  13, "M",
  14, "N",
  15, "O",
  16, "P",
  17, "Q",
  18, "R",
  19, "S",
  20, "T",
  21, "U",
  22, "V",
  23, "W",
  24, "X",
  25, "Y",
  26, "Z",
  ""
);
Software version
return(
	tostring(modbusr(H, 2009, int16))
);
HP model/ODU model
var model := {
	modbusr(H, 2010, int16),
	modbusr(H, 2011, int16),
	modbusr(H, 2012, int16),
	modbusr(H, 2013, int16),
	modbusr(H, 2014, int16),
	modbusr(H, 2015, int16),
};

int i := 0;
string res := "";
while i < length(model)
	switch( getat(model, i),
		12, res := append(res, "B"),
		13, res := append(res, "C"),
		14, res := append(res, "D"),
		15, res := append(res, "E"),
		res := append(res, "*")
	);
	i := i + 1;
loop
return(res);
Device role
switch(modbusr(H, 2026, int16),
	0, return("None"),
	1, return("Individual master (IDU)/Stand alone"),
	2, return("ecoGEO block master"),
	3, return("Block slave"),
	4, return("Supervisor"),
	5, return("Individual slave"),
	6, return("ecoAIR block master"),
	NaN
);
Aktiver Kühlmodus Reed-Kontakt Nur lesen

Status der aktiven Kühlproduktion — EIN wenn Kompressorkühlung läuft

Register: H:2032 Bool

Aktiver Kühlmodus

Lesen
MODBUSR(H, 2032, Bool)
Aktive Kühlleistung Variable Nur lesen

Momentane Ausgangsleistung des aktiven Kühldienstes

Register: H:2191 Int16 Einheit: kW numeric

Aktive Kühlleistung

Lesen
MODBUSR(H, 2191, Int16) / 1000
Frostschutz-Modus Reed-Kontakt Nur lesen

Frostschutzstatus — EIN wenn Frostschutz aktiv ist

Register: C:2035 Bool

Frostschutz-Modus

Lesen
MODBUSR(C, 2035, Bool)
Kühlpuffer-Sollwert Temperatursensor Nur lesen

Aktuelle Zieltemperatur des Kühlungs-Pufferspeichers

Register: H:2153 Int16 Einheit: °C numeric

Kühlpuffer-Sollwert

Temperatur lesen
MODBUSR(H, 2153, Int16) / 10
Heizpuffer-Sollwert Temperatursensor Nur lesen

Aktuelle Zieltemperatur des Heizungs-Pufferspeichers

Register: H:2152 Int16 Einheit: °C numeric

Heizpuffer-Sollwert

Temperatur lesen
MODBUSR(H, 2152, Int16) / 10
Kompressor-Hochdruck Analogeingang Nur lesen

Kältemittelhochdruck — erfordert manuelle Readscript-Konfiguration

Register: H:2094 Int16 Einheit: bar numeric

Kompressor-Hochdruck

Eingangslevel lesen
MODBUSR(H, 2094, Int16) / 100
Kompressor-Heißgastemperatur Temperatursensor Nur lesen

Kompressordruckseite / Scroll-Temperatur

Register: H:2095 Int16 Einheit: °C numeric

Kompressor-Heißgastemperatur

Temperatur lesen
MODBUSR(H, 2095, Int16) / 10
Kompressorbetriebsstunden Variable Nur lesen

Gesamtbetriebszeit des Kompressors in Stunden (zusammengesetzter Wert aus zwei Registern)

Register: H:2105+H:2106 Int16 Einheit: hours numeric

Kompressorbetriebsstunden

Lesen
MODBUSR(H, 2105, Int16) * 1000 + MODBUSR(H, 2106, Int16)
Kompressorstarts Variable Nur lesen

Gesamtzahl der Kompressorstarts (zusammengesetzter Wert aus zwei Registern)

Register: H:2103+H:2104 Int16 Einheit: count numeric

Kompressorstarts

Lesen
MODBUSR(H, 2103, Int16) * 1000 + MODBUSR(H, 2104, Int16)
Kompressor-Saugdruck Analogeingang Nur lesen

Kältemittelsaugdruck — erfordert manuelle Readscript-Konfiguration

Register: H:2093 Int16 Einheit: bar numeric

Kompressor-Saugdruck

Eingangslevel lesen
MODBUSR(H, 2093, Int16) / 100
Kompressor-Saugtemperatur Temperatursensor Nur lesen

Kältemittel-Saugleitungstemperatur

Register: H:2092 Int16 Einheit: °C numeric

Kompressor-Saugtemperatur

Temperatur lesen
MODBUSR(H, 2092, Int16) / 10
Kondensationstemperatur Temperatursensor Nur lesen

Kältemittelkondensationstemperatur

Register: H:2099 Int16 Einheit: °C numeric

Kondensationstemperatur

Temperatur lesen
MODBUSR(H, 2099, Int16) / 10
Pufferspeichertemperatur Kühlung Temperatursensor Nur lesen

Wassertemperatur des Kühlungs-Pufferspeichers

Register: H:2133 Int16 Einheit: °C numeric

Pufferspeichertemperatur Kühlung

Temperatur lesen
MODBUSR(H, 2133, Int16) / 10
Pufferspeichertemperatur Kühlung (Duplikat) Temperatursensor Nur lesen

Duplikat der Pufferspeichertemperatur Kühlung — gleicher Register H:2133

Register: H:2133 Int16 Einheit: °C numeric

Pufferspeichertemperatur Kühlung (Duplikat)

Temperatur lesen
MODBUSR(H, 2133, Int16) / 10
Warmwasser-Produktionsmodus Reed-Kontakt Nur lesen

Status der Warmwasserbereitung — EIN wenn Warmwasser erhitzt wird

Register: H:2030 Bool

Warmwasser-Produktionsmodus

Lesen
MODBUSR(H, 2030, Bool)
Warmwasserzirkulationstemperatur Temperatursensor Nur lesen

Temperatur des Warmwasser-Zirkulationskreises

Register: H:2131 Int16 Einheit: °C numeric

Warmwasserzirkulationstemperatur

Temperatur lesen
MODBUSR(H, 2131, Int16) / 10
Warmwasserleistung Variable Nur lesen

Momentane Ausgangsleistung des Warmwasserdienstes

Register: H:2188 Int16 Einheit: kW numeric

Warmwasserleistung

Lesen
MODBUSR(H, 2188, Int16) / 1000
Warmwasser-Sollwert Temperatursensor Nur lesen

Aktuelle Zieltemperatur des Trinkwarmwassers

Register: H:2150 Int16 Einheit: °C numeric

Warmwasser-Sollwert

Temperatur lesen
MODBUSR(H, 2150, Int16) / 10
Warmwasserspeichertemperatur Temperatursensor Nur lesen

Temperatur des Trinkwarmwasserspeichers

Register: H:2130 Int16 Einheit: °C numeric

Warmwasserspeichertemperatur

Temperatur lesen
MODBUSR(H, 2130, Int16) / 10
Fußbodentrocknung-Modus Reed-Kontakt Nur lesen

Status des Fußbodentrocknungsprogramms — EIN wenn Fußbodentrocknung aktiv

Register: C:2036 Bool

Fußbodentrocknung-Modus

Lesen
MODBUSR(C, 2036, Bool)
Stromverbrauch im Überschussmodus Stromzähler Nur lesen

Stromverbrauch im Überschuss- (Photovoltaik-)Modus

Register: H:2194 Int16 Einheit: kW numeric

Stromverbrauch im Überschussmodus

Bedarf lesen
MODBUSR(H, 2194, Int16) / 1000
Verdampfungstemperatur Temperatursensor Nur lesen

Kältemittelverdampfungstemperatur

Register: H:2098 Int16 Einheit: °C numeric

Verdampfungstemperatur

Temperatur lesen
MODBUSR(H, 2098, Int16) / 100
Externer Zusatzheizer (Aux 2) Reed-Kontakt Nur lesen

Status des allgemeinen externen Zusatzheizers

Register: C:2047 Bool

Externer Zusatzheizer (Aux 2)

Lesen
MODBUSR(C, 2047, Bool)
Kühlungs-Sollwert Gruppe 1 Temperatursensor Nur lesen

Endgültiger Kühlungssollwert für Zonengruppe 1

Register: H:2156 Int16 Einheit: °C numeric

Kühlungs-Sollwert Gruppe 1

Temperatur lesen
MODBUSR(H, 2156, Int16) / 10
Heizungs-Sollwert Gruppe 1 Temperatursensor Nur lesen

Endgültiger Heizungssollwert für Zonengruppe 1

Register: H:2155 Int16 Einheit: °C numeric

Heizungs-Sollwert Gruppe 1

Temperatur lesen
MODBUSR(H, 2155, Int16) / 10
Wärmepumpenstatus Mehrwertschalter Nur lesen

Betriebszustand der Wärmepumpe — AUS, EIN oder NOTBETRIEB

Register: H:2045 Int16 multi-value
Werte / Zustände: OFF · ON · EMERGENCY

Wärmepumpenstatus

Schaltzustand lesen
MODBUSR(H, 2045, Int16)
Pufferspeichertemperatur Heizung Temperatursensor Nur lesen

Wassertemperatur des Heizungs-Pufferspeichers

Register: H:2132 Int16 Einheit: °C numeric

Pufferspeichertemperatur Heizung

Temperatur lesen
MODBUSR(H, 2132, Int16) / 10
Pufferspeichertemperatur Heizung (Duplikat) Temperatursensor Nur lesen

Duplikat mit falscher /100-Umrechnung — primären Eintrag verwenden

Register: H:2132 Int16 Einheit: °C numeric

Pufferspeichertemperatur Heizung (Duplikat)

Temperatur lesen
MODBUSR(H, 2132, Int16) / 100
Heizungs-Produktionsmodus Reed-Kontakt Nur lesen

Status der Heizungsproduktion — EIN wenn Heizung läuft

Register: H:2031 Bool

Heizungs-Produktionsmodus

Lesen
MODBUSR(H, 2031, Bool)
Heizleistung Variable Nur lesen

Momentane Ausgangsleistung des Heizungsdienstes

Register: H:2187 Int16 Einheit: kW numeric

Heizleistung

Lesen
MODBUSR(H, 2187, Int16) / 1000
HTR-Sollwert Temperatursensor Nur lesen

Zieltemperatur des Hochtemperaturheizkörper-Kreises

Register: H:2154 Int16 Einheit: °C numeric

HTR-Sollwert

Temperatur lesen
MODBUSR(H, 2154, Int16) / 10
Momentanleistung Variable Nur lesen

Gesamte momentane Heizungsausgangsleistung

Register: H:2186 Int16 Einheit: kW numeric

Momentanleistung

Lesen
MODBUSR(H, 2186, Int16) / 1000
Integrierter Zusatzheizer (Aux 1) Reed-Kontakt Nur lesen

Status des integrierten elektrischen Backup-Heizers

Register: C:2046 Bool

Integrierter Zusatzheizer (Aux 1)

Lesen
MODBUSR(C, 2046, Bool)
Wechselrichtertemperatur Temperatursensor Nur lesen

Temperatur der Kompressor-Wechselrichterelektronik

Register: H:2097 Int16 Einheit: °C numeric

Wechselrichtertemperatur

Temperatur lesen
MODBUSR(H, 2097, Int16) / 10
Betriebsprogramm Mehrwertschalter Nur lesen

Betriebsprogramm der Wärmepumpe — Winter, Sommer oder Kombiniert

Register: H:2044 Int16 multi-value
Werte / Zustände: Winter · Summer · Combined

Betriebsprogramm

Schaltzustand lesen
MODBUSR(H, 2044, Int16)
Außentemperatur Temperatursensor Nur lesen

Umgebungsaußentemperatur mit Sicherheitsalarmen bei Frost/Überhitzung

Register: H:2080 Int16 Einheit: °C numeric

Außentemperatur

Temperatur lesen
MODBUSR(H, 2080, Int16) / 10
Passiver Kühlmodus Reed-Kontakt Nur lesen

Status der passiven (freien) Kühlproduktion — Kühlung ohne Kompressor

Register: H:2033 Bool

Passiver Kühlmodus

Lesen
MODBUSR(H, 2033, Bool)
Passive Kühlleistung Variable Nur lesen

Momentane Ausgangsleistung des passiven Kühldienstes

Register: H:2192 Int16 Einheit: kW numeric

Passive Kühlleistung

Lesen
MODBUSR(H, 2192, Int16) / 1000
Pool-Produktionsmodus Reed-Kontakt Nur lesen

Status der Poolheizungsproduktion — EIN wenn Pool erhitzt wird

Register: H:2034 Bool

Pool-Produktionsmodus

Lesen
MODBUSR(H, 2034, Bool)
Dashboard-Variable Variable Nur lesen

Ecoforest-Dashboard-Gerätevariable — firmware-spezifischer Diagnosewert

Register: H:6148 Int16 numeric

Dashboard-Variable

Lesen
MODBUSR(H, 6148, Int16)
Vorlauftemperatur Primärkreis Temperatursensor Nur lesen

Wassereinlauftemperatur im quellseitigen Kreislauf

Register: H:2082 Int16 Einheit: °C numeric

Vorlauftemperatur Primärkreis

Temperatur lesen
MODBUSR(H, 2082, Int16) / 10
Rücklauftemperatur Primärkreis Temperatursensor Nur lesen

Wasserauslauftemperatur im quellseitigen Kreislauf

Register: A:2081 Int16 Einheit: °C numeric

Rücklauftemperatur Primärkreis

Temperatur lesen
MODBUSR(A, 2081, Int16) / 10
Primärkreisdruck Analogeingang Nur lesen

Wasserdruck im quellseitigen Kreislauf — erfordert manuelle Readscript-Konfiguration

Register: H:2083 Int16 Einheit: bar numeric

Primärkreisdruck

Eingangslevel lesen
MODBUSR(H, 2083, Int16) / 100
Vorlauftemperatur Sekundärkreis Temperatursensor Nur lesen

Wassereinlauftemperatur im heizungsseitigen Kreislauf

Register: H:2085 Int16 Einheit: °C numeric

Vorlauftemperatur Sekundärkreis

Temperatur lesen
MODBUSR(H, 2085, Int16) / 10
Rücklauftemperatur Sekundärkreis Temperatursensor Nur lesen

Wasserauslauftemperatur im heizungsseitigen Kreislauf

Register: H:2084 Int16 Einheit: °C numeric

Rücklauftemperatur Sekundärkreis

Temperatur lesen
MODBUSR(H, 2084, Int16) / 10
Sekundärkreisdruck Analogeingang Nur lesen

Wasserdruck im heizungsseitigen Kreislauf — erfordert manuelle Readscript-Konfiguration

Register: H:2086 Int16 Einheit: bar numeric

Sekundärkreisdruck

Eingangslevel lesen
MODBUSR(H, 2086, Int16) / 100
Überhitzung Temperatursensor Nur lesen

Kältemittelüberhitzung (Saugtemperatur minus Verdampfungstemperatur)

Register: H:2096 Int16 Einheit: °C numeric

Überhitzung

Temperatur lesen
MODBUSR(H, 2096, Int16) / 10
Gesamtkühlleistung Variable Nur lesen

Gesamte momentane Kühlungsausgangsleistung

Register: H:2190 Int16 Einheit: kW numeric

Gesamtkühlleistung

Lesen
MODBUSR(H, 2190, Int16) / 1000
Gesamter Stromverbrauch Stromzähler Nur lesen

Gesamter momentaner Stromverbrauch

Register: H:2193 Int16 numeric

Gesamter Stromverbrauch

Bedarf lesen
MODBUSR(H, 2193, Int16)
Warmwasserspeichertemperatur (slowakisches Duplikat) Temperatursensor Nur lesen

Duplikat der Warmwasserspeichertemperatur mit slowakischem Namen — gleicher Register H:2130

Register: H:2130 Int16 Einheit: °C numeric

Warmwasserspeichertemperatur (slowakisches Duplikat)

Temperatur lesen
MODBUSR(H, 2130, Int16) / 10
Verbindung: Modbus RTU • 19200 baud• 8N2 • Slave ID: $[SlaveId]
Mögliche Verbesserungen (17)
  • H:2700 Heat Pump Status (Write) — Write HP status: 1=OFF, 2=ON, 3=Emergency. Template reads status (H:2045) but has no write — critical ON/OFF control missing
  • H:2701 Operation Program (Write) — Write operation program: 1=Winter, 2=Summer, 3=Combined. Template reads program (H:2044) but has no write
  • H:2705 DHW BUS Control — Enable/disable DHW setpoint control by BUS: 0=No BUS, 1=Setpoint/Offset by BUS
  • H:2720 DHW Setpoint (Write) — Write DHW setpoint 10.0–82.0°C (gain 0.1). Requires DHW BUS control (H:2705) enabled first
  • H:2722 Buffer Heating Setpoint (Write) — Write buffer heating setpoint (gain 0.1). Requires heating buffer BUS control (H:2713) enabled
  • H:2723 Buffer Cooling Setpoint (Write) — Write buffer cooling setpoint (gain 0.1). Requires cooling buffer BUS control (H:2714) enabled
  • H:2708 Group 1 Demand — Zone 1 heating/cooling demand with setpoint mode: 0=No demand, 1=Heat+setpoint, 2=Cool+setpoint, 11=Heat from HP, 12=Cool from HP
  • H:2730 Group 1 Heating Setpoint (Write) — Write group 1 heating setpoint (gain 0.1)
  • H:2750 Zone 1 BUS Terminal ON/OFF — Enable/disable zone 1 terminal: 0=OFF, 1=ON. Zones 1–5 available (H:2750–H:2754)
  • H:2755 Zone 1 Ambient Temperature Setpoint — Write zone 1 ambient setpoint 5.0–35.0°C (gain 0.1). Zones 1–5 available (H:2755–H:2759)
  • H:2065 Alarm Level — 0=No alarm, 1=Active, 2=Active+recurrence, 3=Recurrent, 4=Long time, 5=Lock-down
  • H:2066 Lock Alarm Code — Alarm code causing lockdown. Together with H:2067–H:2073 provides full alarm diagnostics
  • H:2074 Reset Alarm by BUS — Write 1 to reset recurrence alarm. WARNING: resetting without fixing cause can damage equipment
  • H:2185 Instantaneous Power Units — 10=W, 20=kW, 30=MW — determines units for power registers H:2186–H:2194. Template hardcodes /1000 without reading this
  • H:2200 Current Day Energy Units — 10=Wh, 20=kWh, 30=MWh — followed by daily energy counters H:2201–H:2211 for DHW, heating, pool, cooling, consumption
  • H:2775 Surplus Control by BUS — Enable/disable e-Manager surplus control: 0=OFF, 1=ON. For PV surplus management
  • H:2765 Maximum Compressor Reference — Write max compressor reference 0–100.0% (gain 0.1) — limits compressor speed
Vorlage herunterladen

Quellen

  • Ecoforest Modbus Variables List HP24 V01.00
    2026-03-20
    PDF
  • Ecoforest APIs BUS CLIENT MANUAL V03 (HP24_V01.02)
    2026-03-20
    PDF
  • EcoForest Modbus Registers — GitHub Community (ESPHome)
    github.com 2026-03-20