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
| Features | Fctrl | CmdID | ClusterID | AttributeID | Attribute type | Data | Comment |
|---|---|---|---|---|---|---|---|
| Report attributes | 0x11 or 0x31 or ... | 0x0A | 0x0406 | 0x0000 | 0x18 | 0xcc | 0xcc:bitfiled value (0x00 or 0x01) |
Configuration
| Features | Fctrl | CmdID | ClusterID | Payload | Comment |
|---|---|---|---|---|---|
| Configure reporting | 0x11 or 0x31 or ... | 0x06 | 0x0406 | 0x00 0x0000 0x18 0xmmmm 0xMMMM 0xcc | 0x0000: attributeID 0x18: attribute type 0xmmmm: minimum reporting interval 0xMMMM: maximum reporting interval 0xcc: reportable change |
| Configure reporting response | 0x11 or 0x31 or ... | 0x07 | 0x0406 | 0xss 0x00 0x0000 | 0xss:status |
| Read reporting configuration | 0x11 or 0x31 or ... | 0x08 | 0x0406 | 0x00 0x0000 | 0x0000: attributeID |
| Read reporting configuration response | 0x11 or 0x31 or ... | 0x09 | 0x0406 | 0xss 0x00 0x0000 0x18 0xmmmm 0xMMMM 0xcc | 0xss:status 0x0000:attributeID 0x18: attribute type 0xmmmm: minimum reporting interval 0xMMMM: maximum reporting interval 0xcc: reportable change |
Read/Write
| Features | Fctrl | CmdID | ClusterID | AttributeID | Status | Attribute type | Data | Comment |
|---|---|---|---|---|---|---|---|---|
| Read attribute request | 0x11 or 0x31 or ... | 0x00 | 0x0406 | 0x0000 | Ask the binary input value of the sensor | |||
| Read attribute response | 0x11 or 0x31 or ... | 0x01 | 0x0406 | 0x0000 | 0x00 | 0x18 | 0x0b | 0x0b: 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 | CmdID | ClusterID | Payload | Comment |
|---|---|---|---|---|---|
| Configure reporting | 0x11 or 0x31 or ... | 0x06 | 0x0406 | 0x11 0x0000 0x00 0xmmmm 0xMMMM 0xdd 0xrr 0xtt | 0x11: 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 response | 0x11 or 0x31 or ... | 0x07 | 0x0406 | 0xss 0x01 0x0000 | 0xss : status 0x01 : batch |
| Read reporting configuration | 0x11 or 0x31 or ... | 0x08 | 0x0406 | 0x01 0x0000 | 0x01: Batch |
| Read reporting configuration response | 0x11 or 0x31 or ... | 0x09 | 0x0406 | 0xss 0x11 0x0000 0x00 0xmmmm 0xMMMM 0xdd 0xrr 0xtt | 0xss : 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
| Feature | Fctrl | CmdID | ClusterID | AttributeID | Status | Attribute type | Data | Comment |
|---|---|---|---|---|---|---|---|---|
| Read attribute request | 0x11 or 0x31 or ... | 0x00 | 0x0406 | 0x0010 | Ask the current Occupied to Unoccupied delay | |||
| Read attribute response | 0x11 or 0x31 or ... | 0x01 | 0x0406 | 0x0010 | 0x00 | 0x21 | 0xnnnn | 0xnnnn: Occupied to Unoccupied delay (seconds) |
| Write attribute no response | 0x11 or 0x31 or ... | 0x05 | 0x0406 | 0x0010 | 0x21 | 0xnnnn |
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
| Feature | Fctrl | CmdID | ClusterID | AttributeID | Status | Attribute type | Data | Comment |
|---|---|---|---|---|---|---|---|---|
| Read attribute request | 0x11 or 0x31 or ... | 0x00 | 0x0406 | 0x0001 | Ask the Occupancy sensor Type of the remote sensor | |||
| Read attribute response | 0x11 or 0x31 or ... | 0x01 | 0x0406 | 0x0001 | 0x00 | 0x30 | 0xaa | 0xaa: 0x00: Passive infrared 0x01: UltraSonic 0x02: Passive Infrared and Ultrasonic |
