Thanks for the detailed config, @Wreckit72 — that helps a lot.

What "Zone Radius" means

The coordinate system has its origin at the centre of your window, projected onto the floor:

• X — horizontal offset along the wall. 0 = directly in front of the window centre. Positive = right when standing inside facing the window; negative = left.
• Y — distance into the room, perpendicular to the window (must be positive).
• Radius — the circular protection zone around the (X, Y) point. Larger radius → lower blind position → more blind deployed.

Units: All values are in centimetres on stable releases.

Why your zones may not be activating

A few things to check:

1. Zone Y must be smaller than your blocking distance.
This is the most common cause. The handler only fires when the zone needs more blind than normal solar tracking would provide. If your Zone Y is greater than the "distance to shaded area" (blocking distance) configured for the cover, the zone is already in shadow from normal tracking — the handler sees no work to do and passes through silently. Try setting Zone Y to a value less than your blocking distance.

2. Sun must be inside your FOV.
The handler is skipped entirely if the sun's azimuth is outside your Left/Right FOV angles. Check the sun_in_fov attribute on the cover's position sensor during the hours you expect zones to activate.

3. Zone switches must be on.
Each zone has its own enable/disable switch in HA. Confirm the zone switches are enabled.

4. Check time window.
The handler respects your configured start/end times and sunrise/sunset offsets — outside those windows it's skipped.

5. Use diagnostics to see exactly which gate is blocking it.
Download the diagnostics (HA → Settings → Devices & Services → Adaptive Cover Pro → Download Diagnostics) and look in pipeline_trace → glare_zone for the describe_skip field. It will say exactly why — "outside time window", "no active glare zones or sun not in FOV", "zone already in shadow", etc. That's the fastest way to pinpoint the issue.

For the full coordinate system explanation and a troubleshooting checklist, see the Glare Zones wiki page.

Hi @jrhubott thank you for the quick response.
I believe the Y position maybe set lower so that would make some sense.

I initially treated the Radius as an arc length. from the angle i measured from the centre of the window.
as that made more sense when setting it up than a radius. (a reverse Blind spot.) though i see i am at fault here.

I guess what i don't understand from your above description.

my use case is protecting a leather sofa one side of the room
so on the left side facing out the window:

The Y Value for all Shades will be 60cm. (i have my main shade set distance set to 40 from memory)
The X Value i guess for the center and right side blind. tells the system where in the room the Shaded area is in relation to their center positions?

this still gives me a box anything below the Y value gets sun. everything beyond that value should get shade?
the radius should that be calculated from the center of the window in question to the closest edge of the object you want in shade or from the offset position to the closest edge of the object in question?

hope this makes more sense of what i am asking?

If not i will draw up a quick picture for you. :)

either way thank you for the work you put in though overall its a great step forward from the original code :)

The wiki now has the birds-eye diagram you suggested — step-numbered measurements for X, Y, and Radius mapped to a room sketch. For your sofa setup: Y is the depth from the window wall to the sofa centre, X is the horizontal offset from the window's centre, and Radius covers about half the sofa width. With Shaded Distance set to 2 m and Glare Y at 60 cm your numbers should be in the right ballpark — let me know how it behaves when the sun is active.