{
  "format": "voltrus-device-template/1",
  "template_id": "abb-acs580",
  "manufacturer": "ABB",
  "model": "ACS580",
  "protocol": "modbus",
  "description": "General-purpose AC drive from ABB with a standard control program. The embedded fieldbus interface speaks Modbus RTU over EIA-485 and gives access to control and status words, two references, two actual values, and every drive parameter through a mapped register range. Register map: https://voltrus.id/registers/abb/acs580/",
  "version": "1.0.0",
  "verified": false,
  "verified_notes": "Generated by voltrus.id from 3AXD50000016097 Rev J, effective 2025-10-01 (https://library.e.abb.com/public/d03c76db17d34239a838ed3baf814028/EN_ACS580_FW_J_A5.pdf), read 2026-10-24. Not checked against a real device; confirm a known value before relying on it.",
  "quirks": [
    "Offsets are 0-based wire addresses. The manual prints Modicon numbers such as 40001.",
    "Word order from the manual: Low word first (CD AB).",
    "Applies to the 32-bit parameter registers. Parameter 58.34 selects the order: low word first is the default, high word first is the alternative; bytes inside each register are high byte first (p. 442).",
    "The device speaks Modbus RTU (embedded fieldbus, EIA-485). Voltrus SCADA polls Modbus TCP, so connect it through a Modbus RTU to TCP gateway: use the gateway's IP and port and the device's unit ID.",
    "Defaults from the manual: Node address 1, 19.2 kbit/s, 8 data bits with even parity and 1 stop bit, ABB Drives control profile, addressing mode 0, word order low word first (p. 572-573). Settings in group 58 take effect after a reboot or after parameter 58.06 is set to Refresh settings.",
    "2 unsigned 32-bit registers are read as int32: exact up to a raw value of 2,147,483,647."
  ],
  "license": "CC-BY-4.0",
  "port": 502,
  "unit_id": 1,
  "interval_ms": 1000,
  "endianness": "little",
  "registers": [
    {
      "name": "ControlWord",
      "offset": 0,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Control word (default Data I/O 1) (manual address 400001)",
      "writable": true
    },
    {
      "name": "Reference1",
      "offset": 1,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 1,
      "description": "Reference 1 (default Data I/O 2) (manual address 400002)",
      "writable": true
    },
    {
      "name": "Reference2",
      "offset": 2,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 1,
      "description": "Reference 2 (default Data I/O 3) (manual address 400003)",
      "writable": true
    },
    {
      "name": "StatusWord",
      "offset": 3,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Status word (default Data I/O 4) (manual address 400004)"
    },
    {
      "name": "ActualValue1",
      "offset": 4,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 1,
      "description": "Actual value 1 (default Data I/O 5) (manual address 400005)"
    },
    {
      "name": "ActualValue2",
      "offset": 5,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 1,
      "description": "Actual value 2 (default Data I/O 6) (manual address 400006)"
    },
    {
      "name": "ErrorReset",
      "offset": 89,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Reset error registers (manual address 400090)",
      "writable": true
    },
    {
      "name": "ErrorFunctionCode",
      "offset": 90,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Function code of the last failed query (manual address 400091)"
    },
    {
      "name": "ErrorCode",
      "offset": 91,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Error code after a device failure exception (manual address 400092)"
    },
    {
      "name": "ErrorFailedRegister",
      "offset": 92,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Last register that failed to read or write (manual address 400093)"
    },
    {
      "name": "LastRegisterWritten",
      "offset": 93,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Last register written successfully (manual address 400094)"
    },
    {
      "name": "LastRegisterRead",
      "offset": 94,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Last register read successfully (manual address 400095)"
    },
    {
      "name": "MotorSpeedUsed",
      "offset": 100,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 1,
      "unit": "rpm",
      "description": "Motor speed used (01.01) (manual address 400101)"
    },
    {
      "name": "MotorSpeedPercent",
      "offset": 102,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "%",
      "description": "Motor speed percent of synchronous speed (01.03) (manual address 400103)"
    },
    {
      "name": "OutputFrequency",
      "offset": 105,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 1,
      "unit": "Hz",
      "description": "Output frequency (01.06) (manual address 400106)"
    },
    {
      "name": "MotorCurrent",
      "offset": 106,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "A",
      "description": "Motor current (01.07) (manual address 400107)"
    },
    {
      "name": "MotorCurrentPctMotor",
      "offset": 107,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "%",
      "description": "Motor current percent of nominal motor current (01.08) (manual address 400108)"
    },
    {
      "name": "MotorCurrentPctDrive",
      "offset": 108,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "%",
      "description": "Motor current percent of nominal drive current (01.09) (manual address 400109)"
    },
    {
      "name": "MotorTorque",
      "offset": 109,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 1,
      "unit": "%",
      "description": "Motor torque percent of nominal (01.10) (manual address 400110)"
    },
    {
      "name": "DCVoltage",
      "offset": 110,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "V",
      "description": "DC link voltage (01.11) (manual address 400111)"
    },
    {
      "name": "OutputVoltage",
      "offset": 112,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "V",
      "description": "Output voltage (01.13) (manual address 400113)"
    },
    {
      "name": "OutputPower",
      "offset": 113,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 1,
      "unit": "kW",
      "description": "Output power (01.14) (manual address 400114)"
    },
    {
      "name": "OutputPowerPctMotor",
      "offset": 114,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "%",
      "description": "Output power percent of nominal motor power (01.15) (manual address 400115)"
    },
    {
      "name": "InverterGWh",
      "offset": 117,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "GWh",
      "description": "Inverter energy counter, GWh part (01.18) (manual address 400118)"
    },
    {
      "name": "InverterMWh",
      "offset": 118,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "MWh",
      "description": "Inverter energy counter, MWh part (01.19) (manual address 400119)"
    },
    {
      "name": "InverterkWh",
      "offset": 119,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "kWh",
      "description": "Inverter energy counter, kWh part (01.20) (manual address 400120)"
    },
    {
      "name": "FluxActualPct",
      "offset": 123,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "%",
      "description": "Actual flux percent of nominal (01.24) (manual address 400124)"
    },
    {
      "name": "AmbientTemperature",
      "offset": 130,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 1,
      "unit": "°C",
      "description": "Ambient temperature (01.31) (manual address 400131)"
    },
    {
      "name": "CurrentPhaseU",
      "offset": 171,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "A",
      "description": "U-phase RMS current (01.72) (manual address 400172)"
    },
    {
      "name": "CurrentPhaseV",
      "offset": 172,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "A",
      "description": "V-phase RMS current (01.73) (manual address 400173)"
    },
    {
      "name": "CurrentPhaseW",
      "offset": 173,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "A",
      "description": "W-phase RMS current (01.74) (manual address 400174)"
    },
    {
      "name": "TrippingFault",
      "offset": 400,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Code of the active tripping fault (04.01) (manual address 400401)"
    },
    {
      "name": "ActiveFault2",
      "offset": 401,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Code of the second active fault (04.02) (manual address 400402)"
    },
    {
      "name": "ActiveFault3",
      "offset": 402,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Code of the third active fault (04.03) (manual address 400403)"
    },
    {
      "name": "ActiveWarning1",
      "offset": 405,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Code of the first active warning (04.06) (manual address 400406)"
    },
    {
      "name": "ActiveWarning2",
      "offset": 406,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Code of the second active warning (04.07) (manual address 400407)"
    },
    {
      "name": "ActiveWarning3",
      "offset": 407,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Code of the third active warning (04.08) (manual address 400408)"
    },
    {
      "name": "EventWord1",
      "offset": 439,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "User-defined event word 1 (04.40) (manual address 400440)"
    },
    {
      "name": "OnTimeDays",
      "offset": 500,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "d",
      "description": "Power-on time counter (05.01) (manual address 400501)"
    },
    {
      "name": "RunTimeDays",
      "offset": 501,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "d",
      "description": "Motor run-time counter (05.02) (manual address 400502)"
    },
    {
      "name": "FanOnTimeDays",
      "offset": 503,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "d",
      "description": "Cooling fan on-time counter (05.04) (manual address 400504)"
    },
    {
      "name": "ControlBoardTemp",
      "offset": 509,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 1,
      "unit": "°C",
      "description": "Control board temperature (05.10) (manual address 400510)"
    },
    {
      "name": "InverterTempPct",
      "offset": 510,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 1,
      "unit": "%",
      "description": "Inverter temperature percent of fault limit (05.11) (manual address 400511)"
    },
    {
      "name": "DiagnosticWord1",
      "offset": 519,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Diagnostic word 1 (05.20) (manual address 400520)"
    },
    {
      "name": "DiagnosticWord2",
      "offset": 520,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Diagnostic word 2 (05.21) (manual address 400521)"
    },
    {
      "name": "DiagnosticWord3",
      "offset": 521,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Diagnostic word 3 (05.22) (manual address 400522)"
    },
    {
      "name": "MainControlWord",
      "offset": 600,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Main control word as seen by the drive (06.01) (manual address 400601)"
    },
    {
      "name": "MainStatusWord",
      "offset": 610,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Main status word (06.11) (manual address 400611)"
    },
    {
      "name": "DriveStatusWord1",
      "offset": 615,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Drive status word 1 (06.16) (manual address 400616)"
    },
    {
      "name": "DriveStatusWord2",
      "offset": 616,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Drive status word 2 (06.17) (manual address 400617)"
    },
    {
      "name": "StartInhibitWord",
      "offset": 617,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Start inhibit status word (06.18) (manual address 400618)"
    },
    {
      "name": "AccelTime1",
      "offset": 2311,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "s",
      "description": "Acceleration time 1 (23.12) (manual address 402312)",
      "writable": true
    },
    {
      "name": "DecelTime1",
      "offset": 2312,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "s",
      "description": "Deceleration time 1 (23.13) (manual address 402313)",
      "writable": true
    },
    {
      "name": "MinimumSpeed",
      "offset": 3010,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 1,
      "unit": "rpm",
      "description": "Minimum speed (30.11) (manual address 403011)",
      "writable": true
    },
    {
      "name": "MaximumSpeed",
      "offset": 3011,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 1,
      "unit": "rpm",
      "description": "Maximum speed (30.12) (manual address 403012)",
      "writable": true
    },
    {
      "name": "EFB_NodeAddress",
      "offset": 5802,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Embedded fieldbus node address (58.03) (manual address 405803)",
      "writable": true
    },
    {
      "name": "EFB_BaudRate",
      "offset": 5803,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Embedded fieldbus baud rate (58.04) (manual address 405804)",
      "writable": true
    },
    {
      "name": "EFB_Parity",
      "offset": 5804,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Embedded fieldbus parity and stop bits (58.05) (manual address 405805)",
      "writable": true
    },
    {
      "name": "EFB_WordOrder",
      "offset": 5833,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Word order for 32-bit parameters (58.34) (manual address 405834)",
      "writable": true
    },
    {
      "name": "MotorSpeedUsed_32",
      "offset": 20201,
      "register_type": "int32",
      "register_area": "holding",
      "scale": 0.01,
      "unit": "rpm",
      "description": "Motor speed used, 32-bit (01.01) (manual address 420202)"
    },
    {
      "name": "OutputFrequency_32",
      "offset": 20211,
      "register_type": "int32",
      "register_area": "holding",
      "scale": 0.01,
      "unit": "Hz",
      "description": "Output frequency, 32-bit (01.06) (manual address 420212)"
    },
    {
      "name": "MotorCurrent_32",
      "offset": 20213,
      "register_type": "int32",
      "register_area": "holding",
      "scale": 0.01,
      "unit": "A",
      "description": "Motor current, 32-bit (01.07) (manual address 420214)"
    },
    {
      "name": "MotorTorque_32",
      "offset": 20219,
      "register_type": "int32",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "%",
      "description": "Motor torque percent, 32-bit (01.10) (manual address 420220)"
    },
    {
      "name": "DCVoltage_32",
      "offset": 20221,
      "register_type": "int32",
      "register_area": "holding",
      "scale": 0.01,
      "unit": "V",
      "description": "DC link voltage, 32-bit (01.11) (manual address 420222)"
    },
    {
      "name": "OutputPower_32",
      "offset": 20227,
      "register_type": "int32",
      "register_area": "holding",
      "scale": 0.01,
      "unit": "kW",
      "description": "Output power, 32-bit (01.14) (manual address 420228)"
    },
    {
      "name": "CumulativeEnergy_32",
      "offset": 20307,
      "register_type": "int32",
      "register_area": "holding",
      "scale": 1,
      "unit": "kWh",
      "description": "Cumulative inverter energy, 32-bit (01.54) (manual address 420308)"
    }
  ]
}
