#include "pid_climate.h" #include "esphome/core/log.h" namespace esphome { namespace pid { static const char *const TAG = "pid.climate"; void PIDClimate::setup() { this->sensor_->add_on_state_callback([this](float state) { // only publish if state/current temperature has changed in two digits of precision this->do_publish_ = roundf(state * 100) != roundf(this->current_temperature * 100); this->current_temperature = state; this->update_pid_(); }); this->current_temperature = this->sensor_->state; // restore set points auto restore = this->restore_state_(); if (restore.has_value()) { restore->to_call(this).perform(); } else { // restore from defaults, change_away handles those for us if (supports_heat_() && supports_cool_()) this->mode = climate::CLIMATE_MODE_HEAT_COOL; else if (supports_cool_()) this->mode = climate::CLIMATE_MODE_COOL; else if (supports_heat_()) this->mode = climate::CLIMATE_MODE_HEAT; this->target_temperature = this->default_target_temperature_; } } void PIDClimate::control(const climate::ClimateCall &call) { if (call.get_mode().has_value()) this->mode = *call.get_mode(); if (call.get_target_temperature().has_value()) this->target_temperature = *call.get_target_temperature(); // If switching to off mode, set output immediately if (this->mode == climate::CLIMATE_MODE_OFF) this->write_output_(0.0f); this->publish_state(); } climate::ClimateTraits PIDClimate::traits() { auto traits = climate::ClimateTraits(); traits.set_supports_current_temperature(true); traits.set_supports_two_point_target_temperature(false); traits.set_supported_modes({climate::CLIMATE_MODE_OFF}); if (supports_cool_()) traits.add_supported_mode(climate::CLIMATE_MODE_COOL); if (supports_heat_()) traits.add_supported_mode(climate::CLIMATE_MODE_HEAT); if (supports_heat_() && supports_cool_()) traits.add_supported_mode(climate::CLIMATE_MODE_HEAT_COOL); traits.set_supports_action(true); return traits; } void PIDClimate::dump_config() { LOG_CLIMATE("", "PID Climate", this); ESP_LOGCONFIG(TAG, " Control Parameters:"); ESP_LOGCONFIG(TAG, " kp: %.5f, ki: %.5f, kd: %.5f", controller_.kp, controller_.ki, controller_.kd); if (this->autotuner_ != nullptr) { this->autotuner_->dump_config(); } } void PIDClimate::write_output_(float value) { this->output_value_ = value; // first ensure outputs are off (both outputs not active at the same time) if (this->supports_cool_() && value >= 0) this->cool_output_->set_level(0.0f); if (this->supports_heat_() && value <= 0) this->heat_output_->set_level(0.0f); // value < 0 means cool, > 0 means heat if (this->supports_cool_() && value < 0) this->cool_output_->set_level(std::min(1.0f, -value)); if (this->supports_heat_() && value > 0) this->heat_output_->set_level(std::min(1.0f, value)); // Update action variable for user feedback what's happening climate::ClimateAction new_action; if (this->supports_cool_() && value < 0) new_action = climate::CLIMATE_ACTION_COOLING; else if (this->supports_heat_() && value > 0) new_action = climate::CLIMATE_ACTION_HEATING; else if (this->mode == climate::CLIMATE_MODE_OFF) new_action = climate::CLIMATE_ACTION_OFF; else new_action = climate::CLIMATE_ACTION_IDLE; if (new_action != this->action) { this->action = new_action; this->do_publish_ = true; } this->pid_computed_callback_.call(); } void PIDClimate::update_pid_() { float value; if (std::isnan(this->current_temperature) || std::isnan(this->target_temperature)) { // if any control parameters are nan, turn off all outputs value = 0.0; } else { // Update PID controller irrespective of current mode, to not mess up D/I terms // In non-auto mode, we just discard the output value value = this->controller_.update(this->target_temperature, this->current_temperature); // Check autotuner if (this->autotuner_ != nullptr && !this->autotuner_->is_finished()) { auto res = this->autotuner_->update(this->target_temperature, this->current_temperature); if (res.result_params.has_value()) { this->controller_.kp = res.result_params->kp; this->controller_.ki = res.result_params->ki; this->controller_.kd = res.result_params->kd; // keep autotuner instance so that subsequent dump_configs will print the long result message. } else { value = res.output; if (mode != climate::CLIMATE_MODE_HEAT_COOL) { ESP_LOGW(TAG, "For PID autotuner you need to set AUTO (also called heat/cool) mode!"); } } } } if (this->mode == climate::CLIMATE_MODE_OFF) { this->write_output_(0.0); } else { this->write_output_(value); } if (this->do_publish_) this->publish_state(); } void PIDClimate::start_autotune(std::unique_ptr &&autotune) { this->autotuner_ = std::move(autotune); float min_value = this->supports_cool_() ? -1.0f : 0.0f; float max_value = this->supports_heat_() ? 1.0f : 0.0f; this->autotuner_->config(min_value, max_value); this->set_interval("autotune-progress", 10000, [this]() { if (this->autotuner_ != nullptr && !this->autotuner_->is_finished()) this->autotuner_->dump_config(); }); } void PIDClimate::reset_integral_term() { this->controller_.reset_accumulated_integral(); } } // namespace pid } // namespace esphome