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.

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

Fase 2 — Abilitazione controllo remoto BUS
Il controllo BUS deve essere esplicitamente abilitato per consentire alla pompa di calore di accettare comandi Modbus:
- Andare a Menu installatore –> c. Installazione (pagina 6/8)
- Selezionare f. Controllo remoto
- Scorrere alla pagina 3/3 del sottomenu Controllo remoto
- Selezionare c. Controllo BUS
- Nella schermata BMS remote control, selezionare la casella Enable

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) / 10dove<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
- Verificare che il controllo BUS sia abilitato: Menu installatore –> Installazione –> Controllo remoto –> Controllo BUS –> Enable deve essere selezionato
- Verificare impostazioni porta BMS2: Il protocollo deve essere “MB Extended”, baud rate 19200, parità None, 2 stop bit
- Verificare Slave ID: Il predefinito è 17 per le pompe di calore — assicurarsi che TapHome sia configurato con l’indirizzo corretto
- 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
- 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:
- Aprire il dispositivo nelle impostazioni servizio TapHome
- Aggiungere ReadScript:
MODBUSR(H, <registro>, Int16) / 10 - 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.
