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 ARCH_MVEBU && 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
464 default "u-boot-with-spl.bin" if ARCH_AT91 && SPL_NAND_SUPPORT
465 default "u-boot-with-spl.imx" if ARCH_MX6 && SPL
467 Some SoCs need special image types (e.g. U-Boot binary
468 with a special header) as build targets. By defining
469 CONFIG_BUILD_TARGET in the SoC / board header, this
470 special image will be automatically built upon calling
473 config HAS_BOARD_SIZE_LIMIT
474 bool "Define a maximum size for the U-Boot image"
475 default y if RCAR_GEN3
477 In some cases, we need to enforce a hard limit on how big the U-Boot
480 config BOARD_SIZE_LIMIT
481 int "Maximum size of the U-Boot image in bytes"
482 default 1048576 if RCAR_GEN3
483 depends on HAS_BOARD_SIZE_LIMIT
485 Maximum size of the U-Boot image. When defined, the build system
486 checks that the actual size does not exceed it. This does not
487 include SPL nor TPL, on platforms that use that functionality, they
488 have a separate option to restict size.
490 config SYS_CUSTOM_LDSCRIPT
491 bool "Use a custom location for the U-Boot linker script"
493 Normally when linking U-Boot we will look in the board directory,
494 the CPU directory and finally the "cpu" directory of the architecture
495 for the ile "u-boot.lds" and use that as our linker. However, in
496 some cases we need to provide a different linker script. To do so,
497 enable this option and then provide the location under
501 depends on SYS_CUSTOM_LDSCRIPT
502 string "Custom ldscript location"
504 Path within the source tree to the linker script to use for the
508 hex "Address in memory to use by default"
509 default 0x01000000 if ARCH_SOCFPGA
510 default 0x02000000 if PPC || X86
511 default 0x81000000 if MACH_SUNIV
512 default 0x22000000 if MACH_SUN9I
513 default 0x42000000 if ARCH_SUNXI
514 default 0x82000000 if ARCH_KEYSTONE || ARCH_OMAP2PLUS || ARCH_K3
515 default 0x82000000 if ARCH_MX6 && (MX6SL || MX6SLL || MX6SX || MX6UL || MX6ULL)
516 default 0x12000000 if ARCH_MX6 && !(MX6SL || MX6SLL || MX6SX || MX6UL || MX6ULL)
517 default 0x80800000 if ARCH_MX7
518 default 0x90000000 if FSL_LSCH2 || FSL_LSCH3
520 Address in memory to use as the default safe load address.
522 config ERR_PTR_OFFSET
526 Some U-Boot pointers have redundant information, so we can use a
527 scheme where we can return either an error code or a pointer with the
528 same return value. The default implementation just casts the pointer
529 to a number, however, this may fail on platforms where the end of the
530 address range is used for valid pointers (e.g. 0xffffff00 is a valid
531 heap pointer in socfpga SPL).
532 For such platforms, this value provides an upper range of those error
533 pointer values - up to 'MAX_ERRNO' bytes below this value must be
534 unused/invalid addresses.
536 config PLATFORM_ELFENTRY
538 default "__start" if MIPS
542 hex "Define max stack size that can be used by U-Boot"
543 default 0x4000000 if ARCH_VERSAL_NET || ARCH_VERSAL || ARCH_ZYNQMP
544 default 0x200000 if MICROBLAZE
547 Define Max stack size that can be used by U-Boot. This value is used
548 by the UEFI sub-system. On some boards initrd_high is calculated as
549 base stack pointer minus this stack size.
551 config SYS_MEM_TOP_HIDE
552 hex "Exclude some memory from U-Boot / OS information"
555 If set, this specified memory area will get subtracted from the top
556 (end) of RAM and won't get "touched" at all by U-Boot. By fixing up
557 gd->ram_size the OS / next stage should gets passed the now
558 "corrected" memory size and won't touch it either.
559 WARNING: Please make sure that this value is a multiple of the OS
564 default y if TARGET_PIC32MZDASK
565 default y if TARGET_DEVKIT8000
566 default y if TARGET_TRICORDER
568 Enable this to allow support for the on board SRAM.
569 SRAM base address is controlled by CONFIG_SYS_SRAM_BASE.
570 SRAM size is controlled by CONFIG_SYS_SRAM_SIZE.
574 default 0x80000000 if TARGET_PIC32MZDASK
575 default 0x40200000 if TARGET_DEVKIT8000
576 default 0x40200000 if TARGET_TRICORDER
581 default 0x00080000 if TARGET_PIC32MZDASK
582 default 0x10000 if TARGET_DEVKIT8000
583 default 0x10000 if TARGET_TRICORDER
586 config SYS_MONITOR_LEN
587 int "Maximum size in bytes reserved for U-Boot in memory"
588 default 1048576 if X86
591 Size of memory reserved for monitor code, used to determine
592 _at_compile_time_ (!) if the environment is embedded within the
593 U-Boot image, or in a separate flash sector, among other uses where
594 we need to set a maximum size of the U-Boot binary itself that will
598 bool "Support for multiprocessor"
600 This provides an option to bringup different processors
601 in multiprocessor cases.
604 bool "Compile API examples"
606 default y if ARCH_QEMU
608 U-Boot provides an API for standalone applications. Examples are
609 provided in directory examples/.
611 endmenu # General setup
615 source "boot/Kconfig"
617 source "common/Kconfig"
621 source "disk/Kconfig"
629 source "drivers/Kconfig"
635 source "test/Kconfig"
637 source "tools/Kconfig"