Configuration Guide¶

This guide explains all configuration options for the Heating Curve Optimizer integration.

Configuration Flow¶

The integration uses a multi-step configuration wizard:

Step 1: Basic Settings¶

Building Parameters¶

Area (m²)¶

• Description: Total heated floor area of your home
• Range: 50 - 500 m²
• Default: 150 m²
• Impact: Directly affects heat loss calculation

Energy Label¶

• Description: Building energy efficiency rating
• Options: A+++, A++, A+, A, B, C, D, E, F, G
• Default: C
• Impact: Determines U-value (thermal transmittance)

Energy label to U-value mapping:

Window Configuration¶

Glass East (m²)¶

• Description: Total window area facing east (±45°)
• Range: 0 - 50 m²
• Default: 5 m²
• Impact: Morning solar gain

Glass West (m²)¶

• Description: Total window area facing west (±45°)
• Range: 0 - 50 m²
• Default: 5 m²
• Impact: Evening solar gain

Glass South (m²)¶

• Description: Total window area facing south (±45°)
• Range: 0 - 50 m²
• Default: 10 m²
• Impact: Peak solar gain (most important)

Glass U-value (W/m²K)¶

• Description: Thermal transmittance of windows
• Range: 0.5 - 3.0
• Default: 1.2
• Impact: Heat loss through windows

Common window U-values:

Heat Pump Parameters¶

Base COP¶

• Description: Heat pump COP at 35°C supply temperature and 7°C outdoor temperature
• Range: 2.0 - 6.0
• Default: 3.5
• Impact: Baseline efficiency calculation

K-Factor¶

• Description: COP degradation per °C supply temperature increase
• Range: 0.01 - 0.10
• Default: 0.03
• Impact: How much COP drops when supply temp rises

Heat pump type guidelines:

COP Compensation Factor¶

• Description: Multiplier to adjust theoretical COP to real-world system efficiency
• Range: 0.5 - 1.2
• Default: 0.9
• Impact: Accounts for distribution losses, defrost cycles, auxiliary pumps

Advanced Settings¶

Planning Window (hours)¶

• Description: How far ahead to optimize
• Range: 2 - 24 hours
• Default: 6 hours
• Impact: Longer window = better optimization but more computation

Time Base (minutes)¶

• Description: Optimization time step size
• Range: 15 - 120 minutes
• Default: 60 minutes
• Impact: Smaller steps = finer control but more computation

Offset Change Speed (offset_delta_t)¶

• Description: Minutes required per 1°C offset change
• Range: 10 - 60 minutes
• Default: 10 minutes
• Impact: Controls how quickly the heating curve offset can change
• Formula: Max change per step = time_base / offset_delta_t
• At 60 min time_base, 10 min delta: max 6°C/hour
• At 60 min time_base, 60 min delta: max 1°C/hour

Temperature Control Settings¶

Target Indoor Temperature¶

• Description: Desired indoor temperature setpoint
• Range: 15 - 25°C
• Default: 20°C
• Impact: Base temperature for heat demand calculation

Indoor Temperature Hysteresis¶

• Description: Temperature band around setpoint for smooth control
• Range: 0.1 - 2.0°C
• Default: 0.5°C
• Impact: Prevents frequent on/off cycling

Step 2: Source Selection¶

Select the sensors that provide power consumption and production data.

Consumption Sensor¶

• Required: Yes
• Device Class: power or energy
• Unit: W or kW
• Description: Your home's total electricity consumption

Production Sensor¶

• Required: No (but recommended if you have solar panels)
• Device Class: power or energy
• Unit: W or kW
• Description: Solar panel or other electricity production

Step 3: Price Settings¶

Configure electricity price sensors for optimization.

Consumption Price Sensor¶

• Required: Yes (or configure fixed price)
• Unit: €/kWh or your currency
• Description: Variable electricity consumption price

Supported Price Sensor Formats¶

The integration supports multiple price sensor attribute formats:

attributes:
  raw_today:
    - hour: "2025-11-15T00:00:00+01:00"
      price: 0.23
    - hour: "2025-11-15T01:00:00+01:00"
      price: 0.21
    ...
  raw_tomorrow:
    - hour: "2025-11-16T00:00:00+01:00"
      price: 0.25
    ...

attributes:
  forecast_prices:
    - datetime: "2025-11-15T00:00:00+01:00"
      price: 0.23
    - datetime: "2025-11-15T01:00:00+01:00"
      price: 0.21
    ...

attributes:
  net_prices_today:
    - 0.23
    - 0.21
    - 0.19
    ...
  net_prices_tomorrow:
    - 0.25
    - 0.24
    ...

Production Price Sensor¶

• Required: No
• Unit: €/kWh
• Description: Electricity sell-back price (feed-in tariff)

Fixed Price Mode¶

If you don't have a variable price sensor:

1. Leave price sensors empty
2. Integration uses current sensor state as fixed price
3. Optimization still works but focuses on COP efficiency rather than price timing

Updating Configuration¶

After initial setup, you can modify settings:

1. Navigate to Settings → Devices & Services
2. Find "Heating Curve Optimizer"
3. Click "Configure"
4. Modify parameters
5. Save

Changes take effect immediately (within one update cycle).

Configuration Examples¶

Example 1: Well-Insulated House with Solar¶

Area: 150 m²
Energy Label: A+
Glass East: 3 m²
Glass West: 3 m²
Glass South: 12 m²
Glass U-value: 0.8 W/m²K

Base COP: 4.2
K-Factor: 0.025
COP Compensation: 0.92

Consumption Sensor: sensor.power_consumption
Production Sensor: sensor.solar_production
Consumption Price: sensor.nordpool_kwh_nl_eur_3_10_0
Production Price: sensor.feed_in_tariff

Example 2: Average House, No Solar¶

Area: 120 m²
Energy Label: C
Glass East: 5 m²
Glass West: 5 m²
Glass South: 8 m²
Glass U-value: 1.2 W/m²K

Base COP: 3.5
K-Factor: 0.03
COP Compensation: 0.9

Consumption Sensor: sensor.power_consumption
Production Sensor: (none)
Consumption Price: sensor.electricity_price
Production Price: (none)

Example 3: Poorly Insulated House¶

Area: 180 m²
Energy Label: E
Glass East: 6 m²
Glass West: 6 m²
Glass South: 10 m²
Glass U-value: 2.0 W/m²K

Base COP: 3.0
K-Factor: 0.035
COP Compensation: 0.85

Consumption Sensor: sensor.power_consumption
Production Sensor: (none)
Consumption Price: 0.30 (fixed)
Production Price: (none)

Validation¶

The integration validates your configuration:

• ✓ Area must be reasonable (50-500 m²)
• ✓ Energy label must be valid
• ✓ COP parameters must be physically plausible
• ✓ Selected sensors must exist and have valid states

If validation fails, you'll see an error message explaining the issue.

Next: Quick Start Guide - Start optimizing your heating!