{
 "manufacturer": "Danfoss",
 "manufacturer_slug": "danfoss",
 "model": "Optyma iCO2 gateway (OP-MPAM015 / OP-MPAM005)",
 "model_slug": "optyma-ico2-gateway",
 "short_model": "Optyma iCO2",
 "aliases": [
  "OP-MPAM015",
  "OP-MPAM005",
  "Optyma iCO2 4.6 kW MT",
  "Optyma iCO2 20 kW MT / 10 kW LT"
 ],
 "equipment_type": "Sensor / controller (CO2 condensing unit gateway)",
 "applies_to": "Danfoss Optyma iCO2 CO2 condensing units (4.6 kW MT and 20 kW MT / 10 kW LT) through their Modbus gateway, software 1.0x.",
 "summary": "The Optyma iCO2 gateway exposes Danfoss's CO2 condensing units to a supervisor over RS-485 Modbus RTU. All values are single 16-bit holding registers addressed by PNU. This map covers the main switch, suction setpoint, day/night clock, high/receiver/suction pressures, temperatures, fan and compressor speed, valve openings and status.",
 "transport": [
  "RTU"
 ],
 "defaults": {
  "unit_id": null,
  "baud": null,
  "parity": "Even",
  "data_bits": 8,
  "stop_bits": 1,
  "tcp_port": null
 },
 "addressing": {
  "convention": "1-based",
  "note": "The guide states every PNU is the register address plus 1: PNU 100 is requested as 0x63 (99)."
 },
 "default_word_order": null,
 "firmware": "SW 1.0x",
 "source": {
  "title": "Programming Guide, Basic Modbus parameter list, Optyma iCO2 gateway (OP-MPAM015 and OP-MPAM005), SW Ver. 1.0x",
  "doc_number": "AU459739305217en-000201",
  "revision_date": "2024-08",
  "url": "https://assets.danfoss.com/documents/424639/AU459739305217en-000201.pdf",
  "pages": "pp. 3-4 (parameters), p. 5 (Modbus RTU information)"
 },
 "notes": [
  "Scale follows the 'Decimals' column: 1 decimal = value x10 on the wire (127 = 12.7), 2 decimals = x100. The SW version row has no decimals entry and is left unscaled.",
  "The list header says all values are in °C / bar(g), while the unit column prints °C/°F and bar/PSI. Units here follow the header.",
  "The alarm list (PNU 20000-20021) is left out: its PDF layout does not pair each alarm code with a PNU unambiguously.",
  "Baud rate switches automatically between 19200 and 38400; even parity, 8 data bits, 1 stop bit.",
  "Signedness is not printed; registers with negative minimums are listed as INT16."
 ],
 "registers": [
  {
   "table": "holding_register",
   "address": 99,
   "documented": "100",
   "name": "r23 Ts Ref",
   "description": "",
   "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": 116,
   "documented": "117",
   "name": "r12 Main switch",
   "description": "Main switch for the unit.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "-1": "Manual mode",
    "0": "Standby",
    "1": "On",
    "2": "Vacuum mode"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 119,
   "documented": "120",
   "name": "Reference",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2002,
   "documented": "2003",
   "name": "FW Version",
   "description": "Gateway firmware: high byte major, low byte minor.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2006,
   "documented": "2007",
   "name": "Ctrl. State",
   "description": "Remote readout of the control state.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Normal control",
    "10": "Standby",
    "25": "Manual mode",
    "34": "Safety stop",
    "101": "Restart state (high pressure)",
    "102": "Restart state (fan motor)",
    "103": "Restart state (discharge temp.)",
    "104": "Restart state (receiver pressure)"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2540,
   "documented": "2541",
   "name": "EKC Error",
   "description": "Summary alarm, 1 = active.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10001,
   "documented": "10002",
   "name": "u13 NightCond",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Day",
    "1": "Night"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10002,
   "documented": "10003",
   "name": "OpCond",
   "description": "Unit operating condition code.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10003,
   "documented": "10004",
   "name": "r43 Night Offset",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10013,
   "documented": "10014",
   "name": "F07 Fan Speed%",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10017,
   "documented": "10018",
   "name": "t17 Day start h",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "h",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10018,
   "documented": "10019",
   "name": "t18 Night start h",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "h",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10019,
   "documented": "10020",
   "name": "o08 SW version",
   "description": "Software version of the condensing unit.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10025,
   "documented": "10026",
   "name": "u10 DI1 Status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10026,
   "documented": "10027",
   "name": "u21 Superheat K",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "K",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10027,
   "documented": "10028",
   "name": "u37 DI2 Status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10028,
   "documented": "10029",
   "name": "u 52 CompCap%",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10029,
   "documented": "10030",
   "name": "u01 Pc bar",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "bar",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10030,
   "documented": "10031",
   "name": "U05 Sgc Temp",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10031,
   "documented": "10032",
   "name": "U07 Srec2 temp",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10032,
   "documented": "10033",
   "name": "U08 Prec pressure",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "bar",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10033,
   "documented": "10034",
   "name": "U09 Trec temp",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10034,
   "documented": "10035",
   "name": "U22 Tc",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10035,
   "documented": "10036",
   "name": "U23 Po",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "bar",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10036,
   "documented": "10037",
   "name": "U24 To",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10037,
   "documented": "10038",
   "name": "U25 T Ambient",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10038,
   "documented": "10039",
   "name": "U26 T Discharge",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10039,
   "documented": "10040",
   "name": "U27 T Suction",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10040,
   "documented": "10041",
   "name": "U62 Alarm Relay",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10041,
   "documented": "10042",
   "name": "U91 Vhp %",
   "description": "High pressure valve opening.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10042,
   "documented": "10043",
   "name": "U92 Vrec %",
   "description": "Receiver pressure valve opening.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10043,
   "documented": "10044",
   "name": "U80 FW Version",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10053,
   "documented": "10054",
   "name": "U78 DynLP OFF",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10054,
   "documented": "10055",
   "name": "U79 DynLP ON",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 15000,
   "documented": "15001",
   "name": "t07 Clk Hours",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "h",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 15001,
   "documented": "15002",
   "name": "t08 Clk Minutes",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "min",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  }
 ],
 "integration": {
  "summary": "Read the pressures, temperatures and speeds with function 03 and use the summary alarm and control state for status. Write r12 Main switch and r23 suction setpoint with function 06.",
  "minimum_registers": [
   {
    "table": "holding_register",
    "address": 116,
    "why": "Main switch"
   },
   {
    "table": "holding_register",
    "address": 99,
    "why": "Suction setpoint"
   },
   {
    "table": "holding_register",
    "address": 10029,
    "why": "High pressure"
   },
   {
    "table": "holding_register",
    "address": 10035,
    "why": "Suction pressure"
   },
   {
    "table": "holding_register",
    "address": 10037,
    "why": "Ambient temperature"
   },
   {
    "table": "holding_register",
    "address": 10028,
    "why": "Compressor speed %"
   },
   {
    "table": "holding_register",
    "address": 2540,
    "why": "Summary alarm"
   },
   {
    "table": "holding_register",
    "address": 2006,
    "why": "Control state"
   }
  ],
  "enable": "Set the slave address with parameter o03 on the MMILDS display.",
  "watchdog": null,
  "quirks": [
   "Request PNU - 1 on the wire (PNU 100 = address 99).",
   "Every value is one 16-bit holding register; one decimal in the list means the raw value is x10, two decimals x100."
  ],
  "setup": [
   "Set the slave address with o03 on the MMILDS display.",
   "Line settings: even parity, 8 data bits, 1 stop bit; the baud rate switches automatically between 19200 and 38400."
  ],
  "gotchas": [
   "The list remarks 'MBP CDU-ECU can receive only' against r23 Suction pressure setpoint; check the unit variant before relying on writes to it.",
   "Writes are also accepted by broadcast (address 0)."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/danfoss/optyma-ico2-gateway",
 "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."
}
