geopm 3.1.1.dev453+g1f4a5a13
GEOPM - Global Extensible Open Power Manager
Loading...
Searching...
No Matches
ServiceIOGroup.hpp
Go to the documentation of this file.
1/*
2 * Copyright (c) 2015 - 2024 Intel Corporation
3 * SPDX-License-Identifier: BSD-3-Clause
4 */
5
6#ifndef SERVICEIOGROUP_HPP_INCLUDE
7#define SERVICEIOGROUP_HPP_INCLUDE
8
9#include <map>
10
11#include "geopm/IOGroup.hpp"
12
13struct geopm_request_s;
14
15namespace geopm
16{
17 class PlatformTopo;
18 class ServiceProxy;
19 class BatchClient;
20 struct signal_info_s;
21 struct control_info_s;
22
26 class ServiceIOGroup : public IOGroup
27 {
28 public:
31 std::shared_ptr<ServiceProxy> service_proxy,
32 std::shared_ptr<BatchClient> batch_client_mock);
33 ServiceIOGroup(const ServiceIOGroup &other) = delete;
34 ServiceIOGroup &operator=(const ServiceIOGroup &other) = delete;
35 virtual ~ServiceIOGroup();
36 std::set<std::string> signal_names(void) const override;
37 std::set<std::string> control_names(void) const override;
38 bool is_valid_signal(const std::string &signal_name) const override;
39 bool is_valid_control(const std::string &control_name) const override;
40 int signal_domain_type(const std::string &signal_name) const override;
41 int control_domain_type(const std::string &control_name) const override;
42 int push_signal(const std::string &signal_name,
43 int domain_type,
44 int domain_idx) override;
45 int push_control(const std::string &control_name,
46 int domain_type,
47 int domain_idx) override;
48 void read_batch(void) override;
49 void write_batch(void) override;
50 double sample(int sample_idx) override;
51 void adjust(int control_idx,
52 double setting) override;
53 double read_signal(const std::string &signal_name,
54 int domain_type,
55 int domain_idx) override;
56 void write_control(const std::string &control_name,
57 int domain_type,
58 int domain_idx,
59 double setting) override;
60 // NOTE: This IOGroup will not directly implement a
61 // save/restore since it is a proxy. Creating this
62 // IOGroup will start a session with the service,
63 // and save and restore will be managed by the
64 // geopmd service for every session that is opened.
65 void save_control(void) override;
66 void restore_control(void) override;
67 std::function<double(const std::vector<double> &)> agg_function(const std::string &signal_name) const override;
68 std::function<std::string(double)> format_function(const std::string &signal_name) const override;
69 std::string signal_description(const std::string &signal_name) const override;
70 std::string control_description(const std::string &control_name) const override;
71 int signal_behavior(const std::string &signal_name) const override;
72 void save_control(const std::string &save_path) override;
73 void restore_control(const std::string &save_path) override;
74 std::string name(void) const override;
75 static std::string plugin_name(void);
76 static std::unique_ptr<IOGroup> make_plugin(void);
77 private:
78 void init_batch_server(void);
79 static const std::string M_PLUGIN_NAME;
80 static std::map<std::string, signal_info_s> service_signal_info(std::shared_ptr<ServiceProxy> service_proxy);
81 static std::map<std::string, control_info_s> service_control_info(std::shared_ptr<ServiceProxy> service_proxy);
82 static std::string strip_plugin_name(const std::string &name);
83 const PlatformTopo &m_platform_topo;
84 std::shared_ptr<ServiceProxy> m_service_proxy;
85 std::map<std::string, signal_info_s> m_signal_info;
86 std::map<std::string, control_info_s> m_control_info;
87 std::vector<geopm_request_s> m_signal_requests;
88 std::vector<geopm_request_s> m_control_requests;
89 std::shared_ptr<BatchClient> m_batch_client;
90 std::vector<double> m_batch_samples;
91 std::vector<double> m_batch_settings;
92 int m_session_pid;
93 bool m_is_batch_active;
94 };
95}
96
97#endif
Definition IOGroup.hpp:21
Definition PlatformTopo.hpp:28
IOGroup that uses DBus interface to access geopmd provided signals and controls. This IOGroup is not ...
Definition ServiceIOGroup.hpp:27
void write_control(const std::string &control_name, int domain_type, int domain_idx, double setting) override
Interpret the setting and write setting to the platform. Does not modify the values stored by calling...
Definition ServiceIOGroup.cpp:273
void write_batch(void) override
Write all of the pushed controls so that values previously given to adjust() are written to the platf...
Definition ServiceIOGroup.cpp:212
std::function< std::string(double)> format_function(const std::string &signal_name) const override
Returns a function that can be used to convert a signal of the given name into a printable string....
Definition ServiceIOGroup.cpp:317
bool is_valid_signal(const std::string &signal_name) const override
Test if signal_name refers to a signal supported by the group.
Definition ServiceIOGroup.cpp:111
void adjust(int control_idx, double setting) override
Adjust a setting for a particular control that was previously pushed with push_control()....
Definition ServiceIOGroup.cpp:237
virtual ~ServiceIOGroup()
Definition ServiceIOGroup.cpp:48
std::set< std::string > control_names(void) const override
Returns the names of all controls provided by the IOGroup.
Definition ServiceIOGroup.cpp:102
double read_signal(const std::string &signal_name, int domain_type, int domain_idx) override
Read from platform and interpret into SI units a signal given its name and domain....
Definition ServiceIOGroup.cpp:252
void read_batch(void) override
Read all pushed signals from the platform so that the next call to sample() will reflect the updated ...
Definition ServiceIOGroup.cpp:203
void restore_control(void) override
Restore all controls to values recorded in previous call to the save() method.
Definition ServiceIOGroup.cpp:301
int push_signal(const std::string &signal_name, int domain_type, int domain_idx) override
Add a signal to the list of signals that is read by read_batch() and sampled by sample().
Definition ServiceIOGroup.cpp:141
bool is_valid_control(const std::string &control_name) const override
Test if control_name refers to a control supported by the group.
Definition ServiceIOGroup.cpp:116
ServiceIOGroup & operator=(const ServiceIOGroup &other)=delete
ServiceIOGroup()
Definition ServiceIOGroup.cpp:25
int signal_domain_type(const std::string &signal_name) const override
Query the domain for a named signal.
Definition ServiceIOGroup.cpp:121
ServiceIOGroup(const ServiceIOGroup &other)=delete
int push_control(const std::string &control_name, int domain_type, int domain_idx) override
Add a control to the list of controls that is written by write_batch() and configured with adjust().
Definition ServiceIOGroup.cpp:172
int signal_behavior(const std::string &signal_name) const override
Returns a hint about how a signal will change as a function of time.
Definition ServiceIOGroup.cpp:350
int control_domain_type(const std::string &control_name) const override
Query the domain for a named control.
Definition ServiceIOGroup.cpp:131
static std::string plugin_name(void)
Definition ServiceIOGroup.cpp:410
std::function< double(const std::vector< double > &)> agg_function(const std::string &signal_name) const override
Return a function that should be used when aggregating the given signal.
Definition ServiceIOGroup.cpp:306
std::string control_description(const std::string &control_name) const override
Returns a description of the control. This string can be used by tools to generate help text for user...
Definition ServiceIOGroup.cpp:339
std::string name(void) const override
Get the IOGroup name.
Definition ServiceIOGroup.cpp:405
void save_control(void) override
Save the state of all controls so that any subsequent changes made through the IOGroup can be undone ...
Definition ServiceIOGroup.cpp:295
std::set< std::string > signal_names(void) const override
Returns the names of all signals provided by the IOGroup.
Definition ServiceIOGroup.cpp:93
static std::unique_ptr< IOGroup > make_plugin(void)
Definition ServiceIOGroup.cpp:415
double sample(int sample_idx) override
Retrieve signal value from data read by last call to read_batch() for a particular signal previously ...
Definition ServiceIOGroup.cpp:220
std::string signal_description(const std::string &signal_name) const override
Returns a description of the signal. This string can be used by tools to generate help text for users...
Definition ServiceIOGroup.cpp:328
Definition Agg.cpp:20
const PlatformTopo & platform_topo(void)
Definition PlatformTopo.cpp:81
Definition geopm_pio.h:387