WindowCovering Cluster

Cluster ID: 0x0102  |  Endpoint: Typically on Endpoint 1 (application endpoint)

WindowCovering is the core Cluster in Matter for controlling window covering devices. It applies to motorized roller shades, venetian blinds, curtain tracks, awnings, projector screens, and all devices requiring lift or tilt control. It defines motion control commands, position feedback attributes, and a complete description of device types and safety states.

Commands

The WindowCovering Cluster has 7 commands. The basic trio (UpOrOpen / DownOrClose / StopMotion) is supported by all window covering devices. The four precise positioning commands require the device to have the corresponding Feature combinations enabled. Click a command ID in the table below to jump to its detailed description.

UpOrOpen — Raise / Open (0x00)

Moves the covering toward the fully open position. For roller shades this means retracting upward; for curtain tracks, pulling apart to both sides. Requires no parameters. The device begins moving immediately upon receipt, until it reaches the fully open position or a StopMotion command is received.

↑ Back to Commands

DownOrClose — Lower / Close (0x01)

Moves the covering toward the fully closed position. For roller shades this means extending downward; for curtain tracks, drawing together to the center. Requires no parameters. The device moves to the fully closed position immediately upon receipt.

↑ Back to Commands

StopMotion — Stop Motion (0x02)

Immediately stops all axis motion (both lift and tilt). Requires no parameters. After stopping, all motion bits in OperationalStatus are cleared to zero.

↑ Back to Commands

GoToLiftValue — Lift to Absolute Value (0x04)

Moves the covering lift to a specified absolute position value. This value corresponds to the device's internal physical units (such as motor steps), with the range determined by InstalledOpenLimitLift and InstalledClosedLimitLift.

↑ Back to Commands

GoToLiftPercentage — Lift to Percentage (0x05)

Moves the covering lift to a specified percentage position. This is the most commonly used precise control command. The parameter uses percent100ths (hundredths of a percent, range 0–10000): 0 = fully open, 10000 = fully closed.

↑ Back to Commands

GoToTiltValue — Tilt to Absolute Value (0x07)

Tilts the blind slats to a specified absolute position value. Only supported by blind-type devices with tilt capability.

↑ Back to Commands

GoToTiltPercentage — Tilt to Percentage (0x08)

Tilts the blind slats to a specified percentage position. The logic is consistent with lift percentage: 0 = slats fully open (parallel to the window), 10000 = slats fully closed (perpendicular to the window).

↑ Back to Commands

Attributes

WindowCovering Cluster attributes are organized into four functional groups. Click an attribute ID in the summary table below to jump to its detailed description.

Type & Configuration (0x0000, 0x000D, 0x0007, 0x0017)

Describes the physical type, product classification, and current configuration and operating mode of the window covering device.

Type Enum Values

EndProductType Enum Values

ConfigStatus Bitmap

Mode Bitmap

↑ Back to Attributes

Lift Position (0x0001–0x0011)

Describes the current position, target position, and travel limits of the covering's lift axis. All lift attributes require the device to support the LF (Lift) feature.

↑ Back to Attributes

Tilt Position (0x0002–0x0013)

Describes the current position, target position, and travel limits of the covering's tilt axis (blind slat angle). All tilt attributes require the device to support the TL (Tilt) feature.

↑ Back to Attributes

Operational Status(0x000A, 0x001A)

Describes the current motion direction and safety status of the covering.

OperationalStatus Bitmap

SafetyStatus Bitmap

↑ Back to Attributes

Feature Bitmap

The WindowCovering Cluster declares supported capabilities via FeatureMap (0xFFFC). The combination of features determines which commands and attributes are available:

Example Data

Read result from a WindowCovering Cluster of a motorized roller shade with lift + position awareness at the 30% position (near fully open):

{
  // --- Type & Configuration ---
  "0x0000": 0,              // Type = Rollershade (roller shade)
  "0x000D": 0,              // EndProductType = RollerShade
  "0x0007": 0x09,           // ConfigStatus = Operational + LiftPositionAware
  "0x0017": 0x00,           // Mode = normal operation (all bits 0)

  // --- Lift Position ---
  "0x000E": 3000,           // CurrentPositionLiftPercent100ths = 30.00%
  "0x0008": 30,             // CurrentPositionLiftPercentage = 30%
  "0x000B": 3000,           // TargetPositionLiftPercent100ths = 30.00% (target matches current, stopped)
  "0x0010": 0,              // InstalledOpenLimitLift = 0 (fully open position)
  "0x0011": 10000,          // InstalledClosedLimitLift = 10000 (fully closed position)

  // --- Operational Status ---
  "0x000A": 0x00,           // OperationalStatus = all axes stopped
  "0x001A": 0x0000          // SafetyStatus = no anomalies
}

Common Scenarios