gem5  v19.0.0.0
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
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  * Authors: Thomas Grass
38  * Andreas Hansson
39  * Marco Elver
40  */
41 
42 #ifndef __MEM_MEM_CHECKER_MONITOR_HH__
43 #define __MEM_MEM_CHECKER_MONITOR_HH__
44 
45 #include "base/statistics.hh"
46 #include "mem/mem_checker.hh"
47 #include "params/MemCheckerMonitor.hh"
48 #include "sim/sim_object.hh"
49 #include "sim/system.hh"
50 
55 {
56  public:
57 
59  typedef MemCheckerMonitorParams Params;
60  const Params* params() const
61  { return reinterpret_cast<const Params*>(_params); }
62 
68  MemCheckerMonitor(Params* params);
69 
72 
73  Port &getPort(const std::string &if_name,
74  PortID idx=InvalidPortID) override;
75 
76  void init() override;
77 
78  private:
79 
81  {
83  : serial(_serial)
84  {}
85 
87  };
88 
96  {
97 
98  public:
99 
100  MonitorMasterPort(const std::string& _name, MemCheckerMonitor& _mon)
101  : MasterPort(_name, &_mon), mon(_mon)
102  { }
103 
104  protected:
105 
107  {
108  mon.recvFunctionalSnoop(pkt);
109  }
110 
112  {
113  return mon.recvAtomicSnoop(pkt);
114  }
115 
117  {
118  return mon.recvTimingResp(pkt);
119  }
120 
122  {
123  mon.recvTimingSnoopReq(pkt);
124  }
125 
127  {
128  mon.recvRangeChange();
129  }
130 
131  bool isSnooping() const
132  {
133  return mon.isSnooping();
134  }
135 
137  {
138  mon.recvReqRetry();
139  }
140 
141  private:
142 
144 
145  };
146 
149 
157  {
158 
159  public:
160 
161  MonitorSlavePort(const std::string& _name, MemCheckerMonitor& _mon)
162  : SlavePort(_name, &_mon), mon(_mon)
163  { }
164 
165  protected:
166 
168  {
169  mon.recvFunctional(pkt);
170  }
171 
173  {
174  return mon.recvAtomic(pkt);
175  }
176 
178  {
179  return mon.recvTimingReq(pkt);
180  }
181 
183  {
184  return mon.recvTimingSnoopResp(pkt);
185  }
186 
188  {
189  return mon.getAddrRanges();
190  }
191 
193  {
194  mon.recvRespRetry();
195  }
196 
197  private:
198 
200 
201  };
202 
205 
206  void recvFunctional(PacketPtr pkt);
207 
208  void recvFunctionalSnoop(PacketPtr pkt);
209 
211 
213 
214  bool recvTimingReq(PacketPtr pkt);
215 
216  bool recvTimingResp(PacketPtr pkt);
217 
218  void recvTimingSnoopReq(PacketPtr pkt);
219 
220  bool recvTimingSnoopResp(PacketPtr pkt);
221 
223 
224  bool isSnooping() const;
225 
226  void recvReqRetry();
227 
228  void recvRespRetry();
229 
230  void recvRangeChange();
231 
232  bool warnOnly;
233 
235 };
236 
237 #endif //__MEM_MEM_CHECKER_MONITOR_HH__
A MasterPort is a specialisation of a BaseMasterPort, which implements the default protocol for the t...
Definition: port.hh:75
~MemCheckerMonitor()
Destructor.
Ports are used to interface objects to each other.
Definition: port.hh:60
Tick recvAtomicSnoop(PacketPtr pkt)
bool recvTimingReq(PacketPtr pkt)
MonitorSlavePort(const std::string &_name, MemCheckerMonitor &_mon)
const PortID InvalidPortID
Definition: types.hh:238
AddrRangeList getAddrRanges() const
Get a list of the non-overlapping address ranges the owner is responsible for.
void init() override
init() is called after all C++ SimObjects have been created and all ports are connected.
MemCheckerMonitorSenderState(MemChecker::Serial _serial)
Port & getPort(const std::string &if_name, PortID idx=InvalidPortID) override
Get a port with a given name and index.
bool isSnooping() const
Determine if this master port is snooping or not.
AddrRangeList getAddrRanges() const
Tick recvAtomic(PacketPtr pkt)
bool recvTimingReq(PacketPtr pkt)
Receive a timing request from the peer.
A SlavePort is a specialisation of a port.
Definition: port.hh:258
This is the master port of the communication monitor.
Declaration of Statistics objects.
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:80
MemCheckerMonitor(Params *params)
Constructor based on the Python params.
MonitorMasterPort masterPort
Instance of master port, facing the memory side.
MemChecker.
Definition: mem_checker.hh:72
uint64_t Tick
Tick count type.
Definition: types.hh:63
bool recvTimingResp(PacketPtr pkt)
Receive a timing response from the peer.
MemCheckerMonitorParams Params
Parameters of memchecker monitor.
void recvTimingSnoopReq(PacketPtr pkt)
Receive a timing snoop request from the peer.
Tick recvAtomicSnoop(PacketPtr pkt)
Receive an atomic snoop request packet from our peer.
void recvFunctionalSnoop(PacketPtr pkt)
void recvRespRetry()
Called by the peer if sendTimingResp was called on this protocol (causing recvTimingResp to be called...
Tick recvAtomic(PacketPtr pkt)
Receive an atomic request packet from the peer.
A Packet is used to encapsulate a transfer between two objects in the memory system (e...
Definition: packet.hh:255
void recvRangeChange()
Called to receive an address range change from the peer slave port.
Implements a MemChecker monitor, to be inserted between two ports.
MonitorSlavePort slavePort
Instance of slave port, i.e.
bool recvTimingSnoopResp(PacketPtr pkt)
Receive a timing snoop response from the peer.
A virtual base opaque structure used to hold state associated with the packet (e.g., an MSHR), specific to a SimObject that sees the packet.
Definition: packet.hh:403
const Params * params() const
void recvReqRetry()
Called by the peer if sendTimingReq was called on this peer (causing recvTimingReq to be called on th...
void recvFunctionalSnoop(PacketPtr pkt)
Receive a functional snoop request packet from the peer.
void recvTimingSnoopReq(PacketPtr pkt)
MonitorMasterPort(const std::string &_name, MemCheckerMonitor &_mon)
const SimObjectParams * _params
Cached copy of the object parameters.
Definition: sim_object.hh:110
bool recvTimingSnoopResp(PacketPtr pkt)
void recvFunctional(PacketPtr pkt)
int16_t PortID
Port index/ID type, and a symbolic name for an invalid port id.
Definition: types.hh:237
bool recvTimingResp(PacketPtr pkt)
void recvFunctional(PacketPtr pkt)
Receive a functional request packet from the peer.
This is the slave port of the communication monitor.
Abstract superclass for simulation objects.
Definition: sim_object.hh:96

Generated on Fri Feb 28 2020 16:27:02 for gem5 by doxygen 1.8.13