📖 CCA Handbook — Cover Control Automation
The complete configuration reference for the Cover Control Automation (CCA) blueprint.
Every blueprint input is documented here in full detail — the blueprint UI shows a short
summary and links to the matching chapter of this handbook.
New to CCA? Start with the Quick Start Guide and the
FAQ, then come back here when you want to fine-tune individual options.
Chapters
Getting started
- 🧱 Basics: Cover & Status Helper — the two mandatory settings
- ⚙️ Features & Modes — enable/disable automation features, time-control mode, operators
- 📐 Positions — position source, cover type, open/close/ventilate/shading positions, tolerance
Schedules & environment
- ⏰ Time & Calendar Control — opening/closing times, workday sensors, calendar mode
- 💡 Brightness — brightness-based opening and closing
- ☀️ Sun Elevation — fixed, dynamic and hybrid elevation thresholds
Windows & shading
- 🚪 Window Contacts & Ventilation — lockout protection, tilted-window ventilation
- 🌤️ Sun Shading — shading conditions, sun position, forecast, timing and retry behavior
- 🪟 Tilt Positions (Venetian Blinds) — slat control, elevation-dependent tilt stages
People & overrides
- 🛏️ Resident Mode — presence-based behavior
- ✋ Manual Override & Reset — manual-change detection and reset strategies
- 🛡️ Force Functions & Pause — forced open/close/ventilate/shading, force pause, recovery
Fine-tuning
- ⏳ Drive Delays — fixed and random delays before movements
- 🔀 Additional Conditions — per-action custom conditions
- 🎬 Before/After Actions — custom actions around each movement
- 🩺 Configuration Check — runtime configuration validation
- 📝 Logging — logbook diagnostics
More resources