gilles/versatile_thermostat
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Enhance messages when temp are not ready

Browse Source
This commit is contained in:
Jean-Marc Collin
2023-11-06 16:54:19 +00:00
parent 382f6f99c6
commit a40f976fd1
1 changed files with 48 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files

68
custom_components/versatile_thermostat/pi_algorithm.py
View File

@@ -5,8 +5,9 @@ import logging
_LOGGER = logging.getLogger(__name__) _LOGGER = logging.getLogger(__name__)
class PITemperatureRegulator: class PITemperatureRegulator:
""" A class implementing a PI Algorithm """A class implementing a PI Algorithm
PI algorithms calculate a target temperature by adding an offset which is calculating as follow: PI algorithms calculate a target temperature by adding an offset which is calculating as follow:
- offset = kp * error + ki * accumulated_error - offset = kp * error + ki * accumulated_error
@@ -16,30 +17,48 @@ class PITemperatureRegulator:
- call set_target_temp when the target temperature change. - call set_target_temp when the target temperature change.
""" """
def __init__(self, target_temp: float, kp: float, ki: float, k_ext: float, offset_max: float, stabilization_threshold: float, accumulated_error_threshold: float): def __init__(
self.target_temp:float = target_temp self,
self.kp:float = kp # proportionnel gain target_temp: float,
self.ki:float = ki # integral gain kp: float,
self.k_ext:float = k_ext # exterior gain ki: float,
self.offset_max:float = offset_max k_ext: float,
self.stabilization_threshold:float = stabilization_threshold offset_max: float,
self.accumulated_error:float = 0 stabilization_threshold: float,
self.accumulated_error_threshold:float = accumulated_error_threshold accumulated_error_threshold: float,
):
self.target_temp: float = target_temp
self.kp: float = kp # proportionnel gain
self.ki: float = ki # integral gain
self.k_ext: float = k_ext # exterior gain
self.offset_max: float = offset_max
self.stabilization_threshold: float = stabilization_threshold
self.accumulated_error: float = 0
self.accumulated_error_threshold: float = accumulated_error_threshold
def reset_accumulated_error(self): def reset_accumulated_error(self):
""" Reset the accumulated error """ """Reset the accumulated error"""
self.accumulated_error = 0 self.accumulated_error = 0
def set_target_temp(self, target_temp): def set_target_temp(self, target_temp):
""" Set the new target_temp""" """Set the new target_temp"""
self.target_temp = target_temp self.target_temp = target_temp
# Do not reset the accumulated error # Do not reset the accumulated error
# self.accumulated_error = 0 # self.accumulated_error = 0
def calculate_regulated_temperature(self, internal_temp: float, external_temp:float): # pylint: disable=unused-argument def calculate_regulated_temperature(
""" Calculate a new target_temp given some temperature""" self, internal_temp: float, external_temp: float
if internal_temp is None or external_temp is None: ): # pylint: disable=unused-argument
_LOGGER.warning("Internal_temp or external_temp are not set. Regulation will be suspended") """Calculate a new target_temp given some temperature"""
if internal_temp is None:
_LOGGER.warning(
"Temporarily skipping the self-regulation algorithm while the configured sensor for room temperature is unavailable"
)
return self.target_temp
if external_temp is None:
_LOGGER.warning(
"Temporarily skipping the self-regulation algorithm while the configured sensor for outdoor temperature is unavailable"
)
return self.target_temp return self.target_temp
# Calculate the error factor (P) # Calculate the error factor (P)
@@ -49,7 +68,10 @@ class PITemperatureRegulator:
self.accumulated_error += error self.accumulated_error += error
# Capping of the error # Capping of the error
self.accumulated_error = min(self.accumulated_error_threshold, max(-self.accumulated_error_threshold, self.accumulated_error)) self.accumulated_error = min(
self.accumulated_error_threshold,
max(-self.accumulated_error_threshold, self.accumulated_error),
)
# Calculate the offset (proportionnel + intégral) # Calculate the offset (proportionnel + intégral)
offset = self.kp * error + self.ki * self.accumulated_error offset = self.kp * error + self.ki * self.accumulated_error
@@ -62,7 +84,6 @@ class PITemperatureRegulator:
total_offset = offset + offset_ext total_offset = offset + offset_ext
total_offset = min(self.offset_max, max(-self.offset_max, total_offset)) total_offset = min(self.offset_max, max(-self.offset_max, total_offset))
# If temperature is near the target_temp, reset the accumulated_error # If temperature is near the target_temp, reset the accumulated_error
if abs(error) < self.stabilization_threshold: if abs(error) < self.stabilization_threshold:
_LOGGER.debug("Stabilisation") _LOGGER.debug("Stabilisation")
@@ -70,7 +91,14 @@ class PITemperatureRegulator:
result = round(self.target_temp + total_offset, 1) result = round(self.target_temp + total_offset, 1)
_LOGGER.debug("PITemperatureRegulator - Error: %.2f accumulated_error: %.2f offset: %.2f offset_ext: %.2f target_tem: %.1f regulatedTemp: %.1f", _LOGGER.debug(
error, self.accumulated_error, offset, offset_ext, self.target_temp, result) "PITemperatureRegulator - Error: %.2f accumulated_error: %.2f offset: %.2f offset_ext: %.2f target_tem: %.1f regulatedTemp: %.1f",
error,
self.accumulated_error,
offset,
offset_ext,
self.target_temp,
result,
)
return result return result