Makefile

##########################################################################################################################
# File automatically-generated by tool: [projectgenerator] version: [4.3.0-B58] date: [Mon May 20 15:02:45 PDT 2024] 
##########################################################################################################################

# ------------------------------------------------
# Generic Makefile (based on gcc)
#
# ChangeLog :
#	2017-02-10 - Several enhancements + project update mode
#   2015-07-22 - first version
# ------------------------------------------------

######################################
# target
######################################
TARGET = blink_example


######################################
# building variables
######################################
# debug build?
DEBUG = 0
# optimization
OPT = -Og


#######################################
# paths
#######################################
# Build path
BUILD_DIR = build

######################################
# source
######################################
# C sources
C_SOURCES =  \
Core/Src/main.c \
Core/Src/gpio.c \
Core/Src/stm32f7xx_it.c \
Core/Src/stm32f7xx_hal_msp.c \
Drivers/STM32F7xx_HAL_Driver/Src/stm32f7xx_hal_cortex.c \
Drivers/STM32F7xx_HAL_Driver/Src/stm32f7xx_hal_rcc.c \
Drivers/STM32F7xx_HAL_Driver/Src/stm32f7xx_hal_rcc_ex.c \
Drivers/STM32F7xx_HAL_Driver/Src/stm32f7xx_hal_flash.c \
Drivers/STM32F7xx_HAL_Driver/Src/stm32f7xx_hal_flash_ex.c \
Drivers/STM32F7xx_HAL_Driver/Src/stm32f7xx_hal_gpio.c \
Drivers/STM32F7xx_HAL_Driver/Src/stm32f7xx_hal_dma.c \
Drivers/STM32F7xx_HAL_Driver/Src/stm32f7xx_hal_dma_ex.c \
Drivers/STM32F7xx_HAL_Driver/Src/stm32f7xx_hal_pwr.c \
Drivers/STM32F7xx_HAL_Driver/Src/stm32f7xx_hal_pwr_ex.c \
Drivers/STM32F7xx_HAL_Driver/Src/stm32f7xx_hal.c \
Drivers/STM32F7xx_HAL_Driver/Src/stm32f7xx_hal_i2c.c \
Drivers/STM32F7xx_HAL_Driver/Src/stm32f7xx_hal_i2c_ex.c \
Drivers/STM32F7xx_HAL_Driver/Src/stm32f7xx_hal_exti.c \
Drivers/STM32F7xx_HAL_Driver/Src/stm32f7xx_hal_tim.c \
Drivers/STM32F7xx_HAL_Driver/Src/stm32f7xx_hal_tim_ex.c \
Core/Src/system_stm32f7xx.c \
Core/Src/sysmem.c \
Core/Src/syscalls.c

# ASM sources
ASM_SOURCES =  \
startup_stm32f750xx.s

# ASM sources
ASMM_SOURCES = 


#######################################
# binaries
#######################################


# CHANGE NOTE: I'm still using arm-none-eabi-gcc here for size and objcopy utilities, however note that these have no effect on actual compilation.
#			   We also need  arm-none-eabi-gcc so that we can use some clever commands to automatically find the paths to required libraries we
#			   must manually link in.
PREFIX = arm-none-eabi-

ifdef GCC_PATH
GCC_ARM_CC = $(GCC_PATH)/$(PREFIX)gcc
CP = $(GCC_PATH)/$(PREFIX)objcopy
SZ = $(GCC_PATH)/$(PREFIX)size
else
GCC_ARM_CC = $(PREFIX)gcc
CP = $(PREFIX)objcopy
SZ = $(PREFIX)size
endif

# CHANGE NOTE: zig cc is now used in place of arm-none-eabi-gcc
CC = zig cc
AS = zig cc -x assembler-with-cpp

HEX = $(CP) -O ihex
BIN = $(CP) -O binary -S
 
#######################################
# CFLAGS
#######################################
# cpu
# CHANGE NOTE: zig cc uses "_" instead of "-" in -mcpu arg
CPU = -mcpu=cortex_m7
GCC_ARM_CPU = -mcpu=cortex-m7
# fpu
FPU = -mfpu=fpv5-sp-d16

# float-abi
FLOAT-ABI = -mfloat-abi=hard

# mcu
# CHANGE NOTE: zig cc requires "--target=thumb-freestanding-eabihf" to specify the target for both compilation AND linking
MCU = --target=thumb-freestanding-eabihf $(CPU) -mthumb $(FPU) $(FLOAT-ABI)
GCC_ARM_MCU = $(GCC_ARM_CPU) -mthumb $(FPU) $(FLOAT-ABI)

# macros for gcc
# AS defines
AS_DEFS = 

# C defines
C_DEFS =  \
-DUSE_HAL_DRIVER \
-DSTM32F750xx

# AS includes
AS_INCLUDES = 

# C includes
C_INCLUDES =  \
-ICore/Inc \
-IDrivers/STM32F7xx_HAL_Driver/Inc \
-IDrivers/STM32F7xx_HAL_Driver/Inc/Legacy \
-IDrivers/CMSIS/Device/ST/STM32F7xx/Include \
-IDrivers/CMSIS/Include


# compile gcc flags
ASFLAGS = $(MCU) $(AS_DEFS) $(AS_INCLUDES) $(OPT) -Wall -fdata-sections -ffunction-sections

# CHANGE NOTE: Using arm-none-eabi-gcc to define our needed system include paths
GCC_ARM_SYSROOT = \
  $(shell $(GCC_ARM_CC) $(GCC_ARM_MCU) -print-sysroot 2>&1)

# CHANGE NOTE: The directory where Newlib's libc.a & libm.a reside for the specific target architecture
GCC_ARM_MULTI_DIR = \
  $(shell $(GCC_ARM_CC) $(GCC_ARM_MCU) -print-multi-directory 2>&1)

# CHANGE NOTE: Need the version for some specific object paths
GCC_ARM_VERSION = \
  $(shell $(GCC_ARM_CC) $(GCC_ARM_MCU) -dumpversion 2>&1)


# CHANGE NOTE: We manually add arm-none-eabi-gcc system headers as a system include path
CFLAGS += -isystem $(GCC_ARM_SYSROOT)/include $(MCU) $(C_DEFS) $(C_INCLUDES) $(OPT) -Wall -fdata-sections -ffunction-sections

ifeq ($(DEBUG), 1)
CFLAGS += -g -gdwarf-2
endif


# Generate dependency information
CFLAGS += -MMD -MP -MF"$(@:%.o=%.d)"


#######################################
# LDFLAGS
#######################################
# link script
LDSCRIPT = STM32F750N8Hx_FLASH.ld

# libraries
# CHANGE NOTE: 
#  - Manually provide .a library file locations using "-L" arg
#  - No "-specs=nano.specs" spec sheet exists in zig cc, so we specify the "nano" variant of libc manually ("-lc_nano" instead of "-lc")
#  - "-lgcc" is no longer included, as Zig provides its own equivalent functionality to this library
#  - "-lnosys" is also skipped, as ST already provides code with this functionality, so we get duplicate symbol errors otherwise
LIBS = -lc_nano -lm
LIBDIR = -L$(GCC_ARM_SYSROOT)/../lib/gcc/arm-none-eabi/$(GCC_ARM_VERSION)/$(GCC_ARM_MULTI_DIR) -L$(GCC_ARM_SYSROOT)/lib/$(GCC_ARM_MULTI_DIR)
LDFLAGS = $(MCU) -T$(LDSCRIPT) $(LIBDIR) $(LIBS) -Wl,--gc-sections

# default action: build all
all: $(BUILD_DIR)/$(TARGET).elf $(BUILD_DIR)/$(TARGET).hex $(BUILD_DIR)/$(TARGET).bin


#######################################
# build the application
#######################################
# list of objects
OBJECTS = $(addprefix $(BUILD_DIR)/,$(notdir $(C_SOURCES:.c=.o)))
vpath %.c $(sort $(dir $(C_SOURCES)))

# CHANGE NOTE: We have to manually include the c-runtime objects from gcc-arm-none-eabi for our specific architecture
EXTRA_OBJECTS = \
	$(GCC_ARM_SYSROOT)/../lib/gcc/arm-none-eabi/$(GCC_ARM_VERSION)/$(GCC_ARM_MULTI_DIR)/crti.o \
	$(GCC_ARM_SYSROOT)/../lib/gcc/arm-none-eabi/$(GCC_ARM_VERSION)/$(GCC_ARM_MULTI_DIR)/crtbegin.o \
	$(GCC_ARM_SYSROOT)/../lib/gcc/arm-none-eabi/$(GCC_ARM_VERSION)/$(GCC_ARM_MULTI_DIR)/crtn.o \
	$(GCC_ARM_SYSROOT)/../lib/gcc/arm-none-eabi/$(GCC_ARM_VERSION)/$(GCC_ARM_MULTI_DIR)/crtend.o \
	$(GCC_ARM_SYSROOT)/lib/$(GCC_ARM_MULTI_DIR)/crt0.o

# list of ASM program objects
OBJECTS += $(addprefix $(BUILD_DIR)/,$(notdir $(ASM_SOURCES:.s=.o)))
vpath %.s $(sort $(dir $(ASM_SOURCES)))
OBJECTS += $(addprefix $(BUILD_DIR)/,$(notdir $(ASMM_SOURCES:.S=.o)))
vpath %.S $(sort $(dir $(ASMM_SOURCES)))

# CHANGE NOTE: TODO: See if there's a "clang" way of generating assembly files like GCC does with "-Wa,-a,-ad,-alms=..."
$(BUILD_DIR)/%.o: %.c Makefile | $(BUILD_DIR) 
	$(CC) -c $(CFLAGS) $< -o $@

$(BUILD_DIR)/%.o: %.s Makefile | $(BUILD_DIR)
	$(AS) -c $(CFLAGS) $< -o $@

$(BUILD_DIR)/%.o: %.S Makefile | $(BUILD_DIR)
	$(AS) -c $(CFLAGS) $< -o $@

# CHANGE NOTE: $(MCU) args have been added here since zig's linker (LLVM's ld.lld) requires them 
$(BUILD_DIR)/$(TARGET).elf: $(OBJECTS) Makefile
	$(CC) $(MCU) $(OBJECTS) $(EXTRA_OBJECTS) $(LDFLAGS) -o $@
	$(SZ) $@

$(BUILD_DIR)/%.hex: $(BUILD_DIR)/%.elf | $(BUILD_DIR)
	$(HEX) $< $@
	
$(BUILD_DIR)/%.bin: $(BUILD_DIR)/%.elf | $(BUILD_DIR)
	$(BIN) $< $@	
	
$(BUILD_DIR):
	mkdir $@		

#######################################
# clean up
#######################################
clean:
	-rm -fR $(BUILD_DIR)
  
#######################################
# dependencies
#######################################
-include $(wildcard $(BUILD_DIR)/*.d)

# *** EOF ***