{
 "manufacturer": "Teracom",
 "manufacturer_slug": "teracom",
 "model": "TSH331 IP54 Modbus RTU humidity and temperature sensor",
 "model_slug": "tsh331",
 "short_model": "TSH331",
 "aliases": [
  "TSH331"
 ],
 "equipment_type": "Sensor (humidity / temperature)",
 "applies_to": "TSH331 per the Teracom TSH331 user manual Rev. 1.5, firmware v1.08 or later.",
 "summary": "The TSH331 is an IP54 humidity and temperature sensor from Teracom with a Modbus RTU RS-485 port, cable gland and screwless terminals. It reports temperature, humidity and dew point as floats and x100 integers in Â°C and Â°F.",
 "transport": [
  "RTU"
 ],
 "defaults": {
  "unit_id": 1,
  "baud": 19200,
  "parity": "Even",
  "data_bits": 8,
  "stop_bits": 1,
  "tcp_port": null
 },
 "addressing": {
  "convention": "Modicon",
  "note": "The register table prints both a PDU (wire) address and a logical address (PDU + 40001 for holding registers). 'documented' holds the logical number; the PDU number is what goes in the request, e.g. logical 40101 = PDU 100."
 },
 "default_word_order": "ABCD",
 "firmware": "v1.08 or later",
 "source": {
  "title": "TSH331 User manual",
  "doc_number": "Rev. 1.5",
  "revision_date": "2026-10",
  "url": "https://www.teracomsystems.com/download/modbus-rtu-waterproof-temperature-and-humidity-sensor-tsh331-user-manual/",
  "pages": "p. 4 (Modbus address table)"
 },
 "notes": [
  "Addresses are taken from the manual's PDU address column (0-based); the logical column is the same number plus 40001, the holding-register offset the manual states.",
  "All 32-bit values follow the Data order register (PDU 13): 1 = most significant word first (factory default), 2 = least significant word first. The map shows the default, ABCD.",
  "Left out: the 32-bit float/integer test-value registers (PDU 82-95), which only exist to check word order; the 16-bit test values are kept.",
  "Float blocks: PDU 100+ in Â°C and PDU 200+ in Â°F; the integer blocks (PDU 400+ Â°C, 500+ Â°F) hold the same values x100 as 16-bit words. A missing reading returns NaN (float) or -32768 (16-bit integer).",
  "Readings can be trimmed with the multiplier and offset floats near PDU 2100: corrected = measured x multiplier + offset."
 ],
 "registers": [
  {
   "table": "holding_register",
   "address": 10,
   "documented": "40011",
   "name": "RS-485 address",
   "description": "Modbus slave address of the device.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 11,
   "documented": "40012",
   "name": "Baud rate",
   "description": "Serial baud rate; takes effect after a power cycle.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 12,
   "documented": "40013",
   "name": "Parity, data, stop bits",
   "description": "Parity/data/stop framing; takes effect after a power cycle.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": {
    "1": "8 data bits, even parity, 1 stop (E81)",
    "2": "8 data bits, odd parity, 1 stop (O81)",
    "3": "8 data bits, no parity, 1 stop (N81)"
   },
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 13,
   "documented": "40014",
   "name": "Data order",
   "description": "Word order used for all 32-bit values.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": {
    "1": "MSWF - most significant word first",
    "2": "LSWF - least significant word first"
   },
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 14,
   "documented": "40015",
   "name": "Device code",
   "description": "Fixed product identification code.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 15,
   "documented": "40016",
   "name": "FW version",
   "description": "Firmware version number.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 18,
   "documented": "40019",
   "name": "Vendor URL",
   "description": "Maker URL as UTF-8 text (64 bytes).",
   "data_type": "STRING",
   "length": 32,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 86,
   "documented": "40087",
   "name": "Signed integer test value",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 91,
   "documented": "40092",
   "name": "Unsigned integer test value",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 100,
   "documented": "40101",
   "name": "Temperature °C",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 102,
   "documented": "40103",
   "name": "Humidity %RH",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "%RH",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 104,
   "documented": "40105",
   "name": "Dew point °C",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 200,
   "documented": "40201",
   "name": "Temperature °F",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "°F",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 202,
   "documented": "40203",
   "name": "Humidity %RH",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "%RH",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 204,
   "documented": "40205",
   "name": "Dew point °F",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "°F",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 400,
   "documented": "40401",
   "name": "Temperature °C x 100",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 401,
   "documented": "40402",
   "name": "Humidity %RH x 100",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "%RH",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 402,
   "documented": "40403",
   "name": "Dew point °C x 100",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 500,
   "documented": "40501",
   "name": "Temperature °F x 100",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "°F",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 501,
   "documented": "40502",
   "name": "Humidity %RH x 100",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "%RH",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 502,
   "documented": "40503",
   "name": "Dew point °F x 100",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.01,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "°F",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 2101,
   "documented": "42102",
   "name": "Temperature multiplier",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 2103,
   "documented": "42104",
   "name": "Temperature offset °C",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 2105,
   "documented": "42106",
   "name": "Temperature offset °F",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "°F",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 2111,
   "documented": "42112",
   "name": "Humidity multiplier",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 2113,
   "documented": "42114",
   "name": "Humidity offset",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null
  }
 ],
 "integration": {
  "summary": "Poll the float block PDU 100-105 or the integer block PDU 400-402 with function 03.",
  "minimum_registers": [
   {
    "table": "holding_register",
    "address": 100,
    "why": "Temperature Â°C (float)"
   },
   {
    "table": "holding_register",
    "address": 102,
    "why": "Humidity %RH (float)"
   },
   {
    "table": "holding_register",
    "address": 104,
    "why": "Dew point Â°C"
   },
   {
    "table": "holding_register",
    "address": 400,
    "why": "Temperature Â°C x100"
   },
   {
    "table": "holding_register",
    "address": 401,
    "why": "Humidity x100"
   }
  ],
  "enable": "Modbus RTU is the only interface and is always active; there is nothing to switch on. Factory settings are address 1, 19200 baud, 8E1.",
  "watchdog": null,
  "quirks": [
   "Baud rate and framing changes only take effect after the device is powered off and on again.",
   "Word order for every 32-bit value is set by the Data order register (PDU 13); check it before blaming the scaling."
  ],
  "setup": [
   "Set unit ID (PDU 10), baud (PDU 11) and framing (PDU 12), then power-cycle the device.",
   "Wire sensors as a daisy chain; the last sensor needs a 120 ohm terminator, which the TSH331 has built in (close its jumper)."
  ],
  "gotchas": []
 },
 "page": "https://easymodbus.com/modbus-register-maps/teracom/tsh331",
 "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."
}
