Matter Specification - Occupancy Sensing Cluster

Matter :: Occupancy Sensing Cluster

The server cluster provides an interface to occupancy sensing functionality, including configuration and provision of notifications of occupancy status.
점유 센서 (혹은 재실 감지 센서, 모션 센서) 디바이스를 위한 클러스

1. Classification

Hierarchy	Role	Scope	PICS Code
Base	Application	Endpoint	OCC

2. Identifier

Identifier	Name
0x0406	Occupancy Sensing

3. Data Types

3.1. OccupancyBitamp

Bit	Name	Summary	Conformance
0	Occupied	Indicates the sensed occupancy state	M
If this bit is set, it SHALL indicate the occupied state else if the bit if not set, it SHALL indicate the unoccupied state.

 

3.2. OccupancySensorTypeBitmap

Bit	Name	Summary	Conformance
0	PIR	Indicates a passive infrared sensor	M
1	Ultrasonic	Indicates a ultrasonic sensor	M
2	PhysicalContact	Indicates a physical contact sensor	M

This data type is derived from map8.

 

3.3. OccupancySensorTypeEnum

Value	Name	Summary	Conformance
0	PIR	Indicates a passive infrared sensor	M
1	Ultrasonic	Indicates a ultrasonic sensor	M
2	PIRAndUltrisonic	Indicates a passive infrared and ultrasonic sensor	M
3	PhysicalContact	Indicates a physical contact sensor	M

This data type is derived from enum8.

4. Attributes

4.1. Occupancy

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0000	Occupancy	OccupancyBitmap	0 to 1	P		R V	M

This attribute indicates the sensed (processed) status of occupancy.

4.2. Occupancy Sensor Type

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0001	OccupancySensorType	OccupancySensorTypeEnum	desc		MS	R V	M

This attribute specifies the type of the occupancy sensor.

4.3. Occupancy Sensor Type Bitmap

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0002	OccupancySensorTypeBitmap	OccupancySensorTypeBitmap	0 to 7			R V	M

This attribute specifies the types of the occupancy sensor. Each bit position, if set, indicates the corresponding sensing capability is implemented.
The value of the OccupancySensorType SHALL be aligned to the value of the OccupancySensorTypeBitmap attribute as defined below.

OccupancySensorTypeBitmap	OccupancySensorType
PIR	PIR
Ultrasonic	Ultrasonic
PIR + Ultrasonic	PIRAndUltrasonic
PyhsicalContact	PyhsicalContact
PyhsicalContact + PIR	PIR
PyhsicalContact + Ultrasonic	Ultrasonic
PhsicalContact + PIR + Ultrasonic	PIRAndUltrasonic

4.4. PIR Occupied to Unoccupied Delay

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0010	PIROccupiedToUnoccupiedDelay	uint16	all		0	RW VM	O

This attribute specifies the time delay, in seconds, before the PIR sensor changes to its unoccupied
state after the last detection of movement in the sensed area.

4.5. PIR Unoccupied to Occupied Delay

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0011	PIRUnoccupiedToOccupiedDelay	uint16	all		0	RW VM	PIRUnoccupiedToOccupiedThresh old, O

This attribute specifies the time delay, in seconds, before the PIR sensor changes to its occupied
state after the detection of movement in the sensed area. This attribute is mandatory if the
PIRUnoccupiedToOccupiedThreshold attribute is implemented.

4.6. PIR Unoccupied to Occupied Threshold

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0012	PIRUnoccupiedToOccupiedThreshold	uint8	1 to 254		1	RW VM	PIRUnoccupiedToOccupiedDelay, O

This attribute specifies the number of movement detection events that must occur in the period
PIRUnoccupiedToOccupiedDelay, before the PIR sensor changes to its occupied state. This attribute
is mandatory if the PIRUnoccupiedToOccupiedDelay attribute is implemented.

4.7. Ultrasonic Occupied to Unoccupied Delay

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0020	UltranosicOccupiedToUnoccupiedDelay	uint16	all		0	RW VM	O

This attribute specifies the time delay, in seconds, before the Ultrasonic sensor changes to its unoccupied state after the last detection of movement in the sensed area.

4.8. Ultrasonic Unoccupied to Occupied Delay

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0021	UltrasonicUnoccupiedToOccupiedDelay	uint16	all		0	RW VM	UltrasonicUnoccupiedToOccupiedThresh old, O

This attribute specifies the time delay, in seconds, before the Ultrasonic sensor changes to its occupied
state after the detection of movement in the sensed area. This attribute is mandatory if the
UltrasonicUnoccupiedToOccupiedThreshold attribute is implemented.

4.9. Ultrasonic Unoccupied to Occupied Threshold

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0022	UltrasonicUnoccupiedToOccupiedThreshold	uint8	1 to 254		1	RW VM	UltrasonicUnoccupiedToOccupiedDelay, O

This attribute specifies the number of movement detection events that must occur in the period
UltrasonicUnoccupiedToOccupiedDelay, before the Ultrasonic sensor changes to its occupied state.
This attribute is mandatory if the UltrasonicUnoccupiedToOccupiedDelay attribute is implemented.

4.10. Physical Contact Occupied to Unoccupied Delay

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0030	PhysicalContactOccupiedToUnoccupiedDelay	uint16	all	X	0	RW VM	O

This attribute specifies the time delay, in seconds, before the physical contact occupancy sensor
changes to its unoccupied state after detecting the unoccupied event. The null value indicates that
the sensor does not report occupied to unoccupied transition.

4.11. Physical Contact Unoccupied to Occupied Delay

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0031	PhysicalContactUnoccupiedToOccupiedDelay	uint16	all	X	0	RW VM	O

This attribute specifies the time delay, in seconds, before the physical contact sensor changes to its
occupied state after the detection of the occupied event.

The null value indicates that the sensor does not report unoccupied to occupied transition.

4.12. Physical Contact Unoccupied to Occupied Threshold

ID	Name	Type	Constraint	Quality	Default	Access	Conformance
0x0032	PhysicalContactUnoccupiedToOccupiedThreshold	uint8	1 to 254		1	RW VM	PhysicalContactUnoccupiedToOccupiedDelay, O

This attribute specifies the number of movement detection events that must occur in the period
PhysicalContactUnoccupiedToOccupiedDelay, before the PIR sensor changes to its occupied state.
This attribute is mandatory if the PhysicalContactUnoccupiedToOccupiedDelay attribute is implemented.