github ScratMan/HASmartThermostat 2026.11.2
v2026.11.2

28 minutes ago

⚠️ Warning

Starting from 2026.11.0, the PID algorithm now includes a trapezoidal average filter to stabilize it vs sensor measurement noise and irregular update intervals.
The integral accumulation now averages the error over elapsed time intervals (Ki * 0.5 * (error + last_error) * dt). This prevents the algorithm from over-integrating between sensor updates and provides a smoother thermal response.
For the vast majority of setups, no retuning is required. However, because integration is now mathematically more precise and slightly less aggressive during sharp temperature changes, you may notice a marginally slower integral buildup during large setpoint changes. If your system takes longer to reach the setpoint, a slight increase in Ki can compensate for it.

Additionally, the integral term is now preserved across setpoint/preset changes and OFF states. Wiping the integral on setpoint changes forced the thermostat to relearn the room's baseline heat loss from scratch, causing an unwanted temporary drop in heating.
Best Practice Note: If you experience a slow response when jumping to a higher setpoint (e.g., Eco to Comfort), avoid relying on integral windup or resetting. Instead, enable and tune the outdoor temperature compensation gain (ke). $K_e$ acts dynamically on setpoint - outdoor_temp to instantly step up the required heating output for a higher setpoint without compromising integral stability.

What's changed

When climate is configured through config flow, setting PID gains through set_pid_gain action updates the config options of the entity with the new values and restored upon reload/restart ; so both the final entity and its configuration are aligned.

Fixed bugs

  • fix(climate): correct inverted hysteresis output in COOL mode by @theobarrague in #346
  • fix(climate): use total_seconds() instead of timedelta.seconds for pwm, sensor_stall, sampling_period and lookback by @theobarrague in #347
  • fix(climate): limited decimals on PID settings (#348)

New Contributors

Full Changelog: 2026.11.1...2026.11.2

Don't miss a new HASmartThermostat release

NewReleases is sending notifications on new releases.