Skip to content

[Feature Request] Support tilt control for covers #138

@weiss

Description

@weiss

Is your feature request related to a problem? Please describe.

I'm using Home Assistant cover entities that support both Lift (Open/Close) and Tilt (Slat position/Lamellen). These are Venetian blinds controlled by a TaHoma Switch (via Overkiz integration).

Currently, matterbridge-hass exposes these entities to Matter, but it only maps the Lift functionality. The Tilt functionality is ignored, so I cannot control the angle of the slats.

Describe the solution you'd like.

I'd like matterbridge-hass to map the Home Assistant Tilt attributes/services to the corresponding Matter WindowCovering Cluster features.

  1. Detection:

    • The plugin should check if the HA entity supports cover.set_cover_tilt_position (presence of current_tilt_position attribute or supported features bitmask).
  2. Matter Cluster Configuration (WindowCovering 0x0202):

    • Enable the Tilt Feature Bit (Bit 4) in the WindowCovering cluster configuration for these endpoints.
  3. Attribute Mapping:

    • HA Attribute: current_tilt_position (Integer 0-100).
    • Matter Attribute: Should map to CurrentTiltPercentage (and TargetTiltPercentage).
    • I think Matter may use 100ths of a percent (0-10000), so a scaling by 100 might be required?
  4. Command Mapping:

    • Matter Command: GoToTiltPercentage.
    • Action: Should trigger the Home Assistant service cover.set_cover_tilt_position.
    • Payload: Convert the Matter value back to HA's 0-100 range.

I've verified with another Matter bridge implementation that Google Home does display a secondary slider/button for Tilt if the device correctly advertises the Tilt capability in the WindowCovering cluster.

My HA Entity Attributes (TaHoma/Overkiz):

current_position: 100
current_tilt_position: 100
device_class: blind
friendly_name: Jalousie
supported_features: 255  (Full support: Open/Close/Stop/Set Position + Tilt Open/Close/Stop/Set Position)

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions