Added 'unified' target to Makefile.
[betaflight.git] / Makefile
blob39c83f3c780d7fbba9ea2e6688963dda28f04441
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 ###############################################################################
8 # Makefile for building the betaflight firmware.
10 # Invoke this with 'make help' to see the list of supported targets.
12 ###############################################################################
15 # Things that the user might override on the commandline
18 # The target to build, see VALID_TARGETS below
19 TARGET ?= STM32F405
21 # Compile-time options
22 OPTIONS ?=
24 # compile for OpenPilot BootLoader support
25 OPBL ?= no
27 # compile for External Storage Bootloader support
28 EXST ?= no
30 # compile for target loaded into RAM
31 RAM_BASED ?= no
33 # reserve space for custom defaults
34 CUSTOM_DEFAULTS_EXTENDED ?= no
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 ?=
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 ?=
46 # Serial port/Device for flashing
47 SERIAL_DEVICE ?= $(firstword $(wildcard /dev/ttyACM*) $(firstword $(wildcard /dev/ttyUSB*) no-port-found))
49 # Flash size (KB). Some low-end chips actually have more flash than advertised, use this to override.
50 FLASH_SIZE ?=
53 ###############################################################################
54 # Things that need to be maintained as the source changes
57 FORKNAME = betaflight
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
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
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
79 # developer preferences, edit these at will, they'll be gitignored
80 -include $(ROOT)/make/local.mk
82 # pre-build sanity checks
83 include $(ROOT)/make/checks.mk
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
92 export RM := rm
94 # import macros that are OS specific
95 include $(ROOT)/make/$(OSFAMILY).mk
97 # include the tools makefile
98 include $(ROOT)/make/tools.mk
100 # default xtal value for F4 targets
101 HSE_VALUE ?= 8000000
103 # used for turning on features like VCP and SDCARD
104 FEATURES =
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 =
110 # The list of targets to build for 'pre-push'
111 PRE_PUSH_TARGET_LIST ?= OMNIBUSF4 STM32F405 SPRACINGF7DUAL STM32F7X2 NUCLEOH743 SITL test-representative
113 include $(ROOT)/make/targets.mk
115 REVISION := $(shell git log -1 --format="%h")
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}' )
121 FC_VER := $(FC_VER_MAJOR).$(FC_VER_MINOR).$(FC_VER_PATCH)
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))
130 CSOURCES := $(shell find $(SRC_DIR) -name '*.c')
132 LD_FLAGS :=
133 EXTRA_LD_FLAGS :=
136 # Default Tool options - can be overridden in {mcu}.mk files.
138 ifeq ($(DEBUG),GDB)
139 OPTIMISE_DEFAULT := -Og
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
152 LTO_FLAGS := $(OPTIMISATION_BASE) $(OPTIMISE_SPEED)
153 endif
155 VPATH := $(VPATH):$(ROOT)/make/mcu
156 VPATH := $(VPATH):$(ROOT)/make
158 # start specific includes
159 include $(ROOT)/make/mcu/$(TARGET_MCU).mk
161 # openocd specific includes
162 include $(ROOT)/make/openocd.mk
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
173 DEVICE_FLAGS := $(DEVICE_FLAGS) -DFLASH_SIZE=$(FLASH_SIZE)
175 ifneq ($(HSE_VALUE),)
176 DEVICE_FLAGS := $(DEVICE_FLAGS) -DHSE_VALUE=$(HSE_VALUE)
177 endif
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
185 TARGET_DIR = $(ROOT)/src/main/target/$(BASE_TARGET)
186 TARGET_DIR_SRC = $(notdir $(wildcard $(TARGET_DIR)/*.c))
188 ifeq ($(OPBL),yes)
189 TARGET_FLAGS := -DOPBL $(TARGET_FLAGS)
190 .DEFAULT_GOAL := binary
191 else
192 .DEFAULT_GOAL := hex
193 endif
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
200 INCLUDE_DIRS := $(INCLUDE_DIRS) \
201 $(ROOT)/lib/main/MAVLink
203 INCLUDE_DIRS := $(INCLUDE_DIRS) \
204 $(TARGET_DIR)
206 VPATH := $(VPATH):$(TARGET_DIR)
208 include $(ROOT)/make/source.mk
210 ###############################################################################
211 # Things that might need changing to use different tools
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
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
231 # Tool options.
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 :=
240 # Added after GCC version update, remove once the warnings have been fixed
242 TEMPORARY_FLAGS :=
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)
267 ASFLAGS = $(ARCH_FLAGS) \
268 $(DEBUG_FLAGS) \
269 -x assembler-with-cpp \
270 $(addprefix -I,$(INCLUDE_DIRS)) \
271 -MMD -MP
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
292 ###############################################################################
293 # No user-serviceable parts below
294 ###############################################################################
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
302 # Things we will build
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_ZIP = $(BIN_DIR)/$(FORKNAME)_$(FC_VER)_$(TARGET).zip
309 TARGET_ELF = $(OBJECT_DIR)/$(FORKNAME)_$(TARGET).elf
310 TARGET_EXST_ELF = $(OBJECT_DIR)/$(FORKNAME)_$(TARGET)_EXST.elf
311 TARGET_UNPATCHED_BIN = $(OBJECT_DIR)/$(FORKNAME)_$(TARGET)_UNPATCHED.bin
312 TARGET_LST = $(OBJECT_DIR)/$(FORKNAME)_$(TARGET).lst
313 TARGET_OBJS = $(addsuffix .o,$(addprefix $(OBJECT_DIR)/$(TARGET)/,$(basename $(SRC))))
314 TARGET_DEPS = $(addsuffix .d,$(addprefix $(OBJECT_DIR)/$(TARGET)/,$(basename $(SRC))))
315 TARGET_MAP = $(OBJECT_DIR)/$(FORKNAME)_$(TARGET).map
317 TARGET_EXST_HASH_SECTION_FILE = $(OBJECT_DIR)/$(TARGET)/exst_hash_section.bin
319 CLEAN_ARTIFACTS := $(TARGET_BIN)
320 CLEAN_ARTIFACTS += $(TARGET_HEX)
321 CLEAN_ARTIFACTS += $(TARGET_ELF) $(TARGET_OBJS) $(TARGET_MAP)
322 CLEAN_ARTIFACTS += $(TARGET_LST)
323 CLEAN_ARTIFACTS += $(TARGET_DFU)
325 # Make sure build date and revision is updated on every incremental build
326 $(OBJECT_DIR)/$(TARGET)/build/version.o : $(SRC)
328 # List of buildable ELF files and their object dependencies.
329 # It would be nice to compute these lists, but that seems to be just beyond make.
331 $(TARGET_LST): $(TARGET_ELF)
332 $(V0) $(OBJDUMP) -S --disassemble $< > $@
335 $(TARGET_S19): $(TARGET_ELF)
336 @echo "Creating srec/S19 $(TARGET_S19)" "$(STDOUT)"
337 $(V1) $(OBJCOPY) --output-target=srec $(TARGET_S19)
339 ifeq ($(EXST),no)
340 $(TARGET_BIN): $(TARGET_ELF)
341 @echo "Creating BIN $(TARGET_BIN)" "$(STDOUT)"
342 $(V1) $(OBJCOPY) -O binary $< $@
344 $(TARGET_HEX): $(TARGET_ELF)
345 @echo "Creating HEX $(TARGET_HEX)" "$(STDOUT)"
346 $(V1) $(OBJCOPY) -O ihex --set-start 0x8000000 $< $@
348 $(TARGET_DFU): $(TARGET_HEX)
349 @echo "Creating DFU $(TARGET_DFU)" "$(STDOUT)"
350 $(V1) $(DFUSE-PACK) -i $< $@
352 else
353 CLEAN_ARTIFACTS += $(TARGET_UNPATCHED_BIN) $(TARGET_EXST_HASH_SECTION_FILE) $(TARGET_EXST_ELF)
355 $(TARGET_UNPATCHED_BIN): $(TARGET_ELF)
356 @echo "Creating BIN (without checksum) $(TARGET_UNPATCHED_BIN)" "$(STDOUT)"
357 $(V1) $(OBJCOPY) -O binary $< $@
359 $(TARGET_BIN): $(TARGET_UNPATCHED_BIN)
360 @echo "Creating EXST $(TARGET_BIN)" "$(STDOUT)"
361 # Linker script should allow .bin generation from a .elf which results in a file that is the same length as the FIRMWARE_SIZE.
362 # These 'dd' commands will pad a short binary to length FIRMWARE_SIZE.
363 $(V1) dd if=/dev/zero ibs=1k count=$(FIRMWARE_SIZE) of=$(TARGET_BIN)
364 $(V1) dd if=$(TARGET_UNPATCHED_BIN) of=$(TARGET_BIN) conv=notrunc
366 @echo "Generating MD5 hash of binary" "$(STDOUT)"
367 $(V1) openssl dgst -md5 $(TARGET_BIN) > $(TARGET_UNPATCHED_BIN).md5
369 @echo "Patching MD5 hash into binary" "$(STDOUT)"
370 $(V1) cat $(TARGET_UNPATCHED_BIN).md5 | awk '{printf("%08x: %s",(1024*$(FIRMWARE_SIZE))-16,$$2);}' | xxd -r - $(TARGET_BIN)
371 $(V1) echo $(FIRMWARE_SIZE) | awk '{printf("-s 0x%08x -l 16 -c 16 %s",(1024*$$1)-16,"$(TARGET_BIN)");}' | xargs xxd
373 # 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"
374 # Due to this a temporary file must be created and removed, even though we're only extracting data from the input file.
375 # If this temporary file is NOT used the $(TARGET_ELF) is modified, and running make a second time will result in
376 # a) regeneration of $(TARGET_BIN), and
377 # b) the results of $(TARGET_BIN) will not be as expected.
378 @echo "Extracting HASH section from unpatched EXST elf $(TARGET_ELF)" "$(STDOUT)"
379 $(OBJCOPY) $(TARGET_ELF) $(TARGET_EXST_ELF).tmp --dump-section .exst_hash=$(TARGET_EXST_HASH_SECTION_FILE)
380 rm $(TARGET_EXST_ELF).tmp
382 @echo "Patching MD5 hash into HASH section" "$(STDOUT)"
383 $(V1) cat $(TARGET_UNPATCHED_BIN).md5 | awk '{printf("%08x: %s",64-16,$$2);}' | xxd -r - $(TARGET_EXST_HASH_SECTION_FILE)
385 @echo "Patching updated HASH section into $(TARGET_EXST_ELF)" "$(STDOUT)"
386 $(OBJCOPY) $(TARGET_ELF) $(TARGET_EXST_ELF) --update-section .exst_hash=$(TARGET_EXST_HASH_SECTION_FILE)
388 $(TARGET_HEX): $(TARGET_BIN)
389 $(if $(EXST_ADJUST_VMA),,$(error "EXST_ADJUST_VMA not specified"))
391 @echo "Creating EXST HEX from patched EXST BIN $(TARGET_BIN), VMA Adjust $(EXST_ADJUST_VMA)" "$(STDOUT)"
392 $(V1) $(OBJCOPY) -I binary -O ihex --adjust-vma=$(EXST_ADJUST_VMA) $(TARGET_BIN) $@
394 endif
396 $(TARGET_ELF): $(TARGET_OBJS) $(LD_SCRIPT)
397 @echo "Linking $(TARGET)" "$(STDOUT)"
398 $(V1) $(CROSS_CC) -o $@ $(filter-out %.ld,$^) $(LD_FLAGS)
399 $(V1) $(SIZE) $(TARGET_ELF)
401 # Compile
403 ## compile_file takes two arguments: (1) optimisation description string and (2) optimisation compiler flag
404 define compile_file
405 echo "%% ($(1)) $<" "$(STDOUT)" && \
406 $(CROSS_CC) -c -o $@ $(CFLAGS) $(2) $<
407 endef
409 ifeq ($(DEBUG),GDB)
410 $(OBJECT_DIR)/$(TARGET)/%.o: %.c
411 $(V1) mkdir -p $(dir $@)
412 $(V1) $(if $(findstring $<,$(NOT_OPTIMISED_SRC)), \
413 $(call compile_file,not optimised, $(CC_NO_OPTIMISATION)) \
415 $(call compile_file,debug,$(CC_DEBUG_OPTIMISATION)) \
417 else
418 $(OBJECT_DIR)/$(TARGET)/%.o: %.c
419 $(V1) mkdir -p $(dir $@)
420 $(V1) $(if $(findstring $<,$(NOT_OPTIMISED_SRC)), \
421 $(call compile_file,not optimised,$(CC_NO_OPTIMISATION)) \
423 $(if $(findstring $(subst ./src/main/,,$<),$(SPEED_OPTIMISED_SRC)), \
424 $(call compile_file,speed optimised,$(CC_SPEED_OPTIMISATION)) \
426 $(if $(findstring $(subst ./src/main/,,$<),$(SIZE_OPTIMISED_SRC)), \
427 $(call compile_file,size optimised,$(CC_SIZE_OPTIMISATION)) \
429 $(call compile_file,optimised,$(CC_DEFAULT_OPTIMISATION)) \
433 endif
435 # Assemble
436 $(OBJECT_DIR)/$(TARGET)/%.o: %.s
437 $(V1) mkdir -p $(dir $@)
438 @echo "%% $(notdir $<)" "$(STDOUT)"
439 $(V1) $(CROSS_CC) -c -o $@ $(ASFLAGS) $<
441 $(OBJECT_DIR)/$(TARGET)/%.o: %.S
442 $(V1) mkdir -p $(dir $@)
443 @echo "%% $(notdir $<)" "$(STDOUT)"
444 $(V1) $(CROSS_CC) -c -o $@ $(ASFLAGS) $<
447 ## all : Build all currently built targets
448 all: $(CI_TARGETS)
450 ## all_all : Build all targets (including legacy / unsupported)
451 all_all: $(VALID_TARGETS)
453 ## unified : build all Unified Targets
454 unified: $(UNIFIED_TARGETS)
456 ## unified_zip : build all Unified Targets as zip files (for posting on GitHub)
457 unified_zip: $(addsuffix _zip,$(UNIFIED_TARGETS))
459 ## legacy : Build legacy targets
460 legacy: $(LEGACY_TARGETS)
462 ## unsupported : Build unsupported targets
463 unsupported: $(UNSUPPORTED_TARGETS)
465 ## pre-push : The minimum verification that should be run before pushing, to check if CI has a chance of succeeding
466 pre-push:
467 $(MAKE) $(addsuffix _clean,$(PRE_PUSH_TARGET_LIST)) $(PRE_PUSH_TARGET_LIST) EXTRA_FLAGS=-Werror
469 ## targets-group-1 : build some targets
470 targets-group-1: $(GROUP_1_TARGETS)
472 ## targets-group-2 : build some targets
473 targets-group-2: $(GROUP_2_TARGETS)
475 ## targets-group-3 : build some targets
476 targets-group-3: $(GROUP_3_TARGETS)
478 ## targets-group-4 : build some targets
479 targets-group-4: $(GROUP_4_TARGETS)
481 ## targets-group-5 : build some targets
482 targets-group-5: $(GROUP_5_TARGETS)
484 ## targets-group-rest: build the rest of the targets (not listed in group 1, 2 or 3)
485 targets-group-rest: $(GROUP_OTHER_TARGETS)
487 $(VALID_TARGETS):
488 $(V0) @echo "Building $@" && \
489 $(MAKE) binary hex TARGET=$@ && \
490 echo "Building $@ succeeded."
492 $(NOBUILD_TARGETS):
493 $(MAKE) TARGET=$@
495 TARGETS_CLEAN = $(addsuffix _clean,$(VALID_TARGETS))
497 ## clean : clean up temporary / machine-generated files
498 clean:
499 @echo "Cleaning $(TARGET)"
500 $(V0) rm -f $(CLEAN_ARTIFACTS)
501 $(V0) rm -rf $(OBJECT_DIR)/$(TARGET)
502 @echo "Cleaning $(TARGET) succeeded."
504 ## test_clean : clean up temporary / machine-generated files (tests)
505 test-%_clean:
506 $(MAKE) test_clean
508 test_clean:
509 $(V0) cd src/test && $(MAKE) clean || true
511 ## <TARGET>_clean : clean up one specific target (alias for above)
512 $(TARGETS_CLEAN):
513 $(V0) $(MAKE) -j TARGET=$(subst _clean,,$@) clean
515 ## clean_all : clean all valid targets
516 clean_all: $(TARGETS_CLEAN) test_clean
518 TARGETS_FLASH = $(addsuffix _flash,$(VALID_TARGETS))
520 ## <TARGET>_flash : build and flash a target
521 $(TARGETS_FLASH):
522 $(V0) $(MAKE) hex TARGET=$(subst _flash,,$@)
523 ifneq (,$(findstring /dev/ttyUSB,$(SERIAL_DEVICE)))
524 $(V0) $(MAKE) tty_flash TARGET=$(subst _flash,,$@)
525 else
526 $(V0) $(MAKE) dfu_flash TARGET=$(subst _flash,,$@)
527 endif
529 ## tty_flash : flash firmware (.hex) onto flight controller via a serial port
530 tty_flash:
531 $(V0) stty -F $(SERIAL_DEVICE) raw speed 115200 -crtscts cs8 -parenb -cstopb -ixon
532 $(V0) echo -n 'R' > $(SERIAL_DEVICE)
533 $(V0) stm32flash -w $(TARGET_HEX) -v -g 0x0 -b 115200 $(SERIAL_DEVICE)
535 ## dfu_flash : flash firmware (.bin) onto flight controller via a DFU mode
536 dfu_flash:
537 ifneq (no-port-found,$(SERIAL_DEVICE))
538 # potentially this is because the MCU already is in DFU mode, try anyway
539 $(V0) echo -n 'R' > $(SERIAL_DEVICE)
540 $(V0) sleep 1
541 endif
542 $(V0) $(MAKE) $(TARGET_DFU)
543 $(V0) dfu-util -a 0 -D $(TARGET_DFU) -s :leave
545 st-flash_$(TARGET): $(TARGET_BIN)
546 $(V0) st-flash --reset write $< 0x08000000
548 ## st-flash : flash firmware (.bin) onto flight controller
549 st-flash: st-flash_$(TARGET)
551 ifneq ($(OPENOCD_COMMAND),)
552 openocd-gdb: $(TARGET_ELF)
553 $(V0) $(OPENOCD_COMMAND) & $(CROSS_GDB) $(TARGET_ELF) -ex "target remote localhost:3333" -ex "load"
554 endif
556 TARGETS_ZIP = $(addsuffix _zip,$(VALID_TARGETS))
558 ## <TARGET>_zip : build target and zip it (useful for posting to GitHub)
559 $(TARGETS_ZIP):
560 $(V0) $(MAKE) hex TARGET=$(subst _zip,,$@)
561 $(V0) $(MAKE) zip TARGET=$(subst _zip,,$@)
563 zip:
564 $(V0) zip $(TARGET_ZIP) $(TARGET_HEX)
566 binary:
567 $(V0) $(MAKE) -j $(TARGET_BIN)
569 srec:
570 $(V0) $(MAKE) -j $(TARGET_S19)
572 hex:
573 $(V0) $(MAKE) -j $(TARGET_HEX)
575 unbrick_$(TARGET): $(TARGET_HEX)
576 $(V0) stty -F $(SERIAL_DEVICE) raw speed 115200 -crtscts cs8 -parenb -cstopb -ixon
577 $(V0) stm32flash -w $(TARGET_HEX) -v -g 0x0 -b 115200 $(SERIAL_DEVICE)
579 ## unbrick : unbrick flight controller
580 unbrick: unbrick_$(TARGET)
582 ## cppcheck : run static analysis on C source code
583 cppcheck: $(CSOURCES)
584 $(V0) $(CPPCHECK)
586 cppcheck-result.xml: $(CSOURCES)
587 $(V0) $(CPPCHECK) --xml-version=2 2> cppcheck-result.xml
589 # mkdirs
590 $(DL_DIR):
591 mkdir -p $@
593 $(TOOLS_DIR):
594 mkdir -p $@
596 $(BUILD_DIR):
597 mkdir -p $@
599 ## version : print firmware version
600 version:
601 @echo $(FC_VER)
603 ## help : print this help message and exit
604 help: Makefile make/tools.mk
605 @echo ""
606 @echo "Makefile for the $(FORKNAME) firmware"
607 @echo ""
608 @echo "Usage:"
609 @echo " make [V=<verbosity>] [TARGET=<target>] [OPTIONS=\"<options>\"]"
610 @echo "Or:"
611 @echo " make <target> [V=<verbosity>] [OPTIONS=\"<options>\"]"
612 @echo ""
613 @echo "Valid TARGET values are: $(VALID_TARGETS)"
614 @echo ""
615 @sed -n 's/^## //p' $?
617 ## targets : print a list of all valid target platforms (for consumption by scripts)
618 targets:
619 @echo "Valid targets: $(VALID_TARGETS)"
620 @echo "Built targets: $(CI_TARGETS)"
621 @echo "Unified targets: $(UNIFIED_TARGETS)"
622 @echo "Legacy targets: $(LEGACY_TARGETS)"
623 @echo "Unsupported targets: $(UNSUPPORTED_TARGETS)"
624 @echo "Target: $(TARGET)"
625 @echo "Base target: $(BASE_TARGET)"
626 @echo "targets-group-1: $(GROUP_1_TARGETS)"
627 @echo "targets-group-2: $(GROUP_2_TARGETS)"
628 @echo "targets-group-3: $(GROUP_3_TARGETS)"
629 @echo "targets-group-4: $(GROUP_4_TARGETS)"
630 @echo "targets-group-5: $(GROUP_5_TARGETS)"
631 @echo "targets-group-rest: $(GROUP_OTHER_TARGETS)"
633 @echo "targets-group-1: $(words $(GROUP_1_TARGETS)) targets"
634 @echo "targets-group-2: $(words $(GROUP_2_TARGETS)) targets"
635 @echo "targets-group-3: $(words $(GROUP_3_TARGETS)) targets"
636 @echo "targets-group-4: $(words $(GROUP_4_TARGETS)) targets"
637 @echo "targets-group-5: $(words $(GROUP_5_TARGETS)) targets"
638 @echo "targets-group-rest: $(words $(GROUP_OTHER_TARGETS)) targets"
639 @echo "total in all groups $(words $(CI_TARGETS)) targets"
641 ## target-mcu : print the MCU type of the target
642 target-mcu:
643 @echo $(TARGET_MCU)
645 ## targets-by-mcu : make all targets that have a MCU_TYPE mcu
646 targets-by-mcu:
647 $(V1) for target in $${TARGETS}; do \
648 TARGET_MCU_TYPE=$$($(MAKE) -s TARGET=$${target} target-mcu); \
649 if [ "$${TARGET_MCU_TYPE}" = "$${MCU_TYPE}" ]; then \
650 if [ "$${DO_BUILD}" = 1 ]; then \
651 echo "Building target $${target}..."; \
652 $(MAKE) TARGET=$${target}; \
653 if [ $$? -ne 0 ]; then \
654 echo "Building target $${target} failed, aborting."; \
655 exit 1; \
656 fi; \
657 else \
658 echo -n "$${target} "; \
659 fi; \
660 fi; \
661 done
662 @echo
664 ## targets-f3 : make all F3 targets
665 targets-f3:
666 $(V1) $(MAKE) -s targets-by-mcu MCU_TYPE=STM32F3 TARGETS="$(VALID_TARGETS)" DO_BUILD=1
668 targets-f3-print:
669 $(V1) $(MAKE) -s targets-by-mcu MCU_TYPE=STM32F3 TARGETS="$(VALID_TARGETS)"
671 ## targets-f4 : make all F4 targets
672 targets-f4:
673 $(V1) $(MAKE) -s targets-by-mcu MCU_TYPE=STM32F4 TARGETS="$(VALID_TARGETS)" DO_BUILD=1
675 targets-f4-print:
676 $(V1) $(MAKE) -s targets-by-mcu MCU_TYPE=STM32F4 TARGETS="$(VALID_TARGETS)"
678 targets-ci-f4-print:
679 $(V1) $(MAKE) -s targets-by-mcu MCU_TYPE=STM32F4 TARGETS="$(CI_TARGETS)"
681 ## targets-f7 : make all F7 targets
682 targets-f7:
683 $(V1) $(MAKE) -s targets-by-mcu MCU_TYPE=STM32F7 TARGETS="$(VALID_TARGETS)" DO_BUILD=1
685 targets-f7-print:
686 $(V1) $(MAKE) -s targets-by-mcu MCU_TYPE=STM32F7 TARGETS="$(VALID_TARGETS)"
688 targets-ci-f7-print:
689 $(V1) $(MAKE) -s targets-by-mcu MCU_TYPE=STM32F7 TARGETS="$(CI_TARGETS)"
691 ## test : run the Betaflight test suite
692 ## junittest : run the Betaflight test suite, producing Junit XML result files.
693 ## 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)
694 ## test-all: run the Betaflight test suite including all per-target expanded tests
695 test junittest test-all test-representative:
696 $(V0) cd src/test && $(MAKE) $@
698 ## test_help : print the help message for the test suite (including a list of the available tests)
699 test_help:
700 $(V0) cd src/test && $(MAKE) help
702 ## test_% : run test 'test_%' from the test suite
703 test_%:
704 $(V0) cd src/test && $(MAKE) $@
707 # rebuild everything when makefile changes
708 $(TARGET_OBJS): Makefile $(TARGET_DIR)/target.mk $(wildcard make/*)
710 # include auto-generated dependencies
711 -include $(TARGET_DEPS)