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 ifeq ($(CONFIG_MMC),y)
944 ifneq ($(CONFIG_DM_MMC)$(CONFIG_OF_CONTROL)$(CONFIG_BLK),yyy)
945 @echo >&2 "===================== WARNING ======================"
946 @echo >&2 "This board does not use CONFIG_DM_MMC. Please update"
947 @echo >&2 "the board to use CONFIG_DM_MMC before the v2019.04 release."
948 @echo >&2 "Failure to update by the deadline may result in board removal."
949 @echo >&2 "See doc/driver-model/MIGRATION.txt for more info."
950 @echo >&2 "===================================================="
953 ifeq ($(CONFIG_USB),y)
954 ifneq ($(CONFIG_DM_USB)$(CONFIG_OF_CONTROL)$(CONFIG_BLK),yyy)
955 @echo >&2 "===================== WARNING ======================"
956 @echo >&2 "This board does not use CONFIG_DM_USB. Please update"
957 @echo >&2 "the board to use CONFIG_DM_USB before the v2019.07 release."
958 @echo >&2 "Failure to update by the deadline may result in board removal."
959 @echo >&2 "See doc/driver-model/MIGRATION.txt for more info."
960 @echo >&2 "===================================================="
963 ifeq ($(CONFIG_MVSATA_IDE),y)
964 @echo >&2 "===================== WARNING ======================"
965 @echo >&2 "This board does use CONFIG_MVSATA_IDE which is not"
966 @echo >&2 "ported to driver-model (DM) yet. Please update the storage"
967 @echo >&2 "controller driver to use CONFIG_AHCI before the v2019.07"
969 @echo >&2 "Failure to update by the deadline may result in board removal."
970 @echo >&2 "See doc/driver-model/MIGRATION.txt for more info."
971 @echo >&2 "===================================================="
973 ifeq ($(CONFIG_LIBATA),y)
974 ifneq ($(CONFIG_AHCI),y)
975 @echo >&2 "===================== WARNING ======================"
976 @echo >&2 "This board does use CONFIG_LIBATA but has CONFIG_AHCI not"
977 @echo >&2 "enabled. Please update the storage controller driver to use"
978 @echo >&2 "CONFIG_AHCI before the v2019.07 release."
979 @echo >&2 "Failure to update by the deadline may result in board removal."
980 @echo >&2 "See doc/driver-model/MIGRATION.txt for more info."
981 @echo >&2 "===================================================="
984 ifeq ($(CONFIG_PCI),y)
985 ifneq ($(CONFIG_DM_PCI),y)
986 @echo >&2 "===================== WARNING ======================"
987 @echo >&2 "This board does not use CONFIG_DM_PCI Please update"
988 @echo >&2 "the board to use CONFIG_DM_PCI before the v2019.07 release."
989 @echo >&2 "Failure to update by the deadline may result in board removal."
990 @echo >&2 "See doc/driver-model/MIGRATION.txt for more info."
991 @echo >&2 "===================================================="
994 ifneq ($(CONFIG_LCD)$(CONFIG_VIDEO),)
995 ifneq ($(CONFIG_DM_VIDEO),y)
996 @echo >&2 "===================== WARNING ======================"
997 @echo >&2 "This board does not use CONFIG_DM_VIDEO Please update"
998 @echo >&2 "the board to use CONFIG_DM_VIDEO before the v2019.07 release."
999 @echo >&2 "Failure to update by the deadline may result in board removal."
1000 @echo >&2 "See doc/driver-model/MIGRATION.txt for more info."
1001 @echo >&2 "===================================================="
1004 ifeq ($(CONFIG_OF_EMBED),y)
1005 @echo >&2 "===================== WARNING ======================"
1006 @echo >&2 "CONFIG_OF_EMBED is enabled. This option should only"
1007 @echo >&2 "be used for debugging purposes. Please use"
1008 @echo >&2 "CONFIG_OF_SEPARATE for boards in mainline."
1009 @echo >&2 "See doc/README.fdt-control for more info."
1010 @echo >&2 "===================================================="
1012 ifeq ($(CONFIG_SPI_FLASH),y)
1013 ifneq ($(CONFIG_DM_SPI_FLASH)$(CONFIG_OF_CONTROL),yy)
1014 @echo >&2 "===================== WARNING ======================"
1015 @echo >&2 "This board does not use CONFIG_DM_SPI_FLASH. Please update"
1016 @echo >&2 "the board to use CONFIG_SPI_FLASH before the v2019.07 release."
1017 @echo >&2 "Failure to update by the deadline may result in board removal."
1018 @echo >&2 "See doc/driver-model/MIGRATION.txt for more info."
1019 @echo >&2 "===================================================="
1022 ifneq ($(CONFIG_WATCHDOG)$(CONFIG_HW_WATCHDOG),)
1023 ifneq ($(CONFIG_WDT),y)
1024 @echo >&2 "===================== WARNING ======================"
1025 @echo >&2 "This board does not use CONFIG_WDT (DM watchdog support)."
1026 @echo >&2 "Please update the board to use CONFIG_WDT before the"
1027 @echo >&2 "v2019.10 release."
1028 @echo >&2 "Failure to update by the deadline may result in board removal."
1029 @echo >&2 "See doc/driver-model/MIGRATION.txt for more info."
1030 @echo >&2 "===================================================="
1033 ifneq ($(CONFIG_NET),)
1034 ifneq ($(CONFIG_DM_ETH),y)
1035 @echo >&2 "===================== WARNING ======================"
1036 @echo >&2 "This board does not use CONFIG_DM_ETH (Driver Model"
1037 @echo >&2 "for Ethernet drivers). Please update the board to use"
1038 @echo >&2 "CONFIG_DM_ETH before the v2020.07 release. Failure to"
1039 @echo >&2 "update by the deadline may result in board removal."
1040 @echo >&2 "See doc/driver-model/migration.rst for more info."
1041 @echo >&2 "===================================================="
1044 @# Check that this build does not use CONFIG options that we do not
1045 @# know about unless they are in Kconfig. All the existing CONFIG
1046 @# options are whitelisted, so new ones should not be added.
1047 $(call cmd,cfgcheck,u-boot.cfg)
1053 $(Q)$(MAKE) $(build)=dts dtbs
1055 quiet_cmd_copy = COPY $@
1058 ifeq ($(CONFIG_MULTI_DTB_FIT),y)
1060 ifeq ($(CONFIG_MULTI_DTB_FIT_LZO),y)
1061 FINAL_DTB_CONTAINER = fit-dtb.blob.lzo
1062 else ifeq ($(CONFIG_MULTI_DTB_FIT_GZIP),y)
1063 FINAL_DTB_CONTAINER = fit-dtb.blob.gz
1065 FINAL_DTB_CONTAINER = fit-dtb.blob
1068 fit-dtb.blob.gz: fit-dtb.blob
1071 fit-dtb.blob.lzo: fit-dtb.blob
1074 fit-dtb.blob: dts/dt.dtb FORCE
1075 $(call if_changed,mkimage)
1076 ifneq ($(SOURCE_DATE_EPOCH),)
1077 touch -d @$(SOURCE_DATE_EPOCH) fit-dtb.blob
1078 chmod 0600 fit-dtb.blob
1081 MKIMAGEFLAGS_fit-dtb.blob = -f auto -A $(ARCH) -T firmware -C none -O u-boot \
1083 $(patsubst %,-b arch/$(ARCH)/dts/%.dtb,$(subst ",,$(CONFIG_OF_LIST))) -d /dev/null
1086 u-boot-fit-dtb.bin: u-boot-nodtb.bin $(EXT_DTB)
1087 $(call if_changed,cat)
1089 u-boot-fit-dtb.bin: u-boot-nodtb.bin $(FINAL_DTB_CONTAINER)
1090 $(call if_changed,cat)
1093 u-boot.bin: u-boot-fit-dtb.bin FORCE
1094 $(call if_changed,copy)
1096 u-boot-dtb.bin: u-boot-nodtb.bin dts/dt.dtb FORCE
1097 $(call if_changed,cat)
1099 else ifeq ($(CONFIG_OF_SEPARATE),y)
1100 u-boot-dtb.bin: u-boot-nodtb.bin dts/dt.dtb FORCE
1101 $(call if_changed,cat)
1103 u-boot.bin: u-boot-dtb.bin FORCE
1104 $(call if_changed,copy)
1106 u-boot.bin: u-boot-nodtb.bin FORCE
1107 $(call if_changed,copy)
1111 $(Q)$(MAKE) $(build)=arch/arm/mach-imx $@
1115 $(Q)$(MAKE) $(build)=arch/arm/cpu/armv7/vf610 $@
1117 quiet_cmd_copy = COPY $@
1120 u-boot.dtb: dts/dt.dtb
1123 OBJCOPYFLAGS_u-boot.hex := -O ihex
1125 OBJCOPYFLAGS_u-boot.srec := -O srec
1127 u-boot.hex u-boot.srec: u-boot FORCE
1128 $(call if_changed,objcopy)
1130 OBJCOPYFLAGS_u-boot-elf.srec := $(OBJCOPYFLAGS_u-boot.srec)
1132 u-boot-elf.srec: u-boot.elf FORCE
1133 $(call if_changed,objcopy)
1135 OBJCOPYFLAGS_u-boot-spl.srec = $(OBJCOPYFLAGS_u-boot.srec)
1137 spl/u-boot-spl.srec: spl/u-boot-spl FORCE
1138 $(call if_changed,objcopy)
1141 $(Q)$(MAKE) $(build)=arch/arm/mach-rmobile $@
1143 OBJCOPYFLAGS_u-boot-nodtb.bin := -O binary \
1144 $(if $(CONFIG_X86_16BIT_INIT),-R .start16 -R .resetvec) \
1145 $(if $(CONFIG_MPC85XX_HAVE_RESET_VECTOR),-R .bootpg -R .resetvec)
1147 OBJCOPYFLAGS_u-boot-spl.hex = $(OBJCOPYFLAGS_u-boot.hex)
1149 spl/u-boot-spl.hex: spl/u-boot-spl FORCE
1150 $(call if_changed,objcopy)
1152 binary_size_check: u-boot-nodtb.bin FORCE
1153 @file_size=$(shell wc -c u-boot-nodtb.bin | awk '{print $$1}') ; \
1154 map_size=$(shell cat u-boot.map | \
1155 awk '/_image_copy_start/ {start = $$1} /_image_binary_end/ {end = $$1} END {if (start != "" && end != "") print "ibase=16; " toupper(end) " - " toupper(start)}' \
1158 if [ "" != "$$map_size" ]; then \
1159 if test $$map_size -ne $$file_size; then \
1160 echo "u-boot.map shows a binary size of $$map_size" >&2 ; \
1161 echo " but u-boot-nodtb.bin shows $$file_size" >&2 ; \
1166 ifdef CONFIG_INIT_SP_RELATIVE
1167 ifneq ($(CONFIG_SYS_MALLOC_F_LEN),)
1168 subtract_sys_malloc_f_len = space=$$(($${space} - $(CONFIG_SYS_MALLOC_F_LEN)))
1170 subtract_sys_malloc_f_len = true
1172 # The 1/4 margin below is somewhat arbitrary. The likely initial SP usage is
1173 # so low that the DTB could probably use 90%+ of the available space, for
1174 # current values of CONFIG_SYS_INIT_SP_BSS_OFFSET at least. However, let's be
1175 # safe for now and tweak this later if space becomes tight.
1176 # A rejected alternative would be to check that some absolute minimum stack
1177 # space was available. However, since CONFIG_SYS_INIT_SP_BSS_OFFSET is
1178 # deliberately build-specific, to take account of build-to-build stack usage
1179 # differences due to different feature sets, there is no common absolute value
1181 init_sp_bss_offset_check: u-boot.dtb FORCE
1182 @dtb_size=$(shell wc -c u-boot.dtb | awk '{print $$1}') ; \
1183 space=$(CONFIG_SYS_INIT_SP_BSS_OFFSET) ; \
1184 $(subtract_sys_malloc_f_len) ; \
1185 quarter_space=$$(($${space} / 4)) ; \
1186 if [ $${dtb_size} -gt $${quarter_space} ]; then \
1187 echo "u-boot.dtb is larger than 1 quarter of " >&2 ; \
1188 echo "(CONFIG_SYS_INIT_SP_BSS_OFFSET - CONFIG_SYS_MALLOC_F_LEN)" >&2 ; \
1193 u-boot-nodtb.bin: u-boot FORCE
1194 $(call if_changed,objcopy)
1195 $(call DO_STATIC_RELA,$<,$@,$(CONFIG_SYS_TEXT_BASE))
1200 $(LDR) -T $(CONFIG_CPU) -c $@ $< $(LDR_FLAGS)
1204 # ---------------------------------------------------------------------------
1205 # Use 'make BINMAN_DEBUG=1' to enable debugging
1206 quiet_cmd_binman = BINMAN $@
1207 cmd_binman = $(srctree)/tools/binman/binman $(if $(BINMAN_DEBUG),-D) \
1208 build -u -d u-boot.dtb -O . -m \
1209 -I . -I $(srctree) -I $(srctree)/board/$(BOARDDIR) \
1212 OBJCOPYFLAGS_u-boot.ldr.hex := -I binary -O ihex
1214 OBJCOPYFLAGS_u-boot.ldr.srec := -I binary -O srec
1216 u-boot.ldr.hex u-boot.ldr.srec: u-boot.ldr FORCE
1217 $(call if_changed,objcopy)
1220 # U-Boot entry point, needed for booting of full-blown U-Boot
1221 # from the SPL U-Boot version.
1223 ifndef CONFIG_SYS_UBOOT_START
1224 CONFIG_SYS_UBOOT_START := 0
1227 # Boards with more complex image requirments can provide an .its source file
1228 # or a generator script
1229 ifneq ($(CONFIG_SPL_FIT_SOURCE),"")
1230 U_BOOT_ITS = $(subst ",,$(CONFIG_SPL_FIT_SOURCE))
1232 ifneq ($(CONFIG_SPL_FIT_GENERATOR),"")
1233 U_BOOT_ITS := u-boot.its
1234 ifeq ($(CONFIG_SPL_FIT_GENERATOR),"arch/arm/mach-imx/mkimage_fit_atf.sh")
1235 U_BOOT_ITS_DEPS += u-boot-nodtb.bin
1237 ifeq ($(CONFIG_SPL_FIT_GENERATOR),"arch/arm/mach-rockchip/make_fit_atf.py")
1238 U_BOOT_ITS_DEPS += u-boot
1240 $(U_BOOT_ITS): $(U_BOOT_ITS_DEPS) FORCE
1241 $(srctree)/$(CONFIG_SPL_FIT_GENERATOR) \
1242 $(patsubst %,arch/$(ARCH)/dts/%.dtb,$(subst ",,$(CONFIG_OF_LIST))) > $@
1246 ifdef CONFIG_SPL_LOAD_FIT
1247 MKIMAGEFLAGS_u-boot.img = -f auto -A $(ARCH) -T firmware -C none -O u-boot \
1248 -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_UBOOT_START) \
1249 -n "U-Boot $(UBOOTRELEASE) for $(BOARD) board" -E \
1250 $(patsubst %,-b arch/$(ARCH)/dts/%.dtb,$(subst ",,$(CONFIG_OF_LIST)))
1252 MKIMAGEFLAGS_u-boot.img = -A $(ARCH) -T firmware -C none -O u-boot \
1253 -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_UBOOT_START) \
1254 -n "U-Boot $(UBOOTRELEASE) for $(BOARD) board"
1255 MKIMAGEFLAGS_u-boot-ivt.img = -A $(ARCH) -T firmware_ivt -C none -O u-boot \
1256 -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_UBOOT_START) \
1257 -n "U-Boot $(UBOOTRELEASE) for $(BOARD) board"
1258 u-boot-ivt.img: MKIMAGEOUTPUT = u-boot-ivt.img.log
1259 CLEAN_FILES += u-boot-ivt.img.log u-boot-dtb.imx.log SPL.log u-boot.imx.log
1262 MKIMAGEFLAGS_u-boot-dtb.img = $(MKIMAGEFLAGS_u-boot.img)
1264 MKIMAGEFLAGS_u-boot.kwb = -n $(srctree)/$(CONFIG_SYS_KWD_CONFIG:"%"=%) \
1265 -T kwbimage -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_TEXT_BASE)
1267 MKIMAGEFLAGS_u-boot-spl.kwb = -n $(srctree)/$(CONFIG_SYS_KWD_CONFIG:"%"=%) \
1268 -T kwbimage -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_TEXT_BASE) \
1269 $(if $(KEYDIR),-k $(KEYDIR))
1271 MKIMAGEFLAGS_u-boot.pbl = -n $(srctree)/$(CONFIG_SYS_FSL_PBL_RCW:"%"=%) \
1272 -R $(srctree)/$(CONFIG_SYS_FSL_PBL_PBI:"%"=%) -T pblimage
1274 ifeq ($(CONFIG_MPC85xx)$(CONFIG_OF_SEPARATE),yy)
1275 UBOOT_BIN := u-boot-with-dtb.bin
1277 UBOOT_BIN := u-boot.bin
1280 u-boot-dtb.img u-boot.img u-boot.kwb u-boot.pbl u-boot-ivt.img: \
1281 $(if $(CONFIG_SPL_LOAD_FIT),u-boot-nodtb.bin \
1282 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_OF_HOSTFILE),dts/dt.dtb) \
1283 ,$(UBOOT_BIN)) FORCE
1284 $(call if_changed,mkimage)
1287 ifeq ($(CONFIG_SPL_LOAD_FIT_FULL),y)
1288 MKIMAGEFLAGS_u-boot.itb =
1290 MKIMAGEFLAGS_u-boot.itb = -E
1293 u-boot.itb: u-boot-nodtb.bin \
1294 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_OF_HOSTFILE),dts/dt.dtb) \
1296 $(call if_changed,mkfitimage)
1299 u-boot-spl.kwb: u-boot.img spl/u-boot-spl.bin FORCE
1300 $(call if_changed,mkimage)
1302 u-boot.sha1: u-boot.bin
1303 tools/ubsha1 u-boot.bin
1306 $(OBJDUMP) -d $< > $@
1308 ifneq ($(CONFIG_SPL_PAYLOAD),)
1309 SPL_PAYLOAD := $(CONFIG_SPL_PAYLOAD:"%"=%)
1311 SPL_PAYLOAD := u-boot.bin
1314 SPL_IMAGE := $(CONFIG_SPL_IMAGE:"%"=%)
1316 OBJCOPYFLAGS_u-boot-with-spl.bin = -I binary -O binary \
1317 --pad-to=$(CONFIG_SPL_PAD_TO)
1318 u-boot-with-spl.bin: $(SPL_IMAGE) $(SPL_PAYLOAD) FORCE
1319 $(call if_changed,pad_cat)
1321 ifeq ($(CONFIG_ARCH_ROCKCHIP),y)
1322 MKIMAGEFLAGS_u-boot-tpl.img = -n $(CONFIG_SYS_SOC) -T rksd
1323 tpl/u-boot-tpl.img: tpl/u-boot-tpl.bin FORCE
1324 $(call if_changed,mkimage)
1325 idbloader.img: tpl/u-boot-tpl.img spl/u-boot-spl.bin FORCE
1326 $(call if_changed,cat)
1329 ifeq ($(CONFIG_ARCH_LPC32XX)$(CONFIG_SPL),yy)
1330 MKIMAGEFLAGS_lpc32xx-spl.img = -T lpc32xximage -a $(CONFIG_SPL_TEXT_BASE)
1332 lpc32xx-spl.img: spl/u-boot-spl.bin FORCE
1333 $(call if_changed,mkimage)
1335 OBJCOPYFLAGS_lpc32xx-boot-0.bin = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO)
1337 lpc32xx-boot-0.bin: lpc32xx-spl.img FORCE
1338 $(call if_changed,objcopy)
1340 OBJCOPYFLAGS_lpc32xx-boot-1.bin = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO)
1342 lpc32xx-boot-1.bin: lpc32xx-spl.img FORCE
1343 $(call if_changed,objcopy)
1345 lpc32xx-full.bin: lpc32xx-boot-0.bin lpc32xx-boot-1.bin u-boot.img FORCE
1346 $(call if_changed,cat)
1348 CLEAN_FILES += lpc32xx-*
1351 OBJCOPYFLAGS_u-boot-with-tpl.bin = -I binary -O binary \
1352 --pad-to=$(CONFIG_TPL_PAD_TO)
1353 tpl/u-boot-with-tpl.bin: tpl/u-boot-tpl.bin u-boot.bin FORCE
1354 $(call if_changed,pad_cat)
1356 SPL: spl/u-boot-spl.bin FORCE
1357 $(Q)$(MAKE) $(build)=arch/arm/mach-imx $@
1359 ifeq ($(CONFIG_ARCH_IMX8M)$(CONFIG_ARCH_IMX8), y)
1360 flash.bin: spl/u-boot-spl.bin u-boot.itb FORCE
1361 $(Q)$(MAKE) $(build)=arch/arm/mach-imx $@
1364 u-boot-with-spl.imx u-boot-with-nand-spl.imx: SPL u-boot.bin FORCE
1365 $(Q)$(MAKE) $(build)=arch/arm/mach-imx $@
1367 MKIMAGEFLAGS_u-boot.ubl = -n $(UBL_CONFIG) -T ublimage -e $(CONFIG_SYS_TEXT_BASE)
1369 u-boot.ubl: u-boot-with-spl.bin FORCE
1370 $(call if_changed,mkimage)
1372 MKIMAGEFLAGS_u-boot-spl.ais = -s -n $(if $(CONFIG_AIS_CONFIG_FILE), \
1373 $(srctree)/$(CONFIG_AIS_CONFIG_FILE:"%"=%),"/dev/null") \
1374 -T aisimage -e $(CONFIG_SPL_TEXT_BASE)
1375 spl/u-boot-spl.ais: spl/u-boot-spl.bin FORCE
1376 $(call if_changed,mkimage)
1378 OBJCOPYFLAGS_u-boot.ais = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO)
1379 u-boot.ais: spl/u-boot-spl.ais u-boot.img FORCE
1380 $(call if_changed,pad_cat)
1382 u-boot-signed.sb: u-boot.bin spl/u-boot-spl.bin
1383 $(Q)$(MAKE) $(build)=arch/arm/cpu/arm926ejs/mxs u-boot-signed.sb
1384 u-boot.sb: u-boot.bin spl/u-boot-spl.bin
1385 $(Q)$(MAKE) $(build)=arch/arm/cpu/arm926ejs/mxs u-boot.sb
1387 # On x600 (SPEAr600) U-Boot is appended to U-Boot SPL.
1388 # Both images are created using mkimage (crc etc), so that the ROM
1389 # bootloader can check its integrity. Padding needs to be done to the
1390 # SPL image (with mkimage header) and not the binary. Otherwise the resulting image
1391 # which is loaded/copied by the ROM bootloader to SRAM doesn't fit.
1392 # The resulting image containing both U-Boot images is called u-boot.spr
1393 MKIMAGEFLAGS_u-boot-spl.img = -A $(ARCH) -T firmware -C none \
1394 -a $(CONFIG_SPL_TEXT_BASE) -e $(CONFIG_SPL_TEXT_BASE) -n XLOADER
1395 spl/u-boot-spl.img: spl/u-boot-spl.bin FORCE
1396 $(call if_changed,mkimage)
1398 OBJCOPYFLAGS_u-boot.spr = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO) \
1400 u-boot.spr: spl/u-boot-spl.img u-boot.img FORCE
1401 $(call if_changed,pad_cat)
1403 ifneq ($(CONFIG_ARCH_SOCFPGA),)
1404 quiet_cmd_socboot = SOCBOOT $@
1405 cmd_socboot = cat spl/u-boot-spl.sfp spl/u-boot-spl.sfp \
1406 spl/u-boot-spl.sfp spl/u-boot-spl.sfp \
1407 u-boot.img > $@ || rm -f $@
1408 u-boot-with-spl.sfp: spl/u-boot-spl.sfp u-boot.img FORCE
1409 $(call if_changed,socboot)
1412 ifeq ($(CONFIG_MPC85xx)$(CONFIG_OF_SEPARATE),yy)
1413 u-boot-with-dtb.bin: u-boot.bin u-boot.dtb \
1414 $(if $(CONFIG_MPC85XX_HAVE_RESET_VECTOR), u-boot-br.bin) FORCE
1415 $(call if_changed,binman)
1417 ifeq ($(CONFIG_MPC85XX_HAVE_RESET_VECTOR),y)
1418 OBJCOPYFLAGS_u-boot-br.bin := -O binary -j .bootpg -j .resetvec
1419 u-boot-br.bin: u-boot FORCE
1420 $(call if_changed,objcopy)
1424 # x86 uses a large ROM. We fill it with 0xff, put the 16-bit stuff (including
1425 # reset vector) at the top, Intel ME descriptor at the bottom, and U-Boot in
1426 # the middle. This is handled by binman based on an image description in the
1427 # board's device tree.
1428 ifneq ($(CONFIG_X86_RESET_VECTOR),)
1429 rom: u-boot.rom FORCE
1431 refcode.bin: $(srctree)/board/$(BOARDDIR)/refcode.bin FORCE
1432 $(call if_changed,copy)
1434 quiet_cmd_ldr = LD $@
1435 cmd_ldr = $(LD) $(LDFLAGS_$(@F)) \
1436 $(filter-out FORCE,$^) -o $@
1438 u-boot.rom: u-boot-x86-16bit.bin u-boot.bin \
1439 $(if $(CONFIG_SPL_X86_16BIT_INIT),spl/u-boot-spl.bin) \
1440 $(if $(CONFIG_TPL_X86_16BIT_INIT),tpl/u-boot-tpl.bin) \
1441 $(if $(CONFIG_HAVE_REFCODE),refcode.bin) FORCE
1442 $(call if_changed,binman)
1444 OBJCOPYFLAGS_u-boot-x86-16bit.bin := -O binary -j .start16 -j .resetvec
1445 u-boot-x86-16bit.bin: u-boot FORCE
1446 $(call if_changed,objcopy)
1449 ifneq ($(CONFIG_ARCH_SUNXI),)
1450 ifeq ($(CONFIG_ARM64),)
1451 u-boot-sunxi-with-spl.bin: spl/sunxi-spl.bin u-boot.img u-boot.dtb FORCE
1452 $(call if_changed,binman)
1454 u-boot-sunxi-with-spl.bin: spl/sunxi-spl.bin u-boot.itb FORCE
1455 $(call if_changed,cat)
1459 ifneq ($(CONFIG_TEGRA),)
1460 ifneq ($(CONFIG_BINMAN),)
1461 # Makes u-boot-dtb-tegra.bin u-boot-tegra.bin u-boot-nodtb-tegra.bin
1462 %-dtb-tegra.bin %-tegra.bin %-nodtb-tegra.bin: \
1463 spl/%-spl %.bin FORCE
1464 $(call if_changed,binman)
1466 OBJCOPYFLAGS_u-boot-nodtb-tegra.bin = -O binary --pad-to=$(CONFIG_SYS_TEXT_BASE)
1467 u-boot-nodtb-tegra.bin: spl/u-boot-spl u-boot-nodtb.bin FORCE
1468 $(call if_changed,pad_cat)
1470 OBJCOPYFLAGS_u-boot-tegra.bin = -O binary --pad-to=$(CONFIG_SYS_TEXT_BASE)
1471 u-boot-tegra.bin: spl/u-boot-spl u-boot.bin FORCE
1472 $(call if_changed,pad_cat)
1474 u-boot-dtb-tegra.bin: u-boot-tegra.bin FORCE
1475 $(call if_changed,copy)
1479 OBJCOPYFLAGS_u-boot-app.efi := $(OBJCOPYFLAGS_EFI)
1480 u-boot-app.efi: u-boot FORCE
1481 $(call if_changed,zobjcopy)
1483 u-boot.bin.o: u-boot.bin FORCE
1484 $(call if_changed,efipayload)
1486 u-boot-payload.lds: $(LDSCRIPT_EFI) FORCE
1487 $(call if_changed_dep,cpp_lds)
1489 # Rule to link the EFI payload which contains a stub and a U-Boot binary
1490 quiet_cmd_u-boot_payload ?= LD $@
1491 cmd_u-boot_payload ?= $(LD) $(LDFLAGS_EFI_PAYLOAD) -o $@ \
1492 -T u-boot-payload.lds arch/x86/cpu/call32.o \
1493 lib/efi/efi.o lib/efi/efi_stub.o u-boot.bin.o \
1494 $(addprefix arch/$(ARCH)/lib/,$(EFISTUB))
1496 u-boot-payload: u-boot.bin.o u-boot-payload.lds FORCE
1497 $(call if_changed,u-boot_payload)
1499 OBJCOPYFLAGS_u-boot-payload.efi := $(OBJCOPYFLAGS_EFI)
1500 u-boot-payload.efi: u-boot-payload FORCE
1501 $(call if_changed,zobjcopy)
1503 u-boot-img.bin: spl/u-boot-spl.bin u-boot.img FORCE
1504 $(call if_changed,cat)
1506 #Add a target to create boot binary having SPL binary in PBI format
1507 #concatenated with u-boot binary. It is need by PowerPC SoC having
1508 #internal SRAM <= 512KB.
1509 MKIMAGEFLAGS_u-boot-spl.pbl = -n $(srctree)/$(CONFIG_SYS_FSL_PBL_RCW:"%"=%) \
1510 -R $(srctree)/$(CONFIG_SYS_FSL_PBL_PBI:"%"=%) -T pblimage \
1511 -A $(ARCH) -a $(CONFIG_SPL_TEXT_BASE)
1513 spl/u-boot-spl.pbl: spl/u-boot-spl.bin FORCE
1514 $(call if_changed,mkimage)
1517 UBOOT_BINLOAD := u-boot.img
1519 ifeq ($(CONFIG_MPC85xx)$(CONFIG_OF_SEPARATE),yy)
1520 UBOOT_BINLOAD := u-boot-with-dtb.bin
1522 UBOOT_BINLOAD := u-boot.bin
1526 OBJCOPYFLAGS_u-boot-with-spl-pbl.bin = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO) \
1529 u-boot-with-spl-pbl.bin: spl/u-boot-spl.pbl $(UBOOT_BINLOAD) FORCE
1530 $(call if_changed,pad_cat)
1532 # PPC4xx needs the SPL at the end of the image, since the reset vector
1533 # is located at 0xfffffffc. So we can't use the "u-boot-img.bin" target
1534 # and need to introduce a new build target with the full blown U-Boot
1535 # at the start padded up to the start of the SPL image. And then concat
1536 # the SPL image to the end.
1538 OBJCOPYFLAGS_u-boot-img-spl-at-end.bin := -I binary -O binary \
1539 --pad-to=$(CONFIG_UBOOT_PAD_TO) --gap-fill=0xff
1540 u-boot-img-spl-at-end.bin: u-boot.img spl/u-boot-spl.bin FORCE
1541 $(call if_changed,pad_cat)
1543 # Create a new ELF from a raw binary file.
1544 ifndef PLATFORM_ELFENTRY
1545 PLATFORM_ELFENTRY = "_start"
1547 quiet_cmd_u-boot-elf ?= LD $@
1548 cmd_u-boot-elf ?= $(LD) u-boot-elf.o -o $@ \
1549 --defsym=$(PLATFORM_ELFENTRY)=$(CONFIG_SYS_TEXT_BASE) \
1550 -Ttext=$(CONFIG_SYS_TEXT_BASE)
1551 u-boot.elf: u-boot.bin
1552 $(Q)$(OBJCOPY) -I binary $(PLATFORM_ELFFLAGS) $< u-boot-elf.o
1553 $(call if_changed,u-boot-elf)
1555 # MediaTek's ARM-based u-boot needs a header to contains its load address
1556 # which is parsed by the BootROM.
1557 # If the SPL build is enabled, the header will be added to the spl binary,
1558 # and the spl binary and the u-boot.img will be combined into one file.
1559 # Otherwise the header will be added to the u-boot.bin directly.
1561 ifeq ($(CONFIG_SPL),y)
1562 spl/u-boot-spl-mtk.bin: spl/u-boot-spl
1564 u-boot-mtk.bin: u-boot.dtb u-boot.img spl/u-boot-spl-mtk.bin FORCE
1565 $(call if_changed,binman)
1567 MKIMAGEFLAGS_u-boot-mtk.bin = -T mtk_image \
1568 -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_TEXT_BASE) \
1569 -n "$(patsubst "%",%,$(CONFIG_MTK_BROM_HEADER_INFO))"
1571 u-boot-mtk.bin: u-boot.bin FORCE
1572 $(call if_changed,mkimage)
1575 ARCH_POSTLINK := $(wildcard $(srctree)/arch/$(ARCH)/Makefile.postlink)
1577 # Rule to link u-boot
1578 # May be overridden by arch/$(ARCH)/config.mk
1579 quiet_cmd_u-boot__ ?= LD $@
1580 cmd_u-boot__ ?= $(LD) $(LDFLAGS) $(LDFLAGS_u-boot) -o $@ \
1581 -T u-boot.lds $(u-boot-init) \
1582 --start-group $(u-boot-main) --end-group \
1583 $(PLATFORM_LIBS) -Map u-boot.map; \
1584 $(if $(ARCH_POSTLINK), $(MAKE) -f $(ARCH_POSTLINK) $@, true)
1586 quiet_cmd_smap = GEN common/system_map.o
1588 smap=`$(call SYSTEM_MAP,u-boot) | \
1589 awk '$$2 ~ /[tTwW]/ {printf $$1 $$3 "\\\\000"}'` ; \
1590 $(CC) $(c_flags) -DSYSTEM_MAP="\"$${smap}\"" \
1591 -c $(srctree)/common/system_map.c -o common/system_map.o
1593 u-boot: $(u-boot-init) $(u-boot-main) u-boot.lds FORCE
1594 +$(call if_changed,u-boot__)
1595 ifeq ($(CONFIG_KALLSYMS),y)
1597 $(call cmd,u-boot__) common/system_map.o
1600 ifeq ($(CONFIG_RISCV),y)
1601 @tools/prelink-riscv $@ 0
1604 quiet_cmd_sym ?= SYM $@
1605 cmd_sym ?= $(OBJDUMP) -t $< > $@
1606 u-boot.sym: u-boot FORCE
1607 $(call if_changed,sym)
1609 # The actual objects are generated when descending,
1610 # make sure no implicit rule kicks in
1611 $(sort $(u-boot-init) $(u-boot-main)): $(u-boot-dirs) ;
1613 # Handle descending into subdirectories listed in $(vmlinux-dirs)
1614 # Preset locale variables to speed up the build process. Limit locale
1615 # tweaks to this spot to avoid wrong language settings when running
1616 # make menuconfig etc.
1617 # Error messages still appears in the original language
1619 PHONY += $(u-boot-dirs)
1620 $(u-boot-dirs): prepare scripts
1621 $(Q)$(MAKE) $(build)=$@
1624 # The "tools" are needed early
1625 $(filter-out tools, $(u-boot-dirs)): tools
1626 # The "examples" conditionally depend on U-Boot (say, when USE_PRIVATE_LIBGCC
1627 # is "yes"), so compile examples after U-Boot is compiled.
1628 examples: $(filter-out examples, $(u-boot-dirs))
1630 define filechk_uboot.release
1631 echo "$(UBOOTVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))"
1634 # Store (new) UBOOTRELEASE string in include/config/uboot.release
1635 include/config/uboot.release: include/config/auto.conf FORCE
1636 $(call filechk,uboot.release)
1639 # Things we need to do before we recursively start building the kernel
1640 # or the modules are listed in "prepare".
1641 # A multi level approach is used. prepareN is processed before prepareN-1.
1642 # archprepare is used in arch Makefiles and when processed asm symlink,
1643 # version.h and scripts_basic is processed / created.
1645 # Listed in dependency order
1646 PHONY += prepare archprepare prepare0 prepare1 prepare2 prepare3
1648 # prepare3 is used to check if we are building in a separate output directory,
1650 # 1) Check that make has not been executed in the kernel src $(srctree)
1651 prepare3: include/config/uboot.release
1652 ifneq ($(KBUILD_SRC),)
1653 @$(kecho) ' Using $(srctree) as source for U-Boot'
1654 $(Q)if [ -f $(srctree)/.config -o -d $(srctree)/include/config ]; then \
1655 echo >&2 " $(srctree) is not clean, please run 'make mrproper'"; \
1656 echo >&2 " in the '$(srctree)' directory.";\
1661 # prepare2 creates a makefile if using a separate output directory
1662 prepare2: prepare3 outputmakefile cfg
1664 prepare1: prepare2 $(version_h) $(timestamp_h) \
1665 include/config/auto.conf
1666 ifeq ($(wildcard $(LDSCRIPT)),)
1667 @echo >&2 " Could not find linker script."
1671 ifeq ($(CONFIG_USE_DEFAULT_ENV_FILE),y)
1672 prepare1: $(defaultenv_h)
1675 archprepare: prepare1 scripts_basic
1677 prepare0: archprepare FORCE
1678 $(Q)$(MAKE) $(build)=.
1680 # All the preparing..
1683 # Generate some files
1684 # ---------------------------------------------------------------------------
1686 define filechk_version.h
1687 (echo \#define PLAIN_VERSION \"$(UBOOTRELEASE)\"; \
1688 echo \#define U_BOOT_VERSION \"U-Boot \" PLAIN_VERSION; \
1689 echo \#define CC_VERSION_STRING \"$$(LC_ALL=C $(CC) --version | head -n 1)\"; \
1690 echo \#define LD_VERSION_STRING \"$$(LC_ALL=C $(LD) --version | head -n 1)\"; )
1693 # The SOURCE_DATE_EPOCH mechanism requires a date that behaves like GNU date.
1694 # The BSD date on the other hand behaves different and would produce errors
1695 # with the misused '-d' switch. Respect that and search a working date with
1696 # well known pre- and suffixes for the GNU variant of date.
1697 define filechk_timestamp.h
1698 (if test -n "$${SOURCE_DATE_EPOCH}"; then \
1699 SOURCE_DATE="@$${SOURCE_DATE_EPOCH}"; \
1701 for date in gdate date.gnu date; do \
1702 $${date} -u -d "$${SOURCE_DATE}" >/dev/null 2>&1 && DATE="$${date}"; \
1704 if test -n "$${DATE}"; then \
1705 LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_DATE "%b %d %C%y"'; \
1706 LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_TIME "%T"'; \
1707 LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_TZ "%z"'; \
1708 LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_DMI_DATE "%m/%d/%Y"'; \
1709 LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_BUILD_DATE 0x%Y%m%d'; \
1714 LC_ALL=C date +'#define U_BOOT_DATE "%b %d %C%y"'; \
1715 LC_ALL=C date +'#define U_BOOT_TIME "%T"'; \
1716 LC_ALL=C date +'#define U_BOOT_TZ "%z"'; \
1717 LC_ALL=C date +'#define U_BOOT_DMI_DATE "%m/%d/%Y"'; \
1718 LC_ALL=C date +'#define U_BOOT_BUILD_DATE 0x%Y%m%d'; \
1722 define filechk_defaultenv.h
1726 sed -e 's/\\\x0/\n/g' | \
1727 xxd -i ; echo ", 0x00" ; )
1730 $(version_h): include/config/uboot.release FORCE
1731 $(call filechk,version.h)
1733 $(timestamp_h): $(srctree)/Makefile FORCE
1734 $(call filechk,timestamp.h)
1736 $(defaultenv_h): $(CONFIG_DEFAULT_ENV_FILE:"%"=%) FORCE
1737 $(call filechk,defaultenv.h)
1739 # ---------------------------------------------------------------------------
1740 quiet_cmd_cpp_lds = LDS $@
1741 cmd_cpp_lds = $(CPP) -Wp,-MD,$(depfile) $(cpp_flags) $(LDPPFLAGS) \
1742 -D__ASSEMBLY__ -x assembler-with-cpp -std=c99 -P -o $@ $<
1744 u-boot.lds: $(LDSCRIPT) prepare FORCE
1745 $(call if_changed_dep,cpp_lds)
1747 spl/u-boot-spl.bin: spl/u-boot-spl
1751 spl/u-boot-spl: tools prepare \
1752 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_SPL_OF_PLATDATA),dts/dt.dtb) \
1753 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_TPL_OF_PLATDATA),dts/dt.dtb)
1754 $(Q)$(MAKE) obj=spl -f $(srctree)/scripts/Makefile.spl all
1756 spl/sunxi-spl.bin: spl/u-boot-spl
1759 spl/sunxi-spl-with-ecc.bin: spl/sunxi-spl.bin
1762 spl/u-boot-spl.sfp: spl/u-boot-spl
1765 spl/boot.bin: spl/u-boot-spl
1768 tpl/u-boot-tpl.bin: tools prepare \
1769 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_SPL_OF_PLATDATA),dts/dt.dtb)
1770 $(Q)$(MAKE) obj=tpl -f $(srctree)/scripts/Makefile.spl all
1772 TAG_SUBDIRS := $(patsubst %,$(srctree)/%,$(u-boot-dirs) include)
1778 ctags -w -o ctags `$(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) \
1779 -name '*.[chS]' -print`
1783 etags -a -o etags `$(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) \
1784 -name '*.[chS]' -print`
1786 $(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) -name '*.[chS]' -print > \
1792 grep -v '\(compiled\)\|\(\.o$$\)\|\( [aUw] \)\|\(\.\.ng$$\)\|\(LASH[RL]DI\)' | \
1795 @$(call SYSTEM_MAP,$<) > $@
1797 #########################################################################
1799 # ARM relocations should all be R_ARM_RELATIVE (32-bit) or
1800 # R_AARCH64_RELATIVE (64-bit).
1801 checkarmreloc: u-boot
1802 @RELOC="`$(CROSS_COMPILE)readelf -r -W $< | cut -d ' ' -f 4 | \
1803 grep R_A | sort -u`"; \
1804 if test "$$RELOC" != "R_ARM_RELATIVE" -a \
1805 "$$RELOC" != "R_AARCH64_RELATIVE"; then \
1806 echo "$< contains unexpected relocations: $$RELOC"; \
1810 envtools: scripts_basic $(version_h) $(timestamp_h)
1811 $(Q)$(MAKE) $(build)=tools/env
1813 tools-only: export TOOLS_ONLY=y
1814 tools-only: scripts_basic $(version_h) $(timestamp_h)
1815 $(Q)$(MAKE) $(build)=tools
1817 tools-all: export HOST_TOOLS_ALL=y
1818 tools-all: envtools tools ;
1820 cross_tools: export CROSS_BUILD_TOOLS=y
1821 cross_tools: tools ;
1825 git log --no-merges U-Boot-1_1_5.. | \
1826 unexpand -a | sed -e 's/\s\s*$$//' > $@
1828 #########################################################################
1831 # Cleaning is done on three levels.
1832 # make clean Delete most generated files
1833 # Leave enough to build external modules
1834 # make mrproper Delete the current configuration, and all generated files
1835 # make distclean Remove editor backup files, patch leftover files and the like
1837 # Directories & files removed with 'make clean'
1838 CLEAN_DIRS += $(MODVERDIR) \
1839 $(foreach d, spl tpl, $(patsubst %,$d/%, \
1840 $(filter-out include, $(shell ls -1 $d 2>/dev/null))))
1842 CLEAN_FILES += include/bmp_logo.h include/bmp_logo_data.h \
1843 boot* u-boot* MLO* SPL System.map fit-dtb.blob*
1845 # Directories & files removed with 'make mrproper'
1846 MRPROPER_DIRS += include/config include/generated spl tpl \
1848 MRPROPER_FILES += .config .config.old include/autoconf.mk* include/config.h \
1849 ctags etags tags TAGS cscope* GPATH GTAGS GRTAGS GSYMS \
1850 drivers/video/fonts/*.S
1852 # clean - Delete most, but leave enough to build external modules
1854 clean: rm-dirs := $(CLEAN_DIRS)
1855 clean: rm-files := $(CLEAN_FILES)
1857 clean-dirs := $(foreach f,$(u-boot-alldirs),$(if $(wildcard $(srctree)/$f/Makefile),$f))
1859 clean-dirs := $(addprefix _clean_, $(clean-dirs))
1861 PHONY += $(clean-dirs) clean archclean
1863 $(Q)$(MAKE) $(clean)=$(patsubst _clean_%,%,$@)
1865 clean: $(clean-dirs)
1868 @find $(if $(KBUILD_EXTMOD), $(KBUILD_EXTMOD), .) $(RCS_FIND_IGNORE) \
1869 \( -name '*.[oas]' -o -name '*.ko' -o -name '.*.cmd' \
1870 -o -name '*.ko.*' -o -name '*.su' \
1871 -o -name '.*.d' -o -name '.*.tmp' -o -name '*.mod.c' \
1872 -o -name '*.lex.c' -o -name '*.tab.[ch]' \
1873 -o -name '*.symtypes' -o -name 'modules.order' \
1874 -o -name modules.builtin -o -name '.tmp_*.o.*' \
1875 -o -name 'dsdt.aml' -o -name 'dsdt.asl.tmp' -o -name 'dsdt.c' \
1876 -o -name '*.efi' -o -name '*.gcno' -o -name '*.so' \) \
1877 -type f -print | xargs rm -f \
1878 bl31.c bl31.elf bl31_*.bin image.map tispl.bin*
1880 # mrproper - Delete all generated files, including .config
1882 mrproper: rm-dirs := $(wildcard $(MRPROPER_DIRS))
1883 mrproper: rm-files := $(wildcard $(MRPROPER_FILES))
1884 mrproper-dirs := $(addprefix _mrproper_,scripts)
1886 PHONY += $(mrproper-dirs) mrproper archmrproper
1888 $(Q)$(MAKE) $(clean)=$(patsubst _mrproper_%,%,$@)
1890 mrproper: clean $(mrproper-dirs)
1893 @rm -f arch/*/include/asm/arch
1900 @find $(srctree) $(RCS_FIND_IGNORE) \
1901 \( -name '*.orig' -o -name '*.rej' -o -name '*~' \
1902 -o -name '*.bak' -o -name '#*#' -o -name '.*.orig' \
1903 -o -name '.*.rej' -o -name '*%' -o -name 'core' \
1904 -o -name '*.pyc' \) \
1905 -type f -print | xargs rm -f
1906 @rm -f boards.cfg CHANGELOG
1909 F=`basename $(srctree)` ; cd .. ; \
1910 gtar --force-local -zcvf `LC_ALL=C date "+$$F-%Y-%m-%d-%T.tar.gz"` $$F
1913 @echo 'Cleaning targets:'
1914 @echo ' clean - Remove most generated files but keep the config'
1915 @echo ' mrproper - Remove all generated files + config + various backup files'
1916 @echo ' distclean - mrproper + remove editor backup and patch files'
1918 @echo 'Configuration targets:'
1919 @$(MAKE) -f $(srctree)/scripts/kconfig/Makefile help
1921 @echo 'Test targets:'
1923 @echo ' check - Run all automated tests that use sandbox'
1924 @echo ' qcheck - Run quick automated tests that use sandbox'
1926 @echo 'Other generic targets:'
1927 @echo ' all - Build all necessary images depending on configuration'
1928 @echo ' tests - Build U-Boot for sandbox and run tests'
1929 @echo '* u-boot - Build the bare u-boot'
1930 @echo ' dir/ - Build all files in dir and below'
1931 @echo ' dir/file.[oisS] - Build specified target only'
1932 @echo ' dir/file.lst - Build specified mixed source/assembly target only'
1933 @echo ' (requires a recent binutils and recent build (System.map))'
1934 @echo ' tags/ctags - Generate ctags file for editors'
1935 @echo ' etags - Generate etags file for editors'
1936 @echo ' cscope - Generate cscope index'
1937 @echo ' ubootrelease - Output the release version string (use with make -s)'
1938 @echo ' ubootversion - Output the version stored in Makefile (use with make -s)'
1939 @echo " cfg - Don't build, just create the .cfg files"
1940 @echo " envtools - Build only the target-side environment tools"
1942 @echo 'Static analysers'
1943 @echo ' checkstack - Generate a list of stack hogs'
1944 @echo ' coccicheck - Execute static code analysis with Coccinelle'
1946 @echo 'Documentation targets:'
1947 @$(MAKE) -f $(srctree)/doc/Makefile dochelp
1949 @echo ' make V=0|1 [targets] 0 => quiet build (default), 1 => verbose build'
1950 @echo ' make V=2 [targets] 2 => give reason for rebuild of target'
1951 @echo ' make O=dir [targets] Locate all output files in "dir", including .config'
1952 @echo ' make C=1 [targets] Check all c source with $$CHECK (sparse by default)'
1953 @echo ' make C=2 [targets] Force check of all c source with $$CHECK'
1954 @echo ' make RECORDMCOUNT_WARN=1 [targets] Warn about ignored mcount sections'
1955 @echo ' make W=n [targets] Enable extra gcc checks, n=1,2,3 where'
1956 @echo ' 1: warnings which may be relevant and do not occur too often'
1957 @echo ' 2: warnings which occur quite often but may still be relevant'
1958 @echo ' 3: more obscure warnings, can most likely be ignored'
1959 @echo ' Multiple levels can be combined with W=12 or W=123'
1961 @echo 'Execute "make" or "make all" to build all targets marked with [*] '
1962 @echo 'For further info see the ./README file'
1968 $(srctree)/test/run quick
1970 # Documentation targets
1971 # ---------------------------------------------------------------------------
1972 DOC_TARGETS := xmldocs latexdocs pdfdocs htmldocs epubdocs cleandocs \
1973 linkcheckdocs dochelp refcheckdocs
1974 PHONY += $(DOC_TARGETS)
1975 $(DOC_TARGETS): scripts_basic FORCE
1976 $(Q)$(MAKE) $(build)=doc $@
1978 endif #ifeq ($(config-targets),1)
1979 endif #ifeq ($(mixed-targets),1)
1981 PHONY += checkstack ubootrelease ubootversion
1984 $(OBJDUMP) -d u-boot $$(find . -name u-boot-spl) | \
1985 $(PERL) $(src)/scripts/checkstack.pl $(ARCH)
1988 @echo "$(UBOOTVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))"
1991 @echo $(UBOOTVERSION)
1994 # ---------------------------------------------------------------------------
1995 # Single targets are compatible with:
1996 # - build with mixed source and output
1997 # - build with separate output dir 'make O=...'
1998 # - external modules
2000 # target-dir => where to store outputfile
2001 # build-dir => directory in kernel source tree to use
2003 ifeq ($(KBUILD_EXTMOD),)
2004 build-dir = $(patsubst %/,%,$(dir $@))
2005 target-dir = $(dir $@)
2007 zap-slash=$(filter-out .,$(patsubst %/,%,$(dir $@)))
2008 build-dir = $(KBUILD_EXTMOD)$(if $(zap-slash),/$(zap-slash))
2009 target-dir = $(if $(KBUILD_EXTMOD),$(dir $<),$(dir $@))
2012 %.s: %.c prepare scripts FORCE
2013 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2014 %.i: %.c prepare scripts FORCE
2015 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2016 %.o: %.c prepare scripts FORCE
2017 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2018 %.lst: %.c prepare scripts FORCE
2019 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2020 %.s: %.S prepare scripts FORCE
2021 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2022 %.o: %.S prepare scripts FORCE
2023 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2024 %.symtypes: %.c prepare scripts FORCE
2025 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
2028 /: prepare scripts FORCE
2030 $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \
2031 $(build)=$(build-dir)
2032 %/: prepare scripts FORCE
2034 $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \
2035 $(build)=$(build-dir)
2036 %.ko: prepare scripts FORCE
2038 $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \
2039 $(build)=$(build-dir) $(@:.ko=.o)
2040 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost
2042 quiet_cmd_genenv = GENENV $@
2043 cmd_genenv = $(OBJCOPY) --dump-section .rodata.default_environment=$@ env/common.o; \
2044 sed --in-place -e 's/\x00/\x0A/g' $@
2046 u-boot-initial-env: u-boot.bin
2047 $(call if_changed,genenv)
2049 # Consistency checks
2050 # ---------------------------------------------------------------------------
2055 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/$@
2057 # FIXME Should go into a make.lib or something
2058 # ===========================================================================
2060 quiet_cmd_rmdirs = $(if $(wildcard $(rm-dirs)),CLEAN $(wildcard $(rm-dirs)))
2061 cmd_rmdirs = rm -rf $(rm-dirs)
2063 quiet_cmd_rmfiles = $(if $(wildcard $(rm-files)),CLEAN $(wildcard $(rm-files)))
2064 cmd_rmfiles = rm -f $(rm-files)
2066 # read all saved command lines
2068 targets := $(wildcard $(sort $(targets)))
2069 cmd_files := $(wildcard .*.cmd $(foreach f,$(targets),$(dir $(f)).$(notdir $(f)).cmd))
2071 ifneq ($(cmd_files),)
2072 $(cmd_files): ; # Do not try to update included dependency files
2073 include $(cmd_files)
2076 endif # skip-makefile
2081 # Declare the contents of the .PHONY variable as phony. We keep that
2082 # information in a variable so we can use it in if_changed and friends.