sanchayanmaity/gem5 - Sanchayan Maity's repositories

Go to file

Akash Bagdia 7d7ab73862 sim: Add the notion of clock domains to all ClockedObjects This patch adds the notion of source- and derived-clock domains to the ClockedObjects. As such, all clock information is moved to the clock domain, and the ClockedObjects are grouped into domains. The clock domains are either source domains, with a specific clock period, or derived domains that have a parent domain and a divider (potentially chained). For piece of logic that runs at a derived clock (a ratio of the clock its parent is running at) the necessary derived clock domain is created from its corresponding parent clock domain. For now, the derived clock domain only supports a divider, thus ensuring a lower speed compared to its parent. Multiplier functionality implies a PLL logic that has not been modelled yet (create a separate clock instead). The clock domains should be used as a mechanism to provide a controllable clock source that affects clock for every clocked object lying beneath it. The clock of the domain can (in a future patch) be controlled by a handler responsible for dynamic frequency scaling of the respective clock domains. All the config scripts have been retro-fitted with clock domains. For the System a default SrcClockDomain is created. For CPUs that run at a different speed than the system, there is a seperate clock domain created. This domain incorporates the CPU and the associated caches. As before, Ruby runs under its own clock domain. The clock period of all domains are pre-computed, such that no virtual functions or multiplications are needed when calling clockPeriod. Instead, the clock period is pre-computed when any changes occur. For this to be possible, each clock domain tracks its children.		2013-06-27 05:49:49 -04:00
build_opts	config: add atomic cpu to X86_MESI_CMP_directory build options	2013-06-08 21:57:02 -05:00
configs	sim: Add the notion of clock domains to all ClockedObjects	2013-06-27 05:49:49 -04:00
ext	ext lib: add libfdt to enable flattened device tree support	2013-02-15 18:48:59 -05:00
src	sim: Add the notion of clock domains to all ClockedObjects	2013-06-27 05:49:49 -04:00
system	ARM: Fix issue with with way MPIDR is read to include affinity levels.	2012-09-07 14:20:53 -05:00
tests	sim: Add the notion of clock domains to all ClockedObjects	2013-06-27 05:49:49 -04:00
util	util: Auto generate the packet proto definitions	2013-05-30 12:53:53 -04:00
.hgignore	.hgignore: added src/doxygen	2010-07-27 20:00:38 -07:00
.hgtags	Added tag stable_2013_06_16 for changeset 07352f119e48	2013-06-16 08:27:42 -05:00
COPYING	copyright: Add code for finding all copyright blocks and create a COPYING file	2011-06-02 17:36:07 -07:00
LICENSE	copyright: Add code for finding all copyright blocks and create a COPYING file	2011-06-02 17:36:07 -07:00
README	gem5: Update the README file to be a bit less out-of-date.	2012-09-25 11:49:40 -05:00
SConstruct	scons: ammend swig warning error to version 2.0.10 as well	2013-06-04 15:17:04 -05:00

README

This is the gem5 simulator.

For detailed information about building the simulator and getting
started please refer to:
* The main website:     http://www.gem5.org
* Documentation wiki:   http://www.gem5.org/Documentation 
* Doxygen generated:    http://www.gem5.org/docs
* Tutorials:            http://www.gem5.org/Tutorials


Specific pages of interest are:
http://www.gem5.org/Introduction
http://www.gem5.org/Build_System
http://www.gem5.org/Dependencies
http://www.gem5.org/Running_gem5

Short version:
External tools and required versions

To build gem5, you will need the following software:
g++ version 4.3 or newer.
Python, version 2.4 - 2.7 (we don't support Python 3.X). gem5 links in the 
    Python interpreter, so you need the Python header files and shared 
    library (e.g., /usr/lib/libpython2.4.so) in addition to the interpreter
    executable. These may or may not be installed by default. For example,
    on Debian/Ubuntu, you need the "python-dev" package in addition to the
    "python" package. If you need a newer or different Python installation
     but can't or don't want to upgrade the default Python on your system,
     see http://www.gem5.org/Using_a_non-default_Python_installation
SCons, version 0.98.1 or newer. SCons is a powerful replacement for make. 
    If you don't have administrator privileges on your machine, you can use the
    "scons-local" package to install scons in your m5 directory, or install SCons
    in your home directory using the '--prefix=' option.  
SWIG, version 1.3.34 or newer
zlib, any recent version. For Debian/Ubuntu, you will need the "zlib-dev" or
    "zlib1g-dev" package to get the zlib.h header file as well as the library
    itself.
m4, the macro processor.


4. In this directory, type 'scons build/<ARCH>/gem5.opt' where ARCH is one
of ALPHA, ARM, MIPS, POWER, SPARC, or X86. This will build an optimized version
of the gem5 binary (gem5.opt) for the the specified architecture.

If you have questions, please send mail to gem5-users@gem5.org

WHAT'S INCLUDED (AND NOT)
-------------------------

The basic source release includes these subdirectories:
 - gem5:
   - configs: example simulation configuration scripts
   - ext: less-common external packages needed to build gem5
   - src: source code of the gem5 simulator
   - system: source for some optional system software for simulated systems
   - tests: regression tests
   - util: useful utility programs and files

To run full-system simulations, you will need compiled system firmware
(console and PALcode for Alpha), kernel binaries and one or more disk images. 
Please see the gem5 download page for these items at http://www.gem5.org/Download