github ScratMan/HASmartThermostat dev-2026.12.0-alpha1
v2026.12.0-alpha1 - Development version

pre-release39 minutes ago

⚠️ Warning

Starting from 2026.12.0-alpha1, the PID controller gains and Advanced limits for Cooling mode (kp_cool, ki_cool, kd_cool, ke_cool, pwm_cool, etc.) are now fully independent from Heating mode.

If you are using a dual heating/cooling system or AC mode, no action is required if you wish to keep identical parameters: cooling parameters left empty in the configuration or UI will automatically fallback to inheriting their equivalent heating values. However, if you previously set custom cooling PID gains via YAML or actions, make sure to check your configuration.

Additionally, dynamic PID gain adjustments via the smart_thermostat.set_pid_gain service now support cooling gains (kp_cool, ki_cool, kd_cool, ke_cool) and seamlessly persist them into the integration's Config Entry options for seamless state restoration upon restart.

This is a big refactoring work, and may introduce some bugs. Please report any issue you may find.


What's new

🔀 Hybrid Actuator Control (Analog & Binary Mixed Actuation)

You can now freely mix analog/proportional actuators (0–100% valves, light dimmers, number entities, climate entities) and binary/digital actuators (ON/OFF switches driven by PWM) within the exact same thermostat instance.

  • Intelligent Actuator Splitting: The thermostat automatically inspects each entity's capabilities, routing the continuous raw PID output (0–100%) directly to analog devices (valves, climate entities, light dimmers) while simultaneously driving binary devices via time-proportional PWM regulation.
  • Independent Cycle Protection: Analog entities and binary switches maintain isolated cycle protection timers. A quick state transition on an analog valve will no longer prevent or delay mandatory cycle protection for binary relays.

❄️ Independent Cooling PID & Advanced Settings

Cooling mode now features its own complete set of dedicated PID parameters (kp_cool, ki_cool, kd_cool, ke_cool, pwm_cool) and Advanced configuration limits (output_min_cool, output_max_cool, out_clamp_low_cool, out_clamp_high_cool, min_cycle_duration_cool, min_off_cycle_duration_cool, etc.).

  • Thermal asymmetry management: Cooling systems (like air conditioners or heat pumps) often respond much faster than heating systems (like underfloor heating or radiators). You can now fine-tune aggressive cooling gains without affecting your heating stability.
  • Smart Fallback: If any cooling parameter is left undefined, the thermostat gracefully inherits the corresponding heating value to keep configuration clean and effortless.

🎛️ Action & UI Persistence for Cooling Gains

  • Service Enhancement: The smart_thermostat.set_pid_gain action has been updated to accept optional kp_cool, ki_cool, kd_cool, and ke_cool fields alongside heating gains.
  • Config Entry Sync: Updating gains on a UI-configured thermostat now permanently updates the entity's underlying options flow entries for both heating and cooling modes.

🌐 Config Flow & Localizations

The Config Flow and Options Flow multi-step forms have been fully updated to support pid_cool and advanced_cool steps whenever a cooling actuator (cooler) is configured, including complete English (strings.json), French, German, and Italian localizations.


What's changed

  • Added hybrid actuator separation (_separate_entities_by_control_type) in climate.py to route continuous outputs to analog devices and PWM modulation to toggleable switches simultaneously (closes #269).
  • Added optional cooling PID gains and advanced parameters schema to services.yaml, config_flow.py, and climate.py (closes #269).
  • Updated async_set_pid entity service to handle, store, and persist both heating and cooling parameters individually or simultaneously.
  • Refactored documentation (docs/services.md) to reflect full support for cooling parameter dynamic tuning.

Fixed bugs

  • Set Preset Mode not working if a temp isn't defined in YAML #237

Full Changelog: 2026.11.2...dev-2026.12.0-alpha1

Don't miss a new HASmartThermostat release

NewReleases is sending notifications on new releases.