{
 "manufacturer": "Vaisala",
 "manufacturer_slug": "vaisala",
 "model": "HPP271 hydrogen peroxide probe (Modbus RTU)",
 "model_slug": "hpp271",
 "short_model": "HPP271",
 "aliases": [
  "HPP271",
  "PEROXCAP HPP271"
 ],
 "equipment_type": "Sensor (H2O2 probe)",
 "applies_to": "HPP271 vaporized hydrogen peroxide probe, Modbus RTU interface (user guide M211888EN-E).",
 "summary": "The HPP271 is a Vaisala PEROXCAP probe for vaporized hydrogen peroxide. It is a Modbus RTU slave on RS-485. This map covers H2O2 concentration, H2O+H2O2 dew point and water concentration, status codes, sensor vitality, pressure compensation, purge, low-H2O2 threshold and analog-output settings.",
 "transport": [
  "RTU"
 ],
 "defaults": {
  "unit_id": 240,
  "baud": 19200,
  "parity": "None",
  "data_bits": 8,
  "stop_bits": 2,
  "tcp_port": null
 },
 "addressing": {
  "convention": "1-based",
  "note": "The guide numbers registers in decimal starting at 1 and also prints the 0-based hex address used in the request; register number 1 is address 0x0000 on the wire."
 },
 "default_word_order": "CDAB",
 "firmware": null,
 "source": {
  "title": "HPP271 User Guide",
  "doc_number": "M211888EN-E",
  "revision_date": "2023-04",
  "url": "https://docs.vaisala.com/r/M211888EN-E/en-US",
  "pages": "Appendix A Modbus reference, pp. 86-101 (Tables 11-22)"
 },
 "notes": [
  "All registers are holding registers: read with function 03, write with function 16.",
  "32-bit floats and 32-bit integers put the least significant word at the listed register (CDAB). The guide states this and its worked read example confirms it.",
  "Unavailable data reads as quiet NaN (float) or 0x8000 (16-bit integer) rather than an exception.",
  "Left out: the restore-factory-settings register, because the guide prints its number (7937) and hex address (1E00) inconsistently and 7937 is also the signed-integer test register.",
  "Clipping and error-limit registers for the analog outputs (1801-1807, 2057-2063) and the service agreement block (2817-2846) are left out.",
  "Status code registers 514 and 516 are 32-bit values and follow the low-word-first rule the guide gives for 32-bit integers."
 ],
 "registers": [
  {
   "table": "holding_register",
   "address": 0,
   "documented": "1",
   "name": "H2O2 concentration by volume",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "ppm",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 10,
   "documented": "11",
   "name": "H2O+H2O2 dew point",
   "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": 14,
   "documented": "15",
   "name": "Water concentration by volume",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "ppm",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 256,
   "documented": "257",
   "name": "H2O2 concentration (integer)",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "ppm",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 261,
   "documented": "262",
   "name": "H2O+H2O2 dew point (integer)",
   "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": 263,
   "documented": "264",
   "name": "Water concentration (integer)",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "ppm",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 512,
   "documented": "513",
   "name": "Device status",
   "description": "0 = OK.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "Critical error, maintenance needed",
    "1": "Error, may recover automatically",
    "2": "Warning",
    "3": "Notification",
    "4": "Calibration enabled"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 513,
   "documented": "514",
   "name": "Status code low",
   "description": "Sum of active codes.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "Firmware checksum mismatch",
    "1": "Device settings corrupted",
    "3": "Supply voltage too high",
    "4": "Internal voltage too low",
    "5": "Internal voltage too high",
    "6": "Humidity sensor failure (open circuit)",
    "10": "Humidity sensor failure (open circuit)",
    "14": "Temperature sensor failure (open circuit)",
    "15": "Temperature sensor failure (short circuit)",
    "18": "Temperature sensor failure (open circuit)",
    "19": "Temperature sensor failure (short circuit)"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 515,
   "documented": "516",
   "name": "Status code high",
   "description": "Sum of active codes.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "8": "A/D converter failure (external)",
    "9": "Non-volatile memory failure",
    "12": "Humidity sensor failure (short circuit)",
    "13": "Purge in progress",
    "14": "A/D converter failure (internal)",
    "15": "Calibration about to expire",
    "16": "Calibration expired"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 528,
   "documented": "529",
   "name": "H2O2 concentration status",
   "description": "0 = OK.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "1": "Not reliable",
    "5": "Locked during purge",
    "6": "Calibration expired",
    "7": "Sensor failure",
    "8": "Not ready"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 533,
   "documented": "534",
   "name": "Dew point status",
   "description": "",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "1": "Not reliable",
    "5": "Locked during purge",
    "6": "Calibration expired",
    "7": "Sensor failure",
    "8": "Not ready"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 535,
   "documented": "536",
   "name": "Water concentration status",
   "description": "",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "1": "Not reliable",
    "5": "Locked during purge",
    "6": "Calibration expired",
    "7": "Sensor failure",
    "8": "Not ready"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 546,
   "documented": "547",
   "name": "Sensor vitality",
   "description": "1-100 %; 100 = new sensor. In demanding use, Vaisala advises service at 40 %.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 768,
   "documented": "769",
   "name": "Volatile pressure compensation",
   "description": "813.25-1213.25; cleared at reset.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "hPa",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 772,
   "documented": "773",
   "name": "Power-up pressure compensation",
   "description": "Default 1013.25.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "hPa",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 776,
   "documented": "777",
   "name": "Purge interval",
   "description": "60-10080, default 1440.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "min",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 778,
   "documented": "779",
   "name": "Measurement filtering factor",
   "description": "0.01-1; 1 = off. H2O2 only.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 782,
   "documented": "783",
   "name": "Low H2O2 threshold on/off",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 784,
   "documented": "785",
   "name": "Low H2O2 threshold activation level",
   "description": "Default 3.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "ppm",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 786,
   "documented": "787",
   "name": "Low H2O2 threshold activation delay",
   "description": "Default 1800.",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "s",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 788,
   "documented": "789",
   "name": "Low H2O2 threshold deactivation level",
   "description": "Default 10.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "ppm",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 790,
   "documented": "791",
   "name": "Low H2O2 threshold deactivation delay",
   "description": "Default 10.",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "s",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1282,
   "documented": "1283",
   "name": "Purge status / manual start",
   "description": "Write 1 to start; reads 1-100 progress, 0 done, -1 failed.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1284,
   "documented": "1285",
   "name": "Pressure compensation on/off",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1286,
   "documented": "1287",
   "name": "Manual purge trigger in analog mode",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1287,
   "documented": "1288",
   "name": "Allow interval purge during H2O2 exposure",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1536,
   "documented": "1537",
   "name": "Modbus address",
   "description": "1-255, default 240.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1537,
   "documented": "1538",
   "name": "Bit rate",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "5": "9600",
    "6": "19200",
    "7": "38400",
    "8": "57600",
    "9": "115200"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1538,
   "documented": "1539",
   "name": "Parity, data, stop bits",
   "description": "Default 1 (None, 8, 2).",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "None, 8, 1",
    "1": "None, 8, 2",
    "2": "Even, 8, 1",
    "3": "Even, 8, 2",
    "4": "Odd, 8, 1",
    "5": "Odd, 8, 2"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1539,
   "documented": "1540",
   "name": "Response delay",
   "description": "Extra delay 0-1000 ms.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "ms",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1540,
   "documented": "1541",
   "name": "Restart device",
   "description": "Write 1 to restart.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "W",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1792,
   "documented": "1793",
   "name": "AOUT1 output mode",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "2": "4-20 mA"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1793,
   "documented": "1794",
   "name": "AOUT1 output parameter",
   "description": "Address 0x0000, 0x000A or 0x000E.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1794,
   "documented": "1795",
   "name": "AOUT1 scale low end",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1796,
   "documented": "1797",
   "name": "AOUT1 scale high end",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1798,
   "documented": "1799",
   "name": "AOUT1 error output",
   "description": "0-25 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": 2048,
   "documented": "2049",
   "name": "AOUT2 output mode",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "2": "4-20 mA"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2049,
   "documented": "2050",
   "name": "AOUT2 output parameter",
   "description": "Address 0x0000, 0x000A or 0x000E.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2050,
   "documented": "2051",
   "name": "AOUT2 scale low end",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2052,
   "documented": "2053",
   "name": "AOUT2 scale high end",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2054,
   "documented": "2055",
   "name": "AOUT2 error output",
   "description": "0-25 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": 7936,
   "documented": "7937",
   "name": "Signed integer test",
   "description": "Always reads -12345.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 7937,
   "documented": "7938",
   "name": "Floating point test",
   "description": "Always reads -123.45.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 7939,
   "documented": "7940",
   "name": "Text string test",
   "description": "Reads the text \"-123.45\".",
   "data_type": "STRING",
   "length": 4,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  }
 ],
 "integration": {
  "summary": "Read holding registers 1-16 for H2O2, dew point and water concentration (CDAB floats); check 513 and 529 for reading validity.",
  "minimum_registers": [
   {
    "table": "holding_register",
    "address": 0,
    "why": "H2O2 ppm"
   },
   {
    "table": "holding_register",
    "address": 10,
    "why": "H2O+H2O2 dew point"
   },
   {
    "table": "holding_register",
    "address": 512,
    "why": "Device status"
   },
   {
    "table": "holding_register",
    "address": 528,
    "why": "H2O2 reading status"
   },
   {
    "table": "holding_register",
    "address": 546,
    "why": "Sensor vitality"
   }
  ],
  "enable": "Digital (RS-485 Modbus) or analog output is chosen at power-up by pin 5 of the M12 connector: leave pin 5 floating for Modbus, tie it to ground for analog. Power-cycle after changing it.",
  "watchdog": null,
  "quirks": [
   "Floats and 32-bit integers are low word first (CDAB); pick \"word-swapped\" in masters that default to high word first.",
   "Read or write each 32-bit value in one transaction."
  ],
  "setup": [
   "Defaults: address 240, 19200 baud, no parity, 8 data bits, 2 stop bits.",
   "Change address, bit rate, parity/stop bits and response delay with registers 1537-1540; writing 1 to 1541 restarts the probe."
  ],
  "gotchas": [
   "Use the test registers (7937 reads -12345, 7938 reads -123.45) to confirm float format and addressing before trusting readings.",
   "After starting a purge by writing 1 to 1283, only read that register until the purge has finished."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/vaisala/hpp271",
 "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."
}
