TapHome

Gree U-Match Klimatyzacja

Modbus TCP
Submitted by
Last updated: 03. 2026

Wymaga zewnętrznej bramki

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

Gree U-Match Klimatyzacja

Seria Gree U-Match to komercyjne/mieszkaniowe jednostki klimatyzacji (kanałowe, kasetowe, podłogowe/sufitowe) z czynnikiem chłodniczym R32. TapHome łączy się z każdą jednostką wewnętrzną przez Modbus RTU na RS-485, używając bramki Gree Modbus Gateway (TD GUD 30/01 lub Mini ME30-24/E6) zainstalowanej wewnątrz jednostki wewnętrznej.

Szablon zapewnia sterowanie włącz/wyłącz, wybór trybu pracy (chłodzenie, ogrzewanie, osuszanie, tylko wentylator, auto), regulację punktu nastawczego termostatu, sterowanie prędkością wentylatora (auto, 5 prędkości, turbo), żaluzje pionowe i poziome oraz monitorowanie temperatury w pomieszczeniu i na zewnątrz.

Włączanie komunikacji Modbus

Zanim TapHome będzie mogło komunikować się z jednostką wewnętrzną, Modbus musi zostać aktywowany przy użyciu przewodowego sterownika XK117 (Z4K351GJ).

Aktywacja Modbus w jednostce wewnętrznej
  1. Przy jednostce w stanie WYŁ, przytrzymaj przyciski FUNCTION i TIMER przez więcej niż 5 sekund, aby wejść do menu ustawień
Przewodowy sterownik Gree XK117 w stanie WYŁ — przytrzymaj FUNCTION i TIMER, aby wejść do ustawień
  1. Naciskaj wielokrotnie MODE, aby przejść do 10. parametru ustawień (środkowa liczba), użyj przycisków strzałek, aby wybrać opcję 01 i potwierdź naciskając SWING/ENTER
Przewodowy sterownik Gree XK117 — wybór 10. parametru wartość 01 i potwierdzenie przez SWING/ENTER
Ustawianie adresu jednostki wewnętrznej

Gdy wiele bramek korzysta z tej samej magistrali RS-485, każda jednostka wewnętrzna musi mieć unikalny adres. W przeciwnym razie zachowaj domyślny adres 1.

  1. Przy jednostce w stanie WYŁ, przytrzymaj przyciski FUNCTION i MODE przez więcej niż 5 sekund
Przewodowy sterownik Gree XK117 w stanie WYŁ — przytrzymaj FUNCTION i MODE, aby ustawić adres
  1. Użyj przycisków strzałek, aby wybrać adres jednostki i potwierdź naciskając SWING/ENTER
Przewodowy sterownik Gree XK117 — wybór adresu jednostki i potwierdzenie przez SWING/ENTER

Połączenie sprzętowe

Każda jednostka wewnętrzna wymaga własnego modułu Modbus Gateway. Bramka łączy się z płytą główną jednostki wewnętrznej za pomocą dołączonego 6-pinowego kabla komunikacyjnego i zapewnia interfejs RS-485 dla magistrali Modbus.

Bramka do jednostki wewnętrznej
  1. Podłącz 6-pinowy kabel komunikacyjny do brązowo-czerwonego gniazda oznaczonego COM-BMS (złącze 9) na płycie głównej jednostki wewnętrznej
Płyta główna kanałowej jednostki wewnętrznej Gree — lokalizacja gniazda COM-BMS do podłączenia Modbus Gateway
  1. Podłącz drugi koniec do gniazda bramki Modbus Gateway oznaczonego UNIT
Moduł Gree Modbus Gateway (Mini) — gniazdo UNIT i zaciski RS-485 (A, B, GND)
Okablowanie magistrali RS-485

Podłącz TapHome Core do zacisków RS-485 bramki:

ZaciskFunkcja
ARS-485 Data+
BRS-485 Data-
GNDMasa sygnałowa

Jedna skrętka łączy A i B, pozostałe przewody łączą GND.

Okablowanie skrętki RS-485 do zacisków A+, B- i GND na Gree Modbus Gateway
  • Kabel: Ekranowana skrętka, 0,2–0,32 mm² (24–22 AWG), zgodna z EIA-485 (np. Belden 3016A)
  • Topologia: Tylko magistrala (daisy-chain) — topologie gwiazdy, pierścienia lub trójkąta nie są obsługiwane
  • Maks. długość: 500 metrów
  • Terminacja: Rezystor 120 omów między A i B na pierwszym i ostatnim urządzeniu w magistrali
  • Ekranowanie: Podłącz ekran kabla do uziemienia ochronnego tylko na jednym końcu (najlepiej na najbardziej zewnętrznej jednostce wewnętrznej)
Topologia magistrali RS-485 daisy-chain z ekranowaniem uziemionym na jednym końcu

Magistrala RS-485 musi używać topologii magistralnej (daisy-chain). Okablowanie w topologii gwiazdy, pierścienia lub trójkąta spowoduje błędy komunikacji.

Konfiguracja

  • Protokół: Modbus RTU (opakowany w Modbus TCP przez TapHome)
  • Szybkość transmisji: 9 600 bit/s
  • Bity danych: 8, parzystość: brak, bity stopu: 1
  • Domyślne Slave ID: 1

Podczas importowania szablonu w TapHome podaj:

  • Adres IP — adres bramki TapHome Modbus TCP
  • Slave ID — adres Modbus slave jednostki wewnętrznej (domyślnie: 1)

Przy sterowaniu wieloma jednostkami wewnętrznymi każda bramka musi mieć unikalny adres slave. Ustaw adres przez przewodowy sterownik przed podłączeniem do magistrali.

Możliwości urządzenia

Szablon udostępnia następujące urządzenia:

Sterowanie zasilaniem
  • Włącz/Wyłącz — przełącznik do włączania lub wyłączania jednostki klimatyzacji. Używa rejestru H:2 z niestandardowymi wartościami: 0xAA = WŁ, 0x55 = WYŁ.
Tryb pracy
  • Tryb (przełącznik wielowartościowy) — wybór spośród: Chłodzenie, Ogrzewanie, Osuszanie, Tylko wentylator, Auto. Używa rejestru H:17 (UInt16). Dostępne tryby zależą od możliwości jednostki zewnętrznej — na przykład jeśli jednostka zewnętrzna obsługuje tylko chłodzenie, tryby ogrzewania będą nieskuteczne.
Termostat
  • Termostat — odczytuje temperaturę otoczenia z rejestru H:4 (wartość / 10) i odczytuje/zapisuje żądany punkt nastawczy temperatury w rejestrze H:20. Zakres: 16–30 °C.
Prędkość wentylatora
  • Prędkość wentylatora (przełącznik wielowartościowy) — ustawienie prędkości wentylatora przez rejestr H:19: Auto, Prędkość 1–5 lub Turbo. W trybie osuszania niska prędkość wentylatora jest obowiązkowa. Turbo jest dostępne tylko w trybach chłodzenia/ogrzewania.
Sterowanie żaluzjami
  • Żaluzje pionowe — przełączanie ruchu góra-dół przez rejestr H:22. Akcja serwisowa „Ustaw żaluzje pionowe" zapewnia dokładniejsze sterowanie w 11 pozycjach (0–11).
  • Żaluzje poziome — przełączanie ruchu lewo-prawo przez rejestr H:23. Akcja serwisowa „Ustaw żaluzje poziome" zapewnia dokładniejsze sterowanie w 8 pozycjach (0–8).
Monitorowanie temperatury
RejestrCzujnikOpisW szablonie
H:4Temperatura pomieszczeniaTemperatura pomieszczenia (wartość / 10)Tak
H:49ZewnętrznaTemperatura zewnętrzna (kodowanie bitem znaku)Tak
Word 115Wylot powietrzaTemperatura nawiewanego powietrza (wartość + offset 100)Nie
Atrybuty serwisowe

Szablon udostępnia również atrybuty diagnostyczne odczytywalne w widoku serwisowym TapHome:

AtrybutRejestrOpis
IDU Addr.H:5Adres jednostki wewnętrznej na magistrali bramki
Status zaworu świeżego powietrzaH:24Otwarcie/zamknięcie zaworu świeżego powietrza
Tryb nocnyH:25Status trybu nocnego (0=wył, 1=wł)
Stopień zanieczyszczeniaH:34Poziom zanieczyszczenia filtra
Wybór czujnika temperatury otoczeniaH:39Aktywny czujnik temperatury otoczenia
Funkcja DREDH:77Status urządzenia sterowania popytem (DRED)
Temperatura powietrza powrotnegoH:82Temperatura przy porcie powrotu powietrza
Temperatura płytki świetlnejH:83Czujnik temperatury płytki świetlnej
Dodatkowe możliwości

Protokół Gree Modbus udostępnia również rejestry dla limitów oszczędzania energii (granice temperatury dla chłodzenia/ogrzewania/osuszania), tryb cichy, tryb nocny, ogrzewanie 8 °C (tryb nieobecności), X-Fan i reset czyszczenia filtra. Można je dodać do szablonu TapHome w przyszłej aktualizacji.

Rozwiązywanie problemów

Brak komunikacji Modbus
  1. Sprawdź, czy komunikacja Modbus została aktywowana w jednostce wewnętrznej przez przewodowy sterownik XK117 (10. parametr ustawiony na 01)
  2. Sprawdź okablowanie RS-485: zaciski A, B i GND muszą być prawidłowo podłączone
  3. Potwierdź, że szybkość transmisji jest ustawiona na 9 600 w TapHome
  4. Upewnij się, że Slave ID w TapHome odpowiada adresowi skonfigurowanemu w jednostce wewnętrznej
Zmiany trybu nie są stosowane

Tryb pracy jednostki zewnętrznej ma priorytet. Jeśli jednostka zewnętrzna obsługuje tylko chłodzenie, ustawienie trybu ogrzewania przez Modbus będzie nieskuteczne. Kod błędu 0x04 wskazuje na błąd komunikacji między bramką a jednostką wewnętrzną — sprawdź połączenie 6-pinowego kabla z gniazdem COM-BMS.

Punkt nastawczy temperatury jest ignorowany

Gdy funkcja oszczędzania energii jest włączona, polecenia temperatury spoza skonfigurowanych limitów zostaną odrzucone. Sprawdź limity temperatury oszczędzania energii (Word 106–108) lub wyłącz oszczędzanie energii przez elementy sterujące jednostki wewnętrznej.

Dostępne urządzenia

Gree U-Match AC Moduł
Atrybuty serwisowe
Adres IDUadres jednostki wewnętrznej na magistrali bramy
Stan zaworu świeżego powietrzastan otwarcia/zamknięcia zaworu świeżego powietrza
Tryb uśpieniasleep mode status; 0=off, 1=on (protocol Bit 301)
Stopień zanieczyszczeniastopień zanieczyszczenia filtra
Wybór czujnika temperatury otoczeniaktóry czujnik temperatury otoczenia jest aktywny
Funkcja DREDstan funkcji urządzenia sterowania zapotrzebowaniem (DRED)
Temperatura otoczenia na wlocie powietrza powrotnegoreturn air temperature; value multiplied by 10 in script (raw x10)
Temperatura otoczenia płyty świetlnejlight board temperature sensor; value multiplied by 10 in script (raw x10)
Wahanie góra-dółup-down swing position readback (multi-value); mirrors device #7
Wahanie lewo-prawoleft-right swing position readback (multi-value); mirrors device #6
Akcje serwisowe
Ustaw wahanie góra-dółset vertical swing to specific position; parameter \'val\' 0–11 maps to binary position codes (0000–1011)
Ustaw wahanie lewo-prawoset horizontal swing to specific position; parameter \'val\' 0–8 maps to binary position codes (0000–1101)

Gree_AC

Atrybuty serwisowe
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)
Akcje serwisowe
Set up & down swing
Parametry: 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
Parametry: 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 otoczenia Czujnik temperatury Tylko do odczytu

Temperatura w pomieszczeniu — wartość podzielona przez 10

Rejestr: H:4 UInt16 Jednostka: °C numeric

Temperatura otoczenia

Odczyt temperatury
var v := MODBUSR(H, 4, UInt16);

if (GETBIT(v,15))
    RETURN ((-(V & 0x7FFF))/10);
ELSE
    return(v/10);
END
Prędkość wentylatora Przełącznik wielowartościowy

Wybór prędkości wentylatora — Auto, Prędkość 1–5, Turbo

Rejestr: H:19 UInt16 numeric
Wartości / Stany: Auto · Prędkość 1 · Prędkość 2 · Prędkość 3 · Prędkość 4 · Prędkość 5 · Turbo

Prędkość wentylatora

Odczyt stanu przełącznika
MODBUSR(H, 19, UInt16)
Zapis stanu przełącznika
MODBUSWNE(H, 19, UInt16, Mu)
Tryb Przełącznik wielowartościowy

Wybór trybu pracy — Chłodzenie, Ogrzewanie, Osuszanie, Tylko wentylator, Auto

Rejestr: H:17 UInt16 numeric
Wartości / Stany: Chłodzenie · Chłodzenie · Ogrzewanie · Osuszanie · Tylko wentylator · Auto

Tryb

Odczyt stanu przełącznika
MODBUSR(H, 17, UInt16)
Zapis stanu przełącznika
MODBUSWNE(H, 17, UInt16, Mu)
Temperatura zewnętrzna Czujnik temperatury Tylko do odczytu

Temperatura zewnętrzna z kodowaniem bitem znaku

Rejestr: H:49 Int16 Jednostka: °C numeric

Temperatura zewnętrzna

Odczyt temperatury
var v := MODBUSR(H, 49, Int16);

if (GETBIT(v,15))
    RETURN (-(V & 0x7FFF));
ELSE
    return(v);
END
Włącz/Wyłącz Przełącznik

Główny wyłącznik — 0xAA=WŁ, 0x55=WYŁ

Rejestr: H:2 UInt16 numeric

Włącz/Wyłącz

Odczyt stanu przełącznika
SWITCH(MODBUSR(H, 2, UInt16), 85,0,170,1,0)
Zapis stanu przełącznika
MODBUSWNE(H, 2, UInt16, SWITCH(St, 0,85,1,170,85))
Termostat Termostat

Punkt nastawczy temperatury 16–30 °C z odczytem temperatury w pomieszczeniu

Rejestr: H:4 (current), H:20 (desired)H:20 UInt16 Jednostka: °C numeric

Termostat

Odczyt temperatury
MODBUSR(H, 4, UInt16) / 10
Odczyt temperatury zadanej
MODBUSR(H, 20, UInt16)
Zapis temperatury zadanej
MODBUSWNE(H, 20, UInt16, Se)
Żaluzje poziome Przełącznik

Przełączanie ruchu powietrza lewo-prawo — akcja serwisowa dla sterowania 8-pozycyjnego

Rejestr: H:23 Int16 numeric
Wartości / Stany: SWING · OFF

Żaluzje poziome

Odczyt stanu przełącznika
MODBUSR(H, 23, int16)
Zapis stanu przełącznika
MODBUSW(H, 23, int16, St)
Żaluzje pionowe Przełącznik

Przełączanie ruchu powietrza góra-dół — akcja serwisowa dla sterowania 11-pozycyjnego

Rejestr: H:22 Int16 numeric
Wartości / Stany: SWING · OFF

Żaluzje pionowe

Odczyt stanu przełącznika
MODBUSR(H, 22, int16)
Zapis stanu przełącznika
MODBUSW(H, 22, int16, St)
Połączenie: Modbus TCP • Slave ID: $[SlaveId]
Możliwe ulepszenia (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

Źródła