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
28 devices in the survey implement this cluster
Aqara Hub
Aqara
YS1606-UC
Homebridge
SmartWings Window Covering
SmartWings
Eve MotionBlinds
Eve Systems
Aqara Shutter Switch H2
Aqara
SmartWings Levitate with DUCTECH
DUCTECH
Zemismart Thread Curtain Motor
Zemismart Technology Limited
Smart Window Shade Tubular Motor
JLM
Zemismart Roller Shade Driver
Zemismart Technology Limited
SmartWings Window Covering
SmartWings
Zemismart Smart Curtain
Zemismart Technology Limited
Dendo SCM Matter Window Covering
Dendo Systems
Push Button Module
Insta GmbH
Smart Roller Shutter Switch
Meross
Zemismart MT25B Roller Motor
Zemismart Technology Limited
Eve MotionBlinds
Eve Systems
WiFi Smart Switch
SONOFF
Dual Window Covering
HooRii Technology
Zemismart Smart Curtain
Zemismart Technology Limited
Eve Shutter Switch
Eve Systems
Eve MotionBlinds
Eve Systems
Touchscreen Switch S100
Aqara
Eve MotionBlinds
Eve Systems
Smart universal beltwinder
Delta Dore Rademacher