Author: Avaneendra Gupta
Date  : February 07, 1998


Hello class,

Finally, your troubles MAY be over!!!

I have located a true SPIM/SAL simulator. This can actually handle
SAL code as well (in addition to MAL/TAL/MIPS code). It essentially
is an extension over the MIPS SPIM simulator you have been fighting
with so far.

For further information on this, read the web page
	http://clio.mit.csu.edu.au/subjects/itc222/spimsal.html

The instructions to install and use SPIM/SAL on UNIX are below.
PC-related instructions can be found on the above web page.

You should now be able to write and execute true SAL code that we
learn in class.

Good luck!
Avaneendra.

-----------------------------------------------------------------------------

- You can (and should) download the SPIM/SAL simulator and
  compile it in your area. The procedure for doing this is:

  - Get the file from ftp side
    1. ftp to the site ftp.cs.wisc.edu by logging in as "anonymous" and
       typing in your email as password
	sundance>ftp ftp.cs.wisc.edu
	Name (ftp.cs.wisc.edu:avigupta): anonymous
	Password: <TYPE IN YOUR EMAIL ADDRESS>
	ftp> cd pub/spimsal
	ftp> binary
	ftp> get spimsal.tar.Z

     2. Move file into directory called spim_sal in your area 
	(which you should have already made by typing "mkdir spim_sal" at the 
	UNIX command-line), and then uncompress and untar it.
	sundance> uncompress spimsal.tar.Z
	sundance> tar -xvf spimsal.tar

     3. Now, compile by doing the following:
	- Edit the file "Makefile"
	  - Change the path for TRAP_PATH to point to your directory
	    For example,
   TRAP_PATH = \"/afs/cats.ucsc.edu/users/v/jldunham/spim_sal/trap.handler\"
	  - Change the path for TOPDIR to point to the X11 root directory
	    	TOPDIR = /usr/X11R6.1/
	  - Add the line below immediately after the line for TOPDIR
		CC = gcc
	  - Change the line for IFLAG to following
		IFLAGS = -I$(TOPDIR) -I$(TOPDIR)/include
	  - Close the file Makefile

	- Now, compile by doing the following
	  - make spim
	  - make xspim

	4. Imvoke spim from UNIX by typing
		spim

	    Within spim, you can type help to get a list of commandfss you can use