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 source "scripts/Kconfig.include"
10 # Allow defaults in arch-specific code to override any given here
18 This option cannot be enabled. It is used as dependency
19 for broken and incomplete features.
24 This option cannot be enabled. It it used as a dependency for
25 code that relies on deprecated features that will be removed and
26 the conversion deadline has passed.
29 string "Local version - append to U-Boot release"
31 Append an extra string to the end of your U-Boot version.
32 This will show up in your boot log, for example.
33 The string you set here will be appended after the contents of
34 any files with a filename matching localversion* in your
35 object and source tree, in that order. Your total string can
36 be a maximum of 64 characters.
38 config LOCALVERSION_AUTO
39 bool "Automatically append version information to the version string"
42 This will try to automatically determine if the current tree is a
43 release tree by looking for Git tags that belong to the current
46 A string of the format -gxxxxxxxx will be added to the localversion
47 if a Git-based tree is found. The string generated by this will be
48 appended after any matching localversion* files, and after the value
49 set in CONFIG_LOCALVERSION.
51 (The actual string used here is the first eight characters produced
52 by running the command:
54 $ git rev-parse --verify HEAD
56 which is done within the script "scripts/setlocalversion".)
58 config CC_OPTIMIZE_FOR_SIZE
59 bool "Optimize for size"
62 Enabling this option will pass "-Os" instead of "-O2" to gcc
63 resulting in a smaller U-Boot image.
65 This option is enabled by default for U-Boot.
68 bool "Enable code coverage analysis"
71 Enabling this option will pass "--coverage" to gcc to compile
72 and link code instrumented for coverage analysis.
74 config DISTRO_DEFAULTS
75 bool "Select defaults suitable for booting general purpose Linux distributions"
77 select CMDLINE_EDITING
78 select CMD_BOOTI if ARM64
79 select CMD_BOOTZ if ARM && !ARM64
80 select CMD_DHCP if CMD_NET
86 select CMD_PART if PARTITIONS
87 select CMD_PING if CMD_NET
90 select ENV_VARS_UBOOT_CONFIG
92 select SUPPORT_RAW_INITRD
98 Select this to enable various options and commands which are suitable
99 for building u-boot for booting general purpose Linux distributions.
101 config ENV_VARS_UBOOT_CONFIG
102 bool "Add arch, board, vendor and soc variables to default environment"
104 Define this in order to add variables describing the
105 U-Boot build configuration to the default environment.
106 These will be named arch, cpu, board, vendor, and soc.
107 Enabling this option will cause the following to be defined:
115 int "Number of DRAM banks"
116 default 1 if ARCH_SUNXI || ARCH_OWL
119 This defines the number of DRAM banks.
121 config SYS_BOOT_GET_CMDLINE
122 bool "Enable kernel command line setup"
124 Enables allocating and saving kernel cmdline in space between
125 "bootm_low" and "bootm_low" + BOOTMAPSZ.
127 config SYS_BOOT_GET_KBD
128 bool "Enable kernel board information setup"
130 Enables allocating and saving a kernel copy of the bd_info in
131 space between "bootm_low" and "bootm_low" + BOOTMAPSZ.
134 bool "Enable malloc() pool before relocation"
138 Before relocation, memory is very limited on many platforms. Still,
139 we can provide a small malloc() pool if needed. Driver model in
140 particular needs this to operate, so that it can allocate the
141 initial serial device and any others that are needed.
143 config SYS_MALLOC_F_LEN
144 hex "Size of malloc() pool before relocation"
145 depends on SYS_MALLOC_F
146 default 0x1000 if AM33XX
147 default 0x2800 if SANDBOX
148 default 0x2000 if (ARCH_IMX8 || ARCH_IMX8M || ARCH_MX7 || \
149 ARCH_MX7ULP || ARCH_MX6 || ARCH_MX5 || \
150 ARCH_LS1012A || ARCH_LS1021A || ARCH_LS1043A || \
151 ARCH_LS1046A || ARCH_QEMU)
154 Before relocation, memory is very limited on many platforms. Still,
155 we can provide a small malloc() pool if needed. Driver model in
156 particular needs this to operate, so that it can allocate the
157 initial serial device and any others that are needed.
159 config SYS_MALLOC_LEN
160 hex "Define memory for Dynamic allocation"
161 depends on ARCH_ZYNQ || ARCH_VERSAL || ARCH_STM32MP || ARCH_ROCKCHIP
162 default 0x2000000 if ARCH_ROCKCHIP
164 This defines memory to be allocated for Dynamic allocation
165 TODO: Use for other architectures
167 config SPL_SYS_MALLOC_F_LEN
168 hex "Size of malloc() pool in SPL before relocation"
169 depends on SYS_MALLOC_F && SPL
170 default 0x2800 if RCAR_GEN3
171 default SYS_MALLOC_F_LEN
173 Before relocation, memory is very limited on many platforms. Still,
174 we can provide a small malloc() pool if needed. Driver model in
175 particular needs this to operate, so that it can allocate the
176 initial serial device and any others that are needed.
178 config TPL_SYS_MALLOC_F_LEN
179 hex "Size of malloc() pool in TPL before relocation"
180 depends on SYS_MALLOC_F && TPL
181 default SYS_MALLOC_F_LEN
183 Before relocation, memory is very limited on many platforms. Still,
184 we can provide a small malloc() pool if needed. Driver model in
185 particular needs this to operate, so that it can allocate the
186 initial serial device and any others that are needed.
189 bool "Configure standard U-Boot features (expert users)"
192 This option allows certain base U-Boot options and settings
193 to be disabled or tweaked. This is for specialized
194 environments which can tolerate a "non-standard" U-Boot.
195 Use this only if you really know what you are doing.
198 config SYS_MALLOC_CLEAR_ON_INIT
199 bool "Init with zeros the memory reserved for malloc (slow)"
202 This setting is enabled by default. The reserved malloc
203 memory is initialized with zeros, so first malloc calls
204 will return the pointer to the zeroed memory. But this
207 It is recommended to disable it, when CONFIG_SYS_MALLOC_LEN
208 value, has more than few MiB, e.g. when uses bzip2 or bmp logo.
209 Then the boot time can be significantly reduced.
211 When disabling this, please check if malloc calls, maybe
212 should be replaced by calloc - if one expects zeroed memory.
214 config SYS_MALLOC_DEFAULT_TO_INIT
215 bool "Default malloc to init while reserving the memory for it"
218 It may happen that one needs to move the dynamic allocation
219 from one to another memory range, eg. when moving the malloc
220 from the limited static to a potentially large dynamic (DDR)
223 If so then on top of setting the updated memory aside one
224 needs to bring the malloc init.
226 If such a scenario is sought choose yes.
229 bool "Enable debug information for tools"
231 Enable generation of debug information for tools such as mkimage.
232 This can be used for debugging purposes. With debug information
233 it is possible to set breakpoints on particular lines, single-step
234 debug through the source code, etc.
239 bool "64bit physical address support"
241 Say Y here to support 64bit physical memory address.
242 This can be used not only for 64bit SoCs, but also for
243 large physical address extension on 32bit SoCs.
246 bool "Build U-Boot as BIOS replacement"
249 This option allows to build a ROM version of U-Boot.
250 The build process generally requires several binary blobs
251 which are not shipped in the U-Boot source tree.
252 Please, see doc/arch/x86.rst for details.
255 string "SPL image used in the combined SPL+U-Boot image"
256 default "spl/boot.bin" if ARCH_AT91 && SPL_NAND_SUPPORT
257 default "spl/u-boot-spl.bin"
260 Select the SPL build target that shall be generated by the SPL
261 build process (default spl/u-boot-spl.bin). This image will be
262 used to generate a combined image with SPL and main U-Boot
263 proper as one single image.
266 string "Build target special images"
267 default "u-boot-with-spl.sfp" if TARGET_SOCFPGA_ARRIA10
268 default "u-boot-with-spl.sfp" if TARGET_SOCFPGA_GEN5
269 default "u-boot-spl.kwb" if ARCH_MVEBU && SPL
270 default "u-boot-elf.srec" if RCAR_GEN3
271 default "u-boot.itb" if SPL_LOAD_FIT && (ARCH_ROCKCHIP || \
272 ARCH_SUNXI || RISCV || ARCH_ZYNQMP)
273 default "u-boot.kwb" if ARCH_KIRKWOOD
274 default "u-boot-with-spl.bin" if ARCH_AT91 && SPL_NAND_SUPPORT
275 default "u-boot-with-spl.imx" if ARCH_MX6 && SPL
277 Some SoCs need special image types (e.g. U-Boot binary
278 with a special header) as build targets. By defining
279 CONFIG_BUILD_TARGET in the SoC / board header, this
280 special image will be automatically built upon calling
283 config SYS_CUSTOM_LDSCRIPT
284 bool "Use a custom location for the U-Boot linker script"
286 Normally when linking U-Boot we will look in the board directory,
287 the CPU directory and finally the "cpu" directory of the architecture
288 for the ile "u-boot.lds" and use that as our linker. However, in
289 some cases we need to provide a different linker script. To do so,
290 enable this option and then provide the location under
294 depends on SYS_CUSTOM_LDSCRIPT
295 string "Custom ldscript location"
297 Path within the source tree to the linker script to use for the
300 config ERR_PTR_OFFSET
304 Some U-Boot pointers have redundant information, so we can use a
305 scheme where we can return either an error code or a pointer with the
306 same return value. The default implementation just casts the pointer
307 to a number, however, this may fail on platforms where the end of the
308 address range is used for valid pointers (e.g. 0xffffff00 is a valid
309 heap pointer in socfpga SPL).
310 For such platforms, this value provides an upper range of those error
311 pointer values - up to 'MAX_ERRNO' bytes below this value must be
312 unused/invalid addresses.
314 config PLATFORM_ELFENTRY
316 default "__start" if MIPS
319 endmenu # General setup
323 config ANDROID_BOOT_IMAGE
324 bool "Enable support for Android Boot Images"
325 default y if FASTBOOT
327 This enables support for booting images which use the Android
331 bool "Support Flattened Image Tree"
335 This option allows you to boot the new uImage structure,
336 Flattened Image Tree. FIT is formally a FDT, which can include
337 images of various types (kernel, FDT blob, ramdisk, etc.)
338 in a single blob. To boot this new uImage structure,
339 pass the address of the blob to the "bootm" command.
340 FIT is very flexible, supporting compression, multiple images,
341 multiple configurations, verification through hashing and also
342 verified boot (secure boot using RSA).
346 config FIT_EXTERNAL_OFFSET
347 hex "FIT external data offset"
350 This specifies a data offset in fit image.
351 The offset is from data payload offset to the beginning of
352 fit image header. When specifies a offset, specific data
353 could be put in the hole between data payload and fit image
354 header, such as CSF data on i.MX platform.
356 config FIT_ENABLE_SHA256_SUPPORT
357 bool "Support SHA256 checksum of FIT image contents"
361 Enable this to support SHA256 checksum of FIT image contents. A
362 SHA256 checksum is a 256-bit (32-byte) hash value used to check that
363 the image contents have not been corrupted.
365 config FIT_ENABLE_SHA384_SUPPORT
366 bool "Support SHA384 checksum of FIT image contents"
370 Enable this to support SHA384 checksum of FIT image contents. A
371 SHA384 checksum is a 384-bit (48-byte) hash value used to check that
372 the image contents have not been corrupted. Use this for the highest
375 config FIT_ENABLE_SHA512_SUPPORT
376 bool "Support SHA512 checksum of FIT image contents"
380 Enable this to support SHA512 checksum of FIT image contents. A
381 SHA512 checksum is a 512-bit (64-byte) hash value used to check that
382 the image contents have not been corrupted.
385 bool "Enable signature verification of FIT uImages"
390 select IMAGE_SIGN_INFO
392 This option enables signature verification of FIT uImages,
393 using a hash signed and verified using RSA. If
394 CONFIG_SHA_PROG_HW_ACCEL is defined, i.e support for progressive
395 hashing is available using hardware, then the RSA library will use
396 it. See doc/uImage.FIT/signature.txt for more details.
398 WARNING: When relying on signed FIT images with a required signature
399 check the legacy image format is disabled by default, so that
400 unsigned images cannot be loaded. If a board needs the legacy image
401 format support in this case, enable it using
402 CONFIG_LEGACY_IMAGE_FORMAT.
404 config FIT_SIGNATURE_MAX_SIZE
405 hex "Max size of signed FIT structures"
406 depends on FIT_SIGNATURE
409 This option sets a max size in bytes for verified FIT uImages.
410 A sane value of 256MB protects corrupted DTB structures from overlapping
411 device memory. Assure this size does not extend past expected storage
414 config FIT_ENABLE_RSASSA_PSS_SUPPORT
415 bool "Support rsassa-pss signature scheme of FIT image contents"
416 depends on FIT_SIGNATURE
419 Enable this to support the pss padding algorithm as described
420 in the rfc8017 (https://tools.ietf.org/html/rfc8017).
423 bool "Enable ciphering data in a FIT uImages"
427 Enable the feature of data ciphering/unciphering in the tool mkimage
428 and in the u-boot support of the FIT image.
431 bool "Show verbose messages when FIT images fail"
433 Generally a system will have valid FIT images so debug messages
434 are a waste of code space. If you are debugging your images then
435 you can enable this option to get more verbose information about
438 config FIT_BEST_MATCH
439 bool "Select the best match for the kernel device tree"
441 When no configuration is explicitly selected, default to the
442 one whose fdt's compatibility field best matches that of
443 U-Boot itself. A match is considered "best" if it matches the
444 most specific compatibility entry of U-Boot's fdt's root node.
445 The order of entries in the configuration's fdt is ignored.
447 config FIT_IMAGE_POST_PROCESS
448 bool "Enable post-processing of FIT artifacts after loading by U-Boot"
449 depends on TI_SECURE_DEVICE
451 Allows doing any sort of manipulation to blobs after they got extracted
452 from FIT images like stripping off headers or modifying the size of the
453 blob, verification, authentication, decryption etc. in a platform or
454 board specific way. In order to use this feature a platform or board-
455 specific implementation of board_fit_image_post_process() must be
456 provided. Also, anything done during this post-processing step would
457 need to be comprehended in how the images were prepared before being
458 injected into the FIT creation (i.e. the blobs would have been pre-
459 processed before being added to the FIT image).
464 bool "Support Flattened Image Tree within SPL"
469 bool "Support FIT printing within SPL"
472 Support printing the content of the fitImage in a verbose manner in SPL.
474 config SPL_FIT_SIGNATURE
475 bool "Enable signature verification of FIT firmware within SPL"
479 select SPL_RSA_VERIFY
480 select SPL_IMAGE_SIGN_INFO
483 bool "Enable SPL loading U-Boot as a FIT (basic fitImage features)"
486 Normally with the SPL framework a legacy image is generated as part
487 of the build. This contains U-Boot along with information as to
488 where it should be loaded. This option instead enables generation
489 of a FIT (Flat Image Tree) which provides more flexibility. In
490 particular it can handle selecting from multiple device tree
491 and passing the correct one to U-Boot.
493 config SPL_LOAD_FIT_APPLY_OVERLAY
494 bool "Enable SPL applying DT overlays from FIT"
495 depends on SPL_LOAD_FIT
496 select OF_LIBFDT_OVERLAY
498 The device tree is loaded from the FIT image. Allow the SPL is to
499 also load device-tree overlays from the FIT image an apply them
500 over the device tree.
502 config SPL_LOAD_FIT_APPLY_OVERLAY_BUF_SZ
503 depends on SPL_LOAD_FIT_APPLY_OVERLAY
505 hex "size of temporary buffer used to load the overlays"
507 The size of the area where the overlays will be loaded and
508 uncompress. Must be at least as large as biggest overlay
511 config SPL_LOAD_FIT_FULL
512 bool "Enable SPL loading U-Boot as a FIT (full fitImage features)"
515 Normally with the SPL framework a legacy image is generated as part
516 of the build. This contains U-Boot along with information as to
517 where it should be loaded. This option instead enables generation
518 of a FIT (Flat Image Tree) which provides more flexibility. In
519 particular it can handle selecting from multiple device tree
520 and passing the correct one to U-Boot.
522 config SPL_FIT_IMAGE_POST_PROCESS
523 bool "Enable post-processing of FIT artifacts after loading by the SPL"
524 depends on SPL_LOAD_FIT
526 Allows doing any sort of manipulation to blobs after they got extracted
527 from the U-Boot FIT image like stripping off headers or modifying the
528 size of the blob, verification, authentication, decryption etc. in a
529 platform or board specific way. In order to use this feature a platform
530 or board-specific implementation of board_fit_image_post_process() must
531 be provided. Also, anything done during this post-processing step would
532 need to be comprehended in how the images were prepared before being
533 injected into the FIT creation (i.e. the blobs would have been pre-
534 processed before being added to the FIT image).
536 config SPL_FIT_SOURCE
537 string ".its source file for U-Boot FIT image"
540 Specifies a (platform specific) FIT source file to generate the
541 U-Boot FIT image. This could specify further image to load and/or
544 config SPL_FIT_GENERATOR
545 string ".its file generator script for U-Boot FIT image"
547 default "board/sunxi/mksunxi_fit_atf.sh" if SPL_LOAD_FIT && ARCH_SUNXI
548 default "arch/arm/mach-rockchip/make_fit_atf.py" if SPL_LOAD_FIT && ARCH_ROCKCHIP
549 default "arch/arm/mach-zynqmp/mkimage_fit_atf.sh" if SPL_LOAD_FIT && ARCH_ZYNQMP
550 default "arch/riscv/lib/mkimage_fit_opensbi.sh" if SPL_LOAD_FIT && RISCV
552 Specifies a (platform specific) script file to generate the FIT
553 source file used to build the U-Boot FIT image file. This gets
554 passed a list of supported device tree file stub names to
555 include in the generated image.
561 config LEGACY_IMAGE_FORMAT
562 bool "Enable support for the legacy image format"
563 default y if !FIT_SIGNATURE
565 This option enables the legacy image format. It is enabled by
566 default for backward compatibility, unless FIT_SIGNATURE is
567 set where it is disabled so that unsigned images cannot be
568 loaded. If a board needs the legacy image format support in this
569 case, enable it here.
571 config OF_BOARD_SETUP
572 bool "Set up board-specific details in device tree before boot"
575 This causes U-Boot to call ft_board_setup() before booting into
576 the Operating System. This function can set up various
577 board-specific information in the device tree for use by the OS.
578 The device tree is then passed to the OS.
580 config OF_SYSTEM_SETUP
581 bool "Set up system-specific details in device tree before boot"
584 This causes U-Boot to call ft_system_setup() before booting into
585 the Operating System. This function can set up various
586 system-specific information in the device tree for use by the OS.
587 The device tree is then passed to the OS.
589 config OF_STDOUT_VIA_ALIAS
590 bool "Update the device-tree stdout alias from U-Boot"
593 This uses U-Boot's serial alias from the aliases node to update
594 the device tree passed to the OS. The "linux,stdout-path" property
595 in the chosen node is set to point to the correct serial node.
596 This option currently references CONFIG_CONS_INDEX, which is
597 incorrect when used with device tree as this option does not
598 exist / should not be used.
600 config SYS_EXTRA_OPTIONS
601 string "Extra Options (DEPRECATED)"
603 The old configuration infrastructure (= mkconfig + boards.cfg)
604 provided the extra options field. If you have something like
605 "HAS_BAR,BAZ=64", the optional options
607 #define CONFIG_BAZ 64
608 will be defined in include/config.h.
609 This option was prepared for the smooth migration from the old
610 configuration to Kconfig. Since this option will be removed sometime,
611 new boards should not use this option.
613 config HAVE_SYS_TEXT_BASE
615 depends on !NIOS2 && !XTENSA
620 depends on HAVE_SYS_TEXT_BASE
621 default 0x80800000 if ARCH_OMAP2PLUS || ARCH_K3
622 default 0x4a000000 if ARCH_SUNXI && !MACH_SUN9I && !MACH_SUN8I_V3S
623 default 0x2a000000 if ARCH_SUNXI && MACH_SUN9I
624 default 0x42e00000 if ARCH_SUNXI && MACH_SUN8I_V3S
627 The address in memory that U-Boot will be running from, initially.
630 depends on ARC || ARCH_SUNXI || MPC83xx
631 int "CPU clock frequency"
633 TODO: Move CONFIG_SYS_CLK_FREQ for all the architecture
635 config ARCH_FIXUP_FDT_MEMORY
636 bool "Enable arch_fixup_memory_banks() call"
639 Enable FDT memory map syncup before OS boot. This feature can be
640 used for booting OS with different memory setup where the part of
641 the memory location should be used for different purpose.
643 endmenu # Boot images
647 source "common/Kconfig"
651 source "disk/Kconfig"
659 source "drivers/Kconfig"
665 source "test/Kconfig"