Matter Specification - Concentration Measurement Clusters

Matter :: Concentration Measurement Clusters

The server cluster provides an interface to concentration measurement functionality.
This cluster SHALL to be used via an alias to a specific substance (see Cluster IDs).
일산화탄소, 이산화탄소, 이산화질소, 오존, 미세먼지(PM1, PM2.5, PM10), 포름알데히드, 총휘발성유기화합물(TVOC), 라돈 등 다양한 종류의 대기오염물질의 농도 측정 센서를 위한 클러스터

1. Classification

Hierarchy	Role	Scope	PICS Code
Base	Application	Endpoint	CONC

2. Identifier

Identifier	Name	Substance Measured	PICS Code
0x040C	Carbon Monoxide Concentration Measurement	Carbon Monoxide (CO)	CMOCONC
0x040D	Carbon Dioxide Concentration Measurement	Carbon Dioxide (CO2)	CDOCONC
0x0413	Nitrogen Dioxide Concentration Measurement	Nitrogen Dioxide (NO2)	NDOCONC
0x0415	Ozone Concentration Measurement	Ozone (O3)	OZCONC
0x042A	PM2.5 Concentration Measurement	PM2.5	PMICONC
0x042B	Formaldehyde Concentration Measurement	Formaldehyde (CH2O)	FLDCONC
0x042C	PM1 Concentration Measurement	PM1	PMHCONC
0x042D	PM10 Concentration Measurement	PM10	PMKCONC
0x042E	Total Volatile Organic Compounds Concentration Measurement	Total Volatile Organic Compounds (TVOC)	TVOCCONC
0x042F	Radon Concentration Measurement	Radon (Rn)	RNCONC

3. Features

Bit	Code	Feature	Conformance	Summary
0	MEA	Numeric Measurement	O.a+	Cluster supports numeric measurement of substance
1	LEV	Level Indication	O.a+	Cluster supports basic level indication for substance using the ConcentrationLevel enum
2	MED	Medium Level	[LEV]	Cluster supports the Medium Concentration Level
3	CRI	Critical Level	[LEV]	Cluster supports the Critical Concentration Level
4	PEA	Peak Measurement	[MEA]	Cluster supports peak numeric measurement of substance
5	AVG	Average Measurement	[MEA]	Cluster supports average numeric measurement of substance

4. Data Types

4.1. MeasurementUnitEnum

Value	Name	Summary	Conformance
0	PPM	Parts per Million (10^6)	MEA
1	PPB	Parts per Billion (10^9)	MEA
2	PPT	Parts per Trillion (10^12)	MEA
3	MGM3	Milligram per ㎥	MEA
4	UGM3	Microgram per ㎥	MEA
5	NGM3	Nanogram per ㎥	MEA
6	PM3	Particles per ㎥	MEA
7	BQM3	Becquerel per ㎥	MEA

4.2. MeasurementMediumEnum

Value	Name	Summary	Conformance
0	Air	The measurement is being made in Air	M
1	Water	The measurement is being made in Water	M
2	Soil	The measurement is being made in Soil	M

4.3. LevelValueEnum

Value	Name	Summary	Conformance
0	Unknown	The level is Unknown	M
1	Low	The level is considered Low	M
2	Medium	The level is considered Medium	MED
3	High	The level is considered High	M
4	Critical	The level is considered Critical	CRI

5. Attributes

5.1. Measured Value 

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0000	MeasuredValue	single	MinMeasuredValue to MaxMeasuredValue	X P	null	R V	MEA

This attribute SHALL represent the most recent measurement as a single-precision floating-point number. MeasuredValue’s unit is represented by MeasurementUnit.

A value of null indicates that the measurement is unknown or outside the valid range.

MinMeasuredValue and MaxMeasuredValue define the valid range for MeasuredValue.

5.2. Min Measured Value

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0001	MinMeasuredValue	single	max MaxMeasuredValue	X	null	R V	MEA

This attribute SHALL represent the minimum value of MeasuredValue that is capable of being measured. A MinMeasuredValue of null indicates that the MinMeasuredValue is not defined.

5.3. Max Measured Value

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0002	MaxMeasuredValue	single	min MinMeasuredValue	X	null	R V	MEA

This attribute SHALL represent the maximum value of MeasuredValue that is capable of being measured. A MaxMeasuredValue of null indicates that the MaxMeasuredValue is not defined.

5.4. Peak Measured Value

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0003	PeakMeasuredValue	single	MinMeasuredValue to MaxMeasuredValue	X P	null	R V	PEA

This attribute SHALL represent the maximum value of MeasuredValue that has been measured during the PeakMeasuredValueWindow. If this attribute is provided, the PeakMeasuredValueWindow attribute SHALL also be provided.

5.5. Peak Measued Value Window

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0004	PeakMeasuredValueWindow	elapsed-s	max 604800	P	1	R V	PEA

This attribute SHALL represent the window of time used for determining the PeakMeasuredValue. The value is in seconds.

5.6. Average Measured Value

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0005	AverageMeasuredValue	single	MinMeasuredValue to MaxMeasuredValue	X P	null	R V	AVG

This attribute SHALL represent the average value of MeasuredValue that has been measured during the AverageMeasuredValueWindow. If this attribute is provided, the AverageMeasuredValueWindow attribute SHALL also be provided.

5.7. Average Measured Value Window

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0006	AverageMeasuredValueWindow	elapsed-s	max 604800	P	1	R V	AVG

This attribute SHALL represent the window of time used for determining the AverageMeasuredValue. The value is in seconds.

5.8. Uncertainty

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0007	Uncertainty	single	MS		MS	R V	[MEA]

This attribute SHALL represent the range of error or deviation that can be found in MeasuredValue and PeakMeasuredValue. This is considered a +/- value and should be considered to be in MeasurementUnit.

5.9. Measurement Unit

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0008	MeasurementUnit	MeasurementUnitEnum		F	MS	R V	MEA

This attribute SHALL represent the unit of MeasuredValue. See MeasurementUnitEnum.

5.10. Measurement Medium

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0009	MeasurementMedium	MeasurementMediumEnum		F	MS	R V	M

This attribute SHALL represent the medium in which MeasuredValue is being measured. See MeasurementMediumEnum.

5.11. Level Value

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x000A	LevelValue	LevelValueEnum			0	R V	LEV

This attribute SHALL represent the level of the substance detected. See LevelValueEnum.

6. Data Type

6.1. Base Data Types

Class	Data Type	Short	ID	Size
Analog	Single precision	single	0x39	4 bytes

6.2. Derived Data Types

Class	Data Type	Short	Base Type	ID	Size
Analog	Elapsed Time in seconds	elapsed-s	uint32	0xD2	4 bytes