From 535881abeebe484b5d1914e48556ce7caae258d5 Mon Sep 17 00:00:00 2001
From: "alexei.dolgolyov" <dolgolyov.alexei@gmail.com>
Date: Sun, 25 Jan 2026 15:28:48 +0300
Subject: [PATCH] Add Thermostat Controller blueprint

- Schedule-based heating control using HA schedule helpers
- Multiple schedules support with OR logic
- Working and standby temperatures with input_number overrides
- Window/door sensor integration (disable heating when open)
- External temperature sensor support
- Force heating override switch
- Minimum on-time to prevent rapid cycling
- Configurable disabled behavior (turn off vs standby)
- Debug notifications for troubleshooting
---
 Common/Thermostat Controller.yaml | 684 ++++++++++++++++++++++++++++++
 1 file changed, 684 insertions(+)
 create mode 100644 Common/Thermostat Controller.yaml

diff --git a/Common/Thermostat Controller.yaml b/Common/Thermostat Controller.yaml
new file mode 100644
index 0000000..9b73987
--- /dev/null
+++ b/Common/Thermostat Controller.yaml	
@@ -0,0 +1,684 @@
+# =============================================================================
+# Thermostat Controller Blueprint
+# =============================================================================
+# This blueprint controls a thermostat/climate entity based on schedules,
+# presence, and various conditions.
+#
+# Features:
+#   - Schedule-based heating control (using HA schedule helper)
+#   - Working and standby temperature modes
+#   - Optional input_number overrides for temperatures
+#   - External temperature sensor support
+#   - Window/door sensor integration (disable when open)
+#   - Force heating override
+#   - Minimum on-time to prevent rapid cycling
+#   - Configurable behavior when disabled (off vs standby)
+#   - Debug notifications for troubleshooting
+#
+# Temperature Priority:
+#   1. Windows open → Turn off (or standby based on setting)
+#   2. Force heating ON → Working temperature
+#   3. Schedule active → Working temperature
+#   4. Schedule inactive → Standby temperature (or off)
+#
+# Author: Alexei Dolgolyov (dolgolyov.alexei@gmail.com)
+# =============================================================================
+
+blueprint:
+  name: "Custom: Thermostat Controller"
+  description: >
+    Controls a thermostat based on schedules, with support for working/standby
+    temperatures, window sensors, force heating override, and more.
+  domain: automation
+
+  input:
+    # -------------------------------------------------------------------------
+    # Thermostat Configuration
+    # -------------------------------------------------------------------------
+    thermostat_group:
+      name: Thermostat
+      collapsed: false
+      input:
+        thermostat_entity:
+          name: Thermostat
+          description: The climate entity to control
+          selector:
+            entity:
+              domain: climate
+
+        control_switch:
+          name: Control Switch
+          description: >
+            Master switch to enable/disable thermostat control.
+            When OFF, thermostat will be turned off or set to standby (based on setting).
+          selector:
+            entity:
+              domain:
+                - input_boolean
+                - switch
+                - binary_sensor
+
+        hvac_mode:
+          name: HVAC Mode
+          description: The HVAC mode to use when heating is active
+          default: heat
+          selector:
+            select:
+              options:
+                - heat
+                - cool
+                - heat_cool
+                - auto
+
+    # -------------------------------------------------------------------------
+    # Temperature Configuration
+    # -------------------------------------------------------------------------
+    temperature_group:
+      name: Temperature
+      collapsed: false
+      input:
+        working_temperature:
+          name: Working Temperature
+          description: Target temperature when schedule is active
+          default: 21
+          selector:
+            number:
+              min: 5
+              max: 35
+              step: 0.5
+              unit_of_measurement: °C
+              mode: slider
+
+        working_temperature_override:
+          name: Working Temperature Override (optional)
+          description: >
+            Input number entity to override working temperature.
+            If set and valid, this value will be used instead of the static value.
+          default: []
+          selector:
+            entity:
+              domain: input_number
+              multiple: false
+
+        standby_temperature:
+          name: Standby Temperature
+          description: Target temperature when schedule is inactive (if not turning off)
+          default: 16
+          selector:
+            number:
+              min: 5
+              max: 35
+              step: 0.5
+              unit_of_measurement: °C
+              mode: slider
+
+        standby_temperature_override:
+          name: Standby Temperature Override (optional)
+          description: >
+            Input number entity to override standby temperature.
+            If set and valid, this value will be used instead of the static value.
+          default: []
+          selector:
+            entity:
+              domain: input_number
+              multiple: false
+
+        external_temperature_sensor:
+          name: External Temperature Sensor (optional)
+          description: >
+            Use an external temperature sensor instead of the thermostat's built-in sensor.
+            Leave empty to use the thermostat's own temperature reading.
+          default: []
+          selector:
+            entity:
+              domain: sensor
+              device_class: temperature
+              multiple: false
+
+    # -------------------------------------------------------------------------
+    # Schedule Configuration
+    # -------------------------------------------------------------------------
+    schedule_group:
+      name: Schedule
+      collapsed: false
+      input:
+        schedule_entities:
+          name: Schedule(s)
+          description: >
+            Schedule helpers that define when heating should be active.
+            Multiple schedules are combined (OR logic) - heating is active if ANY schedule is ON.
+            Create schedule helpers in Home Assistant UI with your desired time slots.
+          default: []
+          selector:
+            entity:
+              domain: schedule
+              multiple: true
+
+    # -------------------------------------------------------------------------
+    # Behavior Configuration
+    # -------------------------------------------------------------------------
+    behavior_group:
+      name: Behavior
+      collapsed: false
+      input:
+        disabled_behavior:
+          name: Behavior When Disabled/Inactive
+          description: >
+            What to do when control switch is OFF or schedule is inactive.
+            "Turn off" completely disables the thermostat.
+            "Set standby" keeps thermostat running at standby temperature.
+          default: standby
+          selector:
+            select:
+              options:
+                - label: Turn off thermostat
+                  value: "off"
+                - label: Set standby temperature
+                  value: standby
+
+        minimum_on_time:
+          name: Minimum On Time
+          description: >
+            Minimum time the thermostat must stay on before it can be turned off.
+            Prevents rapid cycling which can damage equipment.
+          default: 5
+          selector:
+            number:
+              min: 0
+              max: 60
+              unit_of_measurement: minutes
+              mode: slider
+
+    # -------------------------------------------------------------------------
+    # Window/Door Sensors
+    # -------------------------------------------------------------------------
+    window_group:
+      name: Window/Door Sensors
+      collapsed: true
+      input:
+        window_sensors:
+          name: Window/Door Sensors (optional)
+          description: >
+            Binary sensors for windows or doors. When any sensor is ON (open),
+            heating will be disabled to save energy.
+          default: []
+          selector:
+            entity:
+              domain: binary_sensor
+              device_class:
+                - window
+                - door
+                - opening
+              multiple: true
+
+        window_reaction_delay:
+          name: Window Reaction Delay
+          description: >
+            Time to wait after window opens before disabling heating.
+            Prevents turning off heating for brief window openings.
+          default: 30
+          selector:
+            number:
+              min: 0
+              max: 300
+              unit_of_measurement: seconds
+              mode: slider
+
+    # -------------------------------------------------------------------------
+    # Force Heating Override
+    # -------------------------------------------------------------------------
+    force_group:
+      name: Force Heating
+      collapsed: true
+      input:
+        force_heating_switch:
+          name: Force Heating Switch (optional)
+          description: >
+            When this switch is ON, heating will be forced to working temperature
+            regardless of schedule or other conditions (except open windows).
+          default: []
+          selector:
+            entity:
+              domain:
+                - input_boolean
+                - switch
+                - binary_sensor
+              multiple: false
+
+    # -------------------------------------------------------------------------
+    # Debug Configuration
+    # -------------------------------------------------------------------------
+    debug_group:
+      name: Debug
+      collapsed: true
+      input:
+        enable_debug_notifications:
+          name: Enable Debug Notifications
+          description: >
+            Send persistent notifications for debugging automation behavior.
+            Shows trigger details, conditions, and thermostat actions.
+          default: false
+          selector:
+            boolean:
+
+# Restart mode ensures latest state is always evaluated
+mode: restart
+
+# =============================================================================
+# Triggers
+# =============================================================================
+trigger:
+  # Home Assistant startup
+  - platform: homeassistant
+    event: start
+    id: 'startup_trigger'
+
+  # Control switch state change
+  - platform: state
+    entity_id: !input control_switch
+    id: 'control_trigger'
+    not_from:
+      - unknown
+      - unavailable
+    not_to:
+      - unknown
+      - unavailable
+
+  # Schedule state change (on/off) - any schedule
+  - platform: state
+    entity_id: !input schedule_entities
+    id: 'schedule_trigger'
+    not_from:
+      - unknown
+      - unavailable
+    not_to:
+      - unknown
+      - unavailable
+
+  # Force heating switch state change
+  - platform: state
+    entity_id: !input force_heating_switch
+    id: 'force_trigger'
+    not_from:
+      - unknown
+      - unavailable
+    not_to:
+      - unknown
+      - unavailable
+
+  # Window sensor state change
+  - platform: state
+    entity_id: !input window_sensors
+    id: 'window_trigger'
+    not_from:
+      - unknown
+      - unavailable
+    not_to:
+      - unknown
+      - unavailable
+
+  # Working temperature override change
+  - platform: state
+    entity_id: !input working_temperature_override
+    id: 'temp_override_trigger'
+    not_from:
+      - unknown
+      - unavailable
+    not_to:
+      - unknown
+      - unavailable
+
+  # Standby temperature override change
+  - platform: state
+    entity_id: !input standby_temperature_override
+    id: 'temp_override_trigger'
+    not_from:
+      - unknown
+      - unavailable
+    not_to:
+      - unknown
+      - unavailable
+
+  # External temperature sensor change (for display/logging)
+  - platform: state
+    entity_id: !input external_temperature_sensor
+    id: 'external_temp_trigger'
+    not_from:
+      - unknown
+      - unavailable
+    not_to:
+      - unknown
+      - unavailable
+
+# =============================================================================
+# Variables
+# =============================================================================
+variables:
+  # ---------------------------------------------------------------------------
+  # Input References
+  # ---------------------------------------------------------------------------
+  thermostat_entity: !input thermostat_entity
+  control_switch: !input control_switch
+  schedule_entities: !input schedule_entities
+  hvac_mode: !input hvac_mode
+
+  working_temperature_static: !input working_temperature
+  working_temperature_override: !input working_temperature_override
+  standby_temperature_static: !input standby_temperature
+  standby_temperature_override: !input standby_temperature_override
+  external_temperature_sensor: !input external_temperature_sensor
+
+  disabled_behavior: !input disabled_behavior
+  minimum_on_time: !input minimum_on_time
+
+  window_sensors: !input window_sensors
+  window_reaction_delay: !input window_reaction_delay
+
+  force_heating_switch: !input force_heating_switch
+  enable_debug_notifications: !input enable_debug_notifications
+
+  # ---------------------------------------------------------------------------
+  # Computed Values
+  # ---------------------------------------------------------------------------
+
+  # Control switch state (default to ON if unavailable)
+  control_on: >
+    {% set state = states(control_switch) %}
+    {% if state in ['unknown', 'unavailable'] %}
+      {{ false }}
+    {% else %}
+      {{ is_state(control_switch, 'on') }}
+    {% endif %}
+
+  # Schedule state - active if ANY schedule is ON
+  schedule_active: >
+    {% if schedule_entities | length > 0 %}
+      {% set active_schedules = schedule_entities | select('is_state', 'on') | list %}
+      {{ active_schedules | length > 0 }}
+    {% else %}
+      {{ false }}
+    {% endif %}
+
+  # Force heating state
+  force_heating_on: >
+    {% if force_heating_switch is not none and force_heating_switch | length > 0 %}
+      {{ is_state(force_heating_switch, 'on') }}
+    {% else %}
+      {{ false }}
+    {% endif %}
+
+  # Window sensors - check if any window is open
+  windows_open: >
+    {% if window_sensors | length > 0 %}
+      {% set open_windows = window_sensors | select('is_state', 'on') | list %}
+      {{ open_windows | length > 0 }}
+    {% else %}
+      {{ false }}
+    {% endif %}
+
+  # Get effective working temperature (override or static)
+  effective_working_temp: >
+    {% if working_temperature_override is not none and working_temperature_override | length > 0 %}
+      {% set override_val = states(working_temperature_override) %}
+      {% if override_val not in ['unknown', 'unavailable'] %}
+        {{ override_val | float(working_temperature_static) }}
+      {% else %}
+        {{ working_temperature_static }}
+      {% endif %}
+    {% else %}
+      {{ working_temperature_static }}
+    {% endif %}
+
+  # Get effective standby temperature (override or static)
+  effective_standby_temp: >
+    {% if standby_temperature_override is not none and standby_temperature_override | length > 0 %}
+      {% set override_val = states(standby_temperature_override) %}
+      {% if override_val not in ['unknown', 'unavailable'] %}
+        {{ override_val | float(standby_temperature_static) }}
+      {% else %}
+        {{ standby_temperature_static }}
+      {% endif %}
+    {% else %}
+      {{ standby_temperature_static }}
+    {% endif %}
+
+  # Get external temperature reading (if configured)
+  external_temperature: >
+    {% if external_temperature_sensor is not none and external_temperature_sensor | length > 0 %}
+      {% set temp = states(external_temperature_sensor) %}
+      {% if temp not in ['unknown', 'unavailable'] %}
+        {{ temp | float }}
+      {% else %}
+        {{ 'N/A' }}
+      {% endif %}
+    {% else %}
+      {{ 'N/A' }}
+    {% endif %}
+
+  # Current thermostat state
+  thermostat_current_state: >
+    {{ states(thermostat_entity) }}
+
+  # Current thermostat temperature setting
+  thermostat_current_temp: >
+    {{ state_attr(thermostat_entity, 'temperature') | float(0) }}
+
+  # Time since thermostat was last turned on (for minimum on-time check)
+  thermostat_on_duration: >
+    {% if states(thermostat_entity) != 'off' %}
+      {{ (now() - states[thermostat_entity].last_changed).total_seconds() / 60 }}
+    {% else %}
+      {{ 0 }}
+    {% endif %}
+
+  # Check if minimum on-time has elapsed
+  min_on_time_elapsed: >
+    {{ thermostat_on_duration >= minimum_on_time or states(thermostat_entity) == 'off' }}
+
+  # ---------------------------------------------------------------------------
+  # Decision Logic
+  # ---------------------------------------------------------------------------
+
+  # Determine target action: 'working', 'standby', or 'off'
+  target_action: >
+    {% if not control_on %}
+      {# Control switch is OFF #}
+      {% if disabled_behavior == 'off' %}
+        {{ 'off' }}
+      {% else %}
+        {{ 'standby' }}
+      {% endif %}
+    {% elif windows_open %}
+      {# Windows are open - disable heating #}
+      {% if disabled_behavior == 'off' %}
+        {{ 'off' }}
+      {% else %}
+        {{ 'standby' }}
+      {% endif %}
+    {% elif force_heating_on %}
+      {# Force heating is ON #}
+      {{ 'working' }}
+    {% elif schedule_active %}
+      {# Schedule is active #}
+      {{ 'working' }}
+    {% else %}
+      {# Schedule is inactive #}
+      {% if disabled_behavior == 'off' %}
+        {{ 'off' }}
+      {% else %}
+        {{ 'standby' }}
+      {% endif %}
+    {% endif %}
+
+  # Determine target temperature based on action
+  target_temperature: >
+    {% if target_action == 'working' %}
+      {{ effective_working_temp }}
+    {% elif target_action == 'standby' %}
+      {{ effective_standby_temp }}
+    {% else %}
+      {{ 0 }}
+    {% endif %}
+
+  # Check if thermostat needs to be updated
+  needs_update: >
+    {% if target_action == 'off' %}
+      {{ thermostat_current_state != 'off' and min_on_time_elapsed }}
+    {% else %}
+      {{ thermostat_current_state == 'off' or thermostat_current_temp != target_temperature | float }}
+    {% endif %}
+
+# =============================================================================
+# Actions
+# =============================================================================
+action:
+  # ---------------------------------------------------------------------------
+  # Debug Logging
+  # ---------------------------------------------------------------------------
+  - choose:
+      - conditions:
+          - condition: template
+            value_template: "{{ enable_debug_notifications }}"
+        sequence:
+          - service: persistent_notification.create
+            data:
+              title: "Thermostat Controller Debug"
+              message: >
+                Trigger: {{ trigger.id | default('manual') }}
+                Time: {{ now().strftime('%H:%M:%S') }}
+
+                Input States:
+                - control_on: {{ control_on }}
+                - schedule_active: {{ schedule_active }}
+                - force_heating_on: {{ force_heating_on }}
+                - windows_open: {{ windows_open }}
+
+                Temperatures:
+                - effective_working: {{ effective_working_temp }}°C
+                - effective_standby: {{ effective_standby_temp }}°C
+                - external_sensor: {{ external_temperature }}
+                - thermostat_current: {{ thermostat_current_temp }}°C
+
+                Decision:
+                - target_action: {{ target_action }}
+                - target_temperature: {{ target_temperature }}°C
+                - needs_update: {{ needs_update }}
+                - min_on_time_elapsed: {{ min_on_time_elapsed }}
+
+  # ---------------------------------------------------------------------------
+  # Window Reaction Delay
+  # ---------------------------------------------------------------------------
+  # If triggered by window opening, wait for reaction delay
+  - choose:
+      - conditions:
+          - condition: template
+            value_template: "{{ trigger.id == 'window_trigger' and windows_open and window_reaction_delay > 0 }}"
+        sequence:
+          - delay:
+              seconds: "{{ window_reaction_delay }}"
+          # Re-check if windows are still open after delay
+          - condition: template
+            value_template: >
+              {% set open_windows = window_sensors | select('is_state', 'on') | list %}
+              {{ open_windows | length > 0 }}
+
+  # ---------------------------------------------------------------------------
+  # Apply Thermostat Settings
+  # ---------------------------------------------------------------------------
+  - choose:
+      # CASE 1: Turn OFF thermostat
+      - conditions:
+          - condition: template
+            value_template: "{{ target_action == 'off' and min_on_time_elapsed }}"
+        sequence:
+          - choose:
+              - conditions:
+                  - condition: template
+                    value_template: "{{ thermostat_current_state != 'off' }}"
+                sequence:
+                  - service: climate.turn_off
+                    target:
+                      entity_id: "{{ thermostat_entity }}"
+                  - choose:
+                      - conditions:
+                          - condition: template
+                            value_template: "{{ enable_debug_notifications }}"
+                        sequence:
+                          - service: persistent_notification.create
+                            data:
+                              title: "Thermostat Controller"
+                              message: "Action: Turned OFF thermostat"
+
+      # CASE 2: Set WORKING temperature
+      - conditions:
+          - condition: template
+            value_template: "{{ target_action == 'working' }}"
+        sequence:
+          - choose:
+              # Turn on if currently off
+              - conditions:
+                  - condition: template
+                    value_template: "{{ thermostat_current_state == 'off' }}"
+                sequence:
+                  - service: climate.set_hvac_mode
+                    target:
+                      entity_id: "{{ thermostat_entity }}"
+                    data:
+                      hvac_mode: "{{ hvac_mode }}"
+          # Set temperature
+          - choose:
+              - conditions:
+                  - condition: template
+                    value_template: "{{ thermostat_current_temp != effective_working_temp | float }}"
+                sequence:
+                  - service: climate.set_temperature
+                    target:
+                      entity_id: "{{ thermostat_entity }}"
+                    data:
+                      temperature: "{{ effective_working_temp }}"
+                  - choose:
+                      - conditions:
+                          - condition: template
+                            value_template: "{{ enable_debug_notifications }}"
+                        sequence:
+                          - service: persistent_notification.create
+                            data:
+                              title: "Thermostat Controller"
+                              message: "Action: Set WORKING temperature to {{ effective_working_temp }}°C"
+
+      # CASE 3: Set STANDBY temperature
+      - conditions:
+          - condition: template
+            value_template: "{{ target_action == 'standby' }}"
+        sequence:
+          - choose:
+              # Turn on if currently off
+              - conditions:
+                  - condition: template
+                    value_template: "{{ thermostat_current_state == 'off' }}"
+                sequence:
+                  - service: climate.set_hvac_mode
+                    target:
+                      entity_id: "{{ thermostat_entity }}"
+                    data:
+                      hvac_mode: "{{ hvac_mode }}"
+          # Set temperature
+          - choose:
+              - conditions:
+                  - condition: template
+                    value_template: "{{ thermostat_current_temp != effective_standby_temp | float }}"
+                sequence:
+                  - service: climate.set_temperature
+                    target:
+                      entity_id: "{{ thermostat_entity }}"
+                    data:
+                      temperature: "{{ effective_standby_temp }}"
+                  - choose:
+                      - conditions:
+                          - condition: template
+                            value_template: "{{ enable_debug_notifications }}"
+                        sequence:
+                          - service: persistent_notification.create
+                            data:
+                              title: "Thermostat Controller"
+                              message: "Action: Set STANDBY temperature to {{ effective_standby_temp }}°C"