Anleitung zur Installation von BSVC unter Solaris und Linux     11.04.02
------------------------------------------------------------
Eine Schritt für Schritt Anleitung für weniger erfahrene Solaris- und
Linux-Benutzer

Auf
  http://www.informatik.uni-kiel-de/~infp00/praktikum.html
läßt sich unter
  ip300 -> BSVC A Microprozessor Simulation Framework
von der Seite des Autors Bradford W. Mott
die Datei
  bsvc-2.1-src.tar.gz
herunterladen.

Unter 
  ip300 -> ip301 -> Erweiterung des BSVC2.1 um die BCD-Befehle
ist eine erweiterte Datei  exec.cxx  erhältlich.

(Die Windowsversion liegt nur in einer Binärversion vor, ist gegenüber
 der Version für Linux/Solaris stark eingeschränkt.)

Compilation und Installation ( as) al) -> Solaris bzw. Linux):

as) gtar xvzf bsvc-2.1-src.tar.gz
    cd bsvc-2.1/src
al) tar xvzf bsvc-2.1-src.tar.gz
    cd bsvc-2.1/src

Makefile.common editieren:

b) PROJECT_BASE = /home/bwmott/projects/bsvc/development/bsvc
   ersetzen durch den aktuellen Pfad, z.B.
   PROJECT_BASE =/home/hugo/bsvc-2.1

   INSTALL_DIR = $(PROJECT_BASE)/bin
   ersetzen durch das gewünschte Installationsverzeichnis, z.B.
   INSTALL_DIR =/home/hugo/local/bin
   /home/hugo/local/bin muß in Suchpfad für PATH eingetragen sein, werden.
   
   WISH         = wish
   ersetzen durch
   WISH         = /opt/local/bin/wish
   bzw. unter Linux suchen mit "wich wish"

   SIMULATORS = sim68000 sim68360
   #SIMULATORS = sim68000
   ersetzen durch
   #SIMULATORS = sim68000 sim68360
   SIMULATORS = sim68000

cs) Makefile.Solaris editieren:

    CXXFLAGS = -O -D_G_NO_EXTERN_TEMPLATES
    ersetzen durch
    CXXFLAGS = -pedantic -O -D_G_NO_EXTERN_TEMPLATES

cl) Makefile.Linux editieren:

    CXXFLAGS = -O -ansi -Wall -D_G_NO_EXTERN_TEMPLATES
    ersetzen durch
    CXXFLAGS = -pedantic -O -D_G_NO_EXTERN_TEMPLATES

ds) Compilieren und Installieren (Solaris):

    Die Datei
    /home/hugo/bsvc-2.1/src/sim68000/cpu/exec.cxx
    ersetzen durch die oben angegebene um BCD-Befehle erweiterte Datei
    exec.cxx

    make -f Makefile.Solaris clean
    make -f Makefile.Solaris
    make -f Makefile.Solaris install

    oder für Linux mit Makefile.Linux

dl) Compilieren und Installieren (Linux):
 
    dito mit -f Makefile.Linux

e)  Aufräumen und testen
   
    Um Platz zu sparen, kann das Verzeichnis src gelöscht werden.

    rm -r src
   
    Dokumentation in doc/ lesen

    Ein erster Test:
   
    cd samples/m68000
    bsvc
      File -> Open Setup -> serial.setup
      File -> Load Program -> example.h68
      Window -> Program Listing
      -> Reset (Setze u.a. den P(rogram)C(ounter) auf die Programmstartadresse)
      -> Single Step

f)  Assemblerprogramme schreiben:

    Benutzte Dateien:
      program.s    Die Quelldatei in M68000-Assembler
      program.h68  Die assemblierte Datei in einem besonderen Ladeformat
      program.lis  Die Quelldatei, ergänzt um den Maschinencode in 
                   hexadezimaler Darstellung

    Mit beliebigem Editor die Quelldatei  program.s  erstellen

    Assemblieren:
      68kasm -l program.s
    erzeugt die oben angegebenen Dateien program.h68 und program.lis


( Die Angaben gelten für  gcc version 2.95.3 )