home-assistant-blueprints/ROOM_CONFIGURATION_GUIDE.md

Room Configuration Guide

Complete examples of configuring different room types with the Adaptive Lighting Mode System.

Example 1: Master Bedroom

Goal: Full control with optional AL, reading/sleep modes, weekend mode

Hardware:

• Inovelli Blue Dimmer: bedroom_switch (Zigbee2MQTT name)
• Lights: light.bedroom_ceiling, light.bedroom_lamp_1, light.bedroom_lamp_2
• No presence sensor (privacy)

Adaptive Lighting Configuration (in configuration.yaml):

adaptive_lighting:
  - name: bedroom
    lights:
      - light.bedroom_ceiling
      - light.bedroom_lamp_1
      - light.bedroom_lamp_2
    interval: 90
    transition: 45
    take_over_control: true
    autoreset_control_seconds: 3600  # 1 hour gentle reset

Package File (packages/adaptive_lighting_master_bedroom.yaml):

Copy from adaptive_lighting_bedroom_template.yaml, customize:

• Modes: Adaptive, Reading, Relaxing, Sleep, Manual Override
• Weekend mode enabled
• Default mode: Adaptive

Blueprint Automations (create via UI):

1. Config Button Mode Cycling:

   • Blueprint: Inovelli Mode Cycling
   • Switch Action Event: event.bedroom_switch_action
   • Mode Input Select: input_select.bedroom_lighting_mode
   • LED Color Entity: number.bedroom_switch_led_color_when_on
   • Zigbee2MQTT Device Name: bedroom_switch

2. Button Actions:

   • Blueprint: Inovelli Button Actions
   • Switch Action Event: event.bedroom_switch_action
   • AL Switch: switch.adaptive_lighting_bedroom
   • Target Lights: light.bedroom_ceiling, light.bedroom_lamp_1, light.bedroom_lamp_2
   • Auto-Reset: 30 minutes

Testing:

• Press config button → mode cycles through all 5 modes
• LED changes color for each mode
• Double-tap up → brightness boosts
• Weekend mode enables Friday 10pm
• Sunrise shifts to 10am on weekend

Example 2: Living Room (Common Area)

Goal: Entertainment modes (Theater, Party), presence control

Hardware:

• Inovelli Blue Dimmer: living_room_switch
• Lights: light.living_room_ceiling, light.living_room_lamp_1
• Presence: binary_sensor.living_room_occupancy

Package File (packages/adaptive_lighting_living_room.yaml):

Copy from adaptive_lighting_living_room_template.yaml

• Modes: Adaptive, Theater, Party, Reading
• Auto-reset mode to Adaptive when lights turn off

Blueprint Automations:

1. Config Button Mode Cycling (same as bedroom)
2. Button Actions (same as bedroom, adjust auto-reset to 15 min)
3. Presence Mode Reset:
   • Occupancy Sensors: binary_sensor.living_room_occupancy
   • Empty Delay: 5 minutes
   • AL Switch: switch.adaptive_lighting_living_room
   • Mode Input Select: input_select.living_room_lighting_mode
   • Default Mode: Adaptive

Testing:

• Enter room → lights turn on (via separate occupancy automation)
• Press config button → cycles through 4 modes
• Set to Theater mode, leave room → after 5 min, resets to Adaptive
• Manual boost → leave room → manual control clears

Example 3: Bathroom (Simple)

Goal: Always Adaptive, brightness boost only

Hardware:

• Inovelli Blue Dimmer: bathroom_switch
• Lights: light.bathroom_ceiling, light.bathroom_vanity
• Presence: binary_sensor.bathroom_occupancy

Package File (packages/adaptive_lighting_bathroom.yaml):

Copy from adaptive_lighting_simple_template.yaml

• No modes (Adaptive only)
• No weekend mode
• Simple reset on presence end

Blueprint Automations:

1. Button Actions ONLY:

   • Double-tap up: Boost brightness
   • Triple-tap down: Night light
   • Auto-reset: 10 minutes

2. Presence Mode Reset:

   • Reset manual control when empty 5 minutes
   • No mode reset (no input_select)

Testing:

• Double-tap up → brightness boosts
• Leave bathroom 5 min → manual control clears
• Triple-tap down → night light mode
• No config button action (not configured)

Entity ID Quick Reference

Finding Your Entities

Inovelli Switch Entities (via Zigbee2MQTT):

event.{device_name}_action           # Button presses (event entity)
number.{device_name}_led_color_when_on
number.{device_name}_led_color_when_off
number.{device_name}_led_intensity_when_on
select.{device_name}_smart_bulb_mode
select.{device_name}_button_delay

Adaptive Lighting Entities:

switch.adaptive_lighting_{name}
switch.adaptive_lighting_sleep_mode_{name}
switch.adaptive_lighting_adapt_brightness_{name}
switch.adaptive_lighting_adapt_color_{name}

Your Input Helpers:

input_select.{room}_lighting_mode
input_boolean.{room}_weekend_mode

Common Customizations

Add a New Mode

1. Edit package file, add mode to input_select:

input_select:
  bedroom_lighting_mode:
    options:
      - "Adaptive"
      - "Reading"
      - "NEW MODE HERE"  # Add this

2. Add color mapping to global package (or use existing color)

3. Add mode application to automation:

- conditions: "{{ mode == 'NEW MODE HERE' }}"
  sequence:
    - service: adaptive_lighting.change_switch_settings
      data:
        min_brightness: 50
        max_brightness: 80
        # ... settings

4. Reload YAML configuration

Change Auto-Reset Timeout

Edit blueprint automation via UI:

• Settings → Automations → [Your button action automation]
• Click Edit
• Adjust "Auto-Reset Timeout" slider
• Save

Disable Weekend Mode

Comment out weekend mode automations in package file:

#  - id: bedroom_weekend_mode_auto_enable
#    alias: "Bedroom: Enable Weekend Mode Friday/Saturday"
#    # ... entire automation

Reload YAML configuration.