{
  "format": "voltrus-device-template/1",
  "template_id": "schneider-electric-atv312",
  "manufacturer": "Schneider Electric",
  "model": "ATV312",
  "protocol": "modbus",
  "description": "Variable speed drive for asynchronous motors. The communication variables listed here cover the control and status words, frequency and speed references, motor measurements, fault codes, ramp and motor settings, and the Modbus line parameters. Register map: https://voltrus.id/registers/schneider-electric/atv312/",
  "version": "1.0.0",
  "verified": false,
  "verified_notes": "Generated by voltrus.id from BBV51701 06/2009 (https://download.schneider-electric.com/files?p_enDocType=User+guide&p_File_Name=ATV312_communication_variables_EN_BBV51701_01.pdf&p_Doc_Ref=BBV51701), 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 0-based addresses, the same as here.",
    "Word order from the manual: Low word first (CD AB).",
    "Almost every variable is a single 16-bit word. The only 32-bit value is the motor speed in customer units, split into a low word at 12002 and a high word at 12003, so the low word comes first.",
    "The device speaks Modbus RTU. 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: Modbus RTU through the RJ45 port. Factory settings: drive address 1 (range 1 to 247), 19200 bps, 8 data bits with even parity and 1 stop bit (8E1), time-out 10 s (Modbus manual BBV52816, p. 9). The remote display terminal only works with 19200 bps and 8E1."
  ],
  "license": "CC-BY-4.0",
  "port": 502,
  "unit_id": 1,
  "interval_ms": 1000,
  "endianness": "little",
  "registers": [
    {
      "name": "CMDD",
      "offset": 8601,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "IEC 61800-7 control word (manual address 8601)",
      "writable": true
    },
    {
      "name": "LFRD",
      "offset": 8602,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 1,
      "unit": "rpm",
      "description": "Speed reference via the bus (manual address 8602)",
      "writable": true
    },
    {
      "name": "ETAD",
      "offset": 8603,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "IEC 61800-7 status word (manual address 8603)"
    },
    {
      "name": "FRHD",
      "offset": 8605,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 1,
      "unit": "rpm",
      "description": "Speed reference at ramp input (manual address 8605)"
    },
    {
      "name": "RFRD",
      "offset": 8604,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 1,
      "unit": "rpm",
      "description": "Output speed (manual address 8604)"
    },
    {
      "name": "ERRD",
      "offset": 8606,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Fault code (manual address 8606)"
    },
    {
      "name": "CMD",
      "offset": 8501,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Control word (manual address 8501)",
      "writable": true
    },
    {
      "name": "LFr",
      "offset": 8502,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "Hz",
      "description": "Frequency reference via the bus (manual address 8502)",
      "writable": true
    },
    {
      "name": "PISP",
      "offset": 8503,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "%",
      "description": "PI regulator reference via the bus (manual address 8503)",
      "writable": true
    },
    {
      "name": "CMI",
      "offset": 8504,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Extended control word (manual address 8504)",
      "writable": true
    },
    {
      "name": "IOLR",
      "offset": 5240,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Logic I/O value (manual address 5240)",
      "writable": true
    },
    {
      "name": "AO1R",
      "offset": 5261,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Analog output value (manual address 5261)",
      "writable": true
    },
    {
      "name": "ETA",
      "offset": 3201,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Status word (manual address 3201)"
    },
    {
      "name": "rFr",
      "offset": 3202,
      "register_type": "int16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "Hz",
      "description": "Output frequency (manual address 3202)"
    },
    {
      "name": "FrH",
      "offset": 3203,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "Hz",
      "description": "Frequency reference before ramp (manual address 3203)"
    },
    {
      "name": "LCr",
      "offset": 3204,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "A",
      "description": "Motor current (manual address 3204)"
    },
    {
      "name": "Otr",
      "offset": 3205,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "%",
      "description": "Motor torque (manual address 3205)"
    },
    {
      "name": "OPr",
      "offset": 3211,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "%",
      "description": "Motor power (manual address 3211)"
    },
    {
      "name": "ULn",
      "offset": 3207,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "V",
      "description": "Line voltage (manual address 3207)"
    },
    {
      "name": "tHd",
      "offset": 3209,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "%",
      "description": "Drive thermal state (manual address 3209)"
    },
    {
      "name": "TDM",
      "offset": 3210,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "%",
      "description": "Maximum drive thermal state reached (manual address 3210)"
    },
    {
      "name": "tHr",
      "offset": 9630,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "%",
      "description": "Motor thermal state (manual address 9630)"
    },
    {
      "name": "rtH",
      "offset": 3231,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "h",
      "description": "Operating time (manual address 3231)"
    },
    {
      "name": "ETI",
      "offset": 3206,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Extended status word (manual address 3206)"
    },
    {
      "name": "USPL",
      "offset": 12002,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Motor speed in customer units, low word (manual address 12002)"
    },
    {
      "name": "USPH",
      "offset": 12003,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Motor speed in customer units, high word (manual address 12003)"
    },
    {
      "name": "LFt",
      "offset": 7121,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Last detected fault (manual address 7121)"
    },
    {
      "name": "DP1",
      "offset": 7201,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Past detected fault 1 (manual address 7201)"
    },
    {
      "name": "LSP",
      "offset": 3105,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "Hz",
      "description": "Low speed (manual address 3105)",
      "writable": true
    },
    {
      "name": "HSP",
      "offset": 3104,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "Hz",
      "description": "High speed (manual address 3104)",
      "writable": true
    },
    {
      "name": "ACC",
      "offset": 9001,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "s",
      "description": "Acceleration ramp time (manual address 9001)",
      "writable": true
    },
    {
      "name": "dEC",
      "offset": 9002,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "s",
      "description": "Deceleration ramp time (manual address 9002)",
      "writable": true
    },
    {
      "name": "Inr",
      "offset": 9020,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Ramp increment (manual address 9020)",
      "writable": true
    },
    {
      "name": "SFr",
      "offset": 3102,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "kHz",
      "description": "Switching frequency (manual address 3102)",
      "writable": true
    },
    {
      "name": "tFr",
      "offset": 3103,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "Hz",
      "description": "Maximum output frequency (manual address 3103)",
      "writable": true
    },
    {
      "name": "UnS",
      "offset": 9601,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "V",
      "description": "Nominal motor voltage (manual address 9601)",
      "writable": true
    },
    {
      "name": "FrS",
      "offset": 9602,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "Hz",
      "description": "Nominal motor frequency (manual address 9602)",
      "writable": true
    },
    {
      "name": "nCr",
      "offset": 9603,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "A",
      "description": "Nominal motor current (manual address 9603)",
      "writable": true
    },
    {
      "name": "nSP",
      "offset": 9604,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "unit": "rpm",
      "description": "Nominal motor speed (manual address 9604)",
      "writable": true
    },
    {
      "name": "COS",
      "offset": 9606,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.01,
      "description": "Motor power factor (cos phi) (manual address 9606)",
      "writable": true
    },
    {
      "name": "ItH",
      "offset": 9622,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "A",
      "description": "Motor thermal protection current (manual address 9622)",
      "writable": true
    },
    {
      "name": "CLI",
      "offset": 9201,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "A",
      "description": "Current limit (manual address 9201)",
      "writable": true
    },
    {
      "name": "Stt",
      "offset": 11201,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Normal stop mode (manual address 11201)",
      "writable": true
    },
    {
      "name": "Fr1",
      "offset": 8413,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Configuration reference 1 (manual address 8413)",
      "writable": true
    },
    {
      "name": "Cd1",
      "offset": 8423,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Control channel 1 configuration (manual address 8423)",
      "writable": true
    },
    {
      "name": "Add",
      "offset": 6001,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Modbus drive address (manual address 6001)",
      "writable": true
    },
    {
      "name": "tbr",
      "offset": 6003,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Modbus transmission speed code (manual address 6003)",
      "writable": true
    },
    {
      "name": "tFO",
      "offset": 6004,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 1,
      "description": "Modbus communication format code (manual address 6004)",
      "writable": true
    },
    {
      "name": "ttO",
      "offset": 6005,
      "register_type": "uint16",
      "register_area": "holding",
      "scale": 0.1,
      "unit": "s",
      "description": "Modbus time-out (manual address 6005)",
      "writable": true
    }
  ]
}
