johno/home-assistant-blueprints
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Clarify that Adaptive Lighting integration is optional

Browse Source 
Update blueprint and README to make it clear that the Adaptive Lighting
switch can be left empty, in which case lights will use simple on/off
control. Add clarifications to input descriptions and enhance
documentation with better examples.
This commit is contained in:
John Ogle
2025-12-06 14:49:03 -08:00
parent 621fdeb709
commit c9529ed52b
2 changed files with 13 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
README.md
View File

@@ -36,7 +36,7 @@ https://git.johnogle.info/johno/home-assistant-blueprints/raw/branch/main/occupa
|-------|-------------|---------| |-------|-------------|---------|
| **Occupancy Sensor** | Binary sensor that detects occupancy/presence | Required | | **Occupancy Sensor** | Binary sensor that detects occupancy/presence | Required |
| **Lights** | Light entities to control | Required | | **Lights** | Light entities to control | Required |
| **Adaptive Lighting Switch** | Adaptive lighting switch for this room | Optional | | **Adaptive Lighting Switch** | Adaptive lighting switch for this room. Leave empty to use simple on/off without adaptive lighting. | Optional |
| **Turn On Transition** | Transition time when turning lights on (seconds) | 5 | | **Turn On Transition** | Transition time when turning lights on (seconds) | 5 |
| **Turn Off Transition** | Transition time when turning lights off (seconds) | 15 | | **Turn Off Transition** | Transition time when turning lights off (seconds) | 15 |
| **Adapt Brightness** | Whether to adapt brightness with adaptive lighting | Yes | | **Adapt Brightness** | Whether to adapt brightness with adaptive lighting | Yes |
@@ -53,14 +53,18 @@ https://git.johnogle.info/johno/home-assistant-blueprints/raw/branch/main/occupa
- **Turn On Transition**: 3 seconds - **Turn On Transition**: 3 seconds
- **Turn Off Transition**: 10 seconds - **Turn Off Transition**: 10 seconds
#### Example 2: Multiple Lights without Adaptive Lighting #### Example 2: Simple On/Off Mode (without Adaptive Lighting)
**Use Case**: Control lights with simple on/off without adaptive lighting adjustments.
**Configuration**: **Configuration**:
- **Occupancy Sensor**: `binary_sensor.kitchen_motion` - **Occupancy Sensor**: `binary_sensor.kitchen_motion`
- **Lights**: `light.kitchen_ceiling`, `light.kitchen_under_cabinet` - **Lights**: `light.kitchen_ceiling`, `light.kitchen_under_cabinet`
- **Adaptive Lighting Switch**: Leave empty - **Adaptive Lighting Switch**: Leave empty (default)
- **Turn On Transition**: 1 second - **Turn On Transition**: 1 second
- **Turn Off Transition**: 5 seconds - **Turn Off Transition**: 5 seconds
- **Adapt Brightness**: Not applicable (no adaptive lighting switch)
- **Adapt Color**: Not applicable (no adaptive lighting switch)
#### Example 3: Bedroom with Gentle Transitions #### Example 3: Bedroom with Gentle Transitions
@@ -74,9 +78,9 @@ https://git.johnogle.info/johno/home-assistant-blueprints/raw/branch/main/occupa
### How It Works ### How It Works
1. **Occupancy Detected**: When the sensor state changes to "on" (occupied): 1. **Occupancy Detected**: When the sensor state changes to "on" (occupied):
- If adaptive lighting is configured, applies adaptive lighting settings - If an Adaptive Lighting switch is configured AND enabled, applies adaptive lighting settings
- If no adaptive lighting, turns lights on with specified transition - If the Adaptive Lighting switch is left empty OR is disabled, turns lights on with simple on/off using the specified transition time
2. **No Occupancy**: When the sensor state changes to "off" (not occupied): 2. **No Occupancy**: When the sensor state changes to "off" (not occupied):
- Turns off all specified lights with configured transition time - Turns off all specified lights with configured transition time

6
occupancy_controlled_lights.yaml
View File

@@ -20,7 +20,7 @@ blueprint:
domain: light domain: light
adaptive_lighting_switch: adaptive_lighting_switch:
name: Adaptive Lighting Switch name: Adaptive Lighting Switch
description: Adaptive lighting switch entity for this room description: (Optional) Adaptive lighting switch entity for this room. If left empty, lights will turn on/off directly without adaptive lighting adjustments.
default: {} default: {}
selector: selector:
entity: entity:
@@ -48,13 +48,13 @@ blueprint:
unit_of_measurement: seconds unit_of_measurement: seconds
adapt_brightness: adapt_brightness:
name: Adapt Brightness name: Adapt Brightness
description: Whether to adapt brightness when turning on lights description: Whether to adapt brightness when turning on lights (only applies when an Adaptive Lighting switch is configured)
default: true default: true
selector: selector:
boolean: boolean:
adapt_color: adapt_color:
name: Adapt Color name: Adapt Color
description: Whether to adapt color when turning on lights description: Whether to adapt color when turning on lights (only applies when an Adaptive Lighting switch is configured)
default: true default: true
selector: selector:
boolean: boolean: