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