TapHome

Ecoforest HP24

Modbus RTU
Submitted by
Last updated: 03. 2026

Il template Ecoforest HP24 collega le pompe di calore Ecoforest ecoGEO e ecoAIR a TapHome tramite Modbus RTU sulla porta RS-485 BMS2. Il template offre un monitoraggio completo di temperature, stati modalità produzione, diagnostica compressore, potenza in uscita, setpoint e programma operativo.

Il regolatore della pompa di calore (Carel pCOOEM+) dispone di due porte RS-485: BMS1 (richiede scheda seriale opzionale) e BMS2 (disponibile di default). La comunicazione utilizza Slave ID 17 come impostazione predefinita per le pompe di calore.

Importante — Slave ID

Lo Slave ID Modbus predefinito per le pompe di calore Ecoforest è 17 (non 1). Durante l’importazione del template in TapHome, modificare il parametro Slave ID dal valore predefinito 1 a 17 (o all’indirizzo configurato).

Collegamento hardware

Panoramica del regolatore

La pompa di calore Ecoforest utilizza un regolatore Carel pCOOEM+. La porta BMS2 (gruppo di connettori all’estrema sinistra) è l’interfaccia RS-485 primaria per la comunicazione Modbus RTU ed è disponibile di default — non è necessario hardware aggiuntivo.

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

Connettori (da sinistra a destra):

  • BMS2 (estrema sinistra) — Porta RS-485 Modbus primaria (Tx/Rx-, Tx/Rx+, GND) — disponibile di default
  • FieldBus1 (sinistra) — Comunicazione interna
  • BMS1 / Serial Card (centro-sinistra) — Porta RS-485 secondaria — richiede scheda seriale opzionale
  • pLAN (centro) — Rete del regolatore
  • FieldBus2 (estrema destra) — Comunicazione interna
Specifiche tecniche
  • Porta di comunicazione: BMS2 (RS-485)
  • Protocollo: Modbus RTU (holding register, codice funzione 0x03 / 0x06 / 0x10)
  • Baud rate: 19200
  • Parità: Nessuna
  • Stop bit: 2
  • Bit dati: 8
  • Slave ID predefinito: 17 (pompa di calore)
Cablaggio RS-485 (porta BMS2)

Collegare con un cavo a coppia intrecciata schermata a 3 fili:

  • Tx/Rx+ (pin A+) su BMS2 –> A+/D+ su TapHome RS-485
  • Tx/Rx- (pin B-) su BMS2 –> B-/D- su TapHome RS-485
  • GND su BMS2 –> GND alimentatore TapHome (obbligatorio)

Specifiche cavo:

  • Tipo: coppia intrecciata schermata a 3 fili
  • Schermo collegato a terra per evitare interferenze
  • Non posare il cavo parallelamente a cavi di potenza

Importante — messa a terra e cavo

Utilizzare esclusivamente cavi a coppia intrecciata schermata a 3 fili. Collegare lo schermo del cavo a terra. Non posare il cavo RS-485 parallelamente a cavi di potenza. Il filo GND deve essere collegato tra il regolatore della pompa di calore e TapHome.

Abilitazione comunicazione Modbus

Prima che TapHome possa comunicare con la pompa di calore Ecoforest, il controllo BUS deve essere abilitato nel menu installatore della pompa di calore. Si tratta di un processo in due fasi: configurazione della porta BMS2 e abilitazione del controllo remoto BUS.

Fase 1 — Verifica configurazione porta BMS2

Navigare alla schermata di configurazione BMS2 nel menu installatore:

  1. Andare a Menu installatore –> c. Installazione (pagina 6/8)
  2. Selezionare f. Controllo remoto
  3. Scorrere alla pagina 3/3 del sottomenu Controllo remoto
  4. Selezionare c. Controllo BUS
  5. Verificare che la configurazione BMS2 mostri:
    • Protocollo: MB Extended
    • Baudrate: 19200
    • Stop bit: 2
    • Parità: None
    • Indirizzo: 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
Fase 2 — Abilitazione controllo remoto BUS

Il controllo BUS deve essere esplicitamente abilitato per consentire alla pompa di calore di accettare comandi Modbus:

  1. Andare a Menu installatore –> c. Installazione (pagina 6/8)
  2. Selezionare f. Controllo remoto
  3. Scorrere alla pagina 3/3 del sottomenu Controllo remoto
  4. Selezionare c. Controllo BUS
  5. Nella schermata BMS remote control, selezionare la casella 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

Controllo BUS è l’opzione c a pagina 3/3 del sottomenu Controllo remoto. Le pagine 1/3 e 2/3 contengono EVU/SG Control e Services Control — scorrerle per raggiungere Controllo BUS.

Funzionalità del dispositivo

Monitoraggio temperature

Il template offre un monitoraggio esteso delle temperature nei circuiti idraulici e nel ciclo refrigerante della pompa di calore:

Temperature circuito idraulico (tutte conversione /10, °C):

  • Temperatura esterna (H:2080) — temperatura ambiente esterna, con allarmi di sicurezza gelo/surriscaldamento
  • Temperatura ingresso circuito primario (H:2082) — ingresso acqua lato sorgente
  • Temperatura uscita circuito primario (H:2081) — uscita acqua lato sorgente
  • Temperatura ingresso circuito secondario (H:2085) — ingresso acqua lato utenza
  • Temperatura uscita circuito secondario (H:2084) — uscita acqua lato utenza
  • Temperatura serbatoio buffer riscaldamento (H:2132) — serbatoio buffer riscaldamento
  • Temperatura serbatoio buffer raffrescamento (H:2133) — serbatoio buffer raffrescamento
  • Temperatura serbatoio ACS (H:2130) — serbatoio acqua calda sanitaria
  • Temperatura ricircolo ACS (H:2131) — circuito ricircolo ACS

Temperature ciclo refrigerante (tutte /10 tranne evaporazione, °C):

  • Temperatura aspirazione compressore (H:2092) — linea aspirazione refrigerante
  • Temperatura mandata compressore (H:2095) — mandata compressore / scroll
  • Surriscaldamento (H:2096) — surriscaldamento refrigerante (aspirazione meno evaporazione)
  • Temperatura inverter (H:2097) — elettronica inverter compressore
  • Temperatura di evaporazione (H:2098) — evaporazione refrigerante (il template usa /100)
  • Temperatura di condensazione (H:2099) — condensazione refrigerante
Monitoraggio setpoint

Il template legge i setpoint correnti per tutti i servizi (tutte conversione /10, °C):

  • Setpoint ACS (H:2150) — temperatura target acqua calda sanitaria
  • Setpoint buffer riscaldamento (H:2152) — temperatura target serbatoio buffer riscaldamento
  • Setpoint buffer raffrescamento (H:2153) — temperatura target serbatoio buffer raffrescamento
  • Setpoint HTR (H:2154) — temperatura target circuito radiatori alta temperatura
  • Setpoint riscaldamento gruppo 1 (H:2155) — temperatura target riscaldamento zona 1
  • Setpoint raffrescamento gruppo 1 (H:2156) — temperatura target raffrescamento zona 1

I registri setpoint sono in sola lettura in questo template. Per scrivere setpoint tramite Modbus, utilizzare i registri di scrittura corrispondenti (H:2720 per ACS, H:2722 per buffer riscaldamento ecc.) che richiedono l’abilitazione del controllo BUS per ogni servizio. Questi possono essere aggiunti come dispositivi Modbus personalizzati in TapHome.

Stati modalità produzione

Indicatori di stato binari che mostrano quali servizi sono attualmente attivi:

  • Modalità produzione ACS (H:2030) — produzione acqua calda sanitaria in corso
  • Modalità produzione riscaldamento (H:2031) — produzione riscaldamento in corso
  • Modalità raffrescamento attivo (H:2032) — produzione raffrescamento attivo in corso
  • Modalità raffrescamento passivo (H:2033) — raffrescamento passivo (gratuito) in corso
  • Modalità produzione piscina (H:2034) — riscaldamento piscina in corso
  • Modalità antigelo (C:2035) — protezione antigelo attiva
  • Modalità asciugatura pavimento (C:2036) — programma asciugatura pavimento attivo
  • Resistenza ausiliaria integrata (Aux 1) (C:2046) — resistenza elettrica di backup attiva
  • Resistenza ausiliaria esterna (Aux 2) (C:2047) — resistenza ausiliaria esterna attiva
Stato pompa di calore e programma operativo
  • Stato pompa di calore (H:2045) — selettore multivalore: SPENTO (0), ACCESO (1), EMERGENZA (2)
  • Programma operativo (H:2044) — selettore multivalore: Inverno (0), Estate (1), Combinato (2)

Questi valori sono in sola lettura nel template corrente. Per scrivere lo stato della pompa di calore o il programma operativo, utilizzare i registri di scrittura H:2700 (stato) e H:2701 (programma) con mappatura valori diversa: per lo stato scrivere 1=SPENTO, 2=ACCESO, 3=Emergenza; per il programma scrivere 1=Inverno, 2=Estate, 3=Combinato.

Monitoraggio potenza

Il template monitora la potenza in uscita istantanea per ogni servizio (tutte conversione /1000):

  • Potenza istantanea (H:2186) — potenza totale riscaldamento
  • Potenza riscaldamento (H:2187) — potenza servizio riscaldamento
  • Potenza ACS (H:2188) — potenza servizio ACS
  • Potenza totale raffrescamento (H:2190) — potenza totale raffrescamento
  • Potenza raffrescamento attivo (H:2191) — potenza servizio raffrescamento attivo
  • Potenza raffrescamento passivo (H:2192) — potenza servizio raffrescamento passivo
Misura energia
  • Consumo elettrico totale (H:2193) — consumo elettrico istantaneo totale
  • Consumo elettrico in modalità surplus (H:2194) — consumo elettrico durante la modalità surplus (fotovoltaico)
Diagnostica compressore
  • Avviamenti compressore (H:2103 + H:2104) — numero totale avviamenti compressore (alto × 1000 + basso)
  • Ore di funzionamento compressore (H:2105 + H:2106) — ore totali di funzionamento compressore (alto × 1000 + basso)
Monitoraggio pressione

Tre sensori di pressione sono inclusi ma richiedono configurazione manuale del readscript dopo l’importazione:

  • Pressione circuito primario (H:2083) — pressione acqua lato sorgente
  • Pressione circuito secondario (H:2086) — pressione acqua lato utenza
  • Pressione aspirazione compressore (H:2093) — pressione refrigerante lato aspirazione
  • Pressione mandata compressore (H:2094) — pressione refrigerante lato mandata

I dispositivi di pressione vengono importati come ModbusAnalogInput senza readscript. Per attivarli, aggiungere il seguente readscript nelle impostazioni servizio TapHome: MODBUSR(H, <indirizzo>, Int16) / 10 dove <indirizzo> è l’indirizzo del registro (es. 2083 per pressione circuito primario). Il risultato è in bar.

Diagnostica di servizio

Il modulo espone otto attributi di servizio per il monitoraggio:

  • Ora pompa di calore — timestamp formattato dai registri H:2000–H:2004
  • Piattaforma software — identificativo piattaforma (ESO22, AWD24, WWD24, WWC24)
  • Gamma prodotto — tipo prodotto (HP, PS, EM, SM)
  • Versione software — stringa versione firmware
  • Lettera tipo compilazione — lettera sottoversione (A–Z)
  • Versione software (Build) — numero build
  • Modello HP / Modello unità esterna — codice modello decodificato dai registri H:2010–H:2015
  • Ruolo dispositivo — ruolo installazione (Standalone, Block master, Block slave, Supervisor ecc.)
Funzionalità aggiuntive

Il manuale Ecoforest API BUS Client documenta ulteriori registri di scrittura non inclusi in questo template, tra cui controllo ON/OFF pompa di calore (H:2700), selezione programma operativo (H:2701), gestione richiesta servizio (H:2705–H:2715), controllo setpoint (H:2720–H:2731), controllo terminale ambiente zona (H:2750–H:2759), gestione allarmi (H:2074), limitazione velocità compressore (H:2765) e gestione surplus/FV (H:2775–H:2778). I registri contatore energia (H:2200+) forniscono contatori energia giornalieri, mensili e annuali. Questi possono essere aggiunti in un futuro aggiornamento del template o come dispositivi Modbus personalizzati.

Risoluzione dei problemi

Nessuna comunicazione Modbus
  1. Verificare che il controllo BUS sia abilitato: Menu installatore –> Installazione –> Controllo remoto –> Controllo BUS –> Enable deve essere selezionato
  2. Verificare impostazioni porta BMS2: Il protocollo deve essere “MB Extended”, baud rate 19200, parità None, 2 stop bit
  3. Verificare Slave ID: Il predefinito è 17 per le pompe di calore — assicurarsi che TapHome sia configurato con l’indirizzo corretto
  4. Verificare cavi RS-485:
    • Tx/Rx+ correttamente collegato a A+/D+ su TapHome
    • Tx/Rx- correttamente collegato a B-/D- su TapHome
    • GND collegato alla massa dell’alimentatore TapHome — problema più comune
  5. Utilizzare cavo a coppia intrecciata schermata, schermo collegato a terra
Letture pressione non funzionanti

I dispositivi di pressione (Pressione circuito primario, Pressione circuito secondario, Pressione aspirazione/mandata compressore) vengono importati senza readscript. Aggiungere il readscript manualmente in TapHome:

  1. Aprire il dispositivo nelle impostazioni servizio TapHome
  2. Aggiungere ReadScript: MODBUSR(H, <registro>, Int16) / 10
  3. I valori sono in bar (manometrico)
Letture temperatura errate
  • La maggior parte delle temperature usa la conversione /10 (guadagno 0,1 secondo documentazione sorgente)
  • La temperatura di evaporazione usa /100 nel template — se le letture sembrano errate, provare a cambiare a /10
  • La voce duplicata della temperatura serbatoio buffer riscaldamento usa /100 invece di /10 — utilizzare la voce primaria con conversione /10
Letture potenza errate

Il template usa una conversione fissa /1000 per i registri di potenza, ma la conversione effettiva dipende dal registro unità potenza H:2185 (10=W, 20=kW, 30=MW). Verificare l’impostazione delle unità di potenza sulla propria pompa di calore. Se la pompa di calore riporta la potenza in W (valore 10 a H:2185), la conversione /1000 è corretta. Per kW (valore 20), le letture saranno 10× troppo grandi.

Dispositivi disponibili

Ecoforest HP24 Modulo
Attributi di servizio
Orario pompa di calorereads H:2000–H:2004 (year/month/day/hour/minute) and formats as \'YYYY/MM/DD HH:MM\' timestamp
Piattaforma softwarereads H:2005 (Int16); maps to platform name: 7=ESO22, 12=AWD24, 13=WWD24, 14=WWC24
Gamma prodottireads H:2006 (Int16); maps to product type: 1=HP, 2=PS, 3=EM, 4=SM
Versione softwarereads H:2007 (Int16); formats as \'V0XX\' version string
Lettera tipo compilazionereads H:2008 (Int16); maps 1–26 to A–Z subversion letter
Versione software (Build)reads H:2009 (Int16); build number as string
Modello HP / Modello unità esternareads H:2010–H:2015 (6 × Int16); decodes model code digits to character string
Ruolo dispositivoreads 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

Attributi di servizio
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
);
Modalità raffrescamento attivo Contatto reed Solo lettura

Stato produzione raffrescamento attivo — ACCESO quando il raffrescamento a compressore è attivo

Registro: H:2032 Bool

Modalità raffrescamento attivo

Lettura
MODBUSR(H, 2032, Bool)
Potenza raffrescamento attivo Variabile Solo lettura

Potenza in uscita istantanea del servizio di raffrescamento attivo

Registro: H:2191 Int16 Unità: kW numeric

Potenza raffrescamento attivo

Lettura
MODBUSR(H, 2191, Int16) / 1000
Modalità antigelo Contatto reed Solo lettura

Stato protezione antigelo — ACCESO quando la protezione antigelo è attiva

Registro: C:2035 Bool

Modalità antigelo

Lettura
MODBUSR(C, 2035, Bool)
Setpoint buffer raffrescamento Sensore di temperatura Solo lettura

Temperatura target attuale del serbatoio buffer raffrescamento

Registro: H:2153 Int16 Unità: °C numeric

Setpoint buffer raffrescamento

Lettura temperatura
MODBUSR(H, 2153, Int16) / 10
Setpoint buffer riscaldamento Sensore di temperatura Solo lettura

Temperatura target attuale del serbatoio buffer riscaldamento

Registro: H:2152 Int16 Unità: °C numeric

Setpoint buffer riscaldamento

Lettura temperatura
MODBUSR(H, 2152, Int16) / 10
Pressione mandata compressore Ingresso analogico Solo lettura

Pressione di mandata del refrigerante — richiede configurazione manuale del readscript

Registro: H:2094 Int16 Unità: bar numeric

Pressione mandata compressore

Lettura livello ingresso
MODBUSR(H, 2094, Int16) / 100
Temperatura mandata compressore Sensore di temperatura Solo lettura

Temperatura mandata compressore / scroll

Registro: H:2095 Int16 Unità: °C numeric

Temperatura mandata compressore

Lettura temperatura
MODBUSR(H, 2095, Int16) / 10
Ore di funzionamento compressore Variabile Solo lettura

Ore totali di funzionamento compressore (valore composito da due registri)

Registro: H:2105+H:2106 Int16 Unità: hours numeric

Ore di funzionamento compressore

Lettura
MODBUSR(H, 2105, Int16) * 1000 + MODBUSR(H, 2106, Int16)
Avviamenti compressore Variabile Solo lettura

Numero totale avviamenti compressore (valore composito da due registri)

Registro: H:2103+H:2104 Int16 Unità: count numeric

Avviamenti compressore

Lettura
MODBUSR(H, 2103, Int16) * 1000 + MODBUSR(H, 2104, Int16)
Pressione aspirazione compressore Ingresso analogico Solo lettura

Pressione di aspirazione del refrigerante — richiede configurazione manuale del readscript

Registro: H:2093 Int16 Unità: bar numeric

Pressione aspirazione compressore

Lettura livello ingresso
MODBUSR(H, 2093, Int16) / 100
Temperatura aspirazione compressore Sensore di temperatura Solo lettura

Temperatura della linea di aspirazione del refrigerante

Registro: H:2092 Int16 Unità: °C numeric

Temperatura aspirazione compressore

Lettura temperatura
MODBUSR(H, 2092, Int16) / 10
Temperatura di condensazione Sensore di temperatura Solo lettura

Temperatura di condensazione del refrigerante

Registro: H:2099 Int16 Unità: °C numeric

Temperatura di condensazione

Lettura temperatura
MODBUSR(H, 2099, Int16) / 10
Temperatura serbatoio buffer raffrescamento Sensore di temperatura Solo lettura

Temperatura dell'acqua nel serbatoio buffer raffrescamento

Registro: H:2133 Int16 Unità: °C numeric

Temperatura serbatoio buffer raffrescamento

Lettura temperatura
MODBUSR(H, 2133, Int16) / 10
Temperatura serbatoio buffer raffrescamento (duplicato) Sensore di temperatura Solo lettura

Duplicato della temperatura serbatoio buffer raffrescamento — stesso registro H:2133

Registro: H:2133 Int16 Unità: °C numeric

Temperatura serbatoio buffer raffrescamento (duplicato)

Lettura temperatura
MODBUSR(H, 2133, Int16) / 10
Modalità produzione ACS Contatto reed Solo lettura

Stato produzione acqua calda sanitaria — ACCESO quando l'ACS è in riscaldamento

Registro: H:2030 Bool

Modalità produzione ACS

Lettura
MODBUSR(H, 2030, Bool)
Temperatura ricircolo ACS Sensore di temperatura Solo lettura

Temperatura del circuito di ricircolo dell'acqua calda sanitaria

Registro: H:2131 Int16 Unità: °C numeric

Temperatura ricircolo ACS

Lettura temperatura
MODBUSR(H, 2131, Int16) / 10
Potenza ACS Variabile Solo lettura

Potenza in uscita istantanea del servizio ACS

Registro: H:2188 Int16 Unità: kW numeric

Potenza ACS

Lettura
MODBUSR(H, 2188, Int16) / 1000
Setpoint ACS Sensore di temperatura Solo lettura

Temperatura target attuale dell'acqua calda sanitaria

Registro: H:2150 Int16 Unità: °C numeric

Setpoint ACS

Lettura temperatura
MODBUSR(H, 2150, Int16) / 10
Temperatura serbatoio ACS Sensore di temperatura Solo lettura

Temperatura del serbatoio dell'acqua calda sanitaria

Registro: H:2130 Int16 Unità: °C numeric

Temperatura serbatoio ACS

Lettura temperatura
MODBUSR(H, 2130, Int16) / 10
Modalità asciugatura pavimento Contatto reed Solo lettura

Stato programma asciugatura pavimento — ACCESO quando asciugatura attiva

Registro: C:2036 Bool

Modalità asciugatura pavimento

Lettura
MODBUSR(C, 2036, Bool)
Consumo elettrico in modalità surplus Contatore elettrico Solo lettura

Consumo elettrico durante la modalità surplus (fotovoltaico)

Registro: H:2194 Int16 Unità: kW numeric

Consumo elettrico in modalità surplus

Lettura domanda
MODBUSR(H, 2194, Int16) / 1000
Temperatura di evaporazione Sensore di temperatura Solo lettura

Temperatura di evaporazione del refrigerante

Registro: H:2098 Int16 Unità: °C numeric

Temperatura di evaporazione

Lettura temperatura
MODBUSR(H, 2098, Int16) / 100
Resistenza ausiliaria esterna (Aux 2) Contatto reed Solo lettura

Stato della resistenza ausiliaria esterna generica

Registro: C:2047 Bool

Resistenza ausiliaria esterna (Aux 2)

Lettura
MODBUSR(C, 2047, Bool)
Setpoint raffrescamento gruppo 1 Sensore di temperatura Solo lettura

Setpoint di raffrescamento finale per il gruppo zona 1

Registro: H:2156 Int16 Unità: °C numeric

Setpoint raffrescamento gruppo 1

Lettura temperatura
MODBUSR(H, 2156, Int16) / 10
Setpoint riscaldamento gruppo 1 Sensore di temperatura Solo lettura

Setpoint di riscaldamento finale per il gruppo zona 1

Registro: H:2155 Int16 Unità: °C numeric

Setpoint riscaldamento gruppo 1

Lettura temperatura
MODBUSR(H, 2155, Int16) / 10
Stato pompa di calore Interruttore multivalore Solo lettura

Stato operativo della pompa di calore — SPENTO, ACCESO o EMERGENZA

Registro: H:2045 Int16 multi-value
Valori / Stati: OFF · ON · EMERGENCY

Stato pompa di calore

Lettura stato interruttore
MODBUSR(H, 2045, Int16)
Temperatura serbatoio buffer riscaldamento Sensore di temperatura Solo lettura

Temperatura dell'acqua nel serbatoio buffer riscaldamento

Registro: H:2132 Int16 Unità: °C numeric

Temperatura serbatoio buffer riscaldamento

Lettura temperatura
MODBUSR(H, 2132, Int16) / 10
Temperatura serbatoio buffer riscaldamento (duplicato) Sensore di temperatura Solo lettura

Duplicato con conversione /100 errata — usare la voce primaria

Registro: H:2132 Int16 Unità: °C numeric

Temperatura serbatoio buffer riscaldamento (duplicato)

Lettura temperatura
MODBUSR(H, 2132, Int16) / 100
Modalità produzione riscaldamento Contatto reed Solo lettura

Stato produzione riscaldamento — ACCESO quando il riscaldamento è attivo

Registro: H:2031 Bool

Modalità produzione riscaldamento

Lettura
MODBUSR(H, 2031, Bool)
Potenza riscaldamento Variabile Solo lettura

Potenza in uscita istantanea del servizio di riscaldamento

Registro: H:2187 Int16 Unità: kW numeric

Potenza riscaldamento

Lettura
MODBUSR(H, 2187, Int16) / 1000
Setpoint HTR Sensore di temperatura Solo lettura

Temperatura target del circuito radiatori alta temperatura

Registro: H:2154 Int16 Unità: °C numeric

Setpoint HTR

Lettura temperatura
MODBUSR(H, 2154, Int16) / 10
Potenza istantanea Variabile Solo lettura

Potenza in uscita totale istantanea del riscaldamento

Registro: H:2186 Int16 Unità: kW numeric

Potenza istantanea

Lettura
MODBUSR(H, 2186, Int16) / 1000
Resistenza ausiliaria integrata (Aux 1) Contatto reed Solo lettura

Stato della resistenza elettrica di backup integrata

Registro: C:2046 Bool

Resistenza ausiliaria integrata (Aux 1)

Lettura
MODBUSR(C, 2046, Bool)
Temperatura inverter Sensore di temperatura Solo lettura

Temperatura dell'elettronica dell'inverter del compressore

Registro: H:2097 Int16 Unità: °C numeric

Temperatura inverter

Lettura temperatura
MODBUSR(H, 2097, Int16) / 10
Programma operativo Interruttore multivalore Solo lettura

Programma operativo della pompa di calore — Inverno, Estate o Combinato

Registro: H:2044 Int16 multi-value
Valori / Stati: Winter · Summer · Combined

Programma operativo

Lettura stato interruttore
MODBUSR(H, 2044, Int16)
Temperatura esterna Sensore di temperatura Solo lettura

Temperatura ambiente esterna con allarmi di sicurezza gelo/surriscaldamento

Registro: H:2080 Int16 Unità: °C numeric

Temperatura esterna

Lettura temperatura
MODBUSR(H, 2080, Int16) / 10
Modalità raffrescamento passivo Contatto reed Solo lettura

Stato produzione raffrescamento passivo (gratuito) — raffrescamento senza compressore

Registro: H:2033 Bool

Modalità raffrescamento passivo

Lettura
MODBUSR(H, 2033, Bool)
Potenza raffrescamento passivo Variabile Solo lettura

Potenza in uscita istantanea del servizio di raffrescamento passivo

Registro: H:2192 Int16 Unità: kW numeric

Potenza raffrescamento passivo

Lettura
MODBUSR(H, 2192, Int16) / 1000
Modalità produzione piscina Contatto reed Solo lettura

Stato produzione riscaldamento piscina — ACCESO quando la piscina è in riscaldamento

Registro: H:2034 Bool

Modalità produzione piscina

Lettura
MODBUSR(H, 2034, Bool)
Variabile dashboard Variabile Solo lettura

Variabile dispositivo dashboard Ecoforest — valore diagnostico specifico del firmware

Registro: H:6148 Int16 numeric

Variabile dashboard

Lettura
MODBUSR(H, 6148, Int16)
Temperatura ingresso circuito primario Sensore di temperatura Solo lettura

Temperatura di ingresso acqua nel circuito lato sorgente

Registro: H:2082 Int16 Unità: °C numeric

Temperatura ingresso circuito primario

Lettura temperatura
MODBUSR(H, 2082, Int16) / 10
Temperatura uscita circuito primario Sensore di temperatura Solo lettura

Temperatura di uscita acqua nel circuito lato sorgente

Registro: A:2081 Int16 Unità: °C numeric

Temperatura uscita circuito primario

Lettura temperatura
MODBUSR(A, 2081, Int16) / 10
Pressione circuito primario Ingresso analogico Solo lettura

Pressione acqua nel circuito lato sorgente — richiede configurazione manuale del readscript

Registro: H:2083 Int16 Unità: bar numeric

Pressione circuito primario

Lettura livello ingresso
MODBUSR(H, 2083, Int16) / 100
Temperatura ingresso circuito secondario Sensore di temperatura Solo lettura

Temperatura di ingresso acqua nel circuito lato utenza

Registro: H:2085 Int16 Unità: °C numeric

Temperatura ingresso circuito secondario

Lettura temperatura
MODBUSR(H, 2085, Int16) / 10
Temperatura uscita circuito secondario Sensore di temperatura Solo lettura

Temperatura di uscita acqua nel circuito lato utenza

Registro: H:2084 Int16 Unità: °C numeric

Temperatura uscita circuito secondario

Lettura temperatura
MODBUSR(H, 2084, Int16) / 10
Pressione circuito secondario Ingresso analogico Solo lettura

Pressione acqua nel circuito lato utenza — richiede configurazione manuale del readscript

Registro: H:2086 Int16 Unità: bar numeric

Pressione circuito secondario

Lettura livello ingresso
MODBUSR(H, 2086, Int16) / 100
Surriscaldamento Sensore di temperatura Solo lettura

Surriscaldamento del refrigerante (temperatura aspirazione meno temperatura evaporazione)

Registro: H:2096 Int16 Unità: °C numeric

Surriscaldamento

Lettura temperatura
MODBUSR(H, 2096, Int16) / 10
Potenza totale raffrescamento Variabile Solo lettura

Potenza in uscita totale istantanea del raffrescamento

Registro: H:2190 Int16 Unità: kW numeric

Potenza totale raffrescamento

Lettura
MODBUSR(H, 2190, Int16) / 1000
Consumo elettrico totale Contatore elettrico Solo lettura

Consumo elettrico istantaneo totale

Registro: H:2193 Int16 numeric

Consumo elettrico totale

Lettura domanda
MODBUSR(H, 2193, Int16)
Temperatura serbatoio ACS (duplicato slovacco) Sensore di temperatura Solo lettura

Duplicato della temperatura serbatoio ACS con nome slovacco — stesso registro H:2130

Registro: H:2130 Int16 Unità: °C numeric

Temperatura serbatoio ACS (duplicato slovacco)

Lettura temperatura
MODBUSR(H, 2130, Int16) / 10
Connessione: Modbus RTU • 19200 baud• 8N2 • Slave ID: $[SlaveId]
Possibili miglioramenti (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

Fonti

  • 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