gem5  v21.1.0.2
q_policy.hh
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2018 ARM Limited
3  * All rights reserved
4  *
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.
13  *
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.
24  *
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.
36  */
37 
38 #ifndef __MEM_QOS_Q_POLICY_HH__
39 #define __MEM_QOS_Q_POLICY_HH__
40 
41 #include <deque>
42 #include <list>
43 #include <unordered_set>
44 
45 #include "base/compiler.hh"
46 #include "mem/packet.hh"
47 #include "mem/qos/mem_ctrl.hh"
48 #include "params/QoSMemCtrl.hh"
49 
50 namespace gem5
51 {
52 
53 namespace memory
54 {
55 
57 namespace qos
58 {
59 
67 {
68  public:
70 
80  static QueuePolicy* create(const QoSMemCtrlParams &p);
81 
90  virtual void enqueuePacket(PacketPtr pkt) {};
91 
101  virtual PacketQueue::iterator selectPacket(PacketQueue* queue) = 0;
102 
108 
109  virtual ~QueuePolicy() {};
110 
111  protected:
112  QueuePolicy(const QoSMemCtrlParams &p)
113  : memCtrl(nullptr)
114  {}
115 
118 };
119 
122 {
123  public:
124  LifoQueuePolicy(const QoSMemCtrlParams &p)
125  : QueuePolicy(p)
126  {}
127 
134  PacketQueue::iterator
135  selectPacket(PacketQueue* queue) override
136  {
137  return queue->end();
138  }
139 };
140 
143 {
144  public:
145  FifoQueuePolicy(const QoSMemCtrlParams &p)
146  : QueuePolicy(p)
147  {}
148 
155  PacketQueue::iterator
156  selectPacket(PacketQueue* queue) override
157  {
158  return queue->begin();
159  }
160 };
161 
169 {
170  public:
171  LrgQueuePolicy(const QoSMemCtrlParams &p)
172  : QueuePolicy(p)
173  {}
174 
175  void enqueuePacket(PacketPtr pkt) override;
176 
183  PacketQueue::iterator
184  selectPacket(PacketQueue* queue) override;
185 
186  protected:
193 };
194 
195 } // namespace qos
196 } // namespace memory
197 } // namespace gem5
198 
199 #endif /* __MEM_QOS_Q_POLICY_HH__ */
gem5::memory::qos::LrgQueuePolicy::LrgQueuePolicy
LrgQueuePolicy(const QoSMemCtrlParams &p)
Definition: q_policy.hh:171
gem5::memory::qos::FifoQueuePolicy::FifoQueuePolicy
FifoQueuePolicy(const QoSMemCtrlParams &p)
Definition: q_policy.hh:145
memory
Definition: mem.h:38
gem5::memory::qos::LrgQueuePolicy::selectPacket
PacketQueue::iterator selectPacket(PacketQueue *queue) override
Implements LRG packet select policy.
Definition: q_policy.cc:74
gem5::memory::qos::FifoQueuePolicy::selectPacket
PacketQueue::iterator selectPacket(PacketQueue *queue) override
Implements FCFS packet select policy.
Definition: q_policy.hh:156
gem5::memory::qos::QueuePolicy
QoS Queue Policy.
Definition: q_policy.hh:66
gem5::memory::qos::QueuePolicy::create
static QueuePolicy * create(const QoSMemCtrlParams &p)
This factory method is used for generating the queue policy.
Definition: q_policy.cc:60
gem5::memory::GEM5_DEPRECATED_NAMESPACE
GEM5_DEPRECATED_NAMESPACE(QoS, qos)
gem5::memory::qos::QueuePolicy::~QueuePolicy
virtual ~QueuePolicy()
Definition: q_policy.hh:109
gem5::memory::qos::LifoQueuePolicy
Last In First Out Queue Policy.
Definition: q_policy.hh:121
gem5::memory::qos::FifoQueuePolicy
First In First Out Queue Policy.
Definition: q_policy.hh:142
packet.hh
gem5::memory::qos::QueuePolicy::PacketQueue
std::deque< PacketPtr > PacketQueue
Definition: q_policy.hh:69
gem5::Packet
A Packet is used to encapsulate a transfer between two objects in the memory system (e....
Definition: packet.hh:283
gem5::MipsISA::p
Bitfield< 0 > p
Definition: pra_constants.hh:326
gem5::memory::qos::QueuePolicy::memCtrl
MemCtrl * memCtrl
Pointer to parent memory controller implementing the policy.
Definition: q_policy.hh:117
gem5::memory::qos::LrgQueuePolicy
Least Recently Granted Queue Policy It selects packets from the queue with a round robin-like policy:...
Definition: q_policy.hh:168
gem5::PacketQueue
A packet queue is a class that holds deferred packets and later sends them using the associated CPU-s...
Definition: packet_queue.hh:65
compiler.hh
gem5::memory::qos::LrgQueuePolicy::enqueuePacket
void enqueuePacket(PacketPtr pkt) override
This method is called by the memory controller after it enqueues a packet.
Definition: q_policy.cc:147
gem5::memory::qos::QueuePolicy::selectPacket
virtual PacketQueue::iterator selectPacket(PacketQueue *queue)=0
Policy selector.
gem5::memory::qos::QueuePolicy::QueuePolicy
QueuePolicy(const QoSMemCtrlParams &p)
Definition: q_policy.hh:112
mem_ctrl.hh
std::deque
STL deque class.
Definition: stl.hh:44
gem5::memory::qos::LifoQueuePolicy::LifoQueuePolicy
LifoQueuePolicy(const QoSMemCtrlParams &p)
Definition: q_policy.hh:124
gem5::memory::qos::QueuePolicy::enqueuePacket
virtual void enqueuePacket(PacketPtr pkt)
This method is called by the memory controller after it enqueues a packet.
Definition: q_policy.hh:90
mem
bool_vector8 mem[]
Definition: reset_stim.h:43
gem5::memory::qos::MemCtrl
The qos::MemCtrl is a base class for Memory objects which support QoS - it provides access to a set o...
Definition: mem_ctrl.hh:80
std::list< RequestorID >
gem5
Reference material can be found at the JEDEC website: UFS standard http://www.jedec....
Definition: decoder.cc:40
gem5::memory::qos::LrgQueuePolicy::toServe
std::list< RequestorID > toServe
Support structure for lrg algorithms: keeps track of serviced requestors, always serve the front elem...
Definition: q_policy.hh:192
gem5::memory::qos::LifoQueuePolicy::selectPacket
PacketQueue::iterator selectPacket(PacketQueue *queue) override
Implements LIFO packet select policy.
Definition: q_policy.hh:135
gem5::memory::qos::QueuePolicy::setMemCtrl
void setMemCtrl(MemCtrl *mem)
Setting a pointer to the Memory Controller implementing the policy.
Definition: q_policy.hh:107

Generated on Tue Sep 21 2021 12:25:34 for gem5 by doxygen 1.8.17