ec60aef6b662c8f47884e6208175b6e9958c8b93
[calu.git] / README
1 == ISA ==
2 - befindet sich in 2_isa/
3 - requirements: latex und perl
4 - build: cd 2_isa; make
5
6 == ASM ==
7 - befindet sich in 3a_asm/
8 - requirements: ghc und zsh
9 - build: cd 3a_asm; make
10
11 == SIM ==
12 - befindet sich in 3b_sim/
13 - requirements: gcc/g++ > 4.4.0, boost > 1.37, readline
14 - build: cd 3b_sim; make
15 - remark: es koennte sein das die librarynamen in 3b_sim/Makefile.flags
16   angepasst werden muessen
17
18 == DTPROG ==
19 - was: programmer ueber UART mittels BootROM
20 - befindet sich in tools/
21 - requirements: python2
22
23 == PROGS ==
24 - befindet sich in progs/
25 - mit "make build" kann man ASM und SIM builden
26 - "make name.dthex" ruft den ASM mit "name.s" auf. Das Ergebnis befindet sich in
27   "name.dthex".
28 - "make name.sim" ruft den SIM mit dem Programm auf ("help" im SIM fuer
29   Erklaerung)
30 - "make name.prog" flasht das Programm per DTPROG auf die CPU
31 - ACHTUNG: Baudrate und Device muss ggf. im progs/Makefile angepasst werden!
32   Beim Quartus Projekt (siehe unten) ist eine Baudrate von 9600 eingestellt.
33
34 == HARDWARE DESIGN ==
35 - source befindet sich in cpu/src/
36 - passendes Quartus Projekt fuer die Cyclons im TILAB in dt/
37 - Image muss mit USBRunner auf das FPGA geladen werden
38 - Hinweis: fertiges Image liegt bereits im Rootverzeichnis
39   ("tilab_bootrom_abgabe.rbf").
40 - Hinweis: Nach dem Flashen der CPU sollte die LED leuchten. LED an bedeutet,
41   die CPU befindet sich im BootROM.
42 - Hinweis: Linker Button ist der "Hard-Reset" (return to BootROM)
43 - Hinweis: Rechter Button ist der "Soft-Reset" (Springe zum Start des Programms
44   im Instruktion-RAM)
45
46 == BOOTROM ==
47 - befindet sich in 2_isa/src/bootrom.s
48 - nach aenderungen mit ASM dthex file erstellen, mithilfe von tools/dthex2vhdl
49    in vhdl "umwandeln" und in cpu/src/rom_b.vhd eintragen
50
51 Bei Fragen/Unklarheiten/Feedback/whatever kannst du uns gerne kontaktieren!
52
53 So long, and thanks for all the fish.