====== Installation ======

===== Benötigte Komponenten =====

Um mit Hilfe von MB-Ref ein komplettes Linux System auf einem Xilinx FPGA integrieren zu können werden benötigt:
  * Entwicklungssystem auf Linux Basis
  * Synthetisierung eines der Referenzdesigns und Datenexport für andere Betriebssysteme:
    * ++Xilinx ISE|[[http://www.xilinx.com/support/download|DOWNLOAD]]++ Version 11.4 für ältere Spartan-3, Version 12.2 ++aktuell| --- //[[linz@li-pro.net|Stephan Linz]] 2010/10/10 08:48//++
    * Lizenzierung für eine Embedded oder System Edition
    * MB-Ref in aktueller Version
  * Kompilierung des Linux System:
    * GNU Cross Toolchain für Microblaze Linux
    * PTXdist als Build System
    * OSELAS.BSP-Xilinx-Microblaze-Reference in aktueller Version

===== Entwicklungssystem =====

Alle hier beschriebenen Installationsschritte beziehen sich auf ein voll eingerichtetes Linux Betriebssystem, vornehmlich Desktop System mit funktionierender X11 GUI. Dabei sollten folgende Pakete zusätzlich eingerichtet und getestet sein:
  * **sudo** -- Programm zum deligieren von Root-Rechten
  * **mc** -- GNU Midnight Commander
  * **vim** -- Vi IMproved, eine Version des "beliebten" UNIX Editor Vi
  * **git** -- beliebtes Version-Kontrollsystem für richtig große Projekte
  * **ckermit** -- C-Kermit ist ein kombiniertes Kommunikationssoftwarepaket für serielle Schnittstellen und Netzwerke
  * **wget** -- CLI-Werkzeug um Daten von einer Web-Seite zu beziehen

===== Xilinx ISE =====

Für eine Installation bitte den Anweisungen unterhalb von [[administration:xilinx_ise_unter_linux:start|Xilinx ISE unter Linux]] folgen.

===== GNU Cross Toolchain für Microblaze Linux =====

Von Xilinx selbst wird über ihr eigenes [[http://git.xilinx.com/|GIT Repository]] eine komplett fertig übersetzte GNU Cross Toolchain für Microblaze Linux als Zielsystem angeboten. Diese sollte auch genutzt werden. Wer Zugriff auf die GNU Cross Toolchain von PetaLogix hat, kann auch diese nutzen ([[projects:embedded:xilinx_mb:mbref:todo:microblaze_gnu_toolchain|Analysen dazu]]).

Zur Installation wird das TBZ Archiv vom Xilinx GIT Repository heruntergeladen (**87.2MB**) und unter /opt ausgepackt:
<code>
user@host: cd /opt
user@host: wget -O /tmp/mb_gnu_tools_bin.tar.bz "http://git.xilinx.com/?p=xldk/microblaze_v1.0.git;a=blob_plain;f=mb_gnu_tools_bin.tar.bz;hb=HEAD"
 ...
user@host: sudo tar xvjf /tmp/mb_gnu_tools_bin.tar.bz
</code>

==== Vorbereitung für PTXdist ====

Um später diese Toolchain von PTXdist auch sicher nutzen zu können, muss diese gekennzeichnet werden. Dazu wird einfach ein Versions-String im ''bin'' Verzeichnis hinterlegt:
<code>
user@host: sudo sh -c "echo 'export PTXCONF_PROJECT=\"Xilinx MicroBlaze Tools v1.0 (20090928.125627)\"' >/opt/microblaze-unknown-linux-gnu/bin/ptxconfig"
</code>

===== PTXdist =====

Für eine Installation bitte den Anweisungen unterhalb von [[administration:ptxdist:start|PTXdist]] folgen.

===== Git vorbereiten =====

Pakete installieren, wenn noch nicht erfolgt:
++++ Ubuntu |
<code>
user@host: sudo apt-get install git-core git-doc gitk
</code>
++++

Informationen über den Autor:
<code>
user@host: git config --global user.name "Your Name Comes Here"
user@host: git config --global user.email you@yourdomain.example.com
</code>

Ausgaben farblich hervorgehoben:
<code>
user@host: git config --global color.branch auto
user@host: git config --global color.diff auto
user@host: git config --global color.interactive auto
user@host: git config --global color.status auto
</code>

Bevorzugten Editor und Merge-Werkzeug angeben:
<code>
user@host: git config --global core.editor "vim"
user@host: git config --global merge.tool "kdiff3"
</code>

FIXME An einen besseren Ort verschieben und hier nur drauf verseisen.

===== Microblaze References =====

Git Archive klonen (**>20MB**):
<code>
user@host: git clone git://github.com/mbref/mbref.git
</code>

===== OSELAS.BSP-Xilinx-Microblaze-Reference =====

Git Archive klonen (**>5MB**):
<code>
user@host: git clone git://github.com/mbref/oselas-bsp-mbref.git
</code>