Features

Features

Core sun tracking

• Individual service devices for vertical, horizontal, and tilted covers
• Two calculation modes — Basic and Climate — both wrapped by a shared override pipeline
• Binary sensor tracking when the sun is in front of the window
• start and end time sensors
• Smart device naming — suggests a device name based on the selected cover entity

Cover support

• Position-capable and open/close-only covers, detected automatically at runtime
  • Configurable threshold for open/close decision (default 50%)
• Tilt-only covers (Z-Wave, some KNX) — entities that expose only SET_TILT_POSITION are routed through set_cover_tilt_position automatically, regardless of the configured cover type (v2.18.0)
• Inverse state support for covers that report position with reversed semantics

Safety & overrides

• Force Override — binary sensors (rain, wind, window-open, fire-alarm, etc.) move covers to a configured safe position at top priority (100)
  • Default position 0% (fully retracted) or customizable (e.g. 100% for security sensors)
  • Minimum position mode — treat the override position as a floor rather than a fixed target
  • Manual control still works during force override
• Weather safety (priority 90) — wind speed, rain rate, or severe-weather binary sensors trigger retraction with a configurable recovery timeout
• Manual override (priority 80) — automatic detection of physical/app/voice cover moves pauses automatic control; persists across HA reboots and integration reloads (v2.17.3)
• Motion-based automatic control (priority 75) — OR logic across any number of occupancy sensors; when none have detected motion for the configured timeout (30–3600 s, default 300 s), covers return to default. Leave the sensor list empty to disable.

Climate & light

• Climate mode — temperature-aware winter / summer / intermediate strategy with optional presence, weather, lux, and irradiance inputs; a dedicated switch toggles it on/off and a Climate Status sensor reports the current strategy
• Glare zones (vertical blinds only, priority 45) — protect named floor areas from direct sunlight; each zone has distance, width, and priority; now fires correctly when climate mode is active with presence (v2.18.0, #231)
• Cloud suppression (priority 60) — lux, irradiance, cloud coverage, or a weather entity's state can suppress solar tracking and return the cover to default; sensor changes trigger immediate re-evaluation (v2.17.5) rather than waiting for the next 5-minute refresh
• Blind spot — angular range within the field of view where a tree, pillar, or neighbouring building blocks direct sun

Adaptive control

• Master Integration Enabled kill switch + per-instance Automatic Control toggle
• Optional return to default position when automatic control is disabled
• Start / end time window (fixed clock times or driven by sensors / input_datetime)
• Minimum position change and minimum interval between moves
• Custom positions — up to 4 sensor-triggered positions, each with its own priority (1–99, default 77)
• Automatic Position Verification — every minute, confirms covers reached the commanded position; up to 3 retries before backing off; respects manual override, Automatic Control, Integration Enabled, and the time window (see Position Verification)

Runtime configuration (v2.18.0)

• 15 runtime configuration services — adaptive_cover_pro.set_position_limits, set_sunset_sunrise, set_automation_timing, set_manual_override, set_force_override, set_custom_position, set_motion, set_light_cloud, set_climate, set_weather_safety, set_sun_tracking, set_blind_spot, set_interpolation, set_geometry, and the set_option escape hatch
• Change any setting from automations, scripts, or templates without opening the Options UI; all changes persist across restarts and trigger a full integration reload
• See Runtime Configuration Services for the full reference

Diagnostics & troubleshooting

• Always-on diagnostic sensors (diagnostic entity category, no setup required) — 10 always-created plus up to 3 conditional:
  • Sun Position — azimuth, elevation, gamma, FOV bounds, in_fov
  • Control Status — why covers are/aren't moving, delta thresholds, time since last action
  • Decision Trace — full pipeline evaluation showing which handler won and why; position_explanation on the Target Position sensor shows the complete chain (e.g. "Sun tracking (45%) → Climate: Winter Heating → 100%")
  • Last Skipped Action — most recent suppressed move with reason, position delta, and thresholds
  • Last Cover Action — most recent cover command with full details
  • Manual Override End Time — when automatic control will resume; persists across reboots (v2.17.3)
  • Position Verification — last check time and retry count per cover
  • Motion Status — motion control state; shows not_configured when no motion sensors are set up
  • Climate Status (when climate mode is configured) — active temperature and climate strategy
  • Force Override Triggers (when force override sensors are configured) — count and per-sensor status
  • Position Mismatch binary sensor (disabled by default) — true when any cover is outside the position tolerance
• Debug Mode — toggle INFO-level category logs (manual override, reconciliation, pipeline, motion) + a rolling ring buffer included in diagnostics downloads; no configuration.yaml edits required

Enhanced geometric accuracy (automatic)

• Angle-dependent safety margins for better sun blocking at extreme angles
• Automatic edge case handling for very low (<2°) and very high (>88°) sun elevations
• Smooth transitions across all sun angles using smoothstep interpolation
• Optional Window Depth parameter for advanced precision with deep reveals
• Optional Sill Height for raised windows
• Backward-compatible — existing installations benefit immediately; window_depth=0 and sill_height=0 are identical to earlier versions

Configuration Summary (built-in review screen)

• Shown as the final step of initial setup and available any time from the options menu
• Organized into four sections, only rendering what is actually configured:
  • Your Cover — what is being controlled and the physical window dimensions
  • How It Decides — narrative explanation of every active rule in priority order
  • Position Limits — default position, min/max range, delta thresholds, and flags (inverse state, interpolation) on one line
  • Decision Priority — compact one-line reference of all 10 pipeline handlers with ✅ / ❌ status
• Cover Warnings (v2.17.5) — flags open/close-only covers, assumed_state, mixed capabilities across entities, and configured position limits that will never apply; hidden when nothing is flagged