TapHome

Mitsubishi Ecodan EHST20C

Modbus TCP
Submitted by
Last updated: 03. 2026

Richiede gateway esterno

Procon MelcoBEMS MINI (A1M) — pagina prodotto

Il Mitsubishi EHST20C è un’unità con accumulo della pompa di calore Ecodan aria-acqua (ATW). Non dispone di un’interfaccia Modbus nativa — la comunicazione con TapHome richiede il gateway Procon MelcoBEMS MINI (A1M), che si collega internamente all’unità interna Ecodan e rende disponibili gli holding register tramite Modbus TCP (Ethernet, porta 502).

Il template TapHome copre il controllo accensione/spegnimento del sistema, la modalità vacanza, lo stato del riscaldamento, il monitoraggio delle temperature di zona e dell’acqua, la misurazione dell’energia e la portata. La disponibilità dei registri dipende dalla versione del controller FTC installato — l’EHST20C utilizza tipicamente FTC4 o FTC5.

Collegamento hardware

Panoramica del gateway

Il Procon MelcoBEMS MINI (A1M) è un gateway BMS dedicato per i sistemi Mitsubishi Ecodan. Si collega al connettore CN105 dell’unità interna e fornisce interfacce Modbus TCP (Ethernet) e Modbus RTU (RS-485). Il template TapHome utilizza l’interfaccia Modbus TCP.

Il gateway espone tutti i registri Discrete, Coil e Input come Holding Register. Alcuni registri sono in sola lettura; i registri scrivibili accettano il codice funzione 06 (scrittura singola) o 16 (scrittura multi-registro).

Connessione di rete

Collegare il gateway MelcoBEMS MINI alla stessa rete di TapHome Core utilizzando un cavo Ethernet standard.

Impostazioni predefinite di fabbrica:

  • Indirizzo IP: 192.168.92.114
  • Maschera di sottorete: 255.255.255.0
  • Porta Modbus TCP: 502
  • Slave ID: 1 (configurabile tramite registro H:4, intervallo 1–247)

L’indirizzo IP predefinito di fabbrica (192.168.92.114) si trova nella sottorete 192.168.92.x, diversa dalla maggior parte delle reti domestiche (tipicamente 192.168.0.x o 192.168.1.x). Potrebbe essere necessario modificare temporaneamente l’IP del computer a 192.168.92.x per accedere al gateway e riconfigurare le impostazioni di rete, oppure configurare il router per instradare il traffico verso questa sottorete.

Il MelcoBEMS MINI non supporta mDNS. Si consiglia di assegnare un indirizzo IP statico o creare una prenotazione DHCP nel router per evitare che l’IP del gateway cambi.

Configurazione

Connessione Modbus TCP in TapHome
  1. Aprire TapHome e andare in Impostazioni → Moduli
  2. Aggiungere un nuovo dispositivo Modbus TCP
  3. Inserire l’indirizzo IP del gateway (predefinito: 192.168.92.114) e la porta 502
  4. Impostare lo Slave ID su 1 (predefinito) — o il valore configurato sul gateway
  5. Importare il template Mitsubishi EHST20C
Configurazione Slave ID

Lo Slave ID Modbus predefinito è 1. Può essere modificato scrivendo un valore (1–247) nell’holding register H:4 sul gateway. Dopo aver modificato lo Slave ID, aggiornare la configurazione del modulo TapHome di conseguenza.

Configurazione RS-485 (solo come riferimento)

Il MelcoBEMS MINI espone anche registri di configurazione RS-485. Questi sono rilevanti solo se si utilizza l’interfaccia RS-485 (non utilizzata da questo template):

RegistroParametroPredefinitoOpzioni
H:5Baud Rate96001200, 2400, 4800, 9600, 14400, 19200, 28800, 38400, 56000, 57600, 115200
H:6ParitàNoneNone, Even, Odd

Funzionalità del dispositivo

Controllo del sistema
  • Sistema ON/OFF (H:25) — accende o spegne il sistema della pompa di calore. Il registro riporta anche due valori di stato in sola lettura: 2 (marcia di emergenza) e 3 (marcia di prova), che possono apparire durante condizioni operative speciali. La scrittura utilizza MODBUSWNE (scrittura se diverso) per evitare traffico bus non necessario.
  • Modalità vacanza (H:38) — attiva la modalità vacanza, che riduce il riscaldamento ACS e mantiene la protezione antigelo mentre l’edificio è non occupato. La scrittura utilizza MODBUSWNE.
Stato del riscaldamento

Stato del riscaldamento (H:72) è un indicatore multi-valore in sola lettura che mostra l’attività corrente del circuito di riscaldamento:

ValoreFTC4FTC5/FTC6
0Nessun tipoNessun tipo
1Riscaldamento C1H/C A1 B1 C1
2Riscaldamento C2H/C A2 B2 C2
3Riscaldamento C3H/C A3 B3 C3

Sui controller FTC5/FTC6, i valori estesi riflettono stati combinati dei circuiti di riscaldamento/raffrescamento. Il template definisce i valori 0–9, ma i valori 4–9 sono segnaposti non definiti riservati per uso futuro.

Monitoraggio delle temperature

Il template fornisce tre sensori di temperatura che leggono dagli holding register con conversione automatica °C × 100 (lo script ReadTemperature divide per 100):

  • Temperatura ambiente zona 1 (H:94) — temperatura ambiente misurata dal sensore della zona 1. Il template utilizza la variante unsigned del registro; la variante signed è disponibile a H:93.
  • Temperatura di mandata (H:102) — temperatura dell’acqua in uscita dalla pompa di calore verso l’impianto di riscaldamento. Nelle tabelle dei registri indicata anche come “Water Outlet Temperature”. La variante signed è disponibile a H:101.
  • Temperatura di ritorno (H:104) — temperatura dell’acqua di ritorno dall’impianto di riscaldamento alla pompa di calore. Nelle tabelle dei registri indicata anche come “Water Inlet Temperature”. La variante signed è disponibile a H:103.

Tutti e tre i sensori utilizzano un intervallo di polling di 15 secondi.

Misurazione dell’energia
  • Energia totale prodotta (H:298) — energia totale cumulativa prodotta dalla pompa di calore in kWh (riscaldamento + raffrescamento + ACS combinati). Intervallo 0–65.535 kWh. Disponibile solo su sistemi FTC4/FTC5.
  • Data misurazione energia — tre registri forniscono il timestamp dell’ultima misurazione energetica: Anno (H:279), Mese (H:280) e Giorno (H:281).
  • Portata (H:299) — portata dell’acqua in l/min (intervallo 0–255). Disponibile solo su sistemi FTC4/FTC5.
Funzionalità aggiuntive

Il sistema Ecodan tramite il gateway MelcoBEMS MINI espone un set completo di registri oltre a quelli implementati nel template corrente. I registri disponibili includono la selezione della modalità operativa (Stop, Acqua calda, Riscaldamento, Raffrescamento, Antigelo, Legionella, Riscaldamento-Eco), il controllo della modalità ACS (Normale/Eco), i setpoint di temperatura della zona 1 e zona 2 per riscaldamento/raffrescamento, ACS forzata, setpoint e lettura temperatura dell’accumulo, temperatura esterna (scala °C × 10), stato sbrinamento (Normale/Standby/Sbrinamento/Attesa riavvio), frequenza compressore della pompa di calore (0–255 Hz), stato della fonte di calore (Pompa di calore/Resistenza a immersione/Riscaldatore ausiliario/Caldaia), codici di guasto ed errore (hex e decimale), e dettagliate ripartizioni del consumo energetico (riscaldamento, raffrescamento, ACS separatamente con precisione kWh e Wh). Queste possono essere aggiunte in un futuro aggiornamento del template.

Il registro della modalità operativa (H:26) e i setpoint di temperatura delle zone (H:32, H:34) non sono inclusi nel template corrente, ma sono fondamentali per il controllo HVAC completo. Possono essere aggiunti come dispositivi Modbus personalizzati in TapHome utilizzando gli indirizzi dei registri sopra elencati. I registri dei setpoint di temperatura utilizzano codifica °C × 100.

Risoluzione dei problemi

Nessuna comunicazione Modbus
  1. Verificare che il gateway MelcoBEMS MINI sia acceso e collegato alla rete
  2. Controllare che TapHome Core e il gateway siano nella stessa sottorete di rete — l’IP predefinito di fabbrica 192.168.92.x potrebbe non corrispondere alla rete domestica
  3. Confermare l’indirizzo IP e la porta (502) nelle impostazioni del modulo TapHome
  4. Verificare che lo Slave ID corrisponda alla configurazione del gateway (predefinito: 1)
  5. Leggere il registro H:11 per verificare la versione firmware del gateway — questo conferma che la comunicazione Modbus TCP di base funziona
Il gateway segnala comunicazione errata (codice errore 0x6999)

Il codice errore 0x6999 (o decimale 6999) nel registro H:9 indica che il MelcoBEMS MINI non riesce a comunicare con l’unità interna Ecodan.

  1. Controllare il collegamento del cavo CN105 tra il gateway e l’unità interna
  2. Verificare che l’unità interna sia accesa
  3. Leggere il registro H:13 per il tipo di sistema rilevato — dovrebbe mostrare 1 (ATW). Un valore di 255 (indeterminato) indica che il gateway non ha stabilito la comunicazione con l’unità
Le letture di temperatura mostrano valori errati

Tutti i registri di temperatura in questo template utilizzano un fattore di scala di °C × 100 (lo script ReadTemperature divide automaticamente per 100). La temperatura esterna (H:99, non nel template) utilizza un fattore di scala diverso di °C × 10. I dispositivi Modbus personalizzati per registri non inclusi nel template richiedono una configurazione manuale della scala.

I registri dell’energia mostrano zero

I registri di misurazione dell’energia (H:279–H:299) sono disponibili solo su sistemi FTC4 e FTC5. Se il sistema utilizza un controller FTC6, questi registri non restituiranno dati validi. Leggere il registro H:270 per identificare il profilo del modello: 1=FTC4, 2=FTC5, 3=FTC6.

Dispositivi disponibili

Mitsubishi EHST20C Modulo
Sistema ON/OFF Interruttore

Controllo alimentazione sistema pompa di calore — ON, OFF, con marcia di emergenza e marcia di prova come valori di stato in sola lettura

Registro: H:25 Bool

Sistema ON/OFF

Lettura stato interruttore
MODBUSR(H, 25, Bool)
Scrittura stato interruttore
MODBUSWNE(H, 25, Bool, St)
Modalità vacanza Interruttore

Attiva la modalità vacanza — riduce il riscaldamento ACS e mantiene la protezione antigelo durante l'assenza

Registro: H:38 Bool

Modalità vacanza

Lettura stato interruttore
MODBUSR(H, 38, Bool)
Scrittura stato interruttore
MODBUSWNE(H, 38, Bool, St)
Stato del riscaldamento Interruttore multivalore Solo lettura

Attività corrente del circuito di riscaldamento — Nessun tipo, Riscaldamento C1, Riscaldamento C2, Riscaldamento C3 (FTC4); modalità H/C estese su FTC5/FTC6

Registro: H:72 Int16 numeric
Valori / Stati: No type · Heating C1 · Heating C2 · Heating C3

Stato del riscaldamento

Lettura stato interruttore
MODBUSR(H, 72, Int16)
Temperatura ambiente zona 1 Sensore di temperatura Solo lettura

Sensore temperatura ambiente zona 1 — utilizza la variante unsigned del registro (H:94)

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

Temperatura ambiente zona 1

Lettura temperatura
MODBUSR(H, 94, Int16) / 100
Temperatura di mandata Sensore di temperatura Solo lettura

Temperatura dell'acqua in uscita dalla pompa di calore verso l'impianto di riscaldamento

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

Temperatura di mandata

Lettura temperatura
MODBUSR(H, 102, Int16) / 100
Temperatura di ritorno Sensore di temperatura Solo lettura

Temperatura dell'acqua di ritorno dall'impianto di riscaldamento alla pompa di calore

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

Temperatura di ritorno

Lettura temperatura
MODBUSR(H, 104, Int16) / 100
Data misurazione energia — giorno Variabile Solo lettura

Componente giorno del timestamp dell'ultima misurazione del consumo energetico

Registro: H:281 Int16 numeric

Data misurazione energia — giorno

Lettura
MODBUSR(H, 281, Int16)
Data misurazione energia — mese Variabile Solo lettura

Componente mese del timestamp dell'ultima misurazione del consumo energetico

Registro: H:280 Int16 numeric

Data misurazione energia — mese

Lettura
MODBUSR(H, 280, Int16)
Data misurazione energia — anno Variabile Solo lettura

Componente anno del timestamp dell'ultima misurazione del consumo energetico

Registro: H:279 Int16 numeric

Data misurazione energia — anno

Lettura
MODBUSR(H, 279, Int16)
Portata Variabile Solo lettura

Portata dell'acqua attraverso il sistema della pompa di calore in litri al minuto

Registro: H:299 Int16 Unità: l/min numeric

Portata

Lettura
MODBUSR(H, 299, Int16)
Energia totale prodotta Variabile Solo lettura

Energia totale cumulativa prodotta — riscaldamento, raffrescamento e ACS combinati (kWh, solo FTC4/FTC5)

Registro: H:298 Int16 Unità: kWh numeric

Energia totale prodotta

Lettura
MODBUSR(H, 298, Int16)
Connessione: Modbus TCP • Slave ID: $[SlaveId]
Possibili miglioramenti (16)
  • H:26 Operating Mode — R/W operating mode: 0=Stop, 1=Hot Water, 2=Heating, 3=Cooling, 5=Freeze Stat, 6=Legionella, 7=Heating-Eco — critical HVAC control missing from template
  • H:27 DHW Mode — R/W DHW operating mode: 0=Normal, 1=Eco
  • H:28 A/C Mode Zone 1 — R/W zone 1 mode: 0=Heating Room, 1=Heating Flow, 2=Heating Curve, 3=Cooling Room, 4=Cooling Flow, 5=Floor Dryup
  • H:29 A/C Mode Zone 2 — R/W zone 2 mode — same values as Zone 1
  • H:30 Tank Water Temperature Setpoint — R/W tank water temperature setpoint (°C × 100, signed). Critical DHW control
  • H:32 H/C Target Temperature Zone 1 — R/W heating/cooling thermostat target temperature Zone 1 (°C × 100, signed)
  • H:34 H/C Target Temperature Zone 2 — R/W heating/cooling thermostat target temperature Zone 2 (°C × 100, signed)
  • H:37 Force DHW — R/W force DHW: 0=Normal, 1=Force DHW
  • H:54 Thermostat Target Temperature Zone 1 — R/W thermostat target temp Zone 1 (°C × 100, signed). Confirmed by HA config
  • H:9 Fault/Error Code — Read-only fault code (hex): 0x8000=No error, 0x6999=Bad communication
  • H:67 Defrost Status — Read-only: 0=Normal, 1=Standby, 2=Defrost, 3=Waiting Restart. Confirmed by HA config
  • H:73 Heat Pump Frequency — Read-only: 0–255 Hz. Compressor frequency indicator. Confirmed by HA config
  • H:80 Heat Source Status — Read-only: 0=H/P, 1=IH, 2=BH, 3=IH+BH, 4=Boiler. Confirmed by HA config
  • H:99 Outdoor Ambient Temperature — Read-only outdoor temp (°C × 10, signed). Range -40.0 to 87.5°C. Confirmed by HA config
  • H:106 Tank Water Temperature — Read-only tank water temp (°C × 100, unsigned). Confirmed by HA config
  • H:288 Total Energy Consumed — Read-only total energy consumed in kWh. Counterpart to Total Energy Produced (H:298)

Fonti

  • Procon MelcoBEMS MINI (A1M) ATW Modbus Register Tables V1.0.4
    PDF
  • Mitsubishi Heat Pump Modbus — Home Assistant Configuration
    github.com 2026-03-18