gem5  [DEVELOP-FOR-23.0]
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
port_wrapper.cc
Go to the documentation of this file.
1 /*
2  * Copyright 2023 Google, LLC.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are
6  * met: redistributions of source code must retain the above copyright
7  * notice, this list of conditions and the following disclaimer;
8  * redistributions in binary form must reproduce the above copyright
9  * notice, this list of conditions and the following disclaimer in the
10  * documentation and/or other materials provided with the distribution;
11  * neither the name of the copyright holders nor the names of its
12  * contributors may be used to endorse or promote products derived from
13  * this software without specific prior written permission.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
17  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
18  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
19  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
20  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
21  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
25  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26  */
27 
28 #include "mem/port_wrapper.hh"
29 
30 namespace gem5
31 {
32 
34  : RequestPort(name, id)
35 {
36 }
37 
38 void
40 {
41  if (!recvRangeChangeCb) {
43  return;
44  }
46 }
47 
48 bool
50 {
51  panic_if(!recvTimingRespCb, "RecvTimingRespCallback is empty.");
52  return recvTimingRespCb(packet);
53 }
54 
55 void
57 {
58  panic_if(!recvReqRetryCb, "RecvReqRetryCallback is empty.");
60 }
61 
62 void
64 {
65  recvRangeChangeCb = std::move(cb);
66 }
67 
68 void
70  RecvReqRetryCallback retry_cb)
71 {
72  recvTimingRespCb = std::move(resp_cb);
73  recvReqRetryCb = std::move(retry_cb);
74 }
75 
77  : ResponsePort(name, id)
78 {
79 }
80 
83 {
84  panic_if(!getAddrRangesCb, "GetAddrRangesCallback is empty.");
85  return getAddrRangesCb();
86 }
87 
88 bool
90 {
91  panic_if(!recvTimingReqCb, "RecvTimingReqCallback is empty.");
92  return recvTimingReqCb(packet);
93 }
94 
95 void
97 {
98  panic_if(!recvRespRetryCb, "RecvRespRetryCallback is empty.");
100 }
101 
102 Tick
104 {
105  panic_if(!recvAtomicCb, "RecvAtomicCallback is empty.");
106  return recvAtomicCb(packet);
107 }
108 
109 Tick
111  MemBackdoorPtr& backdoor)
112 {
113  if (!recvAtomicBackdoorCb) {
114  return ResponsePort::recvAtomicBackdoor(packet, backdoor);
115  }
116  return recvAtomicBackdoorCb(packet, backdoor);
117 }
118 
119 void
121 {
122  panic_if(!recvFunctionalCb, "RecvFunctionalCallback is empty.");
123  recvTimingReqCb(packet);
124 }
125 
126 void
128  MemBackdoorPtr& backdoor)
129 {
130  if (!recvMemBackdoorReqCb) {
131  ResponsePort::recvMemBackdoorReq(req, backdoor);
132  return;
133  }
134  recvMemBackdoorReqCb(req, backdoor);
135 }
136 
137 void
139 {
140  getAddrRangesCb = std::move(cb);
141 }
142 
143 void
145  RecvRespRetryCallback retry_cb)
146 {
147  recvTimingReqCb = std::move(timing_cb);
148  recvRespRetryCb = std::move(retry_cb);
149 }
150 
151 void
153  RecvAtomicBackdoorCallback backdoor_cb)
154 {
155  recvAtomicCb = std::move(atomic_cb);
156  recvAtomicBackdoorCb = std::move(backdoor_cb);
157 }
158 
159 void
162 {
163  recvFunctionalCb = std::move(func_cb);
164  recvMemBackdoorReqCb = std::move(backdoor_cb);
165 }
166 
167 } // namespace gem5
gem5::PortID
int16_t PortID
Port index/ID type, and a symbolic name for an invalid port id.
Definition: types.hh:245
gem5::ResponsePortWrapper::recvTimingReqCb
RecvTimingReqCallback recvTimingReqCb
Definition: port_wrapper.hh:147
gem5::ResponsePortWrapper::setTimingCallbacks
void setTimingCallbacks(RecvTimingReqCallback, RecvRespRetryCallback)
Definition: port_wrapper.cc:144
gem5::ResponsePortWrapper::recvAtomicCb
RecvAtomicCallback recvAtomicCb
Definition: port_wrapper.hh:149
gem5::RequestPortWrapper::RecvTimingRespCallback
std::function< bool(PacketPtr)> RecvTimingRespCallback
Definition: port_wrapper.hh:80
gem5::RequestPort::recvRangeChange
virtual void recvRangeChange()
Called to receive an address range change from the peer response port.
Definition: port.hh:281
gem5::ResponsePortWrapper::RecvFunctionalCallback
std::function< void(PacketPtr)> RecvFunctionalCallback
Definition: port_wrapper.hh:116
gem5::ResponsePortWrapper::recvRespRetryCb
RecvRespRetryCallback recvRespRetryCb
Definition: port_wrapper.hh:148
gem5::RequestPortWrapper::recvTimingResp
bool recvTimingResp(PacketPtr) override
Receive a timing response from the peer.
Definition: port_wrapper.cc:49
gem5::ResponsePortWrapper::recvAtomicBackdoor
Tick recvAtomicBackdoor(PacketPtr, MemBackdoorPtr &) override
Default implementations.
Definition: port_wrapper.cc:110
gem5::ResponsePortWrapper::recvMemBackdoorReqCb
RecvMemBackdoorReqCallback recvMemBackdoorReqCb
Definition: port_wrapper.hh:152
gem5::RequestPort
A RequestPort is a specialisation of a Port, which implements the default protocol for the three diff...
Definition: port.hh:118
gem5::ResponsePortWrapper::ResponsePortWrapper
ResponsePortWrapper(const std::string &name, PortID id=InvalidPortID)
Definition: port_wrapper.cc:76
gem5::ResponsePortWrapper::recvAtomic
Tick recvAtomic(PacketPtr) override
Receive an atomic request packet from the peer.
Definition: port_wrapper.cc:103
gem5::ResponsePortWrapper::setAtomicCallbacks
void setAtomicCallbacks(RecvAtomicCallback, RecvAtomicBackdoorCallback=nullptr)
Definition: port_wrapper.cc:152
gem5::RequestPortWrapper::recvReqRetryCb
RecvReqRetryCallback recvReqRetryCb
Definition: port_wrapper.hh:97
gem5::RequestPortWrapper::recvReqRetry
void recvReqRetry() override
Called by the peer if sendTimingReq was called on this peer (causing recvTimingReq to be called on th...
Definition: port_wrapper.cc:56
gem5::Packet
A Packet is used to encapsulate a transfer between two objects in the memory system (e....
Definition: packet.hh:294
gem5::RequestPortWrapper::recvRangeChange
void recvRangeChange() override
Called to receive an address range change from the peer response port.
Definition: port_wrapper.cc:39
gem5::ResponsePortWrapper::getAddrRangesCb
GetAddrRangesCallback getAddrRangesCb
Definition: port_wrapper.hh:146
gem5::Tick
uint64_t Tick
Tick count type.
Definition: types.hh:58
gem5::ResponsePortWrapper::GetAddrRangesCallback
std::function< AddrRangeList()> GetAddrRangesCallback
Definition: port_wrapper.hh:107
gem5::ResponsePortWrapper::setGetAddrRangesCallback
void setGetAddrRangesCallback(GetAddrRangesCallback)
Definition: port_wrapper.cc:138
gem5::ResponsePortWrapper::getAddrRanges
AddrRangeList getAddrRanges() const override
Get a list of the non-overlapping address ranges the owner is responsible for.
Definition: port_wrapper.cc:82
gem5::ResponsePortWrapper::recvAtomicBackdoorCb
RecvAtomicBackdoorCallback recvAtomicBackdoorCb
Definition: port_wrapper.hh:150
gem5::RequestPortWrapper::recvTimingRespCb
RecvTimingRespCallback recvTimingRespCb
Definition: port_wrapper.hh:96
gem5::ResponsePort::recvMemBackdoorReq
void recvMemBackdoorReq(const MemBackdoorReq &req, MemBackdoorPtr &backdoor) override
Receive a request for a back door to a range of memory.
Definition: port.cc:273
gem5::ResponsePortWrapper::recvMemBackdoorReq
void recvMemBackdoorReq(const MemBackdoorReq &, MemBackdoorPtr &) override
Receive a request for a back door to a range of memory.
Definition: port_wrapper.cc:127
name
const std::string & name()
Definition: trace.cc:48
gem5::MemBackdoor
Definition: backdoor.hh:41
gem5::ResponsePortWrapper::RecvAtomicCallback
std::function< Tick(PacketPtr)> RecvAtomicCallback
Definition: port_wrapper.hh:111
gem5::RequestPortWrapper::setTimingCallbacks
void setTimingCallbacks(RecvTimingRespCallback, RecvReqRetryCallback)
Definition: port_wrapper.cc:69
gem5::ResponsePort
A ResponsePort is a specialization of a port.
Definition: port.hh:331
gem5::ResponsePortWrapper::recvTimingReq
bool recvTimingReq(PacketPtr) override
Receive a timing request from the peer.
Definition: port_wrapper.cc:89
panic_if
#define panic_if(cond,...)
Conditional panic macro that checks the supplied condition and only panics if the condition is true a...
Definition: logging.hh:214
gem5::ResponsePortWrapper::setFunctionalCallbacks
void setFunctionalCallbacks(RecvFunctionalCallback, RecvMemBackdoorReqCallback=nullptr)
Definition: port_wrapper.cc:160
gem5::ResponsePortWrapper::RecvAtomicBackdoorCallback
std::function< Tick(PacketPtr, MemBackdoorPtr &)> RecvAtomicBackdoorCallback
Definition: port_wrapper.hh:113
gem5::RequestPortWrapper::RecvReqRetryCallback
std::function< void()> RecvReqRetryCallback
Definition: port_wrapper.hh:81
port_wrapper.hh
gem5::RequestPortWrapper::RequestPortWrapper
RequestPortWrapper(const std::string &name, PortID id=InvalidPortID)
Definition: port_wrapper.cc:33
gem5::ArmISA::id
Bitfield< 33 > id
Definition: misc_types.hh:305
gem5::ResponsePortWrapper::recvFunctionalCb
RecvFunctionalCallback recvFunctionalCb
Definition: port_wrapper.hh:151
gem5::ResponsePortWrapper::recvFunctional
void recvFunctional(PacketPtr) override
Receive a functional request packet from the peer.
Definition: port_wrapper.cc:120
gem5::RequestPortWrapper::recvRangeChangeCb
RecvRangeChangeCallback recvRangeChangeCb
Definition: port_wrapper.hh:95
std::list< AddrRange >
gem5::ResponsePort::recvAtomicBackdoor
Tick recvAtomicBackdoor(PacketPtr pkt, MemBackdoorPtr &backdoor) override
Default implementations.
Definition: port.cc:262
gem5::RequestPortWrapper::setRangeChangeCallback
void setRangeChangeCallback(RecvReqRetryCallback)
Definition: port_wrapper.cc:63
gem5::ResponsePortWrapper::recvRespRetry
void recvRespRetry() override
Called by the peer if sendTimingResp was called on this protocol (causing recvTimingResp to be called...
Definition: port_wrapper.cc:96
gem5
Reference material can be found at the JEDEC website: UFS standard http://www.jedec....
Definition: gpu_translation_state.hh:37
gem5::ResponsePortWrapper::RecvTimingReqCallback
std::function< bool(PacketPtr)> RecvTimingReqCallback
Definition: port_wrapper.hh:109
gem5::MemBackdoorReq
Definition: backdoor.hh:129
gem5::ResponsePortWrapper::RecvRespRetryCallback
std::function< void()> RecvRespRetryCallback
Definition: port_wrapper.hh:120
gem5::ResponsePortWrapper::RecvMemBackdoorReqCallback
std::function< void(const MemBackdoorReq &, MemBackdoorPtr &)> RecvMemBackdoorReqCallback
Definition: port_wrapper.hh:118

Generated on Sun Jul 30 2023 01:56:58 for gem5 by doxygen 1.8.17