Subversion Repositories forth-cpu

#
# Makefile to simulate and synthesize VHDL designs
#
# @Author      Marc Eberhard/Richard Howe
# @Copyright   Copyright 2013 Marc Eberhard, 2016 Richard Howe
# @License     LGPL
#
# This makefile can build the toolchain, simulators, and the bit
# file for the FPGA. Type "make help" at the command line for a
# list of options
#

NETLIST=top
#TIME=time -p 
TIME=

OS_FLAGS =
# From: https://stackoverflow.com/questions/714100/os-detecting-makefile
ifeq ($(OS),Windows_NT)
GUI_LDFLAGS = -lfreeglut -lopengl32 -lm 
DF=
EXE=.exe

.PHONY: h2 gui text block

h2:     h2.exe
gui:    gui.exe
text:   text.exe
block:  block.exe

else # assume unixen
GUI_LDFLAGS = -lglut -lGL -lm 
DF=./
EXE=
endif

.PHONY: simulation viewer synthesis bitfile upload clean run gui-run 

## Remember to update the synthesis section as well
SOURCES = \
        util.vhd \
        timer.vhd \
        uart.vhd \
        kbd.vhd \
        vga.vhd \
        h2.vhd \
        ram.vhd \
        core.vhd \
        led.vhd 

OBJECTS = ${SOURCES:.vhd=.o}

all:
        @echo ""
        @echo "Simulation:"
        @echo ""
        @echo "make simulation     - simulate VHDL design"
        @echo "make viewer         - start waveform viewer for simulation results"
        @echo "make documentation  - build the PDF and HTML documentation"
        @echo "make h2${EXE}             - build C based CLI emulator for the VHDL SoC"
        @echo "make gui${EXE}            - build C based GUI emulator for the Nexys3 board"
        @echo "make run            - run the C CLI emulator on h2.fth"
        @echo "make gui-run        - run the GUI emulator on h2.hex"
        @echo ""
        @echo "Synthesis:"
        @echo ""
        @echo "make synthesis      - synthesize design"
        @echo "make implementation - implement design"
        @echo "make bitfile        - generate bitfile"
        @echo ""
        @echo "Upload:"
        @echo ""
        @echo "make upload         - upload design to FPGA"
        @echo ""
        @echo "Cleanup:"
        @echo ""
        @echo "make clean          - delete temporary files and cleanup directory"
        @echo ""

## Documentation ===========================================================

documentation: readme.pdf readme.htm

%.pdf: %.md
        pandoc -V geometry:margin=0.5in --toc $< -o $@

%.htm: %.md
        pandoc --toc --self-contained $^ -o $@

## Assembler ===============================================================

%.hex: %.fth h2${EXE}
        ${DF}h2 -S h2.sym -a $< > $@

## Virtual Machine and UART communications =================================

CFLAGS=-Wall -Wextra -O2 -g

h2${EXE}: h2.c h2.h
        ${CC} ${CFLAGS} -std=c99 $< -o $@

disassemble: h2${EXE} h2.fth
        ${DF}h2 -S h2.sym -a h2.fth > h2.hex
        ${DF}h2 -L h2.sym h2.hex | awk '{printf "%04x %s\n", NR-1, $$0;}' | less -

block${EXE}: block.c
        ${CC} ${CFLAGS} -std=c99 $< -o $@

h2.sym: h2.hex

nvram.blk: nvram.txt h2.sym block${EXE} 
        ${DF}block${EXE} < nvram.txt >  $@
        ${DF}block${EXE} < h2.sym    >> $@

# %.blk: %.txt block${EXE}
#       ${DF}block${EXE} < $< > $@

run: h2${EXE} h2.fth nvram.blk
        ${DF}h2 -H -R h2.fth

h2nomain.o: h2.c h2.h
        ${CC} ${CFLAGS} -std=c99 -DNO_MAIN  $< -c -o $@

gui.o: gui.c h2.h
        ${CC} ${CFLAGS} -std=gnu99  $< -c -o $@

gui${EXE}: h2nomain.o gui.o
        ${CC} ${CFLAGS} $^ ${GUI_LDFLAGS} -o $@

gui-run: gui${EXE} h2.hex nvram.blk text.hex
        ${DF}$< h2.hex

text${EXE}: text.c
        ${CC} ${CFLAGS} -std=c99 $< -o $@

text.hex: text${EXE}
        ${DF}$< -g > $@

## Simulation ==============================================================

%.o: %.vhd
        ghdl -a $<

ram.o: util.o
led.o: util.o led.vhd
kbd.o: util.o kbd.vhd
vga.o: util.o vga.vhd text.hex font.bin
core.o: util.o h2.o core.vhd h2.hex
uart.o: util.o uart.vhd
top.o: util.o timer.o core.o uart.o vga.o kbd.o led.o ram.o top.vhd 
tb.o: top.o util.o tb.vhd 

tb: ${OBJECTS} tb.o
        ghdl -e tb

%.ghw: % %.cfg
        ghdl -r $< --wave=$<.ghw

simulation: tb.ghw h2${EXE}

## Simulation ==============================================================


# gtkwave -S signals -f tb.ghw &> /dev/null&

ifeq ($(OS),Windows_NT)
viewer: simulation
        gtkwave -S signals -f tb.ghw 
else
viewer: simulation
        gtkwave -S signals -f tb.ghw &> /dev/null&
endif

USB?=/dev/ttyUSB0

talk:
        picocom --omap delbs -e b -b 115200 ${USB}

bitfile: design.bit

reports:
        @[ -d reports    ]    || mkdir reports
tmp:
        @[ -d tmp        ]    || mkdir tmp
tmp/_xmsgs:
        @[ -d tmp/_xmsgs ]    || mkdir tmp/_xmsgs

tmp/top.prj: tmp
        @rm -f tmp/top.prj
        @( \
            for f in $(SOURCES); do \
                echo "vhdl work \"$$f\""; \
            done; \
            echo "vhdl work \"top.vhd\"" \
        ) > tmp/top.prj

tmp/top.lso: tmp
        @echo "work" > tmp/top.lso

tmp/top.xst: tmp tmp/_xmsgs tmp/top.lso tmp/top.lso
        @( \
            echo "set -tmpdir \"tmp\""; \
            echo "set -xsthdpdir \"tmp\""; \
            echo "run"; \
            echo "-lso tmp/top.lso"; \
            echo "-ifn tmp/top.prj"; \
            echo "-ofn top"; \
            echo "-p xc6slx16-csg324-3"; \
            echo "-top top"; \
            echo "-opt_mode speed"; \
            echo "-opt_level 2" \
        ) > tmp/top.xst

synthesis: h2.hex text.hex reports tmp tmp/_xmsgs tmp/top.prj tmp/top.xst
        @echo "Synthesis running..."
        @${TIME} xst -intstyle silent -ifn tmp/top.xst -ofn reports/xst.log
        @mv _xmsgs/* tmp/_xmsgs
        @rmdir _xmsgs
        @mv top_xst.xrpt tmp
        @grep "ERROR\|WARNING" reports/xst.log | \
         grep -v "WARNING.*has a constant value.*This FF/Latch will be trimmed during the optimization process." | \
         cat

implementation: reports tmp
        @echo "Implementation running..."
        
        @[ -d tmp/xlnx_auto_0_xdb ] || mkdir tmp/xlnx_auto_0_xdb

        @${TIME} ngdbuild -intstyle silent -quiet -dd tmp -uc top.ucf -p xc6slx16-csg324-3 top.ngc top.ngd
        @mv top.bld reports/ngdbuild.log
        @mv _xmsgs/* tmp/_xmsgs
        @rmdir _xmsgs
        @mv xlnx_auto_0_xdb/* tmp
        @rmdir xlnx_auto_0_xdb
        @mv top_ngdbuild.xrpt tmp

        @${TIME} map -intstyle silent -detail -p xc6slx16-csg324-3 -pr b -c 100 -w -o top_map.ncd top.ngd top.pcf
        @mv top_map.mrp reports/map.log
        @mv _xmsgs/* tmp/_xmsgs
        @rmdir _xmsgs
        @mv top_usage.xml top_summary.xml top_map.map top_map.xrpt tmp

        @${TIME} par -intstyle silent -w -ol std top_map.ncd top.ncd top.pcf
        @mv top.par reports/par.log
        @mv top_pad.txt reports/par_pad.txt
        @mv _xmsgs/* tmp/_xmsgs
        @rmdir _xmsgs
        @mv par_usage_statistics.html top.ptwx top.pad top_pad.csv top.unroutes top.xpi top_par.xrpt tmp
        
        @#trce -intstyle silent -v 3 -s 3 -n 3 -fastpaths -xml top.twx top.ncd -o top.twr top.pcf -ucf top.ucf
        @#mv top.twr reports/trce.log
        @#mv _xmsgs/* tmp/_xmsgs
        @#rmdir _xmsgs
        @#mv top.twx tmp

        @#netgen -intstyle silent -ofmt vhdl -sim -w top.ngc top_xsim.vhd
        @#netgen -intstyle silent -ofmt vhdl -sim -w -pcf top.pcf top.ncd top_tsim.vhd
        @#mv _xmsgs/* tmp/_xmsgs
        @#rmdir _xmsgs
        @#mv top_xsim.nlf top_tsim.nlf tmp


design.bit: reports tmp/_xmsgs
        @echo "Generate bitfile running..."
        @touch webtalk.log
        @${TIME} bitgen -intstyle silent -w top.ncd
        @mv top.bit design.bit
        @mv top.bgn reports/bitgen.log
        @mv _xmsgs/* tmp/_xmsgs
        @rmdir _xmsgs
        @sleep 5
        @mv top.drc top_bitgen.xwbt top_usage.xml top_summary.xml webtalk.log tmp
        @grep -i '\(warning\|clock period\)' reports/xst.log

upload: 
        djtgcfg prog -d Nexys3 -i 0 -f design.bit

design: clean simulation synthesis implementation bitfile

postsyn:
        @netgen -w -ofmt vhdl -sim ${NETLIST}.ngc post_synthesis.vhd
        @netgen -w -ofmt vhdl -sim ${NETLIST}.ngd post_translate.vhd
        @netgen  -pcf ${NETLIST}.pcf -w -ofmt vhdl -sim ${NETLIST}.ncd post_map.vhd


clean:
        @echo "Deleting temporary files and cleaning up directory..."
        @rm -vf *~ *.o trace.dat tb tb.ghw work-obj93.cf top.ngc top.ngd top_map.ngm \
              top.pcf top_map.ncd top.ncd top_xsim.vhd top_tsim.vhd top_tsim.sdf \
              top_tsim.nlf top_xst.xrpt top_ngdbuild.xrpt top_usage.xml top_summary.xml \
              top_map.map top_map.xrpt par_usage_statistics.html top.ptwx top.pad top_pad.csv \
              top.unroutes top.xpi top_par.xrpt top.twx top.nlf design.bit top_map.mrp 
        @rm -vrf _xmsgs reports tmp xlnx_auto_0_xdb
        @rm -vrf _xmsgs reports tmp xlnx_auto_0_xdb
        @rm -vrf h2${EXE} gui${EXE} block${EXE} text${EXE}
        @rm -vrf text.bin h2.hex text.hex
        @rm -vrf *.pdf *.htm
        @rm -vrf *.blk *.sym
        @rm -vrf xst/
        @rm -vf usage_statistics_webtalk.html
        @rm -vf mem_h2.binary mem_h2.hexadecimal