{
 "manufacturer": "KELLER",
 "manufacturer_slug": "keller",
 "model": "X-Line digital pressure transmitters, Series 30 / 40 (Modbus RTU)",
 "model_slug": "x-line-series-30-40",
 "short_model": "KELLER X-Line",
 "aliases": [
  "Series 30X",
  "Series 33X",
  "Series 35X",
  "Series 36X",
  "Series 46X",
  "PAA-33X",
  "PR-33X",
  "PA-36XW",
  "Class.Group 5.20",
  "Class.Group 5.21",
  "Class.Group 5.24"
 ],
 "equipment_type": "Sensor (pressure transmitter)",
 "applies_to": "KELLER X-Line transmitters with RS-485, Class.Group firmware 5.20-10.40 or later, 5.21 and 5.24 (protocol document version 3.7).",
 "summary": "KELLER X-Line digital pressure transmitters (Series 30 and 40) speak both the KELLER bus protocol and Modbus RTU on the same RS-485 line. This map covers the Modbus process values (pressure P1/P2, temperatures and the calculated CH0 channel) as floats, x100 integers and 32-bit integers, the conductivity values of 5.21 devices, and the main configuration and status registers.",
 "transport": [
  "RTU"
 ],
 "defaults": {
  "unit_id": 1,
  "baud": 9600,
  "parity": "None",
  "data_bits": 8,
  "stop_bits": 1,
  "tcp_port": null
 },
 "addressing": {
  "convention": "hex 0-based",
  "note": "The document gives the start address (StAdd) in hex exactly as it goes into the request; its example reads P1 with start address 0x0002."
 },
 "default_word_order": "ABCD",
 "firmware": "Class.Group 5.20-10.40 and later, 5.21-xx.xx, 5.24-xx.xx (older 5.20-5.50 only supports the floats at 0x0000-0x000A and the 16-bit integers)",
 "source": {
  "title": "Description of the Communication protocol for X-Line Pressure Transmitters from KELLER (Class.Group 5.20, 5.21, 5.24)",
  "doc_number": "Version 3.7",
  "revision_date": "2020-11",
  "url": "https://us.keller-pressure.com/file-cache/website_component/5e2f29419d8b1060a188c377/manuals/1625167998276",
  "pages": "Chapter 4 MODBUS communication, pp. 8-17; float format chapter 6.2, p. 33"
 },
 "notes": [
  "Floats and 32-bit integers are high word first (ABCD): the register map labels the first register HWord, the float chapter puts the exponent byte in register 0, and the worked P1 read returns 3F 75 F0 7B = 0.9607 bar.",
  "Each channel must be read in one request starting on an even address; an odd start returns exception 2.",
  "Inactive channels read NaN (float), 32767 (16-bit) or 2147483647 (32-bit); over/underflow reads +/- infinity in the float range.",
  "Which ranges exist depends on firmware: 32-bit integers need 5.20-12.28 or later; 16-bit integers work on 5.20-5.50 and on 5.20-12.28 or later but not on 5.20-10.40; the 0x0100 block and the 0x02xx configuration range need 5.20-10.40 or later.",
  "Left out: the coefficient ranges (0x03xx, 0x3xxx, 0x40xx), command registers above 0xFF00, conductivity range/compensation settings and the ASCII serial number.",
  "The KELLER bus protocol (functions 30-100) runs on the same line; this map covers only the Modbus functions 3, 6, 8 and 16."
 ],
 "registers": [
  {
   "table": "holding_register",
   "address": 0,
   "documented": "0x0000",
   "name": "CH0 calculated value",
   "description": "Customer-specific calculated channel.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2,
   "documented": "0x0002",
   "name": "P1 pressure",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "bar",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 4,
   "documented": "0x0004",
   "name": "P2 pressure",
   "description": "Second pressure sensor, if fitted.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "bar",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 6,
   "documented": "0x0006",
   "name": "T temperature",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 8,
   "documented": "0x0008",
   "name": "TOB1 sensor 1 temperature",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10,
   "documented": "0x000A",
   "name": "TOB2 sensor 2 temperature",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 16,
   "documented": "0x0010",
   "name": "CH0 (integer x100)",
   "description": "32767 = error/overflow.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 17,
   "documented": "0x0011",
   "name": "P1 (integer x100)",
   "description": "Range +/-327 bar.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "bar",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 18,
   "documented": "0x0012",
   "name": "P2 (integer x100)",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "bar",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 19,
   "documented": "0x0013",
   "name": "T (integer x100)",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 20,
   "documented": "0x0014",
   "name": "TOB1 (integer x100)",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 21,
   "documented": "0x0015",
   "name": "TOB2 (integer x100)",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 32,
   "documented": "0x0020",
   "name": "CH0 (32-bit integer)",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1e-05,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 34,
   "documented": "0x0022",
   "name": "P1 (32-bit integer)",
   "description": "Pascal (1e-5 bar).",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "Pa",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 36,
   "documented": "0x0024",
   "name": "P2 (32-bit integer)",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "Pa",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 38,
   "documented": "0x0026",
   "name": "T (32-bit integer)",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.01,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 40,
   "documented": "0x0028",
   "name": "TOB1 (32-bit integer)",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.01,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 42,
   "documented": "0x002A",
   "name": "TOB2 (32-bit integer)",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.01,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 256,
   "documented": "0x0100",
   "name": "P1 pressure (block 2)",
   "description": "Same as 0x0002, regrouped for one-shot reads.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "bar",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 258,
   "documented": "0x0102",
   "name": "TOB1 temperature (block 2)",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 260,
   "documented": "0x0104",
   "name": "P2 pressure (block 2)",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "bar",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 262,
   "documented": "0x0106",
   "name": "TOB2 temperature (block 2)",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 264,
   "documented": "0x0108",
   "name": "P1 pressure (block 2, copy)",
   "description": "Class.Group 5.21 / 5.24.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "bar",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 266,
   "documented": "0x010A",
   "name": "T temperature (block 2)",
   "description": "Class.Group 5.21 / 5.24.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 268,
   "documented": "0x010C",
   "name": "Conductivity, temperature compensated",
   "description": "5.21 devices with conductivity only.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "mS/cm",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 270,
   "documented": "0x010E",
   "name": "Conductivity, raw",
   "description": "5.21 devices with conductivity only.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "mS/cm",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 512,
   "documented": "0x0200",
   "name": "UART settings",
   "description": "Bits 0-3 baud (0 = 9600, 1 = 115200).",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": {
    "4": "Parity enabled",
    "5": "Even parity (0 = odd)",
    "6": "2 stop bits (5.21/5.24)"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 514,
   "documented": "0x0202",
   "name": "Serial number high word",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 515,
   "documented": "0x0203",
   "name": "Serial number low word",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 516,
   "documented": "0x0204",
   "name": "Active pressure channels",
   "description": "",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "1": "P1",
    "2": "P2"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 517,
   "documented": "0x0205",
   "name": "Active temperature channels",
   "description": "",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "3": "T",
    "4": "TOB1",
    "5": "TOB2",
    "7": "Conductivity (5.21)"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 518,
   "documented": "0x0206",
   "name": "CH0 calculation mode",
   "description": "Restart needed after change.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Inactive",
    "1": "P1-P2",
    "2": "P2-P1",
    "3": "sqrt(P1)",
    "4": "sqrt(P2)",
    "5": "sqrt(P1-P2)",
    "6": "sqrt(P2-P1)",
    "11": "abs(P1)",
    "12": "abs(P1-P2)",
    "13": "Line-pressure compensated dP (factory)",
    "14": "Straight-line fit of P1",
    "15": "PT1000 temperature"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 521,
   "documented": "0x0209",
   "name": "Sensor type (P-Mode)",
   "description": "Low nibble P1, high nibble P2: 0 = PR relative, 1 = PA absolute, 2 = PAA absolute.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 522,
   "documented": "0x020A",
   "name": "Filter control",
   "description": "",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": {
    "0": "Adaptive filter P1/P2 on",
    "1": "Low-pass filter T/TOB1/TOB2 on"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 524,
   "documented": "0x020C",
   "name": "Device status",
   "description": "Set bit = error in that channel.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "CH0 error",
    "1": "P1 error",
    "2": "P2 error",
    "3": "T error",
    "4": "TOB1 error",
    "5": "TOB2 error",
    "6": "ERR2 analog output computation error",
    "7": "/STD power-up mode"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 525,
   "documented": "0x020D",
   "name": "Device address",
   "description": "1-247, default 1; 250 = transparent.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 526,
   "documented": "0x020E",
   "name": "Firmware Class.Group",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 527,
   "documented": "0x020F",
   "name": "Firmware Year.Week",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 533,
   "documented": "0x0215",
   "name": "Inter-frame time at 9600 baud",
   "description": "Default 35 (3.5 ms); 5.21-16.50+ and 5.24.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "ms",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 534,
   "documented": "0x0216",
   "name": "Inter-frame time at 115200 baud",
   "description": "Default 18 (1.8 ms).",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "ms",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  }
 ],
 "integration": {
  "summary": "Read 4 registers from 0x0100 (function 03) for P1 and its temperature as ABCD floats, or 0x0002-0x000B for all process values. Use the x100 integers at 0x0010 if your master has no float support.",
  "minimum_registers": [
   {
    "table": "holding_register",
    "address": 2,
    "why": "Pressure P1 (bar)"
   },
   {
    "table": "holding_register",
    "address": 8,
    "why": "Sensor temperature"
   },
   {
    "table": "holding_register",
    "address": 256,
    "why": "P1 + TOB1 in one read"
   },
   {
    "table": "holding_register",
    "address": 524,
    "why": "Channel error bits"
   },
   {
    "table": "holding_register",
    "address": 17,
    "why": "P1 as x100 integer"
   }
  ],
  "enable": "Modbus is always active alongside the KELLER protocol; no initialisation command is needed.",
  "watchdog": null,
  "quirks": [
   "Modbus CRC is sent low byte first; the KELLER protocol sends it high byte first.",
   "Address 250 reaches any device regardless of its address (point-to-point use only).",
   "Older firmware limits a read to 2 or 4 registers per request."
  ],
  "setup": [
   "Defaults: address 1, 9600 baud, 8N1. 115200 baud, parity and 2 stop bits are set in register 0x0200."
  ],
  "gotchas": [
   "Single-register writes (function 06) are refused in the 0x03xx and 0xFFxx ranges and on float registers; use function 16."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/keller/x-line-series-30-40",
 "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."
}
