rCore/kernel/Makefile

# Commands:
#   make build                      Build
#   make run                        Build and run in QEMU
#   make justrun                    Run the last build
#   make doc                        Generate docs
#   make asm                        Open the deassemble file of the last build
#   make header                     Open 'objdump -h' of the last build
#   make clean                      Clean
#
# Options:
#   arch    = x86_64 | riscv32 | aarch64
#   d       = int | in_asm | ...    QEMU debug info
#   mode    = debug | release
#   LOG     = off | error | warn | info | debug | trace
#   SFSIMG  = <sfsimg>              SFS image path of user programs
#   smp     = 1 | 2 | ...           SMP core number
#   graphic = on | off              enable/disable qemu graphical output
#   board   = fpga                  Only available on riscv32, build without bbl, run on board
#           | raspi3                Only available on aarch64, run on Raspberry Pi 3 Model B/B+
#   m_mode                          Only available on riscv32, build for M-Mode, without MMU

arch ?= riscv32
board ?= raspi3
mode ?= debug
LOG  ?= debug
smp  ?= 4
# NOTE: crate 'process' use this name 'm_mode' as an environment
#       to set interrupt (MIE or SIE)
m_mode ?=

target := $(arch)-blog_os
kernel := target/$(target)/$(mode)/ucore
bin := target/$(target)/$(mode)/kernel.bin
bootimage := target/$(target)/bootimage.bin
user_dir := ../user

export ARCH = $(arch)
export SMP = $(smp)
#export SFSIMG = $(user_dir)/build/user-$(arch).img
ifeq ($(arch), x86_64)
export SFSIMG = $(user_dir)/img/ucore-i386.img
else
export SFSIMG = $(user_dir)/img/ucore-$(arch).img
endif

ifeq ($(arch), aarch64)
graphic ?= on
else
graphic ?= off
endif

### qemu options ###
qemu_opts := \
	-smp cores=$(smp)

ifeq ($(arch), x86_64)
qemu_opts += \
	-drive format=raw,file=$(bootimage) \
	-drive format=raw,file=$(SFSIMG),media=disk,cache=writeback \
	-serial mon:stdio \
	-device isa-debug-exit

else ifeq ($(arch), riscv32)
qemu_opts += \
	-machine virt \
	-kernel $(bin)
ifdef m_mode
qemu_opts += -cpu rv32imacu-nommu
endif

else ifeq ($(arch), aarch64)
qemu_opts += \
	-machine $(board) \
	-serial null -serial mon:stdio \
	-kernel $(bin)
endif

ifneq ($(graphic), on)
qemu_opts += -nographic
endif

ifdef d
qemu_opts += -d $(d)
endif

### build args ###
ifeq ($(arch), riscv32)
ifeq ($(board), fpga)
features += no_bbl
endif
endif

ifneq ($(graphic), on)
features += nographic
endif

ifeq ($(board), raspi3)
# qemu only has generic timer
# TODO: configure system/generic timer automatically
raspi3_timer ?= generic
ifeq ($(raspi3_timer), generic)
features += raspi3_use_generic_timer
endif
endif

ifdef m_mode
features += no_mmu m_mode
bbl_m_mode := --enable-boot-machine
endif

features += board_$(board)
build_args := --target $(target).json --features "$(features)"

ifeq ($(mode), release)
build_args += --release
endif



### prefix ###
ifeq ($(arch), x86_64)
ifeq ($(uname), Darwin)
prefix := x86_64-elf-
endif
else ifeq ($(arch), riscv32)
prefix := riscv64-unknown-elf-
else ifeq ($(arch), aarch64)
prefix ?= aarch64-none-elf-
endif

ld := $(prefix)ld
objdump := $(prefix)objdump
objcopy := $(prefix)objcopy
cc := $(prefix)gcc
as := $(prefix)as
gdb := $(prefix)gdb

.PHONY: all clean run build asm doc justrun debug kernel sfsimg install

all: kernel

clean:
	@cargo clean
	@cd $(user_dir) && make clean
	@rm -rf ../riscv-pk/build

doc:
	@cargo rustdoc -- --document-private-items

run: build sfsimg justrun

justrun:
	@qemu-system-$(arch) $(qemu_opts) || [ $$? -eq 11 ] # run qemu and assert it exit 11

debug: $(kernel) $(bin)
	@qemu-system-$(arch) $(qemu_opts) -s -S &
	@sleep 1
	@$(gdb) $(kernel) -x ../tools/gdbinit

ifeq ($(arch), x86_64)
build: kernel
else
build: $(bin)
endif

asm:
	@$(objdump) -dS $(kernel) | less

header:
	@$(objdump) -h $(kernel)

sym:
	@$(objdump) -t $(kernel) | less

$(bin): kernel
ifeq ($(arch), riscv32)
ifeq ($(board), fpga)
	@cp $(kernel) $@
else
	@cd ../riscv-pk && \
	mkdir -p build && \
	cd build && \
	../configure \
		$(bbl_m_mode) \
		--with-arch=rv32imac \
		--disable-fp-emulation \
		--host=riscv64-unknown-elf \
		--with-payload=$(abspath $(kernel)) && \
	make && \
	cp bbl ../../kernel/$@
endif
else ifeq ($(arch), aarch64)
	@$(objcopy) $(kernel) --strip-all -O binary $@
endif

ifeq ($(arch), x86_64)
kernel:
	@bootimage build $(build_args)
else
kernel: sfsimg
ifeq ($(arch), riscv32)
	@-patch -p0 -N -b \
		$(shell rustc --print sysroot)/lib/rustlib/src/rust/src/libcore/sync/atomic.rs \
		src/arch/riscv32/atomic.patch
endif
	@CC=$(cc) cargo xbuild $(build_args)
endif


### user programs ###
sfsimg:
	@cd $(user_dir) && make sfsimg


### install ###
ifeq ($(board), raspi3)
sd_card ?=

ifeq ($(shell uname), Darwin)
sd_card := /Volumes/boot
else ifeq ($(shell uname), Linux)
sd_card := /media/$(shell whoami)/boot
endif

ifdef sd_card
.PHONY:
install: $(bin)
	cp $(bin) $(sd_card)/kernel8.img
	sudo umount $(sd_card)
endif

endif