ESPHome  2023.5.5
pid_climate.h
Go to the documentation of this file.
1 #pragma once
2 
4 #include "esphome/core/helpers.h"
9 #include "pid_controller.h"
10 #include "pid_autotuner.h"
11 
12 namespace esphome {
13 namespace pid {
14 
15 class PIDClimate : public climate::Climate, public Component {
16  public:
17  PIDClimate() = default;
18  void setup() override;
19  void dump_config() override;
20 
21  void set_sensor(sensor::Sensor *sensor) { sensor_ = sensor; }
22  void set_cool_output(output::FloatOutput *cool_output) { cool_output_ = cool_output; }
23  void set_heat_output(output::FloatOutput *heat_output) { heat_output_ = heat_output; }
24  void set_kp(float kp) { controller_.kp_ = kp; }
25  void set_ki(float ki) { controller_.ki_ = ki; }
26  void set_kd(float kd) { controller_.kd_ = kd; }
27  void set_min_integral(float min_integral) { controller_.min_integral_ = min_integral; }
28  void set_max_integral(float max_integral) { controller_.max_integral_ = max_integral; }
29  void set_output_samples(int in) { controller_.output_samples_ = in; }
30  void set_derivative_samples(int in) { controller_.derivative_samples_ = in; }
31 
32  void set_threshold_low(float in) { controller_.threshold_low_ = in; }
33  void set_threshold_high(float in) { controller_.threshold_high_ = in; }
34  void set_kp_multiplier(float in) { controller_.kp_multiplier_ = in; }
35  void set_ki_multiplier(float in) { controller_.ki_multiplier_ = in; }
36  void set_kd_multiplier(float in) { controller_.kd_multiplier_ = in; }
38 
39  void set_deadband_output_samples(int in) { controller_.deadband_output_samples_ = in; }
40 
41  float get_output_value() const { return output_value_; }
42  float get_error_value() const { return controller_.error_; }
43  float get_kp() { return controller_.kp_; }
44  float get_ki() { return controller_.ki_; }
45  float get_kd() { return controller_.kd_; }
46  float get_proportional_term() const { return controller_.proportional_term_; }
47  float get_integral_term() const { return controller_.integral_term_; }
48  float get_derivative_term() const { return controller_.derivative_term_; }
49  int get_output_samples() { return controller_.output_samples_; }
50  int get_derivative_samples() { return controller_.derivative_samples_; }
51 
52  float get_threshold_low() { return controller_.threshold_low_; }
53  float get_threshold_high() { return controller_.threshold_high_; }
54  float get_kp_multiplier() { return controller_.kp_multiplier_; }
55  float get_ki_multiplier() { return controller_.ki_multiplier_; }
56  float get_kd_multiplier() { return controller_.kd_multiplier_; }
57  int get_deadband_output_samples() { return controller_.deadband_output_samples_; }
58  bool in_deadband() { return controller_.in_deadband(); }
59 
60  // int get_derivative_samples() const { return controller_.derivative_samples; }
61  // float get_deadband() const { return controller_.deadband; }
62  // float get_proportional_deadband_multiplier() const { return controller_.proportional_deadband_multiplier; }
63 
64  void add_on_pid_computed_callback(std::function<void()> &&callback) {
65  pid_computed_callback_.add(std::move(callback));
66  }
67  void set_default_target_temperature(float default_target_temperature) {
68  default_target_temperature_ = default_target_temperature;
69  }
70  void start_autotune(std::unique_ptr<PIDAutotuner> &&autotune);
71  void reset_integral_term();
72 
73  protected:
75  void control(const climate::ClimateCall &call) override;
77  climate::ClimateTraits traits() override;
78 
79  void update_pid_();
80 
81  bool supports_cool_() const { return this->cool_output_ != nullptr; }
82  bool supports_heat_() const { return this->heat_output_ != nullptr; }
83 
84  void write_output_(float value);
85 
95  std::unique_ptr<PIDAutotuner> autotuner_;
96  bool do_publish_ = false;
97 };
98 
99 template<typename... Ts> class PIDAutotuneAction : public Action<Ts...> {
100  public:
101  PIDAutotuneAction(PIDClimate *parent) : parent_(parent) {}
102 
103  void set_noiseband(float noiseband) { noiseband_ = noiseband; }
104  void set_positive_output(float positive_output) { positive_output_ = positive_output; }
105  void set_negative_output(float negative_output) { negative_output_ = negative_output; }
106 
107  void play(Ts... x) {
108  auto tuner = make_unique<PIDAutotuner>();
109  tuner->set_noiseband(this->noiseband_);
110  tuner->set_output_negative(this->negative_output_);
111  tuner->set_output_positive(this->positive_output_);
112  this->parent_->start_autotune(std::move(tuner));
113  }
114 
115  protected:
116  float noiseband_;
120 };
121 
122 template<typename... Ts> class PIDResetIntegralTermAction : public Action<Ts...> {
123  public:
124  PIDResetIntegralTermAction(PIDClimate *parent) : parent_(parent) {}
125 
126  void play(Ts... x) { this->parent_->reset_integral_term(); }
127 
128  protected:
130 };
131 
132 template<typename... Ts> class PIDSetControlParametersAction : public Action<Ts...> {
133  public:
134  PIDSetControlParametersAction(PIDClimate *parent) : parent_(parent) {}
135 
136  void play(Ts... x) {
137  auto kp = this->kp_.value(x...);
138  auto ki = this->ki_.value(x...);
139  auto kd = this->kd_.value(x...);
140 
141  this->parent_->set_kp(kp);
142  this->parent_->set_ki(ki);
143  this->parent_->set_kd(kd);
144  }
145 
146  protected:
147  TEMPLATABLE_VALUE(float, kp)
148  TEMPLATABLE_VALUE(float, ki)
149  TEMPLATABLE_VALUE(float, kd)
150 
151  PIDClimate *parent_;
152 };
153 
154 } // namespace pid
155 } // namespace esphome
float get_integral_term() const
Definition: pid_climate.h:47
This class is used to encode all control actions on a climate device.
Definition: climate.h:33
void add_on_pid_computed_callback(std::function< void()> &&callback)
Definition: pid_climate.h:64
output::FloatOutput * cool_output_
Definition: pid_climate.h:88
bool supports_cool_() const
Definition: pid_climate.h:81
void set_kp_multiplier(float in)
Definition: pid_climate.h:34
void set_threshold_low(float in)
Definition: pid_climate.h:32
void set_cool_output(output::FloatOutput *cool_output)
Definition: pid_climate.h:22
void write_output_(float value)
Definition: pid_climate.cpp:80
void set_default_target_temperature(float default_target_temperature)
Definition: pid_climate.h:67
void setup() override
Definition: pid_climate.cpp:9
Base class for all output components that can output a variable level, like PWM.
Definition: float_output.h:31
This class contains all static data for climate devices.
void set_output_samples(int in)
Definition: pid_climate.h:29
void set_heat_output(output::FloatOutput *heat_output)
Definition: pid_climate.h:23
void set_negative_output(float negative_output)
Definition: pid_climate.h:105
void set_kd_multiplier(float in)
Definition: pid_climate.h:36
void set_positive_output(float positive_output)
Definition: pid_climate.h:104
void start_autotune(std::unique_ptr< PIDAutotuner > &&autotune)
void set_deadband_output_samples(int in)
Definition: pid_climate.h:39
void set_ki(float ki)
Definition: pid_climate.h:25
std::unique_ptr< PIDAutotuner > autotuner_
Definition: pid_climate.h:95
void set_starting_integral_term(float in)
Definition: pid_climate.h:37
void set_threshold_high(float in)
Definition: pid_climate.h:33
void set_kd(float kd)
Definition: pid_climate.h:26
float get_error_value() const
Definition: pid_climate.h:42
float get_output_value() const
Definition: pid_climate.h:41
PIDSetControlParametersAction(PIDClimate *parent)
Definition: pid_climate.h:134
float get_derivative_term() const
Definition: pid_climate.h:48
void set_noiseband(float noiseband)
Definition: pid_climate.h:103
void control(const climate::ClimateCall &call) override
Override control to change settings of the climate device.
Definition: pid_climate.cpp:33
void set_max_integral(float max_integral)
Definition: pid_climate.h:28
climate::ClimateTraits traits() override
Return the traits of this controller.
Definition: pid_climate.cpp:45
void set_kp(float kp)
Definition: pid_climate.h:24
void set_starting_integral_term(float in)
sensor::Sensor * sensor_
The sensor used for getting the current temperature.
Definition: pid_climate.h:87
bool supports_heat_() const
Definition: pid_climate.h:82
void dump_config() override
Definition: pid_climate.cpp:61
output::FloatOutput * heat_output_
Definition: pid_climate.h:89
Definition: a4988.cpp:4
void set_ki_multiplier(float in)
Definition: pid_climate.h:35
PIDController controller_
Definition: pid_climate.h:90
PIDResetIntegralTermAction(PIDClimate *parent)
Definition: pid_climate.h:124
void set_derivative_samples(int in)
Definition: pid_climate.h:30
Base-class for all sensors.
Definition: sensor.h:57
void set_min_integral(float min_integral)
Definition: pid_climate.h:27
float get_proportional_term() const
Definition: pid_climate.h:46
float output_value_
Output value as reported by the PID controller, for PIDClimateSensor.
Definition: pid_climate.h:92
CallbackManager< void()> pid_computed_callback_
Definition: pid_climate.h:93
void set_sensor(sensor::Sensor *sensor)
Definition: pid_climate.h:21
ClimateDevice - This is the base class for all climate integrations.
Definition: climate.h:161
PIDAutotuneAction(PIDClimate *parent)
Definition: pid_climate.h:101