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 build -u -d u-boot.dtb -O . -m \
1217 -I . -I $(srctree) -I $(srctree)/board/$(BOARDDIR) \
1220 OBJCOPYFLAGS_u-boot.ldr.hex := -I binary -O ihex
1222 OBJCOPYFLAGS_u-boot.ldr.srec := -I binary -O srec
1224 u-boot.ldr.hex u-boot.ldr.srec: u-boot.ldr FORCE
1225 $(call if_changed,objcopy)
1228 # U-Boot entry point, needed for booting of full-blown U-Boot
1229 # from the SPL U-Boot version.
1231 ifndef CONFIG_SYS_UBOOT_START
1232 CONFIG_SYS_UBOOT_START := 0
1235 # Boards with more complex image requirments can provide an .its source file
1236 # or a generator script
1237 ifneq ($(CONFIG_SPL_FIT_SOURCE),"")
1238 U_BOOT_ITS = $(subst ",,$(CONFIG_SPL_FIT_SOURCE))
1240 ifneq ($(CONFIG_SPL_FIT_GENERATOR),"")
1241 U_BOOT_ITS := u-boot.its
1242 ifeq ($(CONFIG_SPL_FIT_GENERATOR),"arch/arm/mach-imx/mkimage_fit_atf.sh")
1243 U_BOOT_ITS_DEPS += u-boot-nodtb.bin
1245 ifeq ($(CONFIG_SPL_FIT_GENERATOR),"arch/arm/mach-rockchip/make_fit_atf.py")
1246 U_BOOT_ITS_DEPS += u-boot
1248 $(U_BOOT_ITS): $(U_BOOT_ITS_DEPS) FORCE
1249 $(srctree)/$(CONFIG_SPL_FIT_GENERATOR) \
1250 $(patsubst %,arch/$(ARCH)/dts/%.dtb,$(subst ",,$(CONFIG_OF_LIST))) > $@
1254 ifdef CONFIG_SPL_LOAD_FIT
1255 MKIMAGEFLAGS_u-boot.img = -f auto -A $(ARCH) -T firmware -C none -O u-boot \
1256 -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_UBOOT_START) \
1257 -n "U-Boot $(UBOOTRELEASE) for $(BOARD) board" -E \
1258 $(patsubst %,-b arch/$(ARCH)/dts/%.dtb,$(subst ",,$(CONFIG_OF_LIST)))
1260 MKIMAGEFLAGS_u-boot.img = -A $(ARCH) -T firmware -C none -O u-boot \
1261 -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_UBOOT_START) \
1262 -n "U-Boot $(UBOOTRELEASE) for $(BOARD) board"
1263 MKIMAGEFLAGS_u-boot-ivt.img = -A $(ARCH) -T firmware_ivt -C none -O u-boot \
1264 -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_UBOOT_START) \
1265 -n "U-Boot $(UBOOTRELEASE) for $(BOARD) board"
1266 u-boot-ivt.img: MKIMAGEOUTPUT = u-boot-ivt.img.log
1267 CLEAN_FILES += u-boot-ivt.img.log u-boot-dtb.imx.log SPL.log u-boot.imx.log
1270 MKIMAGEFLAGS_u-boot-dtb.img = $(MKIMAGEFLAGS_u-boot.img)
1272 MKIMAGEFLAGS_u-boot.kwb = -n $(srctree)/$(CONFIG_SYS_KWD_CONFIG:"%"=%) \
1273 -T kwbimage -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_TEXT_BASE)
1275 MKIMAGEFLAGS_u-boot-spl.kwb = -n $(srctree)/$(CONFIG_SYS_KWD_CONFIG:"%"=%) \
1276 -T kwbimage -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_TEXT_BASE) \
1277 $(if $(KEYDIR),-k $(KEYDIR))
1279 MKIMAGEFLAGS_u-boot.pbl = -n $(srctree)/$(CONFIG_SYS_FSL_PBL_RCW:"%"=%) \
1280 -R $(srctree)/$(CONFIG_SYS_FSL_PBL_PBI:"%"=%) -T pblimage
1282 ifeq ($(CONFIG_MPC85xx)$(CONFIG_OF_SEPARATE),yy)
1283 UBOOT_BIN := u-boot-with-dtb.bin
1285 UBOOT_BIN := u-boot.bin
1288 u-boot-dtb.img u-boot.img u-boot.kwb u-boot.pbl u-boot-ivt.img: \
1289 $(if $(CONFIG_SPL_LOAD_FIT),u-boot-nodtb.bin \
1290 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_OF_HOSTFILE),dts/dt.dtb) \
1291 ,$(UBOOT_BIN)) FORCE
1292 $(call if_changed,mkimage)
1295 ifeq ($(CONFIG_SPL_LOAD_FIT_FULL),y)
1296 MKIMAGEFLAGS_u-boot.itb =
1298 MKIMAGEFLAGS_u-boot.itb = -E
1301 u-boot.itb: u-boot-nodtb.bin \
1302 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_OF_HOSTFILE),dts/dt.dtb) \
1304 $(call if_changed,mkfitimage)
1307 u-boot-spl.kwb: u-boot.img spl/u-boot-spl.bin FORCE
1308 $(call if_changed,mkimage)
1310 u-boot.sha1: u-boot.bin
1311 tools/ubsha1 u-boot.bin
1314 $(OBJDUMP) -d $< > $@
1316 ifneq ($(CONFIG_SPL_PAYLOAD),)
1317 SPL_PAYLOAD := $(CONFIG_SPL_PAYLOAD:"%"=%)
1319 SPL_PAYLOAD := u-boot.bin
1322 SPL_IMAGE := $(CONFIG_SPL_IMAGE:"%"=%)
1324 OBJCOPYFLAGS_u-boot-with-spl.bin = -I binary -O binary \
1325 --pad-to=$(CONFIG_SPL_PAD_TO)
1326 u-boot-with-spl.bin: $(SPL_IMAGE) $(SPL_PAYLOAD) FORCE
1327 $(call if_changed,pad_cat)
1329 ifeq ($(CONFIG_ARCH_ROCKCHIP),y)
1330 MKIMAGEFLAGS_u-boot-tpl.img = -n $(CONFIG_SYS_SOC) -T rksd
1331 tpl/u-boot-tpl.img: tpl/u-boot-tpl.bin FORCE
1332 $(call if_changed,mkimage)
1333 idbloader.img: tpl/u-boot-tpl.img spl/u-boot-spl.bin FORCE
1334 $(call if_changed,cat)
1337 ifeq ($(CONFIG_ARCH_LPC32XX)$(CONFIG_SPL),yy)
1338 MKIMAGEFLAGS_lpc32xx-spl.img = -T lpc32xximage -a $(CONFIG_SPL_TEXT_BASE)
1340 lpc32xx-spl.img: spl/u-boot-spl.bin FORCE
1341 $(call if_changed,mkimage)
1343 OBJCOPYFLAGS_lpc32xx-boot-0.bin = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO)
1345 lpc32xx-boot-0.bin: lpc32xx-spl.img FORCE
1346 $(call if_changed,objcopy)
1348 OBJCOPYFLAGS_lpc32xx-boot-1.bin = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO)
1350 lpc32xx-boot-1.bin: lpc32xx-spl.img FORCE
1351 $(call if_changed,objcopy)
1353 lpc32xx-full.bin: lpc32xx-boot-0.bin lpc32xx-boot-1.bin u-boot.img FORCE
1354 $(call if_changed,cat)
1356 CLEAN_FILES += lpc32xx-*
1359 OBJCOPYFLAGS_u-boot-with-tpl.bin = -I binary -O binary \
1360 --pad-to=$(CONFIG_TPL_PAD_TO)
1361 tpl/u-boot-with-tpl.bin: tpl/u-boot-tpl.bin u-boot.bin FORCE
1362 $(call if_changed,pad_cat)
1364 SPL: spl/u-boot-spl.bin FORCE
1365 $(Q)$(MAKE) $(build)=arch/arm/mach-imx $@
1367 ifeq ($(CONFIG_ARCH_IMX8M)$(CONFIG_ARCH_IMX8), y)
1368 flash.bin: spl/u-boot-spl.bin u-boot.itb FORCE
1369 $(Q)$(MAKE) $(build)=arch/arm/mach-imx $@
1372 u-boot-with-spl.imx u-boot-with-nand-spl.imx: SPL u-boot.bin FORCE
1373 $(Q)$(MAKE) $(build)=arch/arm/mach-imx $@
1375 MKIMAGEFLAGS_u-boot.ubl = -n $(UBL_CONFIG) -T ublimage -e $(CONFIG_SYS_TEXT_BASE)
1377 u-boot.ubl: u-boot-with-spl.bin FORCE
1378 $(call if_changed,mkimage)
1380 MKIMAGEFLAGS_u-boot-spl.ais = -s -n $(if $(CONFIG_AIS_CONFIG_FILE), \
1381 $(srctree)/$(CONFIG_AIS_CONFIG_FILE:"%"=%),"/dev/null") \
1382 -T aisimage -e $(CONFIG_SPL_TEXT_BASE)
1383 spl/u-boot-spl.ais: spl/u-boot-spl.bin FORCE
1384 $(call if_changed,mkimage)
1386 OBJCOPYFLAGS_u-boot.ais = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO)
1387 u-boot.ais: spl/u-boot-spl.ais u-boot.img FORCE
1388 $(call if_changed,pad_cat)
1390 u-boot-signed.sb: u-boot.bin spl/u-boot-spl.bin
1391 $(Q)$(MAKE) $(build)=arch/arm/cpu/arm926ejs/mxs u-boot-signed.sb
1392 u-boot.sb: u-boot.bin spl/u-boot-spl.bin
1393 $(Q)$(MAKE) $(build)=arch/arm/cpu/arm926ejs/mxs u-boot.sb
1395 # On x600 (SPEAr600) U-Boot is appended to U-Boot SPL.
1396 # Both images are created using mkimage (crc etc), so that the ROM
1397 # bootloader can check its integrity. Padding needs to be done to the
1398 # SPL image (with mkimage header) and not the binary. Otherwise the resulting image
1399 # which is loaded/copied by the ROM bootloader to SRAM doesn't fit.
1400 # The resulting image containing both U-Boot images is called u-boot.spr
1401 MKIMAGEFLAGS_u-boot-spl.img = -A $(ARCH) -T firmware -C none \
1402 -a $(CONFIG_SPL_TEXT_BASE) -e $(CONFIG_SPL_TEXT_BASE) -n XLOADER
1403 spl/u-boot-spl.img: spl/u-boot-spl.bin FORCE
1404 $(call if_changed,mkimage)
1406 OBJCOPYFLAGS_u-boot.spr = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO) \
1408 u-boot.spr: spl/u-boot-spl.img u-boot.img FORCE
1409 $(call if_changed,pad_cat)
1411 ifneq ($(CONFIG_ARCH_SOCFPGA),)
1412 quiet_cmd_socboot = SOCBOOT $@
1413 cmd_socboot = cat spl/u-boot-spl.sfp spl/u-boot-spl.sfp \
1414 spl/u-boot-spl.sfp spl/u-boot-spl.sfp \
1415 u-boot.img > $@ || rm -f $@
1416 u-boot-with-spl.sfp: spl/u-boot-spl.sfp u-boot.img FORCE
1417 $(call if_changed,socboot)
1420 ifeq ($(CONFIG_MPC85xx)$(CONFIG_OF_SEPARATE),yy)
1421 u-boot-with-dtb.bin: u-boot.bin u-boot.dtb \
1422 $(if $(CONFIG_MPC85XX_HAVE_RESET_VECTOR), u-boot-br.bin) FORCE
1423 $(call if_changed,binman)
1425 ifeq ($(CONFIG_MPC85XX_HAVE_RESET_VECTOR),y)
1426 OBJCOPYFLAGS_u-boot-br.bin := -O binary -j .bootpg -j .resetvec
1427 u-boot-br.bin: u-boot FORCE
1428 $(call if_changed,objcopy)
1432 # x86 uses a large ROM. We fill it with 0xff, put the 16-bit stuff (including
1433 # reset vector) at the top, Intel ME descriptor at the bottom, and U-Boot in
1434 # the middle. This is handled by binman based on an image description in the
1435 # board's device tree.
1436 ifneq ($(CONFIG_X86_RESET_VECTOR),)
1437 rom: u-boot.rom FORCE
1439 refcode.bin: $(srctree)/board/$(BOARDDIR)/refcode.bin FORCE
1440 $(call if_changed,copy)
1442 quiet_cmd_ldr = LD $@
1443 cmd_ldr = $(LD) $(LDFLAGS_$(@F)) \
1444 $(filter-out FORCE,$^) -o $@
1446 u-boot.rom: u-boot-x86-16bit.bin u-boot.bin \
1447 $(if $(CONFIG_SPL_X86_16BIT_INIT),spl/u-boot-spl.bin) \
1448 $(if $(CONFIG_TPL_X86_16BIT_INIT),tpl/u-boot-tpl.bin) \
1449 $(if $(CONFIG_HAVE_REFCODE),refcode.bin) FORCE
1450 $(call if_changed,binman)
1452 OBJCOPYFLAGS_u-boot-x86-16bit.bin := -O binary -j .start16 -j .resetvec
1453 u-boot-x86-16bit.bin: u-boot FORCE
1454 $(call if_changed,objcopy)
1457 ifneq ($(CONFIG_ARCH_SUNXI),)
1458 ifeq ($(CONFIG_ARM64),)
1459 u-boot-sunxi-with-spl.bin: spl/sunxi-spl.bin u-boot.img u-boot.dtb FORCE
1460 $(call if_changed,binman)
1462 u-boot-sunxi-with-spl.bin: spl/sunxi-spl.bin u-boot.itb FORCE
1463 $(call if_changed,cat)
1467 ifneq ($(CONFIG_TEGRA),)
1468 ifneq ($(CONFIG_BINMAN),)
1469 # Makes u-boot-dtb-tegra.bin u-boot-tegra.bin u-boot-nodtb-tegra.bin
1470 %-dtb-tegra.bin %-tegra.bin %-nodtb-tegra.bin: \
1471 spl/%-spl %.bin FORCE
1472 $(call if_changed,binman)
1474 OBJCOPYFLAGS_u-boot-nodtb-tegra.bin = -O binary --pad-to=$(CONFIG_SYS_TEXT_BASE)
1475 u-boot-nodtb-tegra.bin: spl/u-boot-spl u-boot-nodtb.bin FORCE
1476 $(call if_changed,pad_cat)
1478 OBJCOPYFLAGS_u-boot-tegra.bin = -O binary --pad-to=$(CONFIG_SYS_TEXT_BASE)
1479 u-boot-tegra.bin: spl/u-boot-spl u-boot.bin FORCE
1480 $(call if_changed,pad_cat)
1482 u-boot-dtb-tegra.bin: u-boot-tegra.bin FORCE
1483 $(call if_changed,copy)
1487 OBJCOPYFLAGS_u-boot-app.efi := $(OBJCOPYFLAGS_EFI)
1488 u-boot-app.efi: u-boot FORCE
1489 $(call if_changed,zobjcopy)
1491 u-boot.bin.o: u-boot.bin FORCE
1492 $(call if_changed,efipayload)
1494 u-boot-payload.lds: $(LDSCRIPT_EFI) FORCE
1495 $(call if_changed_dep,cpp_lds)
1497 # Rule to link the EFI payload which contains a stub and a U-Boot binary
1498 quiet_cmd_u-boot_payload ?= LD $@
1499 cmd_u-boot_payload ?= $(LD) $(LDFLAGS_EFI_PAYLOAD) -o $@ \
1500 -T u-boot-payload.lds arch/x86/cpu/call32.o \
1501 lib/efi/efi.o lib/efi/efi_stub.o u-boot.bin.o \
1502 $(addprefix arch/$(ARCH)/lib/,$(EFISTUB))
1504 u-boot-payload: u-boot.bin.o u-boot-payload.lds FORCE
1505 $(call if_changed,u-boot_payload)
1507 OBJCOPYFLAGS_u-boot-payload.efi := $(OBJCOPYFLAGS_EFI)
1508 u-boot-payload.efi: u-boot-payload FORCE
1509 $(call if_changed,zobjcopy)
1511 u-boot-img.bin: spl/u-boot-spl.bin u-boot.img FORCE
1512 $(call if_changed,cat)
1514 #Add a target to create boot binary having SPL binary in PBI format
1515 #concatenated with u-boot binary. It is need by PowerPC SoC having
1516 #internal SRAM <= 512KB.
1517 MKIMAGEFLAGS_u-boot-spl.pbl = -n $(srctree)/$(CONFIG_SYS_FSL_PBL_RCW:"%"=%) \
1518 -R $(srctree)/$(CONFIG_SYS_FSL_PBL_PBI:"%"=%) -T pblimage \
1519 -A $(ARCH) -a $(CONFIG_SPL_TEXT_BASE)
1521 spl/u-boot-spl.pbl: spl/u-boot-spl.bin FORCE
1522 $(call if_changed,mkimage)
1525 UBOOT_BINLOAD := u-boot.img
1527 ifeq ($(CONFIG_MPC85xx)$(CONFIG_OF_SEPARATE),yy)
1528 UBOOT_BINLOAD := u-boot-with-dtb.bin
1530 UBOOT_BINLOAD := u-boot.bin
1534 OBJCOPYFLAGS_u-boot-with-spl-pbl.bin = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO) \
1537 u-boot-with-spl-pbl.bin: spl/u-boot-spl.pbl $(UBOOT_BINLOAD) FORCE
1538 $(call if_changed,pad_cat)
1540 # PPC4xx needs the SPL at the end of the image, since the reset vector
1541 # is located at 0xfffffffc. So we can't use the "u-boot-img.bin" target
1542 # and need to introduce a new build target with the full blown U-Boot
1543 # at the start padded up to the start of the SPL image. And then concat
1544 # the SPL image to the end.
1546 OBJCOPYFLAGS_u-boot-img-spl-at-end.bin := -I binary -O binary \
1547 --pad-to=$(CONFIG_UBOOT_PAD_TO) --gap-fill=0xff
1548 u-boot-img-spl-at-end.bin: u-boot.img spl/u-boot-spl.bin FORCE
1549 $(call if_changed,pad_cat)
1551 # Create a new ELF from a raw binary file.
1552 ifndef PLATFORM_ELFENTRY
1553 PLATFORM_ELFENTRY = "_start"
1555 quiet_cmd_u-boot-elf ?= LD $@
1556 cmd_u-boot-elf ?= $(LD) u-boot-elf.o -o $@ \
1557 --defsym=$(PLATFORM_ELFENTRY)=$(CONFIG_SYS_TEXT_BASE) \
1558 -Ttext=$(CONFIG_SYS_TEXT_BASE)
1559 u-boot.elf: u-boot.bin
1560 $(Q)$(OBJCOPY) -I binary $(PLATFORM_ELFFLAGS) $< u-boot-elf.o
1561 $(call if_changed,u-boot-elf)
1563 # MediaTek's ARM-based u-boot needs a header to contains its load address
1564 # which is parsed by the BootROM.
1565 # If the SPL build is enabled, the header will be added to the spl binary,
1566 # and the spl binary and the u-boot.img will be combined into one file.
1567 # Otherwise the header will be added to the u-boot.bin directly.
1569 ifeq ($(CONFIG_SPL),y)
1570 spl/u-boot-spl-mtk.bin: spl/u-boot-spl
1572 u-boot-mtk.bin: u-boot.dtb u-boot.img spl/u-boot-spl-mtk.bin FORCE
1573 $(call if_changed,binman)
1575 MKIMAGEFLAGS_u-boot-mtk.bin = -T mtk_image \
1576 -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_TEXT_BASE) \
1577 -n "$(patsubst "%",%,$(CONFIG_MTK_BROM_HEADER_INFO))"
1579 u-boot-mtk.bin: u-boot.bin FORCE
1580 $(call if_changed,mkimage)
1583 ARCH_POSTLINK := $(wildcard $(srctree)/arch/$(ARCH)/Makefile.postlink)
1585 # Rule to link u-boot
1586 # May be overridden by arch/$(ARCH)/config.mk
1587 quiet_cmd_u-boot__ ?= LD $@
1588 cmd_u-boot__ ?= $(LD) $(LDFLAGS) $(LDFLAGS_u-boot) -o $@ \
1589 -T u-boot.lds $(u-boot-init) \
1590 --start-group $(u-boot-main) --end-group \
1591 $(PLATFORM_LIBS) -Map u-boot.map; \
1592 $(if $(ARCH_POSTLINK), $(MAKE) -f $(ARCH_POSTLINK) $@, true)
1594 quiet_cmd_smap = GEN common/system_map.o
1596 smap=`$(call SYSTEM_MAP,u-boot) | \
1597 awk '$$2 ~ /[tTwW]/ {printf $$1 $$3 "\\\\000"}'` ; \
1598 $(CC) $(c_flags) -DSYSTEM_MAP="\"$${smap}\"" \
1599 -c $(srctree)/common/system_map.c -o common/system_map.o
1601 u-boot: $(u-boot-init) $(u-boot-main) u-boot.lds FORCE
1602 +$(call if_changed,u-boot__)
1603 ifeq ($(CONFIG_KALLSYMS),y)
1605 $(call cmd,u-boot__) common/system_map.o
1608 ifeq ($(CONFIG_RISCV),y)
1609 @tools/prelink-riscv $@ 0
1612 quiet_cmd_sym ?= SYM $@
1613 cmd_sym ?= $(OBJDUMP) -t $< > $@
1614 u-boot.sym: u-boot FORCE
1615 $(call if_changed,sym)
1617 # The actual objects are generated when descending,
1618 # make sure no implicit rule kicks in
1619 $(sort $(u-boot-init) $(u-boot-main)): $(u-boot-dirs) ;
1621 # Handle descending into subdirectories listed in $(vmlinux-dirs)
1622 # Preset locale variables to speed up the build process. Limit locale
1623 # tweaks to this spot to avoid wrong language settings when running
1624 # make menuconfig etc.
1625 # Error messages still appears in the original language
1627 PHONY += $(u-boot-dirs)
1628 $(u-boot-dirs): prepare scripts
1629 $(Q)$(MAKE) $(build)=$@
1632 # The "tools" are needed early
1633 $(filter-out tools, $(u-boot-dirs)): tools
1634 # The "examples" conditionally depend on U-Boot (say, when USE_PRIVATE_LIBGCC
1635 # is "yes"), so compile examples after U-Boot is compiled.
1636 examples: $(filter-out examples, $(u-boot-dirs))
1638 define filechk_uboot.release
1639 echo "$(UBOOTVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))"
1642 # Store (new) UBOOTRELEASE string in include/config/uboot.release
1643 include/config/uboot.release: include/config/auto.conf FORCE
1644 $(call filechk,uboot.release)
1647 # Things we need to do before we recursively start building the kernel
1648 # or the modules are listed in "prepare".
1649 # A multi level approach is used. prepareN is processed before prepareN-1.
1650 # archprepare is used in arch Makefiles and when processed asm symlink,
1651 # version.h and scripts_basic is processed / created.
1653 # Listed in dependency order
1654 PHONY += prepare archprepare prepare0 prepare1 prepare2 prepare3
1656 # prepare3 is used to check if we are building in a separate output directory,
1658 # 1) Check that make has not been executed in the kernel src $(srctree)
1659 prepare3: include/config/uboot.release
1660 ifneq ($(KBUILD_SRC),)
1661 @$(kecho) ' Using $(srctree) as source for U-Boot'
1662 $(Q)if [ -f $(srctree)/.config -o -d $(srctree)/include/config ]; then \
1663 echo >&2 " $(srctree) is not clean, please run 'make mrproper'"; \
1664 echo >&2 " in the '$(srctree)' directory.";\
1669 # prepare2 creates a makefile if using a separate output directory
1670 prepare2: prepare3 outputmakefile cfg
1672 prepare1: prepare2 $(version_h) $(timestamp_h) \
1673 include/config/auto.conf
1674 ifeq ($(wildcard $(LDSCRIPT)),)
1675 @echo >&2 " Could not find linker script."
1679 ifeq ($(CONFIG_USE_DEFAULT_ENV_FILE),y)
1680 prepare1: $(defaultenv_h)
1683 archprepare: prepare1 scripts_basic
1685 prepare0: archprepare FORCE
1686 $(Q)$(MAKE) $(build)=.
1688 # All the preparing..
1691 # Generate some files
1692 # ---------------------------------------------------------------------------
1694 define filechk_version.h
1695 (echo \#define PLAIN_VERSION \"$(UBOOTRELEASE)\"; \
1696 echo \#define U_BOOT_VERSION \"U-Boot \" PLAIN_VERSION; \
1697 echo \#define CC_VERSION_STRING \"$$(LC_ALL=C $(CC) --version | head -n 1)\"; \
1698 echo \#define LD_VERSION_STRING \"$$(LC_ALL=C $(LD) --version | head -n 1)\"; )
1701 # The SOURCE_DATE_EPOCH mechanism requires a date that behaves like GNU date.
1702 # The BSD date on the other hand behaves different and would produce errors
1703 # with the misused '-d' switch. Respect that and search a working date with
1704 # well known pre- and suffixes for the GNU variant of date.
1705 define filechk_timestamp.h
1706 (if test -n "$${SOURCE_DATE_EPOCH}"; then \
1707 SOURCE_DATE="@$${SOURCE_DATE_EPOCH}"; \
1709 for date in gdate date.gnu date; do \
1710 $${date} -u -d "$${SOURCE_DATE}" >/dev/null 2>&1 && DATE="$${date}"; \
1712 if test -n "$${DATE}"; then \
1713 LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_DATE "%b %d %C%y"'; \
1714 LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_TIME "%T"'; \
1715 LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_TZ "%z"'; \
1716 LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_DMI_DATE "%m/%d/%Y"'; \
1717 LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_BUILD_DATE 0x%Y%m%d'; \
1722 LC_ALL=C date +'#define U_BOOT_DATE "%b %d %C%y"'; \
1723 LC_ALL=C date +'#define U_BOOT_TIME "%T"'; \
1724 LC_ALL=C date +'#define U_BOOT_TZ "%z"'; \
1725 LC_ALL=C date +'#define U_BOOT_DMI_DATE "%m/%d/%Y"'; \
1726 LC_ALL=C date +'#define U_BOOT_BUILD_DATE 0x%Y%m%d'; \
1730 define filechk_defaultenv.h
1734 sed -e 's/\\\x0/\n/g' | \
1735 xxd -i ; echo ", 0x00" ; )
1738 $(version_h): include/config/uboot.release FORCE
1739 $(call filechk,version.h)
1741 $(timestamp_h): $(srctree)/Makefile FORCE
1742 $(call filechk,timestamp.h)
1744 $(defaultenv_h): $(CONFIG_DEFAULT_ENV_FILE:"%"=%) FORCE
1745 $(call filechk,defaultenv.h)
1747 # ---------------------------------------------------------------------------
1748 quiet_cmd_cpp_lds = LDS $@
1749 cmd_cpp_lds = $(CPP) -Wp,-MD,$(depfile) $(cpp_flags) $(LDPPFLAGS) \
1750 -D__ASSEMBLY__ -x assembler-with-cpp -std=c99 -P -o $@ $<
1752 u-boot.lds: $(LDSCRIPT) prepare FORCE
1753 $(call if_changed_dep,cpp_lds)
1755 spl/u-boot-spl.bin: spl/u-boot-spl
1759 spl/u-boot-spl: tools prepare \
1760 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_SPL_OF_PLATDATA),dts/dt.dtb) \
1761 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_TPL_OF_PLATDATA),dts/dt.dtb)
1762 $(Q)$(MAKE) obj=spl -f $(srctree)/scripts/Makefile.spl all
1764 spl/sunxi-spl.bin: spl/u-boot-spl
1767 spl/sunxi-spl-with-ecc.bin: spl/sunxi-spl.bin
1770 spl/u-boot-spl.sfp: spl/u-boot-spl
1773 spl/boot.bin: spl/u-boot-spl
1776 tpl/u-boot-tpl.bin: tools prepare \
1777 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_SPL_OF_PLATDATA),dts/dt.dtb)
1778 $(Q)$(MAKE) obj=tpl -f $(srctree)/scripts/Makefile.spl all
1780 TAG_SUBDIRS := $(patsubst %,$(srctree)/%,$(u-boot-dirs) include)
1786 ctags -w -o ctags `$(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) \
1787 -name '*.[chS]' -print`
1791 etags -a -o etags `$(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) \
1792 -name '*.[chS]' -print`
1794 $(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) -name '*.[chS]' -print > \
1800 grep -v '\(compiled\)\|\(\.o$$\)\|\( [aUw] \)\|\(\.\.ng$$\)\|\(LASH[RL]DI\)' | \
1803 @$(call SYSTEM_MAP,$<) > $@
1805 #########################################################################
1807 # ARM relocations should all be R_ARM_RELATIVE (32-bit) or
1808 # R_AARCH64_RELATIVE (64-bit).
1809 checkarmreloc: u-boot
1810 @RELOC="`$(CROSS_COMPILE)readelf -r -W $< | cut -d ' ' -f 4 | \
1811 grep R_A | sort -u`"; \
1812 if test "$$RELOC" != "R_ARM_RELATIVE" -a \
1813 "$$RELOC" != "R_AARCH64_RELATIVE"; then \
1814 echo "$< contains unexpected relocations: $$RELOC"; \
1818 envtools: scripts_basic $(version_h) $(timestamp_h)
1819 $(Q)$(MAKE) $(build)=tools/env
1821 tools-only: export TOOLS_ONLY=y
1822 tools-only: scripts_basic $(version_h) $(timestamp_h)
1823 $(Q)$(MAKE) $(build)=tools
1825 tools-all: export HOST_TOOLS_ALL=y
1826 tools-all: envtools tools ;
1828 cross_tools: export CROSS_BUILD_TOOLS=y
1829 cross_tools: tools ;
1833 git log --no-merges U-Boot-1_1_5.. | \
1834 unexpand -a | sed -e 's/\s\s*$$//' > $@
1836 #########################################################################
1839 # Cleaning is done on three levels.
1840 # make clean Delete most generated files
1841 # Leave enough to build external modules
1842 # make mrproper Delete the current configuration, and all generated files
1843 # make distclean Remove editor backup files, patch leftover files and the like
1845 # Directories & files removed with 'make clean'
1846 CLEAN_DIRS += $(MODVERDIR) \
1847 $(foreach d, spl tpl, $(patsubst %,$d/%, \
1848 $(filter-out include, $(shell ls -1 $d 2>/dev/null))))
1850 CLEAN_FILES += include/bmp_logo.h include/bmp_logo_data.h \
1851 boot* u-boot* MLO* SPL System.map fit-dtb.blob*
1853 # Directories & files removed with 'make mrproper'
1854 MRPROPER_DIRS += include/config include/generated spl tpl \
1856 MRPROPER_FILES += .config .config.old include/autoconf.mk* include/config.h \
1857 ctags etags tags TAGS cscope* GPATH GTAGS GRTAGS GSYMS \
1858 drivers/video/fonts/*.S
1860 # clean - Delete most, but leave enough to build external modules
1862 clean: rm-dirs := $(CLEAN_DIRS)
1863 clean: rm-files := $(CLEAN_FILES)
1865 clean-dirs := $(foreach f,$(u-boot-alldirs),$(if $(wildcard $(srctree)/$f/Makefile),$f))
1867 clean-dirs := $(addprefix _clean_, $(clean-dirs))
1869 PHONY += $(clean-dirs) clean archclean
1871 $(Q)$(MAKE) $(clean)=$(patsubst _clean_%,%,$@)
1873 clean: $(clean-dirs)
1876 @find $(if $(KBUILD_EXTMOD), $(KBUILD_EXTMOD), .) $(RCS_FIND_IGNORE) \
1877 \( -name '*.[oas]' -o -name '*.ko' -o -name '.*.cmd' \
1878 -o -name '*.ko.*' -o -name '*.su' \
1879 -o -name '.*.d' -o -name '.*.tmp' -o -name '*.mod.c' \
1880 -o -name '*.lex.c' -o -name '*.tab.[ch]' \
1881 -o -name '*.symtypes' -o -name 'modules.order' \
1882 -o -name modules.builtin -o -name '.tmp_*.o.*' \
1883 -o -name 'dsdt.aml' -o -name 'dsdt.asl.tmp' -o -name 'dsdt.c' \
1884 -o -name '*.efi' -o -name '*.gcno' -o -name '*.so' \) \
1885 -type f -print | xargs rm -f \
1886 bl31.c bl31.elf bl31_*.bin image.map tispl.bin*
1888 # mrproper - Delete all generated files, including .config
1890 mrproper: rm-dirs := $(wildcard $(MRPROPER_DIRS))
1891 mrproper: rm-files := $(wildcard $(MRPROPER_FILES))
1892 mrproper-dirs := $(addprefix _mrproper_,scripts)
1894 PHONY += $(mrproper-dirs) mrproper archmrproper
1896 $(Q)$(MAKE) $(clean)=$(patsubst _mrproper_%,%,$@)
1898 mrproper: clean $(mrproper-dirs)
1901 @rm -f arch/*/include/asm/arch
1908 @find $(srctree) $(RCS_FIND_IGNORE) \
1909 \( -name '*.orig' -o -name '*.rej' -o -name '*~' \
1910 -o -name '*.bak' -o -name '#*#' -o -name '.*.orig' \
1911 -o -name '.*.rej' -o -name '*%' -o -name 'core' \
1912 -o -name '*.pyc' \) \
1913 -type f -print | xargs rm -f
1914 @rm -f boards.cfg CHANGELOG
1917 F=`basename $(srctree)` ; cd .. ; \
1918 gtar --force-local -zcvf `LC_ALL=C date "+$$F-%Y-%m-%d-%T.tar.gz"` $$F
1921 @echo 'Cleaning targets:'
1922 @echo ' clean - Remove most generated files but keep the config'
1923 @echo ' mrproper - Remove all generated files + config + various backup files'
1924 @echo ' distclean - mrproper + remove editor backup and patch files'
1926 @echo 'Configuration targets:'
1927 @$(MAKE) -f $(srctree)/scripts/kconfig/Makefile help
1929 @echo 'Test targets:'
1931 @echo ' check - Run all automated tests that use sandbox'
1932 @echo ' qcheck - Run quick automated tests that use sandbox'
1934 @echo 'Other generic targets:'
1935 @echo ' all - Build all necessary images depending on configuration'
1936 @echo ' tests - Build U-Boot for sandbox and run tests'
1937 @echo '* u-boot - Build the bare u-boot'
1938 @echo ' dir/ - Build all files in dir and below'
1939 @echo ' dir/file.[oisS] - Build specified target only'
1940 @echo ' dir/file.lst - Build specified mixed source/assembly target only'
1941 @echo ' (requires a recent binutils and recent build (System.map))'
1942 @echo ' tags/ctags - Generate ctags file for editors'
1943 @echo ' etags - Generate etags file for editors'
1944 @echo ' cscope - Generate cscope index'
1945 @echo ' ubootrelease - Output the release version string (use with make -s)'
1946 @echo ' ubootversion - Output the version stored in Makefile (use with make -s)'
1947 @echo " cfg - Don't build, just create the .cfg files"
1948 @echo " envtools - Build only the target-side environment tools"
1950 @echo 'Static analysers'
1951 @echo ' checkstack - Generate a list of stack hogs'
1952 @echo ' coccicheck - Execute static code analysis with Coccinelle'
1954 @echo 'Documentation targets:'
1955 @$(MAKE) -f $(srctree)/doc/Makefile dochelp
1957 @echo ' make V=0|1 [targets] 0 => quiet build (default), 1 => verbose build'
1958 @echo ' make V=2 [targets] 2 => give reason for rebuild of target'
1959 @echo ' make O=dir [targets] Locate all output files in "dir", including .config'
1960 @echo ' make C=1 [targets] Check all c source with $$CHECK (sparse by default)'
1961 @echo ' make C=2 [targets] Force check of all c source with $$CHECK'
1962 @echo ' make RECORDMCOUNT_WARN=1 [targets] Warn about ignored mcount sections'
1963 @echo ' make W=n [targets] Enable extra gcc checks, n=1,2,3 where'
1964 @echo ' 1: warnings which may be relevant and do not occur too often'
1965 @echo ' 2: warnings which occur quite often but may still be relevant'
1966 @echo ' 3: more obscure warnings, can most likely be ignored'
1967 @echo ' Multiple levels can be combined with W=12 or W=123'
1969 @echo 'Execute "make" or "make all" to build all targets marked with [*] '
1970 @echo 'For further info see the ./README file'
1976 $(srctree)/test/run quick
1978 # Documentation targets
1979 # ---------------------------------------------------------------------------
1980 DOC_TARGETS := xmldocs latexdocs pdfdocs htmldocs epubdocs cleandocs \
1981 linkcheckdocs dochelp refcheckdocs
1982 PHONY += $(DOC_TARGETS)
1983 $(DOC_TARGETS): scripts_basic FORCE
1984 $(Q)$(MAKE) $(build)=doc $@
1986 endif #ifeq ($(config-targets),1)
1987 endif #ifeq ($(mixed-targets),1)
1989 PHONY += checkstack ubootrelease ubootversion
1992 $(OBJDUMP) -d u-boot $$(find . -name u-boot-spl) | \
1993 $(PERL) $(src)/scripts/checkstack.pl $(ARCH)
1996 @echo "$(UBOOTVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))"
1999 @echo $(UBOOTVERSION)
2002 # ---------------------------------------------------------------------------
2003 # Single targets are compatible with:
2004 # - build with mixed source and output
2005 # - build with separate output dir 'make O=...'
2006 # - external modules
2008 # target-dir => where to store outputfile
2009 # build-dir => directory in kernel source tree to use
2011 ifeq ($(KBUILD_EXTMOD),)
2012 build-dir = $(patsubst %/,%,$(dir $@))
2013 target-dir = $(dir $@)
2015 zap-slash=$(filter-out .,$(patsubst %/,%,$(dir $@)))
2016 build-dir = $(KBUILD_EXTMOD)$(if $(zap-slash),/$(zap-slash))
2017 target-dir = $(if $(KBUILD_EXTMOD),$(dir $<),$(dir $@))
2020 %.s: %.c prepare scripts FORCE
2021 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2022 %.i: %.c prepare scripts FORCE
2023 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2024 %.o: %.c prepare scripts FORCE
2025 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2026 %.lst: %.c prepare scripts FORCE
2027 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2028 %.s: %.S prepare scripts FORCE
2029 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2030 %.o: %.S prepare scripts FORCE
2031 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2032 %.symtypes: %.c prepare scripts FORCE
2033 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2036 /: prepare scripts FORCE
2038 $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \
2039 $(build)=$(build-dir)
2040 %/: prepare scripts FORCE
2042 $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \
2043 $(build)=$(build-dir)
2044 %.ko: prepare scripts FORCE
2046 $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \
2047 $(build)=$(build-dir) $(@:.ko=.o)
2048 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost
2050 quiet_cmd_genenv = GENENV $@
2051 cmd_genenv = $(OBJCOPY) --dump-section .rodata.default_environment=$@ env/common.o; \
2052 sed --in-place -e 's/\x00/\x0A/g' $@
2054 u-boot-initial-env: u-boot.bin
2055 $(call if_changed,genenv)
2057 # Consistency checks
2058 # ---------------------------------------------------------------------------
2063 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/$@
2065 # FIXME Should go into a make.lib or something
2066 # ===========================================================================
2068 quiet_cmd_rmdirs = $(if $(wildcard $(rm-dirs)),CLEAN $(wildcard $(rm-dirs)))
2069 cmd_rmdirs = rm -rf $(rm-dirs)
2071 quiet_cmd_rmfiles = $(if $(wildcard $(rm-files)),CLEAN $(wildcard $(rm-files)))
2072 cmd_rmfiles = rm -f $(rm-files)
2074 # read all saved command lines
2076 targets := $(wildcard $(sort $(targets)))
2077 cmd_files := $(wildcard .*.cmd $(foreach f,$(targets),$(dir $(f)).$(notdir $(f)).cmd))
2079 ifneq ($(cmd_files),)
2080 $(cmd_files): ; # Do not try to update included dependency files
2081 include $(cmd_files)
2084 endif # skip-makefile
2089 # Declare the contents of the .PHONY variable as phony. We keep that
2090 # information in a variable so we can use it in if_changed and friends.