{
 "manufacturer": "Ecoforest",
 "manufacturer_slug": "ecoforest",
 "model": "ecoGEO / ecoAIR heat pump (API HP24 Client, Modbus RTU)",
 "model_slug": "ecogeo-ecoair-hp24",
 "short_model": "ecoGEO / ecoAIR HP24",
 "aliases": [
  "ecoGEO",
  "ecoGEO B&C",
  "ecoGEO HP",
  "ecoAIR",
  "AWD24",
  "WWD24",
  "WWC24",
  "API HP24_V01.02"
 ],
 "equipment_type": "Heat pump",
 "applies_to": "Ecoforest ecoGEO, ecoGEO HP and ecoAIR heat pumps on software AWD24, WWD24, WWC24 or later, register list API HP24_V01.02 (heat pump list only; supervisor and source-manager lists not included).",
 "summary": "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.",
 "transport": [
  "RTU"
 ],
 "defaults": {
  "unit_id": 17,
  "baud": 19200,
  "parity": "None",
  "data_bits": null,
  "stop_bits": 2,
  "tcp_port": null
 },
 "addressing": {
  "convention": "0-based",
  "note": "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."
 },
 "default_word_order": null,
 "firmware": "Heat pump software AWD24 / WWD24 / WWC24 and later; API HP24_V01.02",
 "source": {
  "title": "APIs BUS Client Manual (API HP Client manual)",
  "doc_number": "V03",
  "revision_date": "2024-12",
  "url": "https://taphome.com/compatibility/devices/ecoforest-hp24/manufacturer/manual-api-bus-client.pdf",
  "unofficial": true,
  "pages": "pp. 7-10 (port, enable, Modbus functions, frame examples); pp. 14-27 (heat pump register list, section 4)"
 },
 "notes": [
  "Ecoforest does not appear to host this manual publicly; the link is an unaltered copy of the Ecoforest manual on the TapHome integration site.",
  "The manual calls every BUS register a 16-bit analog value but never states whether it is signed, and prints no range for the temperature, pressure, DT, superheat and final-setpoint readings. Those readings (2080-2102, 2130-2144, 2150-2164) are therefore left out, as are the cooling setpoints 2723 and 2731-2739 whose lower limit is only given as T_lim. Writable setpoints whose printed range is entirely positive are listed as UINT16 (identical decoding inside that range); only 2777/2778, printed as -99.9 to 99.9 kW, are INT16. Humidity 2170-2174 is listed as UINT16 because relative humidity cannot be negative.",
  "Instantaneous powers 2186-2194 are left unscaled because their gain depends on register 2185 (W = 1, kW or MW = 0.1).",
  "Left out: the energy-meter block 2200-2461 (gain depends on per-period unit registers) and e-MANAGER power readings 2501-2508, model-code digit registers 2010-2023 and software version letters 2007-2009, and the duplicate 'Zone n temperature' entries at 2175-2179 whose meaning differs from 2140-2144 but is not explained.",
  "The heat pump status read (2045: 0 off, 1 on, 2 emergency) and the command register (2700: 1 off, 2 on, 3 emergency) use different codes; operation program likewise (2044 0-2, 2701 1-3).",
  "Software older than AWD24 / WWD24 / WWC24 is not compatible with this register list."
 ],
 "registers": [
  {
   "table": "holding_register",
   "address": 2000,
   "documented": "2000",
   "name": "Year (system)",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2001,
   "documented": "2001",
   "name": "Month (system)",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2002,
   "documented": "2002",
   "name": "Day (system)",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2003,
   "documented": "2003",
   "name": "Hour (system)",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2004,
   "documented": "2004",
   "name": "Minute (system)",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2005,
   "documented": "2005",
   "name": "Software platform",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "7": "ESO22",
    "12": "AWD24",
    "13": "WWD24",
    "14": "WWC24",
    "15": "ESO24",
    "16": "ESB24"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2006,
   "documented": "2006",
   "name": "Product range",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "1": "HP",
    "2": "PS",
    "3": "EM",
    "4": "SM"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2026,
   "documented": "2026",
   "name": "Device role",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "None",
    "1": "Individual master (IDU) / stand-alone",
    "2": "ecoGEO block master",
    "3": "Block slave",
    "4": "Supervisor",
    "5": "Individual slave",
    "6": "ecoAIR block master"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2030,
   "documented": "2030",
   "name": "DHW production mode status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2031,
   "documented": "2031",
   "name": "Heating production mode status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2032,
   "documented": "2032",
   "name": "Active cooling production mode status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2033,
   "documented": "2033",
   "name": "Passive cooling production mode status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2034,
   "documented": "2034",
   "name": "Pool production mode status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2035,
   "documented": "2035",
   "name": "Anti-freeze production mode status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2036,
   "documented": "2036",
   "name": "Dryfloor production mode status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2044,
   "documented": "2044",
   "name": "Operation program",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Winter",
    "1": "Summer",
    "2": "Combined"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2045,
   "documented": "2045",
   "name": "Heat pump status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On",
    "2": "Emergency"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2046,
   "documented": "2046",
   "name": "Integrated auxiliary heater status (Aux 1)",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2047,
   "documented": "2047",
   "name": "Generic external auxiliary heater status (Aux 2)",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2048,
   "documented": "2048",
   "name": "DHW auxiliary heater status (Aux 3)",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2049,
   "documented": "2049",
   "name": "Buffer auxiliary heater status (Aux 4)",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2050,
   "documented": "2050",
   "name": "Generic external auxiliary chiller status (Aux 5)",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2055,
   "documented": "2055",
   "name": "DHW recirculation status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2056,
   "documented": "2056",
   "name": "Group 1 status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2057,
   "documented": "2057",
   "name": "Group 2 status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2058,
   "documented": "2058",
   "name": "Group 3 status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2059,
   "documented": "2059",
   "name": "Group 4 status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2060,
   "documented": "2060",
   "name": "Group 5 status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2065,
   "documented": "2065",
   "name": "Alarm level",
   "description": "Most serious alarm level present.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "No alarm",
    "1": "Active alarm",
    "2": "Active alarm + recurrence",
    "3": "Recurrent alarm",
    "4": "Long time alarm",
    "5": "Lock-down due to alarm"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2066,
   "documented": "2066",
   "name": "Lock alarm code",
   "description": "Alarm code from the manual's Appendix 1 alarm list.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2067,
   "documented": "2067",
   "name": "Long time alarm code",
   "description": "Alarm code from the manual's Appendix 1 alarm list.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2068,
   "documented": "2068",
   "name": "Recurrence alarm code",
   "description": "Alarm code from the manual's Appendix 1 alarm list.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2069,
   "documented": "2069",
   "name": "Active alarm code 1",
   "description": "Alarm code from the manual's Appendix 1 alarm list.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2070,
   "documented": "2070",
   "name": "Active alarm code 2",
   "description": "Alarm code from the manual's Appendix 1 alarm list.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2071,
   "documented": "2071",
   "name": "Active alarm code 3",
   "description": "Alarm code from the manual's Appendix 1 alarm list.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2072,
   "documented": "2072",
   "name": "Active alarm code 4",
   "description": "Alarm code from the manual's Appendix 1 alarm list.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2073,
   "documented": "2073",
   "name": "Active alarm code 5",
   "description": "Alarm code from the manual's Appendix 1 alarm list.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2074,
   "documented": "2074",
   "name": "Reset alarm by BUS",
   "description": "Write 1 to reset alarms.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2103,
   "documented": "2103",
   "name": "Compressor starts (high part)",
   "description": "Starts = high x 1000 + low.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2104,
   "documented": "2104",
   "name": "Compressor starts (low part)",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2105,
   "documented": "2105",
   "name": "Compressor operating hours (high part)",
   "description": "Hours = high x 1000 + low.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "h",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2106,
   "documented": "2106",
   "name": "Compressor operating hours (low part)",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "h",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2170,
   "documented": "2170",
   "name": "Zone 1 humidity",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2171,
   "documented": "2171",
   "name": "Zone 2 humidity",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2172,
   "documented": "2172",
   "name": "Zone 3 humidity",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2173,
   "documented": "2173",
   "name": "Zone 4 humidity",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2174,
   "documented": "2174",
   "name": "Zone 5 humidity",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2185,
   "documented": "2185",
   "name": "Instantaneous power units",
   "description": "Sets the gain of 2186-2194: W gain 1, kW or MW gain 0.1.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "10": "W",
    "20": "kW",
    "30": "MW"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2186,
   "documented": "2186",
   "name": "Total heating power",
   "description": "Raw value; unit and gain set by register 2185.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2187,
   "documented": "2187",
   "name": "Heating service power",
   "description": "Raw value; unit and gain set by register 2185.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2188,
   "documented": "2188",
   "name": "DHW service power",
   "description": "Raw value; unit and gain set by register 2185.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2189,
   "documented": "2189",
   "name": "Pool service power",
   "description": "Raw value; unit and gain set by register 2185.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2190,
   "documented": "2190",
   "name": "Total cooling power",
   "description": "Raw value; unit and gain set by register 2185.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2191,
   "documented": "2191",
   "name": "Active cooling service power",
   "description": "Raw value; unit and gain set by register 2185.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2192,
   "documented": "2192",
   "name": "Passive cooling service power",
   "description": "Raw value; unit and gain set by register 2185.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2193,
   "documented": "2193",
   "name": "Total electric consumption",
   "description": "Raw value; unit and gain set by register 2185.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2194,
   "documented": "2194",
   "name": "Electric consumption in surplus mode",
   "description": "Raw value; unit and gain set by register 2185.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2690,
   "documented": "2690",
   "name": "New year (last digits)",
   "description": "Then confirm with 2695.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2691,
   "documented": "2691",
   "name": "New month",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2692,
   "documented": "2692",
   "name": "New day",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2693,
   "documented": "2693",
   "name": "New hour",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2694,
   "documented": "2694",
   "name": "New minute",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2695,
   "documented": "2695",
   "name": "Year replacement confirmation",
   "description": "Write 1 to apply the new value.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2696,
   "documented": "2696",
   "name": "Month replacement confirmation",
   "description": "Write 1 to apply the new value.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2697,
   "documented": "2697",
   "name": "Day replacement confirmation",
   "description": "Write 1 to apply the new value.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2698,
   "documented": "2698",
   "name": "Hour replacement confirmation",
   "description": "Write 1 to apply the new value.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2699,
   "documented": "2699",
   "name": "Minute replacement confirmation",
   "description": "Write 1 to apply the new value.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2700,
   "documented": "2700",
   "name": "Heat pump status command",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "1": "Off",
    "2": "On",
    "3": "Emergency"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2701,
   "documented": "2701",
   "name": "Operation program command",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "1": "Winter",
    "2": "Summer",
    "3": "Combined"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2705,
   "documented": "2705",
   "name": "DHW BUS control",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "No setpoint/offset by BUS",
    "1": "Setpoint/offset by BUS"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2706,
   "documented": "2706",
   "name": "DHW recirculation BUS control",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "No setpoint/offset by BUS",
    "1": "Setpoint/offset by BUS"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2707,
   "documented": "2707",
   "name": "Pool BUS control",
   "description": "With pool probe: setpoint/offset by BUS; without probe: 1 = demand by BUS.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2708,
   "documented": "2708",
   "name": "Group 1 demand",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "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"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2709,
   "documented": "2709",
   "name": "Group 2 demand",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "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"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2710,
   "documented": "2710",
   "name": "Group 3 demand",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "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"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2711,
   "documented": "2711",
   "name": "Group 4 demand",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "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"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2712,
   "documented": "2712",
   "name": "Group 5 demand",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "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"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2713,
   "documented": "2713",
   "name": "Heating buffer BUS control",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "No setpoint/offset by BUS",
    "1": "Setpoint/offset by BUS"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2714,
   "documented": "2714",
   "name": "Cooling buffer BUS control",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "No setpoint/offset by BUS",
    "1": "Setpoint/offset by BUS"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2715,
   "documented": "2715",
   "name": "HTR BUS control",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "No setpoint by BUS",
    "1": "Setpoint by BUS (fixed 3 °C offset)"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2720,
   "documented": "2720",
   "name": "DHW setpoint",
   "description": "BUS value, range 10.0-82.0 °C; used only when BUS control is enabled.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2721,
   "documented": "2721",
   "name": "DHW recirculation setpoint",
   "description": "BUS value, range 0.0-99.9 °C; used only when BUS control is enabled.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2722,
   "documented": "2722",
   "name": "Buffer tank heating setpoint",
   "description": "BUS value, range 20.0-T_lim °C; used only when BUS control is enabled.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2724,
   "documented": "2724",
   "name": "HTR setpoint by BUS",
   "description": "BUS value, range 0.0-82.0 °C; used only when BUS control is enabled.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2725,
   "documented": "2725",
   "name": "Offset DHW",
   "description": "BUS value, range 2.0-25.0 °C; used only when BUS control is enabled.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2726,
   "documented": "2726",
   "name": "Offset DHW recirculation",
   "description": "BUS value, range 0.0-99.9 °C; used only when BUS control is enabled.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2727,
   "documented": "2727",
   "name": "Offset heating buffer tank",
   "description": "BUS value, range 2.0-10.0 °C; used only when BUS control is enabled.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2728,
   "documented": "2728",
   "name": "Offset cooling buffer tank",
   "description": "BUS value, range 2.0-10.0 °C; used only when BUS control is enabled.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2729,
   "documented": "2729",
   "name": "HTR setpoint BUS",
   "description": "BUS value, range 0.5-20.0 °C; used only when BUS control is enabled.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2730,
   "documented": "2730",
   "name": "Heating group 1 setpoint",
   "description": "BUS value, range 20.0-T_lim °C; used only when BUS control is enabled.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2732,
   "documented": "2732",
   "name": "Heating group 2 setpoint",
   "description": "BUS value, range 20.0-T_lim °C; used only when BUS control is enabled.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2734,
   "documented": "2734",
   "name": "Heating group 3 setpoint",
   "description": "BUS value, range 20.0-T_lim °C; used only when BUS control is enabled.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2736,
   "documented": "2736",
   "name": "Heating group 4 setpoint",
   "description": "BUS value, range 20.0-T_lim °C; used only when BUS control is enabled.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2738,
   "documented": "2738",
   "name": "Heating group 5 setpoint",
   "description": "BUS value, range 20.0-T_lim °C; used only when BUS control is enabled.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2740,
   "documented": "2740",
   "name": "Pool setpoint",
   "description": "BUS value, range 20.0-T_lim °C; used only when BUS control is enabled.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2750,
   "documented": "2750",
   "name": "Zone 1 BUS terminal on/off",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2751,
   "documented": "2751",
   "name": "Zone 2 BUS terminal on/off",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2752,
   "documented": "2752",
   "name": "Zone 3 BUS terminal on/off",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2753,
   "documented": "2753",
   "name": "Zone 4 BUS terminal on/off",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2754,
   "documented": "2754",
   "name": "Zone 5 BUS terminal on/off",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2755,
   "documented": "2755",
   "name": "Zone 1 ambient temperature setpoint",
   "description": "Range 5.0-35.0 °C.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2756,
   "documented": "2756",
   "name": "Zone 2 ambient temperature setpoint",
   "description": "Range 5.0-35.0 °C.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2757,
   "documented": "2757",
   "name": "Zone 3 ambient temperature setpoint",
   "description": "Range 5.0-35.0 °C.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2758,
   "documented": "2758",
   "name": "Zone 4 ambient temperature setpoint",
   "description": "Range 5.0-35.0 °C.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2759,
   "documented": "2759",
   "name": "Zone 5 ambient temperature setpoint",
   "description": "Range 5.0-35.0 °C.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2765,
   "documented": "2765",
   "name": "Maximum compressor reference",
   "description": "Caps compressor modulation, 0-100.0 %.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "%",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2775,
   "documented": "2775",
   "name": "Surplus control enabled by BUS",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2776,
   "documented": "2776",
   "name": "Maximum consumption enabled by BUS",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2777,
   "documented": "2777",
   "name": "Surplus regulation setpoint",
   "description": "Range -99.9 to 99.9 kW.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "kW",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2778,
   "documented": "2778",
   "name": "Maximum consumption setpoint",
   "description": "Range -99.9 to 99.9 kW.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "kW",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  }
 ],
 "integration": {
  "summary": "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": [
   {
    "table": "holding_register",
    "address": 2045,
    "why": "Heat pump on/off/emergency"
   },
   {
    "table": "holding_register",
    "address": 2065,
    "why": "Alarm level"
   },
   {
    "table": "holding_register",
    "address": 2066,
    "why": "Lock alarm code"
   },
   {
    "table": "holding_register",
    "address": 2030,
    "why": "DHW production status"
   },
   {
    "table": "holding_register",
    "address": 2700,
    "why": "Switch heat pump"
   },
   {
    "table": "holding_register",
    "address": 2705,
    "why": "DHW setpoint by BUS flag"
   },
   {
    "table": "holding_register",
    "address": 2720,
    "why": "DHW setpoint by BUS"
   }
  ],
  "enable": "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.",
  "watchdog": null,
  "quirks": [
   "All values are single 16-bit registers with a fixed gain (0.1 for temperatures, pressures, humidity and setpoints).",
   "Counters over 999 are split: value = high part x 1000 + low part (2103/2104, 2105/2106).",
   "BUS setpoints are clamped to their ranges and only apply when the matching BUS-control flag is set; the final setpoints in 2150-2164 show the result (not mapped here because their sign is not stated).",
   "Date/time writes need the matching confirmation register (2695-2699) set to 1."
  ],
  "setup": [
   "RS-485 on the BMS2 port, 3-wire shielded twisted pair (Tx/Rx-, Tx/Rx+, GND).",
   "Defaults: 19200 baud, no parity, 2 stop bits; address 17 for a heat pump, 15 supervisor, 14 source manager.",
   "On ecoAIR outdoor units BMS2 links to the indoor unit, so an optional RS-485 card on the BMS port is needed for BUS access.",
   "Supported functions: 03, 06, 16."
  ],
  "gotchas": [
   "ecoAIR outdoor units serve this list only when configured as block slave or stand-alone.",
   "Check the API version shown in the user menu (Information) matches HP24_Client; older software uses a different list."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/ecoforest/ecogeo-ecoair-hp24",
 "address_note": "address = 0-based Modbus wire (PDU) address; documented = as printed in the source.",
 "note": "Re-typed from the manufacturer's public documentation (see source) and verified against it. Registers vary by firmware and options; verify against the live device before writing."
}
