################################################################################ 
- COME INSTALLARE L'EMULATORE MIPS E TOOLS VARI IN AMBIENTE LINUX UBUNTU - 
################################################################################

Legenda:
1- Installare l'emulatore SPIM
2- Installare tools grafici 
   2a - QtSpim
   2b - Mars

P.S.: quando date i comandi dal terminale, negli esempi qui riportati c'e' 
un $ o un #, non ricopiate quei simboli, sono solo di riferimento al prompt che 
voi vedete quando aprite un terminale.

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

### 1- Installare l'emulatore SPIM  ###
Per installare l'emulatore SPIM, aprite un terminale e date il seguente comando:

$ sudo apt-get install spim

Quando avra' finito l'esecuzione, avrete l'emulatore MIPS chiamato SPIM installato
nella vostra macchina. Con SPIM, viene installato anche xSPIM, un'interfaccia
grafica per la visualizzazione e l'esecuzione di file in assembly per MIPS. 
Qual'ora pero' non siate soddisfatti di esso, ci sono altri due ambienti grafici
alternativi: QtSpim e Mars.

### 2- Installare tools grafici ###

%%% 2a - QtSpim %%%
Il primo tool, QtSpim e' fatto con le librerie grafiche Qt, purtroppo per i S.O.
Linux viene distribuito come codice sorgente. Ma niente panico, ecco cosa dovete
fare. Aprite un terminale e date i seguenti comandi, uno alla volta:

$ sudo apt-get install qtcreator bison flex

Fatto cio', scaricate i due pacchetti che ci servono dai seguenti link e 
salvateli nella vostra home:

http://spimsimulator.svn.sourceforge.net/viewvc/spimsimulator/QtSpim/?view=tar
http://spimsimulator.svn.sourceforge.net/viewvc/spimsimulator/CPU/?view=tar

Sempre da terminale, date questi due comandi dopo che avrete scaricato 
i due pacchetti. Attenzione! I due pacchetti devono essere nella vostra home, e 
non in cartelle come Scaricati o simili:

$ tar -xzvf spimsimulator-QtSpim.tar.gz
$ tar -xzvf spimsimulator-CPU.tar.gz

Fatto questo dobbiamo compilare QtSpim, aprite QtCreator da 
Applicazioni->Programmazione e dal menu' File scegliete "Open File or Project"
quindi andate nella vostra home, li dovrebbe esserci una cartella chiamata QtSpim. 
Apritela e aprite il file chiamato QtSpim.pro.
A questo punto vi apparira' una finestra di dialogo, non preoccupatevi e cliccate
su "Finish".
Detto cio', cliccate sull'icona in basso a sinistra con un martello in cui e' scritto
"Build All".
Quando avra' completato l'operazione, aprite un terminale e date i seguenti comandi:


$ rm -r QtSpim
$ rm -r CPU
$ rm spimsimulator-QtSpim.tar.gz
$ rm spimsimulator-CPU.tar.gz
# su
# cp -r QtSpim-build-desktop /opt
# rm -r QtSpim-build-desktop
# cd /opt/QtSpim-build-desktop
# link QtSpim qtspim
# mv qtspim /usr/bin
# exit

A questo punto, potete eseguire il programma QtSpim da qualunque terminale, vi
bastera' dare da terminale il seguente comando:

$ qtspim

%%% 2b - Mars %%%
Mars e' un IDE, un ambiente grafico specializzato per la programmazione, in questo
caso per la programmazione con l'Assembly dei processori MIPS. Per installarlo,
basta che seguiate questi semplici passi (richiede una JVM, quindi assicuratevi
di aver installato Java nella vostra macchina):

$ wget http://courses.missouristate.edu/KenVollmar/MARS/MARS_4_1_Jan_2011/Mars_4_1.jar
$ su
# mv Mars_4_1.jar /opt
# cd /usr/bin
# touch mars
# gedit mars

L'editor di testo gedit vi aprira' un foglio bianco, dentro a questo foglio dovete
copia-incollare il seguente testo:

#! /bin/sh
exec java -jar opt/Mars_4_1.jar

Dopo aver incollato questo testo, salvate e chiudete gedit.
Date i seguenti comandi:

#chmod 755 mars
#exit

A questo punto, per eseguire il programma vi bastera' dare da terminale il 
seguente comando:

$ mars