TapHome

Gree U-Match Aria Condizionata

Modbus TCP
Submitted by
Last updated: 03. 2026

Richiede gateway esterno

Gree / TD metal Modbus Gateway (TD GUD 30/01) or Modbus Gateway(Mini) ME30-24/E6(M)

Gree U-Match Aria Condizionata

La serie Gree U-Match comprende unità di climatizzazione commerciali/residenziali (canalizzate, a cassetta, a pavimento/soffitto) con refrigerante R32. TapHome si connette a ciascuna unità interna tramite Modbus RTU su RS-485, utilizzando il Gree Modbus Gateway (TD GUD 30/01 o Mini ME30-24/E6) installato all’interno dell’unità interna.

Il template fornisce controllo accensione/spegnimento, selezione modalità operativa (raffreddamento, riscaldamento, deumidificazione, solo ventilatore, automatico), regolazione del setpoint del termostato, controllo velocità ventilatore (automatico, 5 velocità, turbo), alette verticali e orizzontali, e monitoraggio della temperatura ambiente e esterna.

Abilitare la comunicazione Modbus

Prima che TapHome possa comunicare con l’unità interna, è necessario attivare Modbus tramite il controller cablato XK117 (Z4K351GJ).

Attivazione Modbus sull’unità interna
  1. Con l’unità in stato SPENTO, tenere premuti i tasti FUNCTION e TIMER per più di 5 secondi per accedere al menu impostazioni
Controller cablato Gree XK117 in stato SPENTO — tenere premuti FUNCTION e TIMER per accedere alle impostazioni
  1. Premere più volte MODE per raggiungere il 10° parametro impostazioni (numero centrale), usare i tasti freccia per selezionare l’opzione 01 e confermare premendo SWING/ENTER
Controller cablato Gree XK117 — selezione del 10° parametro valore 01 e conferma con SWING/ENTER
Impostazione dell’indirizzo dell’unità interna

Quando più gateway condividono lo stesso bus RS-485, ogni unità interna deve avere un indirizzo univoco. In caso contrario, mantenere l’indirizzo predefinito 1.

  1. Con l’unità in stato SPENTO, tenere premuti i tasti FUNCTION e MODE per più di 5 secondi
Controller cablato Gree XK117 in stato SPENTO — tenere premuti FUNCTION e MODE per impostazione indirizzo
  1. Usare i tasti freccia per scegliere l’indirizzo dell’unità e confermare premendo SWING/ENTER
Controller cablato Gree XK117 — selezione indirizzo unità e conferma con SWING/ENTER

Collegamento hardware

Ogni unità interna richiede il proprio modulo Modbus Gateway. Il gateway si collega alla scheda dell’unità interna tramite il cavo di comunicazione a 6 pin in dotazione e fornisce un’interfaccia RS-485 per il bus Modbus.

Gateway all’unità interna
  1. Inserire il cavo di comunicazione a 6 pin nella presa marrone-rossa etichettata COM-BMS (connettore 9) sulla scheda dell’unità interna
Scheda principale dell'unità interna canalizzata Gree — posizione del socket COM-BMS per collegamento Modbus Gateway
  1. Collegare l’altra estremità alla presa del Modbus Gateway etichettata UNIT
Modulo Gree Modbus Gateway (Mini) — socket UNIT e terminali RS-485 (A, B, GND)
Cablaggio bus RS-485

Collegare TapHome Core ai terminali RS-485 del gateway:

TerminaleFunzione
ARS-485 Data+
BRS-485 Data-
GNDMassa segnale

Una coppia intrecciata collega A e B, il/i conduttore/i rimanente/i collegano GND.

Cablaggio coppia intrecciata RS-485 ai terminali A+, B- e GND sul Gree Modbus Gateway
  • Cavo: Coppia intrecciata schermata, 0,2–0,32 mm² (24–22 AWG), conforme EIA-485 (es. Belden 3016A)
  • Topologia: Solo bus (daisy-chain) — topologie a stella, anello o triangolo non sono supportate
  • Lunghezza max: 500 metri
  • Terminazione: Resistenza da 120 ohm tra A e B sul primo e sull’ultimo dispositivo del bus
  • Schermatura: Collegare lo schermo del cavo alla messa a terra dello chassis su un solo lato (preferibilmente sull’unità interna più esterna)
Topologia bus RS-485 daisy-chain con schermatura messa a terra su un'estremità

Il bus RS-485 deve utilizzare una topologia a bus (daisy-chain). Il cablaggio a stella, anello o triangolo causerà guasti di comunicazione.

Configurazione

  • Protocollo: Modbus RTU (incapsulato in Modbus TCP da TapHome)
  • Baud rate: 9 600 bit/s
  • Bit dati: 8, parità: nessuna, bit di stop: 1
  • Slave ID predefinito: 1

Durante l’importazione del template in TapHome, fornire:

  • Indirizzo IP — l’indirizzo del gateway TapHome Modbus TCP
  • Slave ID — indirizzo Modbus slave dell’unità interna (predefinito: 1)

Quando si controllano più unità interne, ogni gateway deve avere un indirizzo slave univoco. Impostare l’indirizzo tramite il controller cablato prima di collegarsi al bus.

Funzionalità del dispositivo

Il template espone i seguenti dispositivi:

Controllo alimentazione
  • Accensione/Spegnimento — interruttore per accendere o spegnere l’unità di climatizzazione. Utilizza il registro H:2 con valori non standard: 0xAA = ACCESO, 0x55 = SPENTO.
Modalità operativa
  • Modalità (interruttore multi-valore) — selezionare tra: Raffreddamento, Riscaldamento, Deumidificazione, Solo Ventilatore, Automatico. Utilizza il registro H:17 (UInt16). Le modalità disponibili dipendono dalle capacità dell’unità esterna — ad esempio, se l’unità esterna supporta solo il raffreddamento, le modalità di riscaldamento saranno inefficaci.
Termostato
  • Termostato — legge la temperatura ambiente interna dal registro H:4 (valore / 10) e legge/scrive il setpoint di temperatura desiderato nel registro H:20. Intervallo: 16–30 °C.
Velocità ventilatore
  • Velocità ventilatore (interruttore multi-valore) — impostare la velocità ventilatore tramite il registro H:19: Automatico, Velocità 1–5 o Turbo. In modalità deumidificazione, la bassa velocità del ventilatore è obbligatoria. Il Turbo è disponibile solo nelle modalità raffreddamento/riscaldamento.
Controllo alette
  • Alette verticali — attivare/disattivare l’oscillazione su-giù tramite il registro H:22. L’azione di servizio “Imposta alette verticali” fornisce un controllo più preciso a 11 posizioni (0–11).
  • Alette orizzontali — attivare/disattivare l’oscillazione sinistra-destra tramite il registro H:23. L’azione di servizio “Imposta alette orizzontali” fornisce un controllo più preciso a 8 posizioni (0–8).
Monitoraggio temperatura
RegistroSensoreDescrizioneNel template
H:4Temperatura ambienteTemperatura ambiente (valore / 10)Sì
H:49EsternaTemperatura esterna (codifica bit di segno)Sì
Word 115Uscita ariaTemperatura aria mandata (valore + offset 100)No
Attributi di servizio

Il template espone anche attributi diagnostici leggibili nella vista di servizio di TapHome:

AttributoRegistroDescrizione
IDU Addr.H:5Indirizzo unità interna sul bus gateway
Stato valvola aria frescaH:24Apertura/chiusura valvola aria fresca
Modalità sleepH:25Stato modalità sleep (0=spento, 1=acceso)
Grado contaminazioneH:34Livello contaminazione filtro
Selezione sensore temperatura ambienteH:39Sensore temperatura ambiente attivo
Funzione DREDH:77Stato del dispositivo di abilitazione risposta alla domanda (DRED)
Temperatura aria di ritornoH:82Temperatura alla porta di ritorno aria
Temperatura scheda luminosaH:83Sensore temperatura scheda luminosa
Funzionalità aggiuntive

Il protocollo Gree Modbus espone anche registri per limiti di risparmio energetico (limiti di temperatura per raffreddamento/riscaldamento/deumidificazione), modalità silenziosa, modalità sleep, riscaldamento a 8 °C (modalità assenza), X-Fan e reset pulizia filtro. Questi possono essere aggiunti al template TapHome in un futuro aggiornamento.

Risoluzione dei problemi

Nessuna comunicazione Modbus
  1. Verificare che la comunicazione Modbus sia stata attivata sull’unità interna tramite il controller cablato XK117 (10° parametro impostato su 01)
  2. Controllare il cablaggio RS-485: i terminali A, B e GND devono essere collegati correttamente
  3. Confermare che il baud rate sia impostato a 9 600 in TapHome
  4. Assicurarsi che lo Slave ID in TapHome corrisponda all’indirizzo configurato sull’unità interna
Le modifiche alla modalità non vengono applicate

La modalità operativa dell’unità esterna ha la precedenza. Se l’unità esterna supporta solo il raffreddamento, l’impostazione della modalità di riscaldamento tramite Modbus sarà inefficace. Il codice errore 0x04 indica un guasto di comunicazione tra il gateway e l’unità interna — verificare il collegamento del cavo a 6 pin alla presa COM-BMS.

Il setpoint di temperatura viene ignorato

Quando la funzione di risparmio energetico è abilitata, i comandi di temperatura al di fuori dei limiti configurati verranno rifiutati. Verificare i limiti di temperatura del risparmio energetico (Word 106–108) o disabilitare il risparmio energetico tramite i controlli dell’unità interna.

Dispositivi disponibili

Gree U-Match AC Modulo
Attributi di servizio
Indirizzo IDUindirizzo dell'unità interna sul bus del gateway
Stato valvola aria frescastato apertura/chiusura della valvola aria fresca
Modalità notturnasleep mode status; 0=off, 1=on (protocol Bit 301)
Grado di contaminazionegrado di contaminazione del filtro
Selezione sensore temperatura ambientequale sensore di temperatura ambiente è attivo
Funzione DREDstato della funzione dispositivo di risposta alla domanda (DRED)
Temperatura ambiente alla porta di ritorno ariareturn air temperature; value multiplied by 10 in script (raw x10)
Temperatura ambiente della scheda luminosalight board temperature sensor; value multiplied by 10 in script (raw x10)
Oscillazione su e giùup-down swing position readback (multi-value); mirrors device #7
Oscillazione sinistra e destraleft-right swing position readback (multi-value); mirrors device #6
Azioni di servizio
Impostare oscillazione su e giùset vertical swing to specific position; parameter \'val\' 0–11 maps to binary position codes (0000–1011)
Impostare oscillazione sinistra e destraset horizontal swing to specific position; parameter \'val\' 0–8 maps to binary position codes (0000–1101)

Gree_AC

Attributi di servizio
IDU Addr.
modbusr(H,5,uint16)
Fresh air valve status
modbusr(H,24,uint16)
Sleep mode
modbusr(H,25,uint16)
Contamination grade
modbusr(H,34,uint16)
Selection of ambient temp sensor
modbusr(h,39,uint16)
DRED function
modbusr(h,77,uint16)
Ambient temp at the port of air return
modbusr(h,82,int16)*10
Ambient temp of light board
modbusr(h,83,int16)*10
Up & down swing
modbusr(h,22,uint16)
Left & right swing
modbusr(h,23,uint16)
Azioni di servizio
Set up & down swing
Parametri: value (0–11 val)
modbusw(h,22, uint16, switch(val, 1, "0001",
2,"0010",
3, "0011",
4,"0100",
5, "0101",
6, "0110",
7,"0111",
8,"1000",
9, "1001",
10, "1010",
11, "1011",
"0000"))
Set left & right swing
Parametri: value (0–8 val)
modbusw(h,22, uint16, switch(val, 1, "0001",
2,"0010",
3, "0011",
4,"0100",
5, "0101",
6, "0110",
7,"1100",
8,"1101",
"0000"))
Temperatura ambiente Sensore di temperatura Solo lettura

Temperatura ambiente interno — valore diviso per 10

Registro: H:4 UInt16 Unità: °C numeric

Temperatura ambiente

Lettura temperatura
var v := MODBUSR(H, 4, UInt16);

if (GETBIT(v,15))
    RETURN ((-(V & 0x7FFF))/10);
ELSE
    return(v/10);
END
Velocità ventilatore Interruttore multivalore

Selettore velocità ventilatore — Auto, Velocità 1–5, Turbo

Registro: H:19 UInt16 numeric
Valori / Stati: Automatico · Velocità 1 · Velocità 2 · Velocità 3 · Velocità 4 · Velocità 5 · Turbo

Velocità ventilatore

Lettura stato interruttore
MODBUSR(H, 19, UInt16)
Scrittura stato interruttore
MODBUSWNE(H, 19, UInt16, Mu)
Modalità Interruttore multivalore

Selettore modalità operativa — Raffreddamento, Riscaldamento, Deumidificazione, Solo ventilatore, Automatico

Registro: H:17 UInt16 numeric
Valori / Stati: Raffreddamento · Raffreddamento · Riscaldamento · Deumidificazione · Solo ventilatore · Automatico

Modalità

Lettura stato interruttore
MODBUSR(H, 17, UInt16)
Scrittura stato interruttore
MODBUSWNE(H, 17, UInt16, Mu)
Temperatura esterna Sensore di temperatura Solo lettura

Temperatura ambiente esterna con codifica bit di segno

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

Temperatura esterna

Lettura temperatura
var v := MODBUSR(H, 49, Int16);

if (GETBIT(v,15))
    RETURN (-(V & 0x7FFF));
ELSE
    return(v);
END
Accensione/Spegnimento Interruttore

Interruttore principale — 0xAA=ACCESO, 0x55=SPENTO

Registro: H:2 UInt16 numeric

Accensione/Spegnimento

Lettura stato interruttore
SWITCH(MODBUSR(H, 2, UInt16), 85,0,170,1,0)
Scrittura stato interruttore
MODBUSWNE(H, 2, UInt16, SWITCH(St, 0,85,1,170,85))
Termostato Termostato

Setpoint temperatura 16–30 °C con lettura temperatura ambiente interno

Registro: H:4 (current), H:20 (desired) → H:20 UInt16 Unità: °C numeric

Termostato

Lettura temperatura
MODBUSR(H, 4, UInt16) / 10
Lettura temperatura desiderata
MODBUSR(H, 20, UInt16)
Scrittura temperatura desiderata
MODBUSWNE(H, 20, UInt16, Se)
Alette orizzontali Interruttore

Oscillazione aria sinistra-destra — azione di servizio per controllo a 8 posizioni

Registro: H:23 Int16 numeric
Valori / Stati: SWING · OFF

Alette orizzontali

Lettura stato interruttore
MODBUSR(H, 23, int16)
Scrittura stato interruttore
MODBUSW(H, 23, int16, St)
Alette verticali Interruttore

Oscillazione aria su-giù — azione di servizio per controllo a 11 posizioni

Registro: H:22 Int16 numeric
Valori / Stati: SWING · OFF

Alette verticali

Lettura stato interruttore
MODBUSR(H, 22, int16)
Scrittura stato interruttore
MODBUSW(H, 22, int16, St)
Connessione: Modbus TCP • Slave ID: $[SlaveId]
Possibili miglioramenti (14)
  • Word 106 Lower Limit Temp of Cooling Energy Saving — UInt16, value x10, range 16.0–30.0°C, R/W
  • Word 107 Upper Limit Temp of Heating Energy Saving — UInt16, value x10, range 16.0–30.0°C, R/W
  • Word 108 Lower Limit Temp of Dehumidifying Energy Saving — UInt16, value x10, range 16.0–30.0°C, R/W
  • Word 115 Air Outlet Temperature — UInt16, value + 100, range -30 to 138°C, read-only
  • Word 117 Gate Control Status — UInt16, 0=invalid, 1=without, 2=insert card, 3=disconnect card
  • Word 119 Category of Indoor Unit Model — UInt16, 1=Duct, 2=Cassette, 3=Wall, 4=Floor ceiling, etc.
  • Word 123 Rated Capacity of Indoor Unit — UInt16, hectowatt, read-only
  • Bit 296 Energy Saving — Coil, 0=off, 1=on, R/W
  • Bit 300 Dry Mode — Coil, 0=off, 1=on, R/W
  • Bit 301 Sleep Mode (coil) — Coil, 0=off, 1=on, R/W — currently read-only via service attribute
  • Bit 302 Quiet Mode — Coil, 0=off, 1=on, R/W
  • Bit 303 Ventilation — Coil, 0=off, 1=on, R/W
  • Bit 308 8°C Heating Function — Coil, 0=cancel, 1=start, R/W
  • Word 3302 Upper Limit Capacity of Outdoor Unit — UInt16, 30–100%, R/W, system-level
Scarica template

Fonti