-
Notifications
You must be signed in to change notification settings - Fork 14
Configuration Sun Tracking
| Variable | Default | Range | Description |
|---|---|---|---|
| Window Azimuth | 180 | 0β359 | Compass direction the window faces. Discoverable via Open Street Map Compass |
| Field of View Left | 90 | 0β180 | Unobstructed arc from window centre to the left, in degrees |
| Field of View Right | 90 | 0β180 | Unobstructed arc from window centre to the right, in degrees |
| Minimal Elevation | None | 0β90 | Sun must be above this angle before tracking activates |
| Maximum Elevation | None | 1β90 | Sun must be below this angle for tracking to activate |
| Enable Blind Spot | False | Enables the Blind Spot step: define an angular range where an obstruction blocks direct sun | |
| Enable Glare Zones | False | Enables the Glare Zones step (vertical blinds only): protect named floor areas from direct sun | |
| Minimize Movements | False | Opt-in. Snaps sun tracking to a few fixed coverage levels instead of following the sun continuously β far fewer motor movements. See Minimize Movements below | |
| Maximum Coverage Steps | 1 | 1β10 | Only used when Minimize Movements is on. How many distinct positions the cover may use to reach full coverage. 1 = jump straight to full coverage |
Field of View (FOV) defines the horizontal angular range where the integration actively tracks the sun. Outside this range the sun is treated as "not in front of the window" and the cover returns to the default position.
Measurement steps:
- Stand at the centre of the window, inside your room, looking straight out (perpendicular to the wall: this is the azimuth direction).
- Look left: find the furthest point where direct sunlight can enter through the window without being blocked by a wall, pillar, overhang, or neighbouring building. Estimate the angle between straight-ahead and that point. That is FOV Left.
- Repeat looking right for FOV Right.
- A smartphone protractor app (or a simple protractor held flat) makes this easier to measure accurately.
Recommended values by situation:
| Situation | FOV Left / Right |
|---|---|
| Standard window, no obstructions | 45Β° each side |
| Wide window or sliding glass door | 60β75Β° each side |
| Narrow window or recessed into a thick wall | 30Β° each side |
| Protecting furniture or artwork from any direct sun | Measure actual unobstructed angle (see below) |
Protecting fragile furniture or artwork: The default 90Β° per side (180Β° total) is intentionally wide to work for most installations. However, if your goal is to prevent any direct sunlight from reaching a specific area, use the actual unobstructed angle your window allows, not the default. Measure from the window centre to the edge of whichever wall, column, or frame first blocks direct sun on each side. A tighter FOV means the blind engages as soon as direct sun could enter, and stays in the default (typically more closed) position at all other times.
Example: A south-facing window set into a 60 cm thick wall may only allow direct sun within Β±40Β° of perpendicular. Setting FOV Left and FOV Right to 40Β° each ensures the blind is always active during those hours, rather than the wider 90Β° default which would leave gaps.
By default, sun tracking repositions the cover continuously: as the sun drifts, the calculated position changes by a percent or two, and the cover nudges to follow it. Over a day that adds up to a lot of small motor movements. Some motors are noisy, some are slow, and some users simply prefer the cover to settle and stay put.
Minimize Movements (opt-in, off by default) trades fine-grained tracking for far fewer movements. Instead of following the sun continuously, it snaps the tracked position to one of a small number of fixed coverage levels. Maximum Coverage Steps (1β10) sets how many levels there are between fully open and full coverage.
The quantization always rounds toward more coverage, never less β so this setting can only ever block more direct sun than plain tracking would, never less. You give up some natural light in exchange for fewer movements; you never give up sun protection.
- 1 step (the default when enabled): The moment the sun enters the field of view, the cover moves straight to full coverage and holds there until the sun leaves. This is the fewest possible movements β one move in, one move out.
- 2 steps: The cover uses at most two stops on its way to full coverage β roughly half-closed, then fully closed β as the required coverage grows through the day.
- 3 steps: Three stops (about one third, two thirds, full), and so on up to 10.
Because the value is stable across many sun positions, the integration's normal delta position threshold suppresses the in-between commands automatically β that is what produces the reduction in movements.
"Full coverage" means whatever fully blocks direct sun for your cover:
- Vertical blinds / roller shutters β fully lowered.
- Tilt / venetian slats β slats fully closed. For venetian covers, both the carriage position and the slat tilt are quantized, so a 1-step setting drives the carriage closed and the slats closed.
- Awnings β fully extended (an extended awning is what blocks the sun).
The forecast strip on the companion Lovelace card uses the same quantization, so it shows the same stepped positions the cover will actually be commanded to β not a smooth curve the cover never follows.
Reach for this when motor noise, motor wear, or visual fussiness matters more than squeezing out maximum daylight β for example a bedroom blind you would rather have simply close when the sun hits it, or a motor that is slow or loud enough that frequent small adjustments are annoying. Leave it off if you want the cover to admit as much natural light as possible while still blocking direct sun.
π Home Β· β¨ Features Β· π° What's New
π Getting Started
- Installation
- Migrating from Custom Repository
- Migrating from Adaptive Cover
- First-Time Setup
- Cover Types
π§ Core Concepts
π Cover Types
βοΈ Configuration
- Sun Tracking
- Position
- Glare Zones
- Automation
- Custom Position
- Force Override
- Weather Safety
- Climate
- Blindspot
- Summary Screen
- Debug & Diagnostics
π Entities & Services
- Entities
- Proxy Cover Entity
- Position Verification
- My Position Support (Somfy RTS)
- Runtime Configuration Services
π οΈ Operations
π§ Advanced Use Cases
- Dynamic Temperature Thresholds
- Dynamic Tracking Window
- Bedroom Sleep Mode
- Handling Variable Cloud Cover
- Venetian Tilt-Only on Overcast Days
π¨ Dashboard
π§ͺ Testing & Simulation
π Reference
π©βπ» For Developers