{
 "manufacturer": "Acromag",
 "manufacturer_slug": "acromag",
 "model": "BusWorks XT1531-000 4-channel current output + 4 digital I/O (Modbus TCP)",
 "model_slug": "xt1531",
 "short_model": "XT1531-000",
 "aliases": [
  "XT1531-000",
  "XT1531",
  "BusWorks XT1531"
 ],
 "equipment_type": "Sensor (Ethernet analog output module)",
 "applies_to": "BusWorks XT1531-000 per its user's manual (file revision H, 18 Nov 2022).",
 "summary": "The Acromag BusWorks XT1531 is a Modbus TCP module with four 0-20/4-20 mA analog outputs and four digital I/O channels. The map has the output values, the digital output group (as coils or one holding register), input states and a heartbeat.",
 "transport": [
  "TCP"
 ],
 "defaults": {
  "unit_id": null,
  "baud": null,
  "parity": null,
  "data_bits": null,
  "stop_bits": null,
  "tcp_port": null
 },
 "addressing": {
  "convention": "Modicon",
  "note": "The register map prints both the reference (00001, 10001, 30001, 40001) and the 0-based address column; the address column is what goes on the wire."
 },
 "default_word_order": null,
 "firmware": null,
 "source": {
  "title": "BusWorks XT Series Model XT1531-000 4 CH Current Output + 4 CH Digital I/O User's Manual",
  "doc_number": "8501012H",
  "revision_date": "2022-11-18",
  "url": "https://www.acromag.com/wp-content/uploads/2019/06/Acromag-XT1531_012H-User-Manual.pdf",
  "pages": "pp. 38-42 (data types, register map, example code)"
 },
 "notes": [
  "Analog outputs are normalized counts: 0-30000 = 0-100 % of the selected 0-20 mA or 4-20 mA range (0-20000 with legacy support). The manual notes 20 mA corresponds to a raw DAC count of 29533 and 4 mA to 5907 on the 0-20 mA primary range.",
  "Digital outputs are either coils 00001-00004 (coil option enabled) or bits 0-3 of holding register 40001 (coil option disabled), never both. With 40001, read the current states first and mask, because all four outputs are written at once.",
  "The digital output register 40001 reads 0 after reset (outputs off) and is not kept in non-volatile memory.",
  "The map prints the Modicon reference and a 0-based address column; the address column is sent on the wire.",
  "There are no configuration registers: ranges, IP settings, coil-versus-holding mode and DIO watchdogs are set only with the USB configuration software.",
  "The Unit ID is ignored and echoed back in Modbus TCP."
 ],
 "registers": [
  {
   "table": "coil",
   "address": 0,
   "documented": "00001",
   "name": "Digital output CH0",
   "description": "Only when coil access is enabled in the USB software.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "coil",
   "address": 1,
   "documented": "00002",
   "name": "Digital output CH1",
   "description": "Only when coil access is enabled in the USB software.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "coil",
   "address": 2,
   "documented": "00003",
   "name": "Digital output CH2",
   "description": "Only when coil access is enabled in the USB software.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "coil",
   "address": 3,
   "documented": "00004",
   "name": "Digital output CH3",
   "description": "Only when coil access is enabled in the USB software.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 0,
   "documented": "10001",
   "name": "Digital input CH0",
   "description": "1 = input high (above 2 V).",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 1,
   "documented": "10002",
   "name": "Digital input CH1",
   "description": "1 = input high (above 2 V).",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 2,
   "documented": "10003",
   "name": "Digital input CH2",
   "description": "1 = input high (above 2 V).",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 3,
   "documented": "10004",
   "name": "Digital input CH3",
   "description": "1 = input high (above 2 V).",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 0,
   "documented": "30001",
   "name": "Digital I/O input states CH0-3",
   "description": "",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "CH0 ON",
    "1": "CH1 ON",
    "2": "CH2 ON",
    "3": "CH3 ON"
   },
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 1,
   "documented": "30002",
   "name": "Heart beat",
   "description": "Counts 0-65535 on each host transfer, then wraps.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 0,
   "documented": "40001",
   "name": "Set DO state CH0-3",
   "description": "Only when coil access is disabled; writes all four outputs.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": {
    "0": "DO CH0 ON",
    "1": "DO CH1 ON",
    "2": "DO CH2 ON",
    "3": "DO CH3 ON"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1,
   "documented": "40002",
   "name": "Set AO CH00 value",
   "description": "Normalized count: 0-30000 = 0-100 % of the output range (0-20000 in legacy mode).",
   "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": "40003",
   "name": "Set AO CH01 value",
   "description": "Normalized count: 0-30000 = 0-100 % of the output range (0-20000 in legacy mode).",
   "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": "40004",
   "name": "Set AO CH02 value",
   "description": "Normalized count: 0-30000 = 0-100 % of the output range (0-20000 in legacy mode).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 4,
   "documented": "40005",
   "name": "Set AO CH03 value",
   "description": "Normalized count: 0-30000 = 0-100 % of the output range (0-20000 in legacy mode).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  }
 ],
 "integration": {
  "summary": "Write holding registers 1-4 with normalized counts (30000 = 100 % of range) to set the four current outputs; drive digital outputs with coils 0-3 or holding register 0 depending on the configured mode.",
  "minimum_registers": [
   {
    "table": "holding_register",
    "address": 1,
    "why": "AO channel 0"
   },
   {
    "table": "holding_register",
    "address": 2,
    "why": "AO channel 1"
   },
   {
    "table": "holding_register",
    "address": 0,
    "why": "Digital outputs (holding mode)"
   },
   {
    "table": "input_register",
    "address": 0,
    "why": "Digital I/O states"
   },
   {
    "table": "input_register",
    "address": 1,
    "why": "Heartbeat"
   }
  ],
  "enable": "Modbus TCP needs no enabling; set the IP address (default static 192.168.1.100), output ranges and coil-versus-holding mode with the USB configuration software.",
  "watchdog": "Each digital I/O channel has a watchdog time (1-65534 s, 0 or 65535 = off) and watchdog state (on/off) set in the USB software; with no read/write activity for that time the output goes to its watchdog state. The manual describes no watchdog for the analog outputs.",
  "quirks": [
   "Digital outputs are off (40001 reads 0) after reset.",
   "Coil access and holding-register access to the digital outputs are mutually exclusive."
  ],
  "setup": [
   "Digital outputs need excitation on EXC to work."
  ],
  "gotchas": [
   "If a digital output is on, the paired input reads high; turn the output off to monitor a field signal on that channel.",
   "If the module is an i2o target, coil access must be disabled."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/acromag/xt1531",
 "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."
}
