################################################################################
|
################################################################################
|
#
|
#
|
# Filename: Makefile
|
# Filename: Makefile
|
#
|
#
|
# Project: Zip CPU -- a small, lightweight, RISC CPU soft core
|
# Project: Zip CPU -- a small, lightweight, RISC CPU soft core
|
#
|
#
|
# Purpose: This makefile builds the final verilator simulation of the
|
# Purpose: This makefile builds the final verilator simulation of the
|
# zipsystem. Specifically, it builds the final C++ portion
|
# zipsystem. Specifically, it builds the final C++ portion
|
# of the simulator, and thus the final simulator executable.
|
# of the simulator, and thus the final simulator executable.
|
#
|
#
|
# This simulator depends upon the ncurses library.
|
# This simulator depends upon the ncurses library.
|
#
|
#
|
# Useful targets of this makefile include:
|
# Useful targets of this makefile include:
|
#
|
#
|
# zippy_tb (default)
|
# zippy_tb (default)
|
# This is the test bench program / simulator that is built by
|
# This is the test bench program / simulator that is built by
|
# this directory.
|
# this directory.
|
#
|
#
|
# test
|
# test
|
# Runs the simulator on a test program found in the trunk/sw/zasm
|
# Runs the simulator on a test program found in the trunk/sw/zasm
|
# directory. That program needs to be built via 'make test' in
|
# directory. That program needs to be built via 'make test' in
|
# that directory before this make test will work. Changes to the
|
# that directory before this make test will work. Changes to the
|
# test itself will require a 'make test' in trunk/sw/zasm as well
|
# test itself will require a 'make test' in trunk/sw/zasm as well
|
# as 'make test' in this directory.
|
# as 'make test' in this directory.
|
#
|
#
|
# The test itself consists of two tests. The first, the "step"
|
# The test itself consists of two tests. The first, the "step"
|
# test, tests whether the test works via "step"ing the CPU.
|
# test, tests whether the test works via "step"ing the CPU.
|
# This would be the interface to the CPU were the CPU placed in
|
# This would be the interface to the CPU were the CPU placed in
|
# a device.
|
# a device.
|
#
|
#
|
# The second test is an internal test which works by just running
|
# The second test is an internal test which works by just running
|
# the CPU without step instructions.
|
# the CPU without step instructions.
|
#
|
#
|
# In either case the test is over upon reaching either a HALT
|
# In either case the test is over upon reaching either a HALT
|
# or a BUSY instruction. A HALT instruction indicates success,
|
# or a BUSY instruction. A HALT instruction indicates success,
|
# BUSY a failure.
|
# BUSY a failure.
|
#
|
#
|
# stest
|
# stest
|
# Runs the test in "step" mode as described above.
|
# Runs the test in "step" mode as described above.
|
#
|
#
|
# itest
|
# itest
|
# Runs the test file in interactive mode. The CPU will not
|
# Runs the test file in interactive mode. The CPU will not
|
# execute any instructions without user interaction. This is
|
# execute any instructions without user interaction. This is
|
# useful for actually debugging the test. The other two modes
|
# useful for actually debugging the test. The other two modes
|
# are useful for quickly determining that the CPU does (or
|
# are useful for quickly determining that the CPU does (or
|
# doesn't) work.
|
# doesn't) work.
|
#
|
#
|
# dhrystone
|
# dhrystone
|
# Runs a hand-optimized version of the dhrystone benchmark.
|
# Runs a hand-optimized version of the dhrystone benchmark.
|
# Using the instructions at the top of the dhrystone assembly
|
# Using the instructions at the top of the dhrystone assembly
|
# file, you should be able to convert the result to DMIPS or even
|
# file, you should be able to convert the result to DMIPS or even
|
# DMIPS/MHz.
|
# DMIPS/MHz.
|
#
|
#
|
# div_tb
|
# div_tb
|
# A raw test bench to test the divide unit separate from the
|
# A raw test bench to test the divide unit separate from the
|
# rest of the CPU. This test will fail with a failed assert()
|
# rest of the CPU. This test will fail with a failed assert()
|
# if unsuccessful, or complete with no error (but lots of
|
# if unsuccessful, or complete with no error (but lots of
|
# debugging output) if successful. To actually run this test,
|
# debugging output) if successful. To actually run this test,
|
# you'll need to run ./div_tb (no arguments necessary).
|
# you'll need to run ./div_tb (no arguments necessary).
|
#
|
#
|
# pdump
|
# pdump
|
# zippy_tb can be configured to produce a profile output that is
|
# zippy_tb can be configured to produce a profile output that is
|
# very useful when debugging the Dhrystone benchmark. (It is
|
# very useful when debugging the Dhrystone benchmark. (It is
|
# so configured by default.) This file will be name pfile.bin.
|
# so configured by default.) This file will be name pfile.bin.
|
# pdump is a very simple program designed to read this file and
|
# pdump is a very simple program designed to read this file and
|
# produce some (very raw) information from it. To use this,
|
# produce some (very raw) information from it. To use this,
|
# type pdump and the name of the executable file, such as
|
# type pdump and the name of the executable file, such as
|
# ../asm/zipdhry.z, and examine how many times each instruction
|
# ../asm/zipdhry.z, and examine how many times each instruction
|
# was executed, and how many stalls took place between each
|
# was executed, and how many stalls took place between each
|
# instruction and the next.
|
# instruction and the next.
|
#
|
#
|
# clean
|
# clean
|
# Removes all products of compilation--specifically zippy_tb,
|
# Removes all products of compilation--specifically zippy_tb,
|
# pdump and div_tb.
|
# pdump and div_tb.
|
#
|
#
|
#
|
#
|
# Creator: Dan Gisselquist, Ph.D.
|
# Creator: Dan Gisselquist, Ph.D.
|
# Gisselquist Technology, LLC
|
# Gisselquist Technology, LLC
|
#
|
#
|
################################################################################
|
################################################################################
|
#
|
#
|
# Copyright (C) 2015-2016, Gisselquist Technology, LLC
|
# Copyright (C) 2015-2016, Gisselquist Technology, LLC
|
#
|
#
|
# This program is free software (firmware): you can redistribute it and/or
|
# This program is free software (firmware): you can redistribute it and/or
|
# modify it under the terms of the GNU General Public License as published
|
# modify it under the terms of the GNU General Public License as published
|
# by the Free Software Foundation, either version 3 of the License, or (at
|
# by the Free Software Foundation, either version 3 of the License, or (at
|
# your option) any later version.
|
# your option) any later version.
|
#
|
#
|
# This program is distributed in the hope that it will be useful, but WITHOUT
|
# This program is distributed in the hope that it will be useful, but WITHOUT
|
# ANY WARRANTY; without even the implied warranty of MERCHANTIBILITY or
|
# ANY WARRANTY; without even the implied warranty of MERCHANTIBILITY or
|
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
# for more details.
|
# for more details.
|
#
|
#
|
# License: GPL, v3, as defined and found on www.gnu.org,
|
# License: GPL, v3, as defined and found on www.gnu.org,
|
# http://www.gnu.org/licenses/gpl.html
|
# http://www.gnu.org/licenses/gpl.html
|
#
|
#
|
#
|
#
|
################################################################################
|
################################################################################
|
#
|
#
|
all: zippy_tb pdump div_tb
|
all: zippy_tb pdump div_tb
|
|
|
CXX := g++
|
CXX := g++
|
FLAGS := -Wall -Og -g
|
FLAGS := -Wall -Og -g
|
ZASM := ../../sw/zasm
|
ZASM := ../../sw/zasm
|
RTLD := ../../rtl
|
RTLD := ../../rtl
|
INCS := -I$(RTLD)/obj_dir/ -I$(RTLD) -I/usr/share/verilator/include -I$(ZASM)
|
INCS := -I$(RTLD)/obj_dir/ -I$(RTLD) -I/usr/share/verilator/include -I$(ZASM)
|
SOURCES := zippy_tb.cpp memsim.cpp twoc.cpp $(ZASM)/zopcodes.cpp $(ZASM)/zparser.cpp
|
SOURCES := zippy_tb.cpp memsim.cpp twoc.cpp $(ZASM)/zopcodes.cpp $(ZASM)/zparser.cpp
|
VLIB := /usr/share/verilator/include/verilated.cpp
|
VLIB := /usr/share/verilator/include/verilated.cpp
|
RAWLIB := $(VLIB) $(RTLD)/obj_dir/Vzipsystem__ALL.a
|
RAWLIB := $(VLIB) $(RTLD)/obj_dir/Vzipsystem__ALL.a
|
LIBS := $(RAWLIB) -lncurses -lelf
|
LIBS := $(RAWLIB) -lncurses -lelf
|
TESTF := $(ZASM)/z.out
|
TESTF := $(ZASM)/z.out
|
DHRYSTONEF := ../asm/zipdhry.z
|
DHRYSTONEF := ../asm/zipdhry.z
|
|
|
zippy_tb: $(SOURCES) $(RAWLIB) $(ZASM)/zopcodes.h $(ZASM)/zparser.h testb.h
|
zippy_tb: $(SOURCES) $(RAWLIB) $(ZASM)/zopcodes.h $(ZASM)/zparser.h testb.h
|
zippy_tb: $(RTLD)/cpudefs.h
|
zippy_tb: $(RTLD)/cpudefs.h
|
$(CXX) $(FLAGS) $(INCS) $(SOURCES) $(LIBS) -o $@
|
$(CXX) $(FLAGS) $(INCS) $(SOURCES) $(LIBS) -o $@
|
|
|
div_tb: div_tb.cpp twoc.cpp $(VLIB) $(RTLD)/obj_dir/Vdiv__ALL.a testb.h
|
div_tb: div_tb.cpp twoc.cpp $(VLIB) $(RTLD)/obj_dir/Vdiv__ALL.a testb.h
|
$(CXX) $(FLAGS) $(INCS) div_tb.cpp twoc.cpp $(VLIB) $(RTLD)/obj_dir/Vdiv__ALL.a -o $@
|
$(CXX) $(FLAGS) $(INCS) div_tb.cpp twoc.cpp $(VLIB) $(RTLD)/obj_dir/Vdiv__ALL.a -o $@
|
|
|
pdump: pdump.cpp $(ZASM)/zopcodes.cpp $(ZASM)/zparser.cpp
|
pdump: pdump.cpp $(ZASM)/zopcodes.cpp $(ZASM)/zparser.cpp
|
pdump: $(ZASM)/zopcodes.h $(ZASM)/zparser.h testb.h twoc.cpp
|
pdump: $(ZASM)/zopcodes.h $(ZASM)/zparser.h testb.h twoc.cpp
|
$(CXX) $(FLAGS) $(INCS) pdump.cpp $(ZASM)/zopcodes.cpp $(ZASM)/zparser.cpp twoc.cpp -o $@
|
$(CXX) $(FLAGS) $(INCS) pdump.cpp $(ZASM)/zopcodes.cpp $(ZASM)/zparser.cpp twoc.cpp -lelf -o $@
|
|
|
.PHONY: stest
|
.PHONY: stest
|
stest: zippy_tb
|
stest: zippy_tb
|
./zippy_tb -s $(TESTF)
|
./zippy_tb -s $(TESTF)
|
|
|
.PHONY: itest
|
.PHONY: itest
|
itest: zippy_tb
|
itest: zippy_tb
|
./zippy_tb $(TESTF)
|
./zippy_tb $(TESTF)
|
|
|
.PHONY: test
|
.PHONY: test
|
test: zippy_tb stest
|
test: zippy_tb stest
|
./zippy_tb -a $(TESTF)
|
./zippy_tb -a $(TESTF)
|
|
|
.PHONY: dhrystone
|
.PHONY: dhrystone
|
dhrystone: zippy_tb
|
dhrystone: zippy_tb
|
./zippy_tb -a $(DHRYSTONEF)
|
./zippy_tb -a $(DHRYSTONEF)
|
|
|
.PHONY: clean
|
.PHONY: clean
|
clean:
|
clean:
|
rm ./zippy_tb pdump div_tb
|
rm ./zippy_tb pdump div_tb
|
|
|