Concentration Measurements Cluster

 

This cluster delivers the concentration of the remote sensor, and the minimum and the maximum values that it is capable to measure, and the minimumum and maximum measured since last power on or reset.

This cluster can be used to manage different kind of concentration measurements. As an exemple,
for a CO2 sensor the unit may be 'ppm',
while for a VOC sensor the measurement is is only an Indoor Air Quality indicator usually  in range of 0(Best) to 500(Worst).

If a field of the payload starts with 0x, this means that it’s an hexadecimal representation, and if it starts with 0b, it is a binary representation.

Any multi-byte numerical value is serialized in “Big Endian” order.

Measured Value


The Measured value information attribute set contains  the attribute representing the current concentration value measured by the device.

Notice that the Measured Value Attribute (0x0000) is the source of calculated attributes that keep currents Mean (0x0100), Minimal(0x0101) and Maximal(0x0102) values since startup or reset of the sensor. All these calculated attributes can be accessed the same way than the source one.

Standard report

Report

FeaturesFctrl CmdIDClusterIDAttributeIDAttribute typeDataComment
Report attributes0x11 or 0x31 or
...
0x0a0x800C0x00000x210xhhhh0xhhhh: Measured Value
Concentration unit may be "ppm", "IAQ",...

Configuration

FeaturesFctrl CmdIDClusterIDPayloadComment
Configure reporting0x11 or 0x31 or
...
0x060x800C0x00 0x0000 0x21
0xmmmm 0xMMMM
0xcccc
0x00: Reserved
0x0000: AttributeID
0x21: Attribute type
0xmmmm: minimum reporting interval
0xMMMM: maximum reporting interval
0xcccc: reportable change
Configure reporting response0x11 or 0x31 or
...
0x070x800C0xss 0x00 0x00000xss: status
0x00: Reserved
0x0000: AttributeID
Read reporting configuration0x11 or 0x31 or
...
0x080x800C0x00 0x00000x00: Reserved
0x0000: attributeID
Read reporting configuration response0x11 or 0x31 or
...
0x090x800C0xss 0x00 0x0000 0x21
0xmmmm 0xMMMM
0xcccc
0xss: status
0x00: Reserved
0x0000: AttributeID
0x21: Attribute type
0xmmmm: minimum reporting interval
0xMMMM: maximum reporting interval
0xcccc: reportable change

Read/Write

FeaturesFctrl CmdIDClusterIDAttributeIDStatusAttribute typeDataComment
Read attribute request0x11 or 0x31 or
...
0x000x800C0x0000Ask the current concentration indication
Read attribute response0x11 or 0x31 or
...
0x010x800C0x00000x00 0x210xhhhh0xhhhh: Measured Value
Concentration unit may be "ppm", "IAQ",...

Batch report

The Measured value sample type is "unsigned int U16", the corresponding number to use in br_uncompress type is 6.

Configuration

FeaturesFctrl CmdIDClusterIDPayloadComment
Configure reporting0x11 or 0x31 or
...
0x060x800C0x15 0x0000 0x00 0xmmmm 0xMMMM 0xdddd 0xrrrr 0xtt0x15: 0bsssssss is the size of configuration string after attributeID (obsssssss1 right shifted). The size here is 0x0A.
0x0000: AttributeID
0x00: the index of required field( the MeasuredValue attribute has got only one field 0)
0xmmmm: minimum reporting interval
0xMMMM: maximum reporting interval
0xdddd: required delta value (the size depends on the attribute data type)
0xrrrr: required resolution (the size depends on the attribute data type)
0xtt: the tag value
Configure reporting response0x11 or 0x31 or
...
0x070x800C0xss 0x01 0x00000xss: status
0x01: batch
0x0000: AttributeID
Read reporting configuration0x11 or 0x31 or
...
0x080x800C0x01 0x00000x01: batch
0x0000: AttributeID
Read reporting configuration response0x11 or 0x31 or
...
0x090x800C0xss 0x15 0x0000 0x00 0xmmmm 0xMMMM 0xdddd 0xrrrr 0xtt0xss: status
0x15: 0bsssssss is the size of configuration string after attributeID (obsssssss1 right shifted). The size here is 0x0A.
0x0000: AttributeID
0x00: the index of required field( the MeasuredValue attribute has got only one field 0)
0xmmmm: minimum reporting interval
0xMMMM: maximum reporting interval
0xdddd: required delta value (the size depends on the attribute data type)
0xrrrr: required resolution (the size depends on the attribute data type)
0xtt: the tag value

Min Measurable Value


The Min Measurable Value information attribute set contains the minimum value that the remote sensor is capable to measure.

Read/Write

FeaturesFctrl CmdIDClusterIDAttributeIDStatusAttribute typeDataComment
Read attribute request0x11 or 0x31 or
...
0x000x800C0x0001Ask the minimum value that the sensor is capable to measure
Read attribute response0x11 or 0x31 or
...
0x010x800C0x00010x00 0x210xhhhh0xhhhh: Min Measurable Value
(ppm or IAQ)

Max Measurable Value


The Max Measurable Value information attribute set contains the maximum value that the remote sensor is capable to measure.

Read/Write

FeaturesFctrl CmdIDClusterIDAttributeIDStatusAttribute typeDataComment
Read attribute request0x11 or 0x31 or
...
0x000x800C0x0002Ask the maximum value that the sensor is capable to measure
Read attribute response0x11 or 0x31 or
...
0x010x800C0x00020x00 0x210xhhhh0xhhhh: Max Measurable Value
(ppm or IAQ)

Unit


The unit(s) managed by the corresponding sensor.

Read

FeaturesFctrl CmdIDClusterIDAttributeIDStatusAttribute typeDataComment
Read attribute request0x11 or 0x31 or
...
0x000x800C0x8004Ask the maximum value that the sensor is capable to measure
Read attribute response0x11 or 0x31 or
...
0x010x800C0x80040x00 0x200xuu0xuu: Possible concentration units:
0xFF: Unit is undefined
0x01: Parts per 10
0x02: Parts per 100
0x03: Parts per 1000
0x06: Parts per Million
0x09: Parts per Billion
0x0C: Parts par Trillion
0x0F: Parts par Quintillion
0x80: 0 to 500 Indicator (IAQ)

Min/Normal level


This level may be used for Automatic Baseline Calibration of sensor.
Currently only used for CO2 sensor.

Read/Write

FeaturesFctrl CmdIDClusterIDAttributeIDStatusAttribute typeDataComment
Read attribute request0x11 or 0x31 or
...
0x000x800C0x8008Ask the minimal/normal concentration level defined for this sensor
Read attribute response0x11 or 0x31 or
...
0x010x800C0x80080x00 0x210xhhhh0xhhhh: Minimal/Normal concentration level (ppm or IAQ)
Mainly used for CO2.
Typical outdoor value is between 400 and 420 ppm.
Write no response0x11 or 0x31 or
...
0x050x800C0x80080x00 0x210xhhhh

Calibration period


Used for CO2 sensor Automatic Baseline Calibration.

Read/Write

FeaturesFctrl CmdIDClusterIDAttributeIDStatusAttribute typeDataComment
Read attribute request0x11 or 0x31 or
...
0x000x800C0x8009Ask the minimal/normal concentration level defined for this sensor
Read attribute response0x11 or 0x31 or
...
0x010x800C0x80090x00 0x200xpp0xhhhh: Calibration period (Day)
Mainly used for CO2 ABC calibration:
0x00 : No Autocalibration
0x01 : 1 day
...
0xFF : 255 days
Write no response0x11 or 0x31 or
...
0x050x800C0x80090x00 0x200xpp

 

Cluster commands


FeaturesFctrl CmdIDClusterIDPayloadComment
Command: Reset statistics0x11 0x500x800C0x00Reset/restart MEAN|MIN|MAX calculations
Command: Calibrate with actual value
(Only for CO2 sensor)
0x11 0x500x800C0x01 0xpppp0xpppp: Actual measured CO2 concentration (ppm)
Command: Calibrate with actual and reported value
(Only for CO2 sensor)
0x110x500x800C0x02 0xpppp 0xqqqq0xpppp: Actual measured value
0xpppp: Corresponding reported value
Command: Calibrate with fresh air
(Only for CO2 sensor)
0x110x500x800C0x03Sensor will consider that measurement is done in "fresh air condition"
Print Friendly