{
 "manufacturer": "ABB",
 "manufacturer_slug": "abb",
 "model": "SACE PR122/P, PR123/P, PR332/P, PR333/P trip units with PR120/D-M or PR330/D-M (Modbus RTU)",
 "model_slug": "pr122-pr123-pr332-pr333-modbus",
 "short_model": "PR122/PR123 Modbus",
 "aliases": [
  "PR122/P",
  "PR123/P",
  "PR332/P",
  "PR333/P",
  "PR120/D-M",
  "PR330/D-M",
  "Emax PR122",
  "Emax PR123",
  "Tmax T7 PR332",
  "Emax X1 PR333",
  "Tmax T8 PR332"
 ],
 "equipment_type": "Power meter (circuit breaker trip unit)",
 "applies_to": "ABB SACE PR122/P and PR123/P (Emax) and PR332/P and PR333/P (Emax X1, Tmax T7, Tmax T8) protection releases with the Modbus RTU communication module, per 1SDH000556R0001.",
 "summary": "ABB's PR12x and PR33x electronic trip units talk Modbus RTU through the PR120/D-M (or PR330/D-M) com module. Run-time measures (currents, voltages, power, energy, frequency) and breaker state are input registers; commands such as open, close and trip reset go to two holding registers. 32-bit 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": "The map gives relative addresses with 30001 (input registers, function 4) and 40001 (holding registers) bases; its example says run-time measures at offset 200 are 30201, relative address 200. The relative address is what goes on the wire with the default 'Standard' addressing type."
 },
 "default_word_order": "CDAB",
 "firmware": null,
 "source": {
  "title": "Modbus system Interface for Protection relays PR122/P and PR123/P + communication module PR120/D-M, mounted on CB New Emax; Protection relays PR332/P and PR333/P + communication module PR330/D-M, mounted on CB Emax X1, Tmax T7 and Tmax T8",
  "doc_number": "1SDH000556R0001",
  "revision_date": null,
  "url": "https://library.e.abb.com/public/89aa30f1720540cfaf50e2e1da987829/1SDH000556R0001.pdf",
  "pages": "Comms parameters p. 6; Modbus map and word order p. 11; register map p. 14; commands p. 17; statistics p. 18; state pp. 20-22; run-time measures pp. 23-24; information p. 24; command conditions p. 42; configuration p. 25"
 },
 "notes": [
  "The document states 4-byte values are sent with the low-order word at the lower address (LOW-HIGH), bytes within a word high first, so 32-bit registers here are CDAB.",
  "'Not available' is shown as 2^32-1 (unsigned currents), 2^31-1 (signed power) or 2^16-1 (voltages, frequency).",
  "Input register 102 bit 5 shows whether the measuring module is present; the protection table says it is always fitted on PR122/PR332 LSIRc and on PR123/P and PR333/P. Ground current registers apply to G versions.",
  "The com module can be set to 'ABB' addressing (register 1029); this map assumes the factory 'Standard' addressing.",
  "Left out: per-phase reactive/apparent power, peak factors, harmonics (600+), trip/measure history, logger, waveform and parameter areas.",
  "State 1 (100) bits are 'glitch' bits that clear on read; state 3, 5, 6, 7 and 9 words are not transcribed.",
  "Commands are accepted only while the unit is in Remote mode, and with a test unit connected only CB Open is accepted (commands execution conditions, p. 42)."
 ],
 "registers": [
  {
   "table": "input_register",
   "address": 5,
   "documented": "30006 (rel. 5)",
   "name": "Contact wear",
   "description": "0-65000, 65000 = 100 %.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 6,
   "documented": "30007 (rel. 6)",
   "name": "Total trip protection number",
   "description": "Includes failed trips.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 7,
   "documented": "30008 (rel. 7)",
   "name": "Total operation number",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 101,
   "documented": "30102 (rel. 101)",
   "name": "State 2 - flags",
   "description": "Breaker position and remote/local.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "Any alarm / timing / warning",
    "1": "Any trip (latched)",
    "2": "CB tripped",
    "3": "CB connected (0 = isolated)",
    "4": "CB closed (0 = open)",
    "5": "CB undefined",
    "6": "No communication on local bus",
    "7": "Springs charged",
    "8": "Trip command fail",
    "9": "Remote mode (0 = local)",
    "10": "Programming OK",
    "11": "Programming failed",
    "12": "Internal bus programming session",
    "13": "Test bus programming session",
    "14": "Local bus programming session",
    "15": "System bus programming session"
   },
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 103,
   "documented": "30104 (rel. 103)",
   "name": "State 4 - alarms",
   "description": "",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "Harmonic distortion > 2.1",
    "1": "Contact wear pre-alarm",
    "2": "Contact wear alarm",
    "3": "L pre-alarm",
    "4": "L timing",
    "5": "S timing",
    "6": "S2 timing",
    "7": "G timing",
    "8": "G alarm (trip blocked)",
    "9": "G ext timing",
    "10": "G ext alarm (trip blocked)",
    "11": "T pre-alarm",
    "12": "T alarm",
    "13": "T alarm (trip blocked)",
    "14": "D timing",
    "15": "U timing"
   },
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 107,
   "documented": "30108 (rel. 107)",
   "name": "State 8 - latched trips",
   "description": "Cleared by CB reset or 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": "S2 tripped",
    "3": "I tripped (or MCR)",
    "4": "Iinst tripped",
    "5": "G tripped",
    "6": "G ext tripped",
    "7": "T tripped",
    "8": "D tripped",
    "9": "UN tripped",
    "10": "UV tripped",
    "11": "OV tripped",
    "12": "RV tripped",
    "13": "RP tripped",
    "14": "UF tripped",
    "15": "OF tripped"
   },
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 200,
   "documented": "30201-30202 (rel. 200)",
   "name": "Maximum current",
   "description": "2^32-1 = not available.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 202,
   "documented": "30203 (rel. 202)",
   "name": "Maximum current phase",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Not available",
    "1": "L1",
    "2": "L2",
    "3": "L3",
    "4": "Ne"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 203,
   "documented": "30204-30205 (rel. 203)",
   "name": "L1 current",
   "description": "2^32-1 = not available.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 205,
   "documented": "30206-30207 (rel. 205)",
   "name": "L2 current",
   "description": "2^32-1 = not available.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 207,
   "documented": "30208-30209 (rel. 207)",
   "name": "L3 current",
   "description": "2^32-1 = not available.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 209,
   "documented": "30210-30211 (rel. 209)",
   "name": "Neutral current",
   "description": "2^32-1 = not available.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 211,
   "documented": "30212-30213 (rel. 211)",
   "name": "Internal ground current",
   "description": "G versions. 2^32-1 = not available.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 213,
   "documented": "30214-30215 (rel. 213)",
   "name": "External ground current",
   "description": "G versions, 0.01 A units. 2^32-1 = not available.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 0.01,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 215,
   "documented": "30216 (rel. 215)",
   "name": "V1 line-to-neutral voltage",
   "description": "65535 = not available.",
   "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": 216,
   "documented": "30217 (rel. 216)",
   "name": "V2 line-to-neutral voltage",
   "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": 217,
   "documented": "30218 (rel. 217)",
   "name": "V3 line-to-neutral voltage",
   "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": 219,
   "documented": "30220 (rel. 219)",
   "name": "V12 line-to-line voltage",
   "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": 220,
   "documented": "30221 (rel. 220)",
   "name": "V23 line-to-line voltage",
   "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": 221,
   "documented": "30222 (rel. 221)",
   "name": "V31 line-to-line voltage",
   "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": 222,
   "documented": "30223-30224 (rel. 222)",
   "name": "L1 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": 224,
   "documented": "30225-30226 (rel. 224)",
   "name": "L2 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": 226,
   "documented": "30227-30228 (rel. 226)",
   "name": "L3 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": 228,
   "documented": "30229-30230 (rel. 228)",
   "name": "Total active power",
   "description": "2^31-1 = 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": 236,
   "documented": "30237-30238 (rel. 236)",
   "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": 244,
   "documented": "30245-30246 (rel. 244)",
   "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": 246,
   "documented": "30247 (rel. 246)",
   "name": "Total power factor",
   "description": "Signed, 0.01 steps.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 247,
   "documented": "30248 (rel. 247)",
   "name": "Frequency",
   "description": "",
   "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": 252,
   "documented": "30253-30254 (rel. 252)",
   "name": "Positive active energy",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "kWh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 254,
   "documented": "30255-30256 (rel. 254)",
   "name": "Negative active energy",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "kWh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 256,
   "documented": "30257-30258 (rel. 256)",
   "name": "Total active energy",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "kWh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 262,
   "documented": "30263-30264 (rel. 262)",
   "name": "Total reactive energy",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "kVARh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 264,
   "documented": "30265-30266 (rel. 264)",
   "name": "Total apparent energy",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "kVAh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 704,
   "documented": "30705 (rel. 704)",
   "name": "Rated current In",
   "description": "100-6300 A.",
   "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 (rel. 0)",
   "name": "Command type",
   "description": "Write with the parameter in one function-16 request.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "W",
   "values": {
    "0": "Dummy",
    "1": "Trip reset",
    "2": "Signalling reset",
    "3": "Communication statistics reset",
    "4": "Log events reset",
    "5": "Start programming session",
    "6": "Abort programming session",
    "7": "Stop programming session",
    "8": "CB open",
    "9": "CB close",
    "10": "CB reset",
    "11": "Wink toggle",
    "12": "History measure reset",
    "13": "Energy counters reset",
    "14": "Data logger trigger restart",
    "15": "Data logger stop",
    "16": "Waveform + harmonics acquisition start",
    "17": "Waveform + harmonics acquisition stop"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1,
   "documented": "40002 (rel. 1)",
   "name": "Command parameter",
   "description": "0 when the command needs none.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "W",
   "values": null,
   "bits": null,
   "offset": 0
  }
 ],
 "integration": {
  "summary": "Read input registers 200-264 for measurements and 101/103/107 for breaker state, alarms and trips. Open, close or reset by writing command type and parameter (registers 0-1) together with function 16.",
  "minimum_registers": [
   {
    "table": "input_register",
    "address": 101,
    "why": "CB open/closed, tripped, remote"
   },
   {
    "table": "input_register",
    "address": 107,
    "why": "Which protection tripped"
   },
   {
    "table": "input_register",
    "address": 203,
    "why": "L1 current"
   },
   {
    "table": "input_register",
    "address": 219,
    "why": "V12 voltage"
   },
   {
    "table": "input_register",
    "address": 228,
    "why": "Total active power"
   },
   {
    "table": "input_register",
    "address": 256,
    "why": "Total active energy"
   },
   {
    "table": "holding_register",
    "address": 0,
    "why": "Commands (open/close/reset)"
   }
  ],
  "enable": "Fit the PR120/D-M (or PR330/D-M) module and set address, baud and parity on the trip unit. The breaker must be in Remote mode (state 2 bit 9) for open/close commands.",
  "watchdog": null,
  "quirks": [
   "32-bit values are low word first.",
   "Measures are input registers (function 4), not holding registers.",
   "Commands need function 16 even when the parameter is 0."
  ],
  "setup": [
   "Defaults: address 247, 19200 baud, E,8,1; 9600 baud and O,8,1 / N,8,2 / N,8,1 also available."
  ],
  "gotchas": [
   "Factory address is 247, not 1.",
   "Glitch state bits in register 100 clear when read."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/abb/pr122-pr123-pr332-pr333-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."
}
