1 # SPDX-License-Identifier: GPL-2.0+
10 # To see a list of typical targets execute "make help"
11 # More info can be located in ./README
12 # Comments in this file are targeted only to the developer, do not
13 # expect to learn how to build the kernel reading this file.
15 # o Do not use make's built-in rules and variables
16 # (this increases performance and avoids hard-to-debug behaviour);
17 # o Look for make include files relative to root of kernel src
18 MAKEFLAGS += -rR --include-dir=$(CURDIR)
20 # Avoid funny character set dependencies
24 export LC_COLLATE LC_NUMERIC
26 # Avoid interference with shell env settings
29 # We are using a recursive build, so we need to do a little thinking
30 # to get the ordering right.
32 # Most importantly: sub-Makefiles should only ever modify files in
33 # their own directory. If in some directory we have a dependency on
34 # a file in another dir (which doesn't happen often, but it's often
35 # unavoidable when linking the built-in.o targets which finally
36 # turn into vmlinux), we will call a sub make in that other dir, and
37 # after that we are sure that everything which is in that other dir
40 # The only cases where we need to modify files which have global
41 # effects are thus separated out and done before the recursive
42 # descending is started. They are now explicitly listed as the
46 # ---------------------------------------------------------------------------
48 # Normally, we echo the whole command before executing it. By making
49 # that echo $($(quiet)$(cmd)), we now have the possibility to set
50 # $(quiet) to choose other forms of output instead, e.g.
52 # quiet_cmd_cc_o_c = Compiling $(RELDIR)/$@
53 # cmd_cc_o_c = $(CC) $(c_flags) -c -o $@ $<
55 # If $(quiet) is empty, the whole command will be printed.
56 # If it is set to "quiet_", only the short version will be printed.
57 # If it is set to "silent_", nothing will be printed at all, since
58 # the variable $(silent_cmd_cc_o_c) doesn't exist.
60 # A simple variant is to prefix commands with $(Q) - that's useful
61 # for commands that shall be hidden in non-verbose mode.
65 # If KBUILD_VERBOSE equals 0 then the above command will be hidden.
66 # If KBUILD_VERBOSE equals 1 then the above command is displayed.
68 # To put more focus on warnings, be less verbose as default
69 # Use 'make V=1' to see the full commands
71 ifeq ("$(origin V)", "command line")
78 ifeq ($(KBUILD_VERBOSE),1)
86 # If the user is running make -s (silent mode), suppress echoing of
89 ifneq ($(filter 4.%,$(MAKE_VERSION)),) # make-4
90 ifneq ($(filter %s ,$(firstword x$(MAKEFLAGS))),)
94 ifneq ($(filter s% -s%,$(MAKEFLAGS)),)
99 export quiet Q KBUILD_VERBOSE
101 # kbuild supports saving output files in a separate directory.
102 # To locate output files in a separate directory two syntaxes are supported.
103 # In both cases the working directory must be the root of the kernel src.
105 # Use "make O=dir/to/store/output/files/"
107 # 2) Set KBUILD_OUTPUT
108 # Set the environment variable KBUILD_OUTPUT to point to the directory
109 # where the output files shall be placed.
110 # export KBUILD_OUTPUT=dir/to/store/output/files/
113 # The O= assignment takes precedence over the KBUILD_OUTPUT environment
116 # KBUILD_SRC is set on invocation of make in OBJ directory
117 # KBUILD_SRC is not intended to be used by the regular user (for now)
118 ifeq ($(KBUILD_SRC),)
120 # OK, Make called in directory where kernel src resides
121 # Do we want to locate output files in a separate directory?
122 ifeq ("$(origin O)", "command line")
123 KBUILD_OUTPUT := $(O)
126 # That's our default target when none is given on the command line
130 # Cancel implicit rules on top Makefile
131 $(CURDIR)/Makefile Makefile: ;
133 ifneq ($(KBUILD_OUTPUT),)
134 # Invoke a second make in the output directory, passing relevant variables
135 # check that the output directory actually exists
136 saved-output := $(KBUILD_OUTPUT)
137 KBUILD_OUTPUT := $(shell mkdir -p $(KBUILD_OUTPUT) && cd $(KBUILD_OUTPUT) \
139 $(if $(KBUILD_OUTPUT),, \
140 $(error failed to create output directory "$(saved-output)"))
142 PHONY += $(MAKECMDGOALS) sub-make
144 $(filter-out _all sub-make $(CURDIR)/Makefile, $(MAKECMDGOALS)) _all: sub-make
148 $(Q)$(MAKE) -C $(KBUILD_OUTPUT) KBUILD_SRC=$(CURDIR) \
149 -f $(CURDIR)/Makefile $(filter-out _all sub-make,$(MAKECMDGOALS))
151 # Leave processing to above invocation of make
153 endif # ifneq ($(KBUILD_OUTPUT),)
154 endif # ifeq ($(KBUILD_SRC),)
156 # We process the rest of the Makefile if this is the final invocation of make
157 ifeq ($(skip-makefile),)
159 # Do not print "Entering directory ...",
160 # but we want to display it when entering to the output directory
161 # so that IDEs/editors are able to understand relative filenames.
162 MAKEFLAGS += --no-print-directory
164 # Call a source code checker (by default, "sparse") as part of the
167 # Use 'make C=1' to enable checking of only re-compiled files.
168 # Use 'make C=2' to enable checking of *all* source files, regardless
169 # of whether they are re-compiled or not.
171 # See the file "doc/sparse.txt" for more details, including
172 # where to get the "sparse" utility.
174 ifeq ("$(origin C)", "command line")
175 KBUILD_CHECKSRC = $(C)
177 ifndef KBUILD_CHECKSRC
181 # Use make M=dir to specify directory of external module to build
182 # Old syntax make ... SUBDIRS=$PWD is still supported
183 # Setting the environment variable KBUILD_EXTMOD take precedence
185 KBUILD_EXTMOD ?= $(SUBDIRS)
188 ifeq ("$(origin M)", "command line")
189 KBUILD_EXTMOD := $(M)
192 # If building an external module we do not care about the all: rule
193 # but instead _all depend on modules
195 ifeq ($(KBUILD_EXTMOD),)
201 ifeq ($(KBUILD_SRC),)
202 # building in the source tree
205 ifeq ($(KBUILD_SRC)/,$(dir $(CURDIR)))
206 # building in a subdirectory of the source tree
209 srctree := $(KBUILD_SRC)
216 VPATH := $(srctree)$(if $(KBUILD_EXTMOD),:$(KBUILD_EXTMOD))
218 export srctree objtree VPATH
220 # Make sure CDPATH settings don't interfere
223 #########################################################################
225 HOSTARCH := $(shell uname -m | \
227 -e s/sun4u/sparc64/ \
230 -e s/ppc64/powerpc/ \
232 -e s/macppc/powerpc/\
235 HOSTOS := $(shell uname -s | tr '[:upper:]' '[:lower:]' | \
236 sed -e 's/\(cygwin\).*/cygwin/')
238 export HOSTARCH HOSTOS
240 #########################################################################
242 # set default to nothing for native builds
243 ifeq ($(HOSTARCH),$(ARCH))
247 KCONFIG_CONFIG ?= .config
248 export KCONFIG_CONFIG
250 # SHELL used by kbuild
251 CONFIG_SHELL := $(shell if [ -x "$$BASH" ]; then echo $$BASH; \
252 else if [ -x /bin/bash ]; then echo /bin/bash; \
253 else echo sh; fi ; fi)
257 HOSTCFLAGS = -Wall -Wstrict-prototypes -O2 -fomit-frame-pointer \
258 $(if $(CONFIG_TOOLS_DEBUG),-g)
261 # With the move to GCC 6, we have implicitly upgraded our language
262 # standard to GNU11 (see https://gcc.gnu.org/gcc-5/porting_to.html).
263 # Some Linux distributions (including RHEL7, SLES13, Debian 8) still
264 # have older compilers as their default, so we make it explicit for
265 # these that our host tools are GNU11 (i.e. C11 w/ GNU extensions).
266 CSTD_FLAG := -std=gnu11
267 ifeq ($(HOSTOS),linux)
268 HOSTCFLAGS += $(CSTD_FLAG)
271 ifeq ($(HOSTOS),cygwin)
275 # Mac OS X / Darwin's C preprocessor is Apple specific. It
276 # generates numerous errors and warnings. We want to bypass it
277 # and use GNU C's cpp. To do this we pass the -traditional-cpp
278 # option to the compiler. Note that the -traditional-cpp flag
279 # DOES NOT have the same semantics as GNU C's flag, all it does
280 # is invoke the GNU preprocessor in stock ANSI/ISO C fashion.
282 # Apple's linker is similar, thanks to the new 2 stage linking
283 # multiple symbol definitions are treated as errors, hence the
284 # -multiply_defined suppress option to turn off this error.
286 ifeq ($(HOSTOS),darwin)
287 # get major and minor product version (e.g. '10' and '6' for Snow Leopard)
288 DARWIN_MAJOR_VERSION = $(shell sw_vers -productVersion | cut -f 1 -d '.')
289 DARWIN_MINOR_VERSION = $(shell sw_vers -productVersion | cut -f 2 -d '.')
291 os_x_before = $(shell if [ $(DARWIN_MAJOR_VERSION) -le $(1) -a \
292 $(DARWIN_MINOR_VERSION) -le $(2) ] ; then echo "$(3)"; else echo "$(4)"; fi ;)
294 os_x_after = $(shell if [ $(DARWIN_MAJOR_VERSION) -ge $(1) -a \
295 $(DARWIN_MINOR_VERSION) -ge $(2) ] ; then echo "$(3)"; else echo "$(4)"; fi ;)
297 # Snow Leopards build environment has no longer restrictions as described above
298 HOSTCC = $(call os_x_before, 10, 5, "cc", "gcc")
299 HOSTCFLAGS += $(call os_x_before, 10, 4, "-traditional-cpp")
300 HOSTLDFLAGS += $(call os_x_before, 10, 5, "-multiply_defined suppress")
302 # since Lion (10.7) ASLR is on by default, but we use linker generated lists
303 # in some host tools which is a problem then ... so disable ASLR for these
305 HOSTLDFLAGS += $(call os_x_before, 10, 7, "", "-Xlinker -no_pie")
307 # macOS Mojave (10.14.X)
308 # Undefined symbols for architecture x86_64: "_PyArg_ParseTuple"
309 HOSTLDFLAGS += $(call os_x_after, 10, 14, "-lpython -dynamclib", "")
312 # Decide whether to build built-in, modular, or both.
313 # Normally, just do built-in.
318 # If we have only "make modules", don't compile built-in objects.
319 # When we're building modules with modversions, we need to consider
320 # the built-in objects during the descend as well, in order to
321 # make sure the checksums are up to date before we record them.
323 ifeq ($(MAKECMDGOALS),modules)
324 KBUILD_BUILTIN := $(if $(CONFIG_MODVERSIONS),1)
327 # If we have "make <whatever> modules", compile modules
328 # in addition to whatever we do anyway.
329 # Just "make" or "make all" shall build modules as well
331 # U-Boot does not need modules
332 #ifneq ($(filter all _all modules,$(MAKECMDGOALS)),)
333 # KBUILD_MODULES := 1
336 #ifeq ($(MAKECMDGOALS),)
337 # KBUILD_MODULES := 1
341 actual=$$( wc -c $1 | awk '{print $$1}'); \
342 limit=$$( printf "%d" $2 ); \
343 if test $$actual -gt $$limit; then \
344 echo "$1 exceeds file size limit:" >&2; \
345 echo " limit: $$limit bytes" >&2; \
346 echo " actual: $$actual bytes" >&2; \
347 echo " excess: $$((actual - limit)) bytes" >&2; \
353 export KBUILD_MODULES KBUILD_BUILTIN
354 export KBUILD_CHECKSRC KBUILD_SRC KBUILD_EXTMOD
356 # We need some generic definitions (do not try to remake the file).
357 scripts/Kbuild.include: ;
358 include scripts/Kbuild.include
360 # Make variables (CC, etc...)
362 AS = $(CROSS_COMPILE)as
364 ifneq ($(shell $(CROSS_COMPILE)ld.bfd -v 2> /dev/null),)
365 LD = $(CROSS_COMPILE)ld.bfd
367 LD = $(CROSS_COMPILE)ld
369 CC = $(CROSS_COMPILE)gcc
371 AR = $(CROSS_COMPILE)ar
372 NM = $(CROSS_COMPILE)nm
373 LDR = $(CROSS_COMPILE)ldr
374 STRIP = $(CROSS_COMPILE)strip
375 OBJCOPY = $(CROSS_COMPILE)objcopy
376 OBJDUMP = $(CROSS_COMPILE)objdump
384 DTC ?= $(objtree)/scripts/dtc/dtc
387 CHECKFLAGS := -D__linux__ -Dlinux -D__STDC__ -Dunix -D__unix__ \
388 -Wbitwise -Wno-return-void -D__CHECK_ENDIAN__ $(CF)
390 KBUILD_CPPFLAGS := -D__KERNEL__ -D__UBOOT__
392 KBUILD_CFLAGS := -Wall -Wstrict-prototypes \
393 -Wno-format-security \
394 -fno-builtin -ffreestanding $(CSTD_FLAG)
395 KBUILD_CFLAGS += -fshort-wchar -fno-strict-aliasing
396 KBUILD_AFLAGS := -D__ASSEMBLY__
398 # Don't generate position independent code
399 KBUILD_CFLAGS += $(call cc-option,-fno-PIE)
400 KBUILD_AFLAGS += $(call cc-option,-fno-PIE)
402 # Read UBOOTRELEASE from include/config/uboot.release (if it exists)
403 UBOOTRELEASE = $(shell cat include/config/uboot.release 2> /dev/null)
404 UBOOTVERSION = $(VERSION)$(if $(PATCHLEVEL),.$(PATCHLEVEL)$(if $(SUBLEVEL),.$(SUBLEVEL)))$(EXTRAVERSION)
406 export VERSION PATCHLEVEL SUBLEVEL UBOOTRELEASE UBOOTVERSION
407 export ARCH CPU BOARD VENDOR SOC CPUDIR BOARDDIR
408 export CONFIG_SHELL HOSTCC HOSTCFLAGS HOSTLDFLAGS CROSS_COMPILE AS LD CC
409 export CPP AR NM LDR STRIP OBJCOPY OBJDUMP
410 export MAKE LEX YACC AWK PERL PYTHON PYTHON2 PYTHON3
411 export HOSTCXX HOSTCXXFLAGS CHECK CHECKFLAGS DTC DTC_FLAGS
413 export KBUILD_CPPFLAGS NOSTDINC_FLAGS UBOOTINCLUDE OBJCOPYFLAGS LDFLAGS
414 export KBUILD_CFLAGS KBUILD_AFLAGS
416 # When compiling out-of-tree modules, put MODVERDIR in the module
417 # tree rather than in the kernel tree. The kernel tree might
419 export MODVERDIR := $(if $(KBUILD_EXTMOD),$(firstword $(KBUILD_EXTMOD))/).tmp_versions
421 # Files to ignore in find ... statements
423 export RCS_FIND_IGNORE := \( -name SCCS -o -name BitKeeper -o -name .svn -o \
424 -name CVS -o -name .pc -o -name .hg -o -name .git \) \
426 export RCS_TAR_IGNORE := --exclude SCCS --exclude BitKeeper --exclude .svn \
427 --exclude CVS --exclude .pc --exclude .hg --exclude .git
429 # ===========================================================================
430 # Rules shared between *config targets and build targets
432 # Basic helpers built in scripts/
433 PHONY += scripts_basic
435 $(Q)$(MAKE) $(build)=scripts/basic
436 $(Q)rm -f .tmp_quiet_recordmcount
438 # To avoid any implicit rule to kick in, define an empty command.
439 scripts/basic/%: scripts_basic ;
441 PHONY += outputmakefile
442 # outputmakefile generates a Makefile in the output directory, if using a
443 # separate output directory. This allows convenient use of make in the
446 ifneq ($(KBUILD_SRC),)
447 $(Q)ln -fsn $(srctree) source
448 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/mkmakefile \
449 $(srctree) $(objtree) $(VERSION) $(PATCHLEVEL)
452 # To make sure we do not include .config for any of the *config targets
453 # catch them early, and hand them over to scripts/kconfig/Makefile
454 # It is allowed to specify more targets when calling make, including
455 # mixing *config targets and build targets.
456 # For example 'make oldconfig all'.
457 # Detect when mixed targets is specified, and make a second invocation
458 # of make so .config is not included in this case either (for *config).
460 version_h := include/generated/version_autogenerated.h
461 timestamp_h := include/generated/timestamp_autogenerated.h
462 defaultenv_h := include/generated/defaultenv_autogenerated.h
464 no-dot-config-targets := clean clobber mrproper distclean \
465 help %docs check% coccicheck \
466 ubootversion backup tests check qcheck
472 ifneq ($(filter $(no-dot-config-targets), $(MAKECMDGOALS)),)
473 ifeq ($(filter-out $(no-dot-config-targets), $(MAKECMDGOALS)),)
478 ifeq ($(KBUILD_EXTMOD),)
479 ifneq ($(filter config %config,$(MAKECMDGOALS)),)
481 ifneq ($(words $(MAKECMDGOALS)),1)
487 ifeq ($(mixed-targets),1)
488 # ===========================================================================
489 # We're called with mixed targets (*config and build targets).
490 # Handle them one by one.
492 PHONY += $(MAKECMDGOALS) __build_one_by_one
494 $(filter-out __build_one_by_one, $(MAKECMDGOALS)): __build_one_by_one
499 for i in $(MAKECMDGOALS); do \
500 $(MAKE) -f $(srctree)/Makefile $$i; \
504 ifeq ($(config-targets),1)
505 # ===========================================================================
506 # *config targets only - make sure prerequisites are updated, and descend
507 # in scripts/kconfig to make the *config target
509 KBUILD_DEFCONFIG := sandbox_defconfig
510 export KBUILD_DEFCONFIG KBUILD_KCONFIG
512 config: scripts_basic outputmakefile FORCE
513 $(Q)$(MAKE) $(build)=scripts/kconfig $@
515 %config: scripts_basic outputmakefile FORCE
516 $(Q)$(MAKE) $(build)=scripts/kconfig $@
519 # ===========================================================================
520 # Build targets only - this includes vmlinux, arch specific targets, clean
521 # targets and others. In general all targets except *config targets.
523 # Additional helpers built in scripts/
524 # Carefully list dependencies so we do not try to build scripts twice
527 scripts: scripts_basic include/config/auto.conf
528 $(Q)$(MAKE) $(build)=$(@)
530 ifeq ($(dot-config),1)
532 -include include/config/auto.conf
534 # Read in dependencies to all Kconfig* files, make sure to run
535 # oldconfig if changes are detected.
536 -include include/config/auto.conf.cmd
538 # To avoid any implicit rule to kick in, define an empty command
539 $(KCONFIG_CONFIG) include/config/auto.conf.cmd: ;
541 # If .config is newer than include/config/auto.conf, someone tinkered
542 # with it and forgot to run make oldconfig.
543 # if auto.conf.cmd is missing then we are probably in a cleaned tree so
544 # we execute the config step to be sure to catch updated Kconfig files
545 include/config/%.conf: $(KCONFIG_CONFIG) include/config/auto.conf.cmd
546 $(Q)$(MAKE) -f $(srctree)/Makefile syncconfig
547 @# If the following part fails, include/config/auto.conf should be
548 @# deleted so "make silentoldconfig" will be re-run on the next build.
549 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.autoconf || \
550 { rm -f include/config/auto.conf; false; }
551 @# include/config.h has been updated after "make silentoldconfig".
552 @# We need to touch include/config/auto.conf so it gets newer
553 @# than include/config.h.
554 @# Otherwise, 'make silentoldconfig' would be invoked twice.
555 $(Q)touch include/config/auto.conf
557 u-boot.cfg spl/u-boot.cfg tpl/u-boot.cfg:
558 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.autoconf $(@)
560 -include include/autoconf.mk
561 -include include/autoconf.mk.dep
563 # We want to include arch/$(ARCH)/config.mk only when include/config/auto.conf
564 # is up-to-date. When we switch to a different board configuration, old CONFIG
565 # macros are still remaining in include/config/auto.conf. Without the following
566 # gimmick, wrong config.mk would be included leading nasty warnings/errors.
567 ifneq ($(wildcard $(KCONFIG_CONFIG)),)
568 ifneq ($(wildcard include/config/auto.conf),)
569 autoconf_is_old := $(shell find . -path ./$(KCONFIG_CONFIG) -newer \
570 include/config/auto.conf)
571 ifeq ($(autoconf_is_old),)
573 include arch/$(ARCH)/Makefile
578 # These are set by the arch-specific config.mk. Make sure they are exported
579 # so they can be used when building an EFI application.
580 export EFI_LDS # Filename of EFI link script in arch/$(ARCH)/lib
581 export EFI_CRT0 # Filename of EFI CRT0 in arch/$(ARCH)/lib
582 export EFI_RELOC # Filename of EFU relocation code in arch/$(ARCH)/lib
583 export CFLAGS_EFI # Compiler flags to add when building EFI app
584 export CFLAGS_NON_EFI # Compiler flags to remove when building EFI app
585 export EFI_TARGET # binutils target if EFI is natively supported
587 # If board code explicitly specified LDSCRIPT or CONFIG_SYS_LDSCRIPT, use
588 # that (or fail if absent). Otherwise, search for a linker script in a
592 #LDSCRIPT := $(srctree)/board/$(BOARDDIR)/u-boot.lds.debug
593 ifdef CONFIG_SYS_LDSCRIPT
594 # need to strip off double quotes
595 LDSCRIPT := $(srctree)/$(CONFIG_SYS_LDSCRIPT:"%"=%)
599 # If there is no specified link script, we look in a number of places for it
601 ifeq ($(wildcard $(LDSCRIPT)),)
602 LDSCRIPT := $(srctree)/board/$(BOARDDIR)/u-boot.lds
604 ifeq ($(wildcard $(LDSCRIPT)),)
605 LDSCRIPT := $(srctree)/$(CPUDIR)/u-boot.lds
607 ifeq ($(wildcard $(LDSCRIPT)),)
608 LDSCRIPT := $(srctree)/arch/$(ARCH)/cpu/u-boot.lds
613 # Dummy target needed, because used as prerequisite
614 include/config/auto.conf: ;
615 endif # $(dot-config)
618 # Xtensa linker script cannot be preprocessed with -ansi because of
619 # preprocessor operations on strings that don't make C identifiers.
621 ifeq ($(CONFIG_XTENSA),)
625 ifdef CONFIG_CC_OPTIMIZE_FOR_SIZE
631 KBUILD_CFLAGS += $(call cc-option,-fno-stack-protector)
632 KBUILD_CFLAGS += $(call cc-option,-fno-delete-null-pointer-checks)
634 # change __FILE__ to the relative path from the srctree
635 KBUILD_CFLAGS += $(call cc-option,-fmacro-prefix-map=$(srctree)/=)
638 # $(KBUILD_AFLAGS) sets -g, which causes gcc to pass a suitable -g<format>
639 # option to the assembler.
642 # Report stack usage if supported
643 # ARC tools based on GCC 7.1 has an issue with stack usage
644 # with naked functions, see commit message for more details
646 ifeq ($(shell $(CONFIG_SHELL) $(srctree)/scripts/gcc-stack-usage.sh $(CC)),y)
647 KBUILD_CFLAGS += -fstack-usage
651 KBUILD_CFLAGS += $(call cc-option,-Wno-format-nonliteral)
652 ifeq ($(cc-name),clang)
653 KBUILD_CPPFLAGS += $(call cc-option,-Qunused-arguments,)
654 KBUILD_CFLAGS += $(call cc-disable-warning, format-invalid-specifier)
655 KBUILD_CFLAGS += $(call cc-disable-warning, gnu)
656 KBUILD_CFLAGS += $(call cc-disable-warning, address-of-packed-member)
657 KBUILD_CFLAGS += $(call cc-option, -fcatch-undefined-behavior)
660 # turn jbsr into jsr for m68k
662 ifeq ($(findstring 3.4,$(shell $(CC) --version)),3.4)
663 KBUILD_AFLAGS += -Wa,-gstabs,-S
667 # Prohibit date/time macros, which would make the build non-deterministic
668 KBUILD_CFLAGS += $(call cc-option,-Werror=date-time)
670 include scripts/Makefile.extrawarn
672 # Add user supplied CPPFLAGS, AFLAGS and CFLAGS as the last assignments
673 KBUILD_CPPFLAGS += $(KCPPFLAGS)
674 KBUILD_AFLAGS += $(KAFLAGS)
675 KBUILD_CFLAGS += $(KCFLAGS)
677 # Use UBOOTINCLUDE when you must reference the include/ directory.
678 # Needed to be compatible with the O= option
681 $(if $(KBUILD_SRC), -I$(srctree)/include) \
682 $(if $(CONFIG_$(SPL_)SYS_THUMB_BUILD), \
683 $(if $(CONFIG_HAS_THUMB2),, \
684 -I$(srctree)/arch/$(ARCH)/thumb1/include),) \
685 -I$(srctree)/arch/$(ARCH)/include \
686 -include $(srctree)/include/linux/kconfig.h
688 NOSTDINC_FLAGS += -nostdinc -isystem $(shell $(CC) -print-file-name=include)
689 CHECKFLAGS += $(NOSTDINC_FLAGS)
692 cpp_flags := $(KBUILD_CPPFLAGS) $(PLATFORM_CPPFLAGS) $(UBOOTINCLUDE) \
694 c_flags := $(KBUILD_CFLAGS) $(cpp_flags)
696 #########################################################################
697 # U-Boot objects....order is important (i.e. start must be first)
699 HAVE_VENDOR_COMMON_LIB = $(if $(wildcard $(srctree)/board/$(VENDOR)/common/Makefile),y,n)
702 libs-$(HAVE_VENDOR_COMMON_LIB) += board/$(VENDOR)/common/
703 libs-$(CONFIG_OF_EMBED) += dts/
708 libs-y += drivers/dma/
709 libs-y += drivers/gpio/
710 libs-y += drivers/i2c/
711 libs-y += drivers/mtd/
712 libs-$(CONFIG_CMD_NAND) += drivers/mtd/nand/raw/
713 libs-y += drivers/mtd/onenand/
714 libs-$(CONFIG_CMD_UBI) += drivers/mtd/ubi/
715 libs-y += drivers/mtd/spi/
716 libs-y += drivers/net/
717 libs-y += drivers/net/phy/
718 libs-y += drivers/power/ \
719 drivers/power/domain/ \
720 drivers/power/fuel_gauge/ \
722 drivers/power/pmic/ \
723 drivers/power/battery/ \
724 drivers/power/regulator/
725 libs-y += drivers/spi/
726 libs-$(CONFIG_FMAN_ENET) += drivers/net/fm/
727 libs-$(CONFIG_SYS_FSL_DDR) += drivers/ddr/fsl/
728 libs-$(CONFIG_SYS_FSL_MMDC) += drivers/ddr/fsl/
729 libs-$(CONFIG_$(SPL_)ALTERA_SDRAM) += drivers/ddr/altera/
730 libs-y += drivers/serial/
731 libs-y += drivers/usb/dwc3/
732 libs-y += drivers/usb/common/
733 libs-y += drivers/usb/emul/
734 libs-y += drivers/usb/eth/
735 libs-$(CONFIG_USB_GADGET) += drivers/usb/gadget/
736 libs-$(CONFIG_USB_GADGET) += drivers/usb/gadget/udc/
737 libs-y += drivers/usb/host/
738 libs-y += drivers/usb/musb/
739 libs-y += drivers/usb/musb-new/
740 libs-y += drivers/usb/phy/
741 libs-y += drivers/usb/ulpi/
745 libs-$(CONFIG_API) += api/
746 libs-$(CONFIG_HAS_POST) += post/
747 libs-$(CONFIG_UNIT_TEST) += test/ test/dm/
748 libs-$(CONFIG_UT_ENV) += test/env/
749 libs-$(CONFIG_UT_OVERLAY) += test/overlay/
751 libs-y += $(if $(BOARDDIR),board/$(BOARDDIR)/)
753 libs-y := $(sort $(libs-y))
755 u-boot-dirs := $(patsubst %/,%,$(filter %/, $(libs-y))) tools examples
757 u-boot-alldirs := $(sort $(u-boot-dirs) $(patsubst %/,%,$(filter %/, $(libs-))))
759 libs-y := $(patsubst %/, %/built-in.o, $(libs-y))
761 u-boot-init := $(head-y)
762 u-boot-main := $(libs-y)
766 ifeq ($(CONFIG_USE_PRIVATE_LIBGCC),y)
767 PLATFORM_LIBGCC = arch/$(ARCH)/lib/lib.a
769 PLATFORM_LIBGCC := -L $(shell dirname `$(CC) $(c_flags) -print-libgcc-file-name`) -lgcc
771 PLATFORM_LIBS += $(PLATFORM_LIBGCC)
773 ifdef CONFIG_CC_COVERAGE
774 KBUILD_CFLAGS += --coverage
775 PLATFORM_LIBGCC += -lgcov
779 export PLATFORM_LIBGCC
781 # Special flags for CPP when processing the linker script.
782 # Pass the version down so we can handle backwards compatibility
785 -include $(srctree)/include/u-boot/u-boot.lds.h \
787 $(shell $(LD) --version | \
788 sed -ne 's/GNU ld version \([0-9][0-9]*\)\.\([0-9][0-9]*\).*/-DLD_MAJOR=\1 -DLD_MINOR=\2/p')
790 #########################################################################
791 #########################################################################
793 ifneq ($(CONFIG_BOARD_SIZE_LIMIT),)
794 BOARD_SIZE_CHECK= @ $(call size_check,$@,$(CONFIG_BOARD_SIZE_LIMIT))
799 ifneq ($(CONFIG_SPL_SIZE_LIMIT),0)
800 SPL_SIZE_CHECK = @$(call size_check,$@,$$(tools/spl_size_limit))
805 # Statically apply RELA-style relocations (currently arm64 only)
806 # This is useful for arm64 where static relocation needs to be performed on
807 # the raw binary, but certain simulators only accept an ELF file (but don't
808 # do the relocation).
809 ifneq ($(CONFIG_STATIC_RELA),)
810 # $(1) is u-boot ELF, $(2) is u-boot bin, $(3) is text base
812 start=$$($(NM) $(1) | grep __rel_dyn_start | cut -f 1 -d ' '); \
813 end=$$($(NM) $(1) | grep __rel_dyn_end | cut -f 1 -d ' '); \
814 tools/relocate-rela $(2) $(3) $$start $$end
819 # Always append ALL so that arch config.mk's can add custom ones
820 ALL-y += u-boot.srec u-boot.bin u-boot.sym System.map binary_size_check
822 ALL-$(CONFIG_ONENAND_U_BOOT) += u-boot-onenand.bin
823 ifeq ($(CONFIG_SPL_FSL_PBL),y)
824 ALL-$(CONFIG_RAMBOOT_PBL) += u-boot-with-spl-pbl.bin
826 ifneq ($(CONFIG_SECURE_BOOT), y)
827 # For Secure Boot The Image needs to be signed and Header must also
828 # be included. So The image has to be built explicitly
829 ALL-$(CONFIG_RAMBOOT_PBL) += u-boot.pbl
832 ALL-$(CONFIG_SPL) += spl/u-boot-spl.bin
833 ifeq ($(CONFIG_MX6)$(CONFIG_SECURE_BOOT), yy)
834 ALL-$(CONFIG_SPL_FRAMEWORK) += u-boot-ivt.img
836 ifeq ($(CONFIG_MX7)$(CONFIG_SECURE_BOOT), yy)
837 ALL-$(CONFIG_SPL_FRAMEWORK) += u-boot-ivt.img
839 ALL-$(CONFIG_SPL_FRAMEWORK) += u-boot.img
842 ALL-$(CONFIG_TPL) += tpl/u-boot-tpl.bin
843 ALL-$(CONFIG_OF_SEPARATE) += u-boot.dtb
844 ifeq ($(CONFIG_SPL_FRAMEWORK),y)
845 ALL-$(CONFIG_OF_SEPARATE) += u-boot-dtb.img
847 ALL-$(CONFIG_OF_HOSTFILE) += u-boot.dtb
848 ifneq ($(CONFIG_SPL_TARGET),)
849 ALL-$(CONFIG_SPL) += $(CONFIG_SPL_TARGET:"%"=%)
851 ALL-$(CONFIG_REMAKE_ELF) += u-boot.elf
852 ALL-$(CONFIG_EFI_APP) += u-boot-app.efi
853 ALL-$(CONFIG_EFI_STUB) += u-boot-payload.efi
855 ifneq ($(BUILD_ROM)$(CONFIG_BUILD_ROM),)
856 ALL-$(CONFIG_X86_RESET_VECTOR) += u-boot.rom
859 # Build a combined spl + u-boot image for sunxi
860 ifeq ($(CONFIG_ARCH_SUNXI)$(CONFIG_SPL),yy)
861 ALL-y += u-boot-sunxi-with-spl.bin
864 # enable combined SPL/u-boot/dtb rules for tegra
865 ifeq ($(CONFIG_TEGRA)$(CONFIG_SPL),yy)
866 ALL-y += u-boot-tegra.bin u-boot-nodtb-tegra.bin
867 ALL-$(CONFIG_OF_SEPARATE) += u-boot-dtb-tegra.bin
870 ALL-$(CONFIG_ARCH_MEDIATEK) += u-boot-mtk.bin
872 # Add optional build target if defined in board/cpu/soc headers
873 ifneq ($(CONFIG_BUILD_TARGET),)
874 ALL-y += $(CONFIG_BUILD_TARGET:"%"=%)
877 ifdef CONFIG_INIT_SP_RELATIVE
878 ALL-y += init_sp_bss_offset_check
881 ifeq ($(CONFIG_MPC85xx)$(CONFIG_OF_SEPARATE),yy)
882 ALL-y += u-boot-with-dtb.bin
885 ifeq ($(CONFIG_ARCH_ROCKCHIP)$(CONFIG_SPL)$(CONFIG_TPL),yyy)
886 ALL-y += idbloader.img
889 LDFLAGS_u-boot += $(LDFLAGS_FINAL)
891 # Avoid 'Not enough room for program headers' error on binutils 2.28 onwards.
892 LDFLAGS_u-boot += $(call ld-option, --no-dynamic-linker)
894 ifeq ($(CONFIG_ARC)$(CONFIG_NIOS2)$(CONFIG_X86)$(CONFIG_XTENSA),)
895 LDFLAGS_u-boot += -Ttext $(CONFIG_SYS_TEXT_BASE)
898 # Normally we fill empty space with 0xff
899 quiet_cmd_objcopy = OBJCOPY $@
900 cmd_objcopy = $(OBJCOPY) --gap-fill=0xff $(OBJCOPYFLAGS) \
901 $(OBJCOPYFLAGS_$(@F)) $< $@
903 # Provide a version which does not do this, for use by EFI
904 quiet_cmd_zobjcopy = OBJCOPY $@
905 cmd_zobjcopy = $(OBJCOPY) $(OBJCOPYFLAGS) $(OBJCOPYFLAGS_$(@F)) $< $@
907 quiet_cmd_efipayload = OBJCOPY $@
908 cmd_efipayload = $(OBJCOPY) -I binary -O $(EFIPAYLOAD_BFDTARGET) -B $(EFIPAYLOAD_BFDARCH) $< $@
910 MKIMAGEOUTPUT ?= /dev/null
912 quiet_cmd_mkimage = MKIMAGE $@
913 cmd_mkimage = $(objtree)/tools/mkimage $(MKIMAGEFLAGS_$(@F)) -d $< $@ \
914 >$(MKIMAGEOUTPUT) $(if $(KBUILD_VERBOSE:0=), && cat $(MKIMAGEOUTPUT))
916 quiet_cmd_mkfitimage = MKIMAGE $@
917 cmd_mkfitimage = $(objtree)/tools/mkimage $(MKIMAGEFLAGS_$(@F)) -f $(U_BOOT_ITS) -p $(CONFIG_FIT_EXTERNAL_OFFSET) $@\
918 >$(MKIMAGEOUTPUT) $(if $(KBUILD_VERBOSE:0=), && cat $(MKIMAGEOUTPUT))
920 quiet_cmd_cat = CAT $@
921 cmd_cat = cat $(filter-out $(PHONY), $^) > $@
923 append = cat $(filter-out $< $(PHONY), $^) >> $@
925 quiet_cmd_pad_cat = CAT $@
926 cmd_pad_cat = $(cmd_objcopy) && $(append) || rm -f $@
930 quiet_cmd_cfgcheck = CFGCHK $2
931 cmd_cfgcheck = $(srctree)/scripts/check-config.sh $2 \
932 $(srctree)/scripts/config_whitelist.txt $(srctree)
935 ifeq ($(CONFIG_DEPRECATED),y)
936 $(warning "You have deprecated configuration options enabled in your .config! Please check your configuration.")
937 ifeq ($(CONFIG_SPI),y)
938 ifneq ($(CONFIG_DM_SPI)$(CONFIG_OF_CONTROL),yy)
939 $(warning "The relevant config item with associated code will remove in v2019.07 release.")
943 ifneq ($(CONFIG_DM),y)
944 @echo >&2 "===================== WARNING ======================"
945 @echo >&2 "This board does not use CONFIG_DM. CONFIG_DM will be"
946 @echo >&2 "compulsory starting with the v2020.01 release."
947 @echo >&2 "Failure to update may result in board removal."
948 @echo >&2 "See doc/driver-model/migration.rst for more info."
949 @echo >&2 "===================================================="
951 ifeq ($(CONFIG_MMC),y)
952 ifneq ($(CONFIG_DM_MMC)$(CONFIG_OF_CONTROL)$(CONFIG_BLK),yyy)
953 @echo >&2 "===================== WARNING ======================"
954 @echo >&2 "This board does not use CONFIG_DM_MMC. Please update"
955 @echo >&2 "the board to use CONFIG_DM_MMC before the v2019.04 release."
956 @echo >&2 "Failure to update by the deadline may result in board removal."
957 @echo >&2 "See doc/driver-model/MIGRATION.txt for more info."
958 @echo >&2 "===================================================="
961 ifeq ($(CONFIG_USB),y)
962 ifneq ($(CONFIG_DM_USB)$(CONFIG_OF_CONTROL)$(CONFIG_BLK),yyy)
963 @echo >&2 "===================== WARNING ======================"
964 @echo >&2 "This board does not use CONFIG_DM_USB. Please update"
965 @echo >&2 "the board to use CONFIG_DM_USB before the v2019.07 release."
966 @echo >&2 "Failure to update by the deadline may result in board removal."
967 @echo >&2 "See doc/driver-model/MIGRATION.txt for more info."
968 @echo >&2 "===================================================="
971 ifeq ($(CONFIG_MVSATA_IDE),y)
972 @echo >&2 "===================== WARNING ======================"
973 @echo >&2 "This board does use CONFIG_MVSATA_IDE which is not"
974 @echo >&2 "ported to driver-model (DM) yet. Please update the storage"
975 @echo >&2 "controller driver to use CONFIG_AHCI before the v2019.07"
977 @echo >&2 "Failure to update by the deadline may result in board removal."
978 @echo >&2 "See doc/driver-model/MIGRATION.txt for more info."
979 @echo >&2 "===================================================="
981 ifeq ($(CONFIG_LIBATA),y)
982 ifneq ($(CONFIG_AHCI),y)
983 @echo >&2 "===================== WARNING ======================"
984 @echo >&2 "This board does use CONFIG_LIBATA but has CONFIG_AHCI not"
985 @echo >&2 "enabled. Please update the storage controller driver to use"
986 @echo >&2 "CONFIG_AHCI before the v2019.07 release."
987 @echo >&2 "Failure to update by the deadline may result in board removal."
988 @echo >&2 "See doc/driver-model/MIGRATION.txt for more info."
989 @echo >&2 "===================================================="
992 ifeq ($(CONFIG_PCI),y)
993 ifneq ($(CONFIG_DM_PCI),y)
994 @echo >&2 "===================== WARNING ======================"
995 @echo >&2 "This board does not use CONFIG_DM_PCI Please update"
996 @echo >&2 "the board to use CONFIG_DM_PCI before the v2019.07 release."
997 @echo >&2 "Failure to update by the deadline may result in board removal."
998 @echo >&2 "See doc/driver-model/MIGRATION.txt for more info."
999 @echo >&2 "===================================================="
1002 ifneq ($(CONFIG_LCD)$(CONFIG_VIDEO),)
1003 ifneq ($(CONFIG_DM_VIDEO),y)
1004 @echo >&2 "===================== WARNING ======================"
1005 @echo >&2 "This board does not use CONFIG_DM_VIDEO Please update"
1006 @echo >&2 "the board to use CONFIG_DM_VIDEO before the v2019.07 release."
1007 @echo >&2 "Failure to update by the deadline may result in board removal."
1008 @echo >&2 "See doc/driver-model/MIGRATION.txt for more info."
1009 @echo >&2 "===================================================="
1012 ifeq ($(CONFIG_OF_EMBED),y)
1013 @echo >&2 "===================== WARNING ======================"
1014 @echo >&2 "CONFIG_OF_EMBED is enabled. This option should only"
1015 @echo >&2 "be used for debugging purposes. Please use"
1016 @echo >&2 "CONFIG_OF_SEPARATE for boards in mainline."
1017 @echo >&2 "See doc/README.fdt-control for more info."
1018 @echo >&2 "===================================================="
1020 ifeq ($(CONFIG_SPI_FLASH),y)
1021 ifneq ($(CONFIG_DM_SPI_FLASH)$(CONFIG_OF_CONTROL),yy)
1022 @echo >&2 "===================== WARNING ======================"
1023 @echo >&2 "This board does not use CONFIG_DM_SPI_FLASH. Please update"
1024 @echo >&2 "the board to use CONFIG_SPI_FLASH before the v2019.07 release."
1025 @echo >&2 "Failure to update by the deadline may result in board removal."
1026 @echo >&2 "See doc/driver-model/MIGRATION.txt for more info."
1027 @echo >&2 "===================================================="
1030 ifneq ($(CONFIG_WATCHDOG)$(CONFIG_HW_WATCHDOG),)
1031 ifneq ($(CONFIG_WDT),y)
1032 @echo >&2 "===================== WARNING ======================"
1033 @echo >&2 "This board does not use CONFIG_WDT (DM watchdog support)."
1034 @echo >&2 "Please update the board to use CONFIG_WDT before the"
1035 @echo >&2 "v2019.10 release."
1036 @echo >&2 "Failure to update by the deadline may result in board removal."
1037 @echo >&2 "See doc/driver-model/MIGRATION.txt for more info."
1038 @echo >&2 "===================================================="
1041 ifneq ($(CONFIG_NET),)
1042 ifneq ($(CONFIG_DM_ETH),y)
1043 @echo >&2 "===================== WARNING ======================"
1044 @echo >&2 "This board does not use CONFIG_DM_ETH (Driver Model"
1045 @echo >&2 "for Ethernet drivers). Please update the board to use"
1046 @echo >&2 "CONFIG_DM_ETH before the v2020.07 release. Failure to"
1047 @echo >&2 "update by the deadline may result in board removal."
1048 @echo >&2 "See doc/driver-model/migration.rst for more info."
1049 @echo >&2 "===================================================="
1052 @# Check that this build does not use CONFIG options that we do not
1053 @# know about unless they are in Kconfig. All the existing CONFIG
1054 @# options are whitelisted, so new ones should not be added.
1055 $(call cmd,cfgcheck,u-boot.cfg)
1061 $(Q)$(MAKE) $(build)=dts dtbs
1063 quiet_cmd_copy = COPY $@
1066 ifeq ($(CONFIG_MULTI_DTB_FIT),y)
1068 ifeq ($(CONFIG_MULTI_DTB_FIT_LZO),y)
1069 FINAL_DTB_CONTAINER = fit-dtb.blob.lzo
1070 else ifeq ($(CONFIG_MULTI_DTB_FIT_GZIP),y)
1071 FINAL_DTB_CONTAINER = fit-dtb.blob.gz
1073 FINAL_DTB_CONTAINER = fit-dtb.blob
1076 fit-dtb.blob.gz: fit-dtb.blob
1079 fit-dtb.blob.lzo: fit-dtb.blob
1082 fit-dtb.blob: dts/dt.dtb FORCE
1083 $(call if_changed,mkimage)
1084 ifneq ($(SOURCE_DATE_EPOCH),)
1085 touch -d @$(SOURCE_DATE_EPOCH) fit-dtb.blob
1086 chmod 0600 fit-dtb.blob
1089 MKIMAGEFLAGS_fit-dtb.blob = -f auto -A $(ARCH) -T firmware -C none -O u-boot \
1091 $(patsubst %,-b arch/$(ARCH)/dts/%.dtb,$(subst ",,$(CONFIG_OF_LIST))) -d /dev/null
1094 u-boot-fit-dtb.bin: u-boot-nodtb.bin $(EXT_DTB)
1095 $(call if_changed,cat)
1097 u-boot-fit-dtb.bin: u-boot-nodtb.bin $(FINAL_DTB_CONTAINER)
1098 $(call if_changed,cat)
1101 u-boot.bin: u-boot-fit-dtb.bin FORCE
1102 $(call if_changed,copy)
1104 u-boot-dtb.bin: u-boot-nodtb.bin dts/dt.dtb FORCE
1105 $(call if_changed,cat)
1107 else ifeq ($(CONFIG_OF_SEPARATE),y)
1108 u-boot-dtb.bin: u-boot-nodtb.bin dts/dt.dtb FORCE
1109 $(call if_changed,cat)
1111 u-boot.bin: u-boot-dtb.bin FORCE
1112 $(call if_changed,copy)
1114 u-boot.bin: u-boot-nodtb.bin FORCE
1115 $(call if_changed,copy)
1119 $(Q)$(MAKE) $(build)=arch/arm/mach-imx $@
1123 $(Q)$(MAKE) $(build)=arch/arm/cpu/armv7/vf610 $@
1125 quiet_cmd_copy = COPY $@
1128 u-boot.dtb: dts/dt.dtb
1131 OBJCOPYFLAGS_u-boot.hex := -O ihex
1133 OBJCOPYFLAGS_u-boot.srec := -O srec
1135 u-boot.hex u-boot.srec: u-boot FORCE
1136 $(call if_changed,objcopy)
1138 OBJCOPYFLAGS_u-boot-elf.srec := $(OBJCOPYFLAGS_u-boot.srec)
1140 u-boot-elf.srec: u-boot.elf FORCE
1141 $(call if_changed,objcopy)
1143 OBJCOPYFLAGS_u-boot-spl.srec = $(OBJCOPYFLAGS_u-boot.srec)
1145 spl/u-boot-spl.srec: spl/u-boot-spl FORCE
1146 $(call if_changed,objcopy)
1149 $(Q)$(MAKE) $(build)=arch/arm/mach-rmobile $@
1151 OBJCOPYFLAGS_u-boot-nodtb.bin := -O binary \
1152 $(if $(CONFIG_X86_16BIT_INIT),-R .start16 -R .resetvec) \
1153 $(if $(CONFIG_MPC85XX_HAVE_RESET_VECTOR),-R .bootpg -R .resetvec)
1155 OBJCOPYFLAGS_u-boot-spl.hex = $(OBJCOPYFLAGS_u-boot.hex)
1157 spl/u-boot-spl.hex: spl/u-boot-spl FORCE
1158 $(call if_changed,objcopy)
1160 binary_size_check: u-boot-nodtb.bin FORCE
1161 @file_size=$(shell wc -c u-boot-nodtb.bin | awk '{print $$1}') ; \
1162 map_size=$(shell cat u-boot.map | \
1163 awk '/_image_copy_start/ {start = $$1} /_image_binary_end/ {end = $$1} END {if (start != "" && end != "") print "ibase=16; " toupper(end) " - " toupper(start)}' \
1166 if [ "" != "$$map_size" ]; then \
1167 if test $$map_size -ne $$file_size; then \
1168 echo "u-boot.map shows a binary size of $$map_size" >&2 ; \
1169 echo " but u-boot-nodtb.bin shows $$file_size" >&2 ; \
1174 ifdef CONFIG_INIT_SP_RELATIVE
1175 ifneq ($(CONFIG_SYS_MALLOC_F_LEN),)
1176 subtract_sys_malloc_f_len = space=$$(($${space} - $(CONFIG_SYS_MALLOC_F_LEN)))
1178 subtract_sys_malloc_f_len = true
1180 # The 1/4 margin below is somewhat arbitrary. The likely initial SP usage is
1181 # so low that the DTB could probably use 90%+ of the available space, for
1182 # current values of CONFIG_SYS_INIT_SP_BSS_OFFSET at least. However, let's be
1183 # safe for now and tweak this later if space becomes tight.
1184 # A rejected alternative would be to check that some absolute minimum stack
1185 # space was available. However, since CONFIG_SYS_INIT_SP_BSS_OFFSET is
1186 # deliberately build-specific, to take account of build-to-build stack usage
1187 # differences due to different feature sets, there is no common absolute value
1189 init_sp_bss_offset_check: u-boot.dtb FORCE
1190 @dtb_size=$(shell wc -c u-boot.dtb | awk '{print $$1}') ; \
1191 space=$(CONFIG_SYS_INIT_SP_BSS_OFFSET) ; \
1192 $(subtract_sys_malloc_f_len) ; \
1193 quarter_space=$$(($${space} / 4)) ; \
1194 if [ $${dtb_size} -gt $${quarter_space} ]; then \
1195 echo "u-boot.dtb is larger than 1 quarter of " >&2 ; \
1196 echo "(CONFIG_SYS_INIT_SP_BSS_OFFSET - CONFIG_SYS_MALLOC_F_LEN)" >&2 ; \
1201 u-boot-nodtb.bin: u-boot FORCE
1202 $(call if_changed,objcopy)
1203 $(call DO_STATIC_RELA,$<,$@,$(CONFIG_SYS_TEXT_BASE))
1208 $(LDR) -T $(CONFIG_CPU) -c $@ $< $(LDR_FLAGS)
1212 # ---------------------------------------------------------------------------
1213 # Use 'make BINMAN_DEBUG=1' to enable debugging
1214 quiet_cmd_binman = BINMAN $@
1215 cmd_binman = $(srctree)/tools/binman/binman $(if $(BINMAN_DEBUG),-D) \
1216 --toolpath $(objtree)/tools \
1217 build -u -d u-boot.dtb -O . -m \
1218 -I . -I $(srctree) -I $(srctree)/board/$(BOARDDIR) \
1221 OBJCOPYFLAGS_u-boot.ldr.hex := -I binary -O ihex
1223 OBJCOPYFLAGS_u-boot.ldr.srec := -I binary -O srec
1225 u-boot.ldr.hex u-boot.ldr.srec: u-boot.ldr FORCE
1226 $(call if_changed,objcopy)
1229 # U-Boot entry point, needed for booting of full-blown U-Boot
1230 # from the SPL U-Boot version.
1232 ifndef CONFIG_SYS_UBOOT_START
1233 CONFIG_SYS_UBOOT_START := 0
1236 # Boards with more complex image requirements can provide an .its source file
1237 # or a generator script
1238 ifneq ($(CONFIG_SPL_FIT_SOURCE),"")
1239 U_BOOT_ITS = $(subst ",,$(CONFIG_SPL_FIT_SOURCE))
1241 ifneq ($(CONFIG_SPL_FIT_GENERATOR),"")
1242 U_BOOT_ITS := u-boot.its
1243 ifeq ($(CONFIG_SPL_FIT_GENERATOR),"arch/arm/mach-imx/mkimage_fit_atf.sh")
1244 U_BOOT_ITS_DEPS += u-boot-nodtb.bin
1246 ifeq ($(CONFIG_SPL_FIT_GENERATOR),"arch/arm/mach-rockchip/make_fit_atf.py")
1247 U_BOOT_ITS_DEPS += u-boot
1249 $(U_BOOT_ITS): $(U_BOOT_ITS_DEPS) FORCE
1250 $(srctree)/$(CONFIG_SPL_FIT_GENERATOR) \
1251 $(patsubst %,arch/$(ARCH)/dts/%.dtb,$(subst ",,$(CONFIG_OF_LIST))) > $@
1255 ifdef CONFIG_SPL_LOAD_FIT
1256 MKIMAGEFLAGS_u-boot.img = -f auto -A $(ARCH) -T firmware -C none -O u-boot \
1257 -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_UBOOT_START) \
1258 -n "U-Boot $(UBOOTRELEASE) for $(BOARD) board" -E \
1259 $(patsubst %,-b arch/$(ARCH)/dts/%.dtb,$(subst ",,$(CONFIG_OF_LIST)))
1261 MKIMAGEFLAGS_u-boot.img = -A $(ARCH) -T firmware -C none -O u-boot \
1262 -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_UBOOT_START) \
1263 -n "U-Boot $(UBOOTRELEASE) for $(BOARD) board"
1264 MKIMAGEFLAGS_u-boot-ivt.img = -A $(ARCH) -T firmware_ivt -C none -O u-boot \
1265 -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_UBOOT_START) \
1266 -n "U-Boot $(UBOOTRELEASE) for $(BOARD) board"
1267 u-boot-ivt.img: MKIMAGEOUTPUT = u-boot-ivt.img.log
1268 CLEAN_FILES += u-boot-ivt.img.log u-boot-dtb.imx.log SPL.log u-boot.imx.log
1271 MKIMAGEFLAGS_u-boot-dtb.img = $(MKIMAGEFLAGS_u-boot.img)
1273 MKIMAGEFLAGS_u-boot.kwb = -n $(srctree)/$(CONFIG_SYS_KWD_CONFIG:"%"=%) \
1274 -T kwbimage -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_TEXT_BASE)
1276 MKIMAGEFLAGS_u-boot-spl.kwb = -n $(srctree)/$(CONFIG_SYS_KWD_CONFIG:"%"=%) \
1277 -T kwbimage -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_TEXT_BASE) \
1278 $(if $(KEYDIR),-k $(KEYDIR))
1280 MKIMAGEFLAGS_u-boot.pbl = -n $(srctree)/$(CONFIG_SYS_FSL_PBL_RCW:"%"=%) \
1281 -R $(srctree)/$(CONFIG_SYS_FSL_PBL_PBI:"%"=%) -T pblimage
1283 ifeq ($(CONFIG_MPC85xx)$(CONFIG_OF_SEPARATE),yy)
1284 UBOOT_BIN := u-boot-with-dtb.bin
1286 UBOOT_BIN := u-boot.bin
1289 u-boot-dtb.img u-boot.img u-boot.kwb u-boot.pbl u-boot-ivt.img: \
1290 $(if $(CONFIG_SPL_LOAD_FIT),u-boot-nodtb.bin \
1291 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_OF_HOSTFILE),dts/dt.dtb) \
1292 ,$(UBOOT_BIN)) FORCE
1293 $(call if_changed,mkimage)
1296 ifeq ($(CONFIG_SPL_LOAD_FIT_FULL),y)
1297 MKIMAGEFLAGS_u-boot.itb =
1299 MKIMAGEFLAGS_u-boot.itb = -E
1302 u-boot.itb: u-boot-nodtb.bin \
1303 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_OF_HOSTFILE),dts/dt.dtb) \
1305 $(call if_changed,mkfitimage)
1308 u-boot-spl.kwb: u-boot.img spl/u-boot-spl.bin FORCE
1309 $(call if_changed,mkimage)
1311 u-boot.sha1: u-boot.bin
1312 tools/ubsha1 u-boot.bin
1315 $(OBJDUMP) -d $< > $@
1317 ifneq ($(CONFIG_SPL_PAYLOAD),)
1318 SPL_PAYLOAD := $(CONFIG_SPL_PAYLOAD:"%"=%)
1320 SPL_PAYLOAD := u-boot.bin
1323 SPL_IMAGE := $(CONFIG_SPL_IMAGE:"%"=%)
1325 OBJCOPYFLAGS_u-boot-with-spl.bin = -I binary -O binary \
1326 --pad-to=$(CONFIG_SPL_PAD_TO)
1327 u-boot-with-spl.bin: $(SPL_IMAGE) $(SPL_PAYLOAD) FORCE
1328 $(call if_changed,pad_cat)
1330 ifeq ($(CONFIG_ARCH_ROCKCHIP),y)
1331 MKIMAGEFLAGS_u-boot-tpl.img = -n $(CONFIG_SYS_SOC) -T rksd
1332 tpl/u-boot-tpl.img: tpl/u-boot-tpl.bin FORCE
1333 $(call if_changed,mkimage)
1334 idbloader.img: tpl/u-boot-tpl.img spl/u-boot-spl.bin FORCE
1335 $(call if_changed,cat)
1338 ifeq ($(CONFIG_ARCH_LPC32XX)$(CONFIG_SPL),yy)
1339 MKIMAGEFLAGS_lpc32xx-spl.img = -T lpc32xximage -a $(CONFIG_SPL_TEXT_BASE)
1341 lpc32xx-spl.img: spl/u-boot-spl.bin FORCE
1342 $(call if_changed,mkimage)
1344 OBJCOPYFLAGS_lpc32xx-boot-0.bin = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO)
1346 lpc32xx-boot-0.bin: lpc32xx-spl.img FORCE
1347 $(call if_changed,objcopy)
1349 OBJCOPYFLAGS_lpc32xx-boot-1.bin = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO)
1351 lpc32xx-boot-1.bin: lpc32xx-spl.img FORCE
1352 $(call if_changed,objcopy)
1354 lpc32xx-full.bin: lpc32xx-boot-0.bin lpc32xx-boot-1.bin u-boot.img FORCE
1355 $(call if_changed,cat)
1357 CLEAN_FILES += lpc32xx-*
1360 OBJCOPYFLAGS_u-boot-with-tpl.bin = -I binary -O binary \
1361 --pad-to=$(CONFIG_TPL_PAD_TO)
1362 tpl/u-boot-with-tpl.bin: tpl/u-boot-tpl.bin u-boot.bin FORCE
1363 $(call if_changed,pad_cat)
1365 SPL: spl/u-boot-spl.bin FORCE
1366 $(Q)$(MAKE) $(build)=arch/arm/mach-imx $@
1368 ifeq ($(CONFIG_ARCH_IMX8M)$(CONFIG_ARCH_IMX8), y)
1369 flash.bin: spl/u-boot-spl.bin u-boot.itb FORCE
1370 $(Q)$(MAKE) $(build)=arch/arm/mach-imx $@
1373 u-boot-with-spl.imx u-boot-with-nand-spl.imx: SPL u-boot.bin FORCE
1374 $(Q)$(MAKE) $(build)=arch/arm/mach-imx $@
1376 MKIMAGEFLAGS_u-boot.ubl = -n $(UBL_CONFIG) -T ublimage -e $(CONFIG_SYS_TEXT_BASE)
1378 u-boot.ubl: u-boot-with-spl.bin FORCE
1379 $(call if_changed,mkimage)
1381 MKIMAGEFLAGS_u-boot-spl.ais = -s -n $(if $(CONFIG_AIS_CONFIG_FILE), \
1382 $(srctree)/$(CONFIG_AIS_CONFIG_FILE:"%"=%),"/dev/null") \
1383 -T aisimage -e $(CONFIG_SPL_TEXT_BASE)
1384 spl/u-boot-spl.ais: spl/u-boot-spl.bin FORCE
1385 $(call if_changed,mkimage)
1387 OBJCOPYFLAGS_u-boot.ais = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO)
1388 u-boot.ais: spl/u-boot-spl.ais u-boot.img FORCE
1389 $(call if_changed,pad_cat)
1391 u-boot-signed.sb: u-boot.bin spl/u-boot-spl.bin
1392 $(Q)$(MAKE) $(build)=arch/arm/cpu/arm926ejs/mxs u-boot-signed.sb
1393 u-boot.sb: u-boot.bin spl/u-boot-spl.bin
1394 $(Q)$(MAKE) $(build)=arch/arm/cpu/arm926ejs/mxs u-boot.sb
1396 # On x600 (SPEAr600) U-Boot is appended to U-Boot SPL.
1397 # Both images are created using mkimage (crc etc), so that the ROM
1398 # bootloader can check its integrity. Padding needs to be done to the
1399 # SPL image (with mkimage header) and not the binary. Otherwise the resulting image
1400 # which is loaded/copied by the ROM bootloader to SRAM doesn't fit.
1401 # The resulting image containing both U-Boot images is called u-boot.spr
1402 MKIMAGEFLAGS_u-boot-spl.img = -A $(ARCH) -T firmware -C none \
1403 -a $(CONFIG_SPL_TEXT_BASE) -e $(CONFIG_SPL_TEXT_BASE) -n XLOADER
1404 spl/u-boot-spl.img: spl/u-boot-spl.bin FORCE
1405 $(call if_changed,mkimage)
1407 OBJCOPYFLAGS_u-boot.spr = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO) \
1409 u-boot.spr: spl/u-boot-spl.img u-boot.img FORCE
1410 $(call if_changed,pad_cat)
1412 ifneq ($(CONFIG_ARCH_SOCFPGA),)
1413 quiet_cmd_socboot = SOCBOOT $@
1414 cmd_socboot = cat spl/u-boot-spl.sfp spl/u-boot-spl.sfp \
1415 spl/u-boot-spl.sfp spl/u-boot-spl.sfp \
1416 u-boot.img > $@ || rm -f $@
1417 u-boot-with-spl.sfp: spl/u-boot-spl.sfp u-boot.img FORCE
1418 $(call if_changed,socboot)
1421 ifeq ($(CONFIG_MPC85xx)$(CONFIG_OF_SEPARATE),yy)
1422 u-boot-with-dtb.bin: u-boot.bin u-boot.dtb \
1423 $(if $(CONFIG_MPC85XX_HAVE_RESET_VECTOR), u-boot-br.bin) FORCE
1424 $(call if_changed,binman)
1426 ifeq ($(CONFIG_MPC85XX_HAVE_RESET_VECTOR),y)
1427 OBJCOPYFLAGS_u-boot-br.bin := -O binary -j .bootpg -j .resetvec
1428 u-boot-br.bin: u-boot FORCE
1429 $(call if_changed,objcopy)
1433 # x86 uses a large ROM. We fill it with 0xff, put the 16-bit stuff (including
1434 # reset vector) at the top, Intel ME descriptor at the bottom, and U-Boot in
1435 # the middle. This is handled by binman based on an image description in the
1436 # board's device tree.
1437 ifneq ($(CONFIG_X86_RESET_VECTOR),)
1438 rom: u-boot.rom FORCE
1440 refcode.bin: $(srctree)/board/$(BOARDDIR)/refcode.bin FORCE
1441 $(call if_changed,copy)
1443 quiet_cmd_ldr = LD $@
1444 cmd_ldr = $(LD) $(LDFLAGS_$(@F)) \
1445 $(filter-out FORCE,$^) -o $@
1447 u-boot.rom: u-boot-x86-16bit.bin u-boot.bin \
1448 $(if $(CONFIG_SPL_X86_16BIT_INIT),spl/u-boot-spl.bin) \
1449 $(if $(CONFIG_TPL_X86_16BIT_INIT),tpl/u-boot-tpl.bin) \
1450 $(if $(CONFIG_HAVE_REFCODE),refcode.bin) FORCE
1451 $(call if_changed,binman)
1453 OBJCOPYFLAGS_u-boot-x86-16bit.bin := -O binary -j .start16 -j .resetvec
1454 u-boot-x86-16bit.bin: u-boot FORCE
1455 $(call if_changed,objcopy)
1458 ifneq ($(CONFIG_ARCH_SUNXI),)
1459 ifeq ($(CONFIG_ARM64),)
1460 u-boot-sunxi-with-spl.bin: spl/sunxi-spl.bin u-boot.img u-boot.dtb FORCE
1461 $(call if_changed,binman)
1463 u-boot-sunxi-with-spl.bin: spl/sunxi-spl.bin u-boot.itb FORCE
1464 $(call if_changed,cat)
1468 ifneq ($(CONFIG_TEGRA),)
1469 ifneq ($(CONFIG_BINMAN),)
1470 # Makes u-boot-dtb-tegra.bin u-boot-tegra.bin u-boot-nodtb-tegra.bin
1471 %-dtb-tegra.bin %-tegra.bin %-nodtb-tegra.bin: \
1472 spl/%-spl %.bin FORCE
1473 $(call if_changed,binman)
1475 OBJCOPYFLAGS_u-boot-nodtb-tegra.bin = -O binary --pad-to=$(CONFIG_SYS_TEXT_BASE)
1476 u-boot-nodtb-tegra.bin: spl/u-boot-spl u-boot-nodtb.bin FORCE
1477 $(call if_changed,pad_cat)
1479 OBJCOPYFLAGS_u-boot-tegra.bin = -O binary --pad-to=$(CONFIG_SYS_TEXT_BASE)
1480 u-boot-tegra.bin: spl/u-boot-spl u-boot.bin FORCE
1481 $(call if_changed,pad_cat)
1483 u-boot-dtb-tegra.bin: u-boot-tegra.bin FORCE
1484 $(call if_changed,copy)
1488 OBJCOPYFLAGS_u-boot-app.efi := $(OBJCOPYFLAGS_EFI)
1489 u-boot-app.efi: u-boot FORCE
1490 $(call if_changed,zobjcopy)
1492 u-boot.bin.o: u-boot.bin FORCE
1493 $(call if_changed,efipayload)
1495 u-boot-payload.lds: $(LDSCRIPT_EFI) FORCE
1496 $(call if_changed_dep,cpp_lds)
1498 # Rule to link the EFI payload which contains a stub and a U-Boot binary
1499 quiet_cmd_u-boot_payload ?= LD $@
1500 cmd_u-boot_payload ?= $(LD) $(LDFLAGS_EFI_PAYLOAD) -o $@ \
1501 -T u-boot-payload.lds arch/x86/cpu/call32.o \
1502 lib/efi/efi.o lib/efi/efi_stub.o u-boot.bin.o \
1503 $(addprefix arch/$(ARCH)/lib/,$(EFISTUB))
1505 u-boot-payload: u-boot.bin.o u-boot-payload.lds FORCE
1506 $(call if_changed,u-boot_payload)
1508 OBJCOPYFLAGS_u-boot-payload.efi := $(OBJCOPYFLAGS_EFI)
1509 u-boot-payload.efi: u-boot-payload FORCE
1510 $(call if_changed,zobjcopy)
1512 u-boot-img.bin: spl/u-boot-spl.bin u-boot.img FORCE
1513 $(call if_changed,cat)
1515 #Add a target to create boot binary having SPL binary in PBI format
1516 #concatenated with u-boot binary. It is need by PowerPC SoC having
1517 #internal SRAM <= 512KB.
1518 MKIMAGEFLAGS_u-boot-spl.pbl = -n $(srctree)/$(CONFIG_SYS_FSL_PBL_RCW:"%"=%) \
1519 -R $(srctree)/$(CONFIG_SYS_FSL_PBL_PBI:"%"=%) -T pblimage \
1520 -A $(ARCH) -a $(CONFIG_SPL_TEXT_BASE)
1522 spl/u-boot-spl.pbl: spl/u-boot-spl.bin FORCE
1523 $(call if_changed,mkimage)
1526 UBOOT_BINLOAD := u-boot.img
1528 ifeq ($(CONFIG_MPC85xx)$(CONFIG_OF_SEPARATE),yy)
1529 UBOOT_BINLOAD := u-boot-with-dtb.bin
1531 UBOOT_BINLOAD := u-boot.bin
1535 OBJCOPYFLAGS_u-boot-with-spl-pbl.bin = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO) \
1538 u-boot-with-spl-pbl.bin: spl/u-boot-spl.pbl $(UBOOT_BINLOAD) FORCE
1539 $(call if_changed,pad_cat)
1541 # PPC4xx needs the SPL at the end of the image, since the reset vector
1542 # is located at 0xfffffffc. So we can't use the "u-boot-img.bin" target
1543 # and need to introduce a new build target with the full blown U-Boot
1544 # at the start padded up to the start of the SPL image. And then concat
1545 # the SPL image to the end.
1547 OBJCOPYFLAGS_u-boot-img-spl-at-end.bin := -I binary -O binary \
1548 --pad-to=$(CONFIG_UBOOT_PAD_TO) --gap-fill=0xff
1549 u-boot-img-spl-at-end.bin: u-boot.img spl/u-boot-spl.bin FORCE
1550 $(call if_changed,pad_cat)
1552 # Create a new ELF from a raw binary file.
1553 ifndef PLATFORM_ELFENTRY
1554 PLATFORM_ELFENTRY = "_start"
1556 quiet_cmd_u-boot-elf ?= LD $@
1557 cmd_u-boot-elf ?= $(LD) u-boot-elf.o -o $@ \
1558 --defsym=$(PLATFORM_ELFENTRY)=$(CONFIG_SYS_TEXT_BASE) \
1559 -Ttext=$(CONFIG_SYS_TEXT_BASE)
1560 u-boot.elf: u-boot.bin
1561 $(Q)$(OBJCOPY) -I binary $(PLATFORM_ELFFLAGS) $< u-boot-elf.o
1562 $(call if_changed,u-boot-elf)
1564 # MediaTek's ARM-based u-boot needs a header to contains its load address
1565 # which is parsed by the BootROM.
1566 # If the SPL build is enabled, the header will be added to the spl binary,
1567 # and the spl binary and the u-boot.img will be combined into one file.
1568 # Otherwise the header will be added to the u-boot.bin directly.
1570 ifeq ($(CONFIG_SPL),y)
1571 spl/u-boot-spl-mtk.bin: spl/u-boot-spl
1573 u-boot-mtk.bin: u-boot.dtb u-boot.img spl/u-boot-spl-mtk.bin FORCE
1574 $(call if_changed,binman)
1576 MKIMAGEFLAGS_u-boot-mtk.bin = -T mtk_image \
1577 -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_TEXT_BASE) \
1578 -n "$(patsubst "%",%,$(CONFIG_MTK_BROM_HEADER_INFO))"
1580 u-boot-mtk.bin: u-boot.bin FORCE
1581 $(call if_changed,mkimage)
1584 ARCH_POSTLINK := $(wildcard $(srctree)/arch/$(ARCH)/Makefile.postlink)
1586 # Rule to link u-boot
1587 # May be overridden by arch/$(ARCH)/config.mk
1588 quiet_cmd_u-boot__ ?= LD $@
1589 cmd_u-boot__ ?= $(LD) $(LDFLAGS) $(LDFLAGS_u-boot) -o $@ \
1590 -T u-boot.lds $(u-boot-init) \
1591 --start-group $(u-boot-main) --end-group \
1592 $(PLATFORM_LIBS) -Map u-boot.map; \
1593 $(if $(ARCH_POSTLINK), $(MAKE) -f $(ARCH_POSTLINK) $@, true)
1595 quiet_cmd_smap = GEN common/system_map.o
1597 smap=`$(call SYSTEM_MAP,u-boot) | \
1598 awk '$$2 ~ /[tTwW]/ {printf $$1 $$3 "\\\\000"}'` ; \
1599 $(CC) $(c_flags) -DSYSTEM_MAP="\"$${smap}\"" \
1600 -c $(srctree)/common/system_map.c -o common/system_map.o
1602 u-boot: $(u-boot-init) $(u-boot-main) u-boot.lds FORCE
1603 +$(call if_changed,u-boot__)
1604 ifeq ($(CONFIG_KALLSYMS),y)
1606 $(call cmd,u-boot__) common/system_map.o
1609 ifeq ($(CONFIG_RISCV),y)
1610 @tools/prelink-riscv $@ 0
1613 quiet_cmd_sym ?= SYM $@
1614 cmd_sym ?= $(OBJDUMP) -t $< > $@
1615 u-boot.sym: u-boot FORCE
1616 $(call if_changed,sym)
1618 # The actual objects are generated when descending,
1619 # make sure no implicit rule kicks in
1620 $(sort $(u-boot-init) $(u-boot-main)): $(u-boot-dirs) ;
1622 # Handle descending into subdirectories listed in $(vmlinux-dirs)
1623 # Preset locale variables to speed up the build process. Limit locale
1624 # tweaks to this spot to avoid wrong language settings when running
1625 # make menuconfig etc.
1626 # Error messages still appears in the original language
1628 PHONY += $(u-boot-dirs)
1629 $(u-boot-dirs): prepare scripts
1630 $(Q)$(MAKE) $(build)=$@
1633 # The "tools" are needed early
1634 $(filter-out tools, $(u-boot-dirs)): tools
1635 # The "examples" conditionally depend on U-Boot (say, when USE_PRIVATE_LIBGCC
1636 # is "yes"), so compile examples after U-Boot is compiled.
1637 examples: $(filter-out examples, $(u-boot-dirs))
1639 define filechk_uboot.release
1640 echo "$(UBOOTVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))"
1643 # Store (new) UBOOTRELEASE string in include/config/uboot.release
1644 include/config/uboot.release: include/config/auto.conf FORCE
1645 $(call filechk,uboot.release)
1648 # Things we need to do before we recursively start building the kernel
1649 # or the modules are listed in "prepare".
1650 # A multi level approach is used. prepareN is processed before prepareN-1.
1651 # archprepare is used in arch Makefiles and when processed asm symlink,
1652 # version.h and scripts_basic is processed / created.
1654 # Listed in dependency order
1655 PHONY += prepare archprepare prepare0 prepare1 prepare2 prepare3
1657 # prepare3 is used to check if we are building in a separate output directory,
1659 # 1) Check that make has not been executed in the kernel src $(srctree)
1660 prepare3: include/config/uboot.release
1661 ifneq ($(KBUILD_SRC),)
1662 @$(kecho) ' Using $(srctree) as source for U-Boot'
1663 $(Q)if [ -f $(srctree)/.config -o -d $(srctree)/include/config ]; then \
1664 echo >&2 " $(srctree) is not clean, please run 'make mrproper'"; \
1665 echo >&2 " in the '$(srctree)' directory.";\
1670 # prepare2 creates a makefile if using a separate output directory
1671 prepare2: prepare3 outputmakefile cfg
1673 prepare1: prepare2 $(version_h) $(timestamp_h) \
1674 include/config/auto.conf
1675 ifeq ($(wildcard $(LDSCRIPT)),)
1676 @echo >&2 " Could not find linker script."
1680 ifeq ($(CONFIG_USE_DEFAULT_ENV_FILE),y)
1681 prepare1: $(defaultenv_h)
1684 archprepare: prepare1 scripts_basic
1686 prepare0: archprepare FORCE
1687 $(Q)$(MAKE) $(build)=.
1689 # All the preparing..
1692 # Generate some files
1693 # ---------------------------------------------------------------------------
1695 define filechk_version.h
1696 (echo \#define PLAIN_VERSION \"$(UBOOTRELEASE)\"; \
1697 echo \#define U_BOOT_VERSION \"U-Boot \" PLAIN_VERSION; \
1698 echo \#define CC_VERSION_STRING \"$$(LC_ALL=C $(CC) --version | head -n 1)\"; \
1699 echo \#define LD_VERSION_STRING \"$$(LC_ALL=C $(LD) --version | head -n 1)\"; )
1702 # The SOURCE_DATE_EPOCH mechanism requires a date that behaves like GNU date.
1703 # The BSD date on the other hand behaves different and would produce errors
1704 # with the misused '-d' switch. Respect that and search a working date with
1705 # well known pre- and suffixes for the GNU variant of date.
1706 define filechk_timestamp.h
1707 (if test -n "$${SOURCE_DATE_EPOCH}"; then \
1708 SOURCE_DATE="@$${SOURCE_DATE_EPOCH}"; \
1710 for date in gdate date.gnu date; do \
1711 $${date} -u -d "$${SOURCE_DATE}" >/dev/null 2>&1 && DATE="$${date}"; \
1713 if test -n "$${DATE}"; then \
1714 LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_DATE "%b %d %C%y"'; \
1715 LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_TIME "%T"'; \
1716 LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_TZ "%z"'; \
1717 LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_DMI_DATE "%m/%d/%Y"'; \
1718 LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_BUILD_DATE 0x%Y%m%d'; \
1723 LC_ALL=C date +'#define U_BOOT_DATE "%b %d %C%y"'; \
1724 LC_ALL=C date +'#define U_BOOT_TIME "%T"'; \
1725 LC_ALL=C date +'#define U_BOOT_TZ "%z"'; \
1726 LC_ALL=C date +'#define U_BOOT_DMI_DATE "%m/%d/%Y"'; \
1727 LC_ALL=C date +'#define U_BOOT_BUILD_DATE 0x%Y%m%d'; \
1731 define filechk_defaultenv.h
1735 sed -e 's/\\\x0/\n/g' | \
1736 xxd -i ; echo ", 0x00" ; )
1739 $(version_h): include/config/uboot.release FORCE
1740 $(call filechk,version.h)
1742 $(timestamp_h): $(srctree)/Makefile FORCE
1743 $(call filechk,timestamp.h)
1745 $(defaultenv_h): $(CONFIG_DEFAULT_ENV_FILE:"%"=%) FORCE
1746 $(call filechk,defaultenv.h)
1748 # ---------------------------------------------------------------------------
1749 quiet_cmd_cpp_lds = LDS $@
1750 cmd_cpp_lds = $(CPP) -Wp,-MD,$(depfile) $(cpp_flags) $(LDPPFLAGS) \
1751 -D__ASSEMBLY__ -x assembler-with-cpp -std=c99 -P -o $@ $<
1753 u-boot.lds: $(LDSCRIPT) prepare FORCE
1754 $(call if_changed_dep,cpp_lds)
1756 spl/u-boot-spl.bin: spl/u-boot-spl
1760 spl/u-boot-spl: tools prepare \
1761 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_SPL_OF_PLATDATA),dts/dt.dtb) \
1762 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_TPL_OF_PLATDATA),dts/dt.dtb)
1763 $(Q)$(MAKE) obj=spl -f $(srctree)/scripts/Makefile.spl all
1765 spl/sunxi-spl.bin: spl/u-boot-spl
1768 spl/sunxi-spl-with-ecc.bin: spl/sunxi-spl.bin
1771 spl/u-boot-spl.sfp: spl/u-boot-spl
1774 spl/boot.bin: spl/u-boot-spl
1777 tpl/u-boot-tpl.bin: tools prepare \
1778 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_SPL_OF_PLATDATA),dts/dt.dtb)
1779 $(Q)$(MAKE) obj=tpl -f $(srctree)/scripts/Makefile.spl all
1781 TAG_SUBDIRS := $(patsubst %,$(srctree)/%,$(u-boot-dirs) include)
1787 ctags -w -o ctags `$(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) \
1788 -name '*.[chS]' -print`
1792 etags -a -o etags `$(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) \
1793 -name '*.[chS]' -print`
1795 $(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) -name '*.[chS]' -print > \
1801 grep -v '\(compiled\)\|\(\.o$$\)\|\( [aUw] \)\|\(\.\.ng$$\)\|\(LASH[RL]DI\)' | \
1804 @$(call SYSTEM_MAP,$<) > $@
1806 #########################################################################
1808 # ARM relocations should all be R_ARM_RELATIVE (32-bit) or
1809 # R_AARCH64_RELATIVE (64-bit).
1810 checkarmreloc: u-boot
1811 @RELOC="`$(CROSS_COMPILE)readelf -r -W $< | cut -d ' ' -f 4 | \
1812 grep R_A | sort -u`"; \
1813 if test "$$RELOC" != "R_ARM_RELATIVE" -a \
1814 "$$RELOC" != "R_AARCH64_RELATIVE"; then \
1815 echo "$< contains unexpected relocations: $$RELOC"; \
1819 envtools: scripts_basic $(version_h) $(timestamp_h)
1820 $(Q)$(MAKE) $(build)=tools/env
1822 tools-only: export TOOLS_ONLY=y
1823 tools-only: scripts_basic $(version_h) $(timestamp_h)
1824 $(Q)$(MAKE) $(build)=tools
1826 tools-all: export HOST_TOOLS_ALL=y
1827 tools-all: envtools tools ;
1829 cross_tools: export CROSS_BUILD_TOOLS=y
1830 cross_tools: tools ;
1834 git log --no-merges U-Boot-1_1_5.. | \
1835 unexpand -a | sed -e 's/\s\s*$$//' > $@
1837 #########################################################################
1840 # Cleaning is done on three levels.
1841 # make clean Delete most generated files
1842 # Leave enough to build external modules
1843 # make mrproper Delete the current configuration, and all generated files
1844 # make distclean Remove editor backup files, patch leftover files and the like
1846 # Directories & files removed with 'make clean'
1847 CLEAN_DIRS += $(MODVERDIR) \
1848 $(foreach d, spl tpl, $(patsubst %,$d/%, \
1849 $(filter-out include, $(shell ls -1 $d 2>/dev/null))))
1851 CLEAN_FILES += include/bmp_logo.h include/bmp_logo_data.h \
1852 boot* u-boot* MLO* SPL System.map fit-dtb.blob*
1854 # Directories & files removed with 'make mrproper'
1855 MRPROPER_DIRS += include/config include/generated spl tpl \
1857 MRPROPER_FILES += .config .config.old include/autoconf.mk* include/config.h \
1858 ctags etags tags TAGS cscope* GPATH GTAGS GRTAGS GSYMS \
1859 drivers/video/fonts/*.S
1861 # clean - Delete most, but leave enough to build external modules
1863 clean: rm-dirs := $(CLEAN_DIRS)
1864 clean: rm-files := $(CLEAN_FILES)
1866 clean-dirs := $(foreach f,$(u-boot-alldirs),$(if $(wildcard $(srctree)/$f/Makefile),$f))
1868 clean-dirs := $(addprefix _clean_, $(clean-dirs))
1870 PHONY += $(clean-dirs) clean archclean
1872 $(Q)$(MAKE) $(clean)=$(patsubst _clean_%,%,$@)
1874 clean: $(clean-dirs)
1877 @find $(if $(KBUILD_EXTMOD), $(KBUILD_EXTMOD), .) $(RCS_FIND_IGNORE) \
1878 \( -name '*.[oas]' -o -name '*.ko' -o -name '.*.cmd' \
1879 -o -name '*.ko.*' -o -name '*.su' -o -name '*.pyc' \
1880 -o -name '.*.d' -o -name '.*.tmp' -o -name '*.mod.c' \
1881 -o -name '*.lex.c' -o -name '*.tab.[ch]' \
1882 -o -name '*.symtypes' -o -name 'modules.order' \
1883 -o -name modules.builtin -o -name '.tmp_*.o.*' \
1884 -o -name 'dsdt.aml' -o -name 'dsdt.asl.tmp' -o -name 'dsdt.c' \
1885 -o -name '*.efi' -o -name '*.gcno' -o -name '*.so' \) \
1886 -type f -print | xargs rm -f \
1887 bl31.c bl31.elf bl31_*.bin image.map tispl.bin*
1889 # mrproper - Delete all generated files, including .config
1891 mrproper: rm-dirs := $(wildcard $(MRPROPER_DIRS))
1892 mrproper: rm-files := $(wildcard $(MRPROPER_FILES))
1893 mrproper-dirs := $(addprefix _mrproper_,scripts)
1895 PHONY += $(mrproper-dirs) mrproper archmrproper
1897 $(Q)$(MAKE) $(clean)=$(patsubst _mrproper_%,%,$@)
1899 mrproper: clean $(mrproper-dirs)
1902 @rm -f arch/*/include/asm/arch
1909 @find $(srctree) $(RCS_FIND_IGNORE) \
1910 \( -name '*.orig' -o -name '*.rej' -o -name '*~' \
1911 -o -name '*.bak' -o -name '#*#' -o -name '.*.orig' \
1912 -o -name '.*.rej' -o -name '*%' -o -name 'core' \
1913 -o -name '*.pyc' \) \
1914 -type f -print | xargs rm -f
1915 @rm -f boards.cfg CHANGELOG
1918 F=`basename $(srctree)` ; cd .. ; \
1919 gtar --force-local -zcvf `LC_ALL=C date "+$$F-%Y-%m-%d-%T.tar.gz"` $$F
1922 @echo 'Cleaning targets:'
1923 @echo ' clean - Remove most generated files but keep the config'
1924 @echo ' mrproper - Remove all generated files + config + various backup files'
1925 @echo ' distclean - mrproper + remove editor backup and patch files'
1927 @echo 'Configuration targets:'
1928 @$(MAKE) -f $(srctree)/scripts/kconfig/Makefile help
1930 @echo 'Test targets:'
1932 @echo ' check - Run all automated tests that use sandbox'
1933 @echo ' qcheck - Run quick automated tests that use sandbox'
1935 @echo 'Other generic targets:'
1936 @echo ' all - Build all necessary images depending on configuration'
1937 @echo ' tests - Build U-Boot for sandbox and run tests'
1938 @echo '* u-boot - Build the bare u-boot'
1939 @echo ' dir/ - Build all files in dir and below'
1940 @echo ' dir/file.[oisS] - Build specified target only'
1941 @echo ' dir/file.lst - Build specified mixed source/assembly target only'
1942 @echo ' (requires a recent binutils and recent build (System.map))'
1943 @echo ' tags/ctags - Generate ctags file for editors'
1944 @echo ' etags - Generate etags file for editors'
1945 @echo ' cscope - Generate cscope index'
1946 @echo ' ubootrelease - Output the release version string (use with make -s)'
1947 @echo ' ubootversion - Output the version stored in Makefile (use with make -s)'
1948 @echo " cfg - Don't build, just create the .cfg files"
1949 @echo " envtools - Build only the target-side environment tools"
1951 @echo 'Static analysers'
1952 @echo ' checkstack - Generate a list of stack hogs'
1953 @echo ' coccicheck - Execute static code analysis with Coccinelle'
1955 @echo 'Documentation targets:'
1956 @$(MAKE) -f $(srctree)/doc/Makefile dochelp
1958 @echo ' make V=0|1 [targets] 0 => quiet build (default), 1 => verbose build'
1959 @echo ' make V=2 [targets] 2 => give reason for rebuild of target'
1960 @echo ' make O=dir [targets] Locate all output files in "dir", including .config'
1961 @echo ' make C=1 [targets] Check all c source with $$CHECK (sparse by default)'
1962 @echo ' make C=2 [targets] Force check of all c source with $$CHECK'
1963 @echo ' make RECORDMCOUNT_WARN=1 [targets] Warn about ignored mcount sections'
1964 @echo ' make W=n [targets] Enable extra gcc checks, n=1,2,3 where'
1965 @echo ' 1: warnings which may be relevant and do not occur too often'
1966 @echo ' 2: warnings which occur quite often but may still be relevant'
1967 @echo ' 3: more obscure warnings, can most likely be ignored'
1968 @echo ' Multiple levels can be combined with W=12 or W=123'
1970 @echo 'Execute "make" or "make all" to build all targets marked with [*] '
1971 @echo 'For further info see the ./README file'
1977 $(srctree)/test/run quick
1979 # Documentation targets
1980 # ---------------------------------------------------------------------------
1981 DOC_TARGETS := xmldocs latexdocs pdfdocs htmldocs epubdocs cleandocs \
1982 linkcheckdocs dochelp refcheckdocs
1983 PHONY += $(DOC_TARGETS)
1984 $(DOC_TARGETS): scripts_basic FORCE
1985 $(Q)$(MAKE) $(build)=doc $@
1987 endif #ifeq ($(config-targets),1)
1988 endif #ifeq ($(mixed-targets),1)
1990 PHONY += checkstack ubootrelease ubootversion
1993 $(OBJDUMP) -d u-boot $$(find . -name u-boot-spl) | \
1994 $(PERL) $(src)/scripts/checkstack.pl $(ARCH)
1997 @echo "$(UBOOTVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))"
2000 @echo $(UBOOTVERSION)
2003 # ---------------------------------------------------------------------------
2004 # Single targets are compatible with:
2005 # - build with mixed source and output
2006 # - build with separate output dir 'make O=...'
2007 # - external modules
2009 # target-dir => where to store outputfile
2010 # build-dir => directory in kernel source tree to use
2012 ifeq ($(KBUILD_EXTMOD),)
2013 build-dir = $(patsubst %/,%,$(dir $@))
2014 target-dir = $(dir $@)
2016 zap-slash=$(filter-out .,$(patsubst %/,%,$(dir $@)))
2017 build-dir = $(KBUILD_EXTMOD)$(if $(zap-slash),/$(zap-slash))
2018 target-dir = $(if $(KBUILD_EXTMOD),$(dir $<),$(dir $@))
2021 %.s: %.c prepare scripts FORCE
2022 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2023 %.i: %.c prepare scripts FORCE
2024 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2025 %.o: %.c prepare scripts FORCE
2026 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2027 %.lst: %.c prepare scripts FORCE
2028 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2029 %.s: %.S prepare scripts FORCE
2030 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2031 %.o: %.S prepare scripts FORCE
2032 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2033 %.symtypes: %.c prepare scripts FORCE
2034 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2037 /: prepare scripts FORCE
2039 $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \
2040 $(build)=$(build-dir)
2041 %/: prepare scripts FORCE
2043 $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \
2044 $(build)=$(build-dir)
2045 %.ko: prepare scripts FORCE
2047 $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \
2048 $(build)=$(build-dir) $(@:.ko=.o)
2049 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost
2051 quiet_cmd_genenv = GENENV $@
2052 cmd_genenv = $(OBJCOPY) --dump-section .rodata.default_environment=$@ env/common.o; \
2053 sed --in-place -e 's/\x00/\x0A/g' $@
2055 u-boot-initial-env: u-boot.bin
2056 $(call if_changed,genenv)
2058 # Consistency checks
2059 # ---------------------------------------------------------------------------
2064 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/$@
2066 # FIXME Should go into a make.lib or something
2067 # ===========================================================================
2069 quiet_cmd_rmdirs = $(if $(wildcard $(rm-dirs)),CLEAN $(wildcard $(rm-dirs)))
2070 cmd_rmdirs = rm -rf $(rm-dirs)
2072 quiet_cmd_rmfiles = $(if $(wildcard $(rm-files)),CLEAN $(wildcard $(rm-files)))
2073 cmd_rmfiles = rm -f $(rm-files)
2075 # read all saved command lines
2077 targets := $(wildcard $(sort $(targets)))
2078 cmd_files := $(wildcard .*.cmd $(foreach f,$(targets),$(dir $(f)).$(notdir $(f)).cmd))
2080 ifneq ($(cmd_files),)
2081 $(cmd_files): ; # Do not try to update included dependency files
2082 include $(cmd_files)
2085 endif # skip-makefile
2090 # Declare the contents of the .PHONY variable as phony. We keep that
2091 # information in a variable so we can use it in if_changed and friends.