gem5  [DEVELOP-FOR-23.0]
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
dramsim3_wrapper.cc
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2013 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 
39 #include <cassert>
40 
41 #include "mem/dramsim3_wrapper.hh"
42 
43 #include <fstream>
44 
45 #include "DRAMsim3/src/dramsim3.h"
46 #include "base/compiler.hh"
47 #include "base/logging.hh"
48 
49 namespace gem5
50 {
51 
52 namespace memory
53 {
54 
55 DRAMsim3Wrapper::DRAMsim3Wrapper(const std::string& config_file,
56  const std::string& working_dir,
57  std::function<void(uint64_t)> read_cb,
58  std::function<void(uint64_t)> write_cb) :
59  dramsim(dramsim3::GetMemorySystem(config_file, working_dir,
60  read_cb, write_cb)),
61  _clockPeriod(0.0), _queueSize(0), _burstSize(0)
62 {
63  // there is no way of getting DRAMsim3 to tell us what frequency
64  // it is assuming, so we have to extract it ourselves
65  _clockPeriod = dramsim->GetTCK();
66 
67  if (!_clockPeriod)
68  fatal("DRAMsim3 wrapper failed to get clock\n");
69 
70  // we also need to know what transaction queue size DRAMsim3 is
71  // using so we can stall when responses are blocked
72  _queueSize = dramsim->GetQueueSize();
73 
74  if (!_queueSize)
75  fatal("DRAMsim3 wrapper failed to get queue size\n");
76 
77 
78  // finally, get the data bus bits and burst length so we can add a
79  // sanity check for the burst size
80  unsigned int dataBusBits = dramsim->GetBusBits();
81  unsigned int burstLength = dramsim->GetBurstLength();
82 
83  if (!dataBusBits || !burstLength)
84  fatal("DRAMsim3 wrapper failed to get burst size\n");
85 
86  _burstSize = dataBusBits * burstLength / 8;
87 }
88 
90 {
91  delete dramsim;
92 }
93 
94 
95 void
97 {
98  dramsim->PrintStats();
99 }
100 
101 void
103 {
104  dramsim->ResetStats();
105 }
106 
107 void
108 DRAMsim3Wrapper::setCallbacks(std::function<void(uint64_t)> read_complete,
109  std::function<void(uint64_t)> write_complete)
110 {
111  dramsim->RegisterCallbacks(read_complete, write_complete);
112 }
113 
114 bool
115 DRAMsim3Wrapper::canAccept(uint64_t addr, bool is_write) const
116 {
117  return dramsim->WillAcceptTransaction(addr, is_write);
118 }
119 
120 void
121 DRAMsim3Wrapper::enqueue(uint64_t addr, bool is_write)
122 {
123  [[maybe_unused]] bool success = dramsim->AddTransaction(addr, is_write);
124  assert(success);
125 }
126 
127 double
129 {
130  return _clockPeriod;
131 }
132 
133 unsigned int
135 {
136  return _queueSize;
137 }
138 
139 unsigned int
141 {
142  return _burstSize;
143 }
144 
145 void
147 {
148  dramsim->ClockTick();
149 }
150 
151 } // namespace memory
152 } // namespace gem5
gem5::memory::DRAMsim3Wrapper::dramsim
dramsim3::MemorySystem * dramsim
Definition: dramsim3_wrapper.hh:78
fatal
#define fatal(...)
This implements a cprintf based fatal() function.
Definition: logging.hh:200
gem5::memory::DRAMsim3Wrapper::canAccept
bool canAccept(uint64_t addr, bool is_write) const
Determine if the controller can accept a new packet or not.
Definition: dramsim3_wrapper.cc:115
gem5::memory::DRAMsim3Wrapper::clockPeriod
double clockPeriod() const
Get the internal clock period used by DRAMsim3, specified in ns.
Definition: dramsim3_wrapper.cc:128
gem5::memory::DRAMsim3Wrapper::setCallbacks
void setCallbacks(std::function< void(uint64_t)> read_complete, std::function< void(uint64_t)> write_complete)
Set the callbacks to use for read and write completion.
Definition: dramsim3_wrapper.cc:108
gem5::memory::DRAMsim3Wrapper::burstSize
unsigned int burstSize() const
Get the burst size in bytes used by DRAMsim3.
Definition: dramsim3_wrapper.cc:140
gem5::memory::DRAMsim3Wrapper::printStats
void printStats()
Print the stats gathered in DRAMsim3.
Definition: dramsim3_wrapper.cc:96
memory
Definition: mem.h:38
gem5::memory::DRAMsim3Wrapper::queueSize
unsigned int queueSize() const
Get the transaction queue size used by DRAMsim3.
Definition: dramsim3_wrapper.cc:134
gem5::memory::DRAMsim3Wrapper::DRAMsim3Wrapper
DRAMsim3Wrapper(const std::string &config_file, const std::string &working_dir, std::function< void(uint64_t)> read_cb, std::function< void(uint64_t)> write_cb)
Create an instance of the DRAMsim3 multi-channel memory controller using a specific config and system...
Definition: dramsim3_wrapper.cc:55
gem5::memory::DRAMsim3Wrapper::_clockPeriod
double _clockPeriod
Definition: dramsim3_wrapper.hh:80
dramsim3_wrapper.hh
compiler.hh
dramsim3
Forward declaration to avoid includes.
Definition: dramsim3_wrapper.hh:53
gem5::memory::DRAMsim3Wrapper::enqueue
void enqueue(uint64_t addr, bool is_write)
Enqueue a packet.
Definition: dramsim3_wrapper.cc:121
gem5::memory::DRAMsim3Wrapper::~DRAMsim3Wrapper
~DRAMsim3Wrapper()
Definition: dramsim3_wrapper.cc:89
gem5::memory::DRAMsim3Wrapper::tick
void tick()
Progress the memory controller one cycle.
Definition: dramsim3_wrapper.cc:146
logging.hh
gem5::memory::DRAMsim3Wrapper::_queueSize
unsigned int _queueSize
Definition: dramsim3_wrapper.hh:82
gem5::memory::DRAMsim3Wrapper::_burstSize
unsigned int _burstSize
Definition: dramsim3_wrapper.hh:84
gem5
Reference material can be found at the JEDEC website: UFS standard http://www.jedec....
Definition: gpu_translation_state.hh:37
gem5::memory::DRAMsim3Wrapper::resetStats
void resetStats()
Reset stats (useful for fastforwarding switch)
Definition: dramsim3_wrapper.cc:102
gem5::X86ISA::addr
Bitfield< 3 > addr
Definition: types.hh:84

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