{
 "manufacturer": "Lovato Electric",
 "manufacturer_slug": "lovato-electric",
 "model": "VT1 series variable speed drives (Modbus RTU / ASCII)",
 "model_slug": "vt1-drive",
 "short_model": "VT1",
 "aliases": [
  "VT1",
  "Lovato VT1",
  "VT1 series"
 ],
 "equipment_type": "Variable frequency drive",
 "applies_to": "Lovato VT1 series drives on the built-in RS-485 port, per communication manual I646 GB I 02 21 (Modbus part).",
 "summary": "The Lovato VT1 is an AC drive whose RS-485 port supports Modbus RTU/ASCII and BACnet MS/TP. Over Modbus a master writes a command word and frequency reference and reads a block of monitor registers. This map covers the command word, frequency command, status and fault code, terminal status, output frequency, voltage, current, power, PID values, analog inputs and drive temperature.",
 "transport": [
  "RTU",
  "ASCII"
 ],
 "defaults": {
  "unit_id": null,
  "baud": null,
  "parity": null,
  "data_bits": null,
  "stop_bits": null,
  "tcp_port": null
 },
 "addressing": {
  "convention": "1-based",
  "note": "The register tables print hex numbers one above the wire address, as all three example frames show: reading the frequency command (table 2524H) sends 25 23; writing 60.0 Hz to the frequency command (table 2503H) sends 25 02; a two-register write of run command + frequency (table 2502H-2503H) starts at 25 01. Addresses here are the table value minus one."
 },
 "default_word_order": null,
 "firmware": null,
 "source": {
  "title": "Variable speed drives VT1 series - Communication manual, Modbus and BACnet protocols",
  "doc_number": "I646 GB I 02 21",
  "revision_date": "2021-02",
  "url": "https://datasheet.lovatoelectric.com/DOWNLOAD/Technical/TechInstructions/06.%20AZIONAMENTI%20A%20VELOCITA%20VARIABILE/I646GBI02_21.pdf",
  "pages": "pp. 2-9 (frame, error codes, 1.4 drive control tables, example frames, 1.5 parameter rule)"
 },
 "notes": [
  "All registers are 16-bit holding registers: read with 03, write with 06 or 16. Reads and multi-writes must stay within one register group; at most 37 registers per RTU read and 35 per RTU write.",
  "Offset: the doc has no wording on it, but its three example frames all send the table number minus one (see addressing note), so that rule is applied to every register.",
  "Scales as printed: frequencies 100 = 1 Hz, voltage 10 = 1 V, current 10 = 1 A, power 10 = 1 kW, PID 10 = 1 %, temperature 10 = 1 °C, AVI/ACI 1000 = 10 V.",
  "Left out: the drive parameters. The manual says parameter gg-nn sits at register GGnnH (e.g. 08-03 at 0803H) but gives no example frame for it, so it is not clear whether that number also needs the minus-one shift.",
  "The AVI and ACI rows carry a footnote mark (*1) whose text is not printed in the document; check the analog scaling against the drive display.",
  "Write 0 to unused bits of the command word and never write to the reserved register 2501H (table numbering).",
  "Error responses carry codes 51h-55h (function, address, data amount, data range, writing mode) rather than the standard 01-04.",
  "Bit 2 of the command word is not a fault flag: setting it tells the drive about an external abnormality and makes it stop as set in 07-09 and show EFO; otherwise a communication loss shows Err6."
 ],
 "registers": [
  {
   "table": "holding_register",
   "address": 9473,
   "documented": "2502H",
   "name": "Command word",
   "description": "Run/stop, direction, reset, jog, S1-S5 and relay commands.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": {
    "0": "Run (0 = stop)",
    "1": "Reverse (0 = forward)",
    "2": "External abnormality EFO",
    "3": "Fault reset",
    "4": "Jog forward",
    "5": "Jog reverse",
    "6": "Multi-function command S1",
    "7": "Multi-function command S2",
    "8": "Multi-function command S3",
    "9": "Multi-function command S4",
    "10": "Multi-function command S5",
    "12": "Relay RY1"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9474,
   "documented": "2503H",
   "name": "Frequency command",
   "description": "60.00 Hz is written as 6000.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "Hz",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9504,
   "documented": "2521H",
   "name": "Drive status",
   "description": "",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "Running (0 = stopped)",
    "1": "Reverse (0 = forward)",
    "2": "Ready",
    "3": "Abnormal",
    "4": "Data setting error"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9505,
   "documented": "2522H",
   "name": "Fault code",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Normal",
    "1": "Drive over heat (OH)",
    "2": "Over current at stop (OC)",
    "3": "Under voltage (LV)",
    "4": "Over voltage (OV)",
    "6": "External BB (bb)",
    "7": "CPU error by external signal (CTE)",
    "8": "PID feedback signal lost (PDER)",
    "9": "EEPROM abnormal (EPR)",
    "10": "Parameter auto-measure error (ATER)",
    "11": "Over torque (OL3)",
    "12": "Drive overload (OL2)",
    "13": "Motor overload (OL1)",
    "14": "External communication error (EFO)",
    "15": "External stop (E.S)",
    "16": "Parameters locked (LOC)",
    "18": "Over current at constant speed (OC-C)",
    "19": "Over current accelerating (OC-A)",
    "20": "Over current decelerating (OC-D)",
    "21": "Over current at start (OC-S)",
    "23": "Under voltage running (LV-C)",
    "24": "Over voltage decelerating (OV-C)",
    "25": "Drive over heat running (OH-C)",
    "26": "Stop at 0 speed (STP0)",
    "27": "Direct start malfunction (STP1)",
    "28": "Keypad emergency stop (STP2)",
    "29": "Keypad operation error (Err1)",
    "30": "Parameter setting error (Err2)",
    "31": "Analog transfer error (Err4)",
    "32": "Parameter changed during communication (Err5)",
    "33": "Communication failure (Err6)",
    "34": "Parameter setting error (Err7)",
    "35": "Restore factory setting error (Err8)",
    "38": "Copy unit parameter copy error (EPR1)",
    "39": "Copy unit parameters incorrect (EPR2)",
    "40": "Drive over speed (OVSP)",
    "41": "Input phase lost (PF)",
    "42": "Horsepower setting error (HPERR)",
    "44": "Motor overheat error (OH4)",
    "45": "Motor overheat alarm (OH3)",
    "46": "Output current at current limit (CL)",
    "47": "High pressure fault (HIPB)",
    "48": "Low pressure fault (LOPB)",
    "49": "PID feedback signal loss (FBLSS)"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9506,
   "documented": "2523H",
   "name": "Terminal status",
   "description": "",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "Terminal S1",
    "1": "Terminal S2",
    "2": "Terminal S3",
    "3": "Terminal S4",
    "4": "Terminal S5",
    "6": "Relay RY1"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9507,
   "documented": "2524H",
   "name": "Frequency command (readback)",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "Hz",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9508,
   "documented": "2525H",
   "name": "Output frequency",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "Hz",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9509,
   "documented": "2526H",
   "name": "Output voltage command",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9510,
   "documented": "2527H",
   "name": "DC voltage command",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9511,
   "documented": "2528H",
   "name": "Output current",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9513,
   "documented": "252AH",
   "name": "Output power",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "kW",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9514,
   "documented": "252BH",
   "name": "PID feedback",
   "description": "Percent of maximum frequency.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9515,
   "documented": "252CH",
   "name": "PID input",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9516,
   "documented": "252DH",
   "name": "AVI input value",
   "description": "1000 = 10 V.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9517,
   "documented": "252EH",
   "name": "ACI input value",
   "description": "1000 = 10 V (as printed).",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9521,
   "documented": "2532H",
   "name": "Drive temperature",
   "description": "Heat sink or IGBT temperature.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9522,
   "documented": "2533H",
   "name": "Drive/motor rated current ratio",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  }
 ],
 "integration": {
  "summary": "Write the frequency reference (wire 0x2502) and set bit 0 of the command word (wire 0x2501) to run; a single function 16 write of two registers at 0x2501 does both. Read status, fault code and output values from the block starting at wire 0x2520.",
  "minimum_registers": [
   {
    "table": "holding_register",
    "address": 9473,
    "why": "Command word (run/stop, reset)"
   },
   {
    "table": "holding_register",
    "address": 9474,
    "why": "Frequency reference"
   },
   {
    "table": "holding_register",
    "address": 9504,
    "why": "Drive status"
   },
   {
    "table": "holding_register",
    "address": 9505,
    "why": "Fault code"
   },
   {
    "table": "holding_register",
    "address": 9508,
    "why": "Output frequency"
   },
   {
    "table": "holding_register",
    "address": 9511,
    "why": "Output current"
   }
  ],
  "enable": "Wire the drive's RS-485 port and select Modbus RTU or ASCII, the slave address and the run/frequency command source on the drive keypad; those parameter numbers are in the VT1 instruction manual, not in this protocol document.",
  "watchdog": "A lost connection shows Err6 on the drive; the reaction to an external abnormality written via command bit 2 follows parameter 07-09.",
  "quirks": [
   "Table addresses are one above the wire address.",
   "Exception codes are 51h-55h, not the usual 01h-04h.",
   "Reads and block writes may not cross register groups."
  ],
  "setup": [
   "Set slave address, baud rate and data format on the drive before connecting; the protocol document does not list defaults.",
   "Maximum frame length is 80 bytes.",
   "Terminate each end of the RS-485 line with a 120 ohm resistor."
  ],
  "gotchas": [
   "Do not write to the reserved word at table 2501H (wire 0x2500)."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/lovato-electric/vt1-drive",
 "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."
}
