]> git.ipfire.org Git - thirdparty/u-boot.git/blob - Kconfig
Merge tag 'clk-2023.01' of https://source.denx.de/u-boot/custodians/u-boot-clk
[thirdparty/u-boot.git] / Kconfig
1 #
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.
5 #
6 mainmenu "U-Boot $(UBOOTVERSION) Configuration"
7
8 comment "Compiler: $(CC_VERSION_TEXT)"
9
10 source "scripts/Kconfig.include"
11
12 # Allow defaults in arch-specific code to override any given here
13 source "arch/Kconfig"
14
15 menu "General setup"
16
17 config BROKEN
18 bool
19 help
20 This option cannot be enabled. It is used as dependency
21 for broken and incomplete features.
22
23 config DEPRECATED
24 bool
25 help
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.
29
30 config LOCALVERSION
31 string "Local version - append to U-Boot release"
32 help
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.
39
40 config LOCALVERSION_AUTO
41 bool "Automatically append version information to the version string"
42 default y
43 help
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
46 top of tree revision.
47
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.
52
53 (The actual string used here is the first eight characters produced
54 by running the command:
55
56 $ git rev-parse --verify HEAD
57
58 which is done within the script "scripts/setlocalversion".)
59
60 config CC_IS_GCC
61 def_bool $(success,$(CC) --version | head -n 1 | grep -q gcc)
62
63 config GCC_VERSION
64 int
65 default $(shell,$(srctree)/scripts/gcc-version.sh -p $(CC) | sed 's/^0*//') if CC_IS_GCC
66 default 0
67
68 config CC_IS_CLANG
69 def_bool $(success,$(CC) --version | head -n 1 | grep -q clang)
70
71 config CLANG_VERSION
72 int
73 default $(shell,$(srctree)/scripts/clang-version.sh $(CC))
74
75 choice
76 prompt "Optimization level"
77 default CC_OPTIMIZE_FOR_SIZE
78
79 config CC_OPTIMIZE_FOR_SIZE
80 bool "Optimize for size"
81 help
82 Enabling this option will pass "-Os" to gcc, resulting in a smaller
83 U-Boot image.
84
85 This option is enabled by default for U-Boot.
86
87 config CC_OPTIMIZE_FOR_SPEED
88 bool "Optimize for speed"
89 help
90 Enabling this option will pass "-O2" to gcc, resulting in a faster
91 U-Boot image.
92
93 config CC_OPTIMIZE_FOR_DEBUG
94 bool "Optimize for debugging"
95 help
96 Enabling this option will pass "-Og" to gcc, enabling optimizations
97 which don't interfere with debugging.
98
99 endchoice
100
101 config OPTIMIZE_INLINING
102 bool "Allow compiler to uninline functions marked 'inline' in full U-Boot"
103 help
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
107 reasons.
108
109 config SPL_OPTIMIZE_INLINING
110 bool "Allow compiler to uninline functions marked 'inline' in SPL"
111 depends on SPL
112 help
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
116 reasons.
117
118 config ARCH_SUPPORTS_LTO
119 bool
120
121 config LTO
122 bool "Enable Link Time Optimizations"
123 depends on ARCH_SUPPORTS_LTO
124 help
125 This option enables Link Time Optimization (LTO), a mechanism which
126 allows the compiler to optimize between different compilation units.
127
128 This can optimize away dead code paths, resulting in smaller binary
129 size (if CC_OPTIMIZE_FOR_SIZE is enabled).
130
131 This option is not available for every architecture and may
132 introduce bugs.
133
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
137 nproc command).
138
139 If unsure, say n.
140
141 config TPL_OPTIMIZE_INLINING
142 bool "Allow compiler to uninline functions marked 'inline' in TPL"
143 depends on TPL
144 help
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
148 reasons.
149
150 config CC_COVERAGE
151 bool "Enable code coverage analysis"
152 depends on SANDBOX
153 help
154 Enabling this option will pass "--coverage" to gcc to compile
155 and link code instrumented for coverage analysis.
156
157 config ASAN
158 bool "Enable AddressSanitizer"
159 depends on SANDBOX
160 help
161 Enables AddressSanitizer to discover out-of-bounds accesses,
162 use-after-free, double-free and memory leaks.
163
164 config FUZZ
165 bool "Enable fuzzing"
166 depends on CC_IS_CLANG
167 depends on DM_FUZZING_ENGINE
168 select ASAN
169 help
170 Enables the fuzzing infrastructure to generate fuzzing data and run
171 fuzz tests.
172
173 config CC_HAS_ASM_INLINE
174 def_bool $(success,echo 'void foo(void) { asm inline (""); }' | $(CC) -x c - -c -o /dev/null)
175
176 config XEN
177 bool "Select U-Boot be run as a bootloader for XEN Virtual Machine"
178 help
179 Enabling this option will make U-Boot be run as a bootloader
180 for XEN [1] Virtual Machine.
181
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.
191
192 [1] - https://xenproject.org/
193
194 config DISTRO_DEFAULTS
195 bool "Select defaults suitable for booting general purpose Linux distributions"
196 select AUTO_COMPLETE
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
202 select CMD_EXT2
203 select CMD_EXT4
204 select CMD_FAT
205 select CMD_FS_GENERIC
206 select CMD_PART if PARTITIONS
207 select CMD_PING if CMD_NET
208 select CMD_PXE if NET
209 select CMD_SYSBOOT
210 select ENV_VARS_UBOOT_CONFIG
211 select HUSH_PARSER
212 select SUPPORT_RAW_INITRD
213 select SYS_LONGHELP
214 imply CMD_MII if NET
215 imply USB_STORAGE
216 imply USE_BOOTCOMMAND
217 help
218 Select this to enable various options and commands which are suitable
219 for building u-boot for booting general purpose Linux distributions.
220
221 config ENV_VARS_UBOOT_CONFIG
222 bool "Add arch, board, vendor and soc variables to default environment"
223 help
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:
228 - CONFIG_SYS_ARCH
229 - CONFIG_SYS_CPU
230 - CONFIG_SYS_BOARD
231 - CONFIG_SYS_VENDOR
232 - CONFIG_SYS_SOC
233
234 config NR_DRAM_BANKS
235 int "Number of DRAM banks"
236 default 1 if ARCH_SUNXI || ARCH_OWL
237 default 4
238 help
239 This defines the number of DRAM banks.
240
241 config SYS_BOOT_GET_CMDLINE
242 bool "Enable kernel command line setup"
243 help
244 Enables allocating and saving kernel cmdline in space between
245 "bootm_low" and "bootm_low" + BOOTMAPSZ.
246
247 config SYS_BARGSIZE
248 int "Size of kernel command line buffer in bytes"
249 depends on SYS_BOOT_GET_CMDLINE
250 default 512
251 help
252 Buffer size for Boot Arguments which are passed to the application
253 (usually a Linux kernel) when it is booted
254
255 config SYS_BOOT_GET_KBD
256 bool "Enable kernel board information setup"
257 help
258 Enables allocating and saving a kernel copy of the bd_info in
259 space between "bootm_low" and "bootm_low" + BOOTMAPSZ.
260
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
264 default y if TFABOOT
265 help
266 Typically, we use an initial stack pointer address that is calculated
267 by taking the statically defined CONFIG_SYS_INIT_RAM_ADDR, adding the
268 statically defined CONFIG_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
272 instead.
273
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 SYS_TEXT_BASE if TFABOOT
278
279 config SYS_MALLOC_F
280 bool "Enable malloc() pool before relocation"
281 default y if DM
282
283 help
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.
288
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 || \
300 ROCKCHIP_RK3399
301 default 0x8000 if RCAR_GEN3
302 default 0x10000 if ARCH_IMX8 || ARCH_IMX8M
303 default 0x2000
304 help
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.
309
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
318 default 0x400000
319 help
320 This defines memory to be allocated for Dynamic allocation
321 TODO: Use for other architectures
322
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
330 help
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.
335
336 It is possible to enable CONFIG_SYS_SPL_MALLOC_START to start a new
337 malloc() region in SDRAM once it is inited.
338
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
343 help
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.
348
349 config VALGRIND
350 bool "Inform valgrind about memory allocations"
351 depends on !RISCV
352 help
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.
359
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'.
363
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
368 help
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.
373
374 menuconfig EXPERT
375 bool "Configure standard U-Boot features (expert users)"
376 default y
377 help
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.
382
383 if EXPERT
384 config SYS_MALLOC_CLEAR_ON_INIT
385 bool "Init with zeros the memory reserved for malloc (slow)"
386 default y
387 help
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
391 slows the boot time.
392
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.
396 Warning:
397 When disabling this, please check if malloc calls, maybe
398 should be replaced by calloc - if one expects zeroed memory.
399
400 config SYS_MALLOC_DEFAULT_TO_INIT
401 bool "Default malloc to init while reserving the memory for it"
402 help
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)
406 memory.
407
408 If so then on top of setting the updated memory aside one
409 needs to bring the malloc init.
410
411 If such a scenario is sought choose yes.
412
413 config TOOLS_DEBUG
414 bool "Enable debug information for tools"
415 help
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.
420
421 endif # EXPERT
422
423 config PHYS_64BIT
424 bool "64bit physical address support"
425 help
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.
429
430 config HAS_ROM
431 bool
432 select BINMAN
433 help
434 Enables building of a u-boot.rom target. This collects U-Boot and
435 any necessary binary blobs.
436
437 config SPL_IMAGE
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"
441 depends on SPL
442 help
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.
447
448 config REMAKE_ELF
449 bool "Recreate an ELF image from raw U-Boot binary"
450 help
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.
454
455 config BUILD_TARGET
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-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
466 help
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
471 make / buildman.
472
473 config HAS_BOARD_SIZE_LIMIT
474 bool "Define a maximum size for the U-Boot image"
475 default y if RCAR_GEN3
476 help
477 In some cases, we need to enforce a hard limit on how big the U-Boot
478 image itself can be.
479
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
484 help
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.
489
490 config SYS_CUSTOM_LDSCRIPT
491 bool "Use a custom location for the U-Boot linker script"
492 help
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
498 CONFIG_SYS_LDSCRIPT.
499
500 config SYS_LDSCRIPT
501 depends on SYS_CUSTOM_LDSCRIPT
502 string "Custom ldscript location"
503 help
504 Path within the source tree to the linker script to use for the
505 main U-Boot binary.
506
507 config SYS_LOAD_ADDR
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
519 help
520 Address in memory to use as the default safe load address.
521
522 config ERR_PTR_OFFSET
523 hex
524 default 0x0
525 help
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.
535
536 config PLATFORM_ELFENTRY
537 string
538 default "__start" if MIPS
539 default "_start"
540
541 config STACK_SIZE
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
545 default 0x1000000
546 help
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.
550
551 config SYS_MEM_TOP_HIDE
552 hex "Exclude some memory from U-Boot / OS information"
553 default 0x0
554 help
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
560 page size.
561
562 config SYS_HAS_SRAM
563 bool
564 default y if TARGET_PIC32MZDASK
565 default y if TARGET_DEVKIT8000
566 default y if TARGET_TRICORDER
567 help
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.
571
572 config SYS_SRAM_BASE
573 hex
574 default 0x80000000 if TARGET_PIC32MZDASK
575 default 0x40200000 if TARGET_DEVKIT8000
576 default 0x40200000 if TARGET_TRICORDER
577 default 0x0
578
579 config SYS_SRAM_SIZE
580 hex
581 default 0x00080000 if TARGET_PIC32MZDASK
582 default 0x10000 if TARGET_DEVKIT8000
583 default 0x10000 if TARGET_TRICORDER
584 default 0x0
585
586 config MP
587 bool "Support for multiprocessor"
588 help
589 This provides an option to bringup different processors
590 in multiprocessor cases.
591
592 config EXAMPLES
593 bool "Compile API examples"
594 depends on !SANDBOX
595 default y if ARCH_QEMU
596 help
597 U-Boot provides an API for standalone applications. Examples are
598 provided in directory examples/.
599
600 endmenu # General setup
601
602 source "api/Kconfig"
603
604 source "boot/Kconfig"
605
606 source "common/Kconfig"
607
608 source "cmd/Kconfig"
609
610 source "disk/Kconfig"
611
612 source "dts/Kconfig"
613
614 source "env/Kconfig"
615
616 source "net/Kconfig"
617
618 source "drivers/Kconfig"
619
620 source "fs/Kconfig"
621
622 source "lib/Kconfig"
623
624 source "test/Kconfig"
625
626 source "tools/Kconfig"