Install via HACS (recommended): Add this repository to HACS → Integrations → Custom repositories, set Category to Integration, then install and restart Home Assistant.
- 0.2 — First public version
- 0.3-beta — Improved config flow and optional water heat pump
- 0.4.0-beta — Modularized core logic, assist control, solar power budgets, and formatting utilities
- 0.5-beta — Separated mirror thermostats
- 0.6.0 — Persistent timer state, refactored config flow, cleaned up codebase
Home Assistant custom integration to manage multiple heat-pump climate devices and coordinate their setpoints using per-device temperature offsets. and coordinate their setpoints using per-device temperature offsets.
Not affiliated with Home Assistant.
- Multi-heatpump orchestration: One virtual thermostat coordinates one optional water-based heat pump and any number of air-based assist heat pumps.
- Per-device offsets + guardrails: Lower/upper offsets per device, plus global min/max setpoint limits.
- Manual assists (default) + optional auto on/off: You decide when assists run, or let PowerClimate manage assist HVAC mode with timers and anti-short-cycle.
- Power-aware control (optional):
Solarpreset can allocate per-device power budgets from a signed house net power sensor. - Thermostat mirroring: Optionally mirror setpoint changes only from selected thermostats into PowerClimate; thermostat HVAC on/off state is ignored.
- Diagnostics: Thermal summary, per-HP behavior, derivatives, total power, and budget diagnostics.
- Works with standard HA services: Orchestrates existing
climate.*entities via Home Assistant.
- Detailed documentation (EN): custom_components/powerclimate/README.md
- Gedetailleerde documentatie (NL): custom_components/powerclimate/README-NL.md
- In Home Assistant, open HACS → Integrations → Custom repositories.
- Add the repository URL and set Category to Integration.
- Search for PowerClimate and install it.
- Restart Home Assistant.
Copy custom_components/powerclimate/ into your Home Assistant config/custom_components/ and restart Home Assistant.
-
Home Assistant → Settings → Devices & Services → Add Integration → PowerClimate.
-
Select one or more room temperature sensors (PowerClimate uses an average of available values).
-
Select thermostats that PowerClimate should mirror (optional). Only setpoint changes on these thermostats are copied to PowerClimate; turning a mirrored thermostat off does not turn PowerClimate off.
-
Select an optional water-based heat pump (0 or 1) and zero or more air-based assist heat pumps. The first mirrored thermostat is preselected for the water heat pump.
-
Configure each selected device on its own page (role, sensors, offsets, and optional on/off control for assists).
Note: Set the lower setpoint offset so that the heat pump almost, but not completely, switches off. In this example, the setpoint will be a minimum of 17 °C when the heat pump itself measures 20 °C.
- Issues and feature requests: use the GitHub issue tracker linked in the integration manifest.
- If configured, PowerClimate owns the HVAC mode for the water-based device: it is forced to HEAT while the virtual climate entity is on and explicitly switched to OFF when PowerClimate is turned off.
- The PowerClimate target temperature is clamped between the lower/upper offsets (and the global 16–30 °C limits) before being sent to the water-based device.
- Water temperature is tracked and exposed via diagnostics (when a water sensor is configured).
- The user controls each assist pump's HVAC mode. When an assist is off, PowerClimate leaves it untouched.
- When an assist pump is on, PowerClimate compares the room temperature to
the requested target:
- Minimal mode (room ≥ target): setpoint = current temp + lower offset.
- Setpoint mode (room < target): setpoint = requested target clamped
between
current + lower offsetandcurrent + upper offset.
- All temperatures are clamped between the global min/max before sending commands, ensuring thermostats stay in a safe operating window.
PowerClimate presets control how heat pumps operate in different scenarios:
| Preset | 💧 Water Heat Pump | 🌬️ Air Heat Pump(s) |
|---|---|---|
| none | Normal operation (HEAT mode, follows setpoint) | Setpoint-tracking if ON, untouched if OFF |
| boost | Boost mode (current + upper offset) | Boost mode (current + upper offset) |
| Away | Minimal mode (let temp drop to 16°C) | OFF (if allow_on_off enabled), otherwise minimal |
| Solar | Power-budgeted setpoint (uses surplus energy) | Power-budgeted setpoint (priority after water HP) |
Note: Solar preset requires a configured house net power sensor. Budget allocation prioritizes the water-based device first; any remaining air-device budget rotates across assists to avoid starving the same device every cycle.
Away preset turns off air heat pumps only when allow_on_off_control is enabled for that device.
Mirrored thermostat HVAC mode changes are not propagated; only temperature setpoint changes are mirrored.
All control parameters are defined in const.py and can be adjusted:
| Constant | Default | Description |
|---|---|---|
DEFAULT_MIN_SETPOINT |
16.0 | Absolute minimum temperature that will ever be sent to a pump. |
DEFAULT_MAX_SETPOINT |
30.0 | Absolute maximum temperature sent to any pump. |
DEFAULT_LOWER_SETPOINT_OFFSET_HP1 |
-0.3 | HP1 minimal-mode offset relative to its own sensed temperature. |
DEFAULT_UPPER_SETPOINT_OFFSET_HP1 |
1.5 | HP1 ceiling offset relative to its sensed temperature. |
DEFAULT_LOWER_SETPOINT_OFFSET_ASSIST |
-4.0 | Assist minimal-mode offset (room satisfied). |
DEFAULT_UPPER_SETPOINT_OFFSET_ASSIST |
4.0 | Assist ceiling offset when chasing the room setpoint. |
Sensors are added only for pumps that have a configured climate_entity_id.
| Sensor | Description |
|---|---|
| Temperature Derivative | Room temperature change rate (°C/hour) |
| Water Derivative | Water temperature change rate (°C/hour) |
| Thermal Summary | Human-readable system state |
| HP1 Behavior | HVAC status, temps, water temperature when available |
| HP2+ Behavior | HVAC status, temps, and PowerClimate mode for each configured assist pump |
| Total Power | Aggregated power from all configured pumps |
| Power Budget | Allocated budget totals + per-device budgets (when enabled) |
Behavior sensors are created for every configured pump, not only the first five.
Derivatives use the slope between the oldest and newest sample within the window (room: 15 minutes, water: 10 minutes), matching Home Assistant's Derivative helper behavior.
Behavior sensors label each pump as <first word> (hpX) to match the Thermal Summary format.
General setup guidance (always double-check your device manual):
- Assist pumps (HP2–HP5): enable the manufacturer’s “heat shift” / °C offset if available to stabilize minimal mode, then tune
lower_setpoint_offsetaccordingly so assists idle gently when the room is satisfied. - Water/hybrid pump (HP1): if hybrid, disable gas for space heating and cap CH/flow temperature around 45°C initially for better COP; adjust based on insulation and emitters.
- Use Advanced options to tune assist thresholds (ETA in minutes) and anti-short-cycle
- Use energy sensors or COP data for economic decisions
- Add unit tests for the assist logic