🔥 PumpSteer
Smart heat pump optimization for Home Assistant.
PumpSteer is a Home Assistant custom integration that saves money on electricity by dynamically adjusting the virtual outdoor temperature sent to your heat pump controller — without any cloud dependency, machine learning, or black-box logic.
Everything PumpSteer does is explainable directly from its inputs.
How it works
Your heat pump has a heating curve: the colder it thinks it is outside, the harder it heats. PumpSteer sits between your outdoor sensor and the heat pump controller and sends a calculated fake outdoor temperature instead of the real one.
By raising the fake temperature during expensive electricity slots, the heat pump reduces output and saves money. By lowering it before expensive periods, the house pre-heats while electricity is still cheap.
A PI controller maintains indoor comfort at all times. Price and forecast signals are overlays on top of the PI output — never replacements for it.
fake_outdoor_temp = PI_output + brake_overlay + preheat_boost
Key features
| Feature | Description |
|---|---|
| PI control | Maintains indoor temperature at your target regardless of weather |
| Price braking | Reduces heating during expensive electricity slots (P80 threshold) |
| Pre-brake | Starts brake ramp before the expensive slot begins |
| Preheat boost | Heats extra before expensive periods when forecast is cold |
| Comfort floor | Brake releases automatically if indoor temp drops too far |
| Summer mode | Passes through real outdoor temp when it is warm enough |
| Ohmigo support | Pushes fake temp directly to Ohmigo WiFi controller |
| Holiday mode | Lowers target to 16 °C during absence |
| Fully local | No cloud, no API keys, no ML |
Operating modes
| Mode | What triggers it |
|---|---|
normal |
Default PI control |
braking |
Current price slot is expensive |
pre_braking |
Expensive slot is imminent (within ramp window) |
preheating |
Expensive slot is imminent AND forecast is cold |
summer_mode |
Outdoor temp ≥ summer threshold |
safe_mode |
Required sensor data is missing |
holiday |
Holiday mode switch is on |
Requirements
- Home Assistant 2023.12 or later
- A Nordpool (or compatible) electricity price sensor with
raw_today/raw_tomorrowattributes - An indoor temperature sensor
- An outdoor temperature sensor
- (Optional) A weather entity for forecast-based preheat
- (Optional) An Ohmigo device for direct hardware push
Disclaimer: Heating is a critical system. Use PumpSteer at your own risk. Always monitor behavior after installation and ensure your fallback (safe mode) works correctly.
