Skip to content

v0.2.0

Choose a tag to compare

View all tags
@CorentinBarban CorentinBarban released this 18 Jan 10:28

Release Notes - SmartHRT v0.2.0

Release Date: January 18, 2026

✨ New Features

Native Python Integration

  • Complete rewrite as a native Home Assistant custom integration
  • UI-based configuration (no YAML required)
  • HACS compatible for easy installation and updates

Autonomous Time Triggers

  • Automatic scheduling based on recoverycalc_hour (heating stop time)
  • Automatic scheduling based on target_hour (wake-up time)
  • Dynamic recovery_start_hour calculation and scheduling
  • Periodic recovery time updates during the night

Weather Forecast Integration

  • 3-hour temperature forecast averaging
  • 3-hour wind speed forecast averaging
  • Forecasts used for more accurate recovery time calculations

Temperature Lag Detection

  • Automatic detection of actual cooling start (radiator thermal lag)
  • More accurate RCth calculations based on real temperature drop

New Sensors

  • wind_forecast - 3h average wind forecast (km/h)
  • temp_forecast - 3h average temperature forecast (°C)
  • wind_avg - 4h rolling wind speed average (m/s)
  • night_state - Sun below horizon indicator
  • phone_alarm - Phone alarm sensor value
  • recovery_calc_mode - Recovery calculation mode state
  • rp_calc_mode - RPth calculation mode state
  • stop_lag_duration - Temperature lag duration (seconds)

New Time Entities

  • recoverycalc_hour - Configurable heating stop time
  • recoverystart_hour - Calculated recovery start time (read-only)

New Service

  • smarthrt.on_recovery_end - Trigger recovery end phase for RPth calculation

Multi-language Support

  • 🇬🇧 English (default)
  • 🇫🇷 French
  • 🇩🇪 German
  • 🇪🇸 Spanish
  • 🇮🇹 Italian

🔧 Improvements

Coordinator Architecture

  • Centralized SmartHRTCoordinator managing all thermal calculations
  • SmartHRTData dataclass for clean state management
  • Proper listener pattern for entity updates

Coefficient Setters

  • All RCth/RPth coefficients (lw/hw variants) now properly recalculate recovery time on change
  • Added set_rcth_lw, set_rcth_hw, set_rpth_lw, set_rpth_hw methods

Wind Speed History

  • 4-hour rolling average of wind speed for calibration
  • Uses deque with 240 samples (1 per minute)

📚 Documentation

  • Complete README rewrite in English
  • Separate French documentation (README_fr.md)
  • Detailed thermal model explanation
  • Automation examples

🏗️ Technical Changes

Files Modified

  • const.py - Added new constants (CONF_RECOVERYCALC_HOUR, FORECAST_HOURS, TEMP_DECREASE_THRESHOLD)
  • config_flow.py - Added recoverycalc_hour configuration field
  • coordinator.py - Major refactor with time triggers, weather forecasts, lag detection
  • sensor.py - Added 8 new sensor entities
  • time.py - Added SmartHRTBaseTime class, 2 new time entities
  • number.py - Updated setters for coefficient entities
  • services.yaml - Added on_recovery_end service
  • strings.json - Added recoverycalc_hour and on_recovery_end translations

DevContainer

  • Added FFmpeg feature for media processing capabilities

📋 Migration Guide

From v0.1.x (YAML Package)

  1. Remove the YAML package from your configuration
  2. Install SmartHRT via HACS or manually
  3. Restart Home Assistant
  4. Add the SmartHRT integration via UI (Settings → Devices & Services)
  5. Configure your sensors and parameters
  6. The integration will automatically handle all scheduling

Important Notes

  • Initial RCth/RPth coefficients are set to 50 by default
  • Auto-calibration will improve accuracy over the first few days
  • Existing automations can be simplified or removed as the integration handles triggers internally

Full Changelog: v0.1.0...v0.2.0