{
 "manufacturer": "Acromag",
 "manufacturer_slug": "acromag",
 "model": "BusWorks XT1211-000 / XT1221-000 8-channel differential analog input (Modbus TCP)",
 "model_slug": "xt1211-xt1221",
 "short_model": "XT1211/XT1221",
 "aliases": [
  "XT1211-000",
  "XT1221-000",
  "XT1211",
  "XT1221",
  "BusWorks XT1211",
  "BusWorks XT1221"
 ],
 "equipment_type": "Sensor (Ethernet analog input module)",
 "applies_to": "BusWorks XT1211-000 (current) and XT1221-000 (voltage) per user's manual 8500951K.",
 "summary": "The Acromag BusWorks XT1211 (current) and XT1221 (voltage) are 8-channel differential analog input modules on Modbus TCP. The Modbus map is read-only: eight normalized channel values and a heartbeat counter.",
 "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 XT1211/XT1221-000 8 CH Differential Current/Voltage Input User's Manual",
  "doc_number": "8500951K",
  "revision_date": "2022-11-18",
  "url": "https://www.acromag.com/wp-content/uploads/2019/06/Acromag-XT1211-and-XT1221_951K-User-Manual.pdf",
  "pages": "pp. 33-35 (Modbus functions, data types, register map)"
 },
 "notes": [
  "Channel values are normalized counts, not engineering units: bipolar ranges read -30000 to +30000 for -100 % to +100 %, unipolar ranges 0-30000; with legacy support enabled the span is 20000 instead. The range is chosen per channel in the USB software (XT1211: ±20 mA, 0-20 mA, 0-11.17 mA, 4-20 mA; XT1221: ±10 V, ±5 V, 0-10 V, 0-5 V).",
  "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, averaging and IP settings are set only with the USB configuration software.",
  "The Unit ID is ignored and echoed back in Modbus TCP."
 ],
 "registers": [
  {
   "table": "input_register",
   "address": 0,
   "documented": "30001",
   "name": "CH 00 data",
   "description": "Normalized count: ±30000 = ±100 % of the range (±20000 in legacy mode).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 1,
   "documented": "30002",
   "name": "CH 01 data",
   "description": "Normalized count: ±30000 = ±100 % of the range (±20000 in legacy mode).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 2,
   "documented": "30003",
   "name": "CH 02 data",
   "description": "Normalized count: ±30000 = ±100 % of the range (±20000 in legacy mode).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 3,
   "documented": "30004",
   "name": "CH 03 data",
   "description": "Normalized count: ±30000 = ±100 % of the range (±20000 in legacy mode).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 4,
   "documented": "30005",
   "name": "CH 04 data",
   "description": "Normalized count: ±30000 = ±100 % of the range (±20000 in legacy mode).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 5,
   "documented": "30006",
   "name": "CH 05 data",
   "description": "Normalized count: ±30000 = ±100 % of the range (±20000 in legacy mode).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 6,
   "documented": "30007",
   "name": "CH 06 data",
   "description": "Normalized count: ±30000 = ±100 % of the range (±20000 in legacy mode).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 7,
   "documented": "30008",
   "name": "CH 07 data",
   "description": "Normalized count: ±30000 = ±100 % of the range (±20000 in legacy mode).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 8,
   "documented": "30009",
   "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
  }
 ],
 "integration": {
  "summary": "Read input registers 0-7 for the eight channels and convert counts to engineering units from the configured range (30000 = 100 %). Watch register 8 to confirm fresh data.",
  "minimum_registers": [
   {
    "table": "input_register",
    "address": 0,
    "why": "Channel 0"
   },
   {
    "table": "input_register",
    "address": 1,
    "why": "Channel 1"
   },
   {
    "table": "input_register",
    "address": 7,
    "why": "Channel 7"
   },
   {
    "table": "input_register",
    "address": 8,
    "why": "Heartbeat"
   }
  ],
  "enable": "Modbus TCP needs no enabling; set the IP address (default static 192.168.1.100) and channel ranges with the USB configuration software before connecting to the network.",
  "watchdog": null,
  "quirks": [
   "Values are normalized counts (30000 or 20000 = 100 %), not volts or milliamps."
  ],
  "setup": [
   "Configure IP address, input ranges and averaging over USB before connecting to the network."
  ],
  "gotchas": [
   "Use a USB isolator when configuring with grounded inputs connected, or a ground loop can shift readings."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/acromag/xt1211-xt1221",
 "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."
}
