pid_controller.h

Go to the documentation of this file.

#pragma once
#include "esphome/core/hal.h"
#include <deque>
#include <cmath>
 
namespace esphome {
namespace pid {
 
struct PIDController {
  float update(float setpoint, float process_value);
 
  void reset_accumulated_integral() { accumulated_integral_ = 0; }
  void set_starting_integral_term(float in) { accumulated_integral_ = in; }
 
  bool in_deadband();
 
  friend class PIDClimate;
 
 private:
  float kp_ = 0;
  float ki_ = 0;
  float kd_ = 0;
 
  // smooth the derivative value using a weighted average over X samples
  int derivative_samples_ = 8;
 
  int output_samples_ = 1;
 
  float threshold_low_ = 0.0f;
  float threshold_high_ = 0.0f;
  float kp_multiplier_ = 0.0f;
  float ki_multiplier_ = 0.0f;
  float kd_multiplier_ = 0.0f;
  int deadband_output_samples_ = 1;
 
  float min_integral_ = NAN;
  float max_integral_ = NAN;
 
  // Store computed values in struct so that values can be monitored through sensors
  float error_;
  float dt_;
  float proportional_term_;
  float integral_term_;
  float derivative_term_;
 
  void calculate_proportional_term_();
  void calculate_integral_term_();
  void calculate_derivative_term_(float setpoint);
  float weighted_average_(std::deque<float> &list, float new_value, int samples);
  float calculate_relative_time_();
 
  float previous_error_ = 0;
  float previous_setpoint_ = NAN;
  float accumulated_integral_ = 0;
  uint32_t last_time_ = 0;
 
  // this is a list of derivative values for smoothing.
  std::deque<float> derivative_list_;
 
  // this is a list of output values for smoothing.
  std::deque<float> output_list_;
 
};  // Struct PID Controller
}  // namespace pid
}  // namespace esphome