📋 Changelog

All notable changes are documented here. Versions follow Semantic Versioning.

[Unreleased]

Added / improved

  • Include the actual current-slot electricity price in preheating notifications too, using the same PumpSteer state snapshot introduced in 2.2.2.
  • Correct the preheating message so it does not claim the current price is always cheap.
  • Add opt-in price-notification levels (all, braking only, none) and independent per-mode repeat cooldowns (0, 30, 60 or 120 minutes). The existing Notifications switch remains the master control.
  • Keep legacy defaults (all alerts, no cooldown), leave heat control and Relay Guard untouched, and keep holiday notifications separate.

[2.2.2] — Price-aware braking notifications

Added

  • Braking notifications include the exact current-slot electricity price from the same parsed price snapshot and slot index used by PumpSteer’s control decision.
  • The main PumpSteer sensor exposes current_price and current_price_unit for diagnostics.

Safety / compatibility

  • Missing, invalid or non-finite price values keep the existing braking notification unchanged.
  • Preheating notifications are unchanged.
  • PI, price classification, braking and thermal-control behavior are unchanged.

[2.2.1] — Brake-hold observability & Ohmigo Relay Guard

Added

  • Explicit brake_hold mode while bridging a short non-expensive gap between expensive price periods.
  • BRIDGE_SHORT_DIP_START and BRIDGE_SHORT_DIP_END transition logging without repeated start events.
  • Optional Ohmigo Relay Guard for installations with a physical Active/Bypass relay.
  • Separate restorable Relay Guard switch with diagnostics for relay state, Push state, attempts and last recovery/failure timestamps.

Relay Guard behavior

  • Existing behavior is unchanged when no relay is configured.
  • Recovery requires Relay Guard armed, Ohmigo Push explicitly on, and the configured relay explicitly off.
  • unknown, unavailable or missing relay state never causes a relay command.
  • Ohmigo Push off inhibits recovery without changing the relay.
  • safe_mode does not by itself disable Relay Guard.
  • Recovery uses a stabilization delay, at most three attempts and actual relay-state verification.
  • State changes, Home Assistant startup and a five-minute safety check can trigger evaluation.
  • Overlapping recovery sequences are suppressed.

[2.2.0] — Comfort-aware thermal & price control

Added / changed

  • Pre-brake respects the same comfort floor as active price braking.
  • PumpSteer does not start pre-brake below the comfort floor and releases an existing pre-brake ramp when the floor is crossed.
  • Short price dips are bridged only when the next expensive period starts within the configured brake_hold_minutes window.
  • Weather forecast no longer decides short-dip bridging; bridging is a price-gap decision.
  • The brake factor is held constant during a bridged dip instead of continuing to ramp upward.
  • Longer non-expensive gaps start ramping the brake out immediately.
  • ThermalOutlook now gates preheat when available; the simpler cold-forecast check is used only as fallback.
  • preheat_strength scales the preheat boost.
  • Saving-level-based preheat headroom: 0.3 / 0.5 / 0.7 / 1.0 / 1.5 °C for levels 1–5.
  • Preheat boost tapers above target and reaches zero at target + headroom.
  • Added preheat_headroom_c, preheat_ceiling_c and preheat_headroom_factor diagnostics.
  • ThermalModel fitting is performed after a completed braking phase when at least 20 valid samples have accumulated; the fitted model remains diagnostic and does not directly control brake depth.
  • Electricity price slot indexing correctly handles DST transitions, including the repeated autumn hour and shortened spring day.

Control philosophy

  • PI remains the primary comfort loop.
  • Price and forecast logic remain overlays.
  • ThermalModel does not override the comfort floor or directly control the state machine.

[2.1.4] — Ohmigo watchdog keepalive

Fixed

  • Ohmigo now receives a keepalive resend when the configured push interval is due even if the requested setpoint remains within the 0.2 °C hysteresis.
  • Prevents the Ohmigo watchdog from entering Bypass while PumpSteer’s normal output path is healthy and Ohmigo Push is enabled.
  • Keepalive resends are DEBUG-only and do not create extra Logbook entries.
  • Fixed Home Assistant translation parsing errors caused by literal Jinja braces in Generic Output help text.

Maintenance

  • Synchronized manifest, internal version constant, and version regression test to 2.1.4.
  • Updated English and Swedish Ohmigo help text for keepalive behavior.

[2.1.1] — Release hardening & beta output support

Fixed

  • Corrected HACS repository structure.
  • Removed misplaced integration-level hacs.json.
  • Updated manifest version to 2.1.1.
  • Improved CI validation with HACS, HASSFest, Ruff and Pytest.

Improved

  • Improved PumpSteer logging and telemetry.
  • Improved notification handling.
  • Improved Ohmigo push handling.
  • Expanded documentation, installation guide, dashboard examples, tuning and troubleshooting.
  • Improved internal architecture cleanup and maintainability.

Added

  • Experimental generic Modbus output support.
  • PumpSteer can now push fake outdoor temperature directly via Home Assistant services.
  • Adds groundwork for native non-Ohmigo output targets.
  • Initial testing performed with Thermia Genesis / Calibra heat pumps.

Beta feature: Thermia Genesis / Modbus output

PumpSteer 2.1.1 introduces experimental support for direct Modbus-based fake outdoor temperature control.

This allows compatible heat pumps to receive PumpSteer’s calculated fake outdoor temperature without requiring Ohmigo hardware.

[2.1.0] — Observability & Architecture

Added

  • sensor.pumpsteer_thermal_outlook — new sensor exposing PumpSteer’s internal forecast analysis: preheat worthwhile, preheat strength, warming/cooling trends, night min / day max temperature, precool risk, and effective wind-chill temperature. Primarily diagnostic in 2.1.0 — does not yet replace core preheat logic.
  • switch.pumpsteer_preheat_boost — preheat boost is now a proper dashboard switch. Previously only configurable via the options flow. Existing state is preserved across upgrades via RestoreEntity.
  • ThermalModel in thermal_model.py — passively collects indoor cooling rate samples during braking periods. Foundation for future brake safety prediction. fit() is not yet called; this is passive collection only.

Changed

  • forecast.py refactored — cleaner weather analysis, better separation between forecast retrieval and thermal analysis. ThermalOutlook dataclass introduced.
  • thermal_model.py introduced as a separate module for thermal regression logic.
  • ThermalOutlookSensor suppresses preheat_worthwhile when indoor_temp >= target_temperature to avoid unnecessary preheat signals.
  • Internal cleanup for maintainability and future extensibility.

Notes

  • No migration required. Fully backward compatible with 2.0.x.
  • All new features are additive — existing behavior is unchanged.
  • ThermalModel.fit() is identified as a future improvement; not called in 2.1.0.

[2.0.x] — Stability & Hardening

Fixed (across 2.0.x patch releases)

  • Brake ramp dt now capped at 60 seconds per step — prevents large ramp jumps after HA restarts or long gaps between polling cycles.
  • Midnight grace window (00:00–00:15) prevents stale price threshold caching before Nordpool delivers fresh data.
  • P80 guard: if P80 for the day is below ABSOLUTE_CHEAP_LIMIT, all slots are classified as cheap — no braking on days when electricity is universally cheap.
  • _forecast_is_cold() result correctly isolated from bridge_short_dip path.
  • ramp_in computed against PRICE_EXPENSIVE when upcoming=True to ensure correct ramp duration regardless of intermediate price categories.

[2.0.0] — The Big Rewrite

Added

  • PI controller as the primary control loop with integral windup protection (PID_INTEGRAL_CLAMP). Integral is frozen (not decayed or reset) during braking.
  • Smooth brake ramping — brake_factor ramps in and out over configurable minutes. No hard steps.
  • P30/P80 price classification with per-day caching. Prevents mid-slot reclassification from releasing the brake unexpectedly.
  • Pre-brake (block 5a) — pure price signal, starts ramp before the expensive slot. Independent of forecast availability.
  • Preheat-boost (block 5b) — forecast-gated, boosts heating before expensive periods when weather is cold.
  • pre_braking mode — separate from preheating for unambiguous logging and dashboard state.
  • Comfort floor per aggressiveness level — brake releases automatically when indoor temperature drops too far.
  • Brake hold time — prevents oscillation during short cheap dips within a longer expensive block.
  • Summer mode — passes through real outdoor temperature when outdoor temp exceeds threshold. Highest-priority check.
  • Safe mode — passes through real outdoor temperature when any required sensor is missing or invalid.
  • Holiday mode — lower target (16 °C default), same PI/braking logic. Scheduled via datetime helpers.
  • Ohmigo integration — pushes fake temp to Ohmigo WiFi controller with hysteresis and rate limiting.
  • Notification system — push alerts on mode transitions (braking / preheating).
  • HA 2026.2+ compatibility — uses weather.get_forecasts service call instead of deprecated state_attr(..., 'forecast').
  • Peak filter — ignores expensive price spikes shorter than PEAK_FILTER_MIN_DURATION_MINUTES (default 30 min).

Removed

  • Machine learning features from v1.x
  • very_cheap, extreme price categories — replaced with cheap, normal, expensive
  • All cloud dependencies

Breaking changes from 1.x

  • All entity IDs renamed
  • Price categories changed
  • Options flow rebuilt
  • Automations referencing old entities must be updated

[1.x] — Legacy

Version 1.x used heuristic control with ML features and cloud-optional components. No longer supported. See the Installation Guide for migration instructions.