Skip to content

Commit 39d7720

Browse files
author
Paul Rosenfeld
committed
More README tweaks, GPL tweaks
1 parent 12befe3 commit 39d7720

30 files changed

+68
-17
lines changed

Bank.cpp

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -24,6 +25,7 @@
2425

2526

2627

28+
2729
//Bank.cpp
2830
//
2931
//Class file for bank object

Bank.h

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -24,6 +25,7 @@
2425

2526

2627

28+
2729
#ifndef BANK_H
2830
#define BANK_H
2931

BankState.cpp

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -24,6 +25,7 @@
2425

2526

2627

28+
2729
//BankState.cpp
2830
//
2931
//Class file for bank state object

BankState.h

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -24,6 +25,7 @@
2425

2526

2627

28+
2729
#ifndef BANKSTATE_H
2830
#define BANKSTATE_H
2931

BusPacket.cpp

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -24,6 +25,7 @@
2425

2526

2627

28+
2729
//BusPacket.cpp
2830
//
2931
//Class file for bus packet object

BusPacket.h

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -24,6 +25,7 @@
2425

2526

2627

28+
2729
#ifndef BUSPACKET_H
2830
#define BUSPACKET_H
2931
//BusPacket.h

Callback.h

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -25,6 +26,7 @@
2526

2627

2728

29+
2830
#ifndef CALLBACK_H
2931
#define CALLBACK_H
3032

CommandQueue.cpp

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -24,6 +25,7 @@
2425

2526

2627

28+
2729
//CommandQueue.cpp
2830
//
2931
//Class file for command queue object

CommandQueue.h

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -24,6 +25,7 @@
2425

2526

2627

28+
2729
#ifndef CMDQUEUE_H
2830
#define CMDQUEUE_H
2931

DRAMSim.h

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -24,6 +25,7 @@
2425

2526

2627

28+
2729
#ifndef DRAMSIM_H
2830
#define DRAMSIM_H
2931
/*

IniReader.cpp

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -24,6 +25,7 @@
2425

2526

2627

28+
2729
#include "IniReader.h"
2830

2931
using namespace std;

IniReader.h

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -24,6 +25,7 @@
2425

2526

2627

28+
2729
#ifndef INIREADER_H
2830
#define INIREADER_H
2931

MemoryController.cpp

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -24,6 +25,7 @@
2425

2526

2627

28+
2729
//MemoryController.cpp
2830
//
2931
//Class file for memory controller object

MemoryController.h

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -24,6 +25,7 @@
2425

2526

2627

28+
2729
#ifndef MEMORYCONTROLLER_H
2830
#define MEMORYCONTROLLER_H
2931

MemorySystem.cpp

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -24,6 +25,7 @@
2425

2526

2627

28+
2729
//MemorySystem.cpp
2830
//
2931
//Class file for JEDEC memory system wrapper

MemorySystem.h

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -24,6 +25,7 @@
2425

2526

2627

28+
2729
#ifndef MEMORYSYSTEM_H
2830
#define MEMORYSYSTEM_H
2931

PrintMacros.h

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -21,6 +22,7 @@
2122
*****************************************************************************/
2223

2324

25+
2426
#ifndef PRINT_MACROS_H
2527
#define PRINT_MACROS_H
2628

README.pdf

441 Bytes
Binary file not shown.

README.tex

+2-1
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@
1212
\title{DRAMSim2}
1313
\author{Elliott Cooper-Balis \\
1414
Paul Rosenfeld \\
15+
Bruce Jacob \\
1516
University of Maryland \\
1617
\texttt{\footnotesize dramninjas \textit{[at]} gmail \textit{[dot]} com}
1718
}
@@ -36,7 +37,7 @@ \section{Getting DRAMSim2}
3637

3738
DRAMSim2 is available on \href{http://github.com/dramninjasUMD}{github}. If you have git installed you can clone our repository by typing:\\
3839

39-
\texttt{\$ git clone http://github.com/dramninjasUMD/DRAMSim2.git }
40+
\texttt{\$ git clone git://github.com/dramninjasUMD/DRAMSim2.git }
4041

4142

4243

README.txt

+12-16
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,13 @@
1-
DRAMSim2
2-
----------------------------------------
1+
DRAMSim2: A cycle accurate DRAM Simulator
2+
================================================================================
33
Elliott Cooper-Balis
44
Paul Rosenfeld
5+
Bruce Jacob
56
University of Maryland
67
dramninjas [at] gmail [dot] com
7-
----------------------------------------
88

99

10-
11-
1 About DRAMSim2
10+
1 About DRAMSim2 --------------------------------------------------------------------------------
1211

1312
DRAMSim2 is a cycle accurate model of a DRAM memory controller, the DRAM modules which comprise
1413
system storage, and the buses by which they communicate.
@@ -17,14 +16,13 @@ simple interface which allows it to be CPU simulator agnostic and should to work
1716
section 4.2). This core has no external run time or build time dependencies and has been tested with g++ on
1817
Linux as well as g++ on Cygwin on Windows.
1918

20-
21-
2 Getting DRAMSim2 ------------------
19+
2 Getting DRAMSim2--------------------------------------------------------------------------------
2220

2321
DRAMSim2 is available on github. If you have git installed you can clone our repository by typing:
2422

25-
$ git clone http://github.com/dramninjasUMD/DRAMSim2.git
23+
$ git clone git://github.com/dramninjasUMD/DRAMSim2.git
2624

27-
3 Building DRAMSim2 ------------------
25+
3 Building DRAMSim2--------------------------------------------------------------------------------
2826

2927
To build an optimized standalone trace-based simulator called DRAMSim simply type:
3028
$ make
@@ -35,9 +33,9 @@ To build the DRAMSim2 library, type:
3533
$ make libdramsim.so
3634

3735

38-
4 Running DRAMSim2 -------------------
36+
4 Running DRAMSim2--------------------------------------------------------------------------------
3937

40-
4.1 Trace-Based Simulation -----------
38+
4.1 Trace-Based Simulation--------------------------------------------------------------------------------
4139
In standalone mode, DRAMSim2 can simulate memory system traces. While traces are not as accurate as a
4240
real CPU model driving the memory model, they are convenient since they can be generated in a number of
4341
different ways (instrumentation, hardware traces, CPU simulation, etc.) and reused.
@@ -72,7 +70,7 @@ ton add support for your own trace formats.
7270
The prefix of the filename determines which type of trace this function will use (ex: k6 foo.trc) will use the k6
7371
format in parseTraceFileLine().
7472

75-
4.2 Library Interface
73+
4.2 Library Interface--------------------------------------------------------------------------------
7674

7775
In addition to simulating memory traces, DRAMSim2 can also be built as a dynamic shared library which
7876
is convenient for connecting it to CPU simulators or other custom front ends. A MemorySystem object
@@ -81,8 +79,6 @@ comprise DRAMSim2 can be seen in figure 1. A simple example application is provi
8179
directory. At this time we have plans to provide code to integrate DRAMSim2 into MARSSx86, SST, and
8280
(eventually) M5.
8381

84-
5 Example Output --------------------------------------
85-
8682
The verbosity of the DRAMSim2 can be customized in the system.ini file by turning the various debug flags on
8783
or off.
8884
Below, we have provided a detailed explanation of the simulator output. With all DEBUG flags enabled, the
@@ -190,11 +186,11 @@ The state of each bank in the system is also displayed:
190186
Banks can be in many states, including idle, row active (shown with the row that is active), refreshing, or
191187
precharging. These states will update based on the commands being sent by the controller.
192188

193-
6 Results Output ---------------------------------
189+
6 Results Output--------------------------------------------------------------------------------
194190

195191
In addition to printing memory statistics and debug information to standard out, DRAMSim2 also produces a
196192
'vis' file in the results/ directory. A vis file is essentially a summary of relevant statistics that is generated per
197-
epoch (the number of cycles per epoch can be set by changing the EPOCHCOUNT parameter in the system.ini
193+
epoch (the number of cycles per epoch can be set by changing the EPOCH_COUNT parameter in the system.ini
198194
file).
199195
We are currently working on DRAMVis, which is a cross-platform viewer which parses the vis file and generates
200196
graphs that can be used to analyze and compare results.

Rank.cpp

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
*
44
* Copyright (C) 2010 Elliott Cooper-Balis
55
* Paul Rosenfeld
6+
* Bruce Jacob
67
* University of Maryland
78
*
89
* This program is free software: you can redistribute it and/or modify
@@ -24,6 +25,7 @@
2425

2526

2627

28+
2729
#include "Rank.h"
2830
#include "MemoryController.h"
2931

0 commit comments

Comments
 (0)