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.
165 bool "Enable fuzzing"
166 depends on CC_IS_CLANG
167 depends on DM_FUZZING_ENGINE
170 Enables the fuzzing infrastructure to generate fuzzing data and run
173 config CC_HAS_ASM_INLINE
174 def_bool $(success,echo 'void foo(void) { asm inline (""); }' | $(CC) -x c - -c -o /dev/null)
177 bool "Select U-Boot be run as a bootloader for XEN Virtual Machine"
179 Enabling this option will make U-Boot be run as a bootloader
180 for XEN [1] Virtual Machine.
182 Xen is a virtual machine monitor (VMM) or a type-1 hypervisor with support
183 for para-virtualization. Xen can organize the safe execution of several
184 virtual machines on the same physical system with performance close to
185 native. It is used as the basis for a number of different commercial and
186 open source applications, such as: server virtualization, Infrastructure
187 as a Service (IaaS), desktop virtualization, security applications,
188 embedded and hardware appliances.
189 Xen has a special VM called Domain-0 that runs the Dom0 kernel and allows
190 Xen to use the device drivers for the Domain-0 kernel by default.
192 [1] - https://xenproject.org/
194 config DISTRO_DEFAULTS
195 bool "Select defaults suitable for booting general purpose Linux distributions"
197 select CMDLINE_EDITING
198 select CMD_BOOTI if ARM64
199 select CMD_BOOTZ if ARM && !ARM64
200 select CMD_DHCP if CMD_NET
201 select CMD_ENV_EXISTS
205 select CMD_FS_GENERIC
206 select CMD_PART if PARTITIONS
207 select CMD_PING if CMD_NET
208 select CMD_PXE if NET
210 select ENV_VARS_UBOOT_CONFIG
212 select SUPPORT_RAW_INITRD
216 imply USE_BOOTCOMMAND
218 Select this to enable various options and commands which are suitable
219 for building u-boot for booting general purpose Linux distributions.
221 config ENV_VARS_UBOOT_CONFIG
222 bool "Add arch, board, vendor and soc variables to default environment"
224 Define this in order to add variables describing the
225 U-Boot build configuration to the default environment.
226 These will be named arch, cpu, board, vendor, and soc.
227 Enabling this option will cause the following to be defined:
235 int "Number of DRAM banks"
236 default 1 if ARCH_SUNXI || ARCH_OWL
239 This defines the number of DRAM banks.
241 config SYS_BOOT_GET_CMDLINE
242 bool "Enable kernel command line setup"
244 Enables allocating and saving kernel cmdline in space between
245 "bootm_low" and "bootm_low" + BOOTMAPSZ.
248 int "Size of kernel command line buffer in bytes"
249 depends on SYS_BOOT_GET_CMDLINE
252 Buffer size for Boot Arguments which are passed to the application
253 (usually a Linux kernel) when it is booted
255 config SYS_BOOT_GET_KBD
256 bool "Enable kernel board information setup"
258 Enables allocating and saving a kernel copy of the bd_info in
259 space between "bootm_low" and "bootm_low" + BOOTMAPSZ.
261 config HAS_CUSTOM_SYS_INIT_SP_ADDR
262 bool "Use a custom location for the initial stack pointer address"
263 depends on ARC || (ARM && !INIT_SP_RELATIVE) || MIPS || PPC || RISCV
266 Typically, we use an initial stack pointer address that is calculated
267 by taking the statically defined CFG_SYS_INIT_RAM_ADDR, adding the
268 statically defined CFG_SYS_INIT_RAM_SIZE and then subtracting the
269 build-time constant of GENERATED_GBL_DATA_SIZE. On MIPS a different
270 but statica calculation is performed. However, some platforms will
271 take a different approach. Say Y here to define the address statically
274 config CUSTOM_SYS_INIT_SP_ADDR
275 hex "Static location for the initial stack pointer"
276 depends on HAS_CUSTOM_SYS_INIT_SP_ADDR
277 default TEXT_BASE if TFABOOT
280 bool "Enable malloc() pool before relocation"
284 Before relocation, memory is very limited on many platforms. Still,
285 we can provide a small malloc() pool if needed. Driver model in
286 particular needs this to operate, so that it can allocate the
287 initial serial device and any others that are needed.
289 config SYS_MALLOC_F_LEN
290 hex "Size of malloc() pool before relocation"
291 depends on SYS_MALLOC_F
292 default 0x400 if M68K || PPC || ROCKCHIP_PX30 || ROCKCHIP_RK3036 || \
293 ROCKCHIP_RK3308 || ROCKCHIP_RV1108
294 default 0x600 if ARCH_ZYNQMP_R5 || ARCH_ZYNQMP
295 default 0x800 if ARCH_ZYNQ || ROCKCHIP_RK3128 || ROCKCHIP_RK3188 || \
296 ROCKCHIP_RK322X || X86
297 default 0x1000 if ARCH_MESON || ARCH_BMIPS || ARCH_MTMIPS
298 default 0x1800 if ARCH_TEGRA
299 default 0x4000 if SANDBOX || RISCV || ARCH_APPLE || ROCKCHIP_RK3368 || \
301 default 0x8000 if RCAR_GEN3
302 default 0x10000 if ARCH_IMX8 || ARCH_IMX8M
305 Before relocation, memory is very limited on many platforms. Still,
306 we can provide a small malloc() pool if needed. Driver model in
307 particular needs this to operate, so that it can allocate the
308 initial serial device and any others that are needed.
310 config SYS_MALLOC_LEN
311 hex "Define memory for Dynamic allocation"
312 default 0x4000000 if SANDBOX
313 default 0x2000000 if ARCH_ROCKCHIP || ARCH_OMAP2PLUS || ARCH_MESON
314 default 0x200000 if ARCH_BMIPS || X86
315 default 0x4020000 if SUNXI_MINIMUM_DRAM_MB >= 256
316 default 0x220000 if SUNXI_MINIMUM_DRAM_MB >= 64
317 default 0x120000 if SUNXI_MINIMUM_DRAM_MB >= 32
320 This defines memory to be allocated for Dynamic allocation
321 TODO: Use for other architectures
323 config SPL_SYS_MALLOC_F_LEN
324 hex "Size of malloc() pool in SPL"
325 depends on SYS_MALLOC_F && SPL
326 default 0 if !SPL_FRAMEWORK
327 default 0x2800 if RCAR_GEN3
328 default 0x2000 if IMX8MQ
329 default SYS_MALLOC_F_LEN
331 In SPL memory is very limited on many platforms. Still,
332 we can provide a small malloc() pool if needed. Driver model in
333 particular needs this to operate, so that it can allocate the
334 initial serial device and any others that are needed.
336 It is possible to enable CFG_SYS_SPL_MALLOC_START to start a new
337 malloc() region in SDRAM once it is inited.
339 config TPL_SYS_MALLOC_F_LEN
340 hex "Size of malloc() pool in TPL"
341 depends on SYS_MALLOC_F && TPL
342 default SPL_SYS_MALLOC_F_LEN
344 In TPL memory is very limited on many platforms. Still,
345 we can provide a small malloc() pool if needed. Driver model in
346 particular needs this to operate, so that it can allocate the
347 initial serial device and any others that are needed.
350 bool "Inform valgrind about memory allocations"
353 Valgrind is an instrumentation framework for building dynamic analysis
354 tools. In particular, it may be used to detect memory management bugs
355 in U-Boot. It relies on knowing when heap blocks are allocated in
356 order to give accurate results. This happens automatically for
357 standard allocator functions provided by the host OS. However, this
358 doesn't automatically happen for U-Boot's malloc implementation.
360 Enable this option to annotate U-Boot's malloc implementation so that
361 it can be handled accurately by Valgrind. If you aren't planning on
362 using valgrind to debug U-Boot, say 'n'.
364 config VPL_SYS_MALLOC_F_LEN
365 hex "Size of malloc() pool in VPL before relocation"
366 depends on SYS_MALLOC_F && VPL
367 default SYS_MALLOC_F_LEN
369 Before relocation, memory is very limited on many platforms. Still,
370 we can provide a small malloc() pool if needed. Driver model in
371 particular needs this to operate, so that it can allocate the
372 initial serial device and any others that are needed.
375 bool "Configure standard U-Boot features (expert users)"
378 This option allows certain base U-Boot options and settings
379 to be disabled or tweaked. This is for specialized
380 environments which can tolerate a "non-standard" U-Boot.
381 Use this only if you really know what you are doing.
384 config SYS_MALLOC_CLEAR_ON_INIT
385 bool "Init with zeros the memory reserved for malloc (slow)"
388 This setting is enabled by default. The reserved malloc
389 memory is initialized with zeros, so first malloc calls
390 will return the pointer to the zeroed memory. But this
393 It is recommended to disable it, when CONFIG_SYS_MALLOC_LEN
394 value, has more than few MiB, e.g. when uses bzip2 or bmp logo.
395 Then the boot time can be significantly reduced.
397 When disabling this, please check if malloc calls, maybe
398 should be replaced by calloc - if one expects zeroed memory.
400 config SYS_MALLOC_DEFAULT_TO_INIT
401 bool "Default malloc to init while reserving the memory for it"
403 It may happen that one needs to move the dynamic allocation
404 from one to another memory range, eg. when moving the malloc
405 from the limited static to a potentially large dynamic (DDR)
408 If so then on top of setting the updated memory aside one
409 needs to bring the malloc init.
411 If such a scenario is sought choose yes.
414 bool "Enable debug information for tools"
416 Enable generation of debug information for tools such as mkimage.
417 This can be used for debugging purposes. With debug information
418 it is possible to set breakpoints on particular lines, single-step
419 debug through the source code, etc.
424 bool "64bit physical address support"
426 Say Y here to support 64bit physical memory address.
427 This can be used not only for 64bit SoCs, but also for
428 large physical address extension on 32bit SoCs.
434 Enables building of a u-boot.rom target. This collects U-Boot and
435 any necessary binary blobs.
438 string "SPL image used in the combined SPL+U-Boot image"
439 default "spl/boot.bin" if ARCH_AT91 && SPL_NAND_SUPPORT
440 default "spl/u-boot-spl.bin"
443 Select the SPL build target that shall be generated by the SPL
444 build process (default spl/u-boot-spl.bin). This image will be
445 used to generate a combined image with SPL and main U-Boot
446 proper as one single image.
449 bool "Recreate an ELF image from raw U-Boot binary"
451 Enable this to recreate an ELF image (u-boot.elf) from the raw
452 U-Boot binary (u-boot.bin), which may already have been statically
453 relocated and may already have a device-tree appended to it.
456 string "Build target special images"
457 default "u-boot-with-spl.sfp" if TARGET_SOCFPGA_ARRIA10
458 default "u-boot-with-spl.sfp" if TARGET_SOCFPGA_GEN5
459 default "u-boot-with-spl.kwb" if ARMADA_32BIT && SPL
460 default "u-boot-elf.srec" if RCAR_GEN3
461 default "u-boot.itb" if !BINMAN && SPL_LOAD_FIT && (ARCH_ROCKCHIP || \
462 ARCH_SUNXI || RISCV || ARCH_ZYNQMP)
463 default "u-boot.kwb" if (ARCH_KIRKWOOD || ARMADA_32BIT) && !SPL
464 default "u-boot-with-spl.bin" if MPC85xx && !E500MC && !E5500 && !E6500 && SPL
465 default "u-boot-with-spl.bin" if ARCH_AT91 && SPL_NAND_SUPPORT
466 default "u-boot-with-spl.imx" if ARCH_MX6 && SPL
468 Some SoCs need special image types (e.g. U-Boot binary
469 with a special header) as build targets. By defining
470 CONFIG_BUILD_TARGET in the SoC / board header, this
471 special image will be automatically built upon calling
474 config HAS_BOARD_SIZE_LIMIT
475 bool "Define a maximum size for the U-Boot image"
476 default y if RCAR_GEN3
478 In some cases, we need to enforce a hard limit on how big the U-Boot
481 config BOARD_SIZE_LIMIT
482 int "Maximum size of the U-Boot image in bytes"
483 default 1048576 if RCAR_GEN3
484 depends on HAS_BOARD_SIZE_LIMIT
486 Maximum size of the U-Boot image. When defined, the build system
487 checks that the actual size does not exceed it. This does not
488 include SPL nor TPL, on platforms that use that functionality, they
489 have a separate option to restict size.
491 config SYS_CUSTOM_LDSCRIPT
492 bool "Use a custom location for the U-Boot linker script"
494 Normally when linking U-Boot we will look in the board directory,
495 the CPU directory and finally the "cpu" directory of the architecture
496 for the ile "u-boot.lds" and use that as our linker. However, in
497 some cases we need to provide a different linker script. To do so,
498 enable this option and then provide the location under
502 depends on SYS_CUSTOM_LDSCRIPT
503 string "Custom ldscript location"
505 Path within the source tree to the linker script to use for the
509 hex "Address in memory to use by default"
510 default 0x01000000 if ARCH_SOCFPGA
511 default 0x02000000 if PPC || X86
512 default 0x81000000 if MACH_SUNIV
513 default 0x22000000 if MACH_SUN9I
514 default 0x42000000 if ARCH_SUNXI
515 default 0x82000000 if ARCH_KEYSTONE || ARCH_OMAP2PLUS || ARCH_K3
516 default 0x82000000 if ARCH_MX6 && (MX6SL || MX6SLL || MX6SX || MX6UL || MX6ULL)
517 default 0x12000000 if ARCH_MX6 && !(MX6SL || MX6SLL || MX6SX || MX6UL || MX6ULL)
518 default 0x80800000 if ARCH_MX7
519 default 0x90000000 if FSL_LSCH2 || FSL_LSCH3
521 Address in memory to use as the default safe load address.
523 config ERR_PTR_OFFSET
527 Some U-Boot pointers have redundant information, so we can use a
528 scheme where we can return either an error code or a pointer with the
529 same return value. The default implementation just casts the pointer
530 to a number, however, this may fail on platforms where the end of the
531 address range is used for valid pointers (e.g. 0xffffff00 is a valid
532 heap pointer in socfpga SPL).
533 For such platforms, this value provides an upper range of those error
534 pointer values - up to 'MAX_ERRNO' bytes below this value must be
535 unused/invalid addresses.
537 config PLATFORM_ELFENTRY
539 default "__start" if MIPS
543 hex "Define max stack size that can be used by U-Boot"
544 default 0x4000000 if ARCH_VERSAL_NET || ARCH_VERSAL || ARCH_ZYNQMP
545 default 0x200000 if MICROBLAZE
548 Define Max stack size that can be used by U-Boot. This value is used
549 by the UEFI sub-system. On some boards initrd_high is calculated as
550 base stack pointer minus this stack size.
552 config SYS_MEM_TOP_HIDE
553 hex "Exclude some memory from U-Boot / OS information"
556 If set, this specified memory area will get subtracted from the top
557 (end) of RAM and won't get "touched" at all by U-Boot. By fixing up
558 gd->ram_size the OS / next stage should gets passed the now
559 "corrected" memory size and won't touch it either.
560 WARNING: Please make sure that this value is a multiple of the OS
565 default y if TARGET_PIC32MZDASK
566 default y if TARGET_DEVKIT8000
567 default y if TARGET_TRICORDER
569 Enable this to allow support for the on board SRAM.
570 SRAM base address is controlled by CONFIG_SYS_SRAM_BASE.
571 SRAM size is controlled by CONFIG_SYS_SRAM_SIZE.
575 default 0x80000000 if TARGET_PIC32MZDASK
576 default 0x40200000 if TARGET_DEVKIT8000
577 default 0x40200000 if TARGET_TRICORDER
582 default 0x00080000 if TARGET_PIC32MZDASK
583 default 0x10000 if TARGET_DEVKIT8000
584 default 0x10000 if TARGET_TRICORDER
587 config SYS_MONITOR_LEN
588 int "Maximum size in bytes reserved for U-Boot in memory"
589 default 1048576 if X86
590 default 786432 if ARCH_SUNXI
593 Size of memory reserved for monitor code, used to determine
594 _at_compile_time_ (!) if the environment is embedded within the
595 U-Boot image, or in a separate flash sector, among other uses where
596 we need to set a maximum size of the U-Boot binary itself that will
600 bool "Support for multiprocessor"
602 This provides an option to bringup different processors
603 in multiprocessor cases.
606 bool "Compile API examples"
608 default y if ARCH_QEMU
610 U-Boot provides an API for standalone applications. Examples are
611 provided in directory examples/.
613 endmenu # General setup
617 source "boot/Kconfig"
619 source "common/Kconfig"
623 source "disk/Kconfig"
631 source "drivers/Kconfig"
637 source "test/Kconfig"
639 source "tools/Kconfig"