2 # For a description of the syntax of this configuration file,
3 # see the file Documentation/kbuild/kconfig-language.txt in the
4 # Linux kernel source tree.
6 mainmenu "U-Boot $(UBOOTVERSION) Configuration"
8 comment "Compiler: $(CC_VERSION_TEXT)"
10 source "scripts/Kconfig.include"
12 # Allow defaults in arch-specific code to override any given here
20 This option cannot be enabled. It is used as dependency
21 for broken and incomplete features.
26 This option cannot be enabled. It it used as a dependency for
27 code that relies on deprecated features that will be removed and
28 the conversion deadline has passed.
31 string "Local version - append to U-Boot release"
33 Append an extra string to the end of your U-Boot version.
34 This will show up in your boot log, for example.
35 The string you set here will be appended after the contents of
36 any files with a filename matching localversion* in your
37 object and source tree, in that order. Your total string can
38 be a maximum of 64 characters.
40 config LOCALVERSION_AUTO
41 bool "Automatically append version information to the version string"
44 This will try to automatically determine if the current tree is a
45 release tree by looking for Git tags that belong to the current
48 A string of the format -gxxxxxxxx will be added to the localversion
49 if a Git-based tree is found. The string generated by this will be
50 appended after any matching localversion* files, and after the value
51 set in CONFIG_LOCALVERSION.
53 (The actual string used here is the first eight characters produced
54 by running the command:
56 $ git rev-parse --verify HEAD
58 which is done within the script "scripts/setlocalversion".)
61 def_bool $(success,$(CC) --version | head -n 1 | grep -q gcc)
65 default $(shell,$(srctree)/scripts/gcc-version.sh -p $(CC) | sed 's/^0*//') if CC_IS_GCC
69 def_bool $(success,$(CC) --version | head -n 1 | grep -q clang)
73 default $(shell,$(srctree)/scripts/clang-version.sh $(CC))
76 prompt "Optimization level"
77 default CC_OPTIMIZE_FOR_SIZE
79 config CC_OPTIMIZE_FOR_SIZE
80 bool "Optimize for size"
82 Enabling this option will pass "-Os" to gcc, resulting in a smaller
85 This option is enabled by default for U-Boot.
87 config CC_OPTIMIZE_FOR_SPEED
88 bool "Optimize for speed"
90 Enabling this option will pass "-O2" to gcc, resulting in a faster
93 config CC_OPTIMIZE_FOR_DEBUG
94 bool "Optimize for debugging"
96 Enabling this option will pass "-Og" to gcc, enabling optimizations
97 which don't interfere with debugging.
101 config OPTIMIZE_INLINING
102 bool "Allow compiler to uninline functions marked 'inline' in full U-Boot"
104 This option determines if U-Boot forces gcc to inline the functions
105 developers have marked 'inline'. Doing so takes away freedom from gcc to
106 do what it thinks is best, which is desirable in some cases for size
109 config SPL_OPTIMIZE_INLINING
110 bool "Allow compiler to uninline functions marked 'inline' in SPL"
113 This option determines if U-Boot forces gcc to inline the functions
114 developers have marked 'inline'. Doing so takes away freedom from gcc to
115 do what it thinks is best, which is desirable in some cases for size
118 config ARCH_SUPPORTS_LTO
122 bool "Enable Link Time Optimizations"
123 depends on ARCH_SUPPORTS_LTO
125 This option enables Link Time Optimization (LTO), a mechanism which
126 allows the compiler to optimize between different compilation units.
128 This can optimize away dead code paths, resulting in smaller binary
129 size (if CC_OPTIMIZE_FOR_SIZE is enabled).
131 This option is not available for every architecture and may
134 Currently, when compiling with GCC, due to a weird bug regarding
135 jobserver, the final linking will not respect make's --jobs argument.
136 Instead all available processors will be used (as reported by the
141 config TPL_OPTIMIZE_INLINING
142 bool "Allow compiler to uninline functions marked 'inline' in TPL"
145 This option determines if U-Boot forces gcc to inline the functions
146 developers have marked 'inline'. Doing so takes away freedom from gcc to
147 do what it thinks is best, which is desirable in some cases for size
151 bool "Enable code coverage analysis"
154 Enabling this option will pass "--coverage" to gcc to compile
155 and link code instrumented for coverage analysis.
158 bool "Enable AddressSanitizer"
161 Enables AddressSanitizer to discover out-of-bounds accesses,
162 use-after-free, double-free and memory leaks.
164 config CC_HAS_ASM_INLINE
165 def_bool $(success,echo 'void foo(void) { asm inline (""); }' | $(CC) -x c - -c -o /dev/null)
168 bool "Select U-Boot be run as a bootloader for XEN Virtual Machine"
170 Enabling this option will make U-Boot be run as a bootloader
171 for XEN [1] Virtual Machine.
173 Xen is a virtual machine monitor (VMM) or a type-1 hypervisor with support
174 for para-virtualization. Xen can organize the safe execution of several
175 virtual machines on the same physical system with performance close to
176 native. It is used as the basis for a number of different commercial and
177 open source applications, such as: server virtualization, Infrastructure
178 as a Service (IaaS), desktop virtualization, security applications,
179 embedded and hardware appliances.
180 Xen has a special VM called Domain-0 that runs the Dom0 kernel and allows
181 Xen to use the device drivers for the Domain-0 kernel by default.
183 [1] - https://xenproject.org/
185 config DISTRO_DEFAULTS
186 bool "Select defaults suitable for booting general purpose Linux distributions"
188 select CMDLINE_EDITING
189 select CMD_BOOTI if ARM64
190 select CMD_BOOTZ if ARM && !ARM64
191 select CMD_DHCP if CMD_NET
192 select CMD_ENV_EXISTS
196 select CMD_FS_GENERIC
197 select CMD_PART if PARTITIONS
198 select CMD_PING if CMD_NET
199 select CMD_PXE if NET
201 select ENV_VARS_UBOOT_CONFIG
203 select SUPPORT_RAW_INITRD
207 imply USE_BOOTCOMMAND
209 Select this to enable various options and commands which are suitable
210 for building u-boot for booting general purpose Linux distributions.
212 config ENV_VARS_UBOOT_CONFIG
213 bool "Add arch, board, vendor and soc variables to default environment"
215 Define this in order to add variables describing the
216 U-Boot build configuration to the default environment.
217 These will be named arch, cpu, board, vendor, and soc.
218 Enabling this option will cause the following to be defined:
226 int "Number of DRAM banks"
227 default 1 if ARCH_SUNXI || ARCH_OWL
230 This defines the number of DRAM banks.
232 config SYS_BOOT_GET_CMDLINE
233 bool "Enable kernel command line setup"
235 Enables allocating and saving kernel cmdline in space between
236 "bootm_low" and "bootm_low" + BOOTMAPSZ.
239 int "Size of kernel command line buffer in bytes"
240 depends on SYS_BOOT_GET_CMDLINE
243 Buffer size for Boot Arguments which are passed to the application
244 (usually a Linux kernel) when it is booted
246 config SYS_BOOT_GET_KBD
247 bool "Enable kernel board information setup"
249 Enables allocating and saving a kernel copy of the bd_info in
250 space between "bootm_low" and "bootm_low" + BOOTMAPSZ.
252 config HAS_CUSTOM_SYS_INIT_SP_ADDR
253 bool "Use a custom location for the initial stack pointer address"
254 depends on ARC || (ARM && !INIT_SP_RELATIVE) || MIPS || PPC || RISCV
257 Typically, we use an initial stack pointer address that is calculated
258 by taking the statically defined CONFIG_SYS_INIT_RAM_ADDR, adding the
259 statically defined CONFIG_SYS_INIT_RAM_SIZE and then subtracting the
260 build-time constant of GENERATED_GBL_DATA_SIZE. On MIPS a different
261 but statica calculation is performed. However, some platforms will
262 take a different approach. Say Y here to define the address statically
265 config CUSTOM_SYS_INIT_SP_ADDR
266 hex "Static location for the initial stack pointer"
267 depends on HAS_CUSTOM_SYS_INIT_SP_ADDR
268 default SYS_TEXT_BASE if TFABOOT
271 bool "Enable malloc() pool before relocation"
275 Before relocation, memory is very limited on many platforms. Still,
276 we can provide a small malloc() pool if needed. Driver model in
277 particular needs this to operate, so that it can allocate the
278 initial serial device and any others that are needed.
280 config SYS_MALLOC_F_LEN
281 hex "Size of malloc() pool before relocation"
282 depends on SYS_MALLOC_F
283 default 0x400 if M68K || PPC || ROCKCHIP_PX30 || ROCKCHIP_RK3036 || \
284 ROCKCHIP_RK3308 || ROCKCHIP_RV1108
285 default 0x600 if ARCH_ZYNQMP_R5 || ARCH_ZYNQMP
286 default 0x800 if ARCH_ZYNQ || ROCKCHIP_RK3128 || ROCKCHIP_RK3188 || \
287 ROCKCHIP_RK322X || X86
288 default 0x1000 if ARCH_MESON || ARCH_BMIPS || ARCH_MTMIPS
289 default 0x1800 if ARCH_TEGRA
290 default 0x4000 if SANDBOX || RISCV || ARCH_APPLE || ROCKCHIP_RK3368 || \
292 default 0x8000 if RCAR_GEN3
293 default 0x10000 if ARCH_IMX8 || (ARCH_IMX8M && !IMX8MQ)
296 Before relocation, memory is very limited on many platforms. Still,
297 we can provide a small malloc() pool if needed. Driver model in
298 particular needs this to operate, so that it can allocate the
299 initial serial device and any others that are needed.
301 config SYS_MALLOC_LEN
302 hex "Define memory for Dynamic allocation"
303 default 0x4000000 if SANDBOX
304 default 0x2000000 if ARCH_ROCKCHIP || ARCH_OMAP2PLUS || ARCH_MESON
305 default 0x200000 if ARCH_BMIPS || X86
306 default 0x120000 if MACH_SUNIV
307 default 0x220000 if MACH_SUN8I_V3S
308 default 0x4020000 if ARCH_SUNXI
311 This defines memory to be allocated for Dynamic allocation
312 TODO: Use for other architectures
314 config SPL_SYS_MALLOC_F_LEN
315 hex "Size of malloc() pool in SPL"
316 depends on SYS_MALLOC_F && SPL
317 default 0 if !SPL_FRAMEWORK
318 default 0x2800 if RCAR_GEN3
319 default SYS_MALLOC_F_LEN
321 In SPL memory is very limited on many platforms. Still,
322 we can provide a small malloc() pool if needed. Driver model in
323 particular needs this to operate, so that it can allocate the
324 initial serial device and any others that are needed.
326 It is possible to enable CONFIG_SYS_SPL_MALLOC_START to start a new
327 malloc() region in SDRAM once it is inited.
329 config TPL_SYS_MALLOC_F_LEN
330 hex "Size of malloc() pool in TPL"
331 depends on SYS_MALLOC_F && TPL
332 default SPL_SYS_MALLOC_F_LEN
334 In TPL memory is very limited on many platforms. Still,
335 we can provide a small malloc() pool if needed. Driver model in
336 particular needs this to operate, so that it can allocate the
337 initial serial device and any others that are needed.
340 bool "Inform valgrind about memory allocations"
343 Valgrind is an instrumentation framework for building dynamic analysis
344 tools. In particular, it may be used to detect memory management bugs
345 in U-Boot. It relies on knowing when heap blocks are allocated in
346 order to give accurate results. This happens automatically for
347 standard allocator functions provided by the host OS. However, this
348 doesn't automatically happen for U-Boot's malloc implementation.
350 Enable this option to annotate U-Boot's malloc implementation so that
351 it can be handled accurately by Valgrind. If you aren't planning on
352 using valgrind to debug U-Boot, say 'n'.
354 config VPL_SYS_MALLOC_F_LEN
355 hex "Size of malloc() pool in VPL before relocation"
356 depends on SYS_MALLOC_F && VPL
357 default SYS_MALLOC_F_LEN
359 Before relocation, memory is very limited on many platforms. Still,
360 we can provide a small malloc() pool if needed. Driver model in
361 particular needs this to operate, so that it can allocate the
362 initial serial device and any others that are needed.
365 bool "Configure standard U-Boot features (expert users)"
368 This option allows certain base U-Boot options and settings
369 to be disabled or tweaked. This is for specialized
370 environments which can tolerate a "non-standard" U-Boot.
371 Use this only if you really know what you are doing.
374 config SYS_MALLOC_CLEAR_ON_INIT
375 bool "Init with zeros the memory reserved for malloc (slow)"
378 This setting is enabled by default. The reserved malloc
379 memory is initialized with zeros, so first malloc calls
380 will return the pointer to the zeroed memory. But this
383 It is recommended to disable it, when CONFIG_SYS_MALLOC_LEN
384 value, has more than few MiB, e.g. when uses bzip2 or bmp logo.
385 Then the boot time can be significantly reduced.
387 When disabling this, please check if malloc calls, maybe
388 should be replaced by calloc - if one expects zeroed memory.
390 config SYS_MALLOC_DEFAULT_TO_INIT
391 bool "Default malloc to init while reserving the memory for it"
393 It may happen that one needs to move the dynamic allocation
394 from one to another memory range, eg. when moving the malloc
395 from the limited static to a potentially large dynamic (DDR)
398 If so then on top of setting the updated memory aside one
399 needs to bring the malloc init.
401 If such a scenario is sought choose yes.
404 bool "Enable debug information for tools"
406 Enable generation of debug information for tools such as mkimage.
407 This can be used for debugging purposes. With debug information
408 it is possible to set breakpoints on particular lines, single-step
409 debug through the source code, etc.
414 bool "64bit physical address support"
416 Say Y here to support 64bit physical memory address.
417 This can be used not only for 64bit SoCs, but also for
418 large physical address extension on 32bit SoCs.
424 Enables building of a u-boot.rom target. This collects U-Boot and
425 any necessary binary blobs.
428 string "SPL image used in the combined SPL+U-Boot image"
429 default "spl/boot.bin" if ARCH_AT91 && SPL_NAND_SUPPORT
430 default "spl/u-boot-spl.bin"
433 Select the SPL build target that shall be generated by the SPL
434 build process (default spl/u-boot-spl.bin). This image will be
435 used to generate a combined image with SPL and main U-Boot
436 proper as one single image.
439 bool "Recreate an ELF image from raw U-Boot binary"
441 Enable this to recreate an ELF image (u-boot.elf) from the raw
442 U-Boot binary (u-boot.bin), which may already have been statically
443 relocated and may already have a device-tree appended to it.
446 string "Build target special images"
447 default "u-boot-with-spl.sfp" if TARGET_SOCFPGA_ARRIA10
448 default "u-boot-with-spl.sfp" if TARGET_SOCFPGA_GEN5
449 default "u-boot-spl.kwb" if ARCH_MVEBU && SPL
450 default "u-boot-elf.srec" if RCAR_GEN3
451 default "u-boot.itb" if !BINMAN && SPL_LOAD_FIT && (ARCH_ROCKCHIP || \
452 ARCH_SUNXI || RISCV || ARCH_ZYNQMP)
453 default "u-boot.kwb" if ARCH_KIRKWOOD
454 default "u-boot-with-spl.bin" if ARCH_AT91 && SPL_NAND_SUPPORT
455 default "u-boot-with-spl.imx" if ARCH_MX6 && SPL
457 Some SoCs need special image types (e.g. U-Boot binary
458 with a special header) as build targets. By defining
459 CONFIG_BUILD_TARGET in the SoC / board header, this
460 special image will be automatically built upon calling
463 config HAS_BOARD_SIZE_LIMIT
464 bool "Define a maximum size for the U-Boot image"
465 default y if RCAR_GEN3
467 In some cases, we need to enforce a hard limit on how big the U-Boot
470 config BOARD_SIZE_LIMIT
471 int "Maximum size of the U-Boot image in bytes"
472 default 1048576 if RCAR_GEN3
473 depends on HAS_BOARD_SIZE_LIMIT
475 Maximum size of the U-Boot image. When defined, the build system
476 checks that the actual size does not exceed it. This does not
477 include SPL nor TPL, on platforms that use that functionality, they
478 have a separate option to restict size.
480 config SYS_CUSTOM_LDSCRIPT
481 bool "Use a custom location for the U-Boot linker script"
483 Normally when linking U-Boot we will look in the board directory,
484 the CPU directory and finally the "cpu" directory of the architecture
485 for the ile "u-boot.lds" and use that as our linker. However, in
486 some cases we need to provide a different linker script. To do so,
487 enable this option and then provide the location under
491 depends on SYS_CUSTOM_LDSCRIPT
492 string "Custom ldscript location"
494 Path within the source tree to the linker script to use for the
498 hex "Address in memory to use by default"
499 default 0x01000000 if ARCH_SOCFPGA
500 default 0x02000000 if PPC || X86
501 default 0x81000000 if MACH_SUNIV
502 default 0x22000000 if MACH_SUN9I
503 default 0x42000000 if ARCH_SUNXI
504 default 0x82000000 if ARCH_KEYSTONE || ARCH_OMAP2PLUS || ARCH_K3
505 default 0x82000000 if ARCH_MX6 && (MX6SL || MX6SLL || MX6SX || MX6UL || MX6ULL)
506 default 0x12000000 if ARCH_MX6 && !(MX6SL || MX6SLL || MX6SX || MX6UL || MX6ULL)
507 default 0x80800000 if ARCH_MX7
508 default 0x90000000 if FSL_LSCH2 || FSL_LSCH3
510 Address in memory to use as the default safe load address.
512 config ERR_PTR_OFFSET
516 Some U-Boot pointers have redundant information, so we can use a
517 scheme where we can return either an error code or a pointer with the
518 same return value. The default implementation just casts the pointer
519 to a number, however, this may fail on platforms where the end of the
520 address range is used for valid pointers (e.g. 0xffffff00 is a valid
521 heap pointer in socfpga SPL).
522 For such platforms, this value provides an upper range of those error
523 pointer values - up to 'MAX_ERRNO' bytes below this value must be
524 unused/invalid addresses.
526 config PLATFORM_ELFENTRY
528 default "__start" if MIPS
532 hex "Define max stack size that can be used by U-Boot"
533 default 0x4000000 if ARCH_VERSAL || ARCH_ZYNQMP
534 default 0x200000 if MICROBLAZE
537 Define Max stack size that can be used by U-Boot. This value is used
538 by the UEFI sub-system. On some boards initrd_high is calculated as
539 base stack pointer minus this stack size.
541 config SYS_MEM_TOP_HIDE
542 hex "Exclude some memory from U-Boot / OS information"
545 If set, this specified memory area will get subtracted from the top
546 (end) of RAM and won't get "touched" at all by U-Boot. By fixing up
547 gd->ram_size the OS / next stage should gets passed the now
548 "corrected" memory size and won't touch it either.
549 WARNING: Please make sure that this value is a multiple of the OS
554 default y if TARGET_PIC32MZDASK
555 default y if TARGET_DEVKIT8000
556 default y if TARGET_TRICORDER
558 Enable this to allow support for the on board SRAM.
559 SRAM base address is controlled by CONFIG_SYS_SRAM_BASE.
560 SRAM size is controlled by CONFIG_SYS_SRAM_SIZE.
564 default 0x80000000 if TARGET_PIC32MZDASK
565 default 0x40200000 if TARGET_DEVKIT8000
566 default 0x40200000 if TARGET_TRICORDER
571 default 0x00080000 if TARGET_PIC32MZDASK
572 default 0x10000 if TARGET_DEVKIT8000
573 default 0x10000 if TARGET_TRICORDER
577 bool "Support for multiprocessor"
579 This provides an option to bringup different processors
580 in multiprocessor cases.
583 bool "Compile API examples"
585 default y if ARCH_QEMU
587 U-Boot provides an API for standalone applications. Examples are
588 provided in directory examples/.
590 endmenu # General setup
594 source "boot/Kconfig"
596 source "common/Kconfig"
600 source "disk/Kconfig"
608 source "drivers/Kconfig"
614 source "test/Kconfig"
616 source "tools/Kconfig"