gem5  v21.1.0.2
qport.hh
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2012,2015 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_QPORT_HH__
39 #define __MEM_QPORT_HH__
40 
46 #include "mem/packet_queue.hh"
47 #include "mem/port.hh"
48 #include "sim/sim_object.hh"
49 
50 namespace gem5
51 {
52 
62 {
63 
64  protected:
65 
68 
70 
71  public:
72 
80  QueuedResponsePort(const std::string& name, SimObject* owner,
81  RespPacketQueue &resp_queue, PortID id = InvalidPortID) :
82  ResponsePort(name, owner, id), respQueue(resp_queue)
83  { }
84 
85  virtual ~QueuedResponsePort() { }
86 
93  void schedTimingResp(PacketPtr pkt, Tick when)
94  { respQueue.schedSendTiming(pkt, when); }
95 
99  { return respQueue.trySatisfyFunctional(pkt); }
100 };
101 
110 {
111 
112  protected:
113 
116 
119 
121 
123 
124  public:
125 
133  QueuedRequestPort(const std::string& name, SimObject* owner,
134  ReqPacketQueue &req_queue,
135  SnoopRespPacketQueue &snoop_resp_queue,
136  PortID id = InvalidPortID) :
137  RequestPort(name, owner, id), reqQueue(req_queue),
138  snoopRespQueue(snoop_resp_queue)
139  { }
140 
141  virtual ~QueuedRequestPort() { }
142 
149  void schedTimingReq(PacketPtr pkt, Tick when)
150  { reqQueue.schedSendTiming(pkt, when); }
151 
159  { snoopRespQueue.schedSendTiming(pkt, when); }
160 
164  {
165  return reqQueue.trySatisfyFunctional(pkt) ||
167  }
168 };
169 
170 } // namespace gem5
171 
172 #endif // __MEM_QPORT_HH__
gem5::PortID
int16_t PortID
Port index/ID type, and a symbolic name for an invalid port id.
Definition: types.hh:252
gem5::QueuedRequestPort::QueuedRequestPort
QueuedRequestPort(const std::string &name, SimObject *owner, ReqPacketQueue &req_queue, SnoopRespPacketQueue &snoop_resp_queue, PortID id=InvalidPortID)
Create a QueuedPort with a given name, owner, and a supplied implementation of two packet queues.
Definition: qport.hh:133
gem5::Port::name
const std::string name() const
Return port name (for DPRINTF).
Definition: port.hh:111
gem5::RespPacketQueue
Definition: packet_queue.hh:300
gem5::QueuedRequestPort
The QueuedRequestPort combines two queues, a request queue and a snoop response queue,...
Definition: qport.hh:109
gem5::QueuedResponsePort::~QueuedResponsePort
virtual ~QueuedResponsePort()
Definition: qport.hh:85
gem5::Port::id
const PortID id
A numeric identifier to distinguish ports in a vector, and set to InvalidPortID in case this port is ...
Definition: port.hh:79
gem5::QueuedResponsePort::recvRespRetry
void recvRespRetry()
Called by the peer if sendTimingResp was called on this protocol (causing recvTimingResp to be called...
Definition: qport.hh:69
gem5::PacketQueue::retry
void retry()
Retry sending a packet from the queue.
Definition: packet_queue.cc:66
gem5::QueuedResponsePort::respQueue
RespPacketQueue & respQueue
Packet queue used to store outgoing responses.
Definition: qport.hh:67
gem5::InvalidPortID
const PortID InvalidPortID
Definition: types.hh:253
gem5::RequestPort
A RequestPort is a specialisation of a Port, which implements the default protocol for the three diff...
Definition: port.hh:77
gem5::QueuedRequestPort::recvReqRetry
void recvReqRetry()
Called by the peer if sendTimingReq was called on this peer (causing recvTimingReq to be called on th...
Definition: qport.hh:120
gem5::PacketQueue::trySatisfyFunctional
bool trySatisfyFunctional(PacketPtr pkt)
Check the list of buffered packets against the supplied functional request.
Definition: packet_queue.cc:87
sim_object.hh
gem5::QueuedResponsePort
A queued port is a port that has an infinite queue for outgoing packets and thus decouples the module...
Definition: qport.hh:61
gem5::Packet
A Packet is used to encapsulate a transfer between two objects in the memory system (e....
Definition: packet.hh:283
gem5::QueuedRequestPort::reqQueue
ReqPacketQueue & reqQueue
Packet queue used to store outgoing requests.
Definition: qport.hh:115
gem5::Tick
uint64_t Tick
Tick count type.
Definition: types.hh:58
packet_queue.hh
port.hh
gem5::QueuedRequestPort::~QueuedRequestPort
virtual ~QueuedRequestPort()
Definition: qport.hh:141
gem5::SimObject
Abstract superclass for simulation objects.
Definition: sim_object.hh:146
gem5::QueuedResponsePort::QueuedResponsePort
QueuedResponsePort(const std::string &name, SimObject *owner, RespPacketQueue &resp_queue, PortID id=InvalidPortID)
Create a QueuedPort with a given name, owner, and a supplied implementation of a packet queue.
Definition: qport.hh:80
gem5::ResponsePort
A ResponsePort is a specialization of a port.
Definition: port.hh:268
gem5::ResponsePort::owner
SimObject & owner
Definition: port.hh:279
gem5::QueuedRequestPort::snoopRespQueue
SnoopRespPacketQueue & snoopRespQueue
Packet queue used to store outgoing snoop responses.
Definition: qport.hh:118
gem5::PacketQueue::schedSendTiming
void schedSendTiming(PacketPtr pkt, Tick when)
Add a packet to the transmit list, and schedule a send event.
Definition: packet_queue.cc:107
gem5::QueuedResponsePort::trySatisfyFunctional
bool trySatisfyFunctional(PacketPtr pkt)
Check the list of buffered packets against the supplied functional request.
Definition: qport.hh:98
gem5::QueuedRequestPort::trySatisfyFunctional
bool trySatisfyFunctional(PacketPtr pkt)
Check the list of buffered packets against the supplied functional request.
Definition: qport.hh:163
gem5::ReqPacketQueue
Definition: packet_queue.hh:226
gem5::QueuedRequestPort::schedTimingReq
void schedTimingReq(PacketPtr pkt, Tick when)
Schedule the sending of a timing request.
Definition: qport.hh:149
gem5::QueuedRequestPort::schedTimingSnoopResp
void schedTimingSnoopResp(PacketPtr pkt, Tick when)
Schedule the sending of a timing snoop response.
Definition: qport.hh:158
gem5::SnoopRespPacketQueue
Definition: packet_queue.hh:262
gem5::RequestPort::owner
SimObject & owner
Definition: port.hh:86
gem5::QueuedResponsePort::schedTimingResp
void schedTimingResp(PacketPtr pkt, Tick when)
Schedule the sending of a timing response.
Definition: qport.hh:93
gem5
Reference material can be found at the JEDEC website: UFS standard http://www.jedec....
Definition: decoder.cc:40
gem5::QueuedRequestPort::recvRetrySnoopResp
void recvRetrySnoopResp()
Called by the peer if sendTimingSnoopResp was called on this protocol (causing recvTimingSnoopResp to...
Definition: qport.hh:122

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