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 # Configure default flash sizes for the targets (largest size specified gets hit first) if flash not specified already.
 135 ifeq ($(FLASH_SIZE),)
 136 ifneq ($(TARGET_FLASH),)
 137 FLASH_SIZE := $(TARGET_FLASH)
 138 else
 139 $(error FLASH_SIZE not configured for target $(TARGET))
 140 endif
 141 endif
 142
 143 DEVICE_FLAGS  := $(DEVICE_FLAGS) -DFLASH_SIZE=$(FLASH_SIZE)
 144
 145 ifneq ($(HSE_VALUE),)
 146 DEVICE_FLAGS  := $(DEVICE_FLAGS) -DHSE_VALUE=$(HSE_VALUE)
 147 endif
 148
 149 TARGET_DIR     = $(ROOT)/src/main/target/$(BASE_TARGET)
 150 TARGET_DIR_SRC = $(notdir $(wildcard $(TARGET_DIR)/*.c))
 151
 152 ifeq ($(OPBL),yes)
 153 TARGET_FLAGS := -DOPBL $(TARGET_FLAGS)
 154 .DEFAULT_GOAL := binary
 155 else
 156 .DEFAULT_GOAL := hex
 157 endif
 158
 159 INCLUDE_DIRS    := $(INCLUDE_DIRS) \
 160                    $(ROOT)/lib/main/MAVLink
 161
 162 INCLUDE_DIRS    := $(INCLUDE_DIRS) \
 163                    $(TARGET_DIR)
 164
 165 VPATH           := $(VPATH):$(TARGET_DIR)
 166
 167 include $(ROOT)/make/source.mk
 168
 169 ###############################################################################
 170 # Things that might need changing to use different tools
 171 #
 172
 173 # Find out if ccache is installed on the system
 174 CCACHE := ccache
 175 RESULT = $(shell (which $(CCACHE) > /dev/null 2>&1; echo $$?) )
 176 ifneq ($(RESULT),0)
 177 CCACHE :=
 178 endif
 179
 180 # Tool names
 181 CROSS_CC    := $(CCACHE) $(ARM_SDK_PREFIX)gcc
 182 CROSS_CXX   := $(CCACHE) $(ARM_SDK_PREFIX)g++
 183 OBJCOPY     := $(ARM_SDK_PREFIX)objcopy
 184 OBJDUMP     := $(ARM_SDK_PREFIX)objdump
 185 SIZE        := $(ARM_SDK_PREFIX)size
 186
 187 #
 188 # Tool options.
 189 #
 190 CC_DEBUG_OPTIMISATION   := $(OPTIMISE_DEFAULT)
 191 CC_DEFAULT_OPTIMISATION := $(OPTIMISATION_BASE) $(OPTIMISE_DEFAULT)
 192 CC_SPEED_OPTIMISATION   := $(OPTIMISATION_BASE) $(OPTIMISE_SPEED)
 193 CC_SIZE_OPTIMISATION    := $(OPTIMISATION_BASE) $(OPTIMISE_SIZE)
 194
 195 CFLAGS     += $(ARCH_FLAGS) \
 196               $(addprefix -D,$(OPTIONS)) \
 197               $(addprefix -I,$(INCLUDE_DIRS)) \
 198               $(DEBUG_FLAGS) \
 199               -std=gnu99 \
 200               -Wall -Wextra -Wunsafe-loop-optimizations -Wdouble-promotion \
 201               -ffunction-sections \
 202               -fdata-sections \
 203               -pedantic \
 204               $(DEVICE_FLAGS) \
 205               -DUSE_STDPERIPH_DRIVER \
 206               -D$(TARGET) \
 207               $(TARGET_FLAGS) \
 208               -D'__FORKNAME__="$(FORKNAME)"' \
 209               -D'__TARGET__="$(TARGET)"' \
 210               -D'__REVISION__="$(REVISION)"' \
 211               -save-temps=obj \
 212               -MMD -MP \
 213               $(EXTRA_FLAGS)
 214
 215 ASFLAGS     = $(ARCH_FLAGS) \
 216               -x assembler-with-cpp \
 217               $(addprefix -I,$(INCLUDE_DIRS)) \
 218               -MMD -MP
 219
 220 ifeq ($(LD_FLAGS),)
 221 LD_FLAGS     = -lm \
 222               -nostartfiles \
 223               --specs=nano.specs \
 224               -lc \
 225               -lnosys \
 226               $(ARCH_FLAGS) \
 227               $(LTO_FLAGS) \
 228               $(DEBUG_FLAGS) \
 229               -static \
 230               -Wl,-gc-sections,-Map,$(TARGET_MAP) \
 231               -Wl,-L$(LINKER_DIR) \
 232               -Wl,--cref \
 233               -Wl,--no-wchar-size-warning \
 234               -T$(LD_SCRIPT)
 235 endif
 236
 237 ###############################################################################
 238 # No user-serviceable parts below
 239 ###############################################################################
 240
 241 CPPCHECK        = cppcheck $(CSOURCES) --enable=all --platform=unix64 \
 242                   --std=c99 --inline-suppr --quiet --force \
 243                   $(addprefix -I,$(INCLUDE_DIRS)) \
 244                   -I/usr/include -I/usr/include/linux
 245
 246 #
 247 # Things we will build
 248 #
 249 TARGET_BIN      = $(BIN_DIR)/$(FORKNAME)_$(FC_VER)_$(TARGET).bin
 250 TARGET_HEX      = $(BIN_DIR)/$(FORKNAME)_$(FC_VER)_$(TARGET).hex
 251 TARGET_ELF      = $(OBJECT_DIR)/$(FORKNAME)_$(TARGET).elf
 252 TARGET_LST      = $(OBJECT_DIR)/$(FORKNAME)_$(TARGET).lst
 253 TARGET_OBJS     = $(addsuffix .o,$(addprefix $(OBJECT_DIR)/$(TARGET)/,$(basename $(SRC))))
 254 TARGET_DEPS     = $(addsuffix .d,$(addprefix $(OBJECT_DIR)/$(TARGET)/,$(basename $(SRC))))
 255 TARGET_MAP      = $(OBJECT_DIR)/$(FORKNAME)_$(TARGET).map
 256
 257
 258 CLEAN_ARTIFACTS := $(TARGET_BIN)
 259 CLEAN_ARTIFACTS += $(TARGET_HEX)
 260 CLEAN_ARTIFACTS += $(TARGET_ELF) $(TARGET_OBJS) $(TARGET_MAP)
 261 CLEAN_ARTIFACTS += $(TARGET_LST)
 262
 263 # Make sure build date and revision is updated on every incremental build
 264 $(OBJECT_DIR)/$(TARGET)/build/version.o : $(SRC)
 265
 266 # List of buildable ELF files and their object dependencies.
 267 # It would be nice to compute these lists, but that seems to be just beyond make.
 268
 269 $(TARGET_LST): $(TARGET_ELF)
 270         $(V0) $(OBJDUMP) -S --disassemble $< > $@
 271
 272 $(TARGET_HEX): $(TARGET_ELF)
 273         $(V0) $(OBJCOPY) -O ihex --set-start 0x8000000 $< $@
 274
 275 $(TARGET_BIN): $(TARGET_ELF)
 276         $(V0) $(OBJCOPY) -O binary $< $@
 277
 278 $(TARGET_ELF):  $(TARGET_OBJS)
 279         $(V1) echo Linking $(TARGET)
 280         $(V1) $(CROSS_CC) -o $@ $^ $(LD_FLAGS)
 281         $(V0) $(SIZE) $(TARGET_ELF)
 282
 283 # Compile
 284 ifeq ($(DEBUG),GDB)
 285 $(OBJECT_DIR)/$(TARGET)/%.o: %.c
 286         $(V1) mkdir -p $(dir $@)
 287         $(V1) echo "%% (debug) $(notdir $<)" "$(STDOUT)" && \
 288         $(CROSS_CC) -c -o $@ $(CFLAGS) $(CC_DEBUG_OPTIMISATION) $<
 289 else
 290 $(OBJECT_DIR)/$(TARGET)/%.o: %.c
 291         $(V1) mkdir -p $(dir $@)
 292         $(V1) $(if $(findstring $(subst ./src/main/,,$<),$(SPEED_OPTIMISED_SRC)), \
 293         echo "%% (speed optimised) $(notdir $<)" "$(STDOUT)" && \
 294         $(CROSS_CC) -c -o $@ $(CFLAGS) $(CC_SPEED_OPTIMISATION) $<, \
 295         $(if $(findstring $(subst ./src/main/,,$<),$(SIZE_OPTIMISED_SRC)), \
 296         echo "%% (size optimised) $(notdir $<)" "$(STDOUT)" && \
 297         $(CROSS_CC) -c -o $@ $(CFLAGS) $(CC_SIZE_OPTIMISATION) $<, \
 298         echo "%% $(notdir $<)" "$(STDOUT)" && \
 299         $(CROSS_CC) -c -o $@ $(CFLAGS) $(CC_DEFAULT_OPTIMISATION) $<))
 300 endif
 301
 302 # Assemble
 303 $(OBJECT_DIR)/$(TARGET)/%.o: %.s
 304         $(V1) mkdir -p $(dir $@)
 305         $(V1) echo "%% $(notdir $<)" "$(STDOUT)"
 306         $(V1) $(CROSS_CC) -c -o $@ $(ASFLAGS) $<
 307
 308 $(OBJECT_DIR)/$(TARGET)/%.o: %.S
 309         $(V1) mkdir -p $(dir $@)
 310         $(V1) echo "%% $(notdir $<)" "$(STDOUT)"
 311         $(V1) $(CROSS_CC) -c -o $@ $(ASFLAGS) $<
 312
 313
 314 ## all               : Build all valid targets
 315 all: $(VALID_TARGETS)
 316
 317 ## official          : Build all official (travis) targets
 318 official: $(OFFICIAL_TARGETS)
 319
 320 ## targets-group-1   : build some targets
 321 targets-group-1: $(GROUP_1_TARGETS)
 322
 323 ## targets-group-2   : build some targets
 324 targets-group-2: $(GROUP_2_TARGETS)
 325
 326 ## targets-group-3   : build some targets
 327 targets-group-3: $(GROUP_3_TARGETS)
 328
 329 ## targets-group-3   : build some targets
 330 targets-group-4: $(GROUP_4_TARGETS)
 331
 332 ## targets-group-rest: build the rest of the targets (not listed in group 1, 2 or 3)
 333 targets-group-rest: $(GROUP_OTHER_TARGETS)
 334
 335 $(VALID_TARGETS):
 336         $(V0) @echo "Building $@" && \
 337         time $(MAKE) binary hex TARGET=$@ && \
 338         echo "Building $@ succeeded."
 339
 340 $(SKIP_TARGETS):
 341         $(MAKE) TARGET=$@
 342
 343 CLEAN_TARGETS = $(addprefix clean_,$(VALID_TARGETS) $(SKIP_TARGETS) )
 344 TARGETS_CLEAN = $(addsuffix _clean,$(VALID_TARGETS) $(SKIP_TARGETS) )
 345
 346 ## clean             : clean up temporary / machine-generated files
 347 clean:
 348         $(V0) @echo "Cleaning $(TARGET)"
 349         $(V0) rm -f $(CLEAN_ARTIFACTS)
 350         $(V0) rm -rf $(OBJECT_DIR)/$(TARGET)
 351         $(V0) @echo "Cleaning $(TARGET) succeeded."
 352
 353 ## clean_test        : clean up temporary / machine-generated files (tests)
 354 clean_test:
 355         $(V0) cd src/test && $(MAKE) clean || true
 356
 357 ## clean_<TARGET>    : clean up one specific target
 358 $(CLEAN_TARGETS):
 359         $(V0) $(MAKE) -j TARGET=$(subst clean_,,$@) clean
 360
 361 ## <TARGET>_clean    : clean up one specific target (alias for above)
 362 $(TARGETS_CLEAN):
 363         $(V0) $(MAKE) -j TARGET=$(subst _clean,,$@) clean
 364
 365 ## clean_all         : clean all valid targets
 366 clean_all: $(CLEAN_TARGETS)
 367
 368 ## all_clean         : clean all valid targets (alias for above)
 369 all_clean: $(TARGETS_CLEAN)
 370
 371
 372 flash_$(TARGET): $(TARGET_HEX)
 373         $(V0) stty -F $(SERIAL_DEVICE) raw speed 115200 -crtscts cs8 -parenb -cstopb -ixon
 374         $(V0) echo -n 'R' >$(SERIAL_DEVICE)
 375         $(V0) stm32flash -w $(TARGET_HEX) -v -g 0x0 -b 115200 $(SERIAL_DEVICE)
 376
 377 ## flash             : flash firmware (.hex) onto flight controller
 378 flash: flash_$(TARGET)
 379
 380 st-flash_$(TARGET): $(TARGET_BIN)
 381         $(V0) st-flash --reset write $< 0x08000000
 382
 383 ## st-flash          : flash firmware (.bin) onto flight controller
 384 st-flash: st-flash_$(TARGET)
 385
 386 binary:
 387         $(V0) $(MAKE) -j $(TARGET_BIN)
 388
 389 hex:
 390         $(V0) $(MAKE) -j $(TARGET_HEX)
 391
 392 unbrick_$(TARGET): $(TARGET_HEX)
 393         $(V0) stty -F $(SERIAL_DEVICE) raw speed 115200 -crtscts cs8 -parenb -cstopb -ixon
 394         $(V0) stm32flash -w $(TARGET_HEX) -v -g 0x0 -b 115200 $(SERIAL_DEVICE)
 395
 396 ## unbrick           : unbrick flight controller
 397 unbrick: unbrick_$(TARGET)
 398
 399 ## cppcheck          : run static analysis on C source code
 400 cppcheck: $(CSOURCES)
 401         $(V0) $(CPPCHECK)
 402
 403 cppcheck-result.xml: $(CSOURCES)
 404         $(V0) $(CPPCHECK) --xml-version=2 2> cppcheck-result.xml
 405
 406 # mkdirs
 407 $(DL_DIR):
 408         mkdir -p $@
 409
 410 $(TOOLS_DIR):
 411         mkdir -p $@
 412
 413 $(BUILD_DIR):
 414         mkdir -p $@
 415
 416 ## version           : print firmware version
 417 version:
 418         @echo $(FC_VER)
 419
 420 ## help              : print this help message and exit
 421 help: Makefile make/tools.mk
 422         $(V0) @echo ""
 423         $(V0) @echo "Makefile for the $(FORKNAME) firmware"
 424         $(V0) @echo ""
 425         $(V0) @echo "Usage:"
 426         $(V0) @echo "        make [V=<verbosity>] [TARGET=<target>] [OPTIONS=\"<options>\"]"
 427         $(V0) @echo "Or:"
 428         $(V0) @echo "        make <target> [V=<verbosity>] [OPTIONS=\"<options>\"]"
 429         $(V0) @echo ""
 430         $(V0) @echo "Valid TARGET values are: $(VALID_TARGETS)"
 431         $(V0) @echo ""
 432         $(V0) @sed -n 's/^## //p' $?
 433
 434 ## targets           : print a list of all valid target platforms (for consumption by scripts)
 435 targets:
 436         $(V0) @echo "Valid targets:      $(VALID_TARGETS)"
 437         $(V0) @echo "Target:             $(TARGET)"
 438         $(V0) @echo "Base target:        $(BASE_TARGET)"
 439         $(V0) @echo "targets-group-1:    $(GROUP_1_TARGETS)"
 440         $(V0) @echo "targets-group-2:    $(GROUP_2_TARGETS)"
 441         $(V0) @echo "targets-group-3:    $(GROUP_3_TARGETS)"
 442         $(V0) @echo "targets-group-4:    $(GROUP_4_TARGETS)"
 443         $(V0) @echo "targets-group-rest: $(GROUP_OTHER_TARGETS)"
 444
 445 ## test              : run the cleanflight test suite
 446 ## junittest         : run the cleanflight test suite, producing Junit XML result files.
 447 test junittest:
 448         $(V0) cd src/test && $(MAKE) $@
 449
 450 # rebuild everything when makefile changes
 451 $(TARGET_OBJS) : Makefile
 452
 453 # include auto-generated dependencies
 454 -include $(TARGET_DEPS)