{
 "manufacturer": "Acromag",
 "manufacturer_slug": "acromag",
 "model": "BusWorks XT1121-000 16-channel sourcing digital I/O (Modbus TCP)",
 "model_slug": "xt1121",
 "short_model": "XT1121-000",
 "aliases": [
  "XT1121-000",
  "XT1121",
  "BusWorks XT1121"
 ],
 "equipment_type": "Sensor (Ethernet digital I/O module)",
 "applies_to": "BusWorks XT1121-000 per user's manual 8500950P (revision P, 18 Nov 2022).",
 "summary": "The Acromag BusWorks XT1121-000 is a Modbus TCP Ethernet module with 16 active-high inputs paired with 16 high-side (sourcing) outputs. Its Modbus map is I/O only: four input-state words, a heartbeat counter and four output-command words; all setup is done over USB.",
 "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 (30001, 40001) and the 0-based address column (0, 1, 2...); the address column is what goes on the wire."
 },
 "default_word_order": null,
 "firmware": null,
 "source": {
  "title": "BusWorks XT Series Model XT1121-000 16-Channel Sourcing Digital I/O User's Manual",
  "doc_number": "8500950P",
  "revision_date": "2022-11-18",
  "url": "https://www.acromag.com/wp-content/uploads/2019/06/Acromag-XT1121_950P-User-Manual.pdf",
  "pages": "pp. 31-35 (Modbus registers, register map)"
 },
 "notes": [
  "Each group word covers four channels in bits 0-3; bits 4-15 are unused and read 0.",
  "Input words show the real level at each channel, so they also read back the state of the paired output.",
  "There are no configuration registers: IP settings, input invert and watchdog are set only with the USB configuration software.",
  "The manual's revision table lists 8500950P as released 18 Nov 2022; the download URL path still carries a 2019 date."
 ],
 "registers": [
  {
   "table": "input_register",
   "address": 0,
   "documented": "30001",
   "name": "Input State Group 0 (CH0-3)",
   "description": "Input states, bit 0 = lowest channel; 1 = high (no invert).",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "CH0",
    "1": "CH1",
    "2": "CH2",
    "3": "CH3"
   }
  },
  {
   "table": "input_register",
   "address": 1,
   "documented": "30002",
   "name": "Input State Group 1 (CH4-7)",
   "description": "Input states, bit 0 = lowest channel; 1 = high (no invert).",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "CH4",
    "1": "CH5",
    "2": "CH6",
    "3": "CH7"
   }
  },
  {
   "table": "input_register",
   "address": 2,
   "documented": "30003",
   "name": "Input State Group 2 (CH8-11)",
   "description": "Input states, bit 0 = lowest channel; 1 = high (no invert).",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "CH8",
    "1": "CH9",
    "2": "CH10",
    "3": "CH11"
   }
  },
  {
   "table": "input_register",
   "address": 3,
   "documented": "30004",
   "name": "Input State Group 3 (CH12-15)",
   "description": "Input states, bit 0 = lowest channel; 1 = high (no invert).",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "CH12",
    "1": "CH13",
    "2": "CH14",
    "3": "CH15"
   }
  },
  {
   "table": "input_register",
   "address": 4,
   "documented": "30005",
   "name": "Heart Beat",
   "description": "Counter that rises by 1 per transfer and wraps at 65535.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 0,
   "documented": "40001",
   "name": "Set Output State Group 0 (CH0-3)",
   "description": "Output commands, bit 0 = lowest channel; 1 = on (sourcing).",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": {
    "0": "CH0",
    "1": "CH1",
    "2": "CH2",
    "3": "CH3"
   }
  },
  {
   "table": "holding_register",
   "address": 1,
   "documented": "40002",
   "name": "Set Output State Group 1 (CH4-7)",
   "description": "Output commands, bit 0 = lowest channel; 1 = on (sourcing).",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": {
    "0": "CH4",
    "1": "CH5",
    "2": "CH6",
    "3": "CH7"
   }
  },
  {
   "table": "holding_register",
   "address": 2,
   "documented": "40003",
   "name": "Set Output State Group 2 (CH8-11)",
   "description": "Output commands, bit 0 = lowest channel; 1 = on (sourcing).",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": {
    "0": "CH8",
    "1": "CH9",
    "2": "CH10",
    "3": "CH11"
   }
  },
  {
   "table": "holding_register",
   "address": 3,
   "documented": "40004",
   "name": "Set Output State Group 3 (CH12-15)",
   "description": "Output commands, bit 0 = lowest channel; 1 = on (sourcing).",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": {
    "0": "CH12",
    "1": "CH13",
    "2": "CH14",
    "3": "CH15"
   }
  }
 ],
 "integration": {
  "summary": "Read input registers 0-3 for input states and write holding registers 0-3 to drive the outputs, four channels per word. Watch input register 4 to confirm the module is updating.",
  "minimum_registers": [
   {
    "table": "input_register",
    "address": 0,
    "why": "Inputs CH0-3"
   },
   {
    "table": "input_register",
    "address": 1,
    "why": "Inputs CH4-7"
   },
   {
    "table": "input_register",
    "address": 4,
    "why": "Heartbeat"
   },
   {
    "table": "holding_register",
    "address": 0,
    "why": "Outputs CH0-3"
   },
   {
    "table": "holding_register",
    "address": 1,
    "why": "Outputs CH4-7"
   }
  ],
  "enable": "Modbus TCP needs no enabling; set the IP address (default static 192.168.1.100) with the USB configuration software before connecting to the network. The manual does not print the TCP port number.",
  "watchdog": "Per-channel watchdog (5-65534 s, 0 or 65535 = off) set in the USB software: with no read/write activity for that time the output goes to its chosen watchdog state and stays there until written again.",
  "quirks": [
   "Output commands are lost at reset (outputs start OFF); they are not kept in flash.",
   "The Unit ID is ignored and echoed back."
  ],
  "setup": [
   "Configure IP address, input invert and watchdog over USB before connecting to the network.",
   "Outputs need 6-32 V excitation on EXC to work."
  ],
  "gotchas": [
   "If an 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/xt1121",
 "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."
}
