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