Occupancy Cluster

 

This cluster manages a state entry, it delivers the current state of occupancy of a room.

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.

Occupancy value


The Occupancy value information attribute set contains only the attribute representing the current state of presence detection.

Standard report

Report

FeaturesFctrl CmdIDClusterIDAttributeIDAttribute typeDataComment
Report attributes0x11 or 0x31 or
...
0x0A0x04060x00000x180xcc0xcc:bitfiled value (0x00 or 0x01)

Configuration

FeaturesFctrl CmdIDClusterIDPayloadComment
Configure reporting0x11 or 0x31 or
...
0x060x04060x00 0x0000 0x18 0xmmmm 0xMMMM 0xcc0x0000: attributeID
0x18: attribute type
0xmmmm: minimum reporting interval
0xMMMM: maximum reporting interval
0xcc: reportable change
Configure reporting response0x11 or 0x31 or
...
0x070x04060xss 0x00 0x00000xss:status
Read reporting configuration0x11 or 0x31 or
...
0x080x04060x00 0x00000x0000: attributeID
Read reporting configuration response0x11 or 0x31 or
...
0x090x04060xss 0x00 0x0000 0x18 0xmmmm 0xMMMM 0xcc0xss:status
0x0000:attributeID
0x18: attribute type
0xmmmm: minimum reporting interval
0xMMMM: maximum reporting interval
0xcc: reportable change

Read/Write

FeaturesFctrl CmdIDClusterIDAttributeIDStatusAttribute typeDataComment
Read attribute request0x11 or 0x31 or
...
0x000x04060x0000Ask the binary input value of the sensor
Read attribute response0x11 or 0x31 or
...
0x010x04060x00000x000x180x0b0x0b: binary value (0x00 or 0x01)

Batch report

For Batch reports, the Present value sample type is "Boolean", the corresponding number to use in br_uncompress type is 1.

Configuration

Feature Fctrl CmdIDClusterIDPayloadComment
Configure reporting0x11 or 0x31 or
...
0x060x04060x11 0x0000 0x00 0xmmmm 0xMMMM 0xdd 0xrr 0xtt0x11: Batch(size+flag); 0bsssssss is the size of configuration string after attributeID (obsssssss1 right shifted). The size here is 0x08.
0x0000: AttributeID
0x00: the index of required field( the presentvalue has got only one field 0)
0xmmmm: minimum recorting interval
0xMMMM: maximum recorting interval
0xdd: the required delta value (the size depends on the attribute data type)
0xrr: the required resolution value (the size depends on the attribute data type)
0xtt:the tag value
Configure reporting response0x11 or 0x31 or
...
0x070x04060xss 0x01 0x00000xss : status
0x01 : batch
Read reporting configuration0x11 or 0x31 or
...
0x080x04060x01 0x00000x01: Batch
Read reporting configuration response0x11 or 0x31 or
...
0x090x04060xss 0x11 0x0000 0x00 0xmmmm 0xMMMM 0xdd 0xrr 0xtt0xss : status
0x11: Batch(size+flag); 0bsssssss is the size of configuration string after attributeID (obsssssss1 right shifted). The size here is 0x08.
0x00: the index of required field( the presentvalue has got only one field 0)
0xmmmm: minimum reporting interval
0xMMMM: maximum reporting interval
0xdd: the required delta value (the size depends on the attribute data type)
0xrr: the required resolution value (the size depends on the attribute data type)
0xtt: the tag value

Occupied to Unoccupied delay


This delay (seconds) is used to specify after how long time without move the sensor will decide that the room is unocupied.

Read/Write

FeatureFctrl CmdIDClusterIDAttributeIDStatusAttribute typeDataComment
Read attribute request0x11 or 0x31 or
...
0x000x04060x0010Ask the current Occupied to Unoccupied delay
Read attribute response0x11 or 0x31 or
...
0x010x04060x00100x000x210xnnnn0xnnnn: Occupied to Unoccupied delay (seconds)
Write attribute no response0x11 or 0x31 or
...
0x050x04060x00100x210xnnnn

 

Occupancy Type


The occupancy type attribute informs about the current kind of application of the cluster. This should be set according to the sensor type or sensor usage.

Read

FeatureFctrl CmdIDClusterIDAttributeIDStatusAttribute typeDataComment
Read attribute request0x11 or 0x31 or
...
0x000x04060x0001Ask the Occupancy sensor Type of the remote sensor
Read attribute response0x11 or 0x31 or
...
0x010x04060x00010x000x300xaa0xaa:
0x00: Passive infrared
0x01: UltraSonic
0x02: Passive Infrared and Ultrasonic
Print Friendly