Easy Modbus
  1. Home
  2. Modbus register maps
  3. Gree
  4. Export residential split air conditioners (built-in Modbus on indoor unit / wired controller)

Split AC unit (VRF / split AC gateway built in) · Modbus register map

Gree Export residential split air conditioners (built-in Modbus on indoor unit / wired controller) Modbus register map

Updated 19 November 2026

Short answer

On these Gree residential units the Modbus RTU slave lives in the indoor-unit controller or wired controller, so no extra module is needed. Holding registers carry on/off, mode, fan speed, setpoint, louvres, sleep and energy-saving limits plus indoor, return-air and outdoor temperatures; coils carry feature flags, locks and a long list of indoor, outdoor and inverter-drive fault bits. Up to 255 units can share one BMS line.

This page lists 113 Modbus registers for the Gree Export residential split air conditioners (built-in Modbus on indoor unit / wired controller) — 28 writable — with the table, 0-based wire address, data type, word order, scale, units and access of each, re-typed from Gree’s own free documentation (linked below) and checked against it.

Manufacturer
Gree
Model
Export residential split air conditioners (built-in Modbus on indoor unit / wired controller)
Equipment type
Split AC unit (VRF / split AC gateway built in)
Registers
113 (28 writable)
Transport
Modbus RTU
Default unit ID
Not stated
Default serial
9600 baud, 8N1
Documented addressing
0-based (the number printed is the address on the wire)
Also known as
Gree residential split Modbus, Gree wall split Modbus, Gree wired controller Modbus
Source document
Modbus Protocol for export residential air conditioners · rev. 2023-05 · unofficial copy
Download CSV all columns JSON Manufacturer PDF ↗

Integration notes: Gree Export residential split air conditioners (built-in Modbus on indoor unit / wired controller)

Integration in brief

Poll words 2-25 for on/off, mode, fan, setpoint and louvres and words 4, 49 and 82 for temperatures; read coils 17-236 for status and fault bits. Write word 2 (0xAA on / 0x55 off), 17, 19 and 20 to control the unit.

Minimum registers to map

Addresses are 0-based wire addresses. Enough to monitor and run the unit; map more as the job needs.

RegisterNameTypeWhyAccess
HR 2Unit On/OffUINT16On/offRead/write
HR 17Set modeUINT16ModeRead/write
HR 19Set fan speedUINT16Fan speedRead/write
HR 20Set temperatureUINT16SetpointRead/write
HR 4Ambient temperatureINT16Room temperatureRead
HR 49Outdoor ambient temperatureINT16Outdoor temperatureRead
CO 151Compressor statusBITCompressor runningRead
CO 122Communication failure with outdoor unitBITOutdoor-unit communication faultRead

Enable Modbus control & writes

The Modbus interface is built into the indoor-unit controller or wired controller; each unit needs its own address (1-255) set before connecting the BMS. Power-cycle the unit after connecting the controller.

Byte order & addressing

Network setup

Watch out for

Gree Export residential split air conditioners (built-in Modbus on indoor unit / wired controller) Modbus registers

Address = 0-based wire address (the documented number is shown under it when it differs) · Order: ABCD = high word first, CDAB = low word first · Scale: engineering value = raw × scale.

113 of 113 shown
Gree Export residential split air conditioners (built-in Modbus on indoor unit / wired controller) Modbus register map
TableAddressNameDescriptionTypeOrderScaleUnitsAccessValues / bits
CO17doc Bit17Remote lockUnit locked by remote monitoring or a hotel charging system.BITRead/write0 = Unlocked; 1 = Locked
CO18doc Bit18Remote temperature shieldBlocks setpoint changes at the unit.BITRead/write0 = Not shielded; 1 = Shielded
CO19doc Bit19Remote mode shieldBITRead/write0 = Not shielded; 1 = Shielded
CO20doc Bit20Remote On/Off shieldBITRead/write0 = Not shielded; 1 = Shielded
CO21doc Bit21Remote energy-saving shieldBITRead/write0 = Not shielded; 1 = Shielded
CO24doc Bit24Absence mode (8 °C heating)BITRead/write0 = Off; 1 = On
CO25doc Bit25Healthy functionBITRead/write0 = Off; 1 = On
CO26doc Bit26I-Demand / energy-saving comfortBITRead/write0 = Off; 1 = On
CO27doc Bit27TurboBITRead/write0 = Off; 1 = On
CO28doc Bit28Electric heater permissionBITRead/write0 = Electric heater allowed; 1 = Electric heater not allowed
CO29doc Bit29X-fanBITRead/write0 = Off; 1 = On
CO30doc Bit30SilentBITRead/write0 = Off; 1 = On
CO32doc Bit32Energy saving in cooling activeWrite together with bit 33.BITRead/write0 = Off; 1 = On
CO33doc Bit33Energy saving in heating activeWrite together with bit 32.BITRead/write0 = Off; 1 = On
CO34doc Bit34Button lock (child lock)BITRead/write0 = Off; 1 = On
CO35doc Bit35On/Off memoryWhether the unit restores its on/off state after power loss.BITRead/write0 = Memorize; 1 = Do not memorize
CO36doc Bit36°C/°F flagBITRead/write0 = °C; 1 = °F
CO37doc Bit371 °F flagBITRead0 = No; 1 = Yes
CO38doc Bit381 °F flag, cooling energy-saving limitBITRead0 = No; 1 = Yes
CO39doc Bit391 °F flag, heating energy-saving limitBITRead0 = No; 1 = Yes
CO40doc Bit40Timer statusBITRead0 = No timer; 1 = Timer set
CO46doc Bit46Gate control system fittedBITRead0 = No; 1 = Yes
CO49doc Bit49Timer On flagBITRead0 = Not active; 1 = Active
CO50doc Bit50Timer Off flagBITRead0 = Not active; 1 = Active
CO51doc Bit51Room temperature source in current modeBITRead0 = Return-air sensor; 1 = Wired-controller sensor
CO65doc Bit65Wired controller temperature sensor errorBITRead0 = Normal; 1 = Error
CO74doc Bit74Up and down swing modeBITRead/write0 = Mode 1, simple swing; 1 = Mode 2, fixed angle and small-area swing
CO75doc Bit75Setpoint adjustable in auto modeBITRead0 = No; 1 = Yes
CO97doc Bit97Indoor evaporator temperature sensor errorBITRead0 = Normal; 1 = Error
CO98doc Bit98Indoor return-air temperature sensor errorBITRead0 = Normal; 1 = Error
CO101doc Bit101Water overflow protectionBITRead0 = Normal; 1 = Error
CO104doc Bit104Jumper cap error (indoor)BITRead0 = Normal; 1 = Error
CO105doc Bit105Indoor fan errorBITRead0 = Normal; 1 = Error
CO112doc Bit112Card in/out statusHotel key-card switch.BITRead0 = Card out; 1 = Card in
CO120doc Bit120Communication failure with master wired controllerBITRead0 = Normal; 1 = Error
CO122doc Bit122Communication failure with outdoor unitBITRead0 = Normal; 1 = Error
CO147doc Bit147Outdoor fan statusBITRead0 = Off; 1 = On
CO150doc Bit1504-way valve statusBITRead0 = Off; 1 = On
CO151doc Bit151Compressor statusBITRead0 = Off; 1 = On
CO152doc Bit152Compressor discharge temperature protectionBITRead0 = Normal; 1 = Error
CO153doc Bit153Refrigerant shortage protectionBITRead0 = Normal; 1 = Error
CO154doc Bit154DC fan motor protectionBITRead0 = Normal; 1 = Error
CO155doc Bit1554-way valve reversing errorBITRead0 = Normal; 1 = Error
CO156doc Bit156Overpower protectionBITRead0 = Normal; 1 = Error
CO157doc Bit157Overload protectionBITRead0 = Normal; 1 = Error
CO158doc Bit158Low pressure protectionBITRead0 = Normal; 1 = Error
CO159doc Bit159High pressure protectionBITRead0 = Normal; 1 = Error
CO160doc Bit160Evaporator anti-freeze protectionBITRead0 = Normal; 1 = Error
CO161doc Bit161Outdoor ambient temperature sensor errorBITRead0 = Normal; 1 = Error
CO162doc Bit162Discharge temperature sensor errorBITRead0 = Normal; 1 = Error
CO163doc Bit163Condenser temperature sensor errorBITRead0 = Normal; 1 = Error
CO165doc Bit165Jumper cap error (outdoor)BITRead0 = Normal; 1 = Error
CO166doc Bit166Outdoor unit memory chip errorBITRead0 = Normal; 1 = Error
CO173doc Bit173Indoor and outdoor units mismatchedBITRead0 = Normal; 1 = Error
CO174doc Bit174Drive communication failureBITRead0 = Normal; 1 = Error
CO177doc Bit177Cooling-only flagHeating commands have no effect on cooling-only units.BITRead0 = Cooling and heating; 1 = Cooling only
CO179doc Bit179System defrostingBITRead0 = No; 1 = Yes
CO184doc Bit184Drive DC bus undervoltage or voltage-drop errorBITRead0 = Normal; 1 = Error
CO185doc Bit185Drive DC bus overvoltage protectionBITRead0 = Normal; 1 = Error
CO186doc Bit186Drive AC input current protectionBITRead0 = Normal; 1 = Error
CO187doc Bit187Drive IPM protectionBITRead0 = Normal; 1 = Error
CO188doc Bit188Drive PFC protectionBITRead0 = Normal; 1 = Error
CO189doc Bit189Inverter compressor start-up failureBITRead0 = Normal; 1 = Error
CO190doc Bit190Inverter compressor phase-loss protectionBITRead0 = Normal; 1 = Error
CO191doc Bit191Drive module resetBITRead0 = Normal; 1 = Error
CO192doc Bit192Inverter compressor overcurrent protectionBITRead0 = Normal; 1 = Error
CO193doc Bit193Inverter compressor power protectionBITRead0 = Normal; 1 = Error
CO194doc Bit194Drive current-detection circuit failureBITRead0 = Normal; 1 = Error
CO195doc Bit195Inverter compressor out-of-step protectionBITRead0 = Normal; 1 = Error
CO196doc Bit196Compressor stallingBITRead0 = Normal; 1 = Error
CO198doc Bit198Drive module high-temperature protectionBITRead0 = Normal; 1 = Error
CO199doc Bit199Drive module temperature sensor failureBITRead0 = Normal; 1 = Error
CO210doc Bit210Drive charging circuit failureBITRead0 = Normal; 1 = Error
CO211doc Bit211Drive AC input voltage abnormalBITRead0 = Normal; 1 = Error
CO214doc Bit214Temperature drift protectionBITRead0 = Normal; 1 = Error
CO215doc Bit215Current sensor connection protectionCurrent sensor not on the matching U or V phase.BITRead0 = Normal; 1 = Error
CO216doc Bit216Indoor outlet pipe (gas side) sensor errorBITRead0 = Normal; 1 = Error
CO217doc Bit217Indoor inlet pipe (liquid side) sensor errorBITRead0 = Normal; 1 = Error
CO218doc Bit218Drive board ambient sensor errorBITRead0 = Normal; 1 = Error
CO219doc Bit219Condenser inlet pipe sensor open/shortBITRead0 = Normal; 1 = Error
CO220doc Bit220Condenser outlet pipe sensor open/shortBITRead0 = Normal; 1 = Error
CO221doc Bit221Wiring error or expansion valve errorBITRead0 = Normal; 1 = Error
CO222doc Bit222Mode conflict protectionBITRead0 = Normal; 1 = Error
CO223doc Bit223Compressor demagnetization protectionBITRead0 = Normal; 1 = Error
CO224doc Bit224Whole-unit current detection errorBITRead0 = Normal; 1 = Error
CO225doc Bit225AC contactor protectionBITRead0 = Normal; 1 = Error
CO226doc Bit226OverspeedBITRead0 = Normal; 1 = Error
CO227doc Bit227Outdoor fan 2 errorBITRead0 = Normal; 1 = Error
CO228doc Bit228PG motor zero-crossing protectionBITRead0 = Normal; 1 = Error
CO229doc Bit229Compressor suction temperature sensor errorBITRead0 = Normal; 1 = Error
CO230doc Bit230Indoor fan tripping errorBITRead0 = Normal; 1 = Error
CO231doc Bit231Communication error between indoor unit and gridBITRead0 = Normal; 1 = Error
CO232doc Bit232Communication error between outdoor unit and gridBITRead0 = Normal; 1 = Error
CO233doc Bit233Main error at grid sideBITRead0 = Normal; 1 = Error
CO234doc Bit234Indoor network address errorBITRead0 = Normal; 1 = Error
CO235doc Bit235IP address allocation overflowBITRead0 = Normal; 1 = Error
CO236doc Bit236Other error or protectionBITRead0 = Normal; 1 = Error
HR2doc Word2Unit On/OffWrite 0xAA (170) to switch on, 0x55 (85) to switch off.UINT16Read/write85 = Off; 170 = On
HR4doc Word4Ambient temperatureIndoor ambient temperature in tenths of a degree.INT16× 0.1°CRead
HR5doc Word5IDU addressModbus address of this indoor unit, 1-255.UINT16Read
HR17doc Word17Set modeUINT16Read/write1 = Cooling; 2 = Heating; 3 = Drying; 4 = Fan only; 5 = Auto
HR19doc Word19Set fan speedUINT16Read/write0 = Auto; 1 = Speed 1; 2 = Speed 2; 3 = Speed 3; 4 = Speed 4; 5 = Speed 5; 6 = Turbo
HR20doc Word20Set temperatureRange 16-30.UINT16°CRead/write
HR22doc Word22Up and down swingVertical louvre: off, fixed position or swing between two positions.UINT16Read/write0 = Off; 1 = Swing positions 1-5; 2 = Position 1; 3 = Position 2; 4 = Position 3; 5 = Position 4; 6 = Position 5; 7 = Swing positions 3-5; 8 = Swing positions 2-5; 9 = Swing positions 2-4; 10 = Swing positions 1-4; 11 = Swing positions 1-3
HR23doc Word23Left and right swingHorizontal louvre; off is the default after power-up.UINT16Read/write0 = Off; 1 = Swing in same direction; 2 = Position 1; 3 = Position 2; 4 = Position 3; 5 = Position 4; 6 = Position 5; 12 = Printed as "15 position" (meaning not explained); 13 = Swing in opposite direction
HR24doc Word24Fresh air valveFresh-air valve mode 0-10.UINT16Read/write
HR25doc Word25Sleep modeIgnored in fan and auto modes.UINT16Read/write0 = No sleep; 1 = Sleep mode 1; 2 = Sleep mode 2; 3 = Sleep mode 3
HR35doc Word35Cooling energy-saving lower limitLowest setpoint allowed in cooling while energy saving is active, 16-30.UINT16°CRead/write
HR36doc Word36Heating energy-saving upper limitHighest setpoint allowed in heating while energy saving is active, 16-30.UINT16°CRead/write
HR39doc Word39Ambient sensor selectionWhich sensor gives room temperature in each mode.UINT16Read1 = Return-air sensor always; 2 = Wired-controller sensor always; 3 = Return air in cool/dry/fan, wired controller in heat/auto; 4 = Wired controller in cool/dry/fan, return air in heat/auto
HR49doc Word49Outdoor ambient temperatureWhole degrees.INT16°CRead
HR77doc Word77DRED functionDemand-response mode.UINT16Read0 = No DRED; 1 = DRED 1; 2 = DRED 2; 3 = DRED 3
HR82doc Word82Return-air temperatureTemperature at the indoor-unit air return, tenths of a degree.INT16× 0.1°CRead

Notes on this map

Check it against the live device. A register map tells you what the controller can expose; the unit in front of you may differ by firmware or options. Read a few registers and compare them with the unit’s own display; for a 32-bit value the float and byte-order decoder shows all four word orders at once, so a wrong word order or scale is obvious. New to this? Read what a register map is and why addresses are off by one.

Questions about the Gree Export residential split air conditioners (built-in Modbus on indoor unit / wired controller)

What Modbus registers does the Gree Export residential split air conditioners (built-in Modbus on indoor unit / wired controller) have?

This map lists 113 registers: 97 coils, 16 holding registers. 28 of them can be written. Registers vary with firmware, options and configuration, so confirm against the device.

Are the Gree Export residential split air conditioners (built-in Modbus on indoor unit / wired controller) Modbus addresses 0-based or 1-based?

The manufacturer's document numbers registers 0-based (the number printed is the address on the wire). Every address on this page is the 0-based wire address you put in the request; the documented number is shown under it where it differs. Registers are words numbered from 0 and coils are bits numbered from 0 (Bit0 = Byte0.0). Word n is wire address n and Bit n is coil n. The example frames agree: reading ten bits from coil 5 sends start address 00 05, and reading two words from address 1 sends 00 01.

What are the minimum Modbus registers to integrate the Gree Export residential split air conditioners (built-in Modbus on indoor unit / wired controller)?

Start with HR 2 Unit On/Off (On/off); HR 17 Set mode (Mode); HR 19 Set fan speed (Fan speed); HR 20 Set temperature (Setpoint); HR 4 Ambient temperature (Room temperature); HR 49 Outdoor ambient temperature (Outdoor temperature); CO 151 Compressor status (Compressor running); CO 122 Communication failure with outdoor unit (Outdoor-unit communication fault).

How do I enable Modbus control of the Gree Export residential split air conditioners (built-in Modbus on indoor unit / wired controller)?

The Modbus interface is built into the indoor-unit controller or wired controller; each unit needs its own address (1-255) set before connecting the BMS. Power-cycle the unit after connecting the controller.

Where is the official Gree Export residential split air conditioners (built-in Modbus on indoor unit / wired controller) Modbus documentation?

The source is Modbus Protocol for export residential air conditioners, revision 2023-05. Gree doesn't publish it on its own website, so this map was re-typed from a free copy at https://kesko-onninen-pim-resources-production.s3-eu-west-1.amazonaws.com/pimdocuments/26148852.pdf. It may be an older revision, so check it against the live unit.

More Gree Modbus register maps

Other ac & vrf gateways register maps

All ac & vrf gateways Modbus register maps →

Source: Modbus Protocol for export residential air conditioners · rev. 2023-05 · unofficial copy. Register numbers, types, scaling and units are reproduced as published; descriptions are our own.