⚠️ 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_gainaction has been updated to accept optionalkp_cool,ki_cool,kd_cool, andke_coolfields 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) inclimate.pyto 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, andclimate.py(closes #269). - Updated
async_set_pidentity 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