TapHome

Gree U-Match Klimaanlage

Modbus TCP
Submitted by
Last updated: 03. 2026

Erfordert externes Gateway

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

Gree U-Match Klimaanlage

Die Gree U-Match Serie sind kommerzielle/Wohn-Klimaanlagen (Kanalgerät, Kassette, Boden/Decke) mit R32-Kältemittel. TapHome verbindet sich mit jeder Inneneinheit über Modbus RTU über RS-485 mithilfe des Gree Modbus Gateways (TD GUD 30/01 oder Mini ME30-24/E6), das in der Inneneinheit installiert wird.

Die Vorlage bietet Ein/Aus-Steuerung, Betriebsmodusauswahl (Kühlen, Heizen, Entfeuchten, nur Lüfter, Auto), Thermostat-Sollwerteinstellung, Lüftergeschwindigkeitsregelung (Auto, 5 Stufen, Turbo), vertikale und horizontale Lamellen sowie Umgebungs- und Außentemperaturüberwachung.

Modbus-Kommunikation aktivieren

Bevor TapHome mit der Inneneinheit kommunizieren kann, muss Modbus über den Kabelregler XK117 (Z4K351GJ) aktiviert werden.

Modbus an der Inneneinheit aktivieren
  1. Bei ausgeschalteter Einheit die Tasten FUNCTION und TIMER länger als 5 Sekunden gedrückt halten, um das Einstellungsmenü aufzurufen
Gree Kabelregler XK117 im AUS-Zustand — FUNCTION und TIMER gedrückt halten zum Aufrufen der Einstellungen
  1. MODE mehrmals drücken, um zum 10. Einstellungsparameter (mittlere Zahl) zu gelangen, mit den Pfeiltasten Option 01 auswählen und mit SWING/ENTER bestätigen
Gree Kabelregler XK117 — 10. Parameter Wert 01 auswählen und mit SWING/ENTER bestätigen
Adresse der Inneneinheit einstellen

Wenn mehrere Gateways denselben RS-485-Bus teilen, muss jede Inneneinheit eine eindeutige Adresse haben. Andernfalls die Standardadresse 1 beibehalten.

  1. Bei ausgeschalteter Einheit die Tasten FUNCTION und MODE länger als 5 Sekunden gedrückt halten
Gree Kabelregler XK117 im AUS-Zustand — FUNCTION und MODE gedrückt halten zur Adresseinstellung
  1. Mit den Pfeiltasten die Einheitadresse auswählen und mit SWING/ENTER bestätigen
Gree Kabelregler XK117 — Einheitadresse auswählen und mit SWING/ENTER bestätigen

Hardwareanschluss

Jede Inneneinheit benötigt ein eigenes Modbus Gateway Modul. Das Gateway wird über das mitgelieferte 6-polige Kommunikationskabel mit der Platine der Inneneinheit verbunden und stellt eine RS-485-Schnittstelle für den Modbus-Bus bereit.

Gateway zur Inneneinheit
  1. Das 6-polige Kommunikationskabel in die braunrote Buchse mit der Bezeichnung COM-BMS (Stecker 9) auf der Platine der Inneneinheit stecken
Hauptplatine der Gree Kanalgeräte-Inneneinheit — Position der COM-BMS-Buchse für Modbus Gateway-Anschluss
  1. Das andere Ende an die Buchse des Modbus Gateways mit der Bezeichnung UNIT anschließen
Gree Modbus Gateway (Mini) Modul — UNIT-Buchse und RS-485-Klemmen (A, B, GND)
RS-485 Bus-Verdrahtung

TapHome Core mit den RS-485-Klemmen des Gateways verbinden:

KlemmeFunktion
ARS-485 Data+
BRS-485 Data-
GNDSignalmasse

Ein verdrilltes Paar verbindet A und B, die verbleibende(n) Leitung(en) verbinden GND.

RS-485 verdrilltes Paar Verdrahtung zu A+, B- und GND Klemmen am Gree Modbus Gateway
  • Kabel: Geschirmte verdrillte Doppelader, 0,2–0,32 mm² (24–22 AWG), EIA-485-konform (z.B. Belden 3016A)
  • Topologie: Nur Bus (Daisy-Chain) — Stern-, Ring- oder Dreiecksverdrahtung wird nicht unterstützt
  • Max. Länge: 500 Meter
  • Abschluss: 120-Ohm-Widerstand zwischen A und B am ersten und letzten Gerät am Bus
  • Abschirmung: Kabelschirmung nur an einem Ende mit Schutzerde verbinden (vorzugsweise an der äußersten Inneneinheit)
RS-485 Daisy-Chain Bus-Topologie mit Abschirmung an einem Ende geerdet

Der RS-485-Bus muss eine Bus-(Daisy-Chain-)Topologie verwenden. Stern-, Ring- oder Dreiecksverdrahtung führt zu Kommunikationsausfällen.

Konfiguration

  • Protokoll: Modbus RTU (von TapHome in Modbus TCP eingebettet)
  • Baudrate: 9 600 bit/s
  • Datenbits: 8, Parität: keine, Stoppbits: 1
  • Standard-Slave-ID: 1

Beim Import der Vorlage in TapHome angeben:

  • IP-Adresse — Adresse des TapHome Modbus TCP Gateways
  • Slave-ID — Modbus-Slave-Adresse der Inneneinheit (Standard: 1)

Bei der Steuerung mehrerer Inneneinheiten muss jedes Gateway eine eindeutige Slave-Adresse haben. Die Adresse vor dem Anschluss an den Bus über den Kabelregler einstellen.

Gerätefunktionen

Die Vorlage stellt folgende Geräte bereit:

Einschaltsteuerung
  • Ein/Aus — Schalter zum Ein- oder Ausschalten der Klimaanlage. Verwendet Register H:2 mit nicht standardmäßigen Werten: 0xAA = EIN, 0x55 = AUS.
Betriebsmodus
  • Modus (Mehrwertschalter) — Auswahl aus: Kühlen, Heizen, Entfeuchten, Nur Lüfter, Auto. Verwendet Register H:17 (UInt16). Die verfügbaren Modi hängen von den Fähigkeiten der Außeneinheit ab — wenn die Außeneinheit beispielsweise nur Kühlen unterstützt, sind Heizmodi wirkungslos.
Thermostat
  • Thermostat — liest die Umgebungstemperatur aus Register H:4 (Wert / 10) und liest/schreibt den gewünschten Temperatursollwert in Register H:20. Bereich: 16–30 °C.
Lüftergeschwindigkeit
  • Lüftergeschwindigkeit (Mehrwertschalter) — Lüftergeschwindigkeit über Register H:19 einstellen: Auto, Stufe 1–5 oder Turbo. Im Entfeuchtungsmodus ist niedrige Lüftergeschwindigkeit vorgeschrieben. Turbo ist nur in Kühl-/Heizbetrieb verfügbar.
Lamellensteuerung
  • Lamellen vertikal — Auf/Ab-Schwenkung über Register H:22 ein-/ausschalten. Die Serviceaktion „Vertikale Lamellen einstellen" bietet eine feinere Steuerung mit 11 Positionen (0–11).
  • Lamellen horizontal — Links/Rechts-Schwenkung über Register H:23 ein-/ausschalten. Die Serviceaktion „Horizontale Lamellen einstellen" bietet eine feinere Steuerung mit 8 Positionen (0–8).
Temperaturüberwachung
RegisterSensorBeschreibungIn Vorlage
H:4RaumtemperaturRaumtemperatur (Wert / 10)Ja
H:49AußenAußentemperatur (Vorzeichenbit-Kodierung)Ja
Word 115LuftauslassZulufttemperatur (Wert + 100 Offset)Nein
Serviceattribute

Die Vorlage stellt auch Diagnoseattribute bereit, die in der TapHome-Serviceansicht lesbar sind:

AttributRegisterBeschreibung
IDU Addr.H:5Adresse der Inneneinheit am Gateway-Bus
FrischluftklappenstatusH:24Öffnen/Schließen der Frischluftklappe
SchlafmodusH:25Schlafmodusstatus (0=aus, 1=ein)
VerschmutzungsgradH:34Filterverschmutzungsgrad
Auswahl UmgebungstemperatursensorH:39Aktiver Umgebungstemperatursensor
DRED-FunktionH:77Status des Demand-Response-Enabling-Device
RücklufttemperaturH:82Temperatur am Luftrücklaufport
Lightboard-TemperaturH:83Temperatursensor der Lightboard
Weitere Funktionen

Das Gree Modbus-Protokoll stellt auch Register für Energiesparlimits (Temperaturgrenzwerte für Kühlen/Heizen/Entfeuchten), Ruhemodus, Schlafmodus, 8 °C Heizung (Abwesenheitsmodus), X-Fan und Filter-Reinigungsreset bereit. Diese können in einem zukünftigen Update zur TapHome-Vorlage hinzugefügt werden.

Fehlerbehebung

Keine Modbus-Kommunikation
  1. Sicherstellen, dass die Modbus-Kommunikation an der Inneneinheit über den Kabelregler XK117 aktiviert wurde (10. Parameter auf 01 gesetzt)
  2. RS-485-Verdrahtung prüfen: Klemmen A, B und GND müssen korrekt angeschlossen sein
  3. Sicherstellen, dass die Baudrate in TapHome auf 9 600 eingestellt ist
  4. Sicherstellen, dass die Slave-ID in TapHome mit der an der Inneneinheit konfigurierten Adresse übereinstimmt
Modusänderungen werden nicht übernommen

Der Betriebsmodus der Außeneinheit hat Vorrang. Wenn die Außeneinheit nur Kühlen unterstützt, ist das Einstellen des Heizbetriebs über Modbus wirkungslos. Fehlercode 0x04 weist auf einen Kommunikationsausfall zwischen Gateway und Inneneinheit hin — Anschluss des 6-poligen Kabels an die COM-BMS-Buchse prüfen.

Temperatursollwert wird ignoriert

Wenn die Energiesparfunktion aktiviert ist, werden Temperaturbefehle außerhalb der konfigurierten Grenzwerte abgelehnt. Energiespar-Temperaturgrenzen (Word 106–108) überprüfen oder Energiesparen über die Bedienelemente der Inneneinheit deaktivieren.

Verfügbare Geräte

Gree U-Match AC Modul
Serviceattribute
IDU-AdresseAdresse des Innengeräts auf dem Gateway-Bus
FrischluftventilstatusÖffnungs-/Schließstatus des Frischluftventils
Schlafmodussleep mode status; 0=off, 1=on (protocol Bit 301)
VerschmutzungsgradVerschmutzungsgrad des Filters
Auswahl des Umgebungstemperatursensorswelcher Umgebungstemperatursensor aktiv ist
DRED-FunktionStatus der Demand-Response-Funktion (DRED)
Umgebungstemperatur am Rücklufteinlassreturn air temperature; value multiplied by 10 in script (raw x10)
Umgebungstemperatur der Lichtplatinelight board temperature sensor; value multiplied by 10 in script (raw x10)
Auf- und Abschwenkungup-down swing position readback (multi-value); mirrors device #7
Links- und Rechtsschwenkungleft-right swing position readback (multi-value); mirrors device #6
Serviceaktionen
Auf- und Abschwenkung einstellenset vertical swing to specific position; parameter \'val\' 0–11 maps to binary position codes (0000–1011)
Links- und Rechtsschwenkung einstellenset horizontal swing to specific position; parameter \'val\' 0–8 maps to binary position codes (0000–1101)

Gree_AC

Serviceattribute
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)
Serviceaktionen
Set up & down swing
Parameter: 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
Parameter: 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"))
Umgebungstemperatur Temperatursensor Nur lesen

Raumtemperatur — Wert geteilt durch 10

Register: H:4 UInt16 Einheit: °C numeric

Umgebungstemperatur

Temperatur lesen
var v := MODBUSR(H, 4, UInt16);

if (GETBIT(v,15))
    RETURN ((-(V & 0x7FFF))/10);
ELSE
    return(v/10);
END
Lüftergeschwindigkeit Mehrwertschalter

Lüftergeschwindigkeitswahl — Auto, Stufe 1–5, Turbo

Register: H:19 UInt16 numeric
Werte / Zustände: Auto · Stufe 1 · Stufe 2 · Stufe 3 · Stufe 4 · Stufe 5 · Turbo

Lüftergeschwindigkeit

Schaltzustand lesen
MODBUSR(H, 19, UInt16)
Schaltzustand schreiben
MODBUSWNE(H, 19, UInt16, Mu)
Modus Mehrwertschalter

Betriebsmoduswahl — Kühlen, Heizen, Entfeuchten, Nur Lüfter, Auto

Register: H:17 UInt16 numeric
Werte / Zustände: Kühlen · Kühlen · Heizen · Entfeuchten · Nur Lüfter · Auto

Modus

Schaltzustand lesen
MODBUSR(H, 17, UInt16)
Schaltzustand schreiben
MODBUSWNE(H, 17, UInt16, Mu)
Außentemperatur Temperatursensor Nur lesen

Außentemperatur mit Vorzeichenbit-Kodierung

Register: H:49 Int16 Einheit: °C numeric

Außentemperatur

Temperatur lesen
var v := MODBUSR(H, 49, Int16);

if (GETBIT(v,15))
    RETURN (-(V & 0x7FFF));
ELSE
    return(v);
END
Ein/Aus Schalter

Hauptschalter — 0xAA=EIN, 0x55=AUS

Register: H:2 UInt16 numeric

Ein/Aus

Schaltzustand lesen
SWITCH(MODBUSR(H, 2, UInt16), 85,0,170,1,0)
Schaltzustand schreiben
MODBUSWNE(H, 2, UInt16, SWITCH(St, 0,85,1,170,85))
Thermostat Thermostat

Temperatursollwert 16–30 °C mit Raumtemperaturmessung

Register: H:4 (current), H:20 (desired) → H:20 UInt16 Einheit: °C numeric

Thermostat

Temperatur lesen
MODBUSR(H, 4, UInt16) / 10
Solltemperatur lesen
MODBUSR(H, 20, UInt16)
Solltemperatur schreiben
MODBUSWNE(H, 20, UInt16, Se)
Lamellen horizontal Schalter

Links-rechts Luftschwenkung — Serviceaktion für 8-Positions-Steuerung

Register: H:23 Int16 numeric
Werte / Zustände: SWING · OFF

Lamellen horizontal

Schaltzustand lesen
MODBUSR(H, 23, int16)
Schaltzustand schreiben
MODBUSW(H, 23, int16, St)
Lamellen vertikal Schalter

Auf-ab Luftschwenkung — Serviceaktion für 11-Positions-Steuerung

Register: H:22 Int16 numeric
Werte / Zustände: SWING · OFF

Lamellen vertikal

Schaltzustand lesen
MODBUSR(H, 22, int16)
Schaltzustand schreiben
MODBUSW(H, 22, int16, St)
Verbindung: Modbus TCP • Slave ID: $[SlaveId]
Mögliche Verbesserungen (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
Vorlage herunterladen

Quellen