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    ?= NAZE
  20
  21 # Compile-time options
  22 OPTIONS   ?=
  23
  24 # compile for OpenPilot BootLoader support
  25 OPBL      ?= no
  26
  27 # Debugger optons, must be empty or GDB
  28 DEBUG     ?=
  29
  30 # Insert the debugging hardfault debugger
  31 # releases should not be built with this flag as it does not disable pwm output
  32 DEBUG_HARDFAULTS ?=
  33
  34 # Serial port/Device for flashing
  35 SERIAL_DEVICE   ?= $(firstword $(wildcard /dev/ttyUSB*) no-port-found)
  36
  37 # Flash size (KB).  Some low-end chips actually have more flash than advertised, use this to override.
  38 FLASH_SIZE ?=
  39
  40
  41 ###############################################################################
  42 # Things that need to be maintained as the source changes
  43 #
  44
  45 FORKNAME      = betaflight
  46
  47 # Working directories
  48 ROOT            := $(patsubst %/,%,$(dir $(lastword $(MAKEFILE_LIST))))
  49 SRC_DIR         := $(ROOT)/src/main
  50 OBJECT_DIR      := $(ROOT)/obj/main
  51 BIN_DIR         := $(ROOT)/obj
  52 CMSIS_DIR       := $(ROOT)/lib/main/CMSIS
  53 INCLUDE_DIRS    := $(SRC_DIR) \
  54                    $(ROOT)/src/main/target
  55 LINKER_DIR      := $(ROOT)/src/main/target/link
  56
  57 ## V                 : Set verbosity level based on the V= parameter
  58 ##                     V=0 Low
  59 ##                     V=1 High
  60 include $(ROOT)/make/build_verbosity.mk
  61
  62 # Build tools, so we all share the same versions
  63 # import macros common to all supported build systems
  64 include $(ROOT)/make/system-id.mk
  65
  66 # developer preferences, edit these at will, they'll be gitignored
  67 -include $(ROOT)/make/local.mk
  68
  69 # configure some directories that are relative to wherever ROOT_DIR is located
  70 ifndef TOOLS_DIR
  71 TOOLS_DIR := $(ROOT)/tools
  72 endif
  73 BUILD_DIR := $(ROOT)/build
  74 DL_DIR    := $(ROOT)/downloads
  75
  76 export RM := rm
  77
  78 # import macros that are OS specific
  79 include $(ROOT)/make/$(OSFAMILY).mk
  80
  81 # include the tools makefile
  82 include $(ROOT)/make/tools.mk
  83
  84 # default xtal value for F4 targets
  85 HSE_VALUE       ?= 8000000
  86
  87 # used for turning on features like VCP and SDCARD
  88 FEATURES        =
  89
  90 include $(ROOT)/make/targets.mk
  91
  92 REVISION := $(shell git log -1 --format="%h")
  93
  94 FC_VER_MAJOR := $(shell grep " FC_VERSION_MAJOR" src/main/build/version.h | awk '{print $$3}' )
  95 FC_VER_MINOR := $(shell grep " FC_VERSION_MINOR" src/main/build/version.h | awk '{print $$3}' )
  96 FC_VER_PATCH := $(shell grep " FC_VERSION_PATCH" src/main/build/version.h | awk '{print $$3}' )
  97
  98 FC_VER := $(FC_VER_MAJOR).$(FC_VER_MINOR).$(FC_VER_PATCH)
  99
 100 # Search path for sources
 101 VPATH           := $(SRC_DIR):$(SRC_DIR)/startup
 102 USBFS_DIR       = $(ROOT)/lib/main/STM32_USB-FS-Device_Driver
 103 USBPERIPH_SRC   = $(notdir $(wildcard $(USBFS_DIR)/src/*.c))
 104 FATFS_DIR       = $(ROOT)/lib/main/FatFS
 105 FATFS_SRC       = $(notdir $(wildcard $(FATFS_DIR)/*.c))
 106
 107 CSOURCES        := $(shell find $(SRC_DIR) -name '*.c')
 108
 109 LD_FLAGS         :=
 110
 111 #
 112 # Default Tool options - can be overridden in {mcu}.mk files.
 113 #
 114 ifeq ($(DEBUG),GDB)
 115 OPTIMISE_DEFAULT      := -Og
 116
 117 LTO_FLAGS             := $(OPTIMISE_DEFAULT)
 118 DEBUG_FLAGS            = -ggdb3 -DDEBUG
 119 else
 120 OPTIMISATION_BASE     := -flto -fuse-linker-plugin -ffast-math
 121 OPTIMISE_DEFAULT      := -O2
 122 OPTIMISE_SPEED        := -Ofast
 123 OPTIMISE_SIZE         := -Os
 124
 125 LTO_FLAGS             := $(OPTIMISATION_BASE) $(OPTIMISE_SPEED)
 126 endif
 127
 128 VPATH                   := $(VPATH):$(ROOT)/make/mcu
 129 VPATH                   := $(VPATH):$(ROOT)/make
 130
 131 # start specific includes
 132 include $(ROOT)/make/mcu/$(TARGET_MCU).mk
 133
 134 # openocd specific includes
 135 include $(ROOT)/make/openocd.mk
 136
 137 # Configure default flash sizes for the targets (largest size specified gets hit first) if flash not specified already.
 138 ifeq ($(FLASH_SIZE),)
 139 ifneq ($(TARGET_FLASH),)
 140 FLASH_SIZE := $(TARGET_FLASH)
 141 else
 142 $(error FLASH_SIZE not configured for target $(TARGET))
 143 endif
 144 endif
 145
 146 DEVICE_FLAGS  := $(DEVICE_FLAGS) -DFLASH_SIZE=$(FLASH_SIZE)
 147
 148 ifneq ($(HSE_VALUE),)
 149 DEVICE_FLAGS  := $(DEVICE_FLAGS) -DHSE_VALUE=$(HSE_VALUE)
 150 endif
 151
 152 TARGET_DIR     = $(ROOT)/src/main/target/$(BASE_TARGET)
 153 TARGET_DIR_SRC = $(notdir $(wildcard $(TARGET_DIR)/*.c))
 154
 155 ifeq ($(OPBL),yes)
 156 TARGET_FLAGS := -DOPBL $(TARGET_FLAGS)
 157 .DEFAULT_GOAL := binary
 158 else
 159 .DEFAULT_GOAL := hex
 160 endif
 161
 162 INCLUDE_DIRS    := $(INCLUDE_DIRS) \
 163                    $(ROOT)/lib/main/MAVLink
 164
 165 INCLUDE_DIRS    := $(INCLUDE_DIRS) \
 166                    $(TARGET_DIR)
 167
 168 VPATH           := $(VPATH):$(TARGET_DIR)
 169
 170 include $(ROOT)/make/source.mk
 171
 172 ###############################################################################
 173 # Things that might need changing to use different tools
 174 #
 175
 176 # Find out if ccache is installed on the system
 177 CCACHE := ccache
 178 RESULT = $(shell (which $(CCACHE) > /dev/null 2>&1; echo $$?) )
 179 ifneq ($(RESULT),0)
 180 CCACHE :=
 181 endif
 182
 183 # Tool names
 184 CROSS_CC    := $(CCACHE) $(ARM_SDK_PREFIX)gcc
 185 CROSS_CXX   := $(CCACHE) $(ARM_SDK_PREFIX)g++
 186 CROSS_GDB   := $(ARM_SDK_PREFIX)gdb
 187 OBJCOPY     := $(ARM_SDK_PREFIX)objcopy
 188 OBJDUMP     := $(ARM_SDK_PREFIX)objdump
 189 SIZE        := $(ARM_SDK_PREFIX)size
 190
 191 #
 192 # Tool options.
 193 #
 194 CC_DEBUG_OPTIMISATION   := $(OPTIMISE_DEFAULT)
 195 CC_DEFAULT_OPTIMISATION := $(OPTIMISATION_BASE) $(OPTIMISE_DEFAULT)
 196 CC_SPEED_OPTIMISATION   := $(OPTIMISATION_BASE) $(OPTIMISE_SPEED)
 197 CC_SIZE_OPTIMISATION    := $(OPTIMISATION_BASE) $(OPTIMISE_SIZE)
 198
 199 CFLAGS     += $(ARCH_FLAGS) \
 200               $(addprefix -D,$(OPTIONS)) \
 201               $(addprefix -I,$(INCLUDE_DIRS)) \
 202               $(DEBUG_FLAGS) \
 203               -std=gnu99 \
 204               -Wall -Wextra -Wunsafe-loop-optimizations -Wdouble-promotion \
 205               -ffunction-sections \
 206               -fdata-sections \
 207               -pedantic \
 208               $(DEVICE_FLAGS) \
 209               -DUSE_STDPERIPH_DRIVER \
 210               -D$(TARGET) \
 211               $(TARGET_FLAGS) \
 212               -D'__FORKNAME__="$(FORKNAME)"' \
 213               -D'__TARGET__="$(TARGET)"' \
 214               -D'__REVISION__="$(REVISION)"' \
 215               -save-temps=obj \
 216               -MMD -MP \
 217               $(EXTRA_FLAGS)
 218
 219 ASFLAGS     = $(ARCH_FLAGS) \
 220               -x assembler-with-cpp \
 221               $(addprefix -I,$(INCLUDE_DIRS)) \
 222               -MMD -MP
 223
 224 ifeq ($(LD_FLAGS),)
 225 LD_FLAGS     = -lm \
 226               -nostartfiles \
 227               --specs=nano.specs \
 228               -lc \
 229               -lnosys \
 230               $(ARCH_FLAGS) \
 231               $(LTO_FLAGS) \
 232               $(DEBUG_FLAGS) \
 233               -static \
 234               -Wl,-gc-sections,-Map,$(TARGET_MAP) \
 235               -Wl,-L$(LINKER_DIR) \
 236               -Wl,--cref \
 237               -Wl,--no-wchar-size-warning \
 238               -T$(LD_SCRIPT)
 239 endif
 240
 241 ###############################################################################
 242 # No user-serviceable parts below
 243 ###############################################################################
 244
 245 CPPCHECK        = cppcheck $(CSOURCES) --enable=all --platform=unix64 \
 246                   --std=c99 --inline-suppr --quiet --force \
 247                   $(addprefix -I,$(INCLUDE_DIRS)) \
 248                   -I/usr/include -I/usr/include/linux
 249
 250 #
 251 # Things we will build
 252 #
 253 TARGET_BIN      = $(BIN_DIR)/$(FORKNAME)_$(FC_VER)_$(TARGET).bin
 254 TARGET_HEX      = $(BIN_DIR)/$(FORKNAME)_$(FC_VER)_$(TARGET).hex
 255 TARGET_ELF      = $(OBJECT_DIR)/$(FORKNAME)_$(TARGET).elf
 256 TARGET_LST      = $(OBJECT_DIR)/$(FORKNAME)_$(TARGET).lst
 257 TARGET_OBJS     = $(addsuffix .o,$(addprefix $(OBJECT_DIR)/$(TARGET)/,$(basename $(SRC))))
 258 TARGET_DEPS     = $(addsuffix .d,$(addprefix $(OBJECT_DIR)/$(TARGET)/,$(basename $(SRC))))
 259 TARGET_MAP      = $(OBJECT_DIR)/$(FORKNAME)_$(TARGET).map
 260
 261
 262 CLEAN_ARTIFACTS := $(TARGET_BIN)
 263 CLEAN_ARTIFACTS += $(TARGET_HEX)
 264 CLEAN_ARTIFACTS += $(TARGET_ELF) $(TARGET_OBJS) $(TARGET_MAP)
 265 CLEAN_ARTIFACTS += $(TARGET_LST)
 266
 267 # Make sure build date and revision is updated on every incremental build
 268 $(OBJECT_DIR)/$(TARGET)/build/version.o : $(SRC)
 269
 270 # List of buildable ELF files and their object dependencies.
 271 # It would be nice to compute these lists, but that seems to be just beyond make.
 272
 273 $(TARGET_LST): $(TARGET_ELF)
 274         $(V0) $(OBJDUMP) -S --disassemble $< > $@
 275
 276 $(TARGET_HEX): $(TARGET_ELF)
 277         $(V0) $(OBJCOPY) -O ihex --set-start 0x8000000 $< $@
 278
 279 $(TARGET_BIN): $(TARGET_ELF)
 280         $(V0) $(OBJCOPY) -O binary $< $@
 281
 282 $(TARGET_ELF):  $(TARGET_OBJS)
 283         $(V1) echo Linking $(TARGET)
 284         $(V1) $(CROSS_CC) -o $@ $^ $(LD_FLAGS)
 285         $(V0) $(SIZE) $(TARGET_ELF)
 286
 287 # Compile
 288 ifeq ($(DEBUG),GDB)
 289 $(OBJECT_DIR)/$(TARGET)/%.o: %.c
 290         $(V1) mkdir -p $(dir $@)
 291         $(V1) echo "%% (debug) $(notdir $<)" "$(STDOUT)" && \
 292         $(CROSS_CC) -c -o $@ $(CFLAGS) $(CC_DEBUG_OPTIMISATION) $<
 293 else
 294 $(OBJECT_DIR)/$(TARGET)/%.o: %.c
 295         $(V1) mkdir -p $(dir $@)
 296         $(V1) $(if $(findstring $(subst ./src/main/,,$<),$(SPEED_OPTIMISED_SRC)), \
 297         echo "%% (speed optimised) $(notdir $<)" "$(STDOUT)" && \
 298         $(CROSS_CC) -c -o $@ $(CFLAGS) $(CC_SPEED_OPTIMISATION) $<, \
 299         $(if $(findstring $(subst ./src/main/,,$<),$(SIZE_OPTIMISED_SRC)), \
 300         echo "%% (size optimised) $(notdir $<)" "$(STDOUT)" && \
 301         $(CROSS_CC) -c -o $@ $(CFLAGS) $(CC_SIZE_OPTIMISATION) $<, \
 302         echo "%% $(notdir $<)" "$(STDOUT)" && \
 303         $(CROSS_CC) -c -o $@ $(CFLAGS) $(CC_DEFAULT_OPTIMISATION) $<))
 304 endif
 305
 306 # Assemble
 307 $(OBJECT_DIR)/$(TARGET)/%.o: %.s
 308         $(V1) mkdir -p $(dir $@)
 309         $(V1) echo "%% $(notdir $<)" "$(STDOUT)"
 310         $(V1) $(CROSS_CC) -c -o $@ $(ASFLAGS) $<
 311
 312 $(OBJECT_DIR)/$(TARGET)/%.o: %.S
 313         $(V1) mkdir -p $(dir $@)
 314         $(V1) echo "%% $(notdir $<)" "$(STDOUT)"
 315         $(V1) $(CROSS_CC) -c -o $@ $(ASFLAGS) $<
 316
 317
 318 ## all               : Build all valid targets
 319 all: $(VALID_TARGETS)
 320
 321 ## official          : Build all official (travis) targets
 322 official: $(OFFICIAL_TARGETS)
 323
 324 ## targets-group-1   : build some targets
 325 targets-group-1: $(GROUP_1_TARGETS)
 326
 327 ## targets-group-2   : build some targets
 328 targets-group-2: $(GROUP_2_TARGETS)
 329
 330 ## targets-group-3   : build some targets
 331 targets-group-3: $(GROUP_3_TARGETS)
 332
 333 ## targets-group-3   : build some targets
 334 targets-group-4: $(GROUP_4_TARGETS)
 335
 336 ## targets-group-rest: build the rest of the targets (not listed in group 1, 2 or 3)
 337 targets-group-rest: $(GROUP_OTHER_TARGETS)
 338
 339 $(VALID_TARGETS):
 340         $(V0) @echo "Building $@" && \
 341         time $(MAKE) binary hex TARGET=$@ && \
 342         echo "Building $@ succeeded."
 343
 344 $(SKIP_TARGETS):
 345         $(MAKE) TARGET=$@
 346
 347 CLEAN_TARGETS = $(addprefix clean_,$(VALID_TARGETS) $(SKIP_TARGETS) )
 348 TARGETS_CLEAN = $(addsuffix _clean,$(VALID_TARGETS) $(SKIP_TARGETS) )
 349
 350 ## clean             : clean up temporary / machine-generated files
 351 clean:
 352         $(V0) @echo "Cleaning $(TARGET)"
 353         $(V0) rm -f $(CLEAN_ARTIFACTS)
 354         $(V0) rm -rf $(OBJECT_DIR)/$(TARGET)
 355         $(V0) @echo "Cleaning $(TARGET) succeeded."
 356
 357 ## clean_test        : clean up temporary / machine-generated files (tests)
 358 clean_test:
 359         $(V0) cd src/test && $(MAKE) clean || true
 360
 361 ## clean_<TARGET>    : clean up one specific target
 362 $(CLEAN_TARGETS):
 363         $(V0) $(MAKE) -j TARGET=$(subst clean_,,$@) clean
 364
 365 ## <TARGET>_clean    : clean up one specific target (alias for above)
 366 $(TARGETS_CLEAN):
 367         $(V0) $(MAKE) -j TARGET=$(subst _clean,,$@) clean
 368
 369 ## clean_all         : clean all valid targets
 370 clean_all: $(CLEAN_TARGETS)
 371
 372 ## all_clean         : clean all valid targets (alias for above)
 373 all_clean: $(TARGETS_CLEAN)
 374
 375
 376 flash_$(TARGET): $(TARGET_HEX)
 377         $(V0) stty -F $(SERIAL_DEVICE) raw speed 115200 -crtscts cs8 -parenb -cstopb -ixon
 378         $(V0) echo -n 'R' >$(SERIAL_DEVICE)
 379         $(V0) stm32flash -w $(TARGET_HEX) -v -g 0x0 -b 115200 $(SERIAL_DEVICE)
 380
 381 ## flash             : flash firmware (.hex) onto flight controller
 382 flash: flash_$(TARGET)
 383
 384 st-flash_$(TARGET): $(TARGET_BIN)
 385         $(V0) st-flash --reset write $< 0x08000000
 386
 387 ## st-flash          : flash firmware (.bin) onto flight controller
 388 st-flash: st-flash_$(TARGET)
 389
 390 ifneq ($(OPENOCD_COMMAND),)
 391 openocd-gdb: $(TARGET_ELF)
 392         $(V0) $(OPENOCD_COMMAND) & $(CROSS_GDB) $(TARGET_ELF) -ex "target remote localhost:3333" -ex "load"
 393 endif
 394
 395 binary:
 396         $(V0) $(MAKE) -j $(TARGET_BIN)
 397
 398 hex:
 399         $(V0) $(MAKE) -j $(TARGET_HEX)
 400
 401 unbrick_$(TARGET): $(TARGET_HEX)
 402         $(V0) stty -F $(SERIAL_DEVICE) raw speed 115200 -crtscts cs8 -parenb -cstopb -ixon
 403         $(V0) stm32flash -w $(TARGET_HEX) -v -g 0x0 -b 115200 $(SERIAL_DEVICE)
 404
 405 ## unbrick           : unbrick flight controller
 406 unbrick: unbrick_$(TARGET)
 407
 408 ## cppcheck          : run static analysis on C source code
 409 cppcheck: $(CSOURCES)
 410         $(V0) $(CPPCHECK)
 411
 412 cppcheck-result.xml: $(CSOURCES)
 413         $(V0) $(CPPCHECK) --xml-version=2 2> cppcheck-result.xml
 414
 415 # mkdirs
 416 $(DL_DIR):
 417         mkdir -p $@
 418
 419 $(TOOLS_DIR):
 420         mkdir -p $@
 421
 422 $(BUILD_DIR):
 423         mkdir -p $@
 424
 425 ## version           : print firmware version
 426 version:
 427         @echo $(FC_VER)
 428
 429 ## help              : print this help message and exit
 430 help: Makefile make/tools.mk
 431         $(V0) @echo ""
 432         $(V0) @echo "Makefile for the $(FORKNAME) firmware"
 433         $(V0) @echo ""
 434         $(V0) @echo "Usage:"
 435         $(V0) @echo "        make [V=<verbosity>] [TARGET=<target>] [OPTIONS=\"<options>\"]"
 436         $(V0) @echo "Or:"
 437         $(V0) @echo "        make <target> [V=<verbosity>] [OPTIONS=\"<options>\"]"
 438         $(V0) @echo ""
 439         $(V0) @echo "Valid TARGET values are: $(VALID_TARGETS)"
 440         $(V0) @echo ""
 441         $(V0) @sed -n 's/^## //p' $?
 442
 443 ## targets           : print a list of all valid target platforms (for consumption by scripts)
 444 targets:
 445         $(V0) @echo "Valid targets:      $(VALID_TARGETS)"
 446         $(V0) @echo "Target:             $(TARGET)"
 447         $(V0) @echo "Base target:        $(BASE_TARGET)"
 448         $(V0) @echo "targets-group-1:    $(GROUP_1_TARGETS)"
 449         $(V0) @echo "targets-group-2:    $(GROUP_2_TARGETS)"
 450         $(V0) @echo "targets-group-3:    $(GROUP_3_TARGETS)"
 451         $(V0) @echo "targets-group-4:    $(GROUP_4_TARGETS)"
 452         $(V0) @echo "targets-group-rest: $(GROUP_OTHER_TARGETS)"
 453
 454 ## test              : run the cleanflight test suite
 455 ## junittest         : run the cleanflight test suite, producing Junit XML result files.
 456 test junittest:
 457         $(V0) cd src/test && $(MAKE) $@
 458
 459 # rebuild everything when makefile changes
 460 $(TARGET_OBJS) : Makefile
 461
 462 # include auto-generated dependencies
 463 -include $(TARGET_DEPS)