From 2549110eeaf38f2ec5dd2080bd6595d716176929 Mon Sep 17 00:00:00 2001 From: Kasper Date: Thu, 20 Aug 2026 16:56:08 +0200 Subject: [PATCH] Add Outdoor Light --- Outdoor-Light.md | 204 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 204 insertions(+) create mode 100644 Outdoor-Light.md diff --git a/Outdoor-Light.md b/Outdoor-Light.md new file mode 100644 index 0000000..d56c4c4 --- /dev/null +++ b/Outdoor-Light.md @@ -0,0 +1,204 @@ +# Outdoor Light - Sunset, Night Off, Morning On + +## Overview + +This Home Assistant Blueprint provides automatic control of outdoor lights based on the sun's elevation and configurable times. + +The blueprint is designed for outdoor lighting that should: + +- Turn on automatically when it gets dark +- Turn off at a configured time during the night +- Optionally turn on again in the early morning +- Turn off again when daylight returns + +An optional enable entity can be used to completely enable or disable the automation. + +--- + +## Features + +- Turn lights on automatically when it gets dark +- Turn lights off when daylight returns +- Configurable night-time shutdown +- Optional morning reactivation +- Uses **Sun elevation** instead of fixed sunset/sunrise times +- Optional enable/disable entity +- Supports one or multiple lights +- Fully configurable through the Home Assistant Blueprint UI + +--- + +## How it Works + +The automation has four independent triggers: + +``` + Sun elevation + │ + ▼ + Below evening level + │ + ▼ + LIGHT ON + │ + │ + Night Off Time + │ + ▼ + LIGHT OFF + │ + │ + Morning On Time + │ + ▼ + Still dark enough? + │ │ + YES NO + │ │ + ▼ ▼ + LIGHT ON No action + │ + │ + Sun elevation + above morning level + │ + ▼ + LIGHT OFF +``` +--- +### Evening + +When the sun's elevation falls below the configured Evening elevation, the selected lights are turned on. + +**Example:** +``` +If: +Evening elevation: -4° +``` + +the lights will turn on when the sun drops below -4° elevation. + +This allows the lighting to follow the actual daylight conditions throughout the year rather than relying on a fixed time. + +--- +### Night Off + +The lights can optionally be switched off at a fixed time during the night. + +**Example:** +``` +Night Off: Enabled +Night Off Time: 23:00 +``` + +At 23:00 the lights will be turned off. + +This feature can be disabled if the lights should remain on throughout the entire night. + +--- +### Morning On + +The blueprint can optionally turn the lights back on in the morning. + +**Example:** +``` +Morning On: Enabled +Morning On Time: 05:30 +``` + +At 05:30 the automation checks the sun's elevation. + +The lights will only turn on if the sun is still below the configured Morning elevation. + +This prevents the lights from being turned on unnecessarily during periods when it is already daylight. + +**Example** +``` +Morning On Time: 05:30 +Morning elevation: -4° +``` + +At 05:30: + +``` +Sun elevation < -4° + │ + ├── YES → Lights ON + │ + └── NO → No action +``` + +### Morning Off + +When the sun rises above the configured Morning elevation, the lights are turned off. + +**Example:** +``` +Morning elevation: -4° +``` + +Once the sun reaches an elevation above -4°, the lights are switched off. + +This provides the final daylight shutdown after the optional morning lighting period. + +--- +## Enable Entity + +An optional entity can be selected to enable or disable the automation. + +For example: +``` +input_boolean.outdoor_lights_enabled +``` +When the entity is: +``` +ON +``` +the automation is allowed to control the lights. + +When the entity is: +``` +OFF +``` +the automation will not perform any actions. + +If no enable entity is selected, the automation is always enabled. + +--- +## Blueprint Inputs +| Input | Description | Default | +| --- | --- | --- | +| Light(s) | Light entities controlled by the automation | — | +| Enable Entity | Optional entity used to enable/disable automation | None | +| Evening elevation | Sun elevation at which lights turn on | -4° | +| Morning elevation | Sun elevation at which lights turn off | -4° | +| Enable Night Off | Enable automatic night shutdown | Yes | +| Night Off Time | Time when lights are switched off | 23:00 | +| Enable Morning On | Enable morning reactivation | Yes | +| Morning On Time | Time when morning lighting is evaluated | 05:30 | + +--- +## Requirements + +- Home Assistant +- sun.sun integration +- One or more light entities + +The optional Enable Entity can be any Home Assistant entity that provides an on/off state. + +--- +## Installation + +1. Download the Blueprint YAML file. +2. Open Home Assistant. +3. Go to: + +``` +Settings +→ Automations & Scenes +→ Blueprints +``` + +4. Import the Blueprint. +5. Create an automation from the Blueprint. +6. Select the lights and configure the desired settings.