{
 "manufacturer": "Vaisala",
 "manufacturer_slug": "vaisala",
 "model": "GMW87 CO2 and temperature wall transmitter (Modbus RTU)",
 "model_slug": "gmw87",
 "short_model": "GMW87",
 "aliases": [
  "GMW87",
  "GMW80 series Modbus"
 ],
 "equipment_type": "Sensor (CO2 wall transmitter)",
 "applies_to": "GMW87, the RS-485 Modbus RTU model of the GMW80 series (user guide M211748EN-H).",
 "summary": "The GMW87 is the Modbus RTU member of the Vaisala GMW80 family of CO2 wall transmitters for building automation. Address, bit rate and parity are set with DIP switches. This map covers CO2 and internal temperature in float and integer form, status registers and the integer and float test registers.",
 "transport": [
  "RTU"
 ],
 "defaults": {
  "unit_id": null,
  "baud": null,
  "parity": null,
  "data_bits": 8,
  "stop_bits": null,
  "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": "GMW80 Series User Guide",
  "doc_number": "M211748EN-H",
  "revision_date": "2021-10",
  "url": "https://docs.vaisala.com/r/M211748EN-H/en-US",
  "pages": "Chapter 4 Modbus communication pp. 30-31; Appendix A Modbus reference pp. 47-51 (Tables 13-18)"
 },
 "notes": [
  "All registers are holding registers read with function 03; the guide lists no write function code.",
  "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.",
  "Only GMW87 has the RS-485 Modbus interface; the other GMW80 models are analog.",
  "The temperature value is the internal device temperature, not a specified room measurement.",
  "Left out: error code register 514, a 32-bit integer meant for Vaisala support; the guide states the word order only for 32-bit floats.",
  "Left out: text string test register 7940, because the guide does not give its length in registers."
 ],
 "registers": [
  {
   "table": "holding_register",
   "address": 0,
   "documented": "1",
   "name": "Measured CO2",
   "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": 4,
   "documented": "5",
   "name": "Measured temperature",
   "description": "Internal device temperature; accuracy not specified.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 256,
   "documented": "257",
   "name": "Measured CO2 (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": 258,
   "documented": "259",
   "name": "Measured temperature (integer)",
   "description": "Internal device temperature.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 512,
   "documented": "513",
   "name": "Device status",
   "description": "0 = OK; other values are listed in the troubleshooting section.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 518,
   "documented": "519",
   "name": "Temperature measurement status",
   "description": "0 = OK.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "2": "Under range",
    "3": "Over range",
    "7": "Sensor failure",
    "8": "Measurement not ready (CO2 only)"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 519,
   "documented": "520",
   "name": "CO2 measurement status",
   "description": "",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "2": "Under range",
    "3": "Over range",
    "7": "Sensor failure",
    "8": "Measurement not ready (CO2 only)"
   },
   "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
  }
 ],
 "integration": {
  "summary": "Read holding registers 1-2 for CO2 as a CDAB float, or 257 as an integer. Status 513 is 0 when the device is OK.",
  "minimum_registers": [
   {
    "table": "holding_register",
    "address": 0,
    "why": "CO2 ppm"
   },
   {
    "table": "holding_register",
    "address": 256,
    "why": "CO2 ppm (integer)"
   },
   {
    "table": "holding_register",
    "address": 512,
    "why": "Device status"
   },
   {
    "table": "holding_register",
    "address": 519,
    "why": "CO2 measurement status"
   }
  ],
  "enable": "Set the Modbus address, bit rate and parity with the DIP switches on the transmitter board before power-up.",
  "watchdog": null,
  "quirks": [
   "Floats are low word first (CDAB); pick \"word-swapped\" float in masters that default to high word first.",
   "Read each 32-bit value in one transaction."
  ],
  "setup": [
   "Address (1-247), bit rate (4800, 9600, 19200, 38400, 57600, 76800 or 115200) and parity (None or Even) are set with DIP switches on the component board; the guide gives no factory default.",
   "1 and 2 stop bits are both accepted automatically.",
   "Up to 8 transmitters per RS-485 line; turn on the 120 ohm termination DIP switch only on the last device if the bus has no other terminator."
  ],
  "gotchas": [
   "With all address switches off (address 0) the transmitter is offline and never answers.",
   "Use the test registers (7937, 7938) to confirm float format and addressing before trusting readings."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/vaisala/gmw87",
 "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."
}
