common/spl/Kconfig

   1 menu "SPL / TPL"
   2
   3 config SUPPORT_SPL
   4         bool
   5
   6 config SUPPORT_TPL
   7         bool
   8
   9 config SPL_DFU_NO_RESET
  10         bool
  11
  12 config SPL
  13         bool
  14         depends on SUPPORT_SPL
  15         prompt "Enable SPL"
  16         help
  17           If you want to build SPL as well as the normal image, say Y.
  18
  19 config SPL_FRAMEWORK
  20         bool "Support SPL based upon the common SPL framework"
  21         depends on SPL
  22         default y
  23         help
  24           Enable the SPL framework under common/spl/.  This framework
  25           supports MMC, NAND and YMODEM and other methods loading of U-Boot
  26           and the Linux Kernel.  If unsure, say Y.
  27
  28 config SPL_FRAMEWORK_BOARD_INIT_F
  29         bool "Define a generic function board_init_f"
  30         depends on SPL_FRAMEWORK
  31         help
  32           Define a generic function board_init_f that:
  33           - initialize the spl (spl_early_init)
  34           - initialize the serial (preloader_console_init)
  35           Unless you want to provide your own board_init_f, you should say Y.
  36
  37 config SPL_SIZE_LIMIT
  38         hex "Maximum size of SPL image"
  39         depends on SPL
  40         default 0x11000 if ARCH_MX6 && !MX6_OCRAM_256KB
  41         default 0x31000 if ARCH_MX6 && MX6_OCRAM_256KB
  42         default 0x0
  43         help
  44           Specifies the maximum length of the U-Boot SPL image.
  45           If this value is zero, it is ignored.
  46
  47 config SPL_SIZE_LIMIT_SUBTRACT_GD
  48         bool "SPL image size check: provide space for global data"
  49         depends on SPL_SIZE_LIMIT > 0
  50         help
  51           If enabled, aligned size of global data is reserved in
  52           SPL_SIZE_LIMIT check to ensure such an image does not overflow SRAM
  53           if SPL_SIZE_LIMIT describes the size of SRAM available for SPL when
  54           pre-reloc global data is put into this SRAM, too.
  55
  56 config SPL_SIZE_LIMIT_SUBTRACT_MALLOC
  57         bool "SPL image size check: provide space for malloc() pool before relocation"
  58         depends on SPL_SIZE_LIMIT > 0
  59         help
  60           If enabled, SPL_SYS_MALLOC_F_LEN is reserved in SPL_SIZE_LIMIT check
  61           to ensure such an image does not overflow SRAM if SPL_SIZE_LIMIT
  62           describes the size of SRAM available for SPL when pre-reloc malloc
  63           pool is put into this SRAM, too.
  64
  65 config SPL_SIZE_LIMIT_PROVIDE_STACK
  66         hex "SPL image size check: provide stack space before relocation"
  67         depends on SPL_SIZE_LIMIT > 0
  68         default 0
  69         help
  70           If set, this size is reserved in SPL_SIZE_LIMIT check to ensure such
  71           an image does not overflow SRAM if SPL_SIZE_LIMIT describes the size
  72           of SRAM available for SPL when the stack required before reolcation
  73           uses this SRAM, too.
  74
  75 config SPL_SYS_STACK_F_CHECK_BYTE
  76         hex
  77         default 0xaa
  78         help
  79           Constant used to check the stack
  80
  81 config SPL_SYS_REPORT_STACK_F_USAGE
  82         depends on SPL_SIZE_LIMIT_PROVIDE_STACK != 0
  83         bool "Check and report stack usage in SPL before relocation"
  84         help
  85           If this option is enabled, the initial SPL stack is filled with 0xaa
  86           very early, up to the size configured with
  87           SPL_SIZE_LIMIT_PROVIDE_STACK.
  88           Later when SPL is done using this initial stack and switches to a
  89           stack in DRAM, the actually used size of this initial stack is
  90           reported by examining the memory and searching for the lowest
  91           occurrence of non 0xaa bytes.
  92           This default implementation works for stacks growing down only.
  93
  94 menu "PowerPC and LayerScape SPL Boot options"
  95
  96 config SPL_NAND_BOOT
  97         bool "Load SPL from NAND flash"
  98         depends on PPC && (SUPPORT_SPL && !SPL_FRAMEWORK)
  99
 100 config SPL_MMC_BOOT
 101         bool "Load SPL from SD Card / eMMC"
 102         depends on PPC && (SUPPORT_SPL && !SPL_FRAMEWORK)
 103
 104 config SPL_SPI_BOOT
 105         bool "Load SPL from SPI flash"
 106         depends on PPC && (SUPPORT_SPL && !SPL_FRAMEWORK)
 107
 108 config SPL_FSL_PBL
 109         bool "Create SPL in Freescale PBI format"
 110         depends on (PPC || ARCH_LS1021A || ARCH_LS1043A || ARCH_LS1046A) && \
 111                     SUPPORT_SPL
 112         help
 113           Create boot binary having SPL binary in PBI format concatenated with
 114           u-boot binary.
 115
 116 config SPL_ALLOC_BD
 117         bool "Allocate memory for bd_info"
 118         default y if X86 || SANDBOX
 119         help
 120           Some boards don't allocate space for this in their board_init_f()
 121           code. In this case U-Boot can allocate space for gd->bd in the
 122           standard SPL flow (board_init_r()). Enable this option to support
 123           this feature.
 124
 125 endmenu
 126
 127 config HANDOFF
 128         bool "Pass hand-off information from SPL to U-Boot proper"
 129         depends on SPL && BLOBLIST
 130         help
 131           It is useful to be able to pass information from SPL to U-Boot
 132           proper to preserve state that is known in SPL and is needed in U-Boot.
 133           Enable this to locate the handoff information in U-Boot proper, early
 134           in boot. It is available in gd->handoff. The state state is set up
 135           in SPL (or TPL if that is being used).
 136
 137 if SPL
 138
 139 config SPL_HANDOFF
 140         bool "Pass hand-off information from SPL to U-Boot proper"
 141         depends on HANDOFF && SPL_BLOBLIST
 142         default y
 143         help
 144           This option enables SPL to write handoff information. This can be
 145           used to pass information like the size of SDRAM from SPL to U-Boot
 146           proper. Also SPL can receive information from TPL in the same place
 147           if that is enabled.
 148
 149 config SPL_LDSCRIPT
 150         string "Linker script for the SPL stage"
 151         default "arch/\$(ARCH)/cpu/u-boot-spl.lds"
 152         help
 153           The SPL stage will usually require a different linker-script
 154           (as it runs from a different memory region) than the regular
 155           U-Boot stage.  Set this to the path of the linker-script to
 156           be used for SPL.
 157
 158 config SPL_TEXT_BASE
 159         hex "SPL Text Base"
 160         default ISW_ENTRY_ADDR if AM43XX || AM33XX || OMAP54XX || ARCH_KEYSTONE
 161         default 0x10060 if MACH_SUN50I || MACH_SUN50I_H5 || MACH_SUN9I
 162         default 0x20060 if SUN50I_GEN_H6
 163         default 0x00060 if ARCH_SUNXI
 164         default 0xfffc0000 if ARCH_ZYNQMP
 165         default 0x0
 166         help
 167           The address in memory that SPL will be running from.
 168
 169 config SPL_BOARD_INIT
 170         bool "Call board-specific initialization in SPL"
 171         help
 172           If this option is enabled, U-Boot will call the function
 173           spl_board_init() from board_init_r(). This function should be
 174           provided by the board.
 175
 176 config SPL_BOOTROM_SUPPORT
 177         bool "Support returning to the BOOTROM"
 178         help
 179           Some platforms (e.g. the Rockchip RK3368) provide support in their
 180           ROM for loading the next boot-stage after performing basic setup
 181           from the SPL stage.
 182
 183           Enable this option, to return to the BOOTROM through the
 184           BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
 185           boot device list, if not implemented for a given board)
 186
 187 config SPL_BOOTCOUNT_LIMIT
 188         bool "Support bootcount in SPL"
 189         depends on SPL_ENV_SUPPORT && !TPL_BOOTCOUNT_LIMIT
 190         help
 191           On some boards, which use 'falcon' mode, it is necessary to check
 192           and increment the number of boot attempts. Such boards do not
 193           use proper U-Boot for normal boot flow and hence needs those
 194           adjustments to be done in the SPL.
 195
 196 config SPL_RAW_IMAGE_SUPPORT
 197         bool "Support SPL loading and booting of RAW images"
 198         default n if (ARCH_MX6 && (SPL_MMC_SUPPORT || SPL_SATA_SUPPORT))
 199         default y if !TI_SECURE_DEVICE
 200         help
 201           SPL will support loading and booting a RAW image when this option
 202           is y. If this is not set, SPL will move on to other available
 203           boot media to find a suitable image.
 204
 205 config SPL_LEGACY_IMAGE_SUPPORT
 206         bool "Support SPL loading and booting of Legacy images"
 207         default y if !TI_SECURE_DEVICE && !SPL_LOAD_FIT
 208         help
 209           SPL will support loading and booting Legacy images when this option
 210           is y. If this is not set, SPL will move on to other available
 211           boot media to find a suitable image.
 212
 213 config SPL_LEGACY_IMAGE_CRC_CHECK
 214         bool "Check CRC of Legacy images"
 215         depends on SPL_LEGACY_IMAGE_SUPPORT
 216         select SPL_CRC32_SUPPORT
 217         help
 218           Enable this to check the CRC of Legacy images. While this increases
 219           reliability, it affects both code size and boot duration.
 220           If disabled, Legacy images are booted if the image magic and size
 221           are correct, without further integrity checks.
 222
 223 config SPL_SYS_MALLOC_SIMPLE
 224         bool
 225         prompt "Only use malloc_simple functions in the SPL"
 226         help
 227           Say Y here to only use the *_simple malloc functions from
 228           malloc_simple.c, rather then using the versions from dlmalloc.c;
 229           this will make the SPL binary smaller at the cost of more heap
 230           usage as the *_simple malloc functions do not re-use free-ed mem.
 231
 232 config TPL_SYS_MALLOC_SIMPLE
 233         bool
 234         prompt "Only use malloc_simple functions in the TPL"
 235         depends on TPL
 236         help
 237           Say Y here to only use the *_simple malloc functions from
 238           malloc_simple.c, rather then using the versions from dlmalloc.c;
 239           this will make the TPL binary smaller at the cost of more heap
 240           usage as the *_simple malloc functions do not re-use free-ed mem.
 241
 242 config SPL_STACK_R
 243         bool "Enable SDRAM location for SPL stack"
 244         help
 245           SPL starts off execution in SRAM and thus typically has only a small
 246           stack available. Since SPL sets up DRAM while in its board_init_f()
 247           function, it is possible for the stack to move there before
 248           board_init_r() is reached. This option enables a special SDRAM
 249           location for the SPL stack. U-Boot SPL switches to this after
 250           board_init_f() completes, and before board_init_r() starts.
 251
 252 config SPL_STACK_R_ADDR
 253         depends on SPL_STACK_R
 254         hex "SDRAM location for SPL stack"
 255         default 0x82000000 if ARCH_OMAP2PLUS
 256         help
 257           Specify the address in SDRAM for the SPL stack. This will be set up
 258           before board_init_r() is called.
 259
 260 config SPL_STACK_R_MALLOC_SIMPLE_LEN
 261         depends on SPL_STACK_R && SPL_SYS_MALLOC_SIMPLE
 262         hex "Size of malloc_simple heap after switching to DRAM SPL stack"
 263         default 0x100000
 264         help
 265           Specify the amount of the stack to use as memory pool for
 266           malloc_simple after switching the stack to DRAM. This may be set
 267           to give board_init_r() a larger heap then the initial heap in
 268           SRAM which is limited to SYS_MALLOC_F_LEN bytes.
 269
 270 config SPL_SEPARATE_BSS
 271         bool "BSS section is in a different memory region from text"
 272         help
 273           Some platforms need a large BSS region in SPL and can provide this
 274           because RAM is already set up. In this case BSS can be moved to RAM.
 275           This option should then be enabled so that the correct device tree
 276           location is used. Normally we put the device tree at the end of BSS
 277           but with this option enabled, it goes at _image_binary_end.
 278
 279 config SPL_READ_ONLY
 280         bool
 281         depends on SPL_OF_PLATDATA
 282         # Bind cannot be supported because the udevice structs are in read-only
 283         # memory so we cannot update the linked lists.
 284         select SPL_OF_PLATDATA_NO_BIND
 285         select SPL_OF_PLATDATA_RT
 286         help
 287           Some platforms (e.g. x86 Apollo Lake) load SPL into a read-only
 288           section of memory. This means that of-platdata must make a copy (in
 289           writeable memory) of anything it wants to modify, such as
 290           device-private data.
 291
 292 config SPL_BANNER_PRINT
 293         bool "Enable output of the SPL banner 'U-Boot SPL ...'"
 294         default y
 295         help
 296           If this option is enabled, SPL will print the banner with version
 297           info. Disabling this option could be useful to reduce SPL boot time
 298           (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
 299
 300 config TPL_BANNER_PRINT
 301         bool "Enable output of the TPL banner 'U-Boot TPL ...'"
 302         depends on TPL
 303         default y
 304         help
 305           If this option is enabled, TPL will print the banner with version
 306           info. Disabling this option could be useful to reduce TPL boot time
 307           (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
 308
 309 config SPL_EARLY_BSS
 310         depends on ARM && !ARM64
 311         bool "Allows initializing BSS early before entering board_init_f"
 312         help
 313           On some platform we have sufficient memory available early on to
 314           allow setting up and using a basic BSS prior to entering
 315           board_init_f. Activating this option will also de-activate the
 316           clearing of BSS during the SPL relocation process, thus allowing
 317           to carry state from board_init_f to board_init_r by way of BSS.
 318
 319 config SPL_DISPLAY_PRINT
 320         bool "Display a board-specific message in SPL"
 321         help
 322           If this option is enabled, U-Boot will call the function
 323           spl_display_print() immediately after displaying the SPL console
 324           banner ("U-Boot SPL ..."). This function should be provided by
 325           the board.
 326
 327 config SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
 328         bool "MMC raw mode: by sector"
 329         default y if ARCH_SUNXI || ARCH_DAVINCI || ARCH_UNIPHIER || \
 330                      ARCH_MX6 || ARCH_MX7 || \
 331                      ARCH_ROCKCHIP || ARCH_MVEBU ||  ARCH_SOCFPGA || \
 332                      ARCH_AT91 || ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || \
 333                      OMAP44XX || OMAP54XX || AM33XX || AM43XX || TARGET_SIFIVE_FU540
 334         help
 335           Use sector number for specifying U-Boot location on MMC/SD in
 336           raw mode.
 337
 338 config SYS_MMCSD_RAW_MODE_U_BOOT_SECTOR
 339         hex "Address on the MMC to load U-Boot from"
 340         depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
 341         default 0x40 if ARCH_SUNXI
 342         default 0x75 if ARCH_DAVINCI
 343         default 0x8a if ARCH_MX6 || ARCH_MX7
 344         default 0x100 if ARCH_UNIPHIER
 345         default 0x140 if ARCH_MVEBU
 346         default 0x200 if ARCH_SOCFPGA || ARCH_AT91
 347         default 0x300 if ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || OMAP44XX || \
 348                          OMAP54XX || AM33XX || AM43XX || ARCH_K3
 349         default 0x4000 if ARCH_ROCKCHIP
 350         default 0x822 if TARGET_SIFIVE_FU540
 351         help
 352           Address on the MMC to load U-Boot from, when the MMC is being used
 353           in raw mode. Units: MMC sectors (1 sector = 512 bytes).
 354
 355 config SYS_MMCSD_RAW_MODE_U_BOOT_DATA_PART_OFFSET
 356         hex "U-Boot main hardware partition image offset"
 357         depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
 358         default 0x10 if ARCH_SUNXI
 359         default 0x0
 360         help
 361           On some platforms SPL location depends on hardware partition. The ROM
 362           code skips the MBR sector when loading SPL from main hardware data
 363           partition. This adds offset to the main U-Boot image. Set this symbol
 364           to the number of skipped sectors.
 365
 366           If unsure, leave the default.
 367
 368 config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
 369         bool "MMC Raw mode: by partition"
 370         help
 371           Use a partition for loading U-Boot when using MMC/SD in raw mode.
 372
 373 config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION
 374         hex "Partition to use to load U-Boot from"
 375         depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
 376         default 1
 377         help
 378           Partition on the MMC to load U-Boot from when the MMC is being
 379           used in raw mode
 380
 381 config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
 382         bool "MMC raw mode: by partition type"
 383         depends on DOS_PARTITION && SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
 384         help
 385           Use partition type for specifying U-Boot partition on MMC/SD in
 386           raw mode. U-Boot will be loaded from the first partition of this
 387           type to be found.
 388
 389 config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION_TYPE
 390         hex "Partition Type on the MMC to load U-Boot from"
 391         depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
 392         help
 393           Partition Type on the MMC to load U-Boot from, when the MMC is being
 394           used in raw mode.
 395
 396 config SUPPORT_EMMC_BOOT_OVERRIDE_PART_CONFIG
 397         bool "Override eMMC EXT_CSC_PART_CONFIG by user defined partition"
 398         depends on SUPPORT_EMMC_BOOT
 399         help
 400           eMMC boot partition is normally configured by the bits of the EXT_CSD
 401           register (EXT_CSC_PART_CONFIG), BOOT_PARTITION_ENABLE field. In some
 402           cases it might be required in SPL to load the image from different
 403           partition than the partition selected by EXT_CSC_PART_CONFIG register.
 404           Enable this option if you intend to use an eMMC boot partition other
 405           then selected via EXT_CSC_PART_CONFIG register and specify the custom
 406           partition number by the CONFIG_SYS_MMCSD_RAW_MODE_EMMC_BOOT_PARTITION
 407           option.
 408
 409 config SYS_MMCSD_RAW_MODE_EMMC_BOOT_PARTITION
 410         int "Number of the eMMC boot partition to use"
 411         depends on SUPPORT_EMMC_BOOT_OVERRIDE_PART_CONFIG
 412         default 1
 413         help
 414           eMMC boot partition number to use when the eMMC in raw mode and
 415           the eMMC EXT_CSC_PART_CONFIG selection should be overridden in SPL
 416           by user defined partition number.
 417
 418 config SPL_CRC32_SUPPORT
 419         bool "Support CRC32"
 420         default y if SPL_LEGACY_IMAGE_SUPPORT
 421         help
 422           Enable this to support CRC32 in uImages or FIT images within SPL.
 423           This is a 32-bit checksum value that can be used to verify images.
 424           For FIT images, this is the least secure type of checksum, suitable
 425           for detected accidental image corruption. For secure applications you
 426           should consider SHA1 or SHA256.
 427
 428 config SPL_MD5_SUPPORT
 429         bool "Support MD5"
 430         depends on SPL_FIT
 431         help
 432           Enable this to support MD5 in FIT images within SPL. An MD5
 433           checksum is a 128-bit hash value used to check that the image
 434           contents have not been corrupted. Note that MD5 is not considered
 435           secure as it is possible (with a brute-force attack) to adjust the
 436           image while still retaining the same MD5 hash value. For secure
 437           applications where images may be changed maliciously, you should
 438           consider SHA256 or SHA384.
 439
 440 config SPL_SHA1_SUPPORT
 441         bool "Support SHA1"
 442         depends on SPL_FIT
 443         select SHA1
 444         help
 445           Enable this to support SHA1 in FIT images within SPL. A SHA1
 446           checksum is a 160-bit (20-byte) hash value used to check that the
 447           image contents have not been corrupted or maliciously altered.
 448           While SHA1 is fairly secure it is coming to the end of its life
 449           due to the expanding computing power available to brute-force
 450           attacks. For more security, consider SHA256 or SHA384.
 451
 452 config SPL_SHA256_SUPPORT
 453         bool "Support SHA256"
 454         depends on SPL_FIT
 455         select SHA256
 456         help
 457           Enable this to support SHA256 in FIT images within SPL. A SHA256
 458           checksum is a 256-bit (32-byte) hash value used to check that the
 459           image contents have not been corrupted.
 460
 461 config SPL_SHA384_SUPPORT
 462         bool "Support SHA384"
 463         depends on SPL_FIT
 464         select SHA384
 465         select SHA512_ALGO
 466         help
 467           Enable this to support SHA384 in FIT images within SPL. A SHA384
 468           checksum is a 384-bit (48-byte) hash value used to check that the
 469           image contents have not been corrupted. Use this for the highest
 470           security.
 471
 472 config SPL_SHA512_SUPPORT
 473         bool "Support SHA512"
 474         depends on SPL_FIT
 475         select SHA512
 476         select SHA512_ALGO
 477         help
 478           Enable this to support SHA512 in FIT images within SPL. A SHA512
 479           checksum is a 512-bit (64-byte) hash value used to check that the
 480           image contents have not been corrupted.
 481
 482 config SPL_FIT_IMAGE_TINY
 483         bool "Remove functionality from SPL FIT loading to reduce size"
 484         depends on SPL_FIT
 485         default y if MACH_SUN50I || MACH_SUN50I_H5 || SUN50I_GEN_H6
 486         default y if ARCH_IMX8M
 487         help
 488           Enable this to reduce the size of the FIT image loading code
 489           in SPL, if space for the SPL binary is very tight.
 490
 491           This skips the recording of each loaded payload
 492           (i.e. loadable) into the FDT (modifying the loaded FDT to
 493           ensure this information is available to the next image
 494           invoked).
 495
 496 config SPL_CACHE_SUPPORT
 497         bool "Support CACHE drivers"
 498         help
 499           Enable CACHE drivers in SPL. These drivers can keep data so that
 500           future requests for that data can be served faster. Enable this option
 501           to build the drivers in drivers/cache as part of an SPL build.
 502
 503 config SPL_CPU
 504         bool "Support CPU drivers"
 505         help
 506           Enable this to support CPU drivers in SPL. These drivers can set
 507           up CPUs and provide information about them such as the model and
 508           name. This can be useful in SPL since setting up the CPUs earlier
 509           may improve boot performance. Enable this option to build the
 510           drivers in drivers/cpu as part of an SPL build.
 511
 512 config SPL_CRYPTO_SUPPORT
 513         bool "Support crypto drivers"
 514         help
 515           Enable crypto drivers in SPL. These drivers can be used to
 516           accelerate secure boot processing in secure applications. Enable
 517           this option to build the drivers in drivers/crypto as part of an
 518           SPL build.
 519
 520 config SPL_HASH_SUPPORT
 521         bool "Support hashing drivers"
 522         select SHA1
 523         select SHA256
 524         help
 525           Enable hashing drivers in SPL. These drivers can be used to
 526           accelerate secure boot processing in secure applications. Enable
 527           this option to build system-specific drivers for hash acceleration
 528           as part of an SPL build.
 529
 530 config TPL_HASH_SUPPORT
 531         bool "Support hashing drivers in TPL"
 532         depends on TPL
 533         select SHA1
 534         select SHA256
 535         help
 536           Enable hashing drivers in SPL. These drivers can be used to
 537           accelerate secure boot processing in secure applications. Enable
 538           this option to build system-specific drivers for hash acceleration
 539           as part of an SPL build.
 540
 541 config SPL_DMA
 542         bool "Support DMA drivers"
 543         help
 544           Enable DMA (direct-memory-access) drivers in SPL. These drivers
 545           can be used to handle memory-to-peripheral data transfer without
 546           the CPU moving the data. Enable this option to build the drivers
 547           in drivers/dma as part of an SPL build.
 548
 549 config SPL_DRIVERS_MISC_SUPPORT
 550         bool "Support misc drivers"
 551         help
 552           Enable miscellaneous drivers in SPL. These drivers perform various
 553           tasks that don't fall nicely into other categories, Enable this
 554           option to build the drivers in drivers/misc as part of an SPL
 555           build, for those that support building in SPL (not all drivers do).
 556
 557 config SPL_ENV_SUPPORT
 558         bool "Support an environment"
 559         help
 560           Enable environment support in SPL. The U-Boot environment provides
 561           a number of settings (essentially name/value pairs) which can
 562           control many aspects of U-Boot's operation. Normally this is not
 563           needed in SPL as it has a much simpler task with less
 564           configuration. But some boards use this to support 'Falcon' boot
 565           on EXT2 and FAT, where SPL boots directly into Linux without
 566           starting U-Boot first. Enabling this option will make env_get()
 567           and env_set() available in SPL.
 568
 569 config SPL_SAVEENV
 570         bool "Support save environment"
 571         depends on SPL_ENV_SUPPORT
 572         select SPL_MMC_WRITE if ENV_IS_IN_MMC
 573         help
 574           Enable save environment support in SPL after setenv. By default
 575           the saveenv option is not provided in SPL, but some boards need
 576           this support in 'Falcon' boot, where SPL need to boot from
 577           different images based on environment variable set by OS. For
 578           example OS may set "reboot_image" environment variable to
 579           "recovery" inorder to boot recovery image by SPL. The SPL read
 580           "reboot_image" and act accordingly and change the reboot_image
 581           to default mode using setenv and save the environment.
 582
 583 config SPL_ETH_SUPPORT
 584         bool "Support Ethernet"
 585         depends on SPL_ENV_SUPPORT
 586         help
 587           Enable access to the network subsystem and associated Ethernet
 588           drivers in SPL. This permits SPL to load U-Boot over an Ethernet
 589           link rather than from an on-board peripheral. Environment support
 590           is required since the network stack uses a number of environment
 591           variables. See also SPL_NET_SUPPORT.
 592
 593 config SPL_FS_EXT4
 594         bool "Support EXT filesystems"
 595         help
 596           Enable support for EXT2/3/4 filesystems with SPL. This permits
 597           U-Boot (or Linux in Falcon mode) to be loaded from an EXT
 598           filesystem from within SPL. Support for the underlying block
 599           device (e.g. MMC or USB) must be enabled separately.
 600
 601 config SPL_FS_SQUASHFS
 602         bool "Support SquashFS filesystems"
 603         select FS_SQUASHFS
 604         help
 605           Enable support for SquashFS filesystems with SPL. This permits
 606           U-Boot (or Linux in Falcon mode) to be loaded from a SquashFS
 607           filesystem from within SPL. Support for the underlying block
 608           device (e.g. MMC or USB) must be enabled separately.
 609
 610 config SPL_FS_FAT
 611         bool "Support FAT filesystems"
 612         select FS_FAT
 613         help
 614           Enable support for FAT and VFAT filesystems with SPL. This
 615           permits U-Boot (or Linux in Falcon mode) to be loaded from a FAT
 616           filesystem from within SPL. Support for the underlying block
 617           device (e.g. MMC or USB) must be enabled separately.
 618
 619 config SPL_FAT_WRITE
 620         bool "Support write for FAT filesystems"
 621         help
 622           Enable write support for FAT and VFAT filesystems with SPL.
 623           Support for the underlying block device (e.g. MMC or USB) must be
 624           enabled separately.
 625
 626 config SPL_FPGA
 627         bool "Support FPGAs"
 628         help
 629           Enable support for FPGAs in SPL. Field-programmable Gate Arrays
 630           provide software-configurable hardware which is typically used to
 631           implement peripherals (such as UARTs, LCD displays, MMC) or
 632           accelerate custom processing functions, such as image processing
 633           or machine learning. Sometimes it is useful to program the FPGA
 634           as early as possible during boot, and this option can enable that
 635           within SPL.
 636
 637 config SPL_GPIO_SUPPORT
 638         bool "Support GPIO in SPL"
 639         help
 640           Enable support for GPIOs (General-purpose Input/Output) in SPL.
 641           GPIOs allow U-Boot to read the state of an input line (high or
 642           low) and set the state of an output line. This can be used to
 643           drive LEDs, control power to various system parts and read user
 644           input. GPIOs can be useful in SPL to enable a 'sign-of-life' LED,
 645           for example. Enable this option to build the drivers in
 646           drivers/gpio as part of an SPL build.
 647
 648 config SPL_I2C_SUPPORT
 649         bool "Support I2C"
 650         help
 651           Enable support for the I2C (Inter-Integrated Circuit) bus in SPL.
 652           I2C works with a clock and data line which can be driven by a
 653           one or more masters or slaves. It is a fairly complex bus but is
 654           widely used as it only needs two lines for communication. Speeds of
 655           400kbps are typical but up to 3.4Mbps is supported by some
 656           hardware. I2C can be useful in SPL to configure power management
 657           ICs (PMICs) before raising the CPU clock speed, for example.
 658           Enable this option to build the drivers in drivers/i2c as part of
 659           an SPL build.
 660
 661 config SPL_LIBCOMMON_SUPPORT
 662         bool "Support common libraries"
 663         help
 664           Enable support for common U-Boot libraries within SPL. These
 665           libraries include common code to deal with U-Boot images,
 666           environment and USB, for example. This option is enabled on many
 667           boards. Enable this option to build the code in common/ as part of
 668           an SPL build.
 669
 670 config SPL_LIBDISK_SUPPORT
 671         bool "Support disk partitions"
 672         select PARTITIONS
 673         help
 674           Enable support for disk partitions within SPL. 'Disk' is something
 675           of a misnomer as it includes non-spinning media such as flash (as
 676           used in MMC and USB sticks). Partitions provide a way for a disk
 677           to be split up into separate regions, with a partition table placed
 678           at the start or end which describes the location and size of each
 679           'partition'. These partitions are typically uses as individual block
 680           devices, typically with an EXT2 or FAT filesystem in each. This
 681           option enables whatever partition support has been enabled in
 682           U-Boot to also be used in SPL. It brings in the code in disk/.
 683
 684 config SPL_LIBGENERIC_SUPPORT
 685         bool "Support generic libraries"
 686         help
 687           Enable support for generic U-Boot libraries within SPL. These
 688           libraries include generic code to deal with device tree, hashing,
 689           printf(), compression and the like. This option is enabled on many
 690           boards. Enable this option to build the code in lib/ as part of an
 691           SPL build.
 692
 693 config SPL_DM_MAILBOX
 694         bool "Support Mailbox"
 695         help
 696           Enable support for Mailbox within SPL. This enable the inter
 697           processor communication protocols tobe used within SPL. Enable
 698           this option to build the drivers in drivers/mailbox as part of
 699           SPL build.
 700
 701 config SPL_MMC_SUPPORT
 702         bool "Support MMC"
 703         depends on MMC
 704         select HAVE_BLOCK_DEVICE
 705         help
 706           Enable support for MMC (Multimedia Card) within SPL. This enables
 707           the MMC protocol implementation and allows any enabled drivers to
 708           be used within SPL. MMC can be used with or without disk partition
 709           support depending on the application (SPL_LIBDISK_SUPPORT). Enable
 710           this option to build the drivers in drivers/mmc as part of an SPL
 711           build.
 712
 713 config SYS_MMCSD_FS_BOOT_PARTITION
 714         int "MMC Boot Partition"
 715         default 1
 716         help
 717           Partition on the MMC to load U-Boot from when the MMC is being
 718           used in fs mode
 719
 720 config SPL_MMC_TINY
 721         bool "Tiny MMC framework in SPL"
 722         depends on SPL_MMC_SUPPORT
 723         default n
 724         help
 725           Enable MMC framework tinification support. This option is useful if
 726           if your SPL is extremely size constrained. Heed the warning, enable
 727           this option if and only if you know exactly what you are doing, if
 728           you are reading this help text, you most likely have no idea :-)
 729
 730           The MMC framework is reduced to bare minimum to be useful. No malloc
 731           support is needed for the MMC framework operation with this option
 732           enabled. The framework supports exactly one MMC device and exactly
 733           one MMC driver. The MMC driver can be adjusted to avoid any malloc
 734           operations too, which can remove the need for malloc support in SPL
 735           and thus further reduce footprint.
 736
 737 config SPL_MMC_WRITE
 738         bool "MMC/SD/SDIO card support for write operations in SPL"
 739         depends on SPL_MMC_SUPPORT
 740         default n
 741         help
 742           Enable write access to MMC and SD Cards in SPL
 743
 744
 745 config SPL_MPC8XXX_INIT_DDR_SUPPORT
 746         bool "Support MPC8XXX DDR init"
 747         help
 748           Enable support for DDR-SDRAM (double-data-rate synchronous dynamic
 749           random-access memory) on the MPC8XXX family within SPL. This
 750           allows DRAM to be set up before loading U-Boot into that DRAM,
 751           where it can run.
 752
 753 config SPL_MTD_SUPPORT
 754         bool "Support MTD drivers"
 755         help
 756           Enable support for MTD (Memory Technology Device) within SPL. MTD
 757           provides a block interface over raw NAND and can also be used with
 758           SPI flash. This allows SPL to load U-Boot from supported MTD
 759           devices. See SPL_NAND_SUPPORT and SPL_ONENAND_SUPPORT for how
 760           to enable specific MTD drivers.
 761
 762 config SPL_MUSB_NEW_SUPPORT
 763         bool "Support new Mentor Graphics USB"
 764         help
 765           Enable support for Mentor Graphics USB in SPL. This is a new
 766           driver used by some boards. Enable this option to build
 767           the drivers in drivers/usb/musb-new as part of an SPL build. The
 768           old drivers are in drivers/usb/musb.
 769
 770 config SPL_NAND_SUPPORT
 771         bool "Support NAND flash"
 772         help
 773           Enable support for NAND (Negative AND) flash in SPL. NAND flash
 774           can be used to allow SPL to load U-Boot from supported devices.
 775           This enables the drivers in drivers/mtd/nand/raw as part of an SPL
 776           build.
 777
 778 config SPL_NAND_DRIVERS
 779         bool "Use standard NAND driver"
 780         help
 781           SPL uses normal NAND drivers, not minimal drivers.
 782
 783 config SPL_NAND_ECC
 784         bool "Include standard software ECC in the SPL"
 785
 786 config SPL_NAND_SIMPLE
 787         bool "Support simple NAND drivers in SPL"
 788         help
 789           Support for NAND boot using simple NAND drivers that
 790           expose the cmd_ctrl() interface.
 791
 792 config SPL_NAND_BASE
 793         depends on SPL_NAND_DRIVERS
 794         bool "Use Base NAND Driver"
 795         help
 796           Include nand_base.c in the SPL.
 797
 798 config SPL_NAND_IDENT
 799         depends on SPL_NAND_BASE
 800         bool "Use chip ID to identify NAND flash"
 801         help
 802           SPL uses the chip ID list to identify the NAND flash.
 803
 804 config SPL_UBI
 805         bool "Support UBI"
 806         help
 807           Enable support for loading payloads from UBI. See
 808           README.ubispl for more info.
 809
 810 if SPL_DM
 811 config SPL_CACHE
 812         depends on CACHE
 813         bool "Support cache drivers in SPL"
 814         help
 815           Enable support for cache drivers in SPL.
 816
 817 config SPL_DM_SPI
 818         bool "Support SPI DM drivers in SPL"
 819         help
 820           Enable support for SPI DM drivers in SPL.
 821
 822 config SPL_DM_SPI_FLASH
 823         bool "Support SPI DM FLASH drivers in SPL"
 824         help
 825           Enable support for SPI DM flash drivers in SPL.
 826
 827 endif
 828 if SPL_UBI
 829 config SPL_UBI_LOAD_BY_VOLNAME
 830         bool "Support loading volumes by name"
 831         help
 832           This enables support for loading UBI volumes by name. When this
 833           is set, CONFIG_SPL_UBI_LOAD_MONITOR_VOLNAME can be used to
 834           configure the volume name from which to load U-Boot.
 835
 836 config SPL_UBI_MAX_VOL_LEBS
 837         int "Maximum number of LEBs per volume"
 838         depends on SPL_UBI
 839         help
 840           The maximum number of logical eraseblocks which a static volume
 841           to load can contain. Used for sizing the scan data structure.
 842
 843 config SPL_UBI_MAX_PEB_SIZE
 844         int "Maximum PEB size"
 845         depends on SPL_UBI
 846         help
 847           The maximum physical erase block size.
 848
 849 config SPL_UBI_MAX_PEBS
 850         int "Maximum number of PEBs"
 851         depends on SPL_UBI
 852         help
 853           The maximum physical erase block size. If not overridden by
 854           board code, this value will be used as the actual number of PEBs.
 855
 856 config SPL_UBI_PEB_OFFSET
 857         int "Offset to first UBI PEB"
 858         depends on SPL_UBI
 859         help
 860           The offset in number of PEBs from the start of flash to the first
 861           PEB part of the UBI image.
 862
 863 config SPL_UBI_VID_OFFSET
 864         int "Offset to VID header"
 865         depends on SPL_UBI
 866
 867 config SPL_UBI_LEB_START
 868         int "Offset to LEB in PEB"
 869         depends on SPL_UBI
 870         help
 871           The offset in bytes to the LEB within a PEB.
 872
 873 config SPL_UBI_INFO_ADDR
 874         hex "Address to place UBI scan info"
 875         depends on SPL_UBI
 876         help
 877           Address for ubispl to place the scan info. Read README.ubispl to
 878           determine the required size
 879
 880 config SPL_UBI_VOL_IDS
 881         int "Maximum volume id"
 882         depends on SPL_UBI
 883         help
 884           The maximum volume id which can be loaded. Used for sizing the
 885           scan data structure.
 886
 887 config SPL_UBI_LOAD_MONITOR_ID
 888         int "id of U-Boot volume"
 889         depends on SPL_UBI
 890         help
 891           The UBI volume id from which to load U-Boot
 892
 893 config SPL_UBI_LOAD_MONITOR_VOLNAME
 894         string "volume name of U-Boot volume"
 895         depends on SPL_UBI_LOAD_BY_VOLNAME
 896         help
 897           The UBI volume name from which to load U-Boot
 898
 899 config SPL_UBI_LOAD_KERNEL_ID
 900         int "id of kernel volume"
 901         depends on SPL_OS_BOOT && SPL_UBI
 902         help
 903           The UBI volume id from which to load the kernel
 904
 905 config SPL_UBI_LOAD_ARGS_ID
 906         int "id of kernel args volume"
 907         depends on SPL_OS_BOOT && SPL_UBI
 908         help
 909           The UBI volume id from which to load the device tree
 910
 911 config UBI_SPL_SILENCE_MSG
 912         bool "silence UBI SPL messages"
 913         default n
 914         help
 915           Disable messages from UBI SPL. This leaves warnings
 916           and errors enabled.
 917
 918 endif   # if SPL_UBI
 919
 920 config SPL_NET_SUPPORT
 921         bool "Support networking"
 922         help
 923           Enable support for network devices (such as Ethernet) in SPL.
 924           This permits SPL to load U-Boot over a network link rather than
 925           from an on-board peripheral. Environment support is required since
 926           the network stack uses a number of environment variables. See also
 927           SPL_ETH_SUPPORT.
 928
 929 if SPL_NET_SUPPORT
 930 config SPL_NET_VCI_STRING
 931         string "BOOTP Vendor Class Identifier string sent by SPL"
 932         help
 933           As defined by RFC 2132 the vendor class identifier field can be
 934           sent by the client to identify the vendor type and configuration
 935           of a client.  This is often used in practice to allow for the DHCP
 936           server to specify different files to load depending on if the ROM,
 937           SPL or U-Boot itself makes the request
 938 endif   # if SPL_NET_SUPPORT
 939
 940 config SPL_NO_CPU_SUPPORT
 941         bool "Drop CPU code in SPL"
 942         help
 943           This is specific to the ARM926EJ-S CPU. It disables the standard
 944           start.S start-up code, presumably so that a replacement can be
 945           used on that CPU. You should not enable it unless you know what
 946           you are doing.
 947
 948 config SPL_NOR_SUPPORT
 949         bool "Support NOR flash"
 950         help
 951           Enable support for loading U-Boot from memory-mapped NOR (Negative
 952           OR) flash in SPL. NOR flash is slow to write but fast to read, and
 953           a memory-mapped device makes it very easy to access. Loading from
 954           NOR is typically achieved with just a memcpy().
 955
 956 config SPL_XIP_SUPPORT
 957         bool "Support XIP"
 958         depends on SPL
 959         help
 960           Enable support for execute in place of U-Boot or kernel image. There
 961           is no need to copy image from flash to ram if flash supports execute
 962           in place. Its very useful in systems having enough flash but not
 963           enough ram to load the image.
 964
 965 config SPL_ONENAND_SUPPORT
 966         bool "Support OneNAND flash"
 967         help
 968           Enable support for OneNAND (Negative AND) flash in SPL. OneNAND is
 969           a type of NAND flash and therefore can be used to allow SPL to
 970           load U-Boot from supported devices. This enables the drivers in
 971           drivers/mtd/onenand as part of an SPL build.
 972
 973 config SPL_OS_BOOT
 974         bool "Activate Falcon Mode"
 975         depends on !TI_SECURE_DEVICE
 976         default n
 977         help
 978           Enable booting directly to an OS from SPL.
 979           for more info read doc/README.falcon
 980
 981 if SPL_OS_BOOT
 982 config SYS_OS_BASE
 983         hex "addr, where OS is found"
 984         depends on SPL_NOR_SUPPORT
 985         help
 986           Specify the address, where the OS image is found, which
 987           gets booted.
 988
 989 endif # SPL_OS_BOOT
 990
 991 config SPL_PAYLOAD
 992         string "SPL payload"
 993         default "tpl/u-boot-with-tpl.bin" if TPL
 994         default "u-boot.bin"
 995         help
 996           Payload for SPL boot. For backward compatibility, default to
 997           u-boot.bin, i.e. RAW image without any header. In case of
 998           TPL, tpl/u-boot-with-tpl.bin. For new boards, suggest to
 999           use u-boot.img.
1000
1001 config SPL_PCI
1002         bool "Support PCI drivers"
1003         help
1004           Enable support for PCI in SPL. For platforms that need PCI to boot,
1005           or must perform some init using PCI in SPL, this provides the
1006           necessary driver support. This enables the drivers in drivers/pci
1007           as part of an SPL build.
1008
1009 config SPL_PCH_SUPPORT
1010         bool "Support PCH drivers"
1011         help
1012           Enable support for PCH (Platform Controller Hub) devices in SPL.
1013           These are used to set up GPIOs and the SPI peripheral early in
1014           boot. This enables the drivers in drivers/pch as part of an SPL
1015           build.
1016
1017 config SPL_POST_MEM_SUPPORT
1018         bool "Support POST drivers"
1019         help
1020           Enable support for POST (Power-on Self Test) in SPL. POST is a
1021           procedure that checks that the hardware (CPU or board) appears to
1022           be functionally correctly. It is a sanity check that can be
1023           performed before booting. This enables the drivers in post/drivers
1024           as part of an SPL build.
1025
1026 config SPL_DM_RESET
1027         bool "Support reset drivers"
1028         depends on SPL
1029         help
1030           Enable support for reset control in SPL.
1031           That can be useful in SPL to handle IP reset in driver, as in U-Boot,
1032           by using the generic reset API provided by driver model.
1033           This enables the drivers in drivers/reset as part of an SPL build.
1034
1035 config SPL_POWER_SUPPORT
1036         bool "Support power drivers"
1037         help
1038           Enable support for power control in SPL. This includes support
1039           for PMICs (Power-management Integrated Circuits) and some of the
1040           features provided by PMICs. In particular, voltage regulators can
1041           be used to enable/disable power and vary its voltage. That can be
1042           useful in SPL to turn on boot peripherals and adjust CPU voltage
1043           so that the clock speed can be increased. This enables the drivers
1044           in drivers/power, drivers/power/pmic and drivers/power/regulator
1045           as part of an SPL build.
1046
1047 config SPL_POWER_DOMAIN
1048         bool "Support power domain drivers"
1049         help
1050           Enable support for power domain control in SPL. Many SoCs allow
1051           power to be applied to or removed from portions of the SoC (power
1052           domains). This may be used to save power. This API provides the
1053           means to control such power management hardware. This enables
1054           the drivers in drivers/power/domain as part of a SPL build.
1055
1056 config SPL_RAM_SUPPORT
1057         bool "Support booting from RAM"
1058         default y if MICROBLAZE || ARCH_SOCFPGA || ARCH_TEGRA || ARCH_ZYNQ
1059         help
1060           Enable booting of an image in RAM. The image can be preloaded or
1061           it can be loaded by SPL directly into RAM (e.g. using USB).
1062
1063 config SPL_RAM_DEVICE
1064         bool "Support booting from preloaded image in RAM"
1065         depends on SPL_RAM_SUPPORT
1066         default y if MICROBLAZE || ARCH_SOCFPGA || ARCH_TEGRA || ARCH_ZYNQ
1067         help
1068           Enable booting of an image already loaded in RAM. The image has to
1069           be already in memory when SPL takes over, e.g. loaded by the boot
1070           ROM.
1071
1072 config SPL_REMOTEPROC
1073         bool "Support REMOTEPROCS"
1074         help
1075           Enable support for REMOTEPROCs in SPL. This permits to load
1076           a remote processor firmware in SPL.
1077
1078 config SPL_RTC_SUPPORT
1079         bool "Support RTC drivers"
1080         help
1081           Enable RTC (Real-time Clock) support in SPL. This includes support
1082           for reading and setting the time. Some RTC devices also have some
1083           non-volatile (battery-backed) memory which is accessible if
1084           needed. This enables the drivers in drivers/rtc as part of an SPL
1085           build.
1086
1087 config SPL_SATA_SUPPORT
1088         bool "Support loading from SATA"
1089         help
1090           Enable support for SATA (Serial AT attachment) in SPL. This allows
1091           use of SATA devices such as hard drives and flash drivers for
1092           loading U-Boot. SATA is used in higher-end embedded systems and
1093           can provide higher performance than MMC , at somewhat higher
1094           expense and power consumption. This enables loading from SATA
1095           using a configured device.
1096
1097 config SPL_SATA_RAW_U_BOOT_USE_SECTOR
1098         bool "SATA raw mode: by sector"
1099         depends on SPL_SATA_SUPPORT
1100         help
1101           Use sector number for specifying U-Boot location on SATA disk in
1102           raw mode.
1103
1104 config SPL_SATA_RAW_U_BOOT_SECTOR
1105         hex "Sector on the SATA disk to load U-Boot from"
1106         depends on SPL_SATA_RAW_U_BOOT_USE_SECTOR
1107         help
1108           Sector on the SATA disk to load U-Boot from, when the SATA disk is being
1109           used in raw mode. Units: SATA disk sectors (1 sector = 512 bytes).
1110
1111 config SPL_SERIAL_SUPPORT
1112         bool "Support serial"
1113         select SPL_PRINTF
1114         select SPL_STRTO
1115         help
1116           Enable support for serial in SPL. This allows use of a serial UART
1117           for displaying messages while SPL is running. It also brings in
1118           printf() and panic() functions. This should normally be enabled
1119           unless there are space reasons not to. Even then, consider
1120           enabling SPL_USE_TINY_PRINTF which is a small printf() version.
1121
1122 config SPL_SPI_SUPPORT
1123         bool "Support SPI drivers"
1124         help
1125           Enable support for using SPI in SPL. This is used for connecting
1126           to SPI flash for loading U-Boot. See SPL_SPI_FLASH_SUPPORT for
1127           more details on that. The SPI driver provides the transport for
1128           data between the SPI flash and the CPU. This option can be used to
1129           enable SPI drivers that are needed for other purposes also, such
1130           as a SPI PMIC.
1131
1132 config SPL_SPI_FLASH_SUPPORT
1133         bool "Support SPI flash drivers"
1134         depends on SPL_SPI_SUPPORT
1135         help
1136           Enable support for using SPI flash in SPL, and loading U-Boot from
1137           SPI flash. SPI flash (Serial Peripheral Bus flash) is named after
1138           the SPI bus that is used to connect it to a system. It is a simple
1139           but fast bidirectional 4-wire bus (clock, chip select and two data
1140           lines). This enables the drivers in drivers/mtd/spi as part of an
1141           SPL build. This normally requires SPL_SPI_SUPPORT.
1142
1143 if SPL_SPI_FLASH_SUPPORT
1144
1145 config SPL_SPI_FLASH_TINY
1146         bool "Enable low footprint SPL SPI Flash support"
1147         depends on !SPI_FLASH_BAR
1148         default y if SPI_FLASH
1149         help
1150          Enable lightweight SPL SPI Flash support that supports just reading
1151          data/images from flash. No support to write/erase flash. Enable
1152          this if you have SPL size limitations and don't need full
1153          fledged SPI flash support.
1154
1155 config SPL_SPI_FLASH_SFDP_SUPPORT
1156         bool "SFDP table parsing support for SPI NOR flashes"
1157         depends on !SPI_FLASH_BAR && !SPL_SPI_FLASH_TINY
1158         help
1159          Enable support for parsing and auto discovery of parameters for
1160          SPI NOR flashes using Serial Flash Discoverable Parameters (SFDP)
1161          tables as per JESD216 standard in SPL.
1162
1163 config SPL_SPI_FLASH_MTD
1164         bool "Support for SPI flash MTD drivers in SPL"
1165         help
1166           Enable support for SPI flash MTD drivers in SPL.
1167
1168 config SPL_SPI_LOAD
1169         bool "Support loading from SPI flash"
1170         help
1171           Enable support for loading next stage, U-Boot or otherwise, from
1172           SPI NOR in U-Boot SPL.
1173
1174 endif # SPL_SPI_FLASH_SUPPORT
1175
1176 config SYS_SPI_U_BOOT_OFFS
1177         hex "address of u-boot payload in SPI flash"
1178         default 0x8000 if ARCH_SUNXI
1179         default 0x0
1180         depends on SPL_SPI_LOAD || SPL_SPI_SUNXI
1181         help
1182          Address within SPI-Flash from where the u-boot payload is fetched
1183          from.
1184
1185 config SPL_THERMAL
1186         bool "Driver support for thermal devices"
1187         help
1188           Enable support for temperature-sensing devices. Some SoCs have on-chip
1189           temperature sensors to permit warnings, speed throttling or even
1190           automatic power-off when the temperature gets too high or low. Other
1191           devices may be discrete but connected on a suitable bus.
1192
1193 config SPL_USB_HOST_SUPPORT
1194         bool "Support USB host drivers"
1195         select HAVE_BLOCK_DEVICE
1196         help
1197           Enable access to USB (Universal Serial Bus) host devices so that
1198           SPL can load U-Boot from a connected USB peripheral, such as a USB
1199           flash stick. While USB takes a little longer to start up than most
1200           buses, it is very flexible since many different types of storage
1201           device can be attached. This option enables the drivers in
1202           drivers/usb/host as part of an SPL build.
1203
1204 config SPL_USB_STORAGE
1205         bool "Support loading from USB"
1206         depends on SPL_USB_HOST_SUPPORT && !(BLK && !DM_USB)
1207         help
1208           Enable support for USB devices in SPL. This allows use of USB
1209           devices such as hard drives and flash drivers for loading U-Boot.
1210           The actual drivers are enabled separately using the normal U-Boot
1211           config options. This enables loading from USB using a configured
1212           device.
1213
1214 config SPL_USB_GADGET
1215         bool "Suppport USB Gadget drivers"
1216         help
1217           Enable USB Gadget API which allows to enable USB device functions
1218           in SPL.
1219
1220 if SPL_USB_GADGET
1221
1222 config SPL_USB_ETHER
1223         bool "Support USB Ethernet drivers"
1224         help
1225           Enable access to the USB network subsystem and associated
1226           drivers in SPL. This permits SPL to load U-Boot over a
1227           USB-connected Ethernet link (such as a USB Ethernet dongle) rather
1228           than from an onboard peripheral. Environment support is required
1229           since the network stack uses a number of environment variables.
1230           See also SPL_NET_SUPPORT and SPL_ETH_SUPPORT.
1231
1232 config SPL_DFU
1233         bool "Support DFU (Device Firmware Upgrade)"
1234         select SPL_HASH_SUPPORT
1235         select SPL_DFU_NO_RESET
1236         depends on SPL_RAM_SUPPORT
1237         help
1238           This feature enables the DFU (Device Firmware Upgrade) in SPL with
1239           RAM memory device support. The ROM code will load and execute
1240           the SPL built with dfu. The user can load binaries (u-boot/kernel) to
1241           selected device partition from host-pc using dfu-utils.
1242           This feature is useful to flash the binaries to factory or bare-metal
1243           boards using USB interface.
1244
1245 choice
1246         bool "DFU device selection"
1247         depends on SPL_DFU
1248
1249 config SPL_DFU_RAM
1250         bool "RAM device"
1251         depends on SPL_DFU && SPL_RAM_SUPPORT
1252         help
1253          select RAM/DDR memory device for loading binary images
1254          (u-boot/kernel) to the selected device partition using
1255          DFU and execute the u-boot/kernel from RAM.
1256
1257 endchoice
1258
1259 config SPL_USB_SDP_SUPPORT
1260         bool "Support SDP (Serial Download Protocol)"
1261         depends on SPL_SERIAL_SUPPORT
1262         help
1263           Enable Serial Download Protocol (SDP) device support in SPL. This
1264           allows to download images into memory and execute (jump to) them
1265           using the same protocol as implemented by the i.MX family's boot ROM.
1266
1267 config SPL_SDP_USB_DEV
1268         int "SDP USB controller index"
1269         default 0
1270         depends on SPL_USB_SDP_SUPPORT
1271         help
1272           Some boards have USB controller other than 0. Define this option
1273           so it can be used in compiled environment.
1274 endif
1275
1276 config SPL_WATCHDOG_SUPPORT
1277         bool "Support watchdog drivers"
1278         imply SPL_WDT if !HW_WATCHDOG
1279         help
1280           Enable support for watchdog drivers in SPL. A watchdog is
1281           typically a hardware peripheral which can reset the system when it
1282           detects no activity for a while (such as a software crash). This
1283           enables the drivers in drivers/watchdog as part of an SPL build.
1284
1285 config SPL_YMODEM_SUPPORT
1286         bool "Support loading using Ymodem"
1287         depends on SPL_SERIAL_SUPPORT
1288         help
1289           While loading from serial is slow it can be a useful backup when
1290           there is no other option. The Ymodem protocol provides a reliable
1291           means of transmitting U-Boot over a serial line for using in SPL,
1292           with a checksum to ensure correctness.
1293
1294 config SPL_ATF
1295         bool "Support ARM Trusted Firmware"
1296         depends on ARM64 && SPL_FIT
1297         help
1298           ATF(ARM Trusted Firmware) is a component for ARM AArch64 which
1299           is loaded by SPL (which is considered as BL2 in ATF terminology).
1300           More detail at: https://github.com/ARM-software/arm-trusted-firmware
1301
1302 config SPL_ATF_LOAD_IMAGE_V2
1303         bool "Use the new LOAD_IMAGE_V2 parameter passing"
1304         depends on SPL_ATF
1305         help
1306           Some platforms use the newer LOAD_IMAGE_V2 parameter passing.
1307
1308           If you want to load a bl31 image from the SPL and need the new
1309           method, say Y.
1310
1311 config SPL_ATF_NO_PLATFORM_PARAM
1312         bool "Pass no platform parameter"
1313         depends on SPL_ATF
1314         help
1315           While we expect to call a pointer to a valid FDT (or NULL)
1316           as the platform parameter to an ATF, some ATF versions are
1317           not U-Boot aware and have an insufficiently robust parameter
1318           validation to gracefully reject a FDT being passed.
1319
1320           If this option is enabled, the spl_atf os-type handler will
1321           always pass NULL for the platform parameter.
1322
1323           If your ATF is affected, say Y.
1324
1325 config SPL_AM33XX_ENABLE_RTC32K_OSC
1326         bool "Enable the RTC32K OSC on AM33xx based platforms"
1327         default y if AM33XX
1328         help
1329           Enable access to the AM33xx RTC and select the external 32kHz clock
1330           source.
1331
1332 config SPL_OPTEE
1333         bool "Support OP-TEE Trusted OS"
1334         depends on ARM
1335         help
1336           OP-TEE is an open source Trusted OS  which is loaded by SPL.
1337           More detail at: https://github.com/OP-TEE/optee_os
1338
1339 config SPL_OPENSBI
1340         bool "Support RISC-V OpenSBI"
1341         depends on RISCV && SPL_RISCV_MMODE && RISCV_SMODE
1342         help
1343           OpenSBI is an open-source implementation of the RISC-V Supervisor Binary
1344           Interface (SBI) specification. U-Boot supports the OpenSBI FW_DYNAMIC
1345           firmware. It is loaded and started by U-Boot SPL.
1346
1347           More details are available at https://github.com/riscv/opensbi and
1348           https://github.com/riscv/riscv-sbi-doc
1349
1350 config SPL_OPENSBI_LOAD_ADDR
1351         hex "OpenSBI load address"
1352         depends on SPL_OPENSBI
1353         help
1354           Load address of the OpenSBI binary.
1355
1356 config TPL
1357         bool
1358         depends on SUPPORT_TPL
1359         prompt "Enable TPL"
1360         help
1361           If you want to build TPL as well as the normal image and SPL, say Y.
1362
1363 if TPL
1364
1365 config TPL_SIZE_LIMIT
1366         hex "Maximum size of TPL image"
1367         depends on TPL
1368         default 0x0
1369         help
1370           Specifies the maximum length of the U-Boot TPL image.
1371           If this value is zero, it is ignored.
1372
1373 config TPL_FRAMEWORK
1374         bool "Support TPL based upon the common SPL framework"
1375         default y if SPL_FRAMEWORK
1376         help
1377           Enable the SPL framework under common/spl/ for TPL builds.
1378           This framework supports MMC, NAND and YMODEM and other methods
1379           loading of U-Boot's SPL stage. If unsure, say Y.
1380
1381 config TPL_HANDOFF
1382         bool "Pass hand-off information from TPL to SPL and U-Boot proper"
1383         depends on HANDOFF && TPL_BLOBLIST
1384         default y
1385         help
1386           This option enables TPL to write handoff information. This can be
1387           used to pass information like the size of SDRAM from TPL to U-Boot
1388           proper. The information is also available to SPL if it is useful
1389           there.
1390
1391 config TPL_BOARD_INIT
1392         bool "Call board-specific initialization in TPL"
1393         help
1394           If this option is enabled, U-Boot will call the function
1395           spl_board_init() from board_init_r(). This function should be
1396           provided by the board.
1397
1398 config TPL_BOOTCOUNT_LIMIT
1399         bool "Support bootcount in TPL"
1400         depends on TPL_ENV_SUPPORT
1401         help
1402           If this option is enabled, the TPL will support bootcount.
1403           For example, it may be useful to choose the device to boot.
1404
1405 config TPL_LDSCRIPT
1406         string "Linker script for the TPL stage"
1407         depends on TPL
1408         default "arch/arm/cpu/armv8/u-boot-spl.lds" if ARM64
1409         default "arch/\$(ARCH)/cpu/u-boot-spl.lds"
1410         help
1411           The TPL stage will usually require a different linker-script
1412           (as it runs from a different memory region) than the regular
1413           U-Boot stage.  Set this to the path of the linker-script to
1414           be used for TPL.
1415
1416           May be left empty to trigger the Makefile infrastructure to
1417           fall back to the linker-script used for the SPL stage.
1418
1419 config TPL_NEEDS_SEPARATE_TEXT_BASE
1420         bool "TPL needs a separate text-base"
1421         default n
1422         depends on TPL
1423         help
1424           Enable, if the TPL stage should not inherit its text-base
1425           from the SPL stage.  When enabled, a base address for the
1426           .text sections of the TPL stage has to be set below.
1427
1428 config TPL_NEEDS_SEPARATE_STACK
1429         bool "TPL needs a separate initial stack-pointer"
1430         default n
1431         depends on TPL
1432         help
1433           Enable, if the TPL stage should not inherit its initial
1434           stack-pointer from the settings for the SPL stage.
1435
1436 config TPL_TEXT_BASE
1437         hex "Base address for the .text section of the TPL stage"
1438         depends on TPL_NEEDS_SEPARATE_TEXT_BASE
1439         help
1440           The base address for the .text section of the TPL stage.
1441
1442 config TPL_MAX_SIZE
1443         int "Maximum size (in bytes) for the TPL stage"
1444         default 0
1445         depends on TPL
1446         help
1447           The maximum size (in bytes) of the TPL stage.
1448
1449 config TPL_STACK
1450         hex "Address of the initial stack-pointer for the TPL stage"
1451         depends on TPL_NEEDS_SEPARATE_STACK
1452         help
1453           The address of the initial stack-pointer for the TPL stage.
1454           Usually this will be the (aligned) top-of-stack.
1455
1456 config TPL_READ_ONLY
1457         bool
1458         depends on TPL_OF_PLATDATA
1459         select TPL_OF_PLATDATA_NO_BIND
1460         select TPL_OF_PLATDATA_RT
1461         help
1462           Some platforms (e.g. x86 Apollo Lake) load SPL into a read-only
1463           section of memory. This means that of-platdata must make a copy (in
1464           writeable memory) of anything it wants to modify, such as
1465           device-private data.
1466
1467 config TPL_BOOTROM_SUPPORT
1468         bool "Support returning to the BOOTROM (from TPL)"
1469         help
1470           Some platforms (e.g. the Rockchip RK3368) provide support in their
1471           ROM for loading the next boot-stage after performing basic setup
1472           from the TPL stage.
1473
1474           Enable this option, to return to the BOOTROM through the
1475           BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
1476           boot device list, if not implemented for a given board)
1477
1478 config TPL_DRIVERS_MISC_SUPPORT
1479         bool "Support misc drivers in TPL"
1480         help
1481           Enable miscellaneous drivers in TPL. These drivers perform various
1482           tasks that don't fall nicely into other categories, Enable this
1483           option to build the drivers in drivers/misc as part of an TPL
1484           build, for those that support building in TPL (not all drivers do).
1485
1486 config TPL_ENV_SUPPORT
1487         bool "Support an environment"
1488         help
1489           Enable environment support in TPL. See SPL_ENV_SUPPORT for details.
1490
1491 config TPL_GPIO_SUPPORT
1492         bool "Support GPIO in TPL"
1493         help
1494           Enable support for GPIOs (General-purpose Input/Output) in TPL.
1495           GPIOs allow U-Boot to read the state of an input line (high or
1496           low) and set the state of an output line. This can be used to
1497           drive LEDs, control power to various system parts and read user
1498           input. GPIOs can be useful in TPL to enable a 'sign-of-life' LED,
1499           for example. Enable this option to build the drivers in
1500           drivers/gpio as part of an TPL build.
1501
1502 config TPL_I2C_SUPPORT
1503         bool "Support I2C"
1504         help
1505           Enable support for the I2C bus in TPL. See SPL_I2C_SUPPORT for
1506           details.
1507
1508 config TPL_LIBCOMMON_SUPPORT
1509         bool "Support common libraries"
1510         help
1511           Enable support for common U-Boot libraries within TPL. See
1512           SPL_LIBCOMMON_SUPPORT for details.
1513
1514 config TPL_LIBGENERIC_SUPPORT
1515         bool "Support generic libraries"
1516         help
1517           Enable support for generic U-Boot libraries within TPL. See
1518           SPL_LIBGENERIC_SUPPORT for details.
1519
1520 config TPL_MPC8XXX_INIT_DDR_SUPPORT
1521         bool "Support MPC8XXX DDR init"
1522         help
1523           Enable support for DDR-SDRAM on the MPC8XXX family within TPL. See
1524           SPL_MPC8XXX_INIT_DDR_SUPPORT for details.
1525
1526 config TPL_MMC_SUPPORT
1527         bool "Support MMC"
1528         depends on MMC
1529         help
1530           Enable support for MMC within TPL. See SPL_MMC_SUPPORT for details.
1531
1532 config TPL_NAND_SUPPORT
1533         bool "Support NAND flash"
1534         help
1535           Enable support for NAND in TPL. See SPL_NAND_SUPPORT for details.
1536
1537 config TPL_PCI
1538         bool "Support PCI drivers"
1539         help
1540           Enable support for PCI in TPL. For platforms that need PCI to boot,
1541           or must perform some init using PCI in SPL, this provides the
1542           necessary driver support. This enables the drivers in drivers/pci
1543           as part of a TPL build.
1544
1545 config TPL_PCH_SUPPORT
1546         bool "Support PCH drivers"
1547         help
1548           Enable support for PCH (Platform Controller Hub) devices in TPL.
1549           These are used to set up GPIOs and the SPI peripheral early in
1550           boot. This enables the drivers in drivers/pch as part of a TPL
1551           build.
1552
1553 config TPL_RAM_SUPPORT
1554         bool "Support booting from RAM"
1555         help
1556           Enable booting of an image in RAM. The image can be preloaded or
1557           it can be loaded by TPL directly into RAM (e.g. using USB).
1558
1559 config TPL_RAM_DEVICE
1560         bool "Support booting from preloaded image in RAM"
1561         depends on TPL_RAM_SUPPORT
1562         help
1563           Enable booting of an image already loaded in RAM. The image has to
1564           be already in memory when TPL takes over, e.g. loaded by the boot
1565           ROM.
1566
1567 config TPL_RTC_SUPPORT
1568         bool "Support RTC drivers"
1569         help
1570           Enable RTC (Real-time Clock) support in TPL. This includes support
1571           for reading and setting the time. Some RTC devices also have some
1572           non-volatile (battery-backed) memory which is accessible if
1573           needed. This enables the drivers in drivers/rtc as part of an TPL
1574           build.
1575
1576 config TPL_SERIAL_SUPPORT
1577         bool "Support serial"
1578         select TPL_PRINTF
1579         select TPL_STRTO
1580         help
1581           Enable support for serial in TPL. See SPL_SERIAL_SUPPORT for
1582           details.
1583
1584 config TPL_SPI_FLASH_SUPPORT
1585         bool "Support SPI flash drivers"
1586         help
1587           Enable support for using SPI flash in TPL. See SPL_SPI_FLASH_SUPPORT
1588           for details.
1589
1590 config TPL_SPI_FLASH_TINY
1591         bool "Enable low footprint TPL SPI Flash support"
1592         depends on TPL_SPI_FLASH_SUPPORT && !SPI_FLASH_BAR
1593         default y if SPI_FLASH
1594         help
1595          Enable lightweight TPL SPI Flash support that supports just reading
1596          data/images from flash. No support to write/erase flash. Enable
1597          this if you have TPL size limitations and don't need full-fledged
1598          SPI flash support.
1599
1600 config TPL_SPI_LOAD
1601         bool "Support loading from SPI flash"
1602         depends on TPL_SPI_FLASH_SUPPORT
1603         help
1604           Enable support for loading next stage, U-Boot or otherwise, from
1605           SPI NOR in U-Boot TPL.
1606
1607 config TPL_SPI_SUPPORT
1608         bool "Support SPI drivers"
1609         help
1610           Enable support for using SPI in TPL. See SPL_SPI_SUPPORT for
1611           details.
1612
1613 config TPL_DM_SPI
1614         bool "Support SPI DM drivers in TPL"
1615         help
1616           Enable support for SPI DM drivers in TPL.
1617
1618 config TPL_DM_SPI_FLASH
1619         bool "Support SPI DM FLASH drivers in TPL"
1620         help
1621           Enable support for SPI DM flash drivers in TPL.
1622
1623 config TPL_YMODEM_SUPPORT
1624         bool "Support loading using Ymodem"
1625         depends on TPL_SERIAL_SUPPORT
1626         help
1627           While loading from serial is slow it can be a useful backup when
1628           there is no other option. The Ymodem protocol provides a reliable
1629           means of transmitting U-Boot over a serial line for using in TPL,
1630           with a checksum to ensure correctness.
1631
1632 endif # TPL
1633
1634 config SPL_AT91_MCK_BYPASS
1635         bool "Use external clock signal as a source of main clock for AT91 platforms"
1636         depends on ARCH_AT91
1637         default n
1638         help
1639           Use external 8 to 24 Mhz clock signal as source of main clock instead
1640           of an external crystal oscillator.
1641           This option disables the internal driving on the XOUT pin.
1642           The external source has to provide a stable clock on the XIN pin.
1643           If this option is disabled, the SoC expects a crystal oscillator
1644           that needs driving on both XIN and XOUT lines.
1645
1646 endif # SPL
1647 endmenu