Computer Architecture Simulation Models
DOWNLOADING, INSTALLING & USING HASE
Using one of the downloadable HASE models requires you:
- to be able to run HASE
- to have your own copy of the model files
The downloadable version of HASE includes both the code for HASE and
an installer that works with Linux, Windows, MACs and Intel MACs
().
( Users at the School of Informatics, University of Edinburgh,
do not need to download HASE; it is publicly available at
/group/project/public-hase/HASE-III/Hase).
REQUIREMENTS
Prior to downloading and installing HASE, please ensure that your
system satisfies the following requirements:
- System Requirements:
- Java 1.5
- GCC V3.x.x.x or higher
- libstdc++.so.6
- Linux: Fedora Core 3 or later
- Windows: cygwin
- Symbolic Link Requirements:
- To check that a symbolic link exists to java, use:
java -version
the result should be:
java version "1.5.x.x"
- To check that a symbolic link exists to GCC, use:  
g++ --version
the result should be:
g++ (GCC) 3.x.x.xxxxxxxxx (OS information)
If either of these links does not exist, but the required versions of
Java and GCC are installed on your system, then before continuing,
make links to them using the `alias' command in your .brc file, or by
setting symbolic links.
INSTALLATION
The code for HASE is available in the form of a jar file that includes
its own installer. The most recent version (17th July 2007) is 1.2.1.2.
This version fixes a few minor bugs in version 1.2 and runs faster on large
simulations.
To install HASE-III, execute the following from a terminal with an
X-Server:
- Download Setup_HASE_III_1.2.1.2.jar
into an appropriate directory
- Enter this directory:
cd /Directory_Containing_Setup_HASE_III_1.2.1.2.jar/
- If you have root access:
- Enable root access:
su
Password:xxxxxxx
- Run the installer: java -jar Setup_HASE_III_1.2.1.2.jar
- Follow the installer instructions, selecting `Install for Everyone' on
the option page.
- Check that the installer has selected the right operating system
- If you do not have root access:
- Run the installer: java -jar Setup_HASE_III_1.2.1.2.jar
- Follow the installer instructions, selecting Select `Install
for Just Me' in the installation options. Make sure you choose an
appropriate installation directory (e.g. not /opt in
MAC OS X). After the installer finishes in this mode, you will have to
make your own aliases to /HaseInstallDirectory/bin/Hase to be able to
run Hase
MODEL FILES
To make you own copy of the model files, create a models
subdirectory/folder in your own filespace and download the relevant
<model_name>.tar.gz file using the link on the
website for the model. To extract the files, run
gunzip <model_name>.tar.gz
followed by
tar xvf <model_name>.tar
This will create a subdirectory for the model containing all the files
needed to create your own version.
RUNNING HASE
Type: Hase&
HASE-III will default its open dialog box to the directory from which
it is run.
To use the model, move to the subdirectory/folder for the model and
start up HASE. The file menu or the left most icon in the HASE window
can be used to open a selection window and the project is loaded by
selecting
<model_name>.edl. Then compile the project
using the Build Project option in the Project menu (or the
build icon).
To run the simulation, use the Simulate option in the Project
menu (or the run icon). During the simulation, HASE writes a trace
file into a Results subdirectory
(model_name.sim). When the simulation stops, load the
trace file using the Load Trace File option in the
Project menu (or the clock icon). When the tracefile is
loaded, the animation buttons will light up. Using these buttons you
can play the animation, stop it, single step it, re-wind it, etc.
Selecting the parameters tab in the Project Inspector panel allows
changes in the values of entity parameters to be observed during
simulation. These include register and memory contents, for example.
The parameter display of each entity can dragged out of the main
display into a separate window either by clicking on the hatched area
at the left of by left clicking on the entity's icon whilst holding
down the shift key (though the latter option is currently unavailable
on MACs). If the window is closed, it re-docks with the main display.
DOCUMENTATION
A User Guide for HASE can be accessed via the Help command in the Menu
Bar (select Index). This User Guide is also available on the HASE
website at HASE
User Guide. The latter will generally be more up to date, since
updating the Guide in the HASE application requires a new release
of HASE itself.
DISCLAIMERS, ETC
- The Help facility is still under construction; the Hase++ section
in particular is incomplete.
- There are still a few bugs in the HASE code (e.g. using
the Help facility can sometimes throw java errors - just close
HASE and start again).
- Some files for some of the models contain some redundant code
left over from development.
- In case of difficulties, please send email to
icsa-sec@inf.ed.ac.uk
and we'll try to help.
Return
to Computer Architecture Simulation Models
HASE Project
Institute for Computing Systems Architecture, School of Informatics,
University of Edinburgh
Last change 20/07/2006
Please contact our
webadmin with any comments or changes.
Unless explicitly stated otherwise, all material is
copyright © The University of Edinburgh.