Makefile

# --------------------------- TARGET NAME ---------------------------
# output name (final elf/bin will be named after this)
TARGET = demo

# -------------------------- LINKER SCRIPT --------------------------
# linker script
LD_SCRIPT = stm32l433cbu6.ld

# -------------------------- VERSION NUMBER -------------------------
# software version
SW_VER_MAJOR = 0
SW_VER_MINOR = 0
SW_VER_BUILD = 1

# hardware version
HW_VER_MAJOR = 1
HW_VER_MINOR = 0
HW_VER_BUILD = 0

# ----------------------------- SOURCES -----------------------------
# put all of your sources here (use / as path separator)
SRC += ./startup.c ./vectors.c ./defhndl.c ./image.c ./main.c

# ----------------------------- INCLUDES ----------------------------
# put all used include directories here (use / as path separator)
INC_DIRS = .

# ---------------------------- LIBRARIES ----------------------------
# put all used libraries here starting with 'l[name]', like lm
LIBS = lm lc lgcc
# library search directories (use / as path separator)
LIB_DIRS = .

# ----------------------- OPTIMIZATION LEVEL ------------------------
# use '-O0' (no optimization) for debugging or (-Os) for release
OPT_LEVEL = -O0

# ----------------------- OUTPUT DIRECTORIES ------------------------
# object files directory (use / as path separator)
OBJ_DIR = ./.objs
# final binaries directory (use / as path separator)
OUT_DIR = ./.outs

# --------------------- TOOLS && CONFIGURATION ----------------------
# windows tools configuration
ifeq ($(OS),Windows_NT)
    PATH_SEP = $(strip \\)
    SHELL = cmd
    CP = copy
    RM = del /f
    RMDIR = rmdir
    ECHO = echo
    MKDIR = mkdir
# *nix tools configuration
else
    PATH_SEP = /
    SHELL = sh
    CP = cp
    RM = rm -f
    RMDIR = rm -r
    ECHO = echo
    MKDIR = mkdir -p
endif

# ------------------------- BUILD TOOLS -----------------------------
# build tools (set to 'gcc' or 'llvm')
TOOLCHAIN = gcc
# proper system path for selected build tools (leave empty if these are in 
# system PATH)
TOOLCHAIN_PATH =

# build tools for the clang/llvm approach
ifeq ($(TOOLCHAIN),llvm)
    CC = $(TOOLCHAIN_PATH)clang
    AS = $(TOOLCHAIN_PATH)clang
    LD = $(TOOLCHAIN_PATH)ld
    OBC = $(TOOLCHAIN_PATH)llvm-objcopy
    OBD = $(TOOLCHAIN_PATH)llvm-objdump
    NM = $(TOOLCHAIN_PATH)llvm-nm
    SIZE = $(TOOLCHAIN_PATH)llvm-size
endif

# buildtools for the gcc approach
ifeq ($(TOOLCHAIN),gcc)
    CC = $(TOOLCHAIN_PATH)arm-none-eabi-gcc
    AS = $(TOOLCHAIN_PATH)arm-none-eabi-gcc
    LD = $(TOOLCHAIN_PATH)arm-none-eabi-ld
    OBC = $(TOOLCHAIN_PATH)arm-none-eabi-objcopy
    OBD = $(TOOLCHAIN_PATH)arm-none-eabi-objdump
    NM = $(TOOLCHAIN_PATH)arm-none-eabi-nm
    SIZE = $(TOOLCHAIN_PATH)arm-none-eabi-size
endif

# ------------------------ PREPARE PATHS ----------------------------
# string versions of the 'versions'
SW_VER = $(SW_VER_MAJOR).$(SW_VER_MINOR).$(SW_VER_BUILD)
HW_VER = $(HW_VER_MAJOR).$(HW_VER_MINOR).$(HW_VER_BUILD)

# output directory with valid path separator
OUT_DIR_PATH = $(subst /,$(PATH_SEP),$(OUT_DIR))
OBJ_DIR_PATH = $(subst /,$(PATH_SEP),$(OBJ_DIR))

# target name with directory
TARGET_PATH = $(OUT_DIR_PATH)$(PATH_SEP)$(TARGET)
# output file name with version information
TARGET_VER = $(TARGET)_$(HW_VER)_$(SW_VER)
# target file name with path and version information 
TARGET_VER_PATH = $(OUT_DIR_PATH)$(PATH_SEP)$(TARGET_VER)

# sources converted to objs with valid path separator
OBJ = $(subst /,$(PATH_SEP), $(SRC:%.c=$(OBJ_DIR_PATH)$(PATH_SEP)%.o))

# --------------------------- BUILD FLAGS ---------------------------
# optimization level and C standard
CC_FLAGS += $(OPT_LEVEL) --std=c18
# target architecture flags
CC_FLAGS  = -mcpu=cortex-m4 -march=armv7e-m -mthumb $(OPT_LEVEL)
CC_FLAGS += -mfloat-abi=hard -mfpu=fpv4-sp-d16
# additional architecture flags for clang/llvm
ifeq ($(TOOLCHAIN),llvm)
    CC_FLAGS += --target=thumbv7em-unknown-none-eabihf
    CC_FLAGS += -Wno-keyword-macro
endif
# warning levels
CC_FLAGS += -g -fdata-sections -ffunction-sections
CC_FLAGS += -Wall -Wno-format
CC_FLAGS += -pedantic-errors -Wno-implicit-fallthrough
# use defines such as M_PI from math.h
CC_FLAGS += -D _USE_MATH_DEFINES
CC_FLAGS += $(addprefix -I,$(INC_DIRS))
# version information (software)
CC_FLAGS += -DSW_VER_MAJOR=$(SW_VER_MAJOR)
CC_FLAGS += -DSW_VER_MINOR=$(SW_VER_MINOR)
CC_FLAGS += -DSW_VER_BUILD=$(SW_VER_BUILD)
# version information (hardware)
CC_FLAGS += -DHW_VER_MAJOR=$(HW_VER_MAJOR)
CC_FLAGS += -DHW_VER_MINOR=$(HW_VER_MINOR)
CC_FLAGS += -DHW_VER_MINOR=$(HW_VER_BUILD)
 
# linker flags 
LD_FLAGS  = -T$(LD_SCRIPT) 
LD_FLAGS += $(addprefix -,$(LIBS)) $(addprefix -L,$(LIB_DIRS))
LD_FLAGS +=  -Wl,-Map=$(TARGET_PATH).map
LD_FLAGS += -Wl,--gc-sections -nostdlib

# object dump flags
OBD_FLAGS  = -j ".flash_code" -j ".ram_code" -S
# additional flags for clang/llvm
ifeq ($(BUILD_TOOLS),llvm)
    OBD_FLAGS += -mcpu=cortex-m4 -mattr=vfp4 
    OBD_FLAGS += --triple=thumbv7em-unknown-none-eabihf
endif

# object copy flags 
OBC_FLAGS  = -O binary

# -------------------------- BUILD PROCESS --------------------------
# generate elf and bin and all other files
all: $(TARGET_PATH).elf $(TARGET_PATH).lst $(TARGET_PATH).sym \
	 $(TARGET_PATH).bin size

# compile all sources
$(OBJ_DIR_PATH)$(PATH_SEP)%.o : %.c
	@ $(ECHO) --------------------- Compiling $< ---------------------
	-@ $(MKDIR) $(dir $@)
	$(CC) -c $(CC_FLAGS) $< -o $@

# link all thogether and generate elf file from objs and *.map file
$(TARGET_PATH).elf: $(OBJ)
	@ $(ECHO) ---------------------    Linking   ---------------------
	-@ $(MKDIR) $(dir $@)
	$(CC) $(CC_FLAGS) $(OBJ) --output $@ $(LD_FLAGS) 

# geneate listing
$(TARGET_PATH).lst: $(TARGET_PATH).elf
	@ $(ECHO) ---------------------    Listing   ---------------------
	$(OBD) $(OBD_FLAGS) $< > $@

# generate symbol list
$(TARGET_PATH).sym: $(TARGET_PATH).elf
	@ $(ECHO) --------------------- Symbol map ---------------------
	$(NM) -n -o $(TARGET_PATH).elf > $(TARGET_PATH).sym

# generate bin file
$(TARGET_PATH).bin: $(TARGET_PATH).elf
	@ $(ECHO) --------------------   Converting   --------------------
	$(OBC) $(OBC_FLAGS) $< $@
	$(CP) $(TARGET_PATH).bin $(TARGET_VER_PATH).bin

# show size information
size: $(TARGET_PATH).elf
	@ $(ECHO) --------------------- Section size ---------------------
	$(SIZE) $(TARGET_PATH).elf

# clean build products
clean:
	- $(RM) $(OBJ) 
	- $(RM) $(TARGET_PATH).elf $(TARGET_PATH).bin $(TARGET_VER_PATH).bin
	- $(RM) $(TARGET_PATH).map $(TARGET_PATH).sym $(TARGET_PATH).lst
	- $(RMDIR) $(OBJ_DIR_PATH) $(OUT_DIR_PATH)