{
 "manufacturer": "ABB",
 "manufacturer_slug": "abb",
 "model": "DCS880 DC drive (embedded Modbus RTU)",
 "model_slug": "dcs880",
 "short_model": "DCS880",
 "aliases": [
  "DCS880-S01",
  "DCS880-S02",
  "DCS880-H",
  "DCS880-R"
 ],
 "equipment_type": "Variable frequency drive (DC drive)",
 "applies_to": "DCS880 DC drives, firmware manual revision E, embedded fieldbus (EFB) Modbus RTU on control-board terminal XD2D, ABB Drives profile, 58.33 Addressing mode = Mode 0.",
 "summary": "ABB's thyristor DC drive for armature and field control of DC motors. The control board's XD2D RS-485 port can run Modbus RTU, which puts a control word, two references, a status word and two actual values in the first six holding registers and maps every parameter to a holding register worked out from its group and index. This map covers that cyclic block plus the main armature, field, mains and power signals, the active fault codes and the comm-loss settings, all in 16-bit form.",
 "transport": [
  "RTU"
 ],
 "defaults": {
  "unit_id": 1,
  "baud": 19200,
  "parity": "Even",
  "data_bits": 8,
  "stop_bits": 1,
  "tcp_port": null
 },
 "addressing": {
  "convention": "Modicon",
  "note": "The manual uses 6-digit holding register references 400001-465536, so 400001 is wire address 0. With 58.33 = Mode 0 (default) a 16-bit parameter gg.ii sits at 400000 + 100 x gg + ii, e.g. 01.21 -> 400121 = wire 120. Masters limited to 5 digits can reach 400001-409999 as 40001-49999."
 },
 "default_word_order": null,
 "firmware": null,
 "source": {
  "title": "DCS880 drives Firmware manual",
  "doc_number": "3ADW000474R0501 (rev E)",
  "revision_date": null,
  "url": "https://www.precision-elec.com/wp-content/uploads/2020/12/DCS880-Firmware-Manual.pdf",
  "unofficial": true,
  "pages": "Group 01 pp. 96-99; group 04 p. 101; 06.01 pp. 114-116; 06.15 pp. 122-124; group 58 pp. 385-391; EFB chapter pp. 555-567 (setup p. 556, register addressing p. 559, holding register table p. 563, coils/discrete inputs pp. 565-567)"
 },
 "notes": [
  "Source host: ABB lists this manual as 3ADW000474, but its public library returns 'not available' for that number and no other ABB-hosted copy was found; this is a copy of the ABB document hosted by a US distributor.",
  "Registers 400001-400006 are the defaults of 58.101-58.106 Data I/O 1-6 and can be re-pointed; Data I/O 7-24 (400007-400024) are user-selected and not listed.",
  "Only 16-bit parameter registers are listed. The manual describes a 32-bit block (420000 + 200 x group + 2 x index, word order set by 58.34, default LO-HI) but prints only 16-bit (FbEq16) scaling, so no 32-bit registers are included.",
  "Speed and torque signals (01.01-01.06, 01.17, 01.18) use 46.02 / 46.04 scaling, which depends on drive setup, so they are left out. References and actual values in the cyclic block are left unscaled for the same reason.",
  "The manual's error-code register table is headed 400090-400100 but its rows are numbered 89-94, so those registers are left out.",
  "58.14 Communication loss action defaults to No action in the parameter list; the setup table shows Fault as the value to use for fieldbus control.",
  "01.24 follows 96.02 Unit selection (kW or hp); the unit shown assumes kW."
 ],
 "registers": [
  {
   "table": "holding_register",
   "address": 0,
   "documented": "400001",
   "name": "Control word (CW)",
   "description": "ABB Drives profile; default Data I/O 1 (58.101).",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": {
    "0": "On/Off1: 0->1 = On (to Ready run); 0 = Off1 stop via 21.02",
    "1": "Off2: 1 = normal, 0 = emergency off / coast, to Switch-on inhibited",
    "2": "Off3: 1 = normal, 0 = emergency stop via 21.03",
    "3": "Run: 0->1 = run (firing pulses released); 0 = stop via 21.04",
    "4": "Ramp out zero: 1 = normal, 0 = force ramp output to zero",
    "5": "Ramp halt: 1 = normal, 0 = freeze ramp output",
    "6": "Ramp in zero: 1 = normal, 0 = force ramp input to zero",
    "7": "Reset: 0->1 acknowledges faults",
    "8": "Inching 1 (jog at 22.42)",
    "9": "Inching 2 (jog at 22.43)",
    "10": "Remote command: 1 = overriding control enabled (must be set)",
    "11": "Reserved",
    "12": "Main control 12 (user bit)",
    "13": "Main control 13 (user bit)",
    "14": "Main control 14 (user bit)",
    "15": "Main control 15 (user bit)"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1,
   "documented": "400002",
   "name": "Reference 1 (REF1)",
   "description": "Scaling per 58.26 EFB ref1 type; default Data I/O 2.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2,
   "documented": "400003",
   "name": "Reference 2 (REF2)",
   "description": "Scaling per 58.27 EFB ref2 type; default Data I/O 3.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 3,
   "documented": "400004",
   "name": "Status word (SW)",
   "description": "ABB Drives profile; default Data I/O 4 (58.104).",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "Ready on",
    "1": "Ready run (0 = e.g. Off1 active)",
    "2": "Ready reference: drive running",
    "3": "Tripped: fault",
    "4": "Off2 inactive",
    "5": "Off3 inactive",
    "6": "Switch-on inhibited",
    "7": "Warning",
    "8": "At setpoint",
    "9": "Remote (0 = local)",
    "10": "Above level (selector 06.29)",
    "11": "Status control 11 (selector 06.30)",
    "12": "Status control 12 (selector 06.31)",
    "13": "Status control 13 (selector 06.32)",
    "14": "Status control 14 (selector 06.33)",
    "15": "Reserved"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 4,
   "documented": "400005",
   "name": "Actual value 1 (ACT1)",
   "description": "Type and scaling per 58.28; default Data I/O 5.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 5,
   "documented": "400006",
   "name": "Actual value 2 (ACT2)",
   "description": "Type and scaling per 58.29; default Data I/O 6.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 106,
   "documented": "400107",
   "name": "01.07 Speed change rate",
   "description": "Positive = accelerating.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "rpm/s",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 109,
   "documented": "400110",
   "name": "01.10 Motor current in A",
   "description": "Measured motor (armature) current.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 119,
   "documented": "400120",
   "name": "01.20 Mains voltage in V",
   "description": "Measured mains voltage, 10 ms filter.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 120,
   "documented": "400121",
   "name": "01.21 Armature voltage in V",
   "description": "Measured armature voltage, 10 ms filter.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 123,
   "documented": "400124",
   "name": "01.24 Output power in kW",
   "description": "Unit follows 96.02 (kW or hp).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "kW",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 124,
   "documented": "400125",
   "name": "01.25 Output power",
   "description": "Percent of 99.03 motor nominal power.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 125,
   "documented": "400126",
   "name": "01.26 Reactive power",
   "description": "Percent of 99.03 motor nominal power.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 128,
   "documented": "400129",
   "name": "01.29 M1 field current in A",
   "description": "Motor 1 field current, 500 ms filter.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 129,
   "documented": "400130",
   "name": "01.30 M2 field current in A",
   "description": "Motor 2 field current, 500 ms filter.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 139,
   "documented": "400140",
   "name": "01.40 Drive current",
   "description": "Percent of 07.62 drive DC current scaling.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 140,
   "documented": "400141",
   "name": "01.41 Reactive current",
   "description": "Percent of 99.11 motor nominal current.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 400,
   "documented": "400401",
   "name": "04.01 Tripping fault",
   "description": "Code of the fault that caused the trip (hex).",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 401,
   "documented": "400402",
   "name": "04.02 Active fault 2",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 402,
   "documented": "400403",
   "name": "04.03 Active fault 3",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 403,
   "documented": "400404",
   "name": "04.04 Active fault 4",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 600,
   "documented": "400601",
   "name": "06.01 Main control word",
   "description": "Read-only view of the control word in use; do not write.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "On/Off1: 0->1 = On (to Ready run); 0 = Off1 stop via 21.02",
    "1": "Off2: 1 = normal, 0 = emergency off / coast, to Switch-on inhibited",
    "2": "Off3: 1 = normal, 0 = emergency stop via 21.03",
    "3": "Run: 0->1 = run (firing pulses released); 0 = stop via 21.04",
    "4": "Ramp out zero: 1 = normal, 0 = force ramp output to zero",
    "5": "Ramp halt: 1 = normal, 0 = freeze ramp output",
    "6": "Ramp in zero: 1 = normal, 0 = force ramp input to zero",
    "7": "Reset: 0->1 acknowledges faults",
    "8": "Inching 1 (jog at 22.42)",
    "9": "Inching 2 (jog at 22.43)",
    "10": "Remote command: 1 = overriding control enabled (must be set)",
    "11": "Reserved",
    "12": "Main control 12 (user bit)",
    "13": "Main control 13 (user bit)",
    "14": "Main control 14 (user bit)",
    "15": "Main control 15 (user bit)"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 614,
   "documented": "400615",
   "name": "06.15 Main status word",
   "description": "Same bits as the status word at 400004.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "Ready on",
    "1": "Ready run (0 = e.g. Off1 active)",
    "2": "Ready reference: drive running",
    "3": "Tripped: fault",
    "4": "Off2 inactive",
    "5": "Off3 inactive",
    "6": "Switch-on inhibited",
    "7": "Warning",
    "8": "At setpoint",
    "9": "Remote (0 = local)",
    "10": "Above level (selector 06.29)",
    "11": "Status control 11 (selector 06.30)",
    "12": "Status control 12 (selector 06.31)",
    "13": "Status control 13 (selector 06.32)",
    "14": "Status control 14 (selector 06.33)",
    "15": "Reserved"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 5813,
   "documented": "405814",
   "name": "58.14 Communication loss action",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "No action",
    "1": "Fault",
    "2": "Last speed",
    "3": "Speed reference safe",
    "4": "Fault always",
    "5": "Warning"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 5814,
   "documented": "405815",
   "name": "58.15 Communication loss mode",
   "description": "Which messages reset the loss timer.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "1": "Any message",
    "2": "CW / Ref1 / Ref2"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 5815,
   "documented": "405816",
   "name": "58.16 Communication loss time",
   "description": "Range 0-32.5 s, default 0.3 s.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "s",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  }
 ],
 "integration": {
  "summary": "Set 58.01 = Modbus RTU plus node, baud and parity, validate with 58.06 = Refresh settings, then set 06.08 Main control word source = EFB, 20.01 Command location = Main control word and the speed reference source to EFB reference 1. Write the control word and REF1 at 400001/400002 and poll the status word and actuals at 400004-400006.",
  "minimum_registers": [
   {
    "table": "holding_register",
    "address": 0,
    "why": "Control word: on/run/reset"
   },
   {
    "table": "holding_register",
    "address": 1,
    "why": "Reference 1 (speed reference)"
   },
   {
    "table": "holding_register",
    "address": 3,
    "why": "Status word: ready/running/fault"
   },
   {
    "table": "holding_register",
    "address": 4,
    "why": "Actual value 1"
   },
   {
    "table": "holding_register",
    "address": 109,
    "why": "01.10 Motor current in A"
   },
   {
    "table": "holding_register",
    "address": 120,
    "why": "01.21 Armature voltage, 0.1 V"
   },
   {
    "table": "holding_register",
    "address": 128,
    "why": "01.29 Field current, 0.1 A"
   },
   {
    "table": "holding_register",
    "address": 400,
    "why": "04.01 Tripping fault code"
   }
  ],
  "enable": "58.01 Protocol enable = Modbus RTU (disables the device-to-device link on XD2D). Set 58.03 Node address, 58.04 Baud rate and 58.05 Parity, then 58.06 Communication control = Refresh settings (or reboot). For control set 06.08 Main control word source = EFB, 20.01 Command location = Main control word, and 22.11/22.12 (speed) or 26.11/26.12 (torque) to EFB reference 1 or 2. Save fieldbus parameter writes with 96.16 Parameter save manually = Save.",
  "watchdog": "58.14 Communication loss action (No action / Fault / Last speed / Speed reference safe / Fault always / Warning), 58.16 Communication loss time (0-32.5 s, default 0.3 s) and 58.15 Communication loss mode (any message, or only CW/reference writes, resets the timer). Loss gives fault 6681 or warning A7CE.",
  "quirks": [
   "The control word is edge-triggered: bit 0 must go 0 to 1 for On and bit 3 must go 0 to 1 for Run.",
   "Bit 10 Remote command must be 1 or the control word and references are ignored (bits 0-2 still act).",
   "For holding registers the supported function-code table lists FC 03, FC 06, FC 0x16 (mask write) and FC 0x17 (read/write multiple); FC 16 is not in the list.",
   "The drive handles 10 registers per 10 ms, so long block reads add response delay (about 22 ms for 20 registers)."
  ],
  "setup": [
   "RS-485 on terminal XD2D of the control board; see the DCS880 hardware manual 3ADW000462 for termination.",
   "Defaults: node 1, 19.2 kbit/s, 8 data bits, even parity, 1 stop bit.",
   "Changes to group 58 take effect after 58.06 = Refresh settings or a reboot."
  ],
  "gotchas": [
   "Coils mirror the control word bits and discrete inputs the status word bits plus DI states, but both tables number from 00001 without a 0/1-based statement, so they are not listed."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/abb/dcs880",
 "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."
}
