- Install the following dependencies.
scons
libconfig++-dev
libboost-dev
libboost-iostreams-dev
libboost-serialization-dev
- Clone the timeloop repository.
mkdir timeloop-dev
cd timeloop-dev
git clone ssh://path/to/timeloop.git
- In addition to the main source code, you need the source code for a power-area-timing (pat) model to build timeloop. A placeholder pat model is included in the main repository. Before building timeloop, place a symbolic link to the pat model like so:
cd timeloop/src
ln -s ../pat-public/src/pat .
cd ..
- Instead of the included placeholder pat model, you may build against any
other custom pat model, as long as it exports the same interface as the
pat/pat.hpp in the included model. The implementation must be in a
pat/pat.cpp file. As before, create a symbolic link to the source code for
the power-area-timing model and place it in
src/pat, for example:
git clone ssh://path/to/timeloop-pat[XXX].git
cd timeloop/src
ln -s ../../timeloop-pat[XXX]/src/pat .
cd ..
- Once the pat link is set up, you can build timeloop using scons.
scons -j4
This builds 3 different tools:
-
timeloopis the complete application that instantiates an architecture, constructs its mapspace, searches for an optimal mapping within the mapspace and reports statistics for the optimal mapping. -
evaluatorinstantiates an architecture, evalutes a specific given mapping of a workload and reports the statistics. -
metricssimply instantiates an architecture and reports its workload-independent characteristics such as area and energy-per-access for various architectural structures. -
Run timeloop with a sample configuration.
cd configs/timeloop
../../build/timeloop ./sample.cfg > sample.out
This will place timeloop's log as well as simulation results in sample.out,
an XML-formatted copy of the simulation results in timeLoopOutput.xml, and
a copy of the full architecture configuration with the optimal mapping
baked-in in out.cfg.