Skip to content

Configuration Sun Tracking

Jason Rhubottom edited this page Jun 8, 2026 · 3 revisions

Sun Tracking

Field of View and Blind Spot diagram

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

How to Measure Field of View

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:

  1. Stand at the centre of the window, inside your room, looking straight out (perpendicular to the wall: this is the azimuth direction).
  2. 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.
  3. Repeat looking right for FOV Right.
  4. 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.

Minimize Movements

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.

What the steps mean

  • 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.

Cover-type behaviour

"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).

Position Forecast

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.

When to use it

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.

Clone this wiki locally