Makefile

   1 ###############################################################################
   2 # "THE BEER-WARE LICENSE" (Revision 42):
   3 # <msmith@FreeBSD.ORG> wrote this file. As long as you retain this notice you
   4 # can do whatever you want with this stuff. If we meet some day, and you think
   5 # this stuff is worth it, you can buy me a beer in return
   6 ###############################################################################
   7 #
   8 # Makefile for building the betaflight firmware.
   9 #
  10 # Invoke this with 'make help' to see the list of supported targets.
  11 #
  12 ###############################################################################
  13
  14
  15 # Things that the user might override on the commandline
  16 #
  17
  18 # The target to build, see VALID_TARGETS below
  19 TARGET    ?= STM32F405
  20
  21 # Compile-time options
  22 OPTIONS   ?=
  23
  24 # compile for OpenPilot BootLoader support
  25 OPBL      ?= no
  26
  27 # compile for External Storage Bootloader support
  28 EXST      ?= no
  29
  30 # compile for target loaded into RAM
  31 RAM_BASED ?= no
  32
  33 # reserve space for custom defaults
  34 CUSTOM_DEFAULTS_EXTENDED ?= no
  35
  36 # Debugger optons:
  37 #   empty           - ordinary build with all optimizations enabled
  38 #   RELWITHDEBINFO  - ordinary build with debug symbols and all optimizations enabled
  39 #   GDB             - debug build with minimum number of optimizations
  40 DEBUG     ?=
  41
  42 # Insert the debugging hardfault debugger
  43 # releases should not be built with this flag as it does not disable pwm output
  44 DEBUG_HARDFAULTS ?=
  45
  46 # Serial port/Device for flashing
  47 SERIAL_DEVICE   ?= $(firstword $(wildcard /dev/ttyACM*) $(firstword $(wildcard /dev/ttyUSB*) no-port-found))
  48
  49 # Flash size (KB).  Some low-end chips actually have more flash than advertised, use this to override.
  50 FLASH_SIZE ?=
  51
  52
  53 ###############################################################################
  54 # Things that need to be maintained as the source changes
  55 #
  56
  57 FORKNAME      = betaflight
  58
  59 # Working directories
  60 ROOT            := $(patsubst %/,%,$(dir $(lastword $(MAKEFILE_LIST))))
  61 SRC_DIR         := $(ROOT)/src/main
  62 OBJECT_DIR      := $(ROOT)/obj/main
  63 BIN_DIR         := $(ROOT)/obj
  64 CMSIS_DIR       := $(ROOT)/lib/main/CMSIS
  65 INCLUDE_DIRS    := $(SRC_DIR) \
  66                    $(ROOT)/src/main/target \
  67                    $(ROOT)/src/main/startup
  68 LINKER_DIR      := $(ROOT)/src/link
  69
  70 ## V                 : Set verbosity level based on the V= parameter
  71 ##                     V=0 Low
  72 ##                     V=1 High
  73 include $(ROOT)/make/build_verbosity.mk
  74
  75 # Build tools, so we all share the same versions
  76 # import macros common to all supported build systems
  77 include $(ROOT)/make/system-id.mk
  78
  79 # developer preferences, edit these at will, they'll be gitignored
  80 -include $(ROOT)/make/local.mk
  81
  82 # pre-build sanity checks
  83 include $(ROOT)/make/checks.mk
  84
  85 # configure some directories that are relative to wherever ROOT_DIR is located
  86 ifndef TOOLS_DIR
  87 TOOLS_DIR := $(ROOT)/tools
  88 endif
  89 BUILD_DIR := $(ROOT)/build
  90 DL_DIR    := $(ROOT)/downloads
  91
  92 export RM := rm
  93
  94 # import macros that are OS specific
  95 include $(ROOT)/make/$(OSFAMILY).mk
  96
  97 # include the tools makefile
  98 include $(ROOT)/make/tools.mk
  99
 100 # default xtal value for F4 targets
 101 HSE_VALUE       ?= 8000000
 102
 103 # used for turning on features like VCP and SDCARD
 104 FEATURES        =
 105
 106 # used to disable features based on flash space shortage (larger number => more features disabled)
 107 FEATURE_CUT_LEVEL_SUPPLIED := $(FEATURE_CUT_LEVEL)
 108 FEATURE_CUT_LEVEL =
 109
 110 # The list of targets to build for 'pre-push'
 111 PRE_PUSH_TARGET_LIST ?= OMNIBUSF4 STM32F405 SPRACINGF7DUAL STM32F7X2 NUCLEOH743 SITL test-representative
 112
 113 include $(ROOT)/make/targets.mk
 114
 115 REVISION := $(shell git log -1 --format="%h")
 116
 117 FC_VER_MAJOR := $(shell grep " FC_VERSION_MAJOR" src/main/build/version.h | awk '{print $$3}' )
 118 FC_VER_MINOR := $(shell grep " FC_VERSION_MINOR" src/main/build/version.h | awk '{print $$3}' )
 119 FC_VER_PATCH := $(shell grep " FC_VERSION_PATCH" src/main/build/version.h | awk '{print $$3}' )
 120
 121 FC_VER := $(FC_VER_MAJOR).$(FC_VER_MINOR).$(FC_VER_PATCH)
 122
 123 # Search path for sources
 124 VPATH           := $(SRC_DIR):$(SRC_DIR)/startup
 125 USBFS_DIR       = $(ROOT)/lib/main/STM32_USB-FS-Device_Driver
 126 USBPERIPH_SRC   = $(notdir $(wildcard $(USBFS_DIR)/src/*.c))
 127 FATFS_DIR       = $(ROOT)/lib/main/FatFS
 128 FATFS_SRC       = $(notdir $(wildcard $(FATFS_DIR)/*.c))
 129
 130 CSOURCES        := $(shell find $(SRC_DIR) -name '*.c')
 131
 132 LD_FLAGS        :=
 133 EXTRA_LD_FLAGS  :=
 134
 135 #
 136 # Default Tool options - can be overridden in {mcu}.mk files.
 137 #
 138 ifeq ($(DEBUG),GDB)
 139 OPTIMISE_DEFAULT      := -Og
 140
 141 LTO_FLAGS             := $(OPTIMISE_DEFAULT)
 142 DEBUG_FLAGS            = -ggdb3 -DDEBUG
 143 else
 144 ifeq ($(DEBUG),INFO)
 145 DEBUG_FLAGS            = -ggdb3
 146 endif
 147 OPTIMISATION_BASE     := -flto -fuse-linker-plugin -ffast-math
 148 OPTIMISE_DEFAULT      := -O2
 149 OPTIMISE_SPEED        := -Ofast
 150 OPTIMISE_SIZE         := -Os
 151
 152 LTO_FLAGS             := $(OPTIMISATION_BASE) $(OPTIMISE_SPEED)
 153 endif
 154
 155 VPATH                   := $(VPATH):$(ROOT)/make/mcu
 156 VPATH                   := $(VPATH):$(ROOT)/make
 157
 158 # start specific includes
 159 include $(ROOT)/make/mcu/$(TARGET_MCU).mk
 160
 161 # openocd specific includes
 162 include $(ROOT)/make/openocd.mk
 163
 164 # Configure default flash sizes for the targets (largest size specified gets hit first) if flash not specified already.
 165 ifeq ($(FLASH_SIZE),)
 166 ifneq ($(TARGET_FLASH),)
 167 FLASH_SIZE := $(TARGET_FLASH)
 168 else
 169 $(error FLASH_SIZE not configured for target $(TARGET))
 170 endif
 171 endif
 172
 173 DEVICE_FLAGS  := $(DEVICE_FLAGS) -DFLASH_SIZE=$(FLASH_SIZE)
 174
 175 ifneq ($(HSE_VALUE),)
 176 DEVICE_FLAGS  := $(DEVICE_FLAGS) -DHSE_VALUE=$(HSE_VALUE)
 177 endif
 178
 179 ifneq ($(FEATURE_CUT_LEVEL_SUPPLIED),)
 180 DEVICE_FLAGS  := $(DEVICE_FLAGS) -DFEATURE_CUT_LEVEL=$(FEATURE_CUT_LEVEL_SUPPLIED)
 181 else ifneq ($(FEATURE_CUT_LEVEL),)
 182 DEVICE_FLAGS  := $(DEVICE_FLAGS) -DFEATURE_CUT_LEVEL=$(FEATURE_CUT_LEVEL)
 183 endif
 184
 185 TARGET_DIR     = $(ROOT)/src/main/target/$(BASE_TARGET)
 186 TARGET_DIR_SRC = $(notdir $(wildcard $(TARGET_DIR)/*.c))
 187
 188 ifeq ($(OPBL),yes)
 189 TARGET_FLAGS := -DOPBL $(TARGET_FLAGS)
 190 .DEFAULT_GOAL := binary
 191 else
 192 .DEFAULT_GOAL := hex
 193 endif
 194
 195 ifeq ($(CUSTOM_DEFAULTS_EXTENDED),yes)
 196 TARGET_FLAGS += -DUSE_CUSTOM_DEFAULTS=
 197 EXTRA_LD_FLAGS += -Wl,--defsym=USE_CUSTOM_DEFAULTS_EXTENDED=1
 198 endif
 199
 200 INCLUDE_DIRS    := $(INCLUDE_DIRS) \
 201                    $(ROOT)/lib/main/MAVLink
 202
 203 INCLUDE_DIRS    := $(INCLUDE_DIRS) \
 204                    $(TARGET_DIR)
 205
 206 VPATH           := $(VPATH):$(TARGET_DIR)
 207
 208 include $(ROOT)/make/source.mk
 209
 210 ###############################################################################
 211 # Things that might need changing to use different tools
 212 #
 213
 214 # Find out if ccache is installed on the system
 215 CCACHE := ccache
 216 RESULT = $(shell (which $(CCACHE) > /dev/null 2>&1; echo $$?) )
 217 ifneq ($(RESULT),0)
 218 CCACHE :=
 219 endif
 220
 221 # Tool names
 222 CROSS_CC    := $(CCACHE) $(ARM_SDK_PREFIX)gcc
 223 CROSS_CXX   := $(CCACHE) $(ARM_SDK_PREFIX)g++
 224 CROSS_GDB   := $(ARM_SDK_PREFIX)gdb
 225 OBJCOPY     := $(ARM_SDK_PREFIX)objcopy
 226 OBJDUMP     := $(ARM_SDK_PREFIX)objdump
 227 SIZE        := $(ARM_SDK_PREFIX)size
 228 DFUSE-PACK  := src/utils/dfuse-pack.py
 229
 230 #
 231 # Tool options.
 232 #
 233 CC_DEBUG_OPTIMISATION   := $(OPTIMISE_DEFAULT)
 234 CC_DEFAULT_OPTIMISATION := $(OPTIMISATION_BASE) $(OPTIMISE_DEFAULT)
 235 CC_SPEED_OPTIMISATION   := $(OPTIMISATION_BASE) $(OPTIMISE_SPEED)
 236 CC_SIZE_OPTIMISATION    := $(OPTIMISATION_BASE) $(OPTIMISE_SIZE)
 237 CC_NO_OPTIMISATION      :=
 238
 239 #
 240 # Added after GCC version update, remove once the warnings have been fixed
 241 #
 242 TEMPORARY_FLAGS :=
 243
 244 CFLAGS     += $(ARCH_FLAGS) \
 245               $(addprefix -D,$(OPTIONS)) \
 246               $(addprefix -I,$(INCLUDE_DIRS)) \
 247               $(DEBUG_FLAGS) \
 248               -std=gnu11 \
 249               -Wall -Wextra -Wunsafe-loop-optimizations -Wdouble-promotion \
 250               -ffunction-sections \
 251               -fdata-sections \
 252               -fno-common \
 253               -pedantic \
 254               $(TEMPORARY_FLAGS) \
 255               $(DEVICE_FLAGS) \
 256               -D_GNU_SOURCE \
 257               -DUSE_STDPERIPH_DRIVER \
 258               -D$(TARGET) \
 259               $(TARGET_FLAGS) \
 260               -D'__FORKNAME__="$(FORKNAME)"' \
 261               -D'__TARGET__="$(TARGET)"' \
 262               -D'__REVISION__="$(REVISION)"' \
 263               -save-temps=obj \
 264               -MMD -MP \
 265               $(EXTRA_FLAGS)
 266
 267 ASFLAGS     = $(ARCH_FLAGS) \
 268               $(DEBUG_FLAGS) \
 269               -x assembler-with-cpp \
 270               $(addprefix -I,$(INCLUDE_DIRS)) \
 271               -MMD -MP
 272
 273 ifeq ($(LD_FLAGS),)
 274 LD_FLAGS     = -lm \
 275               -nostartfiles \
 276               --specs=nano.specs \
 277               -lc \
 278               -lnosys \
 279               $(ARCH_FLAGS) \
 280               $(LTO_FLAGS) \
 281               $(DEBUG_FLAGS) \
 282               -static \
 283               -Wl,-gc-sections,-Map,$(TARGET_MAP) \
 284               -Wl,-L$(LINKER_DIR) \
 285               -Wl,--cref \
 286               -Wl,--no-wchar-size-warning \
 287               -Wl,--print-memory-usage \
 288               -T$(LD_SCRIPT) \
 289                $(EXTRA_LD_FLAGS)
 290 endif
 291
 292 ###############################################################################
 293 # No user-serviceable parts below
 294 ###############################################################################
 295
 296 CPPCHECK        = cppcheck $(CSOURCES) --enable=all --platform=unix64 \
 297                   --std=c99 --inline-suppr --quiet --force \
 298                   $(addprefix -I,$(INCLUDE_DIRS)) \
 299                   -I/usr/include -I/usr/include/linux
 300
 301 #
 302 # Things we will build
 303 #
 304 TARGET_S19      = $(BIN_DIR)/$(FORKNAME)_$(FC_VER)_$(TARGET).s19
 305 TARGET_BIN      = $(BIN_DIR)/$(FORKNAME)_$(FC_VER)_$(TARGET).bin
 306 TARGET_HEX      = $(BIN_DIR)/$(FORKNAME)_$(FC_VER)_$(TARGET).hex
 307 TARGET_DFU      = $(BIN_DIR)/$(FORKNAME)_$(FC_VER)_$(TARGET).dfu
 308 TARGET_ELF      = $(OBJECT_DIR)/$(FORKNAME)_$(TARGET).elf
 309 TARGET_EXST_ELF = $(OBJECT_DIR)/$(FORKNAME)_$(TARGET)_EXST.elf
 310 TARGET_UNPATCHED_BIN = $(OBJECT_DIR)/$(FORKNAME)_$(TARGET)_UNPATCHED.bin
 311 TARGET_LST      = $(OBJECT_DIR)/$(FORKNAME)_$(TARGET).lst
 312 TARGET_OBJS     = $(addsuffix .o,$(addprefix $(OBJECT_DIR)/$(TARGET)/,$(basename $(SRC))))
 313 TARGET_DEPS     = $(addsuffix .d,$(addprefix $(OBJECT_DIR)/$(TARGET)/,$(basename $(SRC))))
 314 TARGET_MAP      = $(OBJECT_DIR)/$(FORKNAME)_$(TARGET).map
 315
 316 TARGET_EXST_HASH_SECTION_FILE = $(OBJECT_DIR)/$(TARGET)/exst_hash_section.bin
 317
 318 CLEAN_ARTIFACTS := $(TARGET_BIN)
 319 CLEAN_ARTIFACTS += $(TARGET_HEX)
 320 CLEAN_ARTIFACTS += $(TARGET_ELF) $(TARGET_OBJS) $(TARGET_MAP)
 321 CLEAN_ARTIFACTS += $(TARGET_LST)
 322 CLEAN_ARTIFACTS += $(TARGET_DFU)
 323
 324 # Make sure build date and revision is updated on every incremental build
 325 $(OBJECT_DIR)/$(TARGET)/build/version.o : $(SRC)
 326
 327 # List of buildable ELF files and their object dependencies.
 328 # It would be nice to compute these lists, but that seems to be just beyond make.
 329
 330 $(TARGET_LST): $(TARGET_ELF)
 331         $(V0) $(OBJDUMP) -S --disassemble $< > $@
 332
 333
 334 $(TARGET_S19): $(TARGET_ELF)
 335         @echo "Creating srec/S19 $(TARGET_S19)" "$(STDOUT)"
 336         $(V1) $(OBJCOPY) --output-target=srec $(TARGET_S19)
 337
 338 ifeq ($(EXST),no)
 339 $(TARGET_BIN): $(TARGET_ELF)
 340         @echo "Creating BIN $(TARGET_BIN)" "$(STDOUT)"
 341         $(V1) $(OBJCOPY) -O binary $< $@
 342
 343 $(TARGET_HEX): $(TARGET_ELF)
 344         @echo "Creating HEX $(TARGET_HEX)" "$(STDOUT)"
 345         $(V1) $(OBJCOPY) -O ihex --set-start 0x8000000 $< $@
 346
 347 $(TARGET_DFU): $(TARGET_HEX)
 348         @echo "Creating DFU $(TARGET_DFU)" "$(STDOUT)"
 349         $(V1) $(DFUSE-PACK) -i $< $@
 350
 351 else
 352 CLEAN_ARTIFACTS += $(TARGET_UNPATCHED_BIN) $(TARGET_EXST_HASH_SECTION_FILE) $(TARGET_EXST_ELF)
 353
 354 $(TARGET_UNPATCHED_BIN): $(TARGET_ELF)
 355         @echo "Creating BIN (without checksum) $(TARGET_UNPATCHED_BIN)" "$(STDOUT)"
 356         $(V1) $(OBJCOPY) -O binary $< $@
 357
 358 $(TARGET_BIN): $(TARGET_UNPATCHED_BIN)
 359         @echo "Creating EXST $(TARGET_BIN)" "$(STDOUT)"
 360 # Linker script should allow .bin generation from a .elf which results in a file that is the same length as the FIRMWARE_SIZE.
 361 # These 'dd' commands will pad a short binary to length FIRMWARE_SIZE.
 362         $(V1) dd if=/dev/zero ibs=1k count=$(FIRMWARE_SIZE) of=$(TARGET_BIN)
 363         $(V1) dd if=$(TARGET_UNPATCHED_BIN) of=$(TARGET_BIN) conv=notrunc
 364
 365         @echo "Generating MD5 hash of binary" "$(STDOUT)"
 366         $(V1) openssl dgst -md5 $(TARGET_BIN) > $(TARGET_UNPATCHED_BIN).md5
 367
 368         @echo "Patching MD5 hash into binary" "$(STDOUT)"
 369         $(V1) cat $(TARGET_UNPATCHED_BIN).md5 | awk '{printf("%08x: %s",(1024*$(FIRMWARE_SIZE))-16,$$2);}' | xxd -r - $(TARGET_BIN)
 370         $(V1) echo $(FIRMWARE_SIZE) | awk '{printf("-s 0x%08x -l 16 -c 16 %s",(1024*$$1)-16,"$(TARGET_BIN)");}' | xargs xxd
 371
 372 # Note: From the objcopy manual "If you do not specify outfile, objcopy creates a temporary file and destructively renames the result with the name of infile"
 373 # Due to this a temporary file must be created and removed, even though we're only extracting data from the input file.
 374 # If this temporary file is NOT used the $(TARGET_ELF) is modified, and running make a second time will result in
 375 # a) regeneration of $(TARGET_BIN), and
 376 # b) the results of $(TARGET_BIN) will not be as expected.
 377         @echo "Extracting HASH section from unpatched EXST elf $(TARGET_ELF)" "$(STDOUT)"
 378         $(OBJCOPY) $(TARGET_ELF) $(TARGET_EXST_ELF).tmp --dump-section .exst_hash=$(TARGET_EXST_HASH_SECTION_FILE)
 379         rm $(TARGET_EXST_ELF).tmp
 380
 381         @echo "Patching MD5 hash into HASH section" "$(STDOUT)"
 382         $(V1) cat $(TARGET_UNPATCHED_BIN).md5 | awk '{printf("%08x: %s",64-16,$$2);}' | xxd -r - $(TARGET_EXST_HASH_SECTION_FILE)
 383
 384         @echo "Patching updated HASH section into $(TARGET_EXST_ELF)" "$(STDOUT)"
 385         $(OBJCOPY) $(TARGET_ELF) $(TARGET_EXST_ELF) --update-section .exst_hash=$(TARGET_EXST_HASH_SECTION_FILE)
 386
 387 $(TARGET_HEX): $(TARGET_BIN)
 388         $(if $(EXST_ADJUST_VMA),,$(error "EXST_ADJUST_VMA not specified"))
 389
 390         @echo "Creating EXST HEX from patched EXST BIN $(TARGET_BIN), VMA Adjust $(EXST_ADJUST_VMA)" "$(STDOUT)"
 391         $(V1) $(OBJCOPY) -I binary -O ihex --adjust-vma=$(EXST_ADJUST_VMA) $(TARGET_BIN) $@
 392
 393 endif
 394
 395 $(TARGET_ELF): $(TARGET_OBJS) $(LD_SCRIPT)
 396         @echo "Linking $(TARGET)" "$(STDOUT)"
 397         $(V1) $(CROSS_CC) -o $@ $(filter-out %.ld,$^) $(LD_FLAGS)
 398         $(V1) $(SIZE) $(TARGET_ELF)
 399
 400 # Compile
 401
 402 ## compile_file takes two arguments: (1) optimisation description string and (2) optimisation compiler flag
 403 define compile_file
 404         echo "%% ($(1)) $<" "$(STDOUT)" && \
 405         $(CROSS_CC) -c -o $@ $(CFLAGS) $(2) $<
 406 endef
 407
 408 ifeq ($(DEBUG),GDB)
 409 $(OBJECT_DIR)/$(TARGET)/%.o: %.c
 410         $(V1) mkdir -p $(dir $@)
 411         $(V1) $(if $(findstring $<,$(NOT_OPTIMISED_SRC)), \
 412                 $(call compile_file,not optimised, $(CC_NO_OPTIMISATION)) \
 413         , \
 414                 $(call compile_file,debug,$(CC_DEBUG_OPTIMISATION)) \
 415         )
 416 else
 417 $(OBJECT_DIR)/$(TARGET)/%.o: %.c
 418         $(V1) mkdir -p $(dir $@)
 419         $(V1) $(if $(findstring $<,$(NOT_OPTIMISED_SRC)), \
 420                 $(call compile_file,not optimised,$(CC_NO_OPTIMISATION)) \
 421         , \
 422                 $(if $(findstring $(subst ./src/main/,,$<),$(SPEED_OPTIMISED_SRC)), \
 423                         $(call compile_file,speed optimised,$(CC_SPEED_OPTIMISATION)) \
 424                 , \
 425                         $(if $(findstring $(subst ./src/main/,,$<),$(SIZE_OPTIMISED_SRC)), \
 426                                 $(call compile_file,size optimised,$(CC_SIZE_OPTIMISATION)) \
 427                         , \
 428                                 $(call compile_file,optimised,$(CC_DEFAULT_OPTIMISATION)) \
 429                         ) \
 430                 ) \
 431         )
 432 endif
 433
 434 # Assemble
 435 $(OBJECT_DIR)/$(TARGET)/%.o: %.s
 436         $(V1) mkdir -p $(dir $@)
 437         @echo "%% $(notdir $<)" "$(STDOUT)"
 438         $(V1) $(CROSS_CC) -c -o $@ $(ASFLAGS) $<
 439
 440 $(OBJECT_DIR)/$(TARGET)/%.o: %.S
 441         $(V1) mkdir -p $(dir $@)
 442         @echo "%% $(notdir $<)" "$(STDOUT)"
 443         $(V1) $(CROSS_CC) -c -o $@ $(ASFLAGS) $<
 444
 445
 446 ## all               : Build all currently built targets
 447 all: $(CI_TARGETS)
 448
 449 ## all_all : Build all targets (including legacy / unsupported)
 450 all_all: $(VALID_TARGETS)
 451
 452 ## legacy : Build legacy targets
 453 legacy: $(LEGACY_TARGETS)
 454
 455 ## unsupported : Build unsupported targets
 456 unsupported: $(UNSUPPORTED_TARGETS)
 457
 458 ## pre-push : The minimum verification that should be run before pushing, to check if CI has a chance of succeeding
 459 pre-push:
 460         $(MAKE) $(addsuffix _clean,$(PRE_PUSH_TARGET_LIST)) $(PRE_PUSH_TARGET_LIST) EXTRA_FLAGS=-Werror
 461
 462 ## targets-group-1   : build some targets
 463 targets-group-1: $(GROUP_1_TARGETS)
 464
 465 ## targets-group-2   : build some targets
 466 targets-group-2: $(GROUP_2_TARGETS)
 467
 468 ## targets-group-3   : build some targets
 469 targets-group-3: $(GROUP_3_TARGETS)
 470
 471 ## targets-group-4   : build some targets
 472 targets-group-4: $(GROUP_4_TARGETS)
 473
 474 ## targets-group-5   : build some targets
 475 targets-group-5: $(GROUP_5_TARGETS)
 476
 477 ## targets-group-rest: build the rest of the targets (not listed in group 1, 2 or 3)
 478 targets-group-rest: $(GROUP_OTHER_TARGETS)
 479
 480 $(VALID_TARGETS):
 481         $(V0) @echo "Building $@" && \
 482         $(MAKE) binary hex TARGET=$@ && \
 483         echo "Building $@ succeeded."
 484
 485 $(NOBUILD_TARGETS):
 486         $(MAKE) TARGET=$@
 487
 488 TARGETS_CLEAN = $(addsuffix _clean,$(VALID_TARGETS) )
 489
 490 ## clean             : clean up temporary / machine-generated files
 491 clean:
 492         @echo "Cleaning $(TARGET)"
 493         $(V0) rm -f $(CLEAN_ARTIFACTS)
 494         $(V0) rm -rf $(OBJECT_DIR)/$(TARGET)
 495         @echo "Cleaning $(TARGET) succeeded."
 496
 497 ## test_clean        : clean up temporary / machine-generated files (tests)
 498 test-%_clean:
 499         $(MAKE) test_clean
 500
 501 test_clean:
 502         $(V0) cd src/test && $(MAKE) clean || true
 503
 504 ## <TARGET>_clean    : clean up one specific target (alias for above)
 505 $(TARGETS_CLEAN):
 506         $(V0) $(MAKE) -j TARGET=$(subst _clean,,$@) clean
 507
 508 ## clean_all         : clean all valid targets
 509 clean_all: $(TARGETS_CLEAN) test_clean
 510
 511 TARGETS_FLASH = $(addsuffix _flash,$(VALID_TARGETS) )
 512
 513 ## <TARGET>_flash    : build and flash a target
 514 $(TARGETS_FLASH):
 515         $(V0) $(MAKE) hex TARGET=$(subst _flash,,$@)
 516 ifneq (,$(findstring /dev/ttyUSB,$(SERIAL_DEVICE)))
 517         $(V0) $(MAKE) tty_flash TARGET=$(subst _flash,,$@)
 518 else
 519         $(V0) $(MAKE) dfu_flash TARGET=$(subst _flash,,$@)
 520 endif
 521
 522 ## tty_flash         : flash firmware (.hex) onto flight controller via a serial port
 523 tty_flash:
 524         $(V0) stty -F $(SERIAL_DEVICE) raw speed 115200 -crtscts cs8 -parenb -cstopb -ixon
 525         $(V0) echo -n 'R' > $(SERIAL_DEVICE)
 526         $(V0) stm32flash -w $(TARGET_HEX) -v -g 0x0 -b 115200 $(SERIAL_DEVICE)
 527
 528 ## dfu_flash         : flash firmware (.bin) onto flight controller via a DFU mode
 529 dfu_flash:
 530 ifneq (no-port-found,$(SERIAL_DEVICE))
 531         # potentially this is because the MCU already is in DFU mode, try anyway
 532         $(V0) echo -n 'R' > $(SERIAL_DEVICE)
 533         $(V0) sleep 1
 534 endif
 535         $(V0) $(MAKE) $(TARGET_DFU)
 536         $(V0) dfu-util -a 0 -D $(TARGET_DFU) -s :leave
 537
 538 st-flash_$(TARGET): $(TARGET_BIN)
 539         $(V0) st-flash --reset write $< 0x08000000
 540
 541 ## st-flash          : flash firmware (.bin) onto flight controller
 542 st-flash: st-flash_$(TARGET)
 543
 544 ifneq ($(OPENOCD_COMMAND),)
 545 openocd-gdb: $(TARGET_ELF)
 546         $(V0) $(OPENOCD_COMMAND) & $(CROSS_GDB) $(TARGET_ELF) -ex "target remote localhost:3333" -ex "load"
 547 endif
 548
 549 binary:
 550         $(V0) $(MAKE) -j $(TARGET_BIN)
 551
 552 srec:
 553         $(V0) $(MAKE) -j $(TARGET_S19)
 554
 555 hex:
 556         $(V0) $(MAKE) -j $(TARGET_HEX)
 557
 558 unbrick_$(TARGET): $(TARGET_HEX)
 559         $(V0) stty -F $(SERIAL_DEVICE) raw speed 115200 -crtscts cs8 -parenb -cstopb -ixon
 560         $(V0) stm32flash -w $(TARGET_HEX) -v -g 0x0 -b 115200 $(SERIAL_DEVICE)
 561
 562 ## unbrick           : unbrick flight controller
 563 unbrick: unbrick_$(TARGET)
 564
 565 ## cppcheck          : run static analysis on C source code
 566 cppcheck: $(CSOURCES)
 567         $(V0) $(CPPCHECK)
 568
 569 cppcheck-result.xml: $(CSOURCES)
 570         $(V0) $(CPPCHECK) --xml-version=2 2> cppcheck-result.xml
 571
 572 # mkdirs
 573 $(DL_DIR):
 574         mkdir -p $@
 575
 576 $(TOOLS_DIR):
 577         mkdir -p $@
 578
 579 $(BUILD_DIR):
 580         mkdir -p $@
 581
 582 ## version           : print firmware version
 583 version:
 584         @echo $(FC_VER)
 585
 586 ## help              : print this help message and exit
 587 help: Makefile make/tools.mk
 588         @echo ""
 589         @echo "Makefile for the $(FORKNAME) firmware"
 590         @echo ""
 591         @echo "Usage:"
 592         @echo "        make [V=<verbosity>] [TARGET=<target>] [OPTIONS=\"<options>\"]"
 593         @echo "Or:"
 594         @echo "        make <target> [V=<verbosity>] [OPTIONS=\"<options>\"]"
 595         @echo ""
 596         @echo "Valid TARGET values are: $(VALID_TARGETS)"
 597         @echo ""
 598         @sed -n 's/^## //p' $?
 599
 600 ## targets           : print a list of all valid target platforms (for consumption by scripts)
 601 targets:
 602         @echo "Valid targets:       $(VALID_TARGETS)"
 603         @echo "Built targets:       $(CI_TARGETS)"
 604         @echo "Legacy targets:      $(LEGACY_TARGETS)"
 605         @echo "Unsupported targets: $(UNSUPPORTED_TARGETS)"
 606         @echo "Target:              $(TARGET)"
 607         @echo "Base target:         $(BASE_TARGET)"
 608         @echo "targets-group-1:     $(GROUP_1_TARGETS)"
 609         @echo "targets-group-2:     $(GROUP_2_TARGETS)"
 610         @echo "targets-group-3:     $(GROUP_3_TARGETS)"
 611         @echo "targets-group-4:     $(GROUP_4_TARGETS)"
 612         @echo "targets-group-5:     $(GROUP_5_TARGETS)"
 613         @echo "targets-group-rest:  $(GROUP_OTHER_TARGETS)"
 614
 615         @echo "targets-group-1:     $(words $(GROUP_1_TARGETS)) targets"
 616         @echo "targets-group-2:     $(words $(GROUP_2_TARGETS)) targets"
 617         @echo "targets-group-3:     $(words $(GROUP_3_TARGETS)) targets"
 618         @echo "targets-group-4:     $(words $(GROUP_4_TARGETS)) targets"
 619         @echo "targets-group-5:     $(words $(GROUP_5_TARGETS)) targets"
 620         @echo "targets-group-rest:  $(words $(GROUP_OTHER_TARGETS)) targets"
 621         @echo "total in all groups  $(words $(CI_TARGETS)) targets"
 622
 623 ## target-mcu        : print the MCU type of the target
 624 target-mcu:
 625         @echo $(TARGET_MCU)
 626
 627 ## targets-by-mcu    : make all targets that have a MCU_TYPE mcu
 628 targets-by-mcu:
 629         $(V1) for target in $${TARGETS}; do \
 630                 TARGET_MCU_TYPE=$$($(MAKE) -s TARGET=$${target} target-mcu); \
 631                 if [ "$${TARGET_MCU_TYPE}" = "$${MCU_TYPE}" ]; then \
 632                         if [ "$${DO_BUILD}" = 1 ]; then \
 633                                 echo "Building target $${target}..."; \
 634                                 $(MAKE) TARGET=$${target}; \
 635                                 if [ $$? -ne 0 ]; then \
 636                                         echo "Building target $${target} failed, aborting."; \
 637                                         exit 1; \
 638                                 fi; \
 639                         else \
 640                                 echo -n "$${target} "; \
 641                         fi; \
 642                 fi; \
 643         done
 644         @echo
 645
 646 ## targets-f3        : make all F3 targets
 647 targets-f3:
 648         $(V1) $(MAKE) -s targets-by-mcu MCU_TYPE=STM32F3 TARGETS="$(VALID_TARGETS)" DO_BUILD=1
 649
 650 targets-f3-print:
 651         $(V1) $(MAKE) -s targets-by-mcu MCU_TYPE=STM32F3 TARGETS="$(VALID_TARGETS)"
 652
 653 ## targets-f4        : make all F4 targets
 654 targets-f4:
 655         $(V1) $(MAKE) -s targets-by-mcu MCU_TYPE=STM32F4 TARGETS="$(VALID_TARGETS)" DO_BUILD=1
 656
 657 targets-f4-print:
 658         $(V1) $(MAKE) -s targets-by-mcu MCU_TYPE=STM32F4 TARGETS="$(VALID_TARGETS)"
 659
 660 targets-ci-f4-print:
 661         $(V1) $(MAKE) -s targets-by-mcu MCU_TYPE=STM32F4 TARGETS="$(CI_TARGETS)"
 662
 663 ## targets-f7        : make all F7 targets
 664 targets-f7:
 665         $(V1) $(MAKE) -s targets-by-mcu MCU_TYPE=STM32F7 TARGETS="$(VALID_TARGETS)" DO_BUILD=1
 666
 667 targets-f7-print:
 668         $(V1) $(MAKE) -s targets-by-mcu MCU_TYPE=STM32F7 TARGETS="$(VALID_TARGETS)"
 669
 670 targets-ci-f7-print:
 671         $(V1) $(MAKE) -s targets-by-mcu MCU_TYPE=STM32F7 TARGETS="$(CI_TARGETS)"
 672
 673 ## test              : run the Betaflight test suite
 674 ## junittest         : run the Betaflight test suite, producing Junit XML result files.
 675 ## test-representative: run a representative subset of the Betaflight test suite (i.e. run all tests, but run each expanded test only for one target)
 676 ## test-all: run the Betaflight test suite including all per-target expanded tests
 677 test junittest test-all test-representative:
 678         $(V0) cd src/test && $(MAKE) $@
 679
 680 ## test_help         : print the help message for the test suite (including a list of the available tests)
 681 test_help:
 682         $(V0) cd src/test && $(MAKE) help
 683
 684 ## test_%            : run test 'test_%' from the test suite
 685 test_%:
 686         $(V0) cd src/test && $(MAKE) $@
 687
 688
 689 # rebuild everything when makefile changes
 690 $(TARGET_OBJS): Makefile $(TARGET_DIR)/target.mk $(wildcard make/*)
 691
 692 # include auto-generated dependencies
 693 -include $(TARGET_DEPS)