Matter Specification - Temperature Measurement Cluster

Matter :: Temperature Measurement Cluster

This cluster provides an interface to temperature measurement functionality, including configuration and provision of notifications of temperature measurements.
온도 측정 센서를 위한 클러스터

1. Classification

Hierarchy	Role	Scope	PICS Code
Base	Application	Endpoint	TMP

2. Identifier

Identifier	Name
0x0402	Temperature Measurement

3. Attributes

3.1. Measured Value

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0000	MeasuredValue	temperature	MinMeasuredValue ~ MaxMeasuredValue	XP		R V	M

This attribute SHALL indicate the measured temperature.

The null value indicates that the temperature is unknown.

3.2. Min Measured Value

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0001	MinMeasuredValue	temperature	-27315 to MaxMeasuredValue-1	X		R V	M

This attribute SHALL indicate the minimum value of MeasuredValue that is capable of being measured. See Measured Value for more details.

The null value indicates that the value is not available.

3.3. Max Measured Value

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0002	MaxMeasuredValue	temperature	MinMeasuredValue+1 to 32767	X		R V	M

This attribute indicates the maximum value of MeasuredValue that is capable of being measured. See Measured Value for more details.

The null value indicates that the value is not available.

3.4. Tolerance

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0003	Tolerance	uint16	0 to 2048		0	R V	O

See Measured Value.

4. Measured Value

4.1. Constraint

Where MinMeasuredValue or MaxMeasuredValue attributes are mandatory the null value MAY be used to indicate that a limit is unknown.

For any measurement cluster with MeasuredValue, MinMeasuredValue and MaxMeasuredValue attributes, the following SHALL be always be true:

• If MinMeasuredValue and MaxMeasuredValue are both known, then MaxMeasuredValue SHALL be greater than MinMeasuredValue.
• If MaxMeasuredValue is known, then MeasuredValue SHALL be less than or equal to MaxMeasuredValue.
• If MinMeasuredValue is known, then MeasuredValue SHALL be greater than or equal to MinMeasuredValue.

4.2. Tolerance

For any measurement cluster with a MeasuredValue and Tolerance attribute, when Tolerance is implemented the following SHALL always be true:

• The Tolerance attribute SHALL indicate the magnitude of the possible error that is associated with MeasuredValue attribute, using the same units and resolution. The true value SHALL be in the range (MeasuredValue – Tolerance) to (MeasuredValue + Tolerance).
• If known, the true value SHALL never be outside the possible physical range. Some examples:
  • a temperature SHALL NOT be below absolute zero
  • a concentration SHALL NOT be negative

5. Data Type

5.1. Derived Data Types

Class	Data Type	Short	Base Type	ID	Size
Analog	Temperature	temperature	int16	0xD8	2 bytes
This type, derived from int16, represents a temperature on the Celsius scale with a resolution of 0.01°C. - value = (temperature in °C) x 100 -4°C ⇒ -400 - 123.45°C ⇒ 12345 The range is constrained by absolute zero: -273.15°C to 327.67°C.