{
  "spec_version": 1,
  "slug": "vaisala-gmp252",
  "manufacturer": "Vaisala",
  "model": "CARBOCAP GMP252 carbon dioxide probe",
  "category": "Sensor",
  "supplier_url": "https://www.vaisala.com/en/products/instruments-sensors-and-other-measurement-devices/instruments-industrial-measurements/gmp252",
  "default_configuration": {
    "protocol": "modbus_rtu",
    "unit_id": 240,
    "addressing": "one_based",
    "byte_order": "BigEndian",
    "word_order": "LowFirst",
    "native_interface": "rs485",
    "serial": {
      "baud_rate": 19200,
      "parity": "None",
      "data_bits": 8,
      "stop_bits": 2
    }
  },
  "coils": [],
  "discrete_inputs": [],
  "input_registers": [],
  "holding_registers": [
    {
      "address": 1,
      "count": 2,
      "name": "Measured CO2 value",
      "data_type": "Float32",
      "units": "ppm",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "32-bit float. The register number is the document's own 1-based number; the PDU address is 0 (0000hex)."
    },
    {
      "address": 3,
      "count": 2,
      "name": "Compensation temperature",
      "data_type": "Float32",
      "units": "°C",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "32-bit float (0002hex). The temperature the probe uses for CO2 compensation."
    },
    {
      "address": 5,
      "count": 2,
      "name": "Measured temperature",
      "data_type": "Float32",
      "units": "°C",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "32-bit float (0004hex). Temperature measured by the probe."
    },
    {
      "address": 257,
      "count": 1,
      "name": "Measured CO2 value (16-bit integer)",
      "data_type": "Int16",
      "units": "ppm",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "16-bit signed integer (0100hex), up to 32 000 ppm. An unavailable measurement returns 0000hex rather than an exception."
    },
    {
      "address": 258,
      "count": 1,
      "name": "Measured CO2 value (16-bit integer, x10)",
      "data_type": "Int16",
      "units": "ppm",
      "scale_factor": 10,
      "offset": 0,
      "access": "R",
      "description": "16-bit signed integer (0101hex). The document states that this register is scaled and must be multiplied by 10, so the range reaches about 320 000 ppm."
    },
    {
      "address": 513,
      "count": 2,
      "name": "Power-up value for pressure compensation",
      "data_type": "Float32",
      "units": "hPa",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "0200hex. 700...1500 hPa (operating limit 1.5 bar), init/default 1013.25. Written to EEPROM, which is rated for 30 000 writes."
    },
    {
      "address": 515,
      "count": 2,
      "name": "Power-up value for temperature compensation",
      "data_type": "Float32",
      "units": "°C",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "0202hex. -40...+80 °C, init/default 25."
    },
    {
      "address": 517,
      "count": 2,
      "name": "Power-up value for humidity compensation",
      "data_type": "Float32",
      "units": "%RH",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "0204hex. 0...100 %RH, init/default 0."
    },
    {
      "address": 519,
      "count": 2,
      "name": "Power-up value for oxygen compensation",
      "data_type": "Float32",
      "units": "%O2",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "0206hex. 0...100 %O2, init/default 0."
    },
    {
      "address": 521,
      "count": 2,
      "name": "Volatile pressure compensation",
      "data_type": "Float32",
      "units": "hPa",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "0208hex. Same range as register 513 but cleared at probe reset; use this register for values that change regularly."
    },
    {
      "address": 523,
      "count": 2,
      "name": "Volatile temperature compensation",
      "data_type": "Float32",
      "units": "°C",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "020Ahex. Same range as register 515 but cleared at probe reset."
    },
    {
      "address": 525,
      "count": 2,
      "name": "Volatile humidity compensation",
      "data_type": "Float32",
      "units": "%RH",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "020Chex. Same range as register 517 but cleared at probe reset."
    },
    {
      "address": 527,
      "count": 2,
      "name": "Volatile oxygen compensation",
      "data_type": "Float32",
      "units": "%O2",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "020Ehex. Same range as register 519 but cleared at probe reset."
    },
    {
      "address": 769,
      "count": 1,
      "name": "Modbus address",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "0300hex. Valid range 1...247, factory default 240."
    },
    {
      "address": 770,
      "count": 1,
      "name": "Serial speed",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "0301hex. Enum: 0 = 4800, 1 = 9600, 2 = 19200, 3 = 38400, 4 = 57600, 5 = 115200 baud. Factory default 2 (19200)."
    },
    {
      "address": 771,
      "count": 1,
      "name": "Serial parity",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "0302hex. Enum: 0 = None, 1 = Even, 2 = Odd. Factory default 0 (None)."
    },
    {
      "address": 772,
      "count": 1,
      "name": "Serial stop bits",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "0303hex. Valid range 1...2, factory default 2."
    },
    {
      "address": 773,
      "count": 1,
      "name": "Pressure compensation mode",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "0304hex. Enum: 0 = Off, 1 = On. Factory default 1 (On)."
    },
    {
      "address": 774,
      "count": 1,
      "name": "Temperature compensation mode",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "0305hex. Enum: 0 = Off, 1 = Given, 2 = Measured. Factory default 2 (Measured)."
    },
    {
      "address": 775,
      "count": 1,
      "name": "Humidity compensation mode",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "0306hex. Enum: 0 = Off, 1 = On. Factory default 0 (Off)."
    },
    {
      "address": 776,
      "count": 1,
      "name": "Oxygen compensation mode",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "0307hex. Enum: 0 = Off, 1 = On. Factory default 0 (Off)."
    },
    {
      "address": 777,
      "count": 1,
      "name": "CO2 filtering factor",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "0308hex. Valid range 0...100, factory default 100 (no filtering). A lower value means heavier filtering."
    },
    {
      "address": 2049,
      "count": 1,
      "name": "Device status",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0800hex. 0 = status OK, 1 = critical error, 2 = error, 4 = warning; several statuses can be set at once and the values add up."
    },
    {
      "address": 2050,
      "count": 1,
      "name": "CO2 status",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "0801hex. 0 = status OK, 2 = CO2 reading not reliable (during start-up), 256 = measurement not ready (during start-up)."
    }
  ],
  "combined_registers": [],
  "notes": "Source: Vaisala 'User Guide - Vaisala CARBOCAP Carbon Dioxide Probe GMP252', document M211897EN-D ((c) Vaisala 2018), chapter 5 'Modbus' and Appendix A 'Modbus Reference' (A.1 function codes, A.2.1 measurement data, A.2.2 configuration registers, A.2.3 status registers). The vendor serves the current edition (M211897EN-F) through its documentation portal at https://docs.vaisala.com/r/M211897EN-F/en-US, which is a JavaScript application with no downloadable PDF; the file read here is the vendor's own PDF mirrored by a distributor at https://envcoglobal.com/wp-content/uploads/2020/02/gmp252-user-guide.pdf (SHA-256 25287e143763e8203749de9b742285297c6e07c3785925e3f5875e8ec65c613f) - the mirror rule of the 7 Nov ruling. Factory serial settings from Table 45 'Default Modbus Serial Communication Settings': 19200 bps, no parity, 8 data bits, 2 stop bits, Modbus device address 240. They are the same values the configuration registers report (770 = 2 = 19200, 771 = 0 = None, 772 = 2 stop bits, 769 = 240). Addressing: Appendix A.2 states that the registers are numbered from one and that the PDU address is the register number minus one (register 769 = address 0300hex), so the printed register numbers are stored with addressing 'one_based'. Word order: A.3 prints a float as two registers 'least significant word first', backed by a worked read (D47A then 43E8 = 465.65997 ppm), so the seed declares LowFirst; bytes inside each register stay big-endian. Modbus is one of two serial protocols: the probe can also be in Vaisala Industrial Protocol mode, and the guide's chapter 4.6 explains the 'smode modbus' and 'addr' commands that switch it. The probe serves function codes 03 (read), 16 (write), and 43/14 (read device identification). Registers 513-519 are written to EEPROM (30 000 write cycles); 521-527 are the volatile copies that are cleared on reset. The pressure, temperature, humidity and oxygen compensation values only take effect in the modes set by registers 773-776."
}
