{
 "manufacturer": "ABB",
 "manufacturer_slug": "abb",
 "model": "SACE Tmax PR223DS trip unit (Modbus RTU)",
 "model_slug": "tmax-pr223ds-modbus",
 "short_model": "PR223DS",
 "aliases": [
  "PR223DS",
  "Tmax PR223DS",
  "SACE PR223DS"
 ],
 "equipment_type": "Power meter (circuit breaker trip unit)",
 "applies_to": "ABB SACE PR223DS electronic trip unit (Tmax moulded-case breakers), software version 02.02, per 1SDH000658R0001.",
 "summary": "The PR223DS trip unit on Tmax moulded-case breakers has a built-in Modbus RTU interface. Measurements, status, alarms and trip data are input registers; open, close and reset commands are single holding registers set to 1. 32-bit power and energy values are sent low word first.",
 "transport": [
  "RTU"
 ],
 "defaults": {
  "unit_id": 247,
  "baud": 19200,
  "parity": "Even",
  "data_bits": 8,
  "stop_bits": 1,
  "tcp_port": null
 },
 "addressing": {
  "convention": "Modicon",
  "note": "Each register row gives the absolute address (30001/40001 style) and a 'Relative Address - 1 (HEX)' column that goes in the Modbus message (30101 = 0064h, 40001 = 0000h). This applies with the default 'Standard' addressing type."
 },
 "default_word_order": "CDAB",
 "firmware": "SW 02.02",
 "source": {
  "title": "PR223DS Modbus System Interface - Instruction manual",
  "doc_number": "1SDH000658R0001",
  "revision_date": null,
  "url": "https://library.e.abb.com/public/dfe9aa822695b773c125780800716f6c/1SDH000658R0001.pdf",
  "pages": "Addressing p. 12; default comms p. 17; data organization p. 27; registers pp. 28-40; commands pp. 48-51; serial parameters p. 8; operating mode p. 19; command conditions pp. 22-24"
 },
 "notes": [
  "The manual says double words are little-endian by word (least significant word first) and big-endian within each word, so 32-bit registers here are CDAB.",
  "Default communication parameters (address 247, 19200 baud, even parity, Standard addressing) apply until set with the Test Unit; they can only be changed locally.",
  "Currents read in amps once the nominal current is set; if 'Nominal current unknown' (status bit 13) is set they read as a percentage of In (150 = 1.5 In).",
  "Voltages, power, energy and frequency need the VM210 voltage module; without it they read 0.",
  "Commands run only in remote operating mode and one at a time. The remote signalling contact commands are left out because their hex addresses (0029h, 002Ah) do not match the absolute addresses 40041/40043.",
  "Read the currents as a 5-register block, not one at a time, as the manual asks."
 ],
 "registers": [
  {
   "table": "input_register",
   "address": 6,
   "documented": "30007",
   "name": "CB number of operations",
   "description": "Transitions to open, any cause.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 8,
   "documented": "30009",
   "name": "CB number of protection trips",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 33,
   "documented": "30034",
   "name": "Status",
   "description": "Breaker and trip unit status.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "Any alarm",
    "1": "Any trip",
    "2": "CB tripped",
    "3": "CB closed (0 = open)",
    "4": "Trip command fail",
    "5": "Other trip (test, UVR, SOR)",
    "6": "Local mode (0 = remote)",
    "7": "Programming OK",
    "8": "Programming fail",
    "11": "EEPROM parameters error",
    "12": "AUX-E unknown",
    "13": "Nominal current unknown",
    "14": "Serial parameters unknown",
    "15": "Trip data available"
   },
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 34,
   "documented": "30035",
   "name": "Alarms",
   "description": "",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "L pre-alarm",
    "1": "L alarm (timing/tripping)",
    "2": "S alarm (timing/tripping)",
    "3": "G alarm (timing/tripping)",
    "4": "Motor command overheated",
    "11": "DSP fault",
    "13": "TC error",
    "14": "Frequency out of range",
    "15": "Clock oscillator fault"
   },
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 35,
   "documented": "30036",
   "name": "Trips",
   "description": "Held until trip reset.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "L tripped",
    "1": "S tripped",
    "2": "I tripped",
    "3": "G tripped"
   },
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 36,
   "documented": "30037",
   "name": "DO status",
   "description": "",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "DO1",
    "1": "DO2",
    "2": "DO3",
    "3": "DO4",
    "4": "DO5",
    "5": "DO6",
    "6": "DO7",
    "7": "DO8"
   },
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 100,
   "documented": "30101",
   "name": "RMS current phase 1",
   "description": "Percent x 100 of In if nominal current is unknown.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 101,
   "documented": "30102",
   "name": "RMS current phase 2",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 102,
   "documented": "30103",
   "name": "RMS current phase 3",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 103,
   "documented": "30104",
   "name": "RMS current neutral",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 104,
   "documented": "30105",
   "name": "RMS current ground",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 106,
   "documented": "30107",
   "name": "Voltage V1-N",
   "description": "0xFFFF = not available; needs VM210.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 107,
   "documented": "30108",
   "name": "Voltage V2-N",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 108,
   "documented": "30109",
   "name": "Voltage V3-N",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 109,
   "documented": "30110",
   "name": "Voltage V12",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 110,
   "documented": "30111",
   "name": "Voltage V23",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 111,
   "documented": "30112",
   "name": "Voltage V31",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 113,
   "documented": "30114",
   "name": "Active power phase 1",
   "description": "0x7FFFFFFF = not available.",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kW",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 115,
   "documented": "30116",
   "name": "Active power phase 2",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kW",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 117,
   "documented": "30118",
   "name": "Active power phase 3",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kW",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 119,
   "documented": "30120",
   "name": "Total active power",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kW",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 121,
   "documented": "30122",
   "name": "Reactive power phase 1",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kVAR",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 123,
   "documented": "30124",
   "name": "Reactive power phase 2",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kVAR",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 125,
   "documented": "30126",
   "name": "Reactive power phase 3",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kVAR",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 127,
   "documented": "30128",
   "name": "Total reactive power",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kVAR",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 129,
   "documented": "30130",
   "name": "Apparent power phase 1",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kVA",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 131,
   "documented": "30132",
   "name": "Apparent power phase 2",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kVA",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 133,
   "documented": "30134",
   "name": "Apparent power phase 3",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kVA",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 135,
   "documented": "30136",
   "name": "Total apparent power",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kVA",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 138,
   "documented": "30139",
   "name": "Peak factor phase 1",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 142,
   "documented": "30143",
   "name": "Total power factor",
   "description": "Signed.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 143,
   "documented": "30144",
   "name": "Frequency",
   "description": "0xFFFF when all voltages are below 80 V.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "Hz",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 145,
   "documented": "30146",
   "name": "Positive active energy",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kWh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 147,
   "documented": "30148",
   "name": "Positive reactive energy",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kVARh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 149,
   "documented": "30150",
   "name": "Apparent energy",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kVAh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 151,
   "documented": "30152",
   "name": "Negative active energy",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kWh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 153,
   "documented": "30154",
   "name": "Negative reactive energy",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kVARh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 155,
   "documented": "30156",
   "name": "Max active power in 15 minutes",
   "description": "Highest 15-minute mean, stored.",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.1,
   "units": "kW",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 200,
   "documented": "30201",
   "name": "Trip current phase 1",
   "description": "Measured at the last trip.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 201,
   "documented": "30202",
   "name": "Trip current phase 2",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 202,
   "documented": "30203",
   "name": "Trip current phase 3",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 0,
   "documented": "40001",
   "name": "CB open command",
   "description": "Write 1 to open; remote mode only.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "W",
   "values": {
    "0": "No execution",
    "1": "Execute"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2,
   "documented": "40003",
   "name": "CB close command",
   "description": "Write 1 to close; remote mode only.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "W",
   "values": {
    "0": "No execution",
    "1": "Execute"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 4,
   "documented": "40005",
   "name": "CB reset command",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "W",
   "values": {
    "0": "No execution",
    "1": "Execute"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 12,
   "documented": "40013",
   "name": "Trip reset command",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "W",
   "values": {
    "0": "No execution",
    "1": "Execute"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 22,
   "documented": "40023",
   "name": "Wink command",
   "description": "Flashes the trip unit LED.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "W",
   "values": {
    "0": "No execution",
    "1": "Execute"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 26,
   "documented": "40027",
   "name": "Reset communication statistics",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "W",
   "values": {
    "0": "No execution",
    "1": "Execute"
   },
   "bits": null,
   "offset": 0
  }
 ],
 "integration": {
  "summary": "Read input registers 30101-30156 with function 4 for currents, voltages, power and energy, and 30034-30036 for status, alarms and trips. Write 1 to 40001 / 40003 to open or close.",
  "minimum_registers": [
   {
    "table": "input_register",
    "address": 33,
    "why": "CB open/closed/tripped, local/remote"
   },
   {
    "table": "input_register",
    "address": 35,
    "why": "Which protection tripped"
   },
   {
    "table": "input_register",
    "address": 100,
    "why": "Phase 1 current"
   },
   {
    "table": "input_register",
    "address": 119,
    "why": "Total active power"
   },
   {
    "table": "input_register",
    "address": 145,
    "why": "Active energy"
   },
   {
    "table": "holding_register",
    "address": 0,
    "why": "Open command"
   }
  ],
  "enable": "Modbus is built into the trip unit; address, baud, parity and addressing type are set locally with the ABB Test Unit. Remote commands need the trip unit in Remote mode (LOCAL/REMOTE button); CB open/close also fails if the motor operator selector is on MANUAL or the motor command is faulty.",
  "watchdog": null,
  "quirks": [
   "32-bit values are low word first.",
   "Measurements use function 4 (input registers).",
   "Event bits in 30033 clear after reading."
  ],
  "setup": [
   "Defaults: address 247, 19200 baud, even parity; 9600 baud and odd/no parity also allowed."
  ],
  "gotchas": [
   "Factory address is 247.",
   "Only one command is processed at a time; a second pending command is refused."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/abb/tmax-pr223ds-modbus",
 "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."
}
