PowerBalancerImp.hpp

Go to the documentation of this file.

/*
 * Copyright (c) 2015 - 2024 Intel Corporation
 * SPDX-License-Identifier: BSD-3-Clause
 */
 
#ifndef POWERBALANCERIMP_HPP_INCLUDE
#define POWERBALANCERIMP_HPP_INCLUDE
 
#include <memory>
#include <vector>
 
#include "geopm_time.h"
#include "geopm/PowerBalancer.hpp"
 
namespace geopm
{
    template <typename T> class CircularBuffer;
 
    class PowerBalancerImp : public PowerBalancer
    {
        public:
            PowerBalancerImp(double ctl_latency, double trial_delta, int num_sample, double measure_duration);
            PowerBalancerImp(double ctl_latency);
            virtual ~PowerBalancerImp() = default;
            void power_cap(double cap) override;
            double power_cap(void) const override;
            double power_limit(void) const override;
            void power_limit_adjusted(double limit) override;
            bool is_runtime_stable(double measured_runtime) override;
            double runtime_sample(void) const override;
            void calculate_runtime_sample(void) override;
            void target_runtime(double largest_runtime) override;
            bool is_target_met(double measured_runtime) override;
            double power_slack(void) override;
        private:
            bool is_limit_stable(void);
 
            const double M_CONTROL_LATENCY;
            const double M_MIN_TRIAL_DELTA;
            const int M_MIN_NUM_SAMPLE;
            const double M_MIN_DURATION;
            const double M_RUNTIME_FRACTION;
            int m_num_sample;
            // @brief Maximum power as set in last global budget
            //        increase.
            double m_power_cap;
            // @brief Current power limit to get to target runtime
            //        which may be lower than the cap.
            double m_power_limit;
            struct geopm_time_s m_power_limit_change_time;
            double m_target_runtime;
            double m_trial_delta;
            double m_runtime_sample;
            bool m_is_target_met;
            std::unique_ptr<CircularBuffer<double> > m_runtime_buffer;
            std::vector<double> m_runtime_vec;
    };
}
 
#endif