{
 "manufacturer": "Acond",
 "manufacturer_slug": "acond",
 "model": "Acond heat pumps (Modbus TCP interface v2.35)",
 "model_slug": "acond-heat-pump-modbus-tcp",
 "short_model": "Acond Modbus TCP",
 "aliases": [
  "Acond PRO series",
  "Acond ModbusTCP v2.35"
 ],
 "equipment_type": "Heat pump",
 "applies_to": "Acond air-to-water and brine heat pumps with the ModbusTCP function activated, interface description version 2.35 dated 01.12.2022.",
 "summary": "Acond heat pumps act as a Modbus TCP slave on port 502 once a service technician has activated the function. Input registers report setpoints, sensor temperatures, a status bit field, the operating and regulation mode, fault codes and compressor speed or capacity. Holding registers let the master set room, hot water, pool and cooling targets, choose the mode, acknowledge faults and feed in its own room, outdoor, solar and pool temperatures.",
 "transport": [
  "TCP"
 ],
 "defaults": {
  "unit_id": 1,
  "baud": null,
  "parity": null,
  "data_bits": null,
  "stop_bits": null,
  "tcp_port": 502
 },
 "addressing": {
  "convention": "Modicon",
  "note": "Registers are printed as 30001- (input registers, read with function 4) and 40001- (holding registers, function 3/6/16). Drop the leading 3 or 4 and subtract one: 30007 is input register 6, 40006 is holding register 5."
 },
 "default_word_order": null,
 "firmware": null,
 "source": {
  "title": "Acond Modbus TCP INTERFACE DESCRIPTION",
  "doc_number": "Version 2.35",
  "revision_date": "2022-12-01",
  "url": "https://community.openenergymonitor.org/uploads/short-url/bJsxkmQiygrj9DNip0f8rSOgVU.pdf",
  "unofficial": true,
  "pages": "p. 1 settings; pp. 1-3 input registers; pp. 4-5 holding registers"
 },
 "notes": [
  "Acond's own site does not serve this description publicly (its older v2.34 link returns an HTML page); the link is an unaltered copy of Acond's PDF posted on the OpenEnergyMonitor forum.",
  "Every value is a single 16-bit register: 'Int' rows are INT16 (several have negative minimums printed) and 'Word' rows are bit fields. x10 rows are tenths of a degree.",
  "30020, 30024 and 40014 carry compressor speed in rpm on most series but heat pump power in W on the PRO series; the units field is left blank for that reason.",
  "Bit 5 of 30007 is printed with the same text as bit 4 (circuit 1 pump); it is reproduced as printed. Bits 11 and 13-15 are reserved.",
  "The fault code books referenced by 30021-30023 are not part of this document.",
  "30019 is printed with a x10 modifier but a min/max of 10/25; the x10 scale is kept as printed."
 ],
 "registers": [
  {
   "table": "input_register",
   "address": 0,
   "documented": "30001",
   "name": "T_set_indoor1",
   "description": "Desired room temperature, circuit 1 (10.0-30.0).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 1,
   "documented": "30002",
   "name": "T_act_indoor1",
   "description": "Room temperature sensor, circuit 1.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 2,
   "documented": "30003",
   "name": "T_set_indoor2",
   "description": "Desired room temperature, circuit 2.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 3,
   "documented": "30004",
   "name": "T_act_indoor2",
   "description": "Room temperature sensor, circuit 2.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 4,
   "documented": "30005",
   "name": "T_set_TUV",
   "description": "Desired hot water (DHW) temperature.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 5,
   "documented": "30006",
   "name": "T_act_TUV",
   "description": "Hot water (DHW) temperature sensor.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 6,
   "documented": "30007",
   "name": "TC_status",
   "description": "Heat pump status flags.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "Heat pump switched on",
    "1": "Heat pump running",
    "2": "Alarm",
    "3": "DHW being heated",
    "4": "Heating circuit 1 circulation pump running",
    "5": "Heating circuit circulation pump running (printed as circuit 1 again)",
    "6": "Solar circulation pump running",
    "7": "Swimming pool circulation pump running",
    "8": "Defrosting",
    "9": "Auxiliary heater operating",
    "10": "Summer operation",
    "12": "Cooling operation"
   },
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 7,
   "documented": "30008",
   "name": "T_set_water_back",
   "description": "Desired return water temperature.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 8,
   "documented": "30009",
   "name": "T_act_water_back",
   "description": "Return water temperature sensor.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 9,
   "documented": "30010",
   "name": "T_act_air",
   "description": "Outdoor temperature sensor.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 10,
   "documented": "30011",
   "name": "T_act_solar",
   "description": "Solar panel temperature sensor.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 11,
   "documented": "30012",
   "name": "T_act_pool",
   "description": "Swimming pool temperature sensor.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 12,
   "documented": "30013",
   "name": "T_set_pool",
   "description": "Desired swimming pool temperature.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 13,
   "documented": "30014",
   "name": "rezim_pan",
   "description": "Current operating mode.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Automatic mode",
    "1": "Heat pump only",
    "2": "Not used",
    "3": "Auxiliary heating only",
    "4": "Off mode",
    "5": "Manual mode",
    "6": "Cooling mode"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 14,
   "documented": "30015",
   "name": "typ_reg_pan",
   "description": "How the return water target is calculated.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "AcondTherm",
    "1": "Equitherm",
    "2": "Manual"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 15,
   "documented": "30016",
   "name": "T_solanka",
   "description": "Brine temperature at the collector outlet (ground-source units).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 16,
   "documented": "30017",
   "name": "HeartBeat",
   "description": "Counter 0-255 that changes on each exchange; use it to check the link.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 17,
   "documented": "30018",
   "name": "T_act_water_outlet",
   "description": "Outlet water temperature sensor.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 18,
   "documented": "30019",
   "name": "T_set_water_outlet",
   "description": "Desired outlet water temperature in cooling.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 19,
   "documented": "30020",
   "name": "Comp_rpm_max / Comp_capacity_max",
   "description": "Max compressor speed (rpm), or max output in W on PRO series.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 20,
   "documented": "30021",
   "name": "err_number",
   "description": "Basic fault code (0-62).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 21,
   "documented": "30022",
   "name": "err_number_SECMono",
   "description": "SECMono fault code (0-42).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 22,
   "documented": "30023",
   "name": "err_number_driver",
   "description": "Compressor driver fault code (0-39).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 23,
   "documented": "30024",
   "name": "comp_rpm_actual / comp_capacity_actual",
   "description": "Actual compressor speed (rpm), or current output in W on PRO series.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 0,
   "documented": "40001",
   "name": "T_set_indoor1",
   "description": "Desired room temperature, circuit 1 (10.0-30.0).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1,
   "documented": "40002",
   "name": "T_act_indoor1",
   "description": "Room temperature sent by the master for circuit 1 (0.0-50.0).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2,
   "documented": "40003",
   "name": "T_set_indoor2",
   "description": "Desired room temperature, circuit 2 (10.0-30.0).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 3,
   "documented": "40004",
   "name": "T_act_indoor2",
   "description": "Room temperature sent by the master for circuit 2 (0.0-50.0).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 4,
   "documented": "40005",
   "name": "T_set_TUV",
   "description": "Desired hot water temperature (10.0-46.0).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 5,
   "documented": "40006",
   "name": "TC_set",
   "description": "Mode selection and fault confirmation bits.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": {
    "0": "Automatic mode",
    "1": "Heat pump mode",
    "2": "Auxiliary heating mode",
    "3": "Off mode",
    "4": "Cooling mode",
    "5": "Fault confirmation",
    "6": "Solar on",
    "7": "Swimming pool on",
    "8": "Summer/winter switchover"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 6,
   "documented": "40007",
   "name": "TC_set_reg",
   "description": "Regulation method (0-2).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "AcondTherm",
    "1": "Equitherm",
    "2": "Manual"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 7,
   "documented": "40008",
   "name": "T_set_water_back",
   "description": "Desired return temperature in manual mode (10.0-65.0).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 8,
   "documented": "40009",
   "name": "T_air",
   "description": "Outdoor temperature sent by the master (-50.0 to 50.0).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9,
   "documented": "40010",
   "name": "T_act_solar",
   "description": "Solar system temperature sent by the master (-50.0 to 300.0).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10,
   "documented": "40011",
   "name": "T_act_pool",
   "description": "Pool temperature sent by the master (0.0-50.0).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 11,
   "documented": "40012",
   "name": "T_set_pool",
   "description": "Desired swimming pool temperature (10.0-50.0).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 12,
   "documented": "40013",
   "name": "T_set_water_cool",
   "description": "Desired heat pump outlet temperature in cooling (15.0-30.0).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 13,
   "documented": "40014",
   "name": "Comp_rpm_max / Comp_capacity_max",
   "description": "Speed limit 1800-6000 rpm, or capacity limit 2000-20000 W on PRO series.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  }
 ],
 "integration": {
  "summary": "Have Acond service enable ModbusTCP, tick ModbusTCP on the heat pump's web page, then poll input registers 30001-30024 with function 4 and write targets and TC_set at 40001-40014 regularly so the heat pump keeps using the master's values.",
  "minimum_registers": [
   {
    "table": "input_register",
    "address": 6,
    "why": "Status bits (on, running, alarm, defrost)"
   },
   {
    "table": "input_register",
    "address": 13,
    "why": "Operating mode"
   },
   {
    "table": "input_register",
    "address": 9,
    "why": "Outdoor temperature"
   },
   {
    "table": "input_register",
    "address": 8,
    "why": "Return water temperature"
   },
   {
    "table": "input_register",
    "address": 20,
    "why": "Fault code"
   },
   {
    "table": "holding_register",
    "address": 0,
    "why": "Room setpoint circuit 1"
   },
   {
    "table": "holding_register",
    "address": 4,
    "why": "Hot water setpoint"
   },
   {
    "table": "holding_register",
    "address": 5,
    "why": "Mode / fault reset bits"
   }
  ],
  "enable": "ModbusTCP is activated by an Acond service technician. Afterwards a ModbusTCP link appears on the heat pump's main web page; tick the ModbusTCP box in the dark blue bar to start communication.",
  "watchdog": "If no data is exchanged within MaxCommDataRefresh, the status shows 'ModbusTCP false' and values received from the master are replaced by the heat pump's own sensor readings until communication returns.",
  "quirks": [
   "Only one Modbus master may talk to the heat pump at a time.",
   "Unit ID 2 is reserved for the heat pump cascade; the slave answers as ID 1.",
   "A temperature written outside its range makes the heat pump use its own sensor value; an out-of-range setpoint is ignored."
  ],
  "setup": [
   "Modbus TCP on port 502; supported functions 3 and 4 for reading, 6 and 16 for writing."
  ],
  "gotchas": [
   "The last communication error stays on the status page only until the next successful exchange."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/acond/acond-heat-pump-modbus-tcp",
 "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."
}
