== ISA ==
- befindet sich in 2_isa/
- requirements: latex und perl
- build: cd 2_isa; make

== ASM ==
- befindet sich in 3a_asm/
- requirements: ghc und zsh
- build: cd 3a_asm; make

== SIM ==
- befindet sich in 3b_sim/
- requirements: gcc/g++ > 4.4.0, boost > 1.37, readline
- build: cd 3b_sim; make
- remark: es koennte sein das die librarynamen in 3b_sim/Makefile.flags
  angepasst werden muessen

== DTPROG ==
- was: programmer ueber UART mittels BootROM
- befindet sich in tools/
- requirements: python2

== PROGS ==
- befindet sich in progs/
- mit "make build" kann man ASM und SIM builden
- "make name.dthex" ruft den ASM mit "name.s" auf. Das Ergebnis befindet sich in
  "name.dthex".
- "make name.sim" ruft den SIM mit dem Programm auf ("help" im SIM fuer
  Erklaerung)
- "make name.prog" flasht das Programm per DTPROG auf die CPU
- ACHTUNG: Baudrate und Device muss ggf. im progs/Makefile angepasst werden!
  Beim Quartus Projekt (siehe unten) ist eine Baudrate von 9600 eingestellt.

== HARDWARE DESIGN ==
- source befindet sich in cpu/src/
- passendes Quartus Projekt fuer die Cyclons im TILAB in dt/
- Image muss mit USBRunner auf das FPGA geladen werden
- Hinweis: fertiges Image liegt bereits im Rootverzeichnis
  ("tilab_bootrom_abgabe.rbf").
- Hinweis: Nach dem Flashen der CPU sollte die LED leuchten. LED an bedeutet,
  die CPU befindet sich im BootROM.
- Hinweis: Linker Button ist der "Hard-Reset" (return to BootROM)
- Hinweis: Rechter Button ist der "Soft-Reset" (Springe zum Start des Programms
  im Instruktion-RAM)
- generelles naming (außer UART): <name>_b.vhd ist behavior, <name>.vhd
  ist entity, <name>_pkg.vhd ist package. Mehrere Components sind oft 
  in einem Package zusammengefasst (Beispiel: core_pkg.vhd enthält alle
  pipeline components). Die Adressen für die Extension-Module findest du
  in extension_pkg.vhd.


== BOOTROM ==
- befindet sich in 2_isa/src/bootrom.s
- nach aenderungen mit ASM dthex file erstellen, mithilfe von tools/dthex2vhdl
   in vhdl "umwandeln" und in cpu/src/rom_b.vhd eintragen

Bei Fragen/Unklarheiten/Feedback/whatever kannst du uns gerne kontaktieren!

So long, and thanks for all the fish.