{
 "manufacturer": "Vaisala",
 "manufacturer_slug": "vaisala",
 "model": "HMW87 / HMW87D wall humidity and temperature transmitters (Modbus RTU)",
 "model_slug": "hmw87",
 "short_model": "HMW87",
 "aliases": [
  "HMW87",
  "HMW87D",
  "HMDW80 Modbus"
 ],
 "equipment_type": "Sensor (humidity and temperature transmitter)",
 "applies_to": "HMW87 and HMW87D wall transmitters of the HMDW80 series (the Modbus models in user guide M211510EN-J).",
 "summary": "The HMW87 and HMW87D are the RS-485 Modbus RTU members of the Vaisala HMDW80 wall transmitter family (the D version has a display). This map covers humidity, temperature and calculated readings in float and integer form, status, filtering, serial and display settings and test registers.",
 "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": "HMDW80 Series User Guide",
  "doc_number": "M211510EN-J",
  "revision_date": "2026-06",
  "url": "https://docs.vaisala.com/r/M211510EN-J/en-US",
  "pages": "Appendix A Modbus reference for HMW87 and HMW87D, pp. 76-85"
 },
 "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's data-encoding section covers both formats and its worked read and write examples confirm the order.",
  "Unavailable data reads as quiet NaN (float) or 0x8000 (16-bit integer) rather than an exception.",
  "The guide's Modbus chapter applies only to HMW87 and HMW87D; the other HMDW80 models in the same guide are not covered by this map.",
  "Integer registers carry one decimal (raw x 0.1).",
  "Register 513 reads 0 when an error is active and 1 when there is none, as printed in the guide.",
  "Error codes 1024, 16384 and 32768 are readable only through Insight according to the guide, so they are not listed as status bits.",
  "Left out: display units register 3075, because the guide names the options (metric / non-metric) without giving their numeric values."
 ],
 "registers": [
  {
   "table": "holding_register",
   "address": 0,
   "documented": "1",
   "name": "Relative humidity",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "%RH",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2,
   "documented": "3",
   "name": "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": 8,
   "documented": "9",
   "name": "Dew/frost point 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": 18,
   "documented": "19",
   "name": "Wet-bulb 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": 26,
   "documented": "27",
   "name": "Enthalpy",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "kJ/kg",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 256,
   "documented": "257",
   "name": "Relative humidity (integer)",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "%RH",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 257,
   "documented": "258",
   "name": "Temperature (integer)",
   "description": "",
   "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": 260,
   "documented": "261",
   "name": "Dew/frost point (integer)",
   "description": "",
   "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": 265,
   "documented": "266",
   "name": "Wet-bulb temperature (integer)",
   "description": "",
   "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": 269,
   "documented": "270",
   "name": "Enthalpy (integer)",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "kJ/kg",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 512,
   "documented": "513",
   "name": "Error status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "One or more errors active",
    "1": "No errors"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 515,
   "documented": "516",
   "name": "Status code",
   "description": "Sum of active error codes.",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "Temperature measurement error",
    "1": "Humidity measurement error",
    "2": "Humidity sensor failure",
    "3": "Capacitance reference error",
    "4": "Ambient temperature out of range",
    "5": "Firmware checksum mismatch",
    "6": "Device settings corrupted",
    "7": "Additional configuration settings corrupted",
    "8": "Sensor coefficients corrupted",
    "9": "Main configuration settings corrupted",
    "11": "Supply voltage out of range",
    "13": "Non-volatile memory read/write failure"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 517,
   "documented": "518",
   "name": "Security hash",
   "description": "Changes when settings change.",
   "data_type": "INT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 519,
   "documented": "520",
   "name": "RH measurement status",
   "description": "0 = OK.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "Not available",
    "6": "Calibration expired",
    "7": "Sensor failure"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 520,
   "documented": "521",
   "name": "T measurement status",
   "description": "0 = OK.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "6": "Calibration expired",
    "7": "Sensor failure"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 784,
   "documented": "785",
   "name": "Filtering factor",
   "description": "0.001 = maximum filtering, 1.000 = none.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "CDAB",
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1536,
   "documented": "1537",
   "name": "Modbus address",
   "description": "1-247, default 240; 0 = offline.",
   "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": "Takes effect after restart.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "5": "9600",
    "6": "19200",
    "7": "38400",
    "8": "57600"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1538,
   "documented": "1539",
   "name": "Parity, data, stop bits",
   "description": "Takes effect after restart.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "N81",
    "1": "N82",
    "2": "E81",
    "3": "E82",
    "4": "O81",
    "5": "O82"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1539,
   "documented": "1540",
   "name": "Response delay",
   "description": "0-1020 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": 1541,
   "documented": "1542",
   "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": 3072,
   "documented": "3073",
   "name": "Display parameter 1",
   "description": "HMW87D only; address of the shown value (0x0000, 0x0002, 0x0008, 0x0012, 0x001A).",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 3073,
   "documented": "3074",
   "name": "Display parameter 2",
   "description": "HMW87D only; as 3073, 0xFFFF disables.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 7680,
   "documented": "7681",
   "name": "Restore settings",
   "description": "Write 1 to restore factory settings.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "W",
   "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-4 for RH and temperature (CDAB floats), or the integer copies 257-258 (raw x 0.1) if your controller lacks float support.",
  "minimum_registers": [
   {
    "table": "holding_register",
    "address": 0,
    "why": "Relative humidity"
   },
   {
    "table": "holding_register",
    "address": 2,
    "why": "Temperature"
   },
   {
    "table": "holding_register",
    "address": 8,
    "why": "Dew point"
   },
   {
    "table": "holding_register",
    "address": 512,
    "why": "Error status"
   },
   {
    "table": "holding_register",
    "address": 515,
    "why": "Status code"
   }
  ],
  "enable": "HMW87 and HMW87D ship as Modbus RTU transmitters on RS-485; change the serial settings with Vaisala Insight PC software, the Indigo80 indicator or registers 1537-1540.",
  "watchdog": null,
  "quirks": [
   "Floats are low word first (CDAB); pick \"word-swapped\" float 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, response delay 0.",
   "Bit rate and parity changes take effect after a restart (register 1542)."
  ],
  "gotchas": [
   "Use the test registers (7937 on) to confirm float format and addressing before trusting readings.",
   "Writing address 0 to register 1537 takes the transmitter offline: it stops answering Modbus requests."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/vaisala/hmw87",
 "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."
}
