MAKEFLAGS += --no-builtin-rules # Ensure the build fails if a piped command fails SHELL = /bin/bash .SHELLFLAGS = -o pipefail -c # Build options can either be changed by modifying the makefile, or by building with 'make SETTING=value' # currently, GCC is the only supported compiler COMPILER := gcc # Target game version. Currently only the following version is supported: # gc-eu-mq-dbg GameCube Europe/PAL Master Quest Debug # hacker-mq HackerOoT, based on gc-eu-mq-dbg (default) # # The following versions are work-in-progress and not yet matching: # gc-eu-mq GameCube Europe/PAL Master Quest # # Note: choosing hacker-mq will enable HackerOoT features, # if another version is chosen, this repo will be like # zeldaret/main decomp but without the disassembly, decompilation # and matching tools, including the IDO compiler VERSION := hacker-mq # Enable optimization flags to use GDB on Ares ARES_GDB := 1 # Toggle release or debug mode. 1=Release, 0=Debug # Note: currently only used for HackerOoT RELEASE := 0 # Number of threads to extract and compress with N_THREADS := $(shell nproc) # Check code syntax with host compiler RUN_CC_CHECK := 1 CFLAGS ?= CPPFLAGS ?= ifeq ($(COMPILER),gcc) CFLAGS += -DCOMPILER_GCC -DNON_MATCHING -DAVOID_UB CPPFLAGS += -DCOMPILER_GCC -DNON_MATCHING -DAVOID_UB else $(error Unsupported compiler. Please use gcc as the COMPILER variable.) endif # Set prefix to mips binutils binaries (mips-linux-gnu-ld => 'mips-linux-gnu-') - Change at your own risk! # In nearly all cases, not having 'mips-linux-gnu-*' binaries on the PATH is indicative of missing dependencies MIPS_BINUTILS_PREFIX := mips-linux-gnu- # Version-specific settings ifeq ($(VERSION),gc-eu-mq) DEBUG := 0 HACKEROOT := 0 else ifeq ($(VERSION),gc-eu-mq-dbg) DEBUG := 1 HACKEROOT := 0 else ifeq ($(VERSION),hacker-mq) HACKEROOT := 1 else $(error Unsupported version $(VERSION)) endif PROJECT_DIR := $(dir $(realpath $(firstword $(MAKEFILE_LIST)))) BUILD_DIR := build/$(VERSION) VENV := .venv MAKE = make CPPFLAGS += -fno-dollars-in-identifiers -P # Set PACKAGE_VERSION define for printing commit hash ifeq ($(origin PACKAGE_VERSION), undefined) PACKAGE_VERSION := $(shell git log -1 --pretty=%h | tr -d '\n') ifeq ('$(PACKAGE_VERSION)', '') PACKAGE_VERSION = Unknown version endif endif # Set PACKAGE_AUTHOR define for printing author's git name ifeq ($(origin PACKAGE_AUTHOR), undefined) PACKAGE_AUTHOR := $(shell git config --get user.name) ifeq ('$(PACKAGE_AUTHOR)', '') PACKAGE_AUTHOR = Unknown author endif endif # Make sure the build reports the correct version $(shell touch src/boot/build.c) ifeq ($(VERSION),hacker-mq) SEGMENT_VERSION := hacker-mq CFLAGS += -DENABLE_HACKEROOT=1 CPPFLAGS += -DENABLE_HACKEROOT=1 OPTFLAGS := -Os ifeq ($(RELEASE),1) CFLAGS += -DRELEASE_ROM=1 -DOOT_DEBUG=0 CPPFLAGS += -DRELEASE_ROM=1 -DOOT_DEBUG=0 else CFLAGS += -DRELEASE_ROM=0 -DOOT_DEBUG=1 CPPFLAGS += -DRELEASE_ROM=0 -DOOT_DEBUG=1 endif else ifeq ($(DEBUG),1) CFLAGS += -DOOT_DEBUG=1 CPPFLAGS += -DOOT_DEBUG=1 OPTFLAGS := -O2 else CFLAGS += -DNDEBUG -DOOT_DEBUG=0 CPPFLAGS += -DNDEBUG -DOOT_DEBUG=0 OPTFLAGS := -O2 -g3 endif SEGMENT_VERSION := gc-eu-mq-dbg CFLAGS += -DENABLE_HACKEROOT=0 CPPFLAGS += -DENABLE_HACKEROOT=0 endif # Override optimization flags if using GDB ifeq ($(ARES_GDB),1) OPTFLAGS := -Og -ggdb3 endif # Define author and package version for every OoT version # Note: this won't be used if not using HackerOoT CFLAGS += -DPACKAGE_AUTHOR='$(PACKAGE_AUTHOR)' -DPACKAGE_VERSION='$(PACKAGE_VERSION)' CPPFLAGS += -DPACKAGE_AUTHOR='$(PACKAGE_AUTHOR)' -DPACKAGE_VERSION='$(PACKAGE_VERSION)' OPTFLAGS += -ffast-math -fno-unsafe-math-optimizations ifeq ($(OS),Windows_NT) DETECTED_OS=windows else UNAME_S := $(shell uname -s) ifeq ($(UNAME_S),Linux) DETECTED_OS=linux endif ifeq ($(UNAME_S),Darwin) DETECTED_OS=macos MAKE=gmake CPPFLAGS += -xc++ endif endif #### Tools #### ifneq ($(shell type $(MIPS_BINUTILS_PREFIX)ld >/dev/null 2>/dev/null; echo $$?), 0) $(error Unable to find $(MIPS_BINUTILS_PREFIX)ld. Please install or build MIPS binutils, commonly mips-linux-gnu. (or set MIPS_BINUTILS_PREFIX if your MIPS binutils install uses another prefix)) endif # Detect compiler and set variables appropriately. ifeq ($(COMPILER),gcc) CC := $(MIPS_BINUTILS_PREFIX)gcc else $(error Unsupported compiler. Please use gcc as the COMPILER variable.) endif AS := $(MIPS_BINUTILS_PREFIX)as LD := $(MIPS_BINUTILS_PREFIX)ld OBJCOPY := $(MIPS_BINUTILS_PREFIX)objcopy OBJDUMP := $(MIPS_BINUTILS_PREFIX)objdump NM := $(MIPS_BINUTILS_PREFIX)nm N64_EMULATOR ?= INC := -Iinclude -Iinclude/libc -Isrc -I$(BUILD_DIR) -I. # Check code syntax with host compiler CHECK_WARNINGS := -Wall -Wextra -Wno-format-security -Wno-unknown-pragmas -Wno-unused-parameter -Wno-unused-variable -Wno-missing-braces CPP := cpp MKLDSCRIPT := tools/mkldscript MKDMADATA := tools/mkdmadata ELF2ROM := tools/elf2rom ZAPD := tools/ZAPD/ZAPD.out FADO := tools/fado/fado.elf PYTHON ?= $(VENV)/bin/python3 # Command to replace path variables in the spec file. We can't use the C # preprocessor for this because it won't substitute inside string literals. SPEC_REPLACE_VARS := sed -e 's|$$(BUILD_DIR)|$(BUILD_DIR)|g' ASFLAGS := -march=vr4300 -32 -no-pad-sections -Iinclude ifeq ($(COMPILER),gcc) CFLAGS += -G 0 -nostdinc $(INC) -march=vr4300 -mfix4300 -mabi=32 -fno-pic -mno-abicalls -mdivide-breaks -fno-zero-initialized-in-bss -fno-toplevel-reorder -ffreestanding -fno-common -fno-merge-constants -mno-explicit-relocs -mno-split-addresses $(CHECK_WARNINGS) -funsigned-char MIPS_VERSION := -mips3 RUN_CC_CHECK := 0 endif OBJDUMP_FLAGS := -d -r -z -Mreg-names=32 #### Files #### # ROM image ROM := $(BUILD_DIR)/oot-$(VERSION).z64 ROMC := $(ROM:.z64=-compressed.z64) WAD := $(ROM:.z64=.wad) ELF := $(ROM:.z64=.elf) MAP := $(ROM:.z64=.map) LDSCRIPT := $(ROM:.z64=.ld) # description of ROM segments SPEC := spec ifeq ($(COMPILER),gcc) SRC_DIRS := $(shell find src -type d) endif ASSET_BIN_DIRS := $(shell find assets/* -type d -not -path "assets/xml*" -not -path "assets/text") ASSET_FILES_XML := $(foreach dir,$(ASSET_BIN_DIRS),$(wildcard $(dir)/*.xml)) ASSET_FILES_BIN := $(foreach dir,$(ASSET_BIN_DIRS),$(wildcard $(dir)/*.bin)) ASSET_FILES_OUT := $(foreach f,$(ASSET_FILES_XML:.xml=.c),$f) \ $(foreach f,$(ASSET_FILES_BIN:.bin=.bin.inc.c),$(BUILD_DIR)/$f) \ $(foreach f,$(wildcard assets/text/*.c),$(BUILD_DIR)/$(f:.c=.o)) UNDECOMPILED_DATA_DIRS := $(shell find data -type d) # TODO: for now, ROM segments are still taken from the Debug ROM even when building other versions BASEROM_SEGMENTS_DIR := baseroms/$(SEGMENT_VERSION)/segments BASEROM_BIN_FILES := $(wildcard $(BASEROM_SEGMENTS_DIR)/*) # source files C_FILES := $(filter-out %.inc.c,$(foreach dir,$(SRC_DIRS) $(ASSET_BIN_DIRS),$(wildcard $(dir)/*.c))) S_FILES := $(foreach dir,$(SRC_DIRS) $(UNDECOMPILED_DATA_DIRS),$(wildcard $(dir)/*.s)) O_FILES := $(foreach f,$(S_FILES:.s=.o),$(BUILD_DIR)/$f) \ $(foreach f,$(C_FILES:.c=.o),$(BUILD_DIR)/$f) \ $(foreach f,$(BASEROM_BIN_FILES),$(BUILD_DIR)/baserom/$(notdir $f).o) OVL_RELOC_FILES := $(shell $(CPP) $(CPPFLAGS) $(SPEC) | $(SPEC_REPLACE_VARS) | grep -o '[^"]*_reloc.o' ) # Automatic dependency files # (Only asm_processor dependencies and reloc dependencies are handled for now) DEP_FILES := $(O_FILES:.o=.asmproc.d) $(OVL_RELOC_FILES:.o=.d) TEXTURE_FILES_PNG := $(foreach dir,$(ASSET_BIN_DIRS),$(wildcard $(dir)/*.png)) TEXTURE_FILES_JPG := $(foreach dir,$(ASSET_BIN_DIRS),$(wildcard $(dir)/*.jpg)) TEXTURE_FILES_OUT := $(foreach f,$(TEXTURE_FILES_PNG:.png=.inc.c),$(BUILD_DIR)/$f) \ $(foreach f,$(TEXTURE_FILES_JPG:.jpg=.jpg.inc.c),$(BUILD_DIR)/$f) \ # create build directories $(shell mkdir -p $(BUILD_DIR)/baserom $(BUILD_DIR)/assets/text $(foreach dir,$(SRC_DIRS) $(UNDECOMPILED_DATA_DIRS) $(ASSET_BIN_DIRS),$(BUILD_DIR)/$(dir))) ifeq ($(COMPILER),gcc) $(BUILD_DIR)/src/libultra/libc/ll.o: OPTFLAGS := -Ofast $(BUILD_DIR)/src/%.o: CC := $(CC) -fexec-charset=utf-8 $(BUILD_DIR)/src/overlays/actors/ovl_Item_Shield/%.o: OPTFLAGS := -O2 $(BUILD_DIR)/src/overlays/actors/ovl_En_Part/%.o: OPTFLAGS := -O2 $(BUILD_DIR)/src/overlays/actors/ovl_Item_B_Heart/%.o: OPTFLAGS := -O0 $(BUILD_DIR)/src/overlays/actors/ovl_Bg_Mori_Hineri/%.o: OPTFLAGS := -O0 endif #### Main Targets ### all: rom compress rom: $(ROM) compress: $(ROMC) wad: ifeq ("$(wildcard common-key.bin)", "") $(error Please provide the common-key.bin file.) endif $(MAKE) compress CFLAGS="-DCONSOLE_WIIVC $(CFLAGS) -fno-reorder-blocks -fno-optimize-sibling-calls" CPPFLAGS="-DCONSOLE_WIIVC $(CPPFLAGS)" tools/gzinject/gzinject -a inject -r 1 -k common-key.bin -w basewad.wad -m $(ROMC) -o $(WAD) -t "HackerOoT" -i NHOE -p tools/gzinject/patches/NACE.gzi -p tools/gzinject/patches/gz_default_remap.gzi $(RM) -r wadextract/ common-key.bin clean: $(RM) -r $(BUILD_DIR) assetclean: $(RM) -r $(ASSET_BIN_DIRS) $(RM) -r assets/text/*.h $(RM) -r $(BUILD_DIR)/assets $(RM) -r .extracted-assets.json distclean: clean assetclean $(RM) -r $(BASEROM_SEGMENTS_DIR) $(MAKE) -C tools distclean venv: # Create the virtual environment if it doesn't exist. # Delete the virtual environment directory if creation fails. test -d $(VENV) || python3 -m venv $(VENV) || { rm -rf $(VENV); false; } $(PYTHON) -m pip install -U pip $(PYTHON) -m pip install -U -r requirements.txt setup: venv $(MAKE) -C tools $(PYTHON) tools/decompress_baserom.py $(VERSION) # TODO: for now, we only extract ROM segments and assets from the Debug ROM ifeq ($(VERSION),gc-eu-mq-dbg) $(PYTHON) extract_baserom.py gc-eu-mq-dbg $(PYTHON) extract_assets.py -j$(N_THREADS) -v gc-eu-mq-dbg else ifeq ($(VERSION),hacker-mq) $(PYTHON) extract_baserom.py hacker-mq $(PYTHON) extract_assets.py -j$(N_THREADS) -v hacker-mq # temporary solution until decomp handles this properly cp baseroms/hacker-mq/baserom-decompressed.z64 baseroms/gc-eu-mq-dbg/ endif endif run: $(ROM) ifeq ($(N64_EMULATOR),) $(error Emulator path not set. Set N64_EMULATOR in the Makefile or define it as an environment variable) endif $(N64_EMULATOR) $< .PHONY: all rom compress clean assetclean distclean venv setup run wad .DEFAULT_GOAL := rom #### Various Recipes #### $(ROM): $(ELF) $(ELF2ROM) -cic 6105 $< $@ # TODO: implement z64compress and setup cache folder into build $(ROMC): $(ROM) $(ELF) $(BUILD_DIR)/compress_ranges.txt # note: $(BUILD_DIR)/compress_ranges.txt should only be used for nonmatching builds. it works by chance for matching builds too though $(PYTHON) tools/compress.py --in $(ROM) --out $@ --dma-range `./tools/dmadata_range.sh $(NM) $(ELF)` --compress `cat $(BUILD_DIR)/compress_ranges.txt` --threads $(N_THREADS) $(PYTHON) -m ipl3checksum sum --cic 6105 --update $@ $(ELF): $(TEXTURE_FILES_OUT) $(ASSET_FILES_OUT) $(O_FILES) $(OVL_RELOC_FILES) $(LDSCRIPT) $(BUILD_DIR)/undefined_syms.txt $(LD) -T $(LDSCRIPT) -T $(BUILD_DIR)/undefined_syms.txt --no-check-sections --accept-unknown-input-arch --emit-relocs -Map $(MAP) -o $@ ## Order-only prerequisites # These ensure e.g. the O_FILES are built before the OVL_RELOC_FILES. # The intermediate phony targets avoid quadratically-many dependencies between the targets and prerequisites. o_files: $(O_FILES) $(OVL_RELOC_FILES): | o_files asset_files: $(TEXTURE_FILES_OUT) $(ASSET_FILES_OUT) $(O_FILES): | asset_files .PHONY: o_files asset_files $(BUILD_DIR)/$(SPEC): $(SPEC) $(CPP) $(CPPFLAGS) $< | $(SPEC_REPLACE_VARS) > $@ $(LDSCRIPT): $(BUILD_DIR)/$(SPEC) $(MKLDSCRIPT) $< $@ $(BUILD_DIR)/undefined_syms.txt: undefined_syms.txt $(CPP) $(CPPFLAGS) $< > $@ $(BUILD_DIR)/baserom/%.o: $(BASEROM_SEGMENTS_DIR)/% $(OBJCOPY) -I binary -O elf32-big $< $@ $(BUILD_DIR)/data/%.o: data/%.s $(AS) $(ASFLAGS) $< -o $@ $(BUILD_DIR)/assets/text/%.enc.h: assets/text/%.h assets/text/charmap.txt $(PYTHON) tools/msgenc.py assets/text/charmap.txt $< $@ # Dependencies for files including message data headers # TODO remove when full header dependencies are used. $(BUILD_DIR)/assets/text/fra_message_data_static.o: $(BUILD_DIR)/assets/text/message_data.enc.h $(BUILD_DIR)/assets/text/ger_message_data_static.o: $(BUILD_DIR)/assets/text/message_data.enc.h $(BUILD_DIR)/assets/text/nes_message_data_static.o: $(BUILD_DIR)/assets/text/message_data.enc.h $(BUILD_DIR)/assets/text/staff_message_data_static.o: $(BUILD_DIR)/assets/text/message_data_staff.enc.h $(BUILD_DIR)/src/code/z_message_PAL.o: $(BUILD_DIR)/assets/text/message_data.enc.h $(BUILD_DIR)/assets/text/message_data_staff.enc.h $(BUILD_DIR)/assets/%.o: assets/%.c $(CC) -c $(CFLAGS) $(MIPS_VERSION) $(OPTFLAGS) -o $@ $< $(OBJCOPY) -O binary $@ $@.bin $(BUILD_DIR)/src/%.o: src/%.s $(CPP) $(CPPFLAGS) -Iinclude $< | $(AS) $(ASFLAGS) -o $@ $(BUILD_DIR)/dmadata_table_spec.h $(BUILD_DIR)/compress_ranges.txt: $(BUILD_DIR)/$(SPEC) $(MKDMADATA) $< $(BUILD_DIR)/dmadata_table_spec.h $(BUILD_DIR)/compress_ranges.txt # Dependencies for files that may include the dmadata header automatically generated from the spec file $(BUILD_DIR)/src/boot/z_std_dma.o: $(BUILD_DIR)/dmadata_table_spec.h $(BUILD_DIR)/src/dmadata/dmadata.o: $(BUILD_DIR)/dmadata_table_spec.h # Dependencies for files including from include/tables/ # TODO remove when full header dependencies are used. $(BUILD_DIR)/src/code/graph.o: include/tables/gamestate_table.h $(BUILD_DIR)/src/code/object_table.o: include/tables/object_table.h $(BUILD_DIR)/src/code/z_actor.o: include/tables/actor_table.h # so uses of ACTOR_ID_MAX update when the table length changes $(BUILD_DIR)/src/code/z_actor_dlftbls.o: include/tables/actor_table.h $(BUILD_DIR)/src/code/z_effect_soft_sprite_dlftbls.o: include/tables/effect_ss_table.h $(BUILD_DIR)/src/code/z_game_dlftbls.o: include/tables/gamestate_table.h $(BUILD_DIR)/src/code/z_scene_table.o: include/tables/scene_table.h include/tables/entrance_table.h $(BUILD_DIR)/src/%.o: src/%.c ifneq ($(RUN_CC_CHECK),0) $(CC_CHECK) $< endif $(CC) -c $(CFLAGS) $(MIPS_VERSION) $(OPTFLAGS) -o $@ $< @$(OBJDUMP) $(OBJDUMP_FLAGS) $@ > $(@:.o=.s) $(BUILD_DIR)/src/libultra/libc/ll.o: src/libultra/libc/ll.c ifneq ($(RUN_CC_CHECK),0) $(CC_CHECK) $< endif $(CC) -c $(CFLAGS) $(MIPS_VERSION) $(OPTFLAGS) -o $@ $< $(PYTHON) tools/set_o32abi_bit.py $@ @$(OBJDUMP) $(OBJDUMP_FLAGS) $@ > $(@:.o=.s) $(BUILD_DIR)/src/libultra/libc/llcvt.o: src/libultra/libc/llcvt.c ifneq ($(RUN_CC_CHECK),0) $(CC_CHECK) $< endif $(CC) -c $(CFLAGS) $(MIPS_VERSION) $(OPTFLAGS) -o $@ $< $(PYTHON) tools/set_o32abi_bit.py $@ @$(OBJDUMP) $(OBJDUMP_FLAGS) $@ > $(@:.o=.s) $(BUILD_DIR)/src/overlays/%_reloc.o: $(BUILD_DIR)/$(SPEC) $(FADO) $$(tools/reloc_prereq $< $(notdir $*)) -n $(notdir $*) -o $(@:.o=.s) -M $(@:.o=.d) $(AS) $(ASFLAGS) $(@:.o=.s) -o $@ $(BUILD_DIR)/%.inc.c: %.png $(ZAPD) btex -eh -tt $(subst .,,$(suffix $*)) -i $< -o $@ $(BUILD_DIR)/assets/%.bin.inc.c: assets/%.bin $(ZAPD) bblb -eh -i $< -o $@ $(BUILD_DIR)/assets/%.jpg.inc.c: assets/%.jpg $(ZAPD) bren -eh -i $< -o $@ -include $(DEP_FILES) # Print target for debugging print-% : ; $(info $* is a $(flavor $*) variable set to [$($*)]) @true