196 lines
		
	
	
		
			5.5 KiB
		
	
	
	
		
			Makefile
		
	
	
	
	
	
			
		
		
	
	
			196 lines
		
	
	
		
			5.5 KiB
		
	
	
	
		
			Makefile
		
	
	
	
	
	
# ---------------------------------------
 | 
						|
# Common make rules for all examples
 | 
						|
# ---------------------------------------
 | 
						|
 | 
						|
# Set all as default goal
 | 
						|
.DEFAULT_GOAL := all
 | 
						|
 | 
						|
# ---------------- GNU Make Start -----------------------
 | 
						|
# ESP32-Sx and RP2040 has its own CMake build system
 | 
						|
ifeq (,$(findstring $(FAMILY),espressif rp2040))
 | 
						|
 | 
						|
# ---------------------------------------
 | 
						|
# Rules
 | 
						|
# ---------------------------------------
 | 
						|
 | 
						|
all: $(BUILD)/$(PROJECT).bin $(BUILD)/$(PROJECT).hex size
 | 
						|
 | 
						|
uf2: $(BUILD)/$(PROJECT).uf2
 | 
						|
 | 
						|
# We set vpath to point to the top of the tree so that the source files
 | 
						|
# can be located. By following this scheme, it allows a single build rule
 | 
						|
# to be used to compile all .c files.
 | 
						|
vpath %.c . $(TOP)
 | 
						|
vpath %.s . $(TOP)
 | 
						|
vpath %.S . $(TOP)
 | 
						|
 | 
						|
include ${TOP}/examples/build_system/make/toolchain/$(TOOLCHAIN)_rules.mk
 | 
						|
 | 
						|
# ---------------------------------------
 | 
						|
# Compiler Flags
 | 
						|
# ---------------------------------------
 | 
						|
 | 
						|
CFLAGS += $(addprefix -I,$(INC))
 | 
						|
 | 
						|
# Verbose mode
 | 
						|
ifeq ("$(V)","1")
 | 
						|
$(info CFLAGS  $(CFLAGS) ) $(info )
 | 
						|
$(info LDFLAGS $(LDFLAGS)) $(info )
 | 
						|
$(info ASFLAGS $(ASFLAGS)) $(info )
 | 
						|
endif
 | 
						|
 | 
						|
 | 
						|
OBJ_DIRS = $(sort $(dir $(OBJ)))
 | 
						|
$(OBJ): | $(OBJ_DIRS)
 | 
						|
$(OBJ_DIRS):
 | 
						|
ifeq ($(CMDEXE),1)
 | 
						|
	-@$(MKDIR) $(subst /,\,$@)
 | 
						|
else
 | 
						|
	@$(MKDIR) -p $@
 | 
						|
endif
 | 
						|
 | 
						|
# UF2 generation, iMXRT need to strip to text only before conversion
 | 
						|
ifneq ($(FAMILY),imxrt)
 | 
						|
$(BUILD)/$(PROJECT).uf2: $(BUILD)/$(PROJECT).hex
 | 
						|
	@echo CREATE $@
 | 
						|
	$(PYTHON) $(TOP)/tools/uf2/utils/uf2conv.py -f $(UF2_FAMILY_ID) -c -o $@ $^
 | 
						|
endif
 | 
						|
 | 
						|
copy-artifact: $(BUILD)/$(PROJECT).bin $(BUILD)/$(PROJECT).hex $(BUILD)/$(PROJECT).uf2
 | 
						|
 | 
						|
endif
 | 
						|
# ---------------- GNU Make End -----------------------
 | 
						|
 | 
						|
.PHONY: clean
 | 
						|
clean:
 | 
						|
ifeq ($(CMDEXE),1)
 | 
						|
	rd /S /Q $(subst /,\,$(BUILD))
 | 
						|
else
 | 
						|
	$(RM) -rf $(BUILD)
 | 
						|
endif
 | 
						|
 | 
						|
# get depenecies
 | 
						|
.PHONY: get-deps
 | 
						|
get-deps:
 | 
						|
	$(PYTHON) $(TOP)/tools/get_deps.py ${FAMILY}
 | 
						|
 | 
						|
.PHONY: size
 | 
						|
size: $(BUILD)/$(PROJECT).elf
 | 
						|
	-@echo ''
 | 
						|
	@$(SIZE) $<
 | 
						|
	-@echo ''
 | 
						|
 | 
						|
# linkermap must be install previously at https://github.com/hathach/linkermap
 | 
						|
linkermap: $(BUILD)/$(PROJECT).elf
 | 
						|
	@linkermap -v $<.map
 | 
						|
 | 
						|
# ---------------------------------------
 | 
						|
# Flash Targets
 | 
						|
# ---------------------------------------
 | 
						|
 | 
						|
# --------------- Jlink -----------------
 | 
						|
ifeq ($(OS),Windows_NT)
 | 
						|
  JLINKEXE = JLink.exe
 | 
						|
else
 | 
						|
  JLINKEXE = JLinkExe
 | 
						|
endif
 | 
						|
 | 
						|
# Jlink Interface
 | 
						|
JLINK_IF ?= swd
 | 
						|
 | 
						|
# Jlink script
 | 
						|
$(BUILD)/$(BOARD).jlink: $(BUILD)/$(PROJECT).hex
 | 
						|
	@echo halt > $@
 | 
						|
	@echo loadfile $^ >> $@
 | 
						|
	@echo r >> $@
 | 
						|
	@echo go >> $@
 | 
						|
	@echo exit >> $@
 | 
						|
 | 
						|
# Flash using jlink
 | 
						|
flash-jlink: $(BUILD)/$(BOARD).jlink
 | 
						|
	$(JLINKEXE) -device $(JLINK_DEVICE) -if $(JLINK_IF) -JTAGConf -1,-1 -speed auto -CommandFile $<
 | 
						|
 | 
						|
# --------------- stm32 cube programmer -----------------
 | 
						|
# Flash STM32 MCU using stlink with STM32 Cube Programmer CLI
 | 
						|
flash-stlink: $(BUILD)/$(PROJECT).elf
 | 
						|
	STM32_Programmer_CLI --connect port=swd --write $< --go
 | 
						|
 | 
						|
# --------------- xfel -----------------
 | 
						|
$(BUILD)/$(PROJECT)-sunxi.bin: $(BUILD)/$(PROJECT).bin
 | 
						|
	$(PYTHON) $(TOP)/tools/mksunxi.py $< $@
 | 
						|
 | 
						|
flash-xfel: $(BUILD)/$(PROJECT)-sunxi.bin
 | 
						|
	xfel spinor write 0 $<
 | 
						|
	xfel reset
 | 
						|
 | 
						|
# --------------- pyocd -----------------
 | 
						|
PYOCD_OPTION ?=
 | 
						|
flash-pyocd: $(BUILD)/$(PROJECT).hex
 | 
						|
	pyocd flash -t $(PYOCD_TARGET) $(PYOCD_OPTION) $<
 | 
						|
	#pyocd reset -t $(PYOCD_TARGET)
 | 
						|
 | 
						|
# --------------- openocd -----------------
 | 
						|
OPENOCD_OPTION ?=
 | 
						|
flash-openocd: $(BUILD)/$(PROJECT).elf
 | 
						|
	openocd $(OPENOCD_OPTION) -c "program $< verify reset exit"
 | 
						|
 | 
						|
# --------------- openocd-wch -----------------
 | 
						|
# wch-linke is not supported yet in official openOCD yet. We need to either use
 | 
						|
# 1. download openocd as part of mounriver studio http://www.mounriver.com/download or
 | 
						|
# 2. compiled from https://github.com/hathach/riscv-openocd-wch or
 | 
						|
#    https://github.com/dragonlock2/miscboards/blob/main/wch/SDK/riscv-openocd.tar.xz
 | 
						|
#    with  ./configure --disable-werror --enable-wlinke --enable-ch347=no
 | 
						|
OPENOCD_WCH ?= /home/${USER}/app/riscv-openocd-wch/src/openocd
 | 
						|
OPENOCD_WCH_OPTION ?=
 | 
						|
flash-openocd-wch: $(BUILD)/$(PROJECT).elf
 | 
						|
	$(OPENOCD_WCH) $(OPENOCD_WCH_OPTION) -c init -c halt -c "flash write_image $<" -c reset -c exit
 | 
						|
 | 
						|
# --------------- wlink-rs -----------------
 | 
						|
# flash with https://github.com/ch32-rs/wlink
 | 
						|
WLINK_RS ?= wlink
 | 
						|
flash-wlink-rs: $(BUILD)/$(PROJECT).elf
 | 
						|
	$(WLINK_RS) flash $<
 | 
						|
 | 
						|
# --------------- dfu-util -----------------
 | 
						|
DFU_UTIL_OPTION ?= -a 0
 | 
						|
flash-dfu-util: $(BUILD)/$(PROJECT).bin
 | 
						|
	dfu-util -R $(DFU_UTIL_OPTION) -D $<
 | 
						|
 | 
						|
# --------------- Black Magic -----------------
 | 
						|
# This symlink is created by https://github.com/blacksphere/blackmagic/blob/master/driver/99-blackmagic.rules
 | 
						|
BMP ?= /dev/ttyBmpGdb
 | 
						|
 | 
						|
flash-bmp: $(BUILD)/$(PROJECT).elf
 | 
						|
	$(GDB) --batch -ex 'target extended-remote $(BMP)' -ex 'monitor swdp_scan' -ex 'attach 1' -ex load  $<
 | 
						|
 | 
						|
debug-bmp: $(BUILD)/$(PROJECT).elf
 | 
						|
	$(GDB) -ex 'target extended-remote $(BMP)' -ex 'monitor swdp_scan' -ex 'attach 1' $<
 | 
						|
 | 
						|
# --------------- TI Uniflash -----------------
 | 
						|
DSLITE ?= dslite.sh
 | 
						|
flash-uniflash: $(BUILD)/$(PROJECT).hex
 | 
						|
	${DSLITE} ${UNIFLASH_OPTION} -f $<
 | 
						|
 | 
						|
#-------------- Artifacts --------------
 | 
						|
 | 
						|
# Create binary directory
 | 
						|
$(BIN):
 | 
						|
ifeq ($(CMDEXE),1)
 | 
						|
	@$(MKDIR) $(subst /,\,$@)
 | 
						|
else
 | 
						|
	@$(MKDIR) -p $@
 | 
						|
endif
 | 
						|
 | 
						|
# Copy binaries .elf, .bin, .hex, .uf2 to BIN for upload
 | 
						|
# due to large size of combined artifacts, only uf2 is uploaded for now
 | 
						|
copy-artifact: $(BIN)
 | 
						|
	@$(CP) $(BUILD)/$(PROJECT).uf2 $(BIN)
 | 
						|
	#@$(CP) $(BUILD)/$(PROJECT).bin $(BIN)
 | 
						|
	#@$(CP) $(BUILD)/$(PROJECT).hex $(BIN)
 | 
						|
	#@$(CP) $(BUILD)/$(PROJECT).elf $(BIN)
 | 
						|
 | 
						|
# Print out the value of a make variable.
 | 
						|
# https://stackoverflow.com/questions/16467718/how-to-print-out-a-variable-in-makefile
 | 
						|
print-%:
 | 
						|
	@echo $* = $($*)
 |