TemperatureMeasurement Cluster

Cluster ID: 0x0402  |  Endpoint: Typically on Endpoint 1+ (application endpoint)

TemperatureMeasurement is one of the simplest sensor Clusters — it has only 4 Attributes and no Commands. The device acts as a Server, passively reporting temperature data, while the App (Client) simply reads or subscribes. Commonly found on temperature/humidity sensors, thermostats, and HVAC panels.

Attribute Overview

TemperatureMeasurement has only four Attributes, of which MeasuredValue is the most commonly used. Click an Attribute ID to jump to its detailed description.

Attributes

MeasuredValue (Current Measured Temperature)

The most recently measured temperature from the sensor, in units of 0.01°C. This is the most important Attribute of the entire Cluster.

• Type: int16 (signed, supports negative temperatures)
• Range: -27315 (-273.15°C, absolute zero) to 32767 (327.67°C)
• Nullable: null indicates the sensor data is invalid or the first measurement has not yet completed
• Conversion: Actual temperature = MeasuredValue / 100

↑ Back to Attributes

MinMeasuredValue (Minimum Measurable Temperature)

The lowest temperature the sensor can measure, in units of 0.01°C. The App can use this to set the lower bound of the temperature display range, or to determine whether the current reading has reached the minimum.

• Type: int16, Nullable
• Range: -27315 to MaxMeasuredValue - 1
• Nullable: null indicates the device has not defined a lower limit

↑ Back to Attributes

MaxMeasuredValue (Maximum Measurable Temperature)

The highest temperature the sensor can measure, in units of 0.01°C. When MeasuredValue approaches this upper limit, it may indicate the sensor has exceeded its normal operating range.

• Type: int16, Nullable
• Range: MinMeasuredValue + 1 to 32767
• Nullable: null indicates the device has not defined an upper limit

↑ Back to Attributes

Tolerance (Measurement Tolerance)

The measurement tolerance of the sensor, in units of 0.01°C. For example, a value of 50 means a measurement accuracy of ±0.50°C. This Attribute is optional and not all devices report it.

• Type: uint16 (unsigned, tolerance cannot be negative)
• Range: 0 to 2048 (i.e., 0 to ±20.48°C)

↑ Back to Attributes

Commands

TemperatureMeasurement is a read-only Server Cluster with no Commands. The device is responsible for collecting temperature data and updating Attributes; the App only needs to Read or Subscribe to obtain data.

Example Data

Reading the TemperatureMeasurement Cluster Attributes from a temperature/humidity sensor:

{
  // --- TemperatureMeasurement Cluster (Endpoint 1) ---
  "0x0": 2550,       // MeasuredValue = 2550 → actual 25.50°C
  "0x1": -1000,      // MinMeasuredValue = -1000 → actual -10.00°C
  "0x2": 6000,       // MaxMeasuredValue = 6000 → actual 60.00°C
  "0x3": 50          // Tolerance = 50 → actual ±0.50°C
}

Read request example — retrieve all Cluster Attributes at once:

{
  // Read all Attributes of the temperature sensor
  "readRequests": [{
    "attributePath": {
      "endpointId": 1,
      "clusterId": "0x0402"
      // No attributeId specified → read all Attributes of this Cluster
    }
  }]
}

Subscribe to temperature changes — track temperature updates in real time:

{
  // Subscribe to temperature changes (report every 30 seconds to 5 minutes)
  "subscribeRequests": [{
    "attributePath": {
      "endpointId": 1,
      "clusterId": "0x0402",
      "attributeId": "0x00"        // MeasuredValue
    },
    "minIntervalFloor": 30,        // Report at least every 30 seconds
    "maxIntervalCeiling": 300      // Report at most every 5 minutes
  }]
}

{`// Device returns MeasuredValue = 2550
val rawValue: Int? = 2550    // Nullable, may be null
val tempCelsius = rawValue?.let { it / 100.0 }  // → 25.50°C
val tempFahrenheit = tempCelsius?.let { it * 9.0 / 5.0 + 32 }  // → 77.90°F

// Handle null when displaying
val display = tempCelsius?.let { String.format("%.1f°C", it) } ?: "--"`}

Common Scenarios