gem5  v21.0.1.0
mem_checker_monitor.hh
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2012-2014 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_MEM_CHECKER_MONITOR_HH__
39 #define __MEM_MEM_CHECKER_MONITOR_HH__
40 
41 #include "base/statistics.hh"
42 #include "mem/mem_checker.hh"
43 #include "params/MemCheckerMonitor.hh"
44 #include "sim/sim_object.hh"
45 #include "sim/system.hh"
46 
51 {
52  public:
53 
55  using Params = MemCheckerMonitorParams;
56 
63 
66 
67  Port &getPort(const std::string &if_name,
68  PortID idx=InvalidPortID) override;
69 
70  void init() override;
71 
72  private:
73 
75  {
77  : serial(_serial)
78  {}
79 
81  };
82 
90  {
91 
92  public:
93 
94  MonitorRequestPort(const std::string& _name, MemCheckerMonitor& _mon)
95  : RequestPort(_name, &_mon), mon(_mon)
96  { }
97 
98  protected:
99 
101  {
103  }
104 
106  {
107  return mon.recvAtomicSnoop(pkt);
108  }
109 
111  {
112  return mon.recvTimingResp(pkt);
113  }
114 
116  {
117  mon.recvTimingSnoopReq(pkt);
118  }
119 
121  {
123  }
124 
125  bool isSnooping() const
126  {
127  return mon.isSnooping();
128  }
129 
131  {
132  mon.recvReqRetry();
133  }
134 
135  private:
136 
138 
139  };
140 
143 
151  {
152 
153  public:
154 
155  MonitorResponsePort(const std::string& _name, MemCheckerMonitor& _mon)
156  : ResponsePort(_name, &_mon), mon(_mon)
157  { }
158 
159  protected:
160 
162  {
163  mon.recvFunctional(pkt);
164  }
165 
167  {
168  return mon.recvAtomic(pkt);
169  }
170 
172  {
173  return mon.recvTimingReq(pkt);
174  }
175 
177  {
178  return mon.recvTimingSnoopResp(pkt);
179  }
180 
182  {
183  return mon.getAddrRanges();
184  }
185 
187  {
188  mon.recvRespRetry();
189  }
190 
191  private:
192 
194 
195  };
196 
199 
200  void recvFunctional(PacketPtr pkt);
201 
202  void recvFunctionalSnoop(PacketPtr pkt);
203 
205 
207 
208  bool recvTimingReq(PacketPtr pkt);
209 
210  bool recvTimingResp(PacketPtr pkt);
211 
212  void recvTimingSnoopReq(PacketPtr pkt);
213 
214  bool recvTimingSnoopResp(PacketPtr pkt);
215 
217 
218  bool isSnooping() const;
219 
220  void recvReqRetry();
221 
222  void recvRespRetry();
223 
224  void recvRangeChange();
225 
226  bool warnOnly;
227 
229 };
230 
231 #endif //__MEM_MEM_CHECKER_MONITOR_HH__
MemCheckerMonitor::recvTimingResp
bool recvTimingResp(PacketPtr pkt)
Definition: mem_checker_monitor.cc:217
ResponsePort
A ResponsePort is a specialization of a port.
Definition: port.hh:265
MemCheckerMonitor::MonitorRequestPort::recvTimingSnoopReq
void recvTimingSnoopReq(PacketPtr pkt)
Receive a timing snoop request from the peer.
Definition: mem_checker_monitor.hh:115
MemCheckerMonitor::getAddrRanges
AddrRangeList getAddrRanges() const
Definition: mem_checker_monitor.cc:332
system.hh
MemCheckerMonitor::recvFunctional
void recvFunctional(PacketPtr pkt)
Definition: mem_checker_monitor.cc:79
InvalidPortID
const PortID InvalidPortID
Definition: types.hh:244
MemCheckerMonitor::MonitorRequestPort::isSnooping
bool isSnooping() const
Determine if this request port is snooping or not.
Definition: mem_checker_monitor.hh:125
MemCheckerMonitor::isSnooping
bool isSnooping() const
Definition: mem_checker_monitor.cc:325
Tick
uint64_t Tick
Tick count type.
Definition: types.hh:59
PortID
int16_t PortID
Port index/ID type, and a symbolic name for an invalid port id.
Definition: types.hh:243
MemCheckerMonitor::MonitorRequestPort::recvReqRetry
void recvReqRetry()
Called by the peer if sendTimingReq was called on this peer (causing recvTimingReq to be called on th...
Definition: mem_checker_monitor.hh:130
MemCheckerMonitor::MonitorRequestPort::MonitorRequestPort
MonitorRequestPort(const std::string &_name, MemCheckerMonitor &_mon)
Definition: mem_checker_monitor.hh:94
MemCheckerMonitor::MemCheckerMonitorSenderState::serial
MemChecker::Serial serial
Definition: mem_checker_monitor.hh:80
MemCheckerMonitor::MonitorRequestPort
This is the request port of the communication monitor.
Definition: mem_checker_monitor.hh:89
MemCheckerMonitor::memSidePort
MonitorRequestPort memSidePort
Instance of request port, facing the memory side.
Definition: mem_checker_monitor.hh:142
MemCheckerMonitor::MonitorResponsePort::recvFunctional
void recvFunctional(PacketPtr pkt)
Receive a functional request packet from the peer.
Definition: mem_checker_monitor.hh:161
MemCheckerMonitor::init
void init() override
init() is called after all C++ SimObjects have been created and all ports are connected.
Definition: mem_checker_monitor.cc:59
MemCheckerMonitor::MonitorRequestPort::recvRangeChange
void recvRangeChange()
Called to receive an address range change from the peer response port.
Definition: mem_checker_monitor.hh:120
Packet::SenderState
A virtual base opaque structure used to hold state associated with the packet (e.g....
Definition: packet.hh:432
MemCheckerMonitor::MonitorResponsePort::MonitorResponsePort
MonitorResponsePort(const std::string &_name, MemCheckerMonitor &_mon)
Definition: mem_checker_monitor.hh:155
MemCheckerMonitor::MonitorResponsePort::recvTimingSnoopResp
bool recvTimingSnoopResp(PacketPtr pkt)
Receive a timing snoop response from the peer.
Definition: mem_checker_monitor.hh:176
sim_object.hh
MemCheckerMonitor::MonitorResponsePort
This is the response port of the communication monitor.
Definition: mem_checker_monitor.hh:150
statistics.hh
Port
Ports are used to interface objects to each other.
Definition: port.hh:56
MemCheckerMonitor
Implements a MemChecker monitor, to be inserted between two ports.
Definition: mem_checker_monitor.hh:50
mem_checker.hh
MemCheckerMonitor::recvTimingSnoopResp
bool recvTimingSnoopResp(PacketPtr pkt)
Definition: mem_checker_monitor.cc:319
MemCheckerMonitor::MonitorResponsePort::recvAtomic
Tick recvAtomic(PacketPtr pkt)
Receive an atomic request packet from the peer.
Definition: mem_checker_monitor.hh:166
RequestPort
A RequestPort is a specialisation of a Port, which implements the default protocol for the three diff...
Definition: port.hh:74
MemCheckerMonitor::Params
MemCheckerMonitorParams Params
Parameters of memchecker monitor.
Definition: mem_checker_monitor.hh:55
MemCheckerMonitor::recvTimingSnoopReq
void recvTimingSnoopReq(PacketPtr pkt)
Definition: mem_checker_monitor.cc:313
MemCheckerMonitor::MonitorRequestPort::recvTimingResp
bool recvTimingResp(PacketPtr pkt)
Receive a timing response from the peer.
Definition: mem_checker_monitor.hh:110
MemCheckerMonitor::MemCheckerMonitorSenderState::MemCheckerMonitorSenderState
MemCheckerMonitorSenderState(MemChecker::Serial _serial)
Definition: mem_checker_monitor.hh:76
MemCheckerMonitor::MonitorRequestPort::recvAtomicSnoop
Tick recvAtomicSnoop(PacketPtr pkt)
Receive an atomic snoop request packet from our peer.
Definition: mem_checker_monitor.hh:105
MemCheckerMonitor::MonitorRequestPort::recvFunctionalSnoop
void recvFunctionalSnoop(PacketPtr pkt)
Receive a functional snoop request packet from the peer.
Definition: mem_checker_monitor.hh:100
MemCheckerMonitor::MemCheckerMonitor
MemCheckerMonitor(const Params &params)
Constructor based on the Python params.
Definition: mem_checker_monitor.cc:47
MemCheckerMonitor::MonitorResponsePort::recvTimingReq
bool recvTimingReq(PacketPtr pkt)
Receive a timing request from the peer.
Definition: mem_checker_monitor.hh:171
MemCheckerMonitor::MonitorRequestPort::mon
MemCheckerMonitor & mon
Definition: mem_checker_monitor.hh:137
MemCheckerMonitor::cpuSidePort
MonitorResponsePort cpuSidePort
Instance of response port, i.e.
Definition: mem_checker_monitor.hh:198
MemCheckerMonitor::MonitorResponsePort::mon
MemCheckerMonitor & mon
Definition: mem_checker_monitor.hh:193
MemCheckerMonitor::recvReqRetry
void recvReqRetry()
Definition: mem_checker_monitor.cc:339
MemCheckerMonitor::MonitorResponsePort::recvRespRetry
void recvRespRetry()
Called by the peer if sendTimingResp was called on this protocol (causing recvTimingResp to be called...
Definition: mem_checker_monitor.hh:186
Packet
A Packet is used to encapsulate a transfer between two objects in the memory system (e....
Definition: packet.hh:258
MemCheckerMonitor::recvRespRetry
void recvRespRetry()
Definition: mem_checker_monitor.cc:345
MemCheckerMonitor::recvTimingReq
bool recvTimingReq(PacketPtr pkt)
Definition: mem_checker_monitor.cc:125
MemCheckerMonitor::MemCheckerMonitorSenderState
Definition: mem_checker_monitor.hh:74
MemCheckerMonitor::recvFunctionalSnoop
void recvFunctionalSnoop(PacketPtr pkt)
Definition: mem_checker_monitor.cc:97
MemChecker
MemChecker.
Definition: mem_checker.hh:71
MemCheckerMonitor::MonitorResponsePort::getAddrRanges
AddrRangeList getAddrRanges() const
Get a list of the non-overlapping address ranges the owner is responsible for.
Definition: mem_checker_monitor.hh:181
MemCheckerMonitor::~MemCheckerMonitor
~MemCheckerMonitor()
Destructor.
Definition: mem_checker_monitor.cc:55
SimObject::params
const Params & params() const
Definition: sim_object.hh:168
MemCheckerMonitor::recvAtomicSnoop
Tick recvAtomicSnoop(PacketPtr pkt)
Definition: mem_checker_monitor.cc:119
std::list< AddrRange >
MemCheckerMonitor::memchecker
MemChecker * memchecker
Definition: mem_checker_monitor.hh:228
MemCheckerMonitor::warnOnly
bool warnOnly
Definition: mem_checker_monitor.hh:226
MemCheckerMonitor::recvRangeChange
void recvRangeChange()
Definition: mem_checker_monitor.cc:351
MemCheckerMonitor::getPort
Port & getPort(const std::string &if_name, PortID idx=InvalidPortID) override
Get a port with a given name and index.
Definition: mem_checker_monitor.cc:67
MemChecker::Serial
uint64_t Serial
The Serial type is used to be able to uniquely identify a transaction as it passes through the system...
Definition: mem_checker.hh:79
MemCheckerMonitor::recvAtomic
Tick recvAtomic(PacketPtr pkt)
Definition: mem_checker_monitor.cc:113
SimObject
Abstract superclass for simulation objects.
Definition: sim_object.hh:141

Generated on Tue Jun 22 2021 15:28:29 for gem5 by doxygen 1.8.17