gem5  v22.1.0.0
cpu.hh
Go to the documentation of this file.
1 /*
2  * Copyright 2019 Google, Inc.
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 #ifndef __ARCH_ARM_FASTMODEL_IRIS_CPU_HH__
29 #define __ARCH_ARM_FASTMODEL_IRIS_CPU_HH__
30 
31 #include "cpu/base.hh"
32 #include "iris/detail/IrisInterface.h"
33 #include "params/IrisBaseCPU.hh"
37 
38 namespace gem5
39 {
40 
41 namespace Iris
42 {
43 
44 class ThreadContext;
45 
46 // The base interface of the EVS used by gem5 BaseCPU below.
48 {
49  public:
50  virtual void sendFunc(PacketPtr pkt) = 0;
51  virtual void setClkPeriod(Tick clk_period) = 0;
52  virtual void setSysCounterFrq(uint64_t sys_counter_frq) = 0;
53  virtual void setCluster(SimObject *cluster) = 0;
54  virtual void setResetAddr(int core, Addr addr, bool secure) = 0;
55 };
56 
57 // This CPU class adds some mechanisms which help attach the gem5 and fast
58 // model CPUs to each other. It acts as a base class for the gem5 CPU, and
59 // holds a pointer to the EVS. It also has some methods for setting up some
60 // attributes in the fast model CPU to control its clock rate.
61 class BaseCPU : public gem5::BaseCPU
62 {
63  public:
64  BaseCPU(const BaseCPUParams &params, sc_core::sc_module *_evs);
65  virtual ~BaseCPU();
66 
67  Port &
68  getDataPort() override
69  {
70  panic("%s not implemented.", __FUNCTION__);
71  }
72 
73  Port &
74  getInstPort() override
75  {
76  panic("%s not implemented.", __FUNCTION__);
77  }
78 
79  void
80  wakeup(ThreadID tid) override
81  {
82  auto *tc = threadContexts.at(tid);
83  if (tc->status() == gem5::ThreadContext::Suspended)
84  tc->activate();
85  }
86 
87  Counter totalInsts() const override;
88  Counter totalOps() const override { return totalInsts(); }
89 
90  virtual void
91  setResetAddr(Addr addr, bool secure = false)
92  {
93  panic("%s not implemented.", __FUNCTION__);
94  }
95 
96  protected:
98  // Hold casted pointer to *evs.
100 
101  protected:
103 
104  void
106  {
108  }
109 
110  void serializeThread(CheckpointOut &cp, ThreadID tid) const override;
111 };
112 
113 // This class specializes the one above and sets up ThreadContexts based on
114 // its template parameters. These ThreadContexts provide the standard gem5
115 // interface and translate those accesses to use the Iris API to access that
116 // state in the target context.
117 template <class TC>
118 class CPU : public Iris::BaseCPU
119 {
120  public:
121  CPU(const IrisBaseCPUParams &params,
122  iris::IrisConnectionInterface *iris_if) :
124  {
125  const std::string parent_path = evs->name();
126  System *sys = params.system;
127 
128  int thread_id = 0;
129  for (const std::string &sub_path: params.thread_paths) {
130  std::string path = parent_path + "." + sub_path;
131  auto id = thread_id++;
132  auto *tc = new TC(this, id, sys, params.mmu,
133  params.isa[id], iris_if, path);
134  threadContexts.push_back(tc);
135  }
136  }
137 };
138 
139 } // namespace Iris
140 } // namespace gem5
141 
142 #endif // __ARCH_ARM_FASTMODEL_IRIS_CPU_HH__
std::vector< ThreadContext * > threadContexts
Definition: base.hh:256
Tick clockPeriod() const
Counter totalOps() const override
Definition: cpu.hh:88
void wakeup(ThreadID tid) override
Definition: cpu.hh:80
virtual ~BaseCPU()
Definition: cpu.cc:53
Iris::BaseCpuEvs * evs_base_cpu
Definition: cpu.hh:99
sc_core::sc_module * evs
Definition: cpu.hh:97
Port & getDataPort() override
Purely virtual method that returns a reference to the data port.
Definition: cpu.hh:68
BaseCPU(const BaseCPUParams &params, sc_core::sc_module *_evs)
Definition: cpu.cc:40
void serializeThread(CheckpointOut &cp, ThreadID tid) const override
Serialize a single thread.
Definition: cpu.cc:70
virtual void setResetAddr(Addr addr, bool secure=false)
Definition: cpu.hh:91
void clockPeriodUpdated() override
A hook subclasses can implement so they can do any extra work that's needed when the clock rate is ch...
Definition: cpu.hh:105
friend ThreadContext
Definition: cpu.hh:102
Counter totalInsts() const override
Definition: cpu.cc:61
Port & getInstPort() override
Purely virtual method that returns a reference to the instruction port.
Definition: cpu.hh:74
virtual void setSysCounterFrq(uint64_t sys_counter_frq)=0
virtual void setClkPeriod(Tick clk_period)=0
virtual void setResetAddr(int core, Addr addr, bool secure)=0
virtual void setCluster(SimObject *cluster)=0
virtual void sendFunc(PacketPtr pkt)=0
CPU(const IrisBaseCPUParams &params, iris::IrisConnectionInterface *iris_if)
Definition: cpu.hh:121
A Packet is used to encapsulate a transfer between two objects in the memory system (e....
Definition: packet.hh:294
Ports are used to interface objects to each other.
Definition: port.hh:62
static std::stack< std::string > path
Definition: serialize.hh:315
Abstract superclass for simulation objects.
Definition: sim_object.hh:148
@ Suspended
Temporarily inactive.
const char * name() const
Definition: sc_object.cc:44
#define panic(...)
This implements a cprintf based panic() function.
Definition: logging.hh:178
const Params & params() const
Definition: sim_object.hh:176
Bitfield< 3 > addr
Definition: types.hh:84
double Counter
All counters are of 64-bit values.
Definition: types.hh:47
Reference material can be found at the JEDEC website: UFS standard http://www.jedec....
int16_t ThreadID
Thread index/ID type.
Definition: types.hh:235
std::ostream CheckpointOut
Definition: serialize.hh:66
uint64_t Addr
Address type This will probably be moved somewhere else in the near future.
Definition: types.hh:147
uint64_t Tick
Tick count type.
Definition: types.hh:58

Generated on Wed Dec 21 2022 10:22:24 for gem5 by doxygen 1.9.1