Easy Modbus
  1. Home
  2. Modbus register maps
  3. Gree
  4. Versati heat pump water heater (wired-controller Modbus RTU, protocol V1.5)

Heat pump (air-to-water) · Modbus register map

Gree Versati heat pump water heater (wired-controller Modbus RTU, protocol V1.5) Modbus register map

Updated 19 November 2026

Short answer

The Versati wired controller has a two-wire RS-485 BMS port that answers Modbus RTU, so up to 255 heat pumps can sit on one line. Holding registers (words) carry on/off, mode, water and room setpoints, temperature limits, power and current limits, unit status and compressor frequency; coils (bits) carry function switches (timers, quiet mode, weather compensation, disinfection, holiday) and indoor, outdoor and inverter fault and state flags.

This page lists 142 Modbus registers for the Gree Versati heat pump water heater (wired-controller Modbus RTU, protocol V1.5) — 63 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
Versati heat pump water heater (wired-controller Modbus RTU, protocol V1.5)
Equipment type
Heat pump (air-to-water)
Registers
142 (63 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
Versati III, R32 Versati, Versati heat pump water heater, Gree Versati Modbus V1.5
Source document
Modbus Protocol (V1.5) for the Versati Heat Pump Water Heater · V1.5 · unofficial copy
Download CSV all columns JSON Manufacturer PDF ↗

Integration notes: Gree Versati heat pump water heater (wired-controller Modbus RTU, protocol V1.5)

Integration in brief

Wire the BMS port of the wired controller to RS-485, set a unique address, then read words 117-143 and coils 64-191 for status and faults, and write word 42 (0xAA/0x55), word 2 (mode) and the setpoint words.

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 42On/OffUINT16On/offRead/write
HR 2ModeUINT16ModeRead/write
HR 10WOT-HeatUINT16Heating water setpointRead/write
HR 13T-water tankUINT16Tank setpointRead/write
HR 117Unit statusUINT16Unit statusRead
HR 143Running frequencyUINT16Compressor running frequencyRead
CO 80Compressor StateBITCompressor onRead
CO 86Defrosting StateBITDefrostingRead
CO 102System Recoverable ProtectionBITSystem recoverable protectionRead

Enable Modbus control & writes

On the wired controller press COMMISSION, then FUNCTION, page to 'Address', set the BMS address and press OK. The address must not be 0 or 126 and must match the address the BMS sends.

Byte order & addressing

Network setup

Watch out for

Gree Versati heat pump water heater (wired-controller Modbus RTU, protocol V1.5) 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.

142 of 142 shown
Gree Versati heat pump water heater (wired-controller Modbus RTU, protocol V1.5) Modbus register map
TableAddressNameDescriptionTypeOrderScaleUnitsAccessValues / bits
CO8doc Bit 8Weekly TimerBITRead/write0 = Close; 1 = Open
CO9doc Bit 9Clock TimerBITRead/write0 = Close; 1 = Open
CO10doc Bit 10Temp TimerBITRead/write0 = Close; 1 = Open
CO11doc Bit 11Gate-Ctrl.BITRead/write0 = Close; 1 = Open
CO16doc Bit 16Solar heaterBITRead/write0 = Off; 1 = On
CO17doc Bit 17Ctrl.stateBITRead/write0 = T-water out; 1 = T-room
CO18doc Bit 18Fast Hot WaterBITRead/write0 = Off; 1 = On
CO19doc Bit 19Cool+Hot Water PriorityBITRead/write0 = Cool; 1 = Hot water
CO20doc Bit 20Heat+Hot Water PriorityBITRead/write0 = Heat; 1 = Hot water
CO21doc Bit 21Quite ModeBITRead/write0 = Off; 1 = On
CO22doc Bit 22Weather dependBITRead/write0 = Off; 1 = On
CO23doc Bit 23DisinfectionBITRead/write0 = Off; 1 = On
CO24doc Bit 24Floor DebugBITRead/write0 = Off; 1 = On
CO25doc Bit 25Floor Debug start/stopBITRead/write0 = Stop; 1 = Start
CO26doc Bit 26Emergen. modeBITRead/write0 = Off; 1 = On
CO27doc Bit 27Other thermalBITRead/write0 = Without; 1 = With
CO29doc Bit 29Water TankBITRead/write0 = Without; 1 = With
CO31doc Bit 31Solar settingBITRead/write0 = Without; 1 = With
CO33doc Bit 33Remote sensorBITRead/write0 = Without; 1 = With
CO34doc Bit 34Holiday ModeBITRead/write0 = Off; 1 = On
CO35doc Bit 35Refri. recoveryBITRead/write0 = Off; 1 = On
CO36doc Bit 36Manual defrostBITRead/write0 = Off; 1 = On
CO37doc Bit 37Cool 2-Way valveBITRead/write0 = Off; 1 = On
CO38doc Bit 38Heat 2-Way valveBITRead0 = Off; 1 = On
CO64doc Bit 64Communication Error between the Wired Controller and IDUBITRead0 = Normal; 1 = Error
CO65doc Bit 65Communication Error between the Wired Controler and ODUBITRead0 = Normal; 1 = Error
CO66doc Bit 66Communication Error between the Wired Controller and DriveBITRead0 = Normal; 1 = Error
CO67doc Bit 67HP-AntifreeBITRead0 = Off; 1 = On
CO80doc Bit 80Compressor StateBITRead0 = Off; 1 = On
CO81doc Bit 81ODU Fan StateBITRead0 = Off; 1 = On
CO83doc Bit 834-way Valve StateBITRead0 = Off; 1 = On
CO84doc Bit 84Compressor Crankcase Heater StateBITRead0 = Off; 1 = On
CO85doc Bit 85Underpan Heater StateBITRead0 = Off; 1 = On
CO86doc Bit 86Defrosting StateBITRead0 = End; 1 = Defrosting
CO87doc Bit 87Oil Return StateBITRead0 = No oil return; 1 = In oil return
CO88doc Bit 88Ambient Temp Sensor ErrorBITRead0 = Normal; 1 = Error
CO89doc Bit 89Defrost Temp Sensor ErrorBITRead0 = Normal; 1 = Error
CO90doc Bit 90Discharge Temp Sensor ErrorBITRead0 = Normal; 1 = Error
CO91doc Bit 91Suction Temp Sensor ErrorBITRead0 = Normal; 1 = Error
CO92doc Bit 92ODU Fan ErrorBITRead0 = Normal; 1 = Error
CO93doc Bit 93High-Pressure Sensor ErrorBITRead0 = Normal; 1 = Error
CO94doc Bit 94High Pressure ProtectionBITRead0 = Normal; 1 = Error
CO95doc Bit 95Low Pressure ProtectionBITRead0 = Normal; 1 = Error
CO96doc Bit 96High Discharge ProtectionBITRead0 = Normal; 1 = Error
CO97doc Bit 97Capacity DIP Setting ErrorBITRead0 = Normal; 1 = Error
CO98doc Bit 98Communication Error between IDU and ODUBITRead0 = Normal; 1 = Error
CO102doc Bit 102System Recoverable ProtectionBITRead0 = NO; 1 = Yes
CO103doc Bit 103System Irrecoverable ProtectionBITRead0 = No; 1 = Yes
CO108doc Bit 108Flow Switch ProtectionBITRead0 = Normal; 1 = protected
CO109doc Bit 1094-way valveBITRead0 = No; 1 = Yes
CO128doc Bit 128DC Bus Low-voltage or Voltage DropBITRead0 = Normal; 1 = Error
CO129doc Bit 129DC Bus Over-voltageBITRead0 = Normal; 1 = Error
CO130doc Bit 130AC Current Protection (Input Side)BITRead0 = Normal; 1 = Error
CO131doc Bit 131IPM ErrorBITRead0 = Normal; 1 = Error
CO132doc Bit 132PFC ErrorBITRead0 = Normal; 1 = Error
CO133doc Bit 133Startup ErrorBITRead0 = Normal; 1 = Error
CO134doc Bit 134Phase LossBITRead0 = Normal; 1 = Error
CO135doc Bit 135Drive Module ResettingBITRead0 = Normal; 1 = Error
CO136doc Bit 136Compressor OvercurrentBITRead0 = Normal; 1 = Error
CO137doc Bit 137Over-speedBITRead0 = Normal; 1 = Error
CO138doc Bit 138Charging Circuit Error or Current Sensor ErrorBITRead0 = Normal; 1 = Error
CO139doc Bit 139DesynchronizingBITRead0 = Normal; 1 = Error
CO140doc Bit 140Compressor StallingBITRead0 = Normal; 1 = Error
CO141doc Bit 141Drive Communication ErrorBITRead0 = Normal; 1 = Error
CO142doc Bit 142Radiator or IPM or PFC Over-temperatureBITRead0 = Normal; 1 = Error
CO143doc Bit 143Defective Radiator or IPM or PFCBITRead0 = Normal; 1 = Error
CO146doc Bit 146Charging Circuit ErrorBITRead0 = Normal; 1 = Error
CO147doc Bit 147AC Input Voltage ErrorBITRead0 = Normal; 1 = Error
CO148doc Bit 148Drive Board Temp Sensor ErrorBITRead0 = Normal; 1 = Error
CO149doc Bit 149AC Contactor Protection or Input Cross-zero ErrorBITRead0 = Normal; 1 = Error
CO150doc Bit 150Temp Drift ProtectionBITRead0 = Normal; 1 = Error
CO151doc Bit 151Sensor Connection Protection (Connection to Phase U or V failed)BITRead0 = Normal; 1 = Error
CO152doc Bit 152Condenser Leaving Water Temp Sensor ErrorBITRead0 = Normal; 1 = Error
CO153doc Bit 153E-heater Leaving Water Temp Sensor ErrorBITRead0 = Normal; 1 = Error
CO154doc Bit 154Refrigerant Liquid Temp Sensor ErrorBITRead0 = Normal; 1 = Error
CO155doc Bit 155Condenser Entering Water Temp Sensor ErrorBITRead0 = Normal; 1 = Error
CO156doc Bit 156Water Tank Temp Sensor ErrorBITRead0 = Normal; 1 = Error
CO158doc Bit 158Refrigerant Vapor Line Temp Sensor ErrorBITRead0 = Normal; 1 = Error
CO160doc Bit 160Remote Room Temp Sensor ErrorBITRead0 = Normal; 1 = Error
CO169doc Bit 169Other Heat Source StateBITRead0 = Off; 1 = On
CO170doc Bit 170Flow Switch StateBITRead0 = Close; 1 = Open
CO171doc Bit 171IDU E-heater 1 StateBITRead0 = Off; 1 = On
CO172doc Bit 172IDU E-heater 2 StateBITRead0 = Off; 1 = On
CO173doc Bit 173Water Tank Heater StateBITRead0 = Off; 1 = On
CO175doc Bit 175IDU Water Pump StateBITRead0 = Off; 1 = On
CO176doc Bit 176Circulating 2-way Valve StateBITRead0 = Off; 1 = On
CO179doc Bit 179Gate-CtrlBITRead0 = Card out; 1 = Card in
CO185doc Bit 185E-heater 1 Welding ProtectionBITRead0 = Normal; 1 = protected
CO186doc Bit 186E-heater 2 Welding ProtectionBITRead0 = Normal; 1 = protected
CO187doc Bit 187Water Heater Welding ProtectionBITRead0 = Normal; 1 = protected
CO188doc Bit 188Water Flow ProtectionBITRead0 = No; 1 = Yes
CO190doc Bit 190IDU Recoverable ProtectionBITRead0 = No; 1 = Yes
CO191doc Bit 191IDU Irrecoverable ProtectionBITRead0 = No; 1 = Yes
HR2doc Word 2ModeUINT16Read/write1 = Heat; 2 = Hot water; 3 = Cool+Heat water; 4 = Heat +Hot water; 5 = Cool
HR3doc Word 3Optional E-HeaterUINT16Read/write1 = 1 set; 2 = 2 sets; 3 = Off
HR4doc Word 4Disinfection TempRange 40-70°C, Default: 70°CUINT16°CRead/write
HR5doc Word 5Floor Debug SegmentsRange 1-10 sections Default : 1 sectionUINT16Read/write
HR6doc Word 6Floor Debug Period 1 tempRange 25-35°C, Default: 25°CUINT16°CRead/write
HR7doc Word 7Delta T of segmentRange 2-10°C, Default: 5°CUINT16°CRead/write
HR8doc Word 8Segment timeRange 12-72Hours, Default: 0 HourUINT16hRead/write
HR9doc Word 9WOT-CoolRange 7-25°C Default: 18°CUINT16°CRead/write
HR10doc Word 10WOT-HeatRange 20-60°C [High-temp] / 20-55°C[low-temp] Default: 45°C[High-temp]/45°C[Low-temp]UINT16°CRead/write
HR11doc Word 11RT-CoolRange 18-30°C, Default: 24°CUINT16°CRead/write
HR12doc Word 12RT-HeatRange 18-30°C, Default:20°CUINT16°CRead/write
HR13doc Word 13T-water tankRange 40-80°C, Default: 50°CUINT16°CRead/write
HR16doc Word 16T-HP maxRange 40-55°C, Default: 50°CUINT16°CRead/write
HR17doc Word 17Upper AT-HeatRange 10-37°C, Default:25°CUINT16°CRead/write
HR19doc Word 19Upper RT-HeatRange 22-30°C, Default: 24°CUINT16°CRead/write
HR20doc Word 20Lower RT-HeatRange 18-21°C, Default: 18°CUINT16°CRead/write
HR21doc Word 21Upper WT-HeatRange 46-60°C[High-temp]/ 46-55°C[Low-temp] Default: 55°C[High-temp]/55°C[Low-temp]UINT16°CRead/write
HR22doc Word 22Lower WT-HeatRange 20-45°C Default: 40°CUINT16°CRead/write
HR23doc Word 23Upper AT-CoolRange 26-48°C, Default :40°CUINT16°CRead/write
HR24doc Word 24Lower AT-CoolRange 10-25°C, Default :25°CUINT16°CRead/write
HR25doc Word 25Upper RT-CoolRange 24-30°C, Default : 27°CUINT16°CRead/write
HR26doc Word 26Lower RT-CoolRange 18-23°C, Default : 22°CUINT16°CRead/write
HR27doc Word 27Upper WT-CoolRange 15-25°C[with FCU] Default : 15°CUINT16°CRead/write
HR28doc Word 28Lower WT-CoolRange 7-14°C Default : 7°CUINT16°CRead/write
HR29doc Word 29Delta T-CoolRange 2-10°C, Default :5°CUINT16°CRead/write
HR30doc Word 30Delta T-HeatRange 2-10°C, Default :10°CUINT16°CRead/write
HR31doc Word 31Delta T-hot waterRange 2-8°C, Default :5°CUINT16°CRead/write
HR32doc Word 32Delta T-Room tempRange 1-5°C, Default :2°CUINT16°CRead/write
HR33doc Word 33Cool run timeRange 1-10min Default :3minUINT16minRead/write
HR34doc Word 34Heat run timeRange 1-10min Default :5minUINT16minRead/write
HR35doc Word 35Other thermal logicRange 1-3 Default :1UINT16Read/write
HR36doc Word 36Tank heaterRange 1-2 Default :1UINT16Read/write
HR37doc Word 37Optional E-Heater logicRange 1-2 Default :1UINT16Read/write
HR38doc Word 38Current limit valueRange 0-50A Default :16AUINT16ARead/write
HR39doc Word 39ThermostatUINT16Read/write0 = Without; 1 = Air; 2 = Air+hot water
HR40doc Word 40Force modeUINT16Read/write1 = Force-cool; 2 = Force-heat; 3 = Off
HR41doc Word 41Air removalUINT16Read/write1 = Air; 2 = Water tank; 3 = Off
HR42doc Word 42On/OffUINT16Read/write85 = Off (0x55); 170 = On (0xAA)
HR43doc Word 43Power limitRange 0-10 Kw Default :3 KwUINT16× 0.1kWRead/write
HR44doc Word 44Error resetUINT16Read/write0 = Does not clear fault; 1 = Clear fault
HR117doc Word 117Unit statusUINT16Read1 = Cool; 2 = Heat; 6 = Hot water; 8 = Off
HR132doc Word 132ThermostatUINT16Read1 = Cool; 2 = Heat; 3 = Off
HR133doc Word 133T-floor debugCalculated value.UINT16°CRead
HR134doc Word 134Debug timeCalculated value.UINT16hRead
HR135doc Word 135DisinfectionUINT16Read0 = Off; 1 = Running; 2 = Done; 3 = Failed
HR136doc Word 136Error Time for Floor DebugCalculated value.UINT16sRead
HR137doc Word 137T-weather dependCalculated value.UINT16°CRead
HR142doc Word 142Setting frequencyRange 0-100 Hz Default:0UINT16HzRead
HR143doc Word 143Running frequencyRange 0-100 Hz Default: 0UINT16HzRead

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 Versati heat pump water heater (wired-controller Modbus RTU, protocol V1.5)

What Modbus registers does the Gree Versati heat pump water heater (wired-controller Modbus RTU, protocol V1.5) have?

This map lists 142 registers: 93 coils, 49 holding registers. 63 of them can be written. Registers vary with firmware, options and configuration, so confirm against the device.

Are the Gree Versati heat pump water heater (wired-controller Modbus RTU, protocol V1.5) 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 (Bit 0 = Byte0.0). Word n is holding register n and Bit n is coil n on the wire; the protocol's example frames agree (read from word 1 sends 00 01, read from coil 5 sends 00 05).

What are the minimum Modbus registers to integrate the Gree Versati heat pump water heater (wired-controller Modbus RTU, protocol V1.5)?

Start with HR 42 On/Off (On/off); HR 2 Mode (Mode); HR 10 WOT-Heat (Heating water setpoint); HR 13 T-water tank (Tank setpoint); HR 117 Unit status (Unit status); HR 143 Running frequency (Compressor running frequency); CO 80 Compressor State (Compressor on); CO 86 Defrosting State (Defrosting); CO 102 System Recoverable Protection (System recoverable protection).

How do I enable Modbus control of the Gree Versati heat pump water heater (wired-controller Modbus RTU, protocol V1.5)?

On the wired controller press COMMISSION, then FUNCTION, page to 'Address', set the BMS address and press OK. The address must not be 0 or 126 and must match the address the BMS sends.

Where is the official Gree Versati heat pump water heater (wired-controller Modbus RTU, protocol V1.5) Modbus documentation?

The source is Modbus Protocol (V1.5) for the Versati Heat Pump Water Heater (V1.5). Gree doesn't publish it on its own website, so this map was re-typed from a free copy at https://man.kievclimate.com/man/Gree/Versati/Versati%20III/R32_Versati%20Modbus%20V1.5.pdf. It may be an older revision, so check it against the live unit.

More Gree Modbus register maps

Other pumps register maps

All pumps Modbus register maps →

Source: Modbus Protocol (V1.5) for the Versati Heat Pump Water Heater · V1.5 · unofficial copy. Register numbers, types, scaling and units are reproduced as published; descriptions are our own.