remote/adaptive-lighting
1
0
Fork 0
mirror of https://github.com/basnijholt/adaptive-lighting.git synced 2026-09-15 00:04:05 +02:00
Code Issues Projects Releases Packages Wiki Activity

Protect per-light dim ceilings during interception

Browse source
This commit is contained in:
Bas Nijholt 2026-09-06 09:41:25 -07:00
commit eba899c02c
5 changed files with 227 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

2
docs/advanced/manual-control.md
View file

@ -30,7 +30,7 @@ These lists report manual-control flags. Actual adaptation also depends on `take
The `skip_brightness_increases` option provides a dim-only policy for automatic adaptation. Adaptive Lighting can lower brightness and continue adapting color, but it will not raise brightness above the light's reported numeric value. To keep adapting after direct or physical brightness changes, use `take_over_control: false` and `detect_non_ha_changes: false`; otherwise the existing `pause_all` or `pause_changed` manual-control policy can pause adaptation before this brightness ceiling is applied.
This option does not store a brightness to restore later. A retained brightness reported while a light is off remains the ceiling on a bare turn-on, and leaving sleep mode does not necessarily restore the normal brighter target. Send a direct brightness request or disable `skip_brightness_increases` when you want to brighten the light. If the light reports no numeric brightness, Adaptive Lighting uses its calculated target.
This option does not store a brightness to restore later. A retained brightness reported while a light is off remains the ceiling on a bare turn-on, and leaving sleep mode does not necessarily restore the normal brighter target. To brighten, send a direct brightness request while the light is already on or disable `skip_brightness_increases`. An explicit brightness that turns a light on follows the existing interception rules: with the default `adapt_only_on_bare_turn_on: false`, Adaptive Lighting may replace it with the automatic target; enabling `adapt_only_on_bare_turn_on` with takeover control preserves it and marks the light manually controlled. If the light reports no numeric brightness, Adaptive Lighting uses its calculated target.
The attributes are absent when the Adaptive Lighting switch is off. Use a fallback when checking them in templates:

2
docs/advanced/sleep-mode.md
View file

@ -35,7 +35,7 @@ Sleep mode is configured through the main Adaptive Lighting configuration. See t
| `sleep_transition` | 1 | Transition duration in seconds |
| `transition_until_sleep` | false | Gradually transition to sleep settings after sunset |
With `skip_brightness_increases` enabled, leaving sleep mode does not necessarily restore the normal brighter target. The light's reported sleep brightness remains the automatic ceiling because Adaptive Lighting does not store restoration state. Send a direct brightness request or disable `skip_brightness_increases` when you want to brighten the light.
With `skip_brightness_increases` enabled, leaving sleep mode does not necessarily restore the normal brighter target. The light's reported sleep brightness remains the automatic ceiling because Adaptive Lighting does not store restoration state. To brighten, send a direct brightness request while the light is already on or disable `skip_brightness_increases`. An explicit brightness that also turns the light on still follows `adapt_only_on_bare_turn_on` and takeover-control rules.
## Automation Examples