diff options
Diffstat (limited to 'na/Makefile')
| -rw-r--r-- | na/Makefile | 158 |
1 files changed, 158 insertions, 0 deletions
diff --git a/na/Makefile b/na/Makefile new file mode 100644 index 0000000..3fc72b1 --- /dev/null +++ b/na/Makefile @@ -0,0 +1,158 @@ +# SPDX-License-Identifier: GPL-2.0-or-later +# Copyright (C) 2026 Richard Qin +# +# LumeOS Kernel Makefile (Non-Recursive) +# +# Usage: +# make - Build kernel ELF +# make run - Run in QEMU +# make debug - Run in QEMU with GDB server +# make clean - Clean build artifacts +# make fmt - Format all source files +# make disasm - Generate disassembly listing +# +# Reference: docs/specs/00_conventions.md ยง7 + +# ============================================================ +# Toolchain Detection +# ============================================================ +ifndef TOOLCHAIN_PREFIX + TOOLCHAIN_PREFIX := $(shell \ + if command -v riscv64-linux-gnu-gcc >/dev/null 2>&1; then \ + echo riscv64-linux-gnu-; \ + elif command -v riscv64-unknown-linux-gnu-gcc >/dev/null 2>&1; then \ + echo riscv64-unknown-linux-gnu-; \ + elif command -v riscv64-unknown-elf-gcc >/dev/null 2>&1; then \ + echo riscv64-unknown-elf-; \ + else \ + echo riscv64-linux-gnu-; \ + fi) +endif + +CC := $(TOOLCHAIN_PREFIX)gcc +CXX := $(TOOLCHAIN_PREFIX)g++ +LD := $(TOOLCHAIN_PREFIX)ld +OBJCOPY := $(TOOLCHAIN_PREFIX)objcopy +OBJDUMP := $(TOOLCHAIN_PREFIX)objdump + +# ============================================================ +# Build Configuration +# ============================================================ +ARCH := riscv +BUILD := build +TARGET := $(BUILD)/kernel.elf +IMAGE := $(BUILD)/kernel.bin +LINKER_SCRIPT := linker.ld + +# Common flags (base, before module includes) +WARNINGS := -Wall -Wextra -Wno-unused-parameter +INCLUDES := -Iinclude + +# ============================================================ +# Source Collection (Non-Recursive Module Fragments) +# Module .mk files may append to SRCS_CC, SRCS_S, INCLUDES +# ============================================================ +SRCS_CC := +SRCS_S := + +include arch/$(ARCH)/module.mk +include kernel/module.mk +# include mm/module.mk # Phase 1 +# include fs/module.mk # Phase 3 +# include drivers/module.mk # As needed +include lib/module.mk + +# Compiler flags (defined AFTER includes so INCLUDES is complete) +CFLAGS := $(WARNINGS) -O2 -g \ + -ffreestanding -nostdlib \ + -mcmodel=medany \ + -MMD -MP \ + $(INCLUDES) + +CXXFLAGS := $(CFLAGS) \ + -std=c++17 \ + -fno-exceptions -fno-rtti -fno-use-cxa-atexit \ + -fno-threadsafe-statics + +ASFLAGS := $(CFLAGS) + +LDFLAGS := -nostdlib -static + +# ============================================================ +# Object File Computation +# ============================================================ +OBJS := $(patsubst %.cc,$(BUILD)/%.o,$(SRCS_CC)) \ + $(patsubst %.S,$(BUILD)/%.o,$(SRCS_S)) + +DEPS := $(OBJS:.o=.d) + +# ============================================================ +# Build Rules +# ============================================================ +.PHONY: all clean run debug fmt disasm + +all: $(IMAGE) + +# Link kernel ELF +$(TARGET): $(OBJS) $(LINKER_SCRIPT) + @echo " LD $@" + @mkdir -p $(dir $@) + @$(LD) $(LDFLAGS) -T $(LINKER_SCRIPT) -o $@ $(OBJS) + @$(TOOLCHAIN_PREFIX)size $@ + +# Generate flat binary for QEMU loading +$(IMAGE): $(TARGET) + @echo " OBJCOPY $@" + @$(OBJCOPY) -O binary $< $@ + +# Compile C++ sources +$(BUILD)/%.o: %.cc + @echo " CXX $<" + @mkdir -p $(dir $@) + @$(CXX) $(CXXFLAGS) -c $< -o $@ + +# Assemble RISC-V assembly +$(BUILD)/%.o: %.S + @echo " AS $<" + @mkdir -p $(dir $@) + @$(CC) $(ASFLAGS) -c $< -o $@ + +# Auto-dependency tracking +-include $(DEPS) + +# ============================================================ +# Run & Debug +# ============================================================ +QEMU := qemu-system-riscv64 +QEMU_MACHINE := -machine virt -m 128M -nographic +QEMU_BIOS := -bios default + +run: $(IMAGE) + @echo " QEMU Running..." + $(QEMU) $(QEMU_MACHINE) $(QEMU_BIOS) -kernel $(IMAGE) + +debug: $(IMAGE) + @echo " QEMU Waiting for GDB on :1234..." + $(QEMU) $(QEMU_MACHINE) $(QEMU_BIOS) -kernel $(IMAGE) -s -S + +# ============================================================ +# Utilities +# ============================================================ +clean: + rm -rf $(BUILD) + +disasm: $(TARGET) + @echo " OBJDUMP $<" + @$(OBJDUMP) -d -S $(TARGET) > $(TARGET).asm + @echo " Written to $(TARGET).asm" + +fmt: + @echo " FMT Formatting source files..." + @find . -name '*.cc' -o -name '*.h' | xargs clang-format -i 2>/dev/null || true + +# Print build info (for debugging Makefile issues) +info: + @echo "TOOLCHAIN_PREFIX = $(TOOLCHAIN_PREFIX)" + @echo "SRCS_CC = $(SRCS_CC)" + @echo "SRCS_S = $(SRCS_S)" + @echo "OBJS = $(OBJS)" |