gem5  v20.1.0.0
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 
59 {
60 
61  protected:
62 
65 
67 
68  public:
69 
77  QueuedResponsePort(const std::string& name, SimObject* owner,
78  RespPacketQueue &resp_queue, PortID id = InvalidPortID) :
79  ResponsePort(name, owner, id), respQueue(resp_queue)
80  { }
81 
82  virtual ~QueuedResponsePort() { }
83 
90  void schedTimingResp(PacketPtr pkt, Tick when)
91  { respQueue.schedSendTiming(pkt, when); }
92 
96  { return respQueue.trySatisfyFunctional(pkt); }
97 };
98 
107 {
108 
109  protected:
110 
113 
116 
118 
120 
121  public:
122 
130  QueuedRequestPort(const std::string& name, SimObject* owner,
131  ReqPacketQueue &req_queue,
132  SnoopRespPacketQueue &snoop_resp_queue,
133  PortID id = InvalidPortID) :
134  RequestPort(name, owner, id), reqQueue(req_queue),
135  snoopRespQueue(snoop_resp_queue)
136  { }
137 
138  virtual ~QueuedRequestPort() { }
139 
146  void schedTimingReq(PacketPtr pkt, Tick when)
147  { reqQueue.schedSendTiming(pkt, when); }
148 
156  { snoopRespQueue.schedSendTiming(pkt, when); }
157 
161  {
162  return reqQueue.trySatisfyFunctional(pkt) ||
164  }
165 };
166 
167 #endif // __MEM_QPORT_HH__
QueuedResponsePort::recvRespRetry
void recvRespRetry()
Called by the peer if sendTimingResp was called on this protocol (causing recvTimingResp to be called...
Definition: qport.hh:66
SnoopRespPacketQueue
Definition: packet_queue.hh:258
ResponsePort
A ResponsePort is a specialization of a port.
Definition: port.hh:265
InvalidPortID
const PortID InvalidPortID
Definition: types.hh:238
Tick
uint64_t Tick
Tick count type.
Definition: types.hh:63
PortID
int16_t PortID
Port index/ID type, and a symbolic name for an invalid port id.
Definition: types.hh:237
QueuedRequestPort::~QueuedRequestPort
virtual ~QueuedRequestPort()
Definition: qport.hh:138
QueuedResponsePort::schedTimingResp
void schedTimingResp(PacketPtr pkt, Tick when)
Schedule the sending of a timing response.
Definition: qport.hh:90
PacketQueue::schedSendTiming
void schedSendTiming(PacketPtr pkt, Tick when)
Add a packet to the transmit list, and schedule a send event.
Definition: packet_queue.cc:104
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:77
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:117
QueuedRequestPort::schedTimingReq
void schedTimingReq(PacketPtr pkt, Tick when)
Schedule the sending of a timing request.
Definition: qport.hh:146
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:130
sim_object.hh
QueuedRequestPort
The QueuedRequestPort combines two queues, a request queue and a snoop response queue,...
Definition: qport.hh:106
QueuedRequestPort::schedTimingSnoopResp
void schedTimingSnoopResp(PacketPtr pkt, Tick when)
Schedule the sending of a timing snoop response.
Definition: qport.hh:155
packet_queue.hh
port.hh
QueuedResponsePort
A queued port is a port that has an infinite queue for outgoing packets and thus decouples the module...
Definition: qport.hh:58
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:74
RequestPort
A RequestPort is a specialisation of a Port, which implements the default protocol for the three diff...
Definition: port.hh:74
Port::name
const std::string name() const
Return port name (for DPRINTF).
Definition: port.hh:106
RespPacketQueue
Definition: packet_queue.hh:296
QueuedRequestPort::trySatisfyFunctional
bool trySatisfyFunctional(PacketPtr pkt)
Check the list of buffered packets against the supplied functional request.
Definition: qport.hh:160
ResponsePort::owner
SimObject & owner
Definition: port.hh:276
RequestPort::owner
SimObject & owner
Definition: port.hh:83
QueuedRequestPort::snoopRespQueue
SnoopRespPacketQueue & snoopRespQueue
Packet queue used to store outgoing snoop responses.
Definition: qport.hh:115
QueuedResponsePort::respQueue
RespPacketQueue & respQueue
Packet queue used to store outgoing responses.
Definition: qport.hh:64
PacketQueue::trySatisfyFunctional
bool trySatisfyFunctional(PacketPtr pkt)
Check the list of buffered packets against the supplied functional request.
Definition: packet_queue.cc:84
QueuedRequestPort::recvRetrySnoopResp
void recvRetrySnoopResp()
Called by the peer if sendTimingSnoopResp was called on this protocol (causing recvTimingSnoopResp to...
Definition: qport.hh:119
Packet
A Packet is used to encapsulate a transfer between two objects in the memory system (e....
Definition: packet.hh:257
QueuedResponsePort::~QueuedResponsePort
virtual ~QueuedResponsePort()
Definition: qport.hh:82
QueuedRequestPort::reqQueue
ReqPacketQueue & reqQueue
Packet queue used to store outgoing requests.
Definition: qport.hh:112
QueuedResponsePort::trySatisfyFunctional
bool trySatisfyFunctional(PacketPtr pkt)
Check the list of buffered packets against the supplied functional request.
Definition: qport.hh:95
ReqPacketQueue
Definition: packet_queue.hh:222
PacketQueue::retry
void retry()
Retry sending a packet from the queue.
Definition: packet_queue.cc:63
SimObject
Abstract superclass for simulation objects.
Definition: sim_object.hh:92

Generated on Wed Sep 30 2020 14:02:13 for gem5 by doxygen 1.8.17