2 * Copyright (c) 2012, 2019 ARM Limited
5 * The license below extends only to copyright in the software and shall
6 * not be construed as granting a license to any other intellectual
7 * property including but not limited to intellectual property relating
8 * to a hardware implementation of the functionality of the software
9 * licensed hereunder. You may use the software subject to the license
10 * terms below provided that you ensure that this notice is replicated
11 * unmodified and in its entirety in all distributions of the software,
12 * modified or unmodified, in source code or in binary form.
14 * Redistribution and use in source and binary forms, with or without
15 * modification, are permitted provided that the following conditions are
16 * met: redistributions of source code must retain the above copyright
17 * notice, this list of conditions and the following disclaimer;
18 * redistributions in binary form must reproduce the above copyright
19 * notice, this list of conditions and the following disclaimer in the
20 * documentation and/or other materials provided with the distribution;
21 * neither the name of the copyright holders nor the names of its
22 * contributors may be used to endorse or promote products derived from
23 * this software without specific prior written permission.
25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
26 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
27 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
28 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
29 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
30 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
31 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
32 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
33 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
34 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
35 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
38 #ifndef __SIM_VOLTAGE_DOMAIN_HH__
39 #define __SIM_VOLTAGE_DOMAIN_HH__
43 #include "base/statistics.hh"
44 #include "params/VoltageDomain.hh"
45 #include "sim/clock_domain.hh"
46 #include "sim/sim_object.hh"
49 * A VoltageDomain is used to group clock domains that operate under
50 * the same voltage. The class provides methods for setting and
51 * getting the voltage.
53 class VoltageDomain : public SimObject
57 typedef VoltageDomainParams Params;
58 VoltageDomain(const Params &p);
60 typedef SrcClockDomain::PerfLevel PerfLevel;
63 * Get the current voltage.
65 * @return Voltage of the domain
67 double voltage() const { return voltageOpPoints[_perfLevel]; }
70 * Get the voltage at specified performance level.
72 * @param perf_level Performance level for which the voltage is requested
73 * @return Voltage of the domain at specified performance level
75 double voltage(PerfLevel perf_level) const
77 chatty_assert(perf_level < numVoltages(), "VoltageDomain %s "\
78 "request for voltage perf level %u is outside "\
79 "of numVoltages %u", name(), perf_level,
81 return voltageOpPoints[perf_level];
84 uint32_t numVoltages() const { return (uint32_t)voltageOpPoints.size(); }
87 * Set the voltage point of the domain.
88 * @param Voltage value to be set
90 void perfLevel(PerfLevel perf_level);
93 * Get the voltage point of the domain.
94 * @param Voltage value to be set
96 PerfLevel perfLevel() const { return _perfLevel; }
99 * Register a SrcClockDomain with this voltage domain.
100 * @param src_clock_domain The SrcClockDomain to register.
102 void registerSrcClockDom(SrcClockDomain *src_clock_dom) {
103 assert(src_clock_dom->voltageDomain() == this);
104 srcClockChildren.push_back(src_clock_dom);
108 * Startup has all SrcClockDomains registered with this voltage domain, so
109 * try to make sure that all perf level requests from them are met.
111 void startup() override;
114 * Recomputes the highest (fastest, i.e., numerically lowest) requested
115 * performance level of all associated clock domains, and updates the
116 * performance level of this voltage domain to match. This means that for
117 * two connected clock domains, one fast and one slow, the voltage domain
118 * will provide the voltage associated with the fast DVFS operation point.
119 * Must be called whenever a clock domain decides to swtich its performance
122 * @return True, if the voltage was actually changed.
124 bool sanitiseVoltages();
126 void serialize(CheckpointOut &cp) const override;
127 void unserialize(CheckpointIn &cp) override;
130 typedef std::vector<double> Voltages;
132 * List of possible minimum voltage at each of the frequency operational
133 * points, should be in descending order and same size as freqOpPoints.
134 * An empty list corresponds to default voltage specified for the voltage
135 * domain its clock domain belongs. The same voltage is applied for each
136 * freqOpPoints, overall implying NO DVS
138 const Voltages voltageOpPoints;
139 PerfLevel _perfLevel;
141 struct VoltageDomainStats : public Stats::Group
143 VoltageDomainStats(VoltageDomain &vd);
146 * Stat for reporting voltage of the domain
148 Stats::Value voltage;
152 * List of associated SrcClockDomains that are connected to this voltage
155 typedef std::vector<SrcClockDomain *> SrcClockChildren;
156 SrcClockChildren srcClockChildren;