[[PageOutline]]

L'installation de la plate forme Morpheo ce fait en trois étapes.
 1. La première consiste à rapatrier les sources du projet
 1. Ensuite d'installer les logiciels tiers utiliser par Morpheo
 1. Enfin finaliser l'installation de Morpheo

L'interpréteur de commandes utilisé est le ''bash''. 

= Source du projet =
Voici les étapes à suivre afin de rapatrier les sources du projet :
 1. Placez vous dans le répertoire qui va contenir les sources de Morpheo
 1. Vous avez deux manières d'acquérir les sources de morpheo :
   1. En téléchargeant la version en développement du projet. Cette version n'est pas forcément dans un état stable.
      Pour cela, exécutez la commande suivante :
      {{{
       svn co https://www-asim.lip6.fr/svn/morpheo/trunk/ Morpheo
      }}}
      Cette commande va placer dans le répertoire courant, un répertoire ''Morpheo'' contenant la version en développement du projet.
   1. Soit en récupérant une archive du projet (disponible sur ce [wiki:fr-Archive#Archive lien]). La nomenclature de l'archive est disponible sur ce [wiki:fr-Archive#Nomenclature lien].
      Pour décompresser l'archive, exécutez la commande suivante :
      {{{
       tar xvjf morpheo-x.y.z.tar.bz2
      }}}
 1. Le répertoire courant contient maintenant un répertoire ''Morpheo''. Pour utiliser utiliser Morpheo, il faut positionner quelques variables d'environnement. Pour ce faire, placez vous dans le répertoire ''Morpheo'' nouvellement crée et lancer le script suivant :
{{{
. ./environment.sh
}}}
 Parmi toutes les variables d'environnement, il y a celle qui indique la racine du projet morpheo : MORPHEO_TOPLEVEL


= Installation des outils =

Nous allons maintenant installer les outils réaliser par des tiers, utilisé par la librairie Morpheo. 
Ces applications peuvent soit être récupéré sur le site de ces outils, soit dans le répertoire ${MORPHEO_TOPLEVEL}/Tools. Dans le dernier cas, les fichiers présents sont ce répertoire sont indiqués par un "*".

== SystemC ==
||Site    ||[http://www.systemc.org/]     ||
||Version ||2.2.0                         ||
||Fichiers||systemc-2.2.0.tgz             ||

SystemC est un langage de description de matériel.
Pour l'installer, effectuez les étapes suivantes :

 1. Décompressez l'archive
{{{
tar xvf systemc-2.2.0.tgz
}}}
 1. Créez un répertoire qui va contenir les sources compilées.
{{{
cd systemc-2.2.0/
mkdir objdir
cd objdir
}}}
 1. Lancez le script de configuration. L'option --prefix cible le répertoire qui va contenir les binaires et les libraries.
{{{
mkdir /opt/systemc-2.2.0;
../configure --prefix=/opt/systemc-2.2.0;
}}}
 1. Lancez la compilation
{{{
make
make install
}}}
 1. La commande suivante test l'installation de SystemC 
{{{
make check
}}}

== !SystemCass ==
||Site    ||[https://www-asim.lip6.fr/trac/systemcass]||
||Version ||11_05_2007                    ||
||Fichiers||systemcass_11_05_2007.tar.bz *||
||        ||systemc_tests-2.1.v1.tgz      ||

!SystemCass est un simulateur compatible SystemC ([http://www.systemc.org/]).
Pour l'installer, effectuez les étapes suivantes :

 1. Décompressez l'archive
{{{
tar xvjf systemcass_11_05_2007.tar.bz 
}}}
 1. Positionner la variable d'environnement SYSTEMC vers le répertoire cible 
{{{
export SYSTEMC=/opt/systemcass
export SYSTEMCASS=${SYSTEMC}
}}}
 1. Dans le répertoire crée (en l'occurence systemcass_11_05_2007), allez dans le répertoire src
{{{
cd systemcass_11_05_2007/src
}}}
 1. Créez le répertoire cible, s'il n'existe pas
{{{
mkdir -p ${SYSTEMC}
}}}
 1. Lancez la compilation
{{{
make all
}}}

== or1k - binutils ==
||Site    ||[http://www.beyondsemi.com/page/products/processor_cores/openrisc]||
||Version ||2.16.1                      ||
||Fichiers||or1k_binutils.tar.gz *      ||

Il s'agit d'un ensemble d'outils de développement logiciel.
Pour les installer, effectuez les étapes suivantes :

 1. Décompressez l'archive
{{{
tar xzvf or1k_binutils.tar.gz
}}}
 1. Créez un répertoire qui va contenir les sources compilées.
{{{
cd or1k
mkdir or32-elf-binutils
cd or32-elf-binutils
}}}
 1. Lancez le script de configuration. L'option --prefix cible le répertoire qui va contenir les binaires et les libraries.
{{{
../binutils-2.16.1/configure --target=or32-elf --prefix=/opt/or32-elf
}}}
 1. Lancez la compilation
{{{
make
make install
}}}
== or1k - gcc ==
||Site    ||[http://www.beyondsemi.com/page/products/processor_cores/openrisc]||
||Version ||3.4.4                       ||
||Fichiers||or1k_gcc.tar.gz *           ||

Il s'agit d'une collection de logiciels libres intégrés capables de compiler divers langages de programmation.
Pour les installer, effectuez les étapes suivantes :

 1. Modifiez la variables d'environnement PATH pour inclure les binaires des binutils
{{{
export PATH=/opt/or32-elf/bin:$PATH
}}}
 1. Décompressez l'archive
{{{
tar xzvf or1k_gcc.tar.gz
}}}
 1. Créez un répertoire qui va contenir les sources compilées.
{{{
cd or1k
mkdir or32-elf-gcc
cd or32-elf-gcc
}}}
 1. Lancez le script de configuration. L'option --prefix cible le répertoire qui va contenir les binaires et les libraries.
{{{
../gcc-3.4.4/configure --target=or32-elf --with-gnu-as --with-gnu-ld --disable-threads --enable-languages=c --prefix=/opt/or32-elf
}}}
 1. Lancez la compilation
{{{
make
make install
}}}
== Newlib ==
||Site    ||[http://sourceware.org/newlib/]||
||Version ||1.17.0                      ||
||Fichiers||newlib-1.17.0.tar.gz *      ||

Il s'agit d'une implémentation de la librairie standard C pour systèmes embarqués.
 1. Modifiez la variables d'environnement PATH pour inclure les binaires des binutils
{{{
export PATH=/opt/or32-elf/bin:$PATH
}}}
 1. Décompressez l'archive
{{{
tar xvzf newlib-1.17.0.tar.gz
}}}
 1. Appliquer le patch pour que newlib supporte la plate-forme de simulation de morpheo
{{{
patch -Np1 -d newlib-1.17.0 < ${MORPHEO_TOPLEVEL}/Tools/newlib-1.17.0.patch
}}}
 1. Créez un répertoire qui va contenir les sources compilées.
{{{
mkdir newlib-or32
cd newlib-or32
}}}
 1. Lancez le script de configuration. L'option --prefix cible le répertoire qui va contenir les binaires et les libraries.
{{{
../newlib-1.17.0/configure --host=or32 --target=or32-elf --prefix=/opt/newlib
}}}
 1. Lancez la compilation
{{{
make
make install
}}}

== Xlinx ISE WebPACK ==
||Site    ||[http://www.xilinx.com/ise/logic_design_prod/webpack.htm]||
||Version ||10.1                        ||
||Fichiers||?                           ||

C'est environnement de développement intégré. Il contient un simulateur ainsi qu'un synthétiseur pour les FPGA xilinx.

= Finalisation de l'installation de Morpheo =

Voici les dernières étapes pour finaliser l'installation de Morpheo
 1. Editez le fichier ${MORPHEO_TOPLEVEL}/Makefile.tools. Ce fichier contient la liste des commandes unix ainsi que les outils utilisés. Vérifiez l'emsemble des informations présentes.
 1. Editez également le fichier ${MORPHEO_TOPLEVEL}/Makefile.tools_path. Il contient les chemins d'accès vers les différents outils.
 1. Vous êtes fin prêt pour faire quelques tests

= Test de l'installation =
 1. Allez dans le répertoire principal de morpheo
 1. Positionnez les sources du project
{{{
. environment.sh
}}}
 1. Allez dans le répertoire de la plate-forme de test
{{{
cd Platforms/Test/
}}}
 1. Lancer les compilations :
   1. Des applications à simuler
{{{
make soft
}}}
   1. Des sources du projet, ainsi que de l'environnement de simulation
{{{
make lib
}}}
 1. Lancer les simulations
{{{
make run
}}}