{
 "manufacturer": "JUMO",
 "manufacturer_slug": "jumo",
 "model": "digiLine O-DO S10 optical oxygen sensor (Modbus RTU)",
 "model_slug": "digiline-o-do-s10",
 "short_model": "digiLine O-DO S10",
 "aliases": [
  "JUMO digiLine O-DO S10",
  "digiLine O-DO"
 ],
 "equipment_type": "Sensor (dissolved oxygen)",
 "applies_to": "JUMO digiLine O-DO S10 digital oxygen sensor on RS-485 Modbus RTU (interface description V2.00, 2021-08-20).",
 "summary": "The JUMO digiLine O-DO S10 is an optical dissolved oxygen sensor with digiLine electronics that can be read directly over Modbus RTU or through a JUMO digiLine master. This map covers the oxygen and temperature readings, status word, compensation values (flash and RAM), unit selection, analog output, serial and float-format settings and identification.",
 "transport": [
  "RTU"
 ],
 "defaults": {
  "unit_id": null,
  "baud": null,
  "parity": null,
  "data_bits": 8,
  "stop_bits": null,
  "tcp_port": null
 },
 "addressing": {
  "convention": "0-based",
  "note": "Tables give the Modbus PDU address in decimal and hex; it is sent unchanged (the example reads temperature at 0x2620)."
 },
 "default_word_order": "CDAB",
 "firmware": null,
 "source": {
  "title": "JUMO digiLine O-DO S10 - Oxygen sensor with digital interface - Modbus interface description",
  "doc_number": "20261400T92Z001K000 V2.00/EN/00753777",
  "revision_date": "2021-08-20",
  "url": "https://www.onetemp.com.au/wp-content/uploads/2024/02/digiLine-O-DO-S10-Digital-DO-Sensor-Modbus-Interface-Description.pdf",
  "unofficial": true,
  "pages": "Data types and float format ch. 2.5-2.6 (pp. 13-15); float error codes ch. 2.8.2 (p. 19); address tables ch. 6 (pp. 27-35)"
 },
 "notes": [
  "Copy hosted by the Australian distributor Onetemp; JUMO does not offer a public direct link to this document. The file is the unaltered JUMO interface description.",
  "Float order is selectable in register 775. In \"Standard Modbus format\" (0) the low word comes first (CDAB): the guide says bytes 1-2 and 3-4 are swapped and its temperature example returns 00 00 41 A2 = 20.25 °C. The guide does not state which setting is the factory default, so read 775 first.",
  "Invalid float readings are replaced by error codes: 1.0E37 underrange, 2.0E37 overrange, 3.0E37 invalid input, 4.0E37 division by zero, 5.0E37 math error, 6.0E37 invalid compensation temperature, 7.0E37 probe short circuit, 8.0E37 probe break, 9.0E37 timeout.",
  "Write cyclic compensation values only to the RAM registers (9648-9653); the flash values (9600-9603) must not be written cyclically.",
  "Left out: operating hours and other Uint32 counters (no stated word order), date/time and text fields, the analog output warning/error enable flags (char booleans) and the out-of-range temperature output value.",
  "Default serial settings are not stated in the document."
 ],
 "registers": [
  {
   "table": "holding_register",
   "address": 0,
   "documented": "0 (0x0000)",
   "name": "Device name",
   "description": "ASCII, zero-terminated.",
   "data_type": "STRING",
   "length": 5,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 5,
   "documented": "5 (0x0005)",
   "name": "Software version",
   "description": "ASCII, zero-terminated.",
   "data_type": "STRING",
   "length": 6,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 256,
   "documented": "256 (0x0100)",
   "name": "Serial number",
   "description": "ASCII, zero-terminated.",
   "data_type": "STRING",
   "length": 10,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 266,
   "documented": "266 (0x010A)",
   "name": "Sensor type",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "1": "digiLine pH/ORP/T",
    "2": "digiLine CR/Ci",
    "4": "digiLine O-DO S10"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 267,
   "documented": "267 (0x010B)",
   "name": "Oxygen sensor sub-type",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "digiLine O-DO S10"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 768,
   "documented": "768 (0x0300)",
   "name": "Device address",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 769,
   "documented": "769 (0x0301)",
   "name": "Baud rate",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "9600",
    "1": "19200",
    "2": "38400"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 770,
   "documented": "770 (0x0302)",
   "name": "Data format",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "8-1 no parity",
    "1": "8-1 odd parity",
    "2": "8-1 even parity",
    "3": "8-2 no parity"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 773,
   "documented": "773 (0x0305)",
   "name": "Minimum response time",
   "description": "0-500 ms delay before the sensor answers.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "ms",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 775,
   "documented": "775 (0x0307)",
   "name": "Float value format",
   "description": "Word/byte order of all floats.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Standard Modbus format",
    "1": "IEEE 754 Little Endian",
    "2": "IEEE 754 Big Endian"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1026,
   "documented": "1026 (0x0402)",
   "name": "Sensor replacement counter",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1289,
   "documented": "1289 (0x0509)",
   "name": "Lowest temperature value",
   "description": "Drag indicator.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1291,
   "documented": "1291 (0x050B)",
   "name": "Highest temperature value",
   "description": "Drag indicator.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 8769,
   "documented": "8769 (0x2241)",
   "name": "Analog output function",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Inactive",
    "1": "Fixed value",
    "2": "Standard signal 4-20 mA"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 8770,
   "documented": "8770 (0x2242)",
   "name": "Analog output scaling start",
   "description": "Measured value at 4 mA.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 8772,
   "documented": "8772 (0x2244)",
   "name": "Analog output scaling end",
   "description": "Measured value at 20 mA.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 8776,
   "documented": "8776 (0x2248)",
   "name": "Analog output fixed value",
   "description": "Used when function = 1.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "mA",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 8780,
   "documented": "8780 (0x224C)",
   "name": "Analog output warning value",
   "description": "3.5-21.5 mA.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "mA",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 8782,
   "documented": "8782 (0x224E)",
   "name": "Analog output error value",
   "description": "3.5-21.5 mA.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "mA",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9520,
   "documented": "9520 (0x2530)",
   "name": "Oxygen measurement unit",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "% vol",
    "1": "% SAT",
    "3": "ppm",
    "4": "mbar (partial pressure)"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9600,
   "documented": "9600 (0x2580)",
   "name": "Fixed compensation salt content",
   "description": "Stored in flash; do not write cyclically.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "mS/cm",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9602,
   "documented": "9602 (0x2582)",
   "name": "Fixed ambient pressure",
   "description": "Stored in flash; do not write cyclically.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "hPa",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9647,
   "documented": "9647 (0x25AF)",
   "name": "Compensation control byte",
   "description": "Low byte selects compensation sources.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": {
    "0": "Use RAM compensation temperature (else internal sensor)",
    "1": "Use RAM salt content (else flash value)",
    "2": "Use RAM ambient pressure (else flash value)"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9648,
   "documented": "9648 (0x25B0)",
   "name": "RAM compensation temperature",
   "description": "May be written cyclically.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9650,
   "documented": "9650 (0x25B2)",
   "name": "RAM compensation salt content",
   "description": "May be written cyclically.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "mS/cm",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9652,
   "documented": "9652 (0x25B4)",
   "name": "RAM ambient pressure",
   "description": "May be written cyclically.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "hPa",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9728,
   "documented": "9728 (0x2600)",
   "name": "Measured oxygen value",
   "description": "Unit per register 9520; error codes 1.0E37-9.0E37.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9760,
   "documented": "9760 (0x2620)",
   "name": "Measured temperature",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9792,
   "documented": "9792 (0x2640)",
   "name": "Status word",
   "description": "",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "Invalid oxygen value (warning)",
    "1": "Invalid temperature value (warning)",
    "2": "Sensor cap missing (alarm)",
    "8": "Oxygen outside measuring range (warning)",
    "9": "Temperature outside measuring range (warning)",
    "10": "Cap replacement recommended (warning)"
   },
   "offset": 0
  }
 ],
 "integration": {
  "summary": "Read 9728-9729 (oxygen) and 9760-9761 (temperature) as floats in the format set by register 775, plus the status word at 9792.",
  "minimum_registers": [
   {
    "table": "holding_register",
    "address": 9728,
    "why": "Oxygen value"
   },
   {
    "table": "holding_register",
    "address": 9760,
    "why": "Temperature"
   },
   {
    "table": "holding_register",
    "address": 9792,
    "why": "Status / warnings"
   },
   {
    "table": "holding_register",
    "address": 775,
    "why": "Float format in use"
   },
   {
    "table": "holding_register",
    "address": 9520,
    "why": "Oxygen unit"
   }
  ],
  "enable": "Modbus RTU is available directly on the sensor RS-485 line; set address and format with JUMO DSM software or registers 768-775.",
  "watchdog": null,
  "quirks": [
   "Float byte order follows register 775; standard Modbus format is low word first (CDAB).",
   "Function 03 and 04 both read; writes use 06/16."
  ],
  "setup": [
   "Baud 9600/19200/38400 and data format are set in registers 769-770."
  ],
  "gotchas": [
   "Treat values near 1E37-9E37 as error codes, not readings.",
   "The sensor origin text (638) is managed by digiLine masters and must not be written."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/jumo/digiline-o-do-s10",
 "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."
}
