Skip to content

feat: venetian — tilt-only override mode for Custom Position slots #514

@torstendunkel

Description

@torstendunkel

Checklist

  • I have searched existing enhancements and this is not a duplicate.
  • This request covers a single enhancement (open a separate issue for each one).
  • I have filled out the template below.

Adaptive Cover Pro version

No response

Is your enhancement related to a problem?

On a venetian blind, diffuse/overcast conditions are ideal for opening the slats
fully (maximum daylight, no glare) while still keeping the carriage at the
sun-tracking position. Today there is no way to express "open the slats when
cloudy, let solar tracking decide how far down the blind hangs."

Describe the solution you'd like

Add a tilt-only override mode to Custom Position slots for venetian blinds,
so a slot can fix the slat angle when its sensor is active while leaving the
vertical position entirely under solar tracking control.

Add a new per-slot option in the Custom Position configuration:

Option Default Description
custom_position_tilt_only_override_N off When enabled, the slot controls the tilt axis only. The position axis is not claimed — solar (or whatever handler wins the position pipeline) continues to resolve the carriage position normally.
custom_position_tilt_only_value_N 100 Tilt value (%) to send when the override is active.

When a slot is active and custom_position_tilt_only_override_N is enabled:

  • The configured custom_position_N value is ignored — the slot does not
    participate in position pipeline resolution at all.
  • Only the tilt axis is affected: custom_position_tilt_only_value_N is sent
    instead of the venetian engine's calculated tilt.

Example:

  • Sensor: binary_sensor.overcast_no_direct_sun
  • When overcast → slats fully open (tilt 100%), position determined by solar tracking as usual
  • When sunny again → solar tracking resumes control of both axes

Alternatives you've considered

  • Cloud suppression — moves the cover to a fixed cloudy position when overcast
    conditions are detected, but controls the position axis only; there is no
    companion tilt setting, so the slat angle remains engine-derived and cannot
    be fixed to a desired value.
  • External HA automation calling cover.set_cover_tilt_position directly but
    this trips manual override and suspends ACP automation.

A simpler alternative would be a dedicated tilt setting on the existing cloud
suppression handler. However, a tilt-only override mode on Custom Position slots
is more general: it works with any binary sensor, any priority, and any condition.

Additional context

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestreleasedFix has shipped in a stable production releasewaiting-for-confirmationShipped in a release — awaiting reporter verification

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions