1 |
2 |
dgisselq |
################################################################################
|
2 |
|
|
#
|
3 |
|
|
# Filename: Makefile
|
4 |
|
|
#
|
5 |
|
|
# Project: Zip CPU -- a small, lightweight, RISC CPU soft core
|
6 |
|
|
#
|
7 |
|
|
# Purpose: This makefile builds the final verilator simulation of the
|
8 |
|
|
# zipsystem. Specifically, it builds the final C++ portion
|
9 |
149 |
dgisselq |
# of the simulator, and thus the final simulator executable.
|
10 |
2 |
dgisselq |
#
|
11 |
149 |
dgisselq |
# This simulator depends upon the ncurses library.
|
12 |
2 |
dgisselq |
#
|
13 |
149 |
dgisselq |
# Useful targets of this makefile include:
|
14 |
2 |
dgisselq |
#
|
15 |
149 |
dgisselq |
# zippy_tb (default)
|
16 |
|
|
# This is the test bench program / simulator that is built by
|
17 |
|
|
# this directory.
|
18 |
|
|
#
|
19 |
|
|
# test
|
20 |
|
|
# Runs the simulator on a test program found in the trunk/sw/zasm
|
21 |
|
|
# directory. That program needs to be built via 'make test' in
|
22 |
|
|
# that directory before this make test will work. Changes to the
|
23 |
|
|
# test itself will require a 'make test' in trunk/sw/zasm as well
|
24 |
|
|
# as 'make test' in this directory.
|
25 |
|
|
#
|
26 |
|
|
# The test itself consists of two tests. The first, the "step"
|
27 |
|
|
# test, tests whether the test works via "step"ing the CPU.
|
28 |
|
|
# This would be the interface to the CPU were the CPU placed in
|
29 |
|
|
# a device.
|
30 |
|
|
#
|
31 |
|
|
# The second test is an internal test which works by just running
|
32 |
|
|
# the CPU without step instructions.
|
33 |
|
|
#
|
34 |
|
|
# In either case the test is over upon reaching either a HALT
|
35 |
|
|
# or a BUSY instruction. A HALT instruction indicates success,
|
36 |
|
|
# BUSY a failure.
|
37 |
|
|
#
|
38 |
|
|
# stest
|
39 |
|
|
# Runs the test in "step" mode as described above.
|
40 |
|
|
#
|
41 |
|
|
# itest
|
42 |
|
|
# Runs the test file in interactive mode. The CPU will not
|
43 |
|
|
# execute any instructions without user interaction. This is
|
44 |
|
|
# useful for actually debugging the test. The other two modes
|
45 |
|
|
# are useful for quickly determining that the CPU does (or
|
46 |
|
|
# doesn't) work.
|
47 |
|
|
#
|
48 |
|
|
# dhrystone
|
49 |
|
|
# Runs a hand-optimized version of the dhrystone benchmark.
|
50 |
|
|
# Using the instructions at the top of the dhrystone assembly
|
51 |
|
|
# file, you should be able to convert the result to DMIPS or even
|
52 |
|
|
# DMIPS/MHz.
|
53 |
|
|
#
|
54 |
|
|
# div_tb
|
55 |
|
|
# A raw test bench to test the divide unit separate from the
|
56 |
|
|
# rest of the CPU. This test will fail with a failed assert()
|
57 |
|
|
# if unsuccessful, or complete with no error (but lots of
|
58 |
|
|
# debugging output) if successful. To actually run this test,
|
59 |
|
|
# you'll need to run ./div_tb (no arguments necessary).
|
60 |
|
|
#
|
61 |
|
|
# pdump
|
62 |
|
|
# zippy_tb can be configured to produce a profile output that is
|
63 |
|
|
# very useful when debugging the Dhrystone benchmark. (It is
|
64 |
|
|
# so configured by default.) This file will be name pfile.bin.
|
65 |
|
|
# pdump is a very simple program designed to read this file and
|
66 |
|
|
# produce some (very raw) information from it. To use this,
|
67 |
|
|
# type pdump and the name of the executable file, such as
|
68 |
|
|
# ../asm/zipdhry.z, and examine how many times each instruction
|
69 |
|
|
# was executed, and how many stalls took place between each
|
70 |
|
|
# instruction and the next.
|
71 |
|
|
#
|
72 |
|
|
# clean
|
73 |
|
|
# Removes all products of compilation--specifically zippy_tb,
|
74 |
|
|
# pdump and div_tb.
|
75 |
|
|
#
|
76 |
|
|
#
|
77 |
2 |
dgisselq |
# Creator: Dan Gisselquist, Ph.D.
|
78 |
69 |
dgisselq |
# Gisselquist Technology, LLC
|
79 |
2 |
dgisselq |
#
|
80 |
|
|
################################################################################
|
81 |
|
|
#
|
82 |
159 |
dgisselq |
# Copyright (C) 2015-2016, Gisselquist Technology, LLC
|
83 |
2 |
dgisselq |
#
|
84 |
|
|
# This program is free software (firmware): you can redistribute it and/or
|
85 |
|
|
# modify it under the terms of the GNU General Public License as published
|
86 |
|
|
# by the Free Software Foundation, either version 3 of the License, or (at
|
87 |
|
|
# your option) any later version.
|
88 |
|
|
#
|
89 |
|
|
# This program is distributed in the hope that it will be useful, but WITHOUT
|
90 |
|
|
# ANY WARRANTY; without even the implied warranty of MERCHANTIBILITY or
|
91 |
|
|
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
92 |
|
|
# for more details.
|
93 |
|
|
#
|
94 |
|
|
# License: GPL, v3, as defined and found on www.gnu.org,
|
95 |
|
|
# http://www.gnu.org/licenses/gpl.html
|
96 |
|
|
#
|
97 |
|
|
#
|
98 |
|
|
################################################################################
|
99 |
|
|
#
|
100 |
149 |
dgisselq |
all: zippy_tb pdump div_tb
|
101 |
2 |
dgisselq |
|
102 |
69 |
dgisselq |
CXX := g++
|
103 |
|
|
FLAGS := -Wall -Og -g
|
104 |
76 |
dgisselq |
ZASM := ../../sw/zasm
|
105 |
69 |
dgisselq |
RTLD := ../../rtl
|
106 |
|
|
INCS := -I$(RTLD)/obj_dir/ -I$(RTLD) -I/usr/share/verilator/include -I$(ZASM)
|
107 |
2 |
dgisselq |
SOURCES := zippy_tb.cpp memsim.cpp twoc.cpp $(ZASM)/zopcodes.cpp $(ZASM)/zparser.cpp
|
108 |
69 |
dgisselq |
VLIB := /usr/share/verilator/include/verilated.cpp
|
109 |
|
|
RAWLIB := $(VLIB) $(RTLD)/obj_dir/Vzipsystem__ALL.a
|
110 |
159 |
dgisselq |
LIBS := $(RAWLIB) -lncurses -lelf
|
111 |
69 |
dgisselq |
TESTF := $(ZASM)/z.out
|
112 |
43 |
dgisselq |
DHRYSTONEF := ../asm/zipdhry.z
|
113 |
2 |
dgisselq |
|
114 |
36 |
dgisselq |
zippy_tb: $(SOURCES) $(RAWLIB) $(ZASM)/zopcodes.h $(ZASM)/zparser.h testb.h
|
115 |
39 |
dgisselq |
zippy_tb: $(RTLD)/cpudefs.h
|
116 |
2 |
dgisselq |
$(CXX) $(FLAGS) $(INCS) $(SOURCES) $(LIBS) -o $@
|
117 |
|
|
|
118 |
69 |
dgisselq |
div_tb: div_tb.cpp twoc.cpp $(VLIB) $(RTLD)/obj_dir/Vdiv__ALL.a testb.h
|
119 |
|
|
$(CXX) $(FLAGS) $(INCS) div_tb.cpp twoc.cpp $(VLIB) $(RTLD)/obj_dir/Vdiv__ALL.a -o $@
|
120 |
|
|
|
121 |
58 |
dgisselq |
pdump: pdump.cpp $(ZASM)/zopcodes.cpp $(ZASM)/zparser.cpp
|
122 |
|
|
pdump: $(ZASM)/zopcodes.h $(ZASM)/zparser.h testb.h twoc.cpp
|
123 |
185 |
dgisselq |
$(CXX) $(FLAGS) $(INCS) pdump.cpp $(ZASM)/zopcodes.cpp $(ZASM)/zparser.cpp twoc.cpp -lelf -o $@
|
124 |
58 |
dgisselq |
|
125 |
36 |
dgisselq |
.PHONY: stest
|
126 |
|
|
stest: zippy_tb
|
127 |
|
|
./zippy_tb -s $(TESTF)
|
128 |
|
|
|
129 |
|
|
.PHONY: itest
|
130 |
27 |
dgisselq |
itest: zippy_tb
|
131 |
|
|
./zippy_tb $(TESTF)
|
132 |
|
|
|
133 |
36 |
dgisselq |
.PHONY: test
|
134 |
|
|
test: zippy_tb stest
|
135 |
27 |
dgisselq |
./zippy_tb -a $(TESTF)
|
136 |
36 |
dgisselq |
|
137 |
43 |
dgisselq |
.PHONY: dhrystone
|
138 |
|
|
dhrystone: zippy_tb
|
139 |
|
|
./zippy_tb -a $(DHRYSTONEF)
|
140 |
|
|
|
141 |
36 |
dgisselq |
.PHONY: clean
|
142 |
|
|
clean:
|
143 |
76 |
dgisselq |
rm ./zippy_tb pdump div_tb
|