The Window Covering cluster (0x0102) is a Matter cluster that Controls motorized window coverings like blinds, shades, and curtains with lift and tilt positioning.. It defines 7 commands and 22 attributes and is mandatory for 2 device types.
Window Covering 0x0102
Controls motorized window coverings like blinds, shades, and curtains with lift and tilt positioning.
Spec History
This cluster's ClusterRevision across the Matter releases it has shipped in. Click a version to inspect the cluster as it existed in that release.
Attributes 22
Commands 7
Features 5
| Code | Name | Type | Flags |
|---|---|---|---|
| 0x0000 |
Type
default 0x00
|
Type | |
| 0x0001 |
PhysicalClosedLimitLift
default 0x0000
|
int16u | Optional Provisional |
| 0x0002 |
PhysicalClosedLimitTilt
default 0x0000
|
int16u | Optional Provisional |
| 0x0003 |
CurrentPositionLift
max 65534 · nullable
|
int16u | Optional Provisional |
| 0x0004 |
CurrentPositionTilt
max 65534 · nullable
|
int16u | Optional Provisional |
| 0x0005 |
NumberOfActuationsLift
default 0x0000
|
int16u | Optional |
| 0x0006 |
NumberOfActuationsTilt
default 0x0000
|
int16u | Optional |
| 0x0007 |
ConfigStatus
max 0x7F
|
ConfigStatus | |
| 0x0008 |
CurrentPositionLiftPercentage
nullable
|
percent | Optional |
| 0x0009 |
CurrentPositionTiltPercentage
max 100 · nullable
|
percent | Optional |
| 0x000A |
OperationalStatus
max 63 · default 0x00
|
OperationalStatus | |
| 0x000B |
TargetPositionLiftPercent100ths
nullable
|
percent100ths | Optional |
| 0x000C |
TargetPositionTiltPercent100ths
nullable
|
percent100ths | Optional |
| 0x000D |
EndProductType
default 0x00
|
EndProductType | |
| 0x000E |
CurrentPositionLiftPercent100ths
max 10000 · nullable
|
percent100ths | Optional |
| 0x000F |
CurrentPositionTiltPercent100ths
max 10000 · nullable
|
percent100ths | Optional |
| 0x0010 |
InstalledOpenLimitLift
max 65534 · default 0x0000
|
int16u | Optional Provisional |
| 0x0011 |
InstalledClosedLimitLift
max 65534 · default 65534
|
int16u | Optional Provisional |
| 0x0012 |
InstalledOpenLimitTilt
max 65534 · default 0x0000
|
int16u | Optional Provisional |
| 0x0013 |
InstalledClosedLimitTilt
max 65534 · default 65534
|
int16u | Optional Provisional |
| 0x0017 |
Mode
max 0x0F · default 0x00
|
Mode | Writable |
| 0x001A |
SafetyStatus
max 0x0FFF · default 0x0000
|
SafetyStatus | Optional |
| Code | Name | Direction | Parameters |
|---|---|---|---|
| 0x00 |
UpOrOpen
Upon receipt of this command, the window covering will adjust its position so the physical lift/slide and tilt is at the maximum open/up position.
|
client→server | None |
| 0x01 |
DownOrClose
Upon receipt of this command, the window covering will adjust its position so the physical lift/slide and tilt is at the maximum closed/down position.
|
client→server | None |
| 0x02 |
StopMotion
Upon receipt of this command, the window covering will stop any adjusting to the physical tilt and lift/slide that is currently occurring.
|
client→server | None |
| 0x04 |
GoToLiftValue
Optional Provisional
Go to lift value specified
|
client→server |
LiftValue: int16u |
| 0x05 |
GoToLiftPercentage
Optional This command is used to set the target lift position of the window covering to the percentage value specified in the command.
|
client→server |
LiftPercent100thsValue: percent100ths |
| 0x07 |
GoToTiltValue
Optional Provisional
Go to tilt value specified
|
client→server |
TiltValue: int16u |
| 0x08 |
GoToTiltPercentage
Optional This command is used to set the target tilt position of the window covering to the percentage value specified in the command.
|
client→server |
TiltPercent100thsValue: percent100ths |
Lift
(LF)
bit 0
Lift control and behavior for lifting/sliding window coverings
Tilt
(TL)
bit 1
Tilt control and behavior for tilting window coverings
PositionAwareLift
(PA_LF)
bit 2
Position aware lift control is supported.
AbsolutePosition
(ABS)
bit 3
Provisional
Absolute positioning is supported.
PositionAwareTilt
(PA_TL)
bit 4
Position aware tilt control is supported.
Device Types Using This Cluster
Device types in the Matter spec that reference this cluster
Devices Implementing This Cluster
29 devices in the survey implement this cluster