{
 "manufacturer": "Acromag",
 "manufacturer_slug": "acromag",
 "model": "BusWorks XT1541-000 8-channel voltage output + 4 digital I/O (Modbus TCP)",
 "model_slug": "xt1541",
 "short_model": "XT1541-000",
 "aliases": [
  "XT1541-000",
  "XT1541",
  "BusWorks XT1541"
 ],
 "equipment_type": "Sensor (Ethernet analog output module)",
 "applies_to": "BusWorks XT1541-000 per its user's manual (file revision H, 18 Nov 2022).",
 "summary": "The Acromag BusWorks XT1541 is a Modbus TCP module with eight ±10 V / ±5 V analog outputs and four digital I/O channels. The map has the eight 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 XT1541-000 8 CH Voltage Output + 4 CH Digital I/O User's Manual",
  "doc_number": "8501015H",
  "revision_date": "2022-11-18",
  "url": "https://www.acromag.com/wp-content/uploads/2019/06/Acromag-XT1541_015H-User-Manual.pdf",
  "pages": "pp. 37-42 (data types, register map, example code)"
 },
 "notes": [
  "Analog outputs are normalized counts: -30000 to +30000 = -100 % to +100 % of the selected ±10 V or ±5 V range (±20000 with legacy support). A 0-10 V signal on the ±10 V range is 0 to 30000.",
  "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: ±30000 = ±100 % of the output range (±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: ±30000 = ±100 % of the output range (±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: ±30000 = ±100 % of the output range (±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: ±30000 = ±100 % of the output range (±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": 5,
   "documented": "40006",
   "name": "Set AO CH04 value",
   "description": "Normalized count: ±30000 = ±100 % of the output range (±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": 6,
   "documented": "40007",
   "name": "Set AO CH05 value",
   "description": "Normalized count: ±30000 = ±100 % of the output range (±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": 7,
   "documented": "40008",
   "name": "Set AO CH06 value",
   "description": "Normalized count: ±30000 = ±100 % of the output range (±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": 8,
   "documented": "40009",
   "name": "Set AO CH07 value",
   "description": "Normalized count: ±30000 = ±100 % of the output range (±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-8 with normalized counts (30000 = full scale of the selected range) to set the eight voltage 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": 8,
    "why": "AO channel 7"
   },
   {
    "table": "holding_register",
    "address": 0,
    "why": "Digital outputs (holding mode)"
   },
   {
    "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."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/acromag/xt1541",
 "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."
}
