From c053d3799f5b396c90c98899e5165dd286f2b007 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=89der=20F=2E=20Zulian?= <zulian@eit.uni-kl.de>
Date: Tue, 9 Aug 2016 11:07:24 +0200
Subject: [PATCH] Readme updated with detailed information about 3d-ice
 installation

---
 README.md | 108 +++++++++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 94 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index c8d4551a..c9031a72 100644
--- a/README.md
+++ b/README.md
@@ -83,12 +83,13 @@ They are:
 
   For further information refer to http://qwt.sourceforge.net/
 
-- python3.4
+- python3.5
 
   In Debian like distros:
   
   ```bash
-  $ sudo apt-get install python3.4
+  $ sudo apt-get install python3.5
+  $ sudo apt-get install python3.5-dev
   ```
 
 - libboost_filesystem and libboost_system
@@ -257,6 +258,94 @@ For the trace analyzer the file /opt/local/Library/Frameworks/Python.framework/V
 
 ### DRAMSys Thermal Simulation 
 
+The thermal simulation is performed by a **3D-ICE** [8] server accessed
+through the network. Therefore users interested in thermal simulation during
+their DRAMSys simulations need to make sure they have a 3D-ICE server up and
+running before starting. For more information about 3D-ICE visit the official
+website http://esl.epfl.ch/3D-ICE.
+
+#### Installing the lastest 3D-ICE version
+
+Download the lastest version. Make sure you got version 2.2.6 or greater:
+
+``` bash
+$ wget http://esl.epfl.ch/files/content/sites/esl/files/3dice/releases/3d-ice-latest.zip
+$ tar -xvzf 3d-ice-latest.zip
+```
+
+Install SuperLU dependencies:
+
+``` bash
+$ sudo apt-get install build-essential git bison flex libblas-dev
+```
+
+Download and install SuperLU:
+
+``` bash
+$ wget http://crd.lbl.gov/~xiaoye/SuperLU/superlu_4.3.tar.gz
+$ tar xvfz superlu_4.3.tar.gz
+$ cd SuperLU_4.3/
+$ cp MAKE_INC/make.linux make.inc
+```
+
+Make sure the SuperLUroot variable in ./make.inc is properly set (in my case $(HOME)/repos/).
+
+``` bash
+SuperLUroot = $(HOME)/repos/SuperLU_4.3
+```
+
+Compile the library:
+
+``` bash
+$ make superlulib
+```
+
+Download and install bison-2.4.1:
+
+``` bash
+$ wget http://ftp.gnu.org/gnu/bison/bison-2.4.1.tar.gz
+$ tar xvzf bison-2.4.1.tar.gz
+$ cd bison-2.4.1
+$ ./configure --program-suffix=-2.4.1
+$ make
+$ sudo make install
+```
+
+Go to the 3d-ice directory:
+
+``` bash
+$ cd 3d-ice-2.2.6
+```
+
+Open the file makefile.def and set some variables. Set the correct path to the
+SuperLU library you just compiled (in my case $(HOME)/repos/):
+
+``` bash
+SLU_MAIN = $(HOME)/repos/SuperLU_$(SLU_VERSION)
+```
+
+Set the YACC variable to bison-2.4.1:
+
+``` bash
+YACC = bison-2.4.1
+```
+
+Set the systemC architecture and main folder variables:
+
+``` bash
+SYSTEMC_ARCH = [linux,linux64]
+SYSTEMC_MAIN = $(HOME)/repos/systemc-$(SYSTEMC_VERSION)
+```
+
+Compile 3D-ICE with SystemC/TLM2.0 support:
+
+``` bash
+$ make clean
+$ make SYSTEMC_WRAPPER=y
+```
+
+#### Running DRAMSys
+
 Before starting make sure you have a **clean repository** without any previous
 automatic generated Makefiles. One way to ensure this is by running the
 command below inside your DRAMSys repository, but keep in mind that
@@ -283,18 +372,9 @@ $ qmake ../DRAMSys/dram.vp.system.pro
 $ make
 ```
 
-The thermal simulation is performed by a **3D-ICE** [8] server accessed
-through the network. Therefore users interested in thermal simulation during
-their DRAMSys simulations need to make sure they have a 3D-ICE server up and
-running before starting.
-
-More information about how to obtain 3D-ICE and how to intall it can be found
-in the official website http://esl.epfl.ch/3D-ICE.
-
-Provided the user fulfilled this installation requisite, before starting
-DRAMSys it is necessary to run the 3D-ICE server passing to it two arguments:
-a suitable configuration file and an Internet socket port number. And then
-wait until the server is ready to receive requests.
+Before starting DRAMSys it is necessary to run the 3D-ICE server passing to it
+two arguments: a suitable configuration file and an Internet socket port
+number. And then wait until the server is ready to receive requests.
 
 ``` bash
 $ 3D-ICE-Server <stack file> <port>