CCA Online Tools

🪟 Tilt Positions (Venetian Blinds)

📖 CCA Handbook › Blueprint section: Cover Tilt Position Settings

On this page:


🔄 Tilt Wait Mode

🧩 Input: cover_tilt_wait_mode · Default: fixed_delay

Choose how CCA waits before sending tilt commands: Fixed Delay (Standard): Uses the configured tilt delay value. Works well for most devices. Wait Until Idle (Z-Wave): Waits until cover reports ‘open’ or ‘closed’ state before sending tilt. Prevents tilt commands from being ignored on devices that block tilt during motor movement (e.g., Shelly Qubino Wave Shutter). If your tilt positions are unreliable, try switching to ‘Wait Until Idle’ mode.


🔄 Tilt Wait Timeout

🧩 Input: cover_tilt_wait_timeout · Default: 30

Maximum time to wait for cover to become idle before sending tilt command. Only used when ‘Wait Until Idle’ mode is selected.


🕛 Default Tilt Delay

🧩 Input: tilt_delay · Default: 0

Delay between set_cover_position and set_cover_tilt_position. Only necessary when using the tilt functions. This separates the two commands in terms of time.

Optional


📐 Tilt Position Feature

🧩 Input: cover_tilt_config · Default: cover_tilt_disabled

⚠️ Note: Tilt control is only available for blinds/shutters, not for awnings.

If the cover and the integration support it, the tilt position of the cover can be set. The standard attribute ‘current_tilt_position’ is used for this.


📐 Tilt Reposition Feature

🧩 Input: cover_tilt_reposition_config · Default: cover_tilt_reposition_disabled

If Tilt Reposition Feature is enabled you can choose if the blinds are closed before tilting to a new position. In some cases tilting the blinds in small steps can lead to false positions. This is because of the minimum time the motor needs to run. If the runtime between current tilt position and target tilt position is to small the motor will not stop at the right position. Thus the blinds will be preclosed to 0 and then run to the target position.


🔼 Open Tilt Position

🧩 Input: open_tilt_position · Default: 50

To which tilt position should the cover be moved when opening?


🔻 Close Tilt Position

🧩 Input: close_tilt_position · Default: 50

To which tilt position should the cover be moved when closing?


💨 Ventilate Tilt Position

🧩 Input: ventilate_tilt_position · Default: 50

To which tilt position should the cover be moved for ventilation?


〰️ Tilt Position Tolerance

🧩 Input: tilt_position_tolerance · Default: 0

Tolerance to be applied when comparing the current tilt position with the to be tilt position. These are absolute values, analogous to the position tolerance. Use this when several states share the same cover position and can only be told apart by their tilt angle (e.g. closed/shading/ventilate all at position 0), or to absorb small tilt motor inaccuracies.


🥵 Sun Shading Tilt Position

🧩 Input: shading_tilt_position_0 · Default: 0

Minimum tilt position for shading. The cover will be tilted to this position if the sun elevation is below the value of elevation 1.


🥵 Sun Shading Tilt Position 1

🧩 Input: shading_tilt_position_1 · Default: 20

To which tilt position should the cover be moved for shading when the sun is above elevation 1?


🥵 Sun Shading Tilt Elevation 1

🧩 Input: shading_tilt_elevation_1 · Default: 20

Sun elevation for tilt position 1.


🥵 Sun Shading Tilt Position 2

🧩 Input: shading_tilt_position_2 · Default: 37

To which tilt position should the cover be moved for shading when the sun is above elevation 2?


🥵 Sun Shading Tilt Elevation 2

🧩 Input: shading_tilt_elevation_2 · Default: 30

Sun elevation for tilt position 2.


🥵 Sun Shading Tilt Position 3

🧩 Input: shading_tilt_position_3 · Default: 50

To which tilt position should the cover be moved for shading when the sun is above elevation 3?


🥵 Sun Shading Tilt Elevation 3

🧩 Input: shading_tilt_elevation_3 · Default: 48

Sun elevation for tilt position 3.


⬅️ Handbook index · Previous: 🌤️ Sun Shading · Next: 🛏️ Resident Mode