kconfig / kbuild: re-sync with Linux 4.18
[oweals/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 # Allow defaults in arch-specific code to override any given here
9 source "arch/Kconfig"
10
11 menu "General setup"
12
13 config BROKEN
14         bool
15         help
16           This option cannot be enabled. It is used as dependency
17           for broken and incomplete features.
18
19 config DEPRECATED
20         bool
21         help
22           This option cannot be enabled.  It it used as a dependency for
23           code that relies on deprecated features that will be removed and
24           the conversion deadline has passed.
25
26 config LOCALVERSION
27         string "Local version - append to U-Boot release"
28         help
29           Append an extra string to the end of your U-Boot version.
30           This will show up in your boot log, for example.
31           The string you set here will be appended after the contents of
32           any files with a filename matching localversion* in your
33           object and source tree, in that order.  Your total string can
34           be a maximum of 64 characters.
35
36 config LOCALVERSION_AUTO
37         bool "Automatically append version information to the version string"
38         default y
39         help
40           This will try to automatically determine if the current tree is a
41           release tree by looking for Git tags that belong to the current
42           top of tree revision.
43
44           A string of the format -gxxxxxxxx will be added to the localversion
45           if a Git-based tree is found.  The string generated by this will be
46           appended after any matching localversion* files, and after the value
47           set in CONFIG_LOCALVERSION.
48
49           (The actual string used here is the first eight characters produced
50           by running the command:
51
52             $ git rev-parse --verify HEAD
53
54           which is done within the script "scripts/setlocalversion".)
55
56 config CC_OPTIMIZE_FOR_SIZE
57         bool "Optimize for size"
58         default y
59         help
60           Enabling this option will pass "-Os" instead of "-O2" to gcc
61           resulting in a smaller U-Boot image.
62
63           This option is enabled by default for U-Boot.
64
65 config CC_COVERAGE
66         bool "Enable code coverage analysis"
67         depends on SANDBOX
68         help
69           Enabling this option will pass "--coverage" to gcc to compile
70           and link code instrumented for coverage analysis.
71
72 config DISTRO_DEFAULTS
73         bool "Select defaults suitable for booting general purpose Linux distributions"
74         select AUTO_COMPLETE
75         select CMDLINE_EDITING
76         select CMD_BOOTI if ARM64
77         select CMD_BOOTZ if ARM && !ARM64
78         select CMD_DHCP if CMD_NET
79         select CMD_ENV_EXISTS
80         select CMD_EXT2
81         select CMD_EXT4
82         select CMD_FAT
83         select CMD_FS_GENERIC
84         select CMD_PART if PARTITIONS
85         select CMD_PING if CMD_NET
86         select CMD_PXE if NET
87         select CMD_SYSBOOT
88         select ENV_VARS_UBOOT_CONFIG
89         select HUSH_PARSER
90         select SUPPORT_RAW_INITRD
91         select SYS_LONGHELP
92         imply CMD_MII if NET
93         imply USB_STORAGE
94         imply USE_BOOTCOMMAND
95         help
96           Select this to enable various options and commands which are suitable
97           for building u-boot for booting general purpose Linux distributions.
98
99 config ENV_VARS_UBOOT_CONFIG
100         bool "Add arch, board, vendor and soc variables to default environment"
101         help
102           Define this in order to add variables describing the
103           U-Boot build configuration to the default environment.
104           These will be named arch, cpu, board, vendor, and soc.
105           Enabling this option will cause the following to be defined:
106           - CONFIG_SYS_ARCH
107           - CONFIG_SYS_CPU
108           - CONFIG_SYS_BOARD
109           - CONFIG_SYS_VENDOR
110           - CONFIG_SYS_SOC
111
112 config NR_DRAM_BANKS
113         int "Number of DRAM banks"
114         default 4
115         help
116           This defines the number of DRAM banks.
117
118 config SYS_BOOT_GET_CMDLINE
119         bool "Enable kernel command line setup"
120         help
121           Enables allocating and saving kernel cmdline in space between
122           "bootm_low" and "bootm_low" + BOOTMAPSZ.
123
124 config SYS_BOOT_GET_KBD
125         bool "Enable kernel board information setup"
126         help
127           Enables allocating and saving a kernel copy of the bd_info in
128           space between "bootm_low" and "bootm_low" + BOOTMAPSZ.
129
130 config SYS_MALLOC_F
131         bool "Enable malloc() pool before relocation"
132         default y if DM
133
134         help
135           Before relocation, memory is very limited on many platforms. Still,
136           we can provide a small malloc() pool if needed. Driver model in
137           particular needs this to operate, so that it can allocate the
138           initial serial device and any others that are needed.
139
140 config SYS_MALLOC_F_LEN
141         hex "Size of malloc() pool before relocation"
142         depends on SYS_MALLOC_F
143         default 0x1000 if AM33XX
144         default 0x2800 if SANDBOX
145         default 0x2000 if (ARCH_IMX8 || ARCH_IMX8M || ARCH_MX7 || \
146                            ARCH_MX7ULP || ARCH_MX6 || ARCH_MX5 || \
147                            ARCH_LS1012A || ARCH_LS1021A || ARCH_LS1043A || \
148                            ARCH_LS1046A)
149         default 0x400
150         help
151           Before relocation, memory is very limited on many platforms. Still,
152           we can provide a small malloc() pool if needed. Driver model in
153           particular needs this to operate, so that it can allocate the
154           initial serial device and any others that are needed.
155
156 config SYS_MALLOC_LEN
157         hex "Define memory for Dynamic allocation"
158         depends on ARCH_ZYNQ || ARCH_VERSAL || ARCH_STM32MP || ARCH_ROCKCHIP
159         default 0x2000000 if ARCH_ROCKCHIP
160         help
161           This defines memory to be allocated for Dynamic allocation
162           TODO: Use for other architectures
163
164 config SPL_SYS_MALLOC_F_LEN
165         hex "Size of malloc() pool in SPL before relocation"
166         depends on SYS_MALLOC_F && SPL
167         default 0x2800 if RCAR_GEN3
168         default SYS_MALLOC_F_LEN
169         help
170           Before relocation, memory is very limited on many platforms. Still,
171           we can provide a small malloc() pool if needed. Driver model in
172           particular needs this to operate, so that it can allocate the
173           initial serial device and any others that are needed.
174
175 config TPL_SYS_MALLOC_F_LEN
176         hex "Size of malloc() pool in TPL before relocation"
177         depends on SYS_MALLOC_F && TPL
178         default SYS_MALLOC_F_LEN
179         help
180           Before relocation, memory is very limited on many platforms. Still,
181           we can provide a small malloc() pool if needed. Driver model in
182           particular needs this to operate, so that it can allocate the
183           initial serial device and any others that are needed.
184
185 menuconfig EXPERT
186         bool "Configure standard U-Boot features (expert users)"
187         default y
188         help
189           This option allows certain base U-Boot options and settings
190           to be disabled or tweaked. This is for specialized
191           environments which can tolerate a "non-standard" U-Boot.
192           Use this only if you really know what you are doing.
193
194 if EXPERT
195         config SYS_MALLOC_CLEAR_ON_INIT
196         bool "Init with zeros the memory reserved for malloc (slow)"
197         default y
198         help
199           This setting is enabled by default. The reserved malloc
200           memory is initialized with zeros, so first malloc calls
201           will return the pointer to the zeroed memory. But this
202           slows the boot time.
203
204           It is recommended to disable it, when CONFIG_SYS_MALLOC_LEN
205           value, has more than few MiB, e.g. when uses bzip2 or bmp logo.
206           Then the boot time can be significantly reduced.
207           Warning:
208           When disabling this, please check if malloc calls, maybe
209           should be replaced by calloc - if one expects zeroed memory.
210
211 config TOOLS_DEBUG
212         bool "Enable debug information for tools"
213         help
214           Enable generation of debug information for tools such as mkimage.
215           This can be used for debugging purposes. With debug information
216           it is possible to set breakpoints on particular lines, single-step
217           debug through the source code, etc.
218
219 endif # EXPERT
220
221 config PHYS_64BIT
222         bool "64bit physical address support"
223         help
224           Say Y here to support 64bit physical memory address.
225           This can be used not only for 64bit SoCs, but also for
226           large physical address extension on 32bit SoCs.
227
228 config BUILD_ROM
229         bool "Build U-Boot as BIOS replacement"
230         depends on X86
231         help
232           This option allows to build a ROM version of U-Boot.
233           The build process generally requires several binary blobs
234           which are not shipped in the U-Boot source tree.
235           Please, see doc/README.x86 for details.
236
237 config SPL_IMAGE
238         string "SPL image used in the combined SPL+U-Boot image"
239         default "spl/boot.bin" if ARCH_AT91 && SPL_NAND_SUPPORT
240         default "spl/u-boot-spl.bin"
241         depends on SPL
242         help
243           Select the SPL build target that shall be generated by the SPL
244           build process (default spl/u-boot-spl.bin). This image will be
245           used to generate a combined image with SPL and main U-Boot
246           proper as one single image.
247
248 config BUILD_TARGET
249         string "Build target special images"
250         default "u-boot-with-spl.sfp" if TARGET_SOCFPGA_ARRIA10
251         default "u-boot-with-spl.sfp" if TARGET_SOCFPGA_GEN5
252         default "u-boot-spl.kwb" if ARCH_MVEBU && SPL
253         default "u-boot-elf.srec" if RCAR_GEN3
254         default "u-boot.itb" if SPL_LOAD_FIT && (ARCH_ROCKCHIP || \
255                                 ARCH_SUNXI || RISCV || ARCH_ZYNQMP)
256         default "u-boot.kwb" if KIRKWOOD
257         default "u-boot-with-spl.bin" if ARCH_AT91 && SPL_NAND_SUPPORT
258         default "u-boot-with-spl.imx" if ARCH_MX6 && SPL
259         help
260           Some SoCs need special image types (e.g. U-Boot binary
261           with a special header) as build targets. By defining
262           CONFIG_BUILD_TARGET in the SoC / board header, this
263           special image will be automatically built upon calling
264           make / buildman.
265
266 config SYS_CUSTOM_LDSCRIPT
267         bool "Use a custom location for the U-Boot linker script"
268         help
269           Normally when linking U-Boot we will look in the board directory,
270           the CPU directory and finally the "cpu" directory of the architecture
271           for the ile "u-boot.lds" and use that as our linker.  However, in
272           some cases we need to provide a different linker script.  To do so,
273           enable this option and then provide the location under
274           CONFIG_SYS_LDSCRIPT.
275
276 config SYS_LDSCRIPT
277         depends on SYS_CUSTOM_LDSCRIPT
278         string "Custom ldscript location"
279         help
280           Path within the source tree to the linker script to use for the
281           main U-Boot binary.
282
283 config ERR_PTR_OFFSET
284         hex
285         default 0x0
286         help
287           Some U-Boot pointers have redundant information, so we can use a
288           scheme where we can return either an error code or a pointer with the
289           same return value. The default implementation just casts the pointer
290           to a number, however, this may fail on platforms where the end of the
291           address range is used for valid pointers (e.g. 0xffffff00 is a valid
292           heap pointer in socfpga SPL).
293           For such platforms, this value provides an upper range of those error
294           pointer values - up to 'MAX_ERRNO' bytes below this value must be
295           unused/invalid addresses.
296
297 endmenu         # General setup
298
299 menu "Boot images"
300
301 config ANDROID_BOOT_IMAGE
302         bool "Enable support for Android Boot Images"
303         default y if FASTBOOT
304         help
305           This enables support for booting images which use the Android
306           image format header.
307
308 config FIT
309         bool "Support Flattened Image Tree"
310         select MD5
311         select SHA1
312         help
313           This option allows you to boot the new uImage structure,
314           Flattened Image Tree.  FIT is formally a FDT, which can include
315           images of various types (kernel, FDT blob, ramdisk, etc.)
316           in a single blob.  To boot this new uImage structure,
317           pass the address of the blob to the "bootm" command.
318           FIT is very flexible, supporting compression, multiple images,
319           multiple configurations, verification through hashing and also
320           verified boot (secure boot using RSA).
321
322 if FIT
323
324 config FIT_EXTERNAL_OFFSET
325         hex "FIT external data offset"
326         default 0x0
327         help
328           This specifies a data offset in fit image.
329           The offset is from data payload offset to the beginning of
330           fit image header. When specifies a offset, specific data
331           could be put in the hole between data payload and fit image
332           header, such as CSF data on i.MX platform.
333
334 config FIT_ENABLE_SHA256_SUPPORT
335         bool "Support SHA256 checksum of FIT image contents"
336         default y
337         select SHA256
338         help
339           Enable this to support SHA256 checksum of FIT image contents. A
340           SHA256 checksum is a 256-bit (32-byte) hash value used to check that
341           the image contents have not been corrupted. SHA256 is recommended
342           for use in secure applications since (as at 2016) there is no known
343           feasible attack that could produce a 'collision' with differing
344           input data. Use this for the highest security. Note that only the
345           SHA256 variant is supported: SHA512 and others are not currently
346           supported in U-Boot.
347
348 config FIT_SIGNATURE
349         bool "Enable signature verification of FIT uImages"
350         depends on DM
351         select HASH
352         select RSA
353         select RSA_VERIFY
354         select IMAGE_SIGN_INFO
355         help
356           This option enables signature verification of FIT uImages,
357           using a hash signed and verified using RSA. If
358           CONFIG_SHA_PROG_HW_ACCEL is defined, i.e support for progressive
359           hashing is available using hardware, then the RSA library will use
360           it. See doc/uImage.FIT/signature.txt for more details.
361
362           WARNING: When relying on signed FIT images with a required signature
363           check the legacy image format is disabled by default, so that
364           unsigned images cannot be loaded. If a board needs the legacy image
365           format support in this case, enable it using
366           CONFIG_LEGACY_IMAGE_FORMAT.
367
368 config FIT_SIGNATURE_MAX_SIZE
369         hex "Max size of signed FIT structures"
370         depends on FIT_SIGNATURE
371         default 0x10000000
372         help
373           This option sets a max size in bytes for verified FIT uImages.
374           A sane value of 256MB protects corrupted DTB structures from overlapping
375           device memory. Assure this size does not extend past expected storage
376           space.
377
378 config FIT_ENABLE_RSASSA_PSS_SUPPORT
379         bool "Support rsassa-pss signature scheme of FIT image contents"
380         depends on FIT_SIGNATURE
381         default n
382         help
383           Enable this to support the pss padding algorithm as described
384           in the rfc8017 (https://tools.ietf.org/html/rfc8017).
385
386 config FIT_CIPHER
387         bool "Enable ciphering data in a FIT uImages"
388         depends on DM
389         select AES
390         help
391           Enable the feature of data ciphering/unciphering in the tool mkimage
392           and in the u-boot support of the FIT image.
393
394 config FIT_VERBOSE
395         bool "Show verbose messages when FIT images fail"
396         help
397           Generally a system will have valid FIT images so debug messages
398           are a waste of code space. If you are debugging your images then
399           you can enable this option to get more verbose information about
400           failures.
401
402 config FIT_BEST_MATCH
403         bool "Select the best match for the kernel device tree"
404         help
405           When no configuration is explicitly selected, default to the
406           one whose fdt's compatibility field best matches that of
407           U-Boot itself. A match is considered "best" if it matches the
408           most specific compatibility entry of U-Boot's fdt's root node.
409           The order of entries in the configuration's fdt is ignored.
410
411 config FIT_IMAGE_POST_PROCESS
412         bool "Enable post-processing of FIT artifacts after loading by U-Boot"
413         depends on TI_SECURE_DEVICE
414         help
415           Allows doing any sort of manipulation to blobs after they got extracted
416           from FIT images like stripping off headers or modifying the size of the
417           blob, verification, authentication, decryption etc. in a platform or
418           board specific way. In order to use this feature a platform or board-
419           specific implementation of board_fit_image_post_process() must be
420           provided. Also, anything done during this post-processing step would
421           need to be comprehended in how the images were prepared before being
422           injected into the FIT creation (i.e. the blobs would have been pre-
423           processed before being added to the FIT image).
424
425 if SPL
426
427 config SPL_FIT
428         bool "Support Flattened Image Tree within SPL"
429         depends on SPL
430         select SPL_OF_LIBFDT
431
432 config SPL_FIT_PRINT
433         bool "Support FIT printing within SPL"
434         depends on SPL_FIT
435         help
436           Support printing the content of the fitImage in a verbose manner in SPL.
437
438 config SPL_FIT_SIGNATURE
439         bool "Enable signature verification of FIT firmware within SPL"
440         depends on SPL_DM
441         select SPL_FIT
442         select SPL_RSA
443         select SPL_RSA_VERIFY
444         select IMAGE_SIGN_INFO
445
446 config SPL_LOAD_FIT
447         bool "Enable SPL loading U-Boot as a FIT (basic fitImage features)"
448         select SPL_FIT
449         help
450           Normally with the SPL framework a legacy image is generated as part
451           of the build. This contains U-Boot along with information as to
452           where it should be loaded. This option instead enables generation
453           of a FIT (Flat Image Tree) which provides more flexibility. In
454           particular it can handle selecting from multiple device tree
455           and passing the correct one to U-Boot.
456
457 config SPL_LOAD_FIT_APPLY_OVERLAY
458         bool "Enable SPL applying DT overlays from FIT"
459         depends on SPL_LOAD_FIT
460         select OF_LIBFDT_OVERLAY
461         help
462           The device tree is loaded from the FIT image. Allow the SPL is to
463           also load device-tree overlays from the FIT image an apply them
464           over the device tree.
465
466 config SPL_LOAD_FIT_APPLY_OVERLAY_BUF_SZ
467         depends on SPL_LOAD_FIT_APPLY_OVERLAY
468         default 0x10000
469         hex "size of temporary buffer used to load the overlays"
470         help
471           The size of the area where the overlays will be loaded and
472           uncompress. Must be at least as large as biggest overlay
473           (uncompressed)
474
475 config SPL_LOAD_FIT_FULL
476         bool "Enable SPL loading U-Boot as a FIT (full fitImage features)"
477         select SPL_FIT
478         help
479           Normally with the SPL framework a legacy image is generated as part
480           of the build. This contains U-Boot along with information as to
481           where it should be loaded. This option instead enables generation
482           of a FIT (Flat Image Tree) which provides more flexibility. In
483           particular it can handle selecting from multiple device tree
484           and passing the correct one to U-Boot.
485
486 config SPL_FIT_IMAGE_POST_PROCESS
487         bool "Enable post-processing of FIT artifacts after loading by the SPL"
488         depends on SPL_LOAD_FIT
489         help
490           Allows doing any sort of manipulation to blobs after they got extracted
491           from the U-Boot FIT image like stripping off headers or modifying the
492           size of the blob, verification, authentication, decryption etc. in a
493           platform or board specific way. In order to use this feature a platform
494           or board-specific implementation of board_fit_image_post_process() must
495           be provided. Also, anything done during this post-processing step would
496           need to be comprehended in how the images were prepared before being
497           injected into the FIT creation (i.e. the blobs would have been pre-
498           processed before being added to the FIT image).
499
500 config SPL_FIT_SOURCE
501         string ".its source file for U-Boot FIT image"
502         depends on SPL_FIT
503         help
504           Specifies a (platform specific) FIT source file to generate the
505           U-Boot FIT image. This could specify further image to load and/or
506           execute.
507
508 config SPL_FIT_GENERATOR
509         string ".its file generator script for U-Boot FIT image"
510         depends on SPL_FIT
511         default "board/sunxi/mksunxi_fit_atf.sh" if SPL_LOAD_FIT && ARCH_SUNXI
512         default "arch/arm/mach-rockchip/make_fit_atf.py" if SPL_LOAD_FIT && ARCH_ROCKCHIP
513         default "arch/arm/mach-zynqmp/mkimage_fit_atf.sh" if SPL_LOAD_FIT && ARCH_ZYNQMP
514         default "arch/riscv/lib/mkimage_fit_opensbi.sh" if SPL_LOAD_FIT && RISCV
515         help
516           Specifies a (platform specific) script file to generate the FIT
517           source file used to build the U-Boot FIT image file. This gets
518           passed a list of supported device tree file stub names to
519           include in the generated image.
520
521 endif # SPL
522
523 endif # FIT
524
525 config LEGACY_IMAGE_FORMAT
526         bool "Enable support for the legacy image format"
527         default y if !FIT_SIGNATURE
528         help
529           This option enables the legacy image format. It is enabled by
530           default for backward compatibility, unless FIT_SIGNATURE is
531           set where it is disabled so that unsigned images cannot be
532           loaded. If a board needs the legacy image format support in this
533           case, enable it here.
534
535 config OF_BOARD_SETUP
536         bool "Set up board-specific details in device tree before boot"
537         depends on OF_LIBFDT
538         help
539           This causes U-Boot to call ft_board_setup() before booting into
540           the Operating System. This function can set up various
541           board-specific information in the device tree for use by the OS.
542           The device tree is then passed to the OS.
543
544 config OF_SYSTEM_SETUP
545         bool "Set up system-specific details in device tree before boot"
546         depends on OF_LIBFDT
547         help
548           This causes U-Boot to call ft_system_setup() before booting into
549           the Operating System. This function can set up various
550           system-specific information in the device tree for use by the OS.
551           The device tree is then passed to the OS.
552
553 config OF_STDOUT_VIA_ALIAS
554         bool "Update the device-tree stdout alias from U-Boot"
555         depends on OF_LIBFDT
556         help
557           This uses U-Boot's serial alias from the aliases node to update
558           the device tree passed to the OS. The "linux,stdout-path" property
559           in the chosen node is set to point to the correct serial node.
560           This option currently references CONFIG_CONS_INDEX, which is
561           incorrect when used with device tree as this option does not
562           exist / should not be used.
563
564 config SYS_EXTRA_OPTIONS
565         string "Extra Options (DEPRECATED)"
566         help
567           The old configuration infrastructure (= mkconfig + boards.cfg)
568           provided the extra options field. If you have something like
569           "HAS_BAR,BAZ=64", the optional options
570             #define CONFIG_HAS
571             #define CONFIG_BAZ  64
572           will be defined in include/config.h.
573           This option was prepared for the smooth migration from the old
574           configuration to Kconfig. Since this option will be removed sometime,
575           new boards should not use this option.
576
577 config HAVE_SYS_TEXT_BASE
578         bool
579         depends on !NIOS2 && !XTENSA
580         depends on !EFI_APP
581         default y
582
583 config SYS_TEXT_BASE
584         depends on HAVE_SYS_TEXT_BASE
585         default 0x80800000 if ARCH_OMAP2PLUS || ARCH_K3
586         default 0x4a000000 if ARCH_SUNXI && !MACH_SUN9I && !MACH_SUN8I_V3S
587         default 0x2a000000 if ARCH_SUNXI && MACH_SUN9I
588         default 0x42e00000 if ARCH_SUNXI && MACH_SUN8I_V3S
589         hex "Text Base"
590         help
591           The address in memory that U-Boot will be running from, initially.
592
593 config SYS_CLK_FREQ
594         depends on ARC || ARCH_SUNXI || MPC83xx
595         int "CPU clock frequency"
596         help
597           TODO: Move CONFIG_SYS_CLK_FREQ for all the architecture
598
599 config ARCH_FIXUP_FDT_MEMORY
600         bool "Enable arch_fixup_memory_banks() call"
601         default y
602         help
603           Enable FDT memory map syncup before OS boot. This feature can be
604           used for booting OS with different memory setup where the part of
605           the memory location should be used for different purpose.
606
607 endmenu         # Boot images
608
609 source "api/Kconfig"
610
611 source "common/Kconfig"
612
613 source "cmd/Kconfig"
614
615 source "disk/Kconfig"
616
617 source "dts/Kconfig"
618
619 source "env/Kconfig"
620
621 source "net/Kconfig"
622
623 source "drivers/Kconfig"
624
625 source "fs/Kconfig"
626
627 source "lib/Kconfig"
628
629 source "test/Kconfig"