mirror of
https://github.com/verilator/verilator.git
synced 2025-01-09 16:17:36 +00:00
f5b1a5cd58
While GNU 'ar' supports '@' to specify a file, BSD 'ar' does not. The max line length can be handled by 'xargs' instead, which will know to break up the command. In case there are multiple calls, only build the index (specified with '-s') once in a later call.
333 lines
10 KiB
Makefile
333 lines
10 KiB
Makefile
# -*- Makefile -*-
|
|
######################################################################
|
|
# DESCRIPTION: Makefile commands for all verilated target files
|
|
#
|
|
# Copyright 2003-2022 by Wilson Snyder. This program is free software; you
|
|
# can redistribute it and/or modify it under the terms of either the GNU
|
|
# Lesser General Public License Version 3 or the Perl Artistic License
|
|
# Version 2.0.
|
|
# SPDX-License-Identifier: LGPL-3.0-only OR Artistic-2.0
|
|
######################################################################
|
|
|
|
AR = @AR@
|
|
CXX = @CXX@
|
|
LINK = @CXX@
|
|
OBJCACHE ?= @OBJCACHE@
|
|
PERL = @PERL@
|
|
PYTHON3 = @PYTHON3@
|
|
|
|
CFG_WITH_CCWARN = @CFG_WITH_CCWARN@
|
|
CFG_WITH_LONGTESTS = @CFG_WITH_LONGTESTS@
|
|
|
|
# Compiler flags to enable profiling
|
|
CFG_CXXFLAGS_PROFILE = @CFG_CXXFLAGS_PROFILE@
|
|
# Select newest language
|
|
CFG_CXXFLAGS_STD_NEWEST = @CFG_CXXFLAGS_STD_NEWEST@
|
|
# Compiler flags to use to turn off unused and generated code warnings, such as -Wno-div-by-zero
|
|
CFG_CXXFLAGS_NO_UNUSED = @CFG_CXXFLAGS_NO_UNUSED@
|
|
# Compiler flags that turn on extra warnings
|
|
CFG_CXXFLAGS_WEXTRA = @CFG_CXXFLAGS_WEXTRA@
|
|
# Linker libraries for multithreading
|
|
CFG_LDLIBS_THREADS = @CFG_LDLIBS_THREADS@
|
|
|
|
######################################################################
|
|
# Programs
|
|
|
|
VERILATOR_COVERAGE = $(PERL) $(VERILATOR_ROOT)/bin/verilator_coverage
|
|
VERILATOR_INCLUDER = $(PERL) $(VERILATOR_ROOT)/bin/verilator_includer
|
|
VERILATOR_CCACHE_REPORT = $(PYTHON3) $(VERILATOR_ROOT)/bin/verilator_ccache_report
|
|
|
|
######################################################################
|
|
# Make checks
|
|
|
|
ifneq ($(words $(CURDIR)),1)
|
|
$(error Unsupported: GNU Make cannot build in directories containing spaces, build elsewhere: '$(CURDIR)')
|
|
endif
|
|
|
|
######################################################################
|
|
# C Preprocessor flags
|
|
|
|
# Add -MMD -MP if you're using a recent version of GCC.
|
|
VK_CPPFLAGS_ALWAYS += \
|
|
-MMD \
|
|
-I$(VERILATOR_ROOT)/include \
|
|
-I$(VERILATOR_ROOT)/include/vltstd \
|
|
-DVM_COVERAGE=$(VM_COVERAGE) \
|
|
-DVM_SC=$(VM_SC) \
|
|
-DVM_TRACE=$(VM_TRACE) \
|
|
-DVM_TRACE_FST=$(VM_TRACE_FST) \
|
|
$(CFG_CXXFLAGS_NO_UNUSED) \
|
|
|
|
ifeq ($(CFG_WITH_CCWARN),yes) # Local... Else don't burden users
|
|
VK_CPPFLAGS_WALL += -Wall $(CFG_CXXFLAGS_WEXTRA) -Werror
|
|
endif
|
|
|
|
CPPFLAGS += -I. $(VK_CPPFLAGS_WALL) $(VK_CPPFLAGS_ALWAYS)
|
|
|
|
VPATH += ..
|
|
VPATH += $(VERILATOR_ROOT)/include
|
|
VPATH += $(VERILATOR_ROOT)/include/vltstd
|
|
|
|
#OPT = -ggdb -DPRINTINITSTR -DDETECTCHANGE
|
|
#OPT = -ggdb -DPRINTINITSTR
|
|
CPPFLAGS += $(OPT)
|
|
|
|
CPPFLAGS += $(M32)
|
|
LDFLAGS += $(M32)
|
|
|
|
# Allow upper level user makefiles to specify flags they want.
|
|
# These aren't ever set by Verilator, so users are free to override them.
|
|
CPPFLAGS += $(USER_CPPFLAGS)
|
|
LDFLAGS += $(USER_LDFLAGS)
|
|
LDLIBS += $(USER_LDLIBS)
|
|
|
|
# Add flags from -CFLAGS and -LDFLAGS on Verilator command line
|
|
CPPFLAGS += $(VM_USER_CFLAGS)
|
|
LDFLAGS += $(VM_USER_LDFLAGS)
|
|
LDLIBS += $(VM_USER_LDLIBS)
|
|
|
|
######################################################################
|
|
# Optimization control.
|
|
|
|
# See also the BENCHMARKING & OPTIMIZATION section of the manual.
|
|
|
|
# Optimization flags for non performance-critical/rarely executed code.
|
|
# No optimization by default, which improves compilation speed.
|
|
OPT_SLOW =
|
|
# Optimization for performance critical/hot code. Most time is spent in these
|
|
# routines. Optimizing by default for improved execution speed.
|
|
OPT_FAST = -Os
|
|
# Optimization applied to the common run-time library used by verilated models.
|
|
# For compatibility this is called OPT_GLOBAL even though it only applies to
|
|
# files in the run-time library. Normally there should be no need for the user
|
|
# to change this as the library is small, but can have significant speed impact.
|
|
OPT_GLOBAL = -Os
|
|
|
|
#######################################################################
|
|
##### Profile builds
|
|
|
|
ifeq ($(VM_PROFC),1)
|
|
CPPFLAGS += $(CFG_CXXFLAGS_PROFILE)
|
|
LDFLAGS += $(CFG_CXXFLAGS_PROFILE)
|
|
endif
|
|
|
|
#######################################################################
|
|
##### SystemC builds
|
|
|
|
ifeq ($(VM_SC),1)
|
|
CPPFLAGS += $(SYSTEMC_CXX_FLAGS) $(addprefix -I, $(SYSTEMC_INCLUDE))
|
|
LDFLAGS += $(SYSTEMC_CXX_FLAGS) $(addprefix -L, $(SYSTEMC_LIBDIR))
|
|
SC_LIBS = -lsystemc
|
|
ifneq ($(wildcard $(SYSTEMC_LIBDIR)/*numeric_bit*),)
|
|
# Systemc 1.2.1beta
|
|
SC_LIBS += -lnumeric_bit -lqt
|
|
endif
|
|
endif
|
|
|
|
#######################################################################
|
|
##### Threaded builds
|
|
|
|
ifneq ($(VM_C11),0)
|
|
ifneq ($(VM_C11),)
|
|
VK_C11=1
|
|
endif
|
|
endif
|
|
|
|
ifneq ($(VM_THREADS),0)
|
|
ifneq ($(VM_THREADS),)
|
|
CPPFLAGS += -DVL_THREADED
|
|
VK_C11=1
|
|
VK_LIBS_THREADED=1
|
|
endif
|
|
endif
|
|
|
|
ifneq ($(VM_TRACE_THREADS),0)
|
|
ifneq ($(VM_TRACE_THREADS),)
|
|
ifeq ($(findstring -DVL_THREADED,$(CPPFLAGS)),)
|
|
$(error VM_TRACE_THREADS requires VM_THREADS)
|
|
endif
|
|
CPPFLAGS += -DVL_TRACE_THREADED
|
|
VK_C11=1
|
|
VK_LIBS_THREADED=1
|
|
endif
|
|
endif
|
|
|
|
|
|
ifneq ($(VM_TRACE_FST_WRITER_THREAD),0)
|
|
ifneq ($(VM_TRACE_FST_WRITER_THREAD),)
|
|
CPPFLAGS += -DVL_TRACE_FST_WRITER_THREAD
|
|
VK_C11=1
|
|
VK_LIBS_THREADED=1
|
|
endif
|
|
endif
|
|
|
|
ifneq ($(VK_C11),0)
|
|
ifneq ($(VK_C11),)
|
|
# Need C++11 at least, so always default to newest
|
|
CPPFLAGS += $(CFG_CXXFLAGS_STD_NEWEST)
|
|
endif
|
|
endif
|
|
|
|
ifneq ($(VK_LIBS_THREADED),0)
|
|
ifneq ($(VK_LIBS_THREADED),)
|
|
LDLIBS += $(CFG_LDLIBS_THREADS)
|
|
endif
|
|
endif
|
|
|
|
#######################################################################
|
|
### Aggregates
|
|
|
|
VM_FAST += $(VM_CLASSES_FAST) $(VM_SUPPORT_FAST)
|
|
VM_SLOW += $(VM_CLASSES_SLOW) $(VM_SUPPORT_SLOW)
|
|
|
|
#######################################################################
|
|
### Overall Objects Linking
|
|
|
|
VK_FAST_OBJS = $(addsuffix .o, $(VM_FAST))
|
|
VK_SLOW_OBJS = $(addsuffix .o, $(VM_SLOW))
|
|
|
|
VK_USER_OBJS = $(addsuffix .o, $(VM_USER_CLASSES))
|
|
|
|
# Note VM_GLOBAL_FAST and VM_GLOBAL_SLOW holds the files required from the
|
|
# run-time library. In practice everything is actually in VM_GLOBAL_FAST,
|
|
# but keeping the distinction for compatibility for now.
|
|
VK_GLOBAL_OBJS = $(addsuffix .o, $(VM_GLOBAL_FAST) $(VM_GLOBAL_SLOW))
|
|
|
|
ifneq ($(VM_PARALLEL_BUILDS),1)
|
|
# Fast build for small designs: All .cpp files in one fell swoop. This
|
|
# saves total compute, but can be slower if only a little changes. It is
|
|
# also a lot slower for medium to large designs when the speed of the C
|
|
# compiler dominates, which in this mode is not parallelizable.
|
|
|
|
VK_OBJS += $(VM_PREFIX)__ALL.o
|
|
$(VM_PREFIX)__ALL.cpp: $(addsuffix .cpp, $(VM_FAST) $(VM_SLOW))
|
|
$(VERILATOR_INCLUDER) -DVL_INCLUDE_OPT=include $^ > $@
|
|
all_cpp: $(VM_PREFIX)__ALL.cpp
|
|
else
|
|
# Parallel build: Each .cpp file by itself. This can be somewhat slower for
|
|
# very small designs and examples, but is a lot faster for large designs.
|
|
|
|
VK_OBJS += $(VK_FAST_OBJS) $(VK_SLOW_OBJS)
|
|
endif
|
|
|
|
# When archiving just objects (.o), use single $(AR) run
|
|
# 1. Make .verilator_deplist.tmp file with list of objects so don't exceed
|
|
# the command line limits when calling $(AR).
|
|
# The approach to write the dependency file is compatible with GNU Make 3,
|
|
# and can be simplified using the file function once GNU Make 4.x becomes
|
|
# the minimum supported version.
|
|
# When merging objects (.o) and archives (.a) additionally:
|
|
# 1. Extract object files from .a
|
|
# 2. Create a new archive from extracted .o and given .o
|
|
%.a: | %.verilator_deplist.tmp
|
|
$(info Archive $(AR) -rcs $@ $^)
|
|
$(foreach L, $(filter-out %.a,$^), $(shell echo $L >>$@.verilator_deplist.tmp))
|
|
@if test $(words $(filter %.a,$^)) -eq 0; then \
|
|
$(RM) -f $@; \
|
|
cat $@.verilator_deplist.tmp | xargs $(AR) -rc $@; \
|
|
$(AR) -s $@; \
|
|
else \
|
|
$(RM) -rf $@.tmpdir; \
|
|
for archive in $(filter %.a,$^); do \
|
|
mkdir -p $@.tmpdir/$$(basename $${archive}); \
|
|
cd $@.tmpdir/$$(basename $${archive}); \
|
|
$(AR) -x ../../$${archive}; \
|
|
cd ../..; \
|
|
done; \
|
|
$(RM) -f $@; \
|
|
cat $@.verilator_deplist.tmp | xargs $(AR) -rc $@; \
|
|
$(AR) -rcs $@ $@.tmpdir/*/*.o; \
|
|
fi \
|
|
; $(RM) -rf $@.verilator_deplist.tmp $@.tmpdir
|
|
|
|
# Truncate the dependency list file used in the %.a target above.
|
|
%.verilator_deplist.tmp:
|
|
echo "" > $@
|
|
|
|
$(VM_PREFIX)__ALL.a: $(VK_OBJS) $(VM_HIER_LIBS)
|
|
|
|
|
|
######################################################################
|
|
### Compile rules
|
|
|
|
ifneq ($(VM_DEFAULT_RULES),0)
|
|
# Anything not in $(VK_SLOW_OBJS) or $(VK_GLOBAL_OBJS), including verilated.o
|
|
# and user files passed on the Verilator command line use this rule.
|
|
%.o: %.cpp
|
|
$(OBJCACHE) $(CXX) $(CXXFLAGS) $(CPPFLAGS) $(OPT_FAST) -c -o $@ $<
|
|
|
|
$(VK_SLOW_OBJS): %.o: %.cpp
|
|
$(OBJCACHE) $(CXX) $(CXXFLAGS) $(CPPFLAGS) $(OPT_SLOW) -c -o $@ $<
|
|
|
|
$(VK_GLOBAL_OBJS): %.o: %.cpp
|
|
$(OBJCACHE) $(CXX) $(CXXFLAGS) $(CPPFLAGS) $(OPT_GLOBAL) -c -o $@ $<
|
|
endif
|
|
|
|
#Default rule embedded in make:
|
|
#.cpp.o:
|
|
# $(CXX) $(CXXFLAGS) $(CPPFLAGS) -c -o $@ $<
|
|
|
|
######################################################################
|
|
### ccache report
|
|
|
|
ifneq ($(findstring ccache-report,$(MAKECMDGOALS)),)
|
|
ifneq ($(OBJCACHE),ccache)
|
|
$(error ccache-report requires OBJCACHE to equal 'ccache')
|
|
endif
|
|
VK_OTHER_GOALS := $(strip $(subst ccache-report,,$(MAKECMDGOALS)))
|
|
ifeq ($(VK_OTHER_GOALS),)
|
|
$(error ccache-report must be used with at least one other explicit target)
|
|
endif
|
|
|
|
# Report ccache behaviour for this invocation of make
|
|
VK_CCACHE_LOGDIR := ccache-logs
|
|
VK_CCACHE_REPORT := $(VM_PREFIX)__ccache_report.txt
|
|
# Remove previous logfiles and report
|
|
$(shell rm -rf $(VK_CCACHE_LOGDIR) $(VK_CCACHE_REPORT))
|
|
|
|
$(VK_CCACHE_LOGDIR):
|
|
mkdir -p $@
|
|
|
|
$(VK_OBJS): | $(VK_CCACHE_LOGDIR)
|
|
|
|
$(VK_OBJS): export CCACHE_LOGFILE=$(VK_CCACHE_LOGDIR)/$@.log
|
|
|
|
$(VK_CCACHE_REPORT): $(VK_OBJS)
|
|
$(VERILATOR_CCACHE_REPORT) -o $@ $(VK_CCACHE_LOGDIR)
|
|
|
|
.PHONY: ccache-report
|
|
ccache-report: $(VK_CCACHE_REPORT)
|
|
@cat $<
|
|
|
|
# ccache-report runs last
|
|
ccache-report: $(VK_OTHER_GOALS)
|
|
endif
|
|
|
|
######################################################################
|
|
### Debugging
|
|
|
|
debug-make::
|
|
@echo
|
|
@echo CXXFLAGS: $(CXXFLAGS)
|
|
@echo CPPFLAGS: $(CPPFLAGS)
|
|
@echo OPT_FAST: $(OPT_FAST)
|
|
@echo OPT_SLOW: $(OPT_SLOW)
|
|
@echo VM_PREFIX: $(VM_PREFIX)
|
|
@echo VM_PARALLEL_BUILDS: $(VM_PARALLEL_BUILDS)
|
|
@echo VM_CLASSES_FAST: $(VM_CLASSES_FAST)
|
|
@echo VM_CLASSES_SLOW: $(VM_CLASSES_SLOW)
|
|
@echo VM_SUPPORT_FAST: $(VM_SUPPORT_FAST)
|
|
@echo VM_SUPPORT_SLOW: $(VM_SUPPORT_SLOW)
|
|
@echo VM_GLOBAL_FAST: $(VM_GLOBAL_FAST)
|
|
@echo VM_GLOBAL_SLOW: $(VM_GLOBAL_SLOW)
|
|
@echo VK_OBJS: $(VK_OBJS)
|
|
@echo
|
|
|
|
######################################################################
|
|
### Detect out of date files and rebuild.
|
|
|
|
DEPS := $(wildcard *.d)
|
|
ifneq ($(DEPS),)
|
|
include $(DEPS)
|
|
endif
|