Easy Modbus
  1. Home
  2. Modbus register maps
  3. Ecoforest
  4. ecoGEO / ecoAIR heat pump (API HP24 Client, Modbus RTU)

Heat pump · Modbus register map

Ecoforest ecoGEO / ecoAIR heat pump (API HP24 Client, Modbus RTU) Modbus register map

Updated 17 November 2026

Short answer

Ecoforest's geothermal and air-source heat pumps expose the 'API HP Client' list over Modbus RTU on the BMS2 RS-485 port. Every value is a single 16-bit holding register with a fixed gain. This map covers status, alarms, compressor counters, humidity, service powers and the read/write BUS control and setpoint registers; temperature and pressure readings are left out because the manual does not state their sign.

This page lists 110 Modbus registers for the Ecoforest ecoGEO / ecoAIR heat pump (API HP24 Client, Modbus RTU) — 54 writable — with the table, 0-based wire address, data type, word order, scale, units and access of each, re-typed from Ecoforest’s own free documentation (linked below) and checked against it.

Manufacturer
Ecoforest
Model
ecoGEO / ecoAIR heat pump (API HP24 Client, Modbus RTU)
Equipment type
Heat pump
Registers
110 (54 writable)
Transport
Modbus RTU
Default unit ID
17
Default serial
19200 baud, 8N2
Documented addressing
0-based (the number printed is the address on the wire)
Firmware
Heat pump software AWD24 / WWD24 / WWC24 and later; API HP24_V01.02
Also known as
ecoGEO, ecoGEO B&C, ecoGEO HP, ecoAIR, AWD24, WWD24, WWC24, API HP24_V01.02
Source document
APIs BUS Client Manual (API HP Client manual) · V03 · rev. 2024-12 · unofficial copy
Download CSV all columns JSON Manufacturer PDF ↗

Integration notes: Ecoforest ecoGEO / ecoAIR heat pump (API HP24 Client, Modbus RTU)

Integration in brief

Enable BUS control in the installer menu, connect to BMS2 at 19200 baud, no parity, 2 stop bits, address 17, and poll the status and alarm registers 2030-2073 with function 03. Write 2700 to switch the heat pump and the 2705-2715 BUS-control flags before writing setpoints 2720-2759.

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 2045Heat pump statusUINT16Heat pump on/off/emergencyRead
HR 2065Alarm levelUINT16Alarm levelRead
HR 2066Lock alarm codeUINT16Lock alarm codeRead
HR 2030DHW production mode statusUINT16DHW production statusRead
HR 2700Heat pump status commandUINT16Switch heat pumpRead/write
HR 2705DHW BUS controlUINT16DHW setpoint by BUS flagRead/write
HR 2720DHW setpointUINT16DHW setpoint by BUSRead/write

Enable Modbus control & writes

Installer menu > Installation > Remote control > BUS Control > enable. Check the BMS2 port settings (protocol 'MB Extended') in the same Remote control submenu. On the source manager BUS control is always on.

Byte order & addressing

Network setup

Watch out for

Ecoforest ecoGEO / ecoAIR heat pump (API HP24 Client, Modbus RTU) 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.

110 of 110 shown
Ecoforest ecoGEO / ecoAIR heat pump (API HP24 Client, Modbus RTU) Modbus register map
TableAddressNameDescriptionTypeOrderScaleUnitsAccessValues / bits
HR2000Year (system)UINT16Read
HR2001Month (system)UINT16Read
HR2002Day (system)UINT16Read
HR2003Hour (system)UINT16Read
HR2004Minute (system)UINT16Read
HR2005Software platformUINT16Read7 = ESO22; 12 = AWD24; 13 = WWD24; 14 = WWC24; 15 = ESO24; 16 = ESB24
HR2006Product rangeUINT16Read1 = HP; 2 = PS; 3 = EM; 4 = SM
HR2026Device roleUINT16Read0 = None; 1 = Individual master (IDU) / stand-alone; 2 = ecoGEO block master; 3 = Block slave; 4 = Supervisor; 5 = Individual slave; 6 = ecoAIR block master
HR2030DHW production mode statusUINT16Read0 = Off; 1 = On
HR2031Heating production mode statusUINT16Read0 = Off; 1 = On
HR2032Active cooling production mode statusUINT16Read0 = Off; 1 = On
HR2033Passive cooling production mode statusUINT16Read0 = Off; 1 = On
HR2034Pool production mode statusUINT16Read0 = Off; 1 = On
HR2035Anti-freeze production mode statusUINT16Read0 = Off; 1 = On
HR2036Dryfloor production mode statusUINT16Read0 = Off; 1 = On
HR2044Operation programUINT16Read0 = Winter; 1 = Summer; 2 = Combined
HR2045Heat pump statusUINT16Read0 = Off; 1 = On; 2 = Emergency
HR2046Integrated auxiliary heater status (Aux 1)UINT16Read0 = Off; 1 = On
HR2047Generic external auxiliary heater status (Aux 2)UINT16Read0 = Off; 1 = On
HR2048DHW auxiliary heater status (Aux 3)UINT16Read0 = Off; 1 = On
HR2049Buffer auxiliary heater status (Aux 4)UINT16Read0 = Off; 1 = On
HR2050Generic external auxiliary chiller status (Aux 5)UINT16Read0 = Off; 1 = On
HR2055DHW recirculation statusUINT16Read0 = Off; 1 = On
HR2056Group 1 statusUINT16Read0 = Off; 1 = On
HR2057Group 2 statusUINT16Read0 = Off; 1 = On
HR2058Group 3 statusUINT16Read0 = Off; 1 = On
HR2059Group 4 statusUINT16Read0 = Off; 1 = On
HR2060Group 5 statusUINT16Read0 = Off; 1 = On
HR2065Alarm levelMost serious alarm level present.UINT16Read0 = No alarm; 1 = Active alarm; 2 = Active alarm + recurrence; 3 = Recurrent alarm; 4 = Long time alarm; 5 = Lock-down due to alarm
HR2066Lock alarm codeAlarm code from the manual's Appendix 1 alarm list.UINT16Read
HR2067Long time alarm codeAlarm code from the manual's Appendix 1 alarm list.UINT16Read
HR2068Recurrence alarm codeAlarm code from the manual's Appendix 1 alarm list.UINT16Read
HR2069Active alarm code 1Alarm code from the manual's Appendix 1 alarm list.UINT16Read
HR2070Active alarm code 2Alarm code from the manual's Appendix 1 alarm list.UINT16Read
HR2071Active alarm code 3Alarm code from the manual's Appendix 1 alarm list.UINT16Read
HR2072Active alarm code 4Alarm code from the manual's Appendix 1 alarm list.UINT16Read
HR2073Active alarm code 5Alarm code from the manual's Appendix 1 alarm list.UINT16Read
HR2074Reset alarm by BUSWrite 1 to reset alarms.UINT16Read/write0 = Off; 1 = On
HR2103Compressor starts (high part)Starts = high x 1000 + low.UINT16Read
HR2104Compressor starts (low part)UINT16Read
HR2105Compressor operating hours (high part)Hours = high x 1000 + low.UINT16hRead
HR2106Compressor operating hours (low part)UINT16hRead
HR2170Zone 1 humidityUINT16× 0.1%Read
HR2171Zone 2 humidityUINT16× 0.1%Read
HR2172Zone 3 humidityUINT16× 0.1%Read
HR2173Zone 4 humidityUINT16× 0.1%Read
HR2174Zone 5 humidityUINT16× 0.1%Read
HR2185Instantaneous power unitsSets the gain of 2186-2194: W gain 1, kW or MW gain 0.1.UINT16Read10 = W; 20 = kW; 30 = MW
HR2186Total heating powerRaw value; unit and gain set by register 2185.UINT16Read
HR2187Heating service powerRaw value; unit and gain set by register 2185.UINT16Read
HR2188DHW service powerRaw value; unit and gain set by register 2185.UINT16Read
HR2189Pool service powerRaw value; unit and gain set by register 2185.UINT16Read
HR2190Total cooling powerRaw value; unit and gain set by register 2185.UINT16Read
HR2191Active cooling service powerRaw value; unit and gain set by register 2185.UINT16Read
HR2192Passive cooling service powerRaw value; unit and gain set by register 2185.UINT16Read
HR2193Total electric consumptionRaw value; unit and gain set by register 2185.UINT16Read
HR2194Electric consumption in surplus modeRaw value; unit and gain set by register 2185.UINT16Read
HR2690New year (last digits)Then confirm with 2695.UINT16Read/write
HR2691New monthUINT16Read/write
HR2692New dayUINT16Read/write
HR2693New hourUINT16Read/write
HR2694New minuteUINT16Read/write
HR2695Year replacement confirmationWrite 1 to apply the new value.UINT16Read/write0 = Off; 1 = On
HR2696Month replacement confirmationWrite 1 to apply the new value.UINT16Read/write0 = Off; 1 = On
HR2697Day replacement confirmationWrite 1 to apply the new value.UINT16Read/write0 = Off; 1 = On
HR2698Hour replacement confirmationWrite 1 to apply the new value.UINT16Read/write0 = Off; 1 = On
HR2699Minute replacement confirmationWrite 1 to apply the new value.UINT16Read/write0 = Off; 1 = On
HR2700Heat pump status commandUINT16Read/write1 = Off; 2 = On; 3 = Emergency
HR2701Operation program commandUINT16Read/write1 = Winter; 2 = Summer; 3 = Combined
HR2705DHW BUS controlUINT16Read/write0 = No setpoint/offset by BUS; 1 = Setpoint/offset by BUS
HR2706DHW recirculation BUS controlUINT16Read/write0 = No setpoint/offset by BUS; 1 = Setpoint/offset by BUS
HR2707Pool BUS controlWith pool probe: setpoint/offset by BUS; without probe: 1 = demand by BUS.UINT16Read/write0 = Off; 1 = On
HR2708Group 1 demandUINT16Read/write0 = No demand by BUS; 1 = Heating demand and setpoint by BUS; 2 = Cooling demand and setpoint by BUS; 11 = Heating demand by BUS, setpoint from HP; 12 = Cooling demand by BUS, setpoint from HP
HR2709Group 2 demandUINT16Read/write0 = No demand by BUS; 1 = Heating demand and setpoint by BUS; 2 = Cooling demand and setpoint by BUS; 11 = Heating demand by BUS, setpoint from HP; 12 = Cooling demand by BUS, setpoint from HP
HR2710Group 3 demandUINT16Read/write0 = No demand by BUS; 1 = Heating demand and setpoint by BUS; 2 = Cooling demand and setpoint by BUS; 11 = Heating demand by BUS, setpoint from HP; 12 = Cooling demand by BUS, setpoint from HP
HR2711Group 4 demandUINT16Read/write0 = No demand by BUS; 1 = Heating demand and setpoint by BUS; 2 = Cooling demand and setpoint by BUS; 11 = Heating demand by BUS, setpoint from HP; 12 = Cooling demand by BUS, setpoint from HP
HR2712Group 5 demandUINT16Read/write0 = No demand by BUS; 1 = Heating demand and setpoint by BUS; 2 = Cooling demand and setpoint by BUS; 11 = Heating demand by BUS, setpoint from HP; 12 = Cooling demand by BUS, setpoint from HP
HR2713Heating buffer BUS controlUINT16Read/write0 = No setpoint/offset by BUS; 1 = Setpoint/offset by BUS
HR2714Cooling buffer BUS controlUINT16Read/write0 = No setpoint/offset by BUS; 1 = Setpoint/offset by BUS
HR2715HTR BUS controlUINT16Read/write0 = No setpoint by BUS; 1 = Setpoint by BUS (fixed 3 °C offset)
HR2720DHW setpointBUS value, range 10.0-82.0 °C; used only when BUS control is enabled.UINT16× 0.1°CRead/write
HR2721DHW recirculation setpointBUS value, range 0.0-99.9 °C; used only when BUS control is enabled.UINT16× 0.1°CRead/write
HR2722Buffer tank heating setpointBUS value, range 20.0-T_lim °C; used only when BUS control is enabled.UINT16× 0.1°CRead/write
HR2724HTR setpoint by BUSBUS value, range 0.0-82.0 °C; used only when BUS control is enabled.UINT16× 0.1°CRead/write
HR2725Offset DHWBUS value, range 2.0-25.0 °C; used only when BUS control is enabled.UINT16× 0.1°CRead/write
HR2726Offset DHW recirculationBUS value, range 0.0-99.9 °C; used only when BUS control is enabled.UINT16× 0.1°CRead/write
HR2727Offset heating buffer tankBUS value, range 2.0-10.0 °C; used only when BUS control is enabled.UINT16× 0.1°CRead/write
HR2728Offset cooling buffer tankBUS value, range 2.0-10.0 °C; used only when BUS control is enabled.UINT16× 0.1°CRead/write
HR2729HTR setpoint BUSBUS value, range 0.5-20.0 °C; used only when BUS control is enabled.UINT16× 0.1°CRead/write
HR2730Heating group 1 setpointBUS value, range 20.0-T_lim °C; used only when BUS control is enabled.UINT16× 0.1°CRead/write
HR2732Heating group 2 setpointBUS value, range 20.0-T_lim °C; used only when BUS control is enabled.UINT16× 0.1°CRead/write
HR2734Heating group 3 setpointBUS value, range 20.0-T_lim °C; used only when BUS control is enabled.UINT16× 0.1°CRead/write
HR2736Heating group 4 setpointBUS value, range 20.0-T_lim °C; used only when BUS control is enabled.UINT16× 0.1°CRead/write
HR2738Heating group 5 setpointBUS value, range 20.0-T_lim °C; used only when BUS control is enabled.UINT16× 0.1°CRead/write
HR2740Pool setpointBUS value, range 20.0-T_lim °C; used only when BUS control is enabled.UINT16× 0.1°CRead/write
HR2750Zone 1 BUS terminal on/offUINT16Read/write0 = Off; 1 = On
HR2751Zone 2 BUS terminal on/offUINT16Read/write0 = Off; 1 = On
HR2752Zone 3 BUS terminal on/offUINT16Read/write0 = Off; 1 = On
HR2753Zone 4 BUS terminal on/offUINT16Read/write0 = Off; 1 = On
HR2754Zone 5 BUS terminal on/offUINT16Read/write0 = Off; 1 = On
HR2755Zone 1 ambient temperature setpointRange 5.0-35.0 °C.UINT16× 0.1°CRead/write
HR2756Zone 2 ambient temperature setpointRange 5.0-35.0 °C.UINT16× 0.1°CRead/write
HR2757Zone 3 ambient temperature setpointRange 5.0-35.0 °C.UINT16× 0.1°CRead/write
HR2758Zone 4 ambient temperature setpointRange 5.0-35.0 °C.UINT16× 0.1°CRead/write
HR2759Zone 5 ambient temperature setpointRange 5.0-35.0 °C.UINT16× 0.1°CRead/write
HR2765Maximum compressor referenceCaps compressor modulation, 0-100.0 %.UINT16× 0.1%Read/write
HR2775Surplus control enabled by BUSUINT16Read/write0 = Off; 1 = On
HR2776Maximum consumption enabled by BUSUINT16Read/write0 = Off; 1 = On
HR2777Surplus regulation setpointRange -99.9 to 99.9 kW.INT16× 0.1kWRead/write
HR2778Maximum consumption setpointRange -99.9 to 99.9 kW.INT16× 0.1kWRead/write

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 Ecoforest ecoGEO / ecoAIR heat pump (API HP24 Client, Modbus RTU)

What Modbus registers does the Ecoforest ecoGEO / ecoAIR heat pump (API HP24 Client, Modbus RTU) have?

This map lists 110 registers: 110 holding registers. 54 of them can be written. Registers vary with firmware, options and configuration, so confirm against the device.

Are the Ecoforest ecoGEO / ecoAIR heat pump (API HP24 Client, Modbus RTU) 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. Addresses are printed in decimal and go on the wire unchanged: the manual's read example for outdoor temperature (address 2080) sends start register 08 20 hex, and the write example for heat pump status (2700) sends 0A 8C hex.

What are the minimum Modbus registers to integrate the Ecoforest ecoGEO / ecoAIR heat pump (API HP24 Client, Modbus RTU)?

Start with HR 2045 Heat pump status (Heat pump on/off/emergency); HR 2065 Alarm level (Alarm level); HR 2066 Lock alarm code (Lock alarm code); HR 2030 DHW production mode status (DHW production status); HR 2700 Heat pump status command (Switch heat pump); HR 2705 DHW BUS control (DHW setpoint by BUS flag); HR 2720 DHW setpoint (DHW setpoint by BUS).

How do I enable Modbus control of the Ecoforest ecoGEO / ecoAIR heat pump (API HP24 Client, Modbus RTU)?

Installer menu > Installation > Remote control > BUS Control > enable. Check the BMS2 port settings (protocol 'MB Extended') in the same Remote control submenu. On the source manager BUS control is always on.

Where is the official Ecoforest ecoGEO / ecoAIR heat pump (API HP24 Client, Modbus RTU) Modbus documentation?

The source is APIs BUS Client Manual (API HP Client manual) (V03), revision 2024-12. Ecoforest doesn't publish it on its own website, so this map was re-typed from a free copy at https://taphome.com/compatibility/devices/ecoforest-hp24/manufacturer/manual-api-bus-client.pdf. It may be an older revision, so check it against the live unit.

Other pumps register maps

All pumps Modbus register maps →

Source: APIs BUS Client Manual (API HP Client manual) · V03 · rev. 2024-12 · unofficial copy. Register numbers, types, scaling and units are reproduced as published; descriptions are our own.