111bde1cdSSimon Glassmenu "SPL / TPL" 211bde1cdSSimon Glass 3c2ae7d82SSimon Glassconfig SUPPORT_SPL 4c2ae7d82SSimon Glass bool 5c2ae7d82SSimon Glass 6c2ae7d82SSimon Glassconfig SUPPORT_TPL 7c2ae7d82SSimon Glass bool 8c2ae7d82SSimon Glass 966928afbSB, Raviconfig SPL_DFU_NO_RESET 1066928afbSB, Ravi bool 1166928afbSB, Ravi 12c2ae7d82SSimon Glassconfig SPL 13c2ae7d82SSimon Glass bool 14c2ae7d82SSimon Glass depends on SUPPORT_SPL 15c2ae7d82SSimon Glass prompt "Enable SPL" 16c2ae7d82SSimon Glass help 17c2ae7d82SSimon Glass If you want to build SPL as well as the normal image, say Y. 18c2ae7d82SSimon Glass 1975670c81STom Riniconfig SPL_FRAMEWORK 2075670c81STom Rini bool "Support SPL based upon the common SPL framework" 2175670c81STom Rini depends on SPL 2275670c81STom Rini default y 2375670c81STom Rini help 2475670c81STom Rini Enable the SPL framework under common/spl/. This framework 2575670c81STom Rini supports MMC, NAND and YMODEM and other methods loading of U-Boot 2675670c81STom Rini and the Linux Kernel. If unsure, say Y. 2775670c81STom Rini 28226498b8STom Riniif SPL 29226498b8STom Rini 30dd6fbcb9SPhilipp Tomsichconfig SPL_LDSCRIPT 31dd6fbcb9SPhilipp Tomsich string "Linker script for the SPL stage" 32dd6fbcb9SPhilipp Tomsich default "arch/$(ARCH)/cpu/u-boot-spl.lds" 33dd6fbcb9SPhilipp Tomsich help 34dd6fbcb9SPhilipp Tomsich The SPL stage will usually require a different linker-script 35dd6fbcb9SPhilipp Tomsich (as it runs from a different memory region) than the regular 36dd6fbcb9SPhilipp Tomsich U-Boot stage. Set this to the path of the linker-script to 37dd6fbcb9SPhilipp Tomsich be used for SPL. 38dd6fbcb9SPhilipp Tomsich 390680f1b1SLey Foon Tanconfig SPL_BOARD_INIT 400680f1b1SLey Foon Tan bool "Call board-specific initialization in SPL" 410680f1b1SLey Foon Tan help 420680f1b1SLey Foon Tan If this option is enabled, U-Boot will call the function 430680f1b1SLey Foon Tan spl_board_init() from board_init_r(). This function should be 440680f1b1SLey Foon Tan provided by the board. 450680f1b1SLey Foon Tan 46225d30b7SPhilipp Tomsichconfig SPL_BOOTROM_SUPPORT 47225d30b7SPhilipp Tomsich bool "Support returning to the BOOTROM" 48225d30b7SPhilipp Tomsich help 49225d30b7SPhilipp Tomsich Some platforms (e.g. the Rockchip RK3368) provide support in their 50225d30b7SPhilipp Tomsich ROM for loading the next boot-stage after performing basic setup 51225d30b7SPhilipp Tomsich from the SPL stage. 52225d30b7SPhilipp Tomsich 53225d30b7SPhilipp Tomsich Enable this option, to return to the BOOTROM through the 54225d30b7SPhilipp Tomsich BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the 55225d30b7SPhilipp Tomsich boot device list, if not implemented for a given board) 56225d30b7SPhilipp Tomsich 57afa9609eSLukasz Majewskiconfig SPL_BOOTCOUNT_LIMIT 58afa9609eSLukasz Majewski bool "Support bootcount in SPL" 59afa9609eSLukasz Majewski depends on SPL_ENV_SUPPORT 60afa9609eSLukasz Majewski help 61afa9609eSLukasz Majewski On some boards, which use 'falcon' mode, it is necessary to check 62afa9609eSLukasz Majewski and increment the number of boot attempts. Such boards do not 63afa9609eSLukasz Majewski use proper U-Boot for normal boot flow and hence needs those 64afa9609eSLukasz Majewski adjustments to be done in the SPL. 65afa9609eSLukasz Majewski 6624eb39b5SAndrew F. Davisconfig SPL_RAW_IMAGE_SUPPORT 6724eb39b5SAndrew F. Davis bool "Support SPL loading and booting of RAW images" 6824eb39b5SAndrew F. Davis default n if (ARCH_MX6 && (SPL_MMC_SUPPORT || SPL_SATA_SUPPORT)) 69ae9b57b5SAndrew F. Davis default y if !TI_SECURE_DEVICE 7024eb39b5SAndrew F. Davis help 7124eb39b5SAndrew F. Davis SPL will support loading and booting a RAW image when this option 7224eb39b5SAndrew F. Davis is y. If this is not set, SPL will move on to other available 7324eb39b5SAndrew F. Davis boot media to find a suitable image. 7424eb39b5SAndrew F. Davis 75722a6b17SAndrew F. Davisconfig SPL_LEGACY_IMAGE_SUPPORT 76722a6b17SAndrew F. Davis bool "Support SPL loading and booting of Legacy images" 77ae9b57b5SAndrew F. Davis default y if !TI_SECURE_DEVICE 78722a6b17SAndrew F. Davis help 79722a6b17SAndrew F. Davis SPL will support loading and booting Legacy images when this option 80722a6b17SAndrew F. Davis is y. If this is not set, SPL will move on to other available 81722a6b17SAndrew F. Davis boot media to find a suitable image. 82722a6b17SAndrew F. Davis 83c2ae7d82SSimon Glassconfig SPL_SYS_MALLOC_SIMPLE 84c2ae7d82SSimon Glass bool 85c2ae7d82SSimon Glass prompt "Only use malloc_simple functions in the SPL" 86c2ae7d82SSimon Glass help 87c2ae7d82SSimon Glass Say Y here to only use the *_simple malloc functions from 88c2ae7d82SSimon Glass malloc_simple.c, rather then using the versions from dlmalloc.c; 89c2ae7d82SSimon Glass this will make the SPL binary smaller at the cost of more heap 90c2ae7d82SSimon Glass usage as the *_simple malloc functions do not re-use free-ed mem. 91c2ae7d82SSimon Glass 92d60b5f74SPhilipp Tomsichconfig TPL_SYS_MALLOC_SIMPLE 93d60b5f74SPhilipp Tomsich bool 94d60b5f74SPhilipp Tomsich prompt "Only use malloc_simple functions in the TPL" 95d60b5f74SPhilipp Tomsich help 96d60b5f74SPhilipp Tomsich Say Y here to only use the *_simple malloc functions from 97d60b5f74SPhilipp Tomsich malloc_simple.c, rather then using the versions from dlmalloc.c; 98d60b5f74SPhilipp Tomsich this will make the TPL binary smaller at the cost of more heap 99d60b5f74SPhilipp Tomsich usage as the *_simple malloc functions do not re-use free-ed mem. 100d60b5f74SPhilipp Tomsich 101c2ae7d82SSimon Glassconfig SPL_STACK_R 102c2ae7d82SSimon Glass bool "Enable SDRAM location for SPL stack" 103c2ae7d82SSimon Glass help 104c2ae7d82SSimon Glass SPL starts off execution in SRAM and thus typically has only a small 105c2ae7d82SSimon Glass stack available. Since SPL sets up DRAM while in its board_init_f() 106c2ae7d82SSimon Glass function, it is possible for the stack to move there before 107c2ae7d82SSimon Glass board_init_r() is reached. This option enables a special SDRAM 108c2ae7d82SSimon Glass location for the SPL stack. U-Boot SPL switches to this after 109c2ae7d82SSimon Glass board_init_f() completes, and before board_init_r() starts. 110c2ae7d82SSimon Glass 111c2ae7d82SSimon Glassconfig SPL_STACK_R_ADDR 112c2ae7d82SSimon Glass depends on SPL_STACK_R 113c2ae7d82SSimon Glass hex "SDRAM location for SPL stack" 114ff6c3125STom Rini default 0x82000000 if ARCH_OMAP2PLUS 115c2ae7d82SSimon Glass help 116c2ae7d82SSimon Glass Specify the address in SDRAM for the SPL stack. This will be set up 117c2ae7d82SSimon Glass before board_init_r() is called. 118c2ae7d82SSimon Glass 119c2ae7d82SSimon Glassconfig SPL_STACK_R_MALLOC_SIMPLE_LEN 120c2ae7d82SSimon Glass depends on SPL_STACK_R && SPL_SYS_MALLOC_SIMPLE 121c2ae7d82SSimon Glass hex "Size of malloc_simple heap after switching to DRAM SPL stack" 122c2ae7d82SSimon Glass default 0x100000 123c2ae7d82SSimon Glass help 124c2ae7d82SSimon Glass Specify the amount of the stack to use as memory pool for 125c2ae7d82SSimon Glass malloc_simple after switching the stack to DRAM. This may be set 126c2ae7d82SSimon Glass to give board_init_r() a larger heap then the initial heap in 127c2ae7d82SSimon Glass SRAM which is limited to SYS_MALLOC_F_LEN bytes. 128c2ae7d82SSimon Glass 129c2ae7d82SSimon Glassconfig SPL_SEPARATE_BSS 130c2ae7d82SSimon Glass bool "BSS section is in a different memory region from text" 131c2ae7d82SSimon Glass help 132c2ae7d82SSimon Glass Some platforms need a large BSS region in SPL and can provide this 133c2ae7d82SSimon Glass because RAM is already set up. In this case BSS can be moved to RAM. 134c2ae7d82SSimon Glass This option should then be enabled so that the correct device tree 135c2ae7d82SSimon Glass location is used. Normally we put the device tree at the end of BSS 136c2ae7d82SSimon Glass but with this option enabled, it goes at _image_binary_end. 137c2ae7d82SSimon Glass 1380292bc0dSAnatolij Gustschinconfig SPL_DISABLE_BANNER_PRINT 1390292bc0dSAnatolij Gustschin bool "Disable output of the SPL banner 'U-Boot SPL ...'" 1400292bc0dSAnatolij Gustschin help 1410292bc0dSAnatolij Gustschin If this option is enabled, SPL will not print the banner with version 1420292bc0dSAnatolij Gustschin info. Selecting this option could be useful to reduce SPL boot time 1430292bc0dSAnatolij Gustschin (e.g. approx. 6 ms slower, when output on i.MX6 with 115200 baud). 1440292bc0dSAnatolij Gustschin 145a807ab33SSimon Glassconfig SPL_DISPLAY_PRINT 146a807ab33SSimon Glass bool "Display a board-specific message in SPL" 147a807ab33SSimon Glass help 148a807ab33SSimon Glass If this option is enabled, U-Boot will call the function 149a807ab33SSimon Glass spl_display_print() immediately after displaying the SPL console 150a807ab33SSimon Glass banner ("U-Boot SPL ..."). This function should be provided by 151a807ab33SSimon Glass the board. 152a807ab33SSimon Glass 15338fed8abSSemen Protsenkoconfig SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR 15438fed8abSSemen Protsenko bool "MMC raw mode: by sector" 1551da1938dSFabio Estevam default y if ARCH_SUNXI || ARCH_DAVINCI || ARCH_UNIPHIER || \ 1561da1938dSFabio Estevam ARCH_MX6 || ARCH_MX7 || \ 15738fed8abSSemen Protsenko ARCH_ROCKCHIP || ARCH_MVEBU || ARCH_SOCFPGA || \ 15838fed8abSSemen Protsenko ARCH_AT91 || ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || \ 15938fed8abSSemen Protsenko OMAP44XX || OMAP54XX || AM33XX || AM43XX 16038fed8abSSemen Protsenko help 16138fed8abSSemen Protsenko Use sector number for specifying U-Boot location on MMC/SD in 16238fed8abSSemen Protsenko raw mode. 16338fed8abSSemen Protsenko 16438fed8abSSemen Protsenkoconfig SYS_MMCSD_RAW_MODE_U_BOOT_SECTOR 16538fed8abSSemen Protsenko hex "Address on the MMC to load U-Boot from" 166226498b8STom Rini depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR 16738fed8abSSemen Protsenko default 0x50 if ARCH_SUNXI 16838fed8abSSemen Protsenko default 0x75 if ARCH_DAVINCI 1691da1938dSFabio Estevam default 0x8a if ARCH_MX6 || ARCH_MX7 1708f4d62b4SKever Yang default 0x100 if ARCH_UNIPHIER 17138fed8abSSemen Protsenko default 0x140 if ARCH_MVEBU 17238fed8abSSemen Protsenko default 0x200 if ARCH_SOCFPGA || ARCH_AT91 17338fed8abSSemen Protsenko default 0x300 if ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || OMAP44XX || \ 174586bde93SLokesh Vutla OMAP54XX || AM33XX || AM43XX || ARCH_K3 1758f4d62b4SKever Yang default 0x4000 if ARCH_ROCKCHIP 17638fed8abSSemen Protsenko help 17738fed8abSSemen Protsenko Address on the MMC to load U-Boot from, when the MMC is being used 17838fed8abSSemen Protsenko in raw mode. Units: MMC sectors (1 sector = 512 bytes). 17938fed8abSSemen Protsenko 180949123e3SDalon Westergreenconfig SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION 181949123e3SDalon Westergreen bool "MMC Raw mode: by partition" 182949123e3SDalon Westergreen help 183949123e3SDalon Westergreen Use a partition for loading U-Boot when using MMC/SD in raw mode. 184949123e3SDalon Westergreen 185949123e3SDalon Westergreenconfig SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION 186949123e3SDalon Westergreen hex "Partition to use to load U-Boot from" 187226498b8STom Rini depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION 188949123e3SDalon Westergreen default 1 189949123e3SDalon Westergreen help 190949123e3SDalon Westergreen Partition on the MMC to load U-Boot from when the MMC is being 191949123e3SDalon Westergreen used in raw mode 192949123e3SDalon Westergreen 193f0fb4fa7SDalon Westergreenconfig SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE 194f0fb4fa7SDalon Westergreen bool "MMC raw mode: by partition type" 195226498b8STom Rini depends on DOS_PARTITION && SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION 196f0fb4fa7SDalon Westergreen help 197f0fb4fa7SDalon Westergreen Use partition type for specifying U-Boot partition on MMC/SD in 198f0fb4fa7SDalon Westergreen raw mode. U-Boot will be loaded from the first partition of this 199f0fb4fa7SDalon Westergreen type to be found. 200f0fb4fa7SDalon Westergreen 201f0fb4fa7SDalon Westergreenconfig SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION_TYPE 202f0fb4fa7SDalon Westergreen hex "Partition Type on the MMC to load U-Boot from" 203226498b8STom Rini depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE 204f0fb4fa7SDalon Westergreen help 205f0fb4fa7SDalon Westergreen Partition Type on the MMC to load U-Boot from, when the MMC is being 206f0fb4fa7SDalon Westergreen used in raw mode. 207f0fb4fa7SDalon Westergreen 20811bde1cdSSimon Glassconfig SPL_CRC32_SUPPORT 20911bde1cdSSimon Glass bool "Support CRC32" 21011bde1cdSSimon Glass depends on SPL_FIT 21111bde1cdSSimon Glass help 21211bde1cdSSimon Glass Enable this to support CRC32 in FIT images within SPL. This is a 21311bde1cdSSimon Glass 32-bit checksum value that can be used to verify images. This is 21411bde1cdSSimon Glass the least secure type of checksum, suitable for detected 21511bde1cdSSimon Glass accidental image corruption. For secure applications you should 21611bde1cdSSimon Glass consider SHA1 or SHA256. 21711bde1cdSSimon Glass 21811bde1cdSSimon Glassconfig SPL_MD5_SUPPORT 21911bde1cdSSimon Glass bool "Support MD5" 22011bde1cdSSimon Glass depends on SPL_FIT 22111bde1cdSSimon Glass help 22211bde1cdSSimon Glass Enable this to support MD5 in FIT images within SPL. An MD5 22311bde1cdSSimon Glass checksum is a 128-bit hash value used to check that the image 22411bde1cdSSimon Glass contents have not been corrupted. Note that MD5 is not considered 22511bde1cdSSimon Glass secure as it is possible (with a brute-force attack) to adjust the 22611bde1cdSSimon Glass image while still retaining the same MD5 hash value. For secure 22711bde1cdSSimon Glass applications where images may be changed maliciously, you should 22811bde1cdSSimon Glass consider SHA1 or SHA256. 22911bde1cdSSimon Glass 23011bde1cdSSimon Glassconfig SPL_SHA1_SUPPORT 23111bde1cdSSimon Glass bool "Support SHA1" 23211bde1cdSSimon Glass depends on SPL_FIT 233089df18bSTom Rini select SHA1 23411bde1cdSSimon Glass help 23511bde1cdSSimon Glass Enable this to support SHA1 in FIT images within SPL. A SHA1 23611bde1cdSSimon Glass checksum is a 160-bit (20-byte) hash value used to check that the 23711bde1cdSSimon Glass image contents have not been corrupted or maliciously altered. 23811bde1cdSSimon Glass While SHA1 is fairly secure it is coming to the end of its life 23911bde1cdSSimon Glass due to the expanding computing power avaiable to brute-force 24011bde1cdSSimon Glass attacks. For more security, consider SHA256. 24111bde1cdSSimon Glass 24211bde1cdSSimon Glassconfig SPL_SHA256_SUPPORT 24311bde1cdSSimon Glass bool "Support SHA256" 24411bde1cdSSimon Glass depends on SPL_FIT 245089df18bSTom Rini select SHA256 24611bde1cdSSimon Glass help 24711bde1cdSSimon Glass Enable this to support SHA256 in FIT images within SPL. A SHA256 24811bde1cdSSimon Glass checksum is a 256-bit (32-byte) hash value used to check that the 24911bde1cdSSimon Glass image contents have not been corrupted. SHA256 is recommended for 25011bde1cdSSimon Glass use in secure applications since (as at 2016) there is no known 25111bde1cdSSimon Glass feasible attack that could produce a 'collision' with differing 25211bde1cdSSimon Glass input data. Use this for the highest security. Note that only the 25311bde1cdSSimon Glass SHA256 variant is supported: SHA512 and others are not currently 25411bde1cdSSimon Glass supported in U-Boot. 25511bde1cdSSimon Glass 256337bbb62SPhilipp Tomsichconfig SPL_FIT_IMAGE_TINY 257337bbb62SPhilipp Tomsich bool "Remove functionality from SPL FIT loading to reduce size" 258337bbb62SPhilipp Tomsich depends on SPL_FIT 2596f796a9bSIcenowy Zheng default y if MACH_SUN50I || MACH_SUN50I_H5 || MACH_SUN50I_H6 260337bbb62SPhilipp Tomsich help 261337bbb62SPhilipp Tomsich Enable this to reduce the size of the FIT image loading code 262337bbb62SPhilipp Tomsich in SPL, if space for the SPL binary is very tight. 263337bbb62SPhilipp Tomsich 264337bbb62SPhilipp Tomsich This removes the detection of image types (which forces the 265337bbb62SPhilipp Tomsich first image to be treated as having a U-Boot style calling 266337bbb62SPhilipp Tomsich convention) and skips the recording of each loaded payload 267337bbb62SPhilipp Tomsich (i.e. loadable) into the FDT (modifying the loaded FDT to 268337bbb62SPhilipp Tomsich ensure this information is available to the next image 269337bbb62SPhilipp Tomsich invoked). 270337bbb62SPhilipp Tomsich 2715e148df9SSimon Glassconfig SPL_CPU_SUPPORT 2725e148df9SSimon Glass bool "Support CPU drivers" 2735e148df9SSimon Glass help 2745e148df9SSimon Glass Enable this to support CPU drivers in SPL. These drivers can set 2755e148df9SSimon Glass up CPUs and provide information about them such as the model and 2765e148df9SSimon Glass name. This can be useful in SPL since setting up the CPUs earlier 2775e148df9SSimon Glass may improve boot performance. Enable this option to build the 2785e148df9SSimon Glass drivers in drivers/cpu as part of an SPL build. 2795e148df9SSimon Glass 28011bde1cdSSimon Glassconfig SPL_CRYPTO_SUPPORT 28111bde1cdSSimon Glass bool "Support crypto drivers" 28211bde1cdSSimon Glass help 28311bde1cdSSimon Glass Enable crypto drivers in SPL. These drivers can be used to 28411bde1cdSSimon Glass accelerate secure boot processing in secure applications. Enable 28511bde1cdSSimon Glass this option to build the drivers in drivers/crypto as part of an 28611bde1cdSSimon Glass SPL build. 28711bde1cdSSimon Glass 28811bde1cdSSimon Glassconfig SPL_HASH_SUPPORT 28911bde1cdSSimon Glass bool "Support hashing drivers" 290089df18bSTom Rini select SHA1 291089df18bSTom Rini select SHA256 29211bde1cdSSimon Glass help 29311bde1cdSSimon Glass Enable hashing drivers in SPL. These drivers can be used to 29411bde1cdSSimon Glass accelerate secure boot processing in secure applications. Enable 29511bde1cdSSimon Glass this option to build system-specific drivers for hash acceleration 29611bde1cdSSimon Glass as part of an SPL build. 29711bde1cdSSimon Glass 29811bde1cdSSimon Glassconfig SPL_DMA_SUPPORT 29911bde1cdSSimon Glass bool "Support DMA drivers" 30011bde1cdSSimon Glass help 30111bde1cdSSimon Glass Enable DMA (direct-memory-access) drivers in SPL. These drivers 30211bde1cdSSimon Glass can be used to handle memory-to-peripheral data transfer without 30311bde1cdSSimon Glass the CPU moving the data. Enable this option to build the drivers 30411bde1cdSSimon Glass in drivers/dma as part of an SPL build. 30511bde1cdSSimon Glass 30611bde1cdSSimon Glassconfig SPL_DRIVERS_MISC_SUPPORT 30711bde1cdSSimon Glass bool "Support misc drivers" 30811bde1cdSSimon Glass help 30911bde1cdSSimon Glass Enable miscellaneous drivers in SPL. These drivers perform various 31011bde1cdSSimon Glass tasks that don't fall nicely into other categories, Enable this 31111bde1cdSSimon Glass option to build the drivers in drivers/misc as part of an SPL 31211bde1cdSSimon Glass build, for those that support building in SPL (not all drivers do). 31311bde1cdSSimon Glass 31411bde1cdSSimon Glassconfig SPL_ENV_SUPPORT 31511bde1cdSSimon Glass bool "Support an environment" 31611bde1cdSSimon Glass help 31711bde1cdSSimon Glass Enable environment support in SPL. The U-Boot environment provides 31811bde1cdSSimon Glass a number of settings (essentially name/value pairs) which can 31911bde1cdSSimon Glass control many aspects of U-Boot's operation. Normally this is not 32011bde1cdSSimon Glass needed in SPL as it has a much simpler task with less 32111bde1cdSSimon Glass configuration. But some boards use this to support 'Falcon' boot 32211bde1cdSSimon Glass on EXT2 and FAT, where SPL boots directly into Linux without 32300caae6dSSimon Glass starting U-Boot first. Enabling this option will make env_get() 324382bee57SSimon Glass and env_set() available in SPL. 32511bde1cdSSimon Glass 326d2d9bdfcSB, Raviconfig SPL_SAVEENV 327d2d9bdfcSB, Ravi bool "Support save environment" 328226498b8STom Rini depends on SPL_ENV_SUPPORT 329d6400c3fSJean-Jacques Hiblot select SPL_MMC_WRITE if ENV_IS_IN_MMC 330d2d9bdfcSB, Ravi help 331d2d9bdfcSB, Ravi Enable save environment support in SPL after setenv. By default 332d2d9bdfcSB, Ravi the saveenv option is not provided in SPL, but some boards need 333d2d9bdfcSB, Ravi this support in 'Falcon' boot, where SPL need to boot from 334d2d9bdfcSB, Ravi different images based on environment variable set by OS. For 335d2d9bdfcSB, Ravi example OS may set "reboot_image" environment variable to 336d2d9bdfcSB, Ravi "recovery" inorder to boot recovery image by SPL. The SPL read 337d2d9bdfcSB, Ravi "reboot_image" and act accordingly and change the reboot_image 338919d25c9SShyam Saini to default mode using setenv and save the environment. 339d2d9bdfcSB, Ravi 34011bde1cdSSimon Glassconfig SPL_ETH_SUPPORT 34111bde1cdSSimon Glass bool "Support Ethernet" 34211bde1cdSSimon Glass depends on SPL_ENV_SUPPORT 34311bde1cdSSimon Glass help 34411bde1cdSSimon Glass Enable access to the network subsystem and associated Ethernet 34511bde1cdSSimon Glass drivers in SPL. This permits SPL to load U-Boot over an Ethernet 34611bde1cdSSimon Glass link rather than from an on-board peripheral. Environment support 34711bde1cdSSimon Glass is required since the network stack uses a number of environment 34811bde1cdSSimon Glass variables. See also SPL_NET_SUPPORT. 34911bde1cdSSimon Glass 35011bde1cdSSimon Glassconfig SPL_EXT_SUPPORT 35111bde1cdSSimon Glass bool "Support EXT filesystems" 35211bde1cdSSimon Glass help 35311bde1cdSSimon Glass Enable support for EXT2/3/4 filesystems with SPL. This permits 35411bde1cdSSimon Glass U-Boot (or Linux in Falcon mode) to be loaded from an EXT 35511bde1cdSSimon Glass filesystem from within SPL. Support for the underlying block 35611bde1cdSSimon Glass device (e.g. MMC or USB) must be enabled separately. 35711bde1cdSSimon Glass 35811bde1cdSSimon Glassconfig SPL_FAT_SUPPORT 35911bde1cdSSimon Glass bool "Support FAT filesystems" 360eedfb89eSSekhar Nori select FS_FAT 36111bde1cdSSimon Glass help 36211bde1cdSSimon Glass Enable support for FAT and VFAT filesystems with SPL. This 36311bde1cdSSimon Glass permits U-Boot (or Linux in Falcon mode) to be loaded from a FAT 36411bde1cdSSimon Glass filesystem from within SPL. Support for the underlying block 36511bde1cdSSimon Glass device (e.g. MMC or USB) must be enabled separately. 36611bde1cdSSimon Glass 36711bde1cdSSimon Glassconfig SPL_FPGA_SUPPORT 36811bde1cdSSimon Glass bool "Support FPGAs" 36911bde1cdSSimon Glass help 37011bde1cdSSimon Glass Enable support for FPGAs in SPL. Field-programmable Gate Arrays 37111bde1cdSSimon Glass provide software-configurable hardware which is typically used to 37211bde1cdSSimon Glass implement peripherals (such as UARTs, LCD displays, MMC) or 37311bde1cdSSimon Glass accelerate custom processing functions, such as image processing 37411bde1cdSSimon Glass or machine learning. Sometimes it is useful to program the FPGA 37511bde1cdSSimon Glass as early as possible during boot, and this option can enable that 37611bde1cdSSimon Glass within SPL. 37711bde1cdSSimon Glass 37811bde1cdSSimon Glassconfig SPL_GPIO_SUPPORT 37911bde1cdSSimon Glass bool "Support GPIO" 38011bde1cdSSimon Glass help 38111bde1cdSSimon Glass Enable support for GPIOs (General-purpose Input/Output) in SPL. 38211bde1cdSSimon Glass GPIOs allow U-Boot to read the state of an input line (high or 38311bde1cdSSimon Glass low) and set the state of an output line. This can be used to 38411bde1cdSSimon Glass drive LEDs, control power to various system parts and read user 38511bde1cdSSimon Glass input. GPIOs can be useful in SPL to enable a 'sign-of-life' LED, 38611bde1cdSSimon Glass for example. Enable this option to build the drivers in 38711bde1cdSSimon Glass drivers/gpio as part of an SPL build. 38811bde1cdSSimon Glass 38911bde1cdSSimon Glassconfig SPL_I2C_SUPPORT 39011bde1cdSSimon Glass bool "Support I2C" 39111bde1cdSSimon Glass help 39211bde1cdSSimon Glass Enable support for the I2C (Inter-Integrated Circuit) bus in SPL. 39311bde1cdSSimon Glass I2C works with a clock and data line which can be driven by a 39411bde1cdSSimon Glass one or more masters or slaves. It is a fairly complex bus but is 39511bde1cdSSimon Glass widely used as it only needs two lines for communication. Speeds of 39611bde1cdSSimon Glass 400kbps are typical but up to 3.4Mbps is supported by some 39711bde1cdSSimon Glass hardware. I2C can be useful in SPL to configure power management 39811bde1cdSSimon Glass ICs (PMICs) before raising the CPU clock speed, for example. 39911bde1cdSSimon Glass Enable this option to build the drivers in drivers/i2c as part of 40011bde1cdSSimon Glass an SPL build. 40111bde1cdSSimon Glass 40211bde1cdSSimon Glassconfig SPL_LIBCOMMON_SUPPORT 40311bde1cdSSimon Glass bool "Support common libraries" 40411bde1cdSSimon Glass help 40511bde1cdSSimon Glass Enable support for common U-Boot libraries within SPL. These 40611bde1cdSSimon Glass libraries include common code to deal with U-Boot images, 40711bde1cdSSimon Glass environment and USB, for example. This option is enabled on many 40811bde1cdSSimon Glass boards. Enable this option to build the code in common/ as part of 40911bde1cdSSimon Glass an SPL build. 41011bde1cdSSimon Glass 41111bde1cdSSimon Glassconfig SPL_LIBDISK_SUPPORT 41200416704SSimon Goldschmidt bool "Support disk partitions" 41311bde1cdSSimon Glass help 41411bde1cdSSimon Glass Enable support for disk partitions within SPL. 'Disk' is something 41511bde1cdSSimon Glass of a misnomer as it includes non-spinning media such as flash (as 41611bde1cdSSimon Glass used in MMC and USB sticks). Partitions provide a way for a disk 41711bde1cdSSimon Glass to be split up into separate regions, with a partition table placed 41811bde1cdSSimon Glass at the start or end which describes the location and size of each 41911bde1cdSSimon Glass 'partition'. These partitions are typically uses as individual block 42011bde1cdSSimon Glass devices, typically with an EXT2 or FAT filesystem in each. This 42111bde1cdSSimon Glass option enables whatever partition support has been enabled in 42211bde1cdSSimon Glass U-Boot to also be used in SPL. It brings in the code in disk/. 42311bde1cdSSimon Glass 42411bde1cdSSimon Glassconfig SPL_LIBGENERIC_SUPPORT 42511bde1cdSSimon Glass bool "Support generic libraries" 42611bde1cdSSimon Glass help 42711bde1cdSSimon Glass Enable support for generic U-Boot libraries within SPL. These 42811bde1cdSSimon Glass libraries include generic code to deal with device tree, hashing, 42911bde1cdSSimon Glass printf(), compression and the like. This option is enabled on many 43011bde1cdSSimon Glass boards. Enable this option to build the code in lib/ as part of an 43111bde1cdSSimon Glass SPL build. 43211bde1cdSSimon Glass 433*88027419SLokesh Vutlaconfig SPL_DM_MAILBOX 434*88027419SLokesh Vutla bool "Support Mailbox" 435*88027419SLokesh Vutla help 436*88027419SLokesh Vutla Enable support for Mailbox within SPL. This enable the inter 437*88027419SLokesh Vutla processor communication protocols tobe used within SPL. Enable 438*88027419SLokesh Vutla this option to build the drivers in drivers/mailbox as part of 439*88027419SLokesh Vutla SPL build. 440*88027419SLokesh Vutla 44111bde1cdSSimon Glassconfig SPL_MMC_SUPPORT 44211bde1cdSSimon Glass bool "Support MMC" 443226498b8STom Rini depends on MMC 44411bde1cdSSimon Glass help 44511bde1cdSSimon Glass Enable support for MMC (Multimedia Card) within SPL. This enables 44611bde1cdSSimon Glass the MMC protocol implementation and allows any enabled drivers to 44711bde1cdSSimon Glass be used within SPL. MMC can be used with or without disk partition 44811bde1cdSSimon Glass support depending on the application (SPL_LIBDISK_SUPPORT). Enable 44911bde1cdSSimon Glass this option to build the drivers in drivers/mmc as part of an SPL 45011bde1cdSSimon Glass build. 45111bde1cdSSimon Glass 452d6400c3fSJean-Jacques Hiblotconfig SPL_MMC_WRITE 453d6400c3fSJean-Jacques Hiblot bool "MMC/SD/SDIO card support for write operations in SPL" 454d6400c3fSJean-Jacques Hiblot depends on SPL_MMC_SUPPORT 455d6400c3fSJean-Jacques Hiblot default n 456d6400c3fSJean-Jacques Hiblot help 457d6400c3fSJean-Jacques Hiblot Enable write access to MMC and SD Cards in SPL 458d6400c3fSJean-Jacques Hiblot 459d6400c3fSJean-Jacques Hiblot 46011bde1cdSSimon Glassconfig SPL_MPC8XXX_INIT_DDR_SUPPORT 46111bde1cdSSimon Glass bool "Support MPC8XXX DDR init" 46211bde1cdSSimon Glass help 46311bde1cdSSimon Glass Enable support for DDR-SDRAM (double-data-rate synchronous dynamic 46411bde1cdSSimon Glass random-access memory) on the MPC8XXX family within SPL. This 46511bde1cdSSimon Glass allows DRAM to be set up before loading U-Boot into that DRAM, 46611bde1cdSSimon Glass where it can run. 46711bde1cdSSimon Glass 46811bde1cdSSimon Glassconfig SPL_MTD_SUPPORT 46911bde1cdSSimon Glass bool "Support MTD drivers" 47011bde1cdSSimon Glass help 47111bde1cdSSimon Glass Enable support for MTD (Memory Technology Device) within SPL. MTD 47211bde1cdSSimon Glass provides a block interface over raw NAND and can also be used with 47311bde1cdSSimon Glass SPI flash. This allows SPL to load U-Boot from supported MTD 47411bde1cdSSimon Glass devices. See SPL_NAND_SUPPORT and SPL_ONENAND_SUPPORT for how 47511bde1cdSSimon Glass to enable specific MTD drivers. 47611bde1cdSSimon Glass 47711bde1cdSSimon Glassconfig SPL_MUSB_NEW_SUPPORT 47811bde1cdSSimon Glass bool "Support new Mentor Graphics USB" 47911bde1cdSSimon Glass help 48011bde1cdSSimon Glass Enable support for Mentor Graphics USB in SPL. This is a new 48111bde1cdSSimon Glass driver used by some boards. Enable this option to build 48211bde1cdSSimon Glass the drivers in drivers/usb/musb-new as part of an SPL build. The 48311bde1cdSSimon Glass old drivers are in drivers/usb/musb. 48411bde1cdSSimon Glass 48511bde1cdSSimon Glassconfig SPL_NAND_SUPPORT 48611bde1cdSSimon Glass bool "Support NAND flash" 48711bde1cdSSimon Glass help 48811bde1cdSSimon Glass Enable support for NAND (Negative AND) flash in SPL. NAND flash 48911bde1cdSSimon Glass can be used to allow SPL to load U-Boot from supported devices. 49011bde1cdSSimon Glass This enables the drivers in drivers/mtd/nand as part of an SPL 49111bde1cdSSimon Glass build. 49211bde1cdSSimon Glass 49311bde1cdSSimon Glassconfig SPL_NET_SUPPORT 49411bde1cdSSimon Glass bool "Support networking" 49511bde1cdSSimon Glass help 49611bde1cdSSimon Glass Enable support for network devices (such as Ethernet) in SPL. 49711bde1cdSSimon Glass This permits SPL to load U-Boot over a network link rather than 49811bde1cdSSimon Glass from an on-board peripheral. Environment support is required since 49911bde1cdSSimon Glass the network stack uses a number of environment variables. See also 50011bde1cdSSimon Glass SPL_ETH_SUPPORT. 50111bde1cdSSimon Glass 50211bde1cdSSimon Glassif SPL_NET_SUPPORT 50311bde1cdSSimon Glassconfig SPL_NET_VCI_STRING 50411bde1cdSSimon Glass string "BOOTP Vendor Class Identifier string sent by SPL" 50511bde1cdSSimon Glass help 50611bde1cdSSimon Glass As defined by RFC 2132 the vendor class identifier field can be 50711bde1cdSSimon Glass sent by the client to identify the vendor type and configuration 50811bde1cdSSimon Glass of a client. This is often used in practice to allow for the DHCP 50911bde1cdSSimon Glass server to specify different files to load depending on if the ROM, 51011bde1cdSSimon Glass SPL or U-Boot itself makes the request 51111bde1cdSSimon Glassendif # if SPL_NET_SUPPORT 51211bde1cdSSimon Glass 51311bde1cdSSimon Glassconfig SPL_NO_CPU_SUPPORT 51411bde1cdSSimon Glass bool "Drop CPU code in SPL" 51511bde1cdSSimon Glass help 51611bde1cdSSimon Glass This is specific to the ARM926EJ-S CPU. It disables the standard 51711bde1cdSSimon Glass start.S start-up code, presumably so that a replacement can be 51811bde1cdSSimon Glass used on that CPU. You should not enable it unless you know what 51911bde1cdSSimon Glass you are doing. 52011bde1cdSSimon Glass 52111bde1cdSSimon Glassconfig SPL_NOR_SUPPORT 52211bde1cdSSimon Glass bool "Support NOR flash" 52311bde1cdSSimon Glass help 52411bde1cdSSimon Glass Enable support for loading U-Boot from memory-mapped NOR (Negative 52511bde1cdSSimon Glass OR) flash in SPL. NOR flash is slow to write but fast to read, and 52611bde1cdSSimon Glass a memory-mapped device makes it very easy to access. Loading from 52711bde1cdSSimon Glass NOR is typically achieved with just a memcpy(). 52811bde1cdSSimon Glass 529c6d9e9dbSVikas Manochaconfig SPL_XIP_SUPPORT 530c6d9e9dbSVikas Manocha bool "Support XIP" 531c6d9e9dbSVikas Manocha depends on SPL 532c6d9e9dbSVikas Manocha help 533c6d9e9dbSVikas Manocha Enable support for execute in place of U-Boot or kernel image. There 534c6d9e9dbSVikas Manocha is no need to copy image from flash to ram if flash supports execute 535c6d9e9dbSVikas Manocha in place. Its very useful in systems having enough flash but not 536c6d9e9dbSVikas Manocha enough ram to load the image. 537c6d9e9dbSVikas Manocha 53811bde1cdSSimon Glassconfig SPL_ONENAND_SUPPORT 53911bde1cdSSimon Glass bool "Support OneNAND flash" 54011bde1cdSSimon Glass help 54111bde1cdSSimon Glass Enable support for OneNAND (Negative AND) flash in SPL. OneNAND is 54211bde1cdSSimon Glass a type of NAND flash and therefore can be used to allow SPL to 54311bde1cdSSimon Glass load U-Boot from supported devices. This enables the drivers in 54411bde1cdSSimon Glass drivers/mtd/onenand as part of an SPL build. 54511bde1cdSSimon Glass 546c20ae2ffSHeiko Schocherconfig SPL_OS_BOOT 547c20ae2ffSHeiko Schocher bool "Activate Falcon Mode" 548226498b8STom Rini depends on !TI_SECURE_DEVICE 549c20ae2ffSHeiko Schocher default n 550c20ae2ffSHeiko Schocher help 551c20ae2ffSHeiko Schocher Enable booting directly to an OS from SPL. 552c20ae2ffSHeiko Schocher for more info read doc/README.falcon 553c20ae2ffSHeiko Schocher 55429d3bc79SHeiko Schocherif SPL_OS_BOOT 55529d3bc79SHeiko Schocherconfig SYS_OS_BASE 55629d3bc79SHeiko Schocher hex "addr, where OS is found" 557226498b8STom Rini depends on SPL_NOR_SUPPORT 55829d3bc79SHeiko Schocher help 55929d3bc79SHeiko Schocher Specify the address, where the OS image is found, which 56029d3bc79SHeiko Schocher gets booted. 56129d3bc79SHeiko Schocher 56229d3bc79SHeiko Schocherendif # SPL_OS_BOOT 56329d3bc79SHeiko Schocher 5647550dbe3SYork Sunconfig SPL_PAYLOAD 5657550dbe3SYork Sun string "SPL payload" 5667550dbe3SYork Sun default "tpl/u-boot-with-tpl.bin" if TPL 5677550dbe3SYork Sun default "u-boot.bin" 5687550dbe3SYork Sun help 5697550dbe3SYork Sun Payload for SPL boot. For backward compability, default to 5707550dbe3SYork Sun u-boot.bin, i.e. RAW image without any header. In case of 5717550dbe3SYork Sun TPL, tpl/u-boot-with-tpl.bin. For new boards, suggest to 5727550dbe3SYork Sun use u-boot.img. 5737550dbe3SYork Sun 5742446b6b8SSimon Glassconfig SPL_PCI_SUPPORT 5752446b6b8SSimon Glass bool "Support PCI drivers" 5762446b6b8SSimon Glass help 5772446b6b8SSimon Glass Enable support for PCI in SPL. For platforms that need PCI to boot, 5782446b6b8SSimon Glass or must perform some init using PCI in SPL, this provides the 5792446b6b8SSimon Glass necessary driver support. This enables the drivers in drivers/pci 5802446b6b8SSimon Glass as part of an SPL build. 5812446b6b8SSimon Glass 582bbe41abfSSimon Glassconfig SPL_PCH_SUPPORT 583bbe41abfSSimon Glass bool "Support PCH drivers" 584bbe41abfSSimon Glass help 585bbe41abfSSimon Glass Enable support for PCH (Platform Controller Hub) devices in SPL. 586bbe41abfSSimon Glass These are used to set up GPIOs and the SPI peripheral early in 587bbe41abfSSimon Glass boot. This enables the drivers in drivers/pch as part of an SPL 588bbe41abfSSimon Glass build. 589bbe41abfSSimon Glass 59011bde1cdSSimon Glassconfig SPL_POST_MEM_SUPPORT 59111bde1cdSSimon Glass bool "Support POST drivers" 59211bde1cdSSimon Glass help 59311bde1cdSSimon Glass Enable support for POST (Power-on Self Test) in SPL. POST is a 59411bde1cdSSimon Glass procedure that checks that the hardware (CPU or board) appears to 59511bde1cdSSimon Glass be functionally correctly. It is a sanity check that can be 59611bde1cdSSimon Glass performed before booting. This enables the drivers in post/drivers 59711bde1cdSSimon Glass as part of an SPL build. 59811bde1cdSSimon Glass 599bfc6bae8SLey Foon Tanconfig SPL_DM_RESET 6000e373c0aSPatrick Delaunay bool "Support reset drivers" 6010e373c0aSPatrick Delaunay depends on SPL 6020e373c0aSPatrick Delaunay help 6030e373c0aSPatrick Delaunay Enable support for reset control in SPL. 6040e373c0aSPatrick Delaunay That can be useful in SPL to handle IP reset in driver, as in U-Boot, 6050e373c0aSPatrick Delaunay by using the generic reset API provided by driver model. 6060e373c0aSPatrick Delaunay This enables the drivers in drivers/reset as part of an SPL build. 6070e373c0aSPatrick Delaunay 60811bde1cdSSimon Glassconfig SPL_POWER_SUPPORT 60911bde1cdSSimon Glass bool "Support power drivers" 61011bde1cdSSimon Glass help 61111bde1cdSSimon Glass Enable support for power control in SPL. This includes support 61211bde1cdSSimon Glass for PMICs (Power-management Integrated Circuits) and some of the 61311bde1cdSSimon Glass features provided by PMICs. In particular, voltage regulators can 61411bde1cdSSimon Glass be used to enable/disable power and vary its voltage. That can be 61511bde1cdSSimon Glass useful in SPL to turn on boot peripherals and adjust CPU voltage 61611bde1cdSSimon Glass so that the clock speed can be increased. This enables the drivers 61711bde1cdSSimon Glass in drivers/power, drivers/power/pmic and drivers/power/regulator 61811bde1cdSSimon Glass as part of an SPL build. 61911bde1cdSSimon Glass 620e13278c9SPeng Fanconfig SPL_POWER_DOMAIN 621e13278c9SPeng Fan bool "Support power domain drivers" 622e13278c9SPeng Fan help 623e13278c9SPeng Fan Enable support for power domain control in SPL. Many SoCs allow 624e13278c9SPeng Fan power to be applied to or removed from portions of the SoC (power 625e13278c9SPeng Fan domains). This may be used to save power. This API provides the 626e13278c9SPeng Fan means to control such power management hardware. This enables 627e13278c9SPeng Fan the drivers in drivers/power/domain as part of a SPL build. 628e13278c9SPeng Fan 62922802f4eSStefan Agnerconfig SPL_RAM_SUPPORT 63022802f4eSStefan Agner bool "Support booting from RAM" 63122802f4eSStefan Agner default y if MICROBLAZE || ARCH_SOCFPGA || TEGRA || ARCH_ZYNQ 63222802f4eSStefan Agner help 63322802f4eSStefan Agner Enable booting of an image in RAM. The image can be preloaded or 63422802f4eSStefan Agner it can be loaded by SPL directly into RAM (e.g. using USB). 63522802f4eSStefan Agner 636f417d40fSStefan Agnerconfig SPL_RAM_DEVICE 637f417d40fSStefan Agner bool "Support booting from preloaded image in RAM" 63822802f4eSStefan Agner depends on SPL_RAM_SUPPORT 639f417d40fSStefan Agner default y if MICROBLAZE || ARCH_SOCFPGA || TEGRA || ARCH_ZYNQ 640f417d40fSStefan Agner help 641f417d40fSStefan Agner Enable booting of an image already loaded in RAM. The image has to 642f417d40fSStefan Agner be already in memory when SPL takes over, e.g. loaded by the boot 643f417d40fSStefan Agner ROM. 644f417d40fSStefan Agner 64530bf8a0dSSimon Glassconfig SPL_RTC_SUPPORT 64630bf8a0dSSimon Glass bool "Support RTC drivers" 64730bf8a0dSSimon Glass help 64830bf8a0dSSimon Glass Enable RTC (Real-time Clock) support in SPL. This includes support 64930bf8a0dSSimon Glass for reading and setting the time. Some RTC devices also have some 65030bf8a0dSSimon Glass non-volatile (battery-backed) memory which is accessible if 65130bf8a0dSSimon Glass needed. This enables the drivers in drivers/rtc as part of an SPL 65230bf8a0dSSimon Glass build. 65330bf8a0dSSimon Glass 65411bde1cdSSimon Glassconfig SPL_SATA_SUPPORT 65511bde1cdSSimon Glass bool "Support loading from SATA" 65611bde1cdSSimon Glass help 65711bde1cdSSimon Glass Enable support for SATA (Serial AT attachment) in SPL. This allows 65811bde1cdSSimon Glass use of SATA devices such as hard drives and flash drivers for 65911bde1cdSSimon Glass loading U-Boot. SATA is used in higher-end embedded systems and 66011bde1cdSSimon Glass can provide higher performance than MMC , at somewhat higher 66111bde1cdSSimon Glass expense and power consumption. This enables loading from SATA 66211bde1cdSSimon Glass using a configured device. 66311bde1cdSSimon Glass 66411bde1cdSSimon Glassconfig SPL_SERIAL_SUPPORT 66511bde1cdSSimon Glass bool "Support serial" 66614ad44abSAlex Kiernan select SPL_PRINTF 66714ad44abSAlex Kiernan select SPL_STRTO 66811bde1cdSSimon Glass help 66911bde1cdSSimon Glass Enable support for serial in SPL. This allows use of a serial UART 67011bde1cdSSimon Glass for displaying messages while SPL is running. It also brings in 67111bde1cdSSimon Glass printf() and panic() functions. This should normally be enabled 67211bde1cdSSimon Glass unless there are space reasons not to. Even then, consider 67311bde1cdSSimon Glass enabling USE_TINY_PRINTF which is a small printf() version. 67411bde1cdSSimon Glass 67511bde1cdSSimon Glassconfig SPL_SPI_FLASH_SUPPORT 67611bde1cdSSimon Glass bool "Support SPI flash drivers" 67711bde1cdSSimon Glass help 67811bde1cdSSimon Glass Enable support for using SPI flash in SPL, and loading U-Boot from 67911bde1cdSSimon Glass SPI flash. SPI flash (Serial Peripheral Bus flash) is named after 68011bde1cdSSimon Glass the SPI bus that is used to connect it to a system. It is a simple 68111bde1cdSSimon Glass but fast bidirectional 4-wire bus (clock, chip select and two data 68211bde1cdSSimon Glass lines). This enables the drivers in drivers/mtd/spi as part of an 68311bde1cdSSimon Glass SPL build. This normally requires SPL_SPI_SUPPORT. 68411bde1cdSSimon Glass 68555500438SMarek Vasutconfig SPL_SPI_LOAD 68655500438SMarek Vasut bool "Support loading from SPI flash" 68755500438SMarek Vasut depends on SPL_SPI_FLASH_SUPPORT 68855500438SMarek Vasut help 68955500438SMarek Vasut Enable support for loading next stage, U-Boot or otherwise, from 69055500438SMarek Vasut SPI NOR in U-Boot SPL. 69155500438SMarek Vasut 69211bde1cdSSimon Glassconfig SPL_SPI_SUPPORT 69311bde1cdSSimon Glass bool "Support SPI drivers" 69411bde1cdSSimon Glass help 69511bde1cdSSimon Glass Enable support for using SPI in SPL. This is used for connecting 69611bde1cdSSimon Glass to SPI flash for loading U-Boot. See SPL_SPI_FLASH_SUPPORT for 69711bde1cdSSimon Glass more details on that. The SPI driver provides the transport for 69811bde1cdSSimon Glass data between the SPI flash and the CPU. This option can be used to 69911bde1cdSSimon Glass enable SPI drivers that are needed for other purposes also, such 70011bde1cdSSimon Glass as a SPI PMIC. 70111bde1cdSSimon Glass 7028502f9f6SFaiz Abbasconfig SPL_THERMAL 7038502f9f6SFaiz Abbas bool "Driver support for thermal devices" 7048502f9f6SFaiz Abbas help 7058502f9f6SFaiz Abbas Enable support for temperature-sensing devices. Some SoCs have on-chip 7068502f9f6SFaiz Abbas temperature sensors to permit warnings, speed throttling or even 7078502f9f6SFaiz Abbas automatic power-off when the temperature gets too high or low. Other 7088502f9f6SFaiz Abbas devices may be discrete but connected on a suitable bus. 7098502f9f6SFaiz Abbas 71011bde1cdSSimon Glassconfig SPL_USB_HOST_SUPPORT 71111bde1cdSSimon Glass bool "Support USB host drivers" 71211bde1cdSSimon Glass help 71311bde1cdSSimon Glass Enable access to USB (Universal Serial Bus) host devices so that 71411bde1cdSSimon Glass SPL can load U-Boot from a connected USB peripheral, such as a USB 71511bde1cdSSimon Glass flash stick. While USB takes a little longer to start up than most 71611bde1cdSSimon Glass buses, it is very flexible since many different types of storage 71711bde1cdSSimon Glass device can be attached. This option enables the drivers in 71811bde1cdSSimon Glass drivers/usb/host as part of an SPL build. 71911bde1cdSSimon Glass 72011bde1cdSSimon Glassconfig SPL_USB_SUPPORT 72111bde1cdSSimon Glass bool "Support loading from USB" 72211bde1cdSSimon Glass depends on SPL_USB_HOST_SUPPORT 72311bde1cdSSimon Glass help 72411bde1cdSSimon Glass Enable support for USB devices in SPL. This allows use of USB 72511bde1cdSSimon Glass devices such as hard drives and flash drivers for loading U-Boot. 72611bde1cdSSimon Glass The actual drivers are enabled separately using the normal U-Boot 72711bde1cdSSimon Glass config options. This enables loading from USB using a configured 72811bde1cdSSimon Glass device. 72911bde1cdSSimon Glass 730e94793c8SStefan Agnerconfig SPL_USB_GADGET_SUPPORT 731e94793c8SStefan Agner bool "Suppport USB Gadget drivers" 732e94793c8SStefan Agner help 733e94793c8SStefan Agner Enable USB Gadget API which allows to enable USB device functions 734e94793c8SStefan Agner in SPL. 735e94793c8SStefan Agner 736e94793c8SStefan Agnerif SPL_USB_GADGET_SUPPORT 737e94793c8SStefan Agner 738b432b1ebSFaiz Abbasconfig SPL_USB_ETHER 739e94793c8SStefan Agner bool "Support USB Ethernet drivers" 740e94793c8SStefan Agner help 741e94793c8SStefan Agner Enable access to the USB network subsystem and associated 742e94793c8SStefan Agner drivers in SPL. This permits SPL to load U-Boot over a 743e94793c8SStefan Agner USB-connected Ethernet link (such as a USB Ethernet dongle) rather 744e94793c8SStefan Agner than from an onboard peripheral. Environment support is required 745e94793c8SStefan Agner since the network stack uses a number of environment variables. 746e94793c8SStefan Agner See also SPL_NET_SUPPORT and SPL_ETH_SUPPORT. 747e94793c8SStefan Agner 7485991703eSStefan Agnerconfig SPL_DFU_SUPPORT 749c3c19c27SFabio Estevam bool "Support DFU (Device Firmware Upgrade)" 7505991703eSStefan Agner select SPL_HASH_SUPPORT 75166928afbSB, Ravi select SPL_DFU_NO_RESET 7521b19cbdbSB, Ravi depends on SPL_RAM_SUPPORT 7535991703eSStefan Agner help 754c3c19c27SFabio Estevam This feature enables the DFU (Device Firmware Upgrade) in SPL with 7555991703eSStefan Agner RAM memory device support. The ROM code will load and execute 7565991703eSStefan Agner the SPL built with dfu. The user can load binaries (u-boot/kernel) to 7575991703eSStefan Agner selected device partition from host-pc using dfu-utils. 7585991703eSStefan Agner This feature is useful to flash the binaries to factory or bare-metal 7595991703eSStefan Agner boards using USB interface. 7605991703eSStefan Agner 7615991703eSStefan Agnerchoice 7625991703eSStefan Agner bool "DFU device selection" 7635991703eSStefan Agner depends on SPL_DFU_SUPPORT 7645991703eSStefan Agner 7655991703eSStefan Agnerconfig SPL_DFU_RAM 7665991703eSStefan Agner bool "RAM device" 76722802f4eSStefan Agner depends on SPL_DFU_SUPPORT && SPL_RAM_SUPPORT 7685991703eSStefan Agner help 7695991703eSStefan Agner select RAM/DDR memory device for loading binary images 7705991703eSStefan Agner (u-boot/kernel) to the selected device partition using 7715991703eSStefan Agner DFU and execute the u-boot/kernel from RAM. 7725991703eSStefan Agner 7735991703eSStefan Agnerendchoice 7745991703eSStefan Agner 775a3774c1cSStefan Agnerconfig SPL_USB_SDP_SUPPORT 776a3774c1cSStefan Agner bool "Support SDP (Serial Download Protocol)" 777a3774c1cSStefan Agner help 778a3774c1cSStefan Agner Enable Serial Download Protocol (SDP) device support in SPL. This 779a3774c1cSStefan Agner allows to download images into memory and execute (jump to) them 780a3774c1cSStefan Agner using the same protocol as implemented by the i.MX family's boot ROM. 781e94793c8SStefan Agnerendif 782e94793c8SStefan Agner 78311bde1cdSSimon Glassconfig SPL_WATCHDOG_SUPPORT 78411bde1cdSSimon Glass bool "Support watchdog drivers" 78511bde1cdSSimon Glass help 78611bde1cdSSimon Glass Enable support for watchdog drivers in SPL. A watchdog is 78711bde1cdSSimon Glass typically a hardware peripheral which can reset the system when it 78811bde1cdSSimon Glass detects no activity for a while (such as a software crash). This 78911bde1cdSSimon Glass enables the drivers in drivers/watchdog as part of an SPL build. 79011bde1cdSSimon Glass 79111bde1cdSSimon Glassconfig SPL_YMODEM_SUPPORT 79211bde1cdSSimon Glass bool "Support loading using Ymodem" 7933bac19ceSAlex Kiernan depends on SPL_SERIAL_SUPPORT 79411bde1cdSSimon Glass help 79511bde1cdSSimon Glass While loading from serial is slow it can be a useful backup when 79611bde1cdSSimon Glass there is no other option. The Ymodem protocol provides a reliable 79711bde1cdSSimon Glass means of transmitting U-Boot over a serial line for using in SPL, 79811bde1cdSSimon Glass with a checksum to ensure correctness. 79911bde1cdSSimon Glass 800aa122f6bSPhilipp Tomsichconfig SPL_ATF 801bcc1726aSKever Yang bool "Support ARM Trusted Firmware" 802226498b8STom Rini depends on ARM64 803bcc1726aSKever Yang help 804d21fb63dSPhilipp Tomsich ATF(ARM Trusted Firmware) is a component for ARM AArch64 which 805bcc1726aSKever Yang is loaded by SPL (which is considered as BL2 in ATF terminology). 806bcc1726aSKever Yang More detail at: https://github.com/ARM-software/arm-trusted-firmware 807bcc1726aSKever Yang 808d21fb63dSPhilipp Tomsichconfig SPL_ATF_NO_PLATFORM_PARAM 809d21fb63dSPhilipp Tomsich bool "Pass no platform parameter" 810d21fb63dSPhilipp Tomsich depends on SPL_ATF 811d21fb63dSPhilipp Tomsich help 812d21fb63dSPhilipp Tomsich While we expect to call a pointer to a valid FDT (or NULL) 813d21fb63dSPhilipp Tomsich as the platform parameter to an ATF, some ATF versions are 814d21fb63dSPhilipp Tomsich not U-Boot aware and have an insufficiently robust parameter 815d21fb63dSPhilipp Tomsich validation to gracefully reject a FDT being passed. 816d21fb63dSPhilipp Tomsich 817d21fb63dSPhilipp Tomsich If this option is enabled, the spl_atf os-type handler will 818d21fb63dSPhilipp Tomsich always pass NULL for the platform parameter. 819d21fb63dSPhilipp Tomsich 820d21fb63dSPhilipp Tomsich If your ATF is affected, say Y. 821d21fb63dSPhilipp Tomsich 8223bf5f13cSAlex Kiernanconfig SPL_AM33XX_ENABLE_RTC32K_OSC 8233bf5f13cSAlex Kiernan bool "Enable the RTC32K OSC on AM33xx based platforms" 8243bf5f13cSAlex Kiernan default y if AM33XX 8253bf5f13cSAlex Kiernan help 8263bf5f13cSAlex Kiernan Enable access to the AM33xx RTC and select the external 32kHz clock 8273bf5f13cSAlex Kiernan source. 8283bf5f13cSAlex Kiernan 829226498b8STom Riniconfig TPL 830226498b8STom Rini bool 831226498b8STom Rini depends on SUPPORT_TPL 832226498b8STom Rini prompt "Enable TPL" 833226498b8STom Rini help 834226498b8STom Rini If you want to build TPL as well as the normal image and SPL, say Y. 835226498b8STom Rini 836226498b8STom Riniif TPL 837226498b8STom Rini 838af2f4426SKever Yangconfig TPL_BOARD_INIT 839af2f4426SKever Yang bool "Call board-specific initialization in TPL" 840af2f4426SKever Yang help 841af2f4426SKever Yang If this option is enabled, U-Boot will call the function 842af2f4426SKever Yang spl_board_init() from board_init_r(). This function should be 843af2f4426SKever Yang provided by the board. 844af2f4426SKever Yang 845dd6fbcb9SPhilipp Tomsichconfig TPL_LDSCRIPT 846dd6fbcb9SPhilipp Tomsich string "Linker script for the TPL stage" 847dd6fbcb9SPhilipp Tomsich depends on TPL 848dd6fbcb9SPhilipp Tomsich help 849dd6fbcb9SPhilipp Tomsich The TPL stage will usually require a different linker-script 850dd6fbcb9SPhilipp Tomsich (as it runs from a different memory region) than the regular 851dd6fbcb9SPhilipp Tomsich U-Boot stage. Set this to the path of the linker-script to 852dd6fbcb9SPhilipp Tomsich be used for TPL. 853dd6fbcb9SPhilipp Tomsich 854b3ed6ce7SPhilipp Tomsich May be left empty to trigger the Makefile infrastructure to 855b3ed6ce7SPhilipp Tomsich fall back to the linker-script used for the SPL stage. 856b3ed6ce7SPhilipp Tomsich 857b3ed6ce7SPhilipp Tomsichconfig TPL_NEEDS_SEPARATE_TEXT_BASE 858b3ed6ce7SPhilipp Tomsich bool "TPL needs a separate text-base" 859b3ed6ce7SPhilipp Tomsich default n 860b3ed6ce7SPhilipp Tomsich depends on TPL 861b3ed6ce7SPhilipp Tomsich help 862b3ed6ce7SPhilipp Tomsich Enable, if the TPL stage should not inherit its text-base 863b3ed6ce7SPhilipp Tomsich from the SPL stage. When enabled, a base address for the 864b3ed6ce7SPhilipp Tomsich .text sections of the TPL stage has to be set below. 865b3ed6ce7SPhilipp Tomsich 866b3ed6ce7SPhilipp Tomsichconfig TPL_NEEDS_SEPARATE_STACK 867b3ed6ce7SPhilipp Tomsich bool "TPL needs a separate initial stack-pointer" 868b3ed6ce7SPhilipp Tomsich default n 869b3ed6ce7SPhilipp Tomsich depends on TPL 870b3ed6ce7SPhilipp Tomsich help 871b3ed6ce7SPhilipp Tomsich Enable, if the TPL stage should not inherit its initial 872b3ed6ce7SPhilipp Tomsich stack-pointer from the settings for the SPL stage. 873b3ed6ce7SPhilipp Tomsich 874b3ed6ce7SPhilipp Tomsichconfig TPL_TEXT_BASE 875b3ed6ce7SPhilipp Tomsich hex "Base address for the .text section of the TPL stage" 876b3ed6ce7SPhilipp Tomsich depends on TPL_NEEDS_SEPARATE_TEXT_BASE 877b3ed6ce7SPhilipp Tomsich help 878b3ed6ce7SPhilipp Tomsich The base address for the .text section of the TPL stage. 879b3ed6ce7SPhilipp Tomsich 880b3ed6ce7SPhilipp Tomsichconfig TPL_MAX_SIZE 881b3ed6ce7SPhilipp Tomsich int "Maximum size (in bytes) for the TPL stage" 8825aa49af3SPhilipp Tomsich default 0 883b3ed6ce7SPhilipp Tomsich depends on TPL 884b3ed6ce7SPhilipp Tomsich help 885b3ed6ce7SPhilipp Tomsich The maximum size (in bytes) of the TPL stage. 886b3ed6ce7SPhilipp Tomsich 887b3ed6ce7SPhilipp Tomsichconfig TPL_STACK 888b3ed6ce7SPhilipp Tomsich hex "Address of the initial stack-pointer for the TPL stage" 889b3ed6ce7SPhilipp Tomsich depends on TPL_NEEDS_SEPARATE_STACK 890b3ed6ce7SPhilipp Tomsich help 891b3ed6ce7SPhilipp Tomsich The address of the initial stack-pointer for the TPL stage. 892b3ed6ce7SPhilipp Tomsich Usually this will be the (aligned) top-of-stack. 893b3ed6ce7SPhilipp Tomsich 894a954fa32SPhilipp Tomsichconfig TPL_BOOTROM_SUPPORT 895a954fa32SPhilipp Tomsich bool "Support returning to the BOOTROM (from TPL)" 896a954fa32SPhilipp Tomsich help 897a954fa32SPhilipp Tomsich Some platforms (e.g. the Rockchip RK3368) provide support in their 898a954fa32SPhilipp Tomsich ROM for loading the next boot-stage after performing basic setup 899a954fa32SPhilipp Tomsich from the TPL stage. 900a954fa32SPhilipp Tomsich 901a954fa32SPhilipp Tomsich Enable this option, to return to the BOOTROM through the 902a954fa32SPhilipp Tomsich BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the 903a954fa32SPhilipp Tomsich boot device list, if not implemented for a given board) 904a954fa32SPhilipp Tomsich 905c3916e7bSPhilipp Tomsichconfig TPL_DRIVERS_MISC_SUPPORT 906c3916e7bSPhilipp Tomsich bool "Support misc drivers in TPL" 907c3916e7bSPhilipp Tomsich help 908c3916e7bSPhilipp Tomsich Enable miscellaneous drivers in TPL. These drivers perform various 909c3916e7bSPhilipp Tomsich tasks that don't fall nicely into other categories, Enable this 910c3916e7bSPhilipp Tomsich option to build the drivers in drivers/misc as part of an TPL 911c3916e7bSPhilipp Tomsich build, for those that support building in TPL (not all drivers do). 912c3916e7bSPhilipp Tomsich 913f73329eeSSimon Glassconfig TPL_ENV_SUPPORT 914f73329eeSSimon Glass bool "Support an environment" 915f73329eeSSimon Glass help 916f73329eeSSimon Glass Enable environment support in TPL. See SPL_ENV_SUPPORT for details. 917f73329eeSSimon Glass 918f73329eeSSimon Glassconfig TPL_I2C_SUPPORT 919f73329eeSSimon Glass bool "Support I2C" 920f73329eeSSimon Glass help 921616bd09eSPhilipp Tomsich Enable support for the I2C bus in TPL. See SPL_I2C_SUPPORT for 922f73329eeSSimon Glass details. 923f73329eeSSimon Glass 924f73329eeSSimon Glassconfig TPL_LIBCOMMON_SUPPORT 925f73329eeSSimon Glass bool "Support common libraries" 926f73329eeSSimon Glass help 927f73329eeSSimon Glass Enable support for common U-Boot libraries within TPL. See 928f73329eeSSimon Glass SPL_LIBCOMMON_SUPPORT for details. 929f73329eeSSimon Glass 930f73329eeSSimon Glassconfig TPL_LIBGENERIC_SUPPORT 931f73329eeSSimon Glass bool "Support generic libraries" 932f73329eeSSimon Glass help 933f73329eeSSimon Glass Enable support for generic U-Boot libraries within TPL. See 934f73329eeSSimon Glass SPL_LIBGENERIC_SUPPORT for details. 935f73329eeSSimon Glass 936f73329eeSSimon Glassconfig TPL_MPC8XXX_INIT_DDR_SUPPORT 937f73329eeSSimon Glass bool "Support MPC8XXX DDR init" 938f73329eeSSimon Glass help 939f73329eeSSimon Glass Enable support for DDR-SDRAM on the MPC8XXX family within TPL. See 940f73329eeSSimon Glass SPL_MPC8XXX_INIT_DDR_SUPPORT for details. 941f73329eeSSimon Glass 942f73329eeSSimon Glassconfig TPL_MMC_SUPPORT 943f73329eeSSimon Glass bool "Support MMC" 944226498b8STom Rini depends on MMC 945f73329eeSSimon Glass help 946f73329eeSSimon Glass Enable support for MMC within TPL. See SPL_MMC_SUPPORT for details. 947f73329eeSSimon Glass 948f73329eeSSimon Glassconfig TPL_NAND_SUPPORT 949f73329eeSSimon Glass bool "Support NAND flash" 950f73329eeSSimon Glass help 951616bd09eSPhilipp Tomsich Enable support for NAND in TPL. See SPL_NAND_SUPPORT for details. 952f73329eeSSimon Glass 953d79dfd45SMarek Vasutconfig TPL_RAM_SUPPORT 954d79dfd45SMarek Vasut bool "Support booting from RAM" 955d79dfd45SMarek Vasut help 956d79dfd45SMarek Vasut Enable booting of an image in RAM. The image can be preloaded or 957d79dfd45SMarek Vasut it can be loaded by TPL directly into RAM (e.g. using USB). 958d79dfd45SMarek Vasut 959d79dfd45SMarek Vasutconfig TPL_RAM_DEVICE 960d79dfd45SMarek Vasut bool "Support booting from preloaded image in RAM" 961d79dfd45SMarek Vasut depends on TPL_RAM_SUPPORT 962d79dfd45SMarek Vasut help 963d79dfd45SMarek Vasut Enable booting of an image already loaded in RAM. The image has to 964d79dfd45SMarek Vasut be already in memory when TPL takes over, e.g. loaded by the boot 965d79dfd45SMarek Vasut ROM. 966d79dfd45SMarek Vasut 967f73329eeSSimon Glassconfig TPL_SERIAL_SUPPORT 968f73329eeSSimon Glass bool "Support serial" 96914ad44abSAlex Kiernan select TPL_PRINTF 97014ad44abSAlex Kiernan select TPL_STRTO 971f73329eeSSimon Glass help 972616bd09eSPhilipp Tomsich Enable support for serial in TPL. See SPL_SERIAL_SUPPORT for 973f73329eeSSimon Glass details. 974f73329eeSSimon Glass 975f73329eeSSimon Glassconfig TPL_SPI_FLASH_SUPPORT 976f73329eeSSimon Glass bool "Support SPI flash drivers" 977f73329eeSSimon Glass help 978616bd09eSPhilipp Tomsich Enable support for using SPI flash in TPL. See SPL_SPI_FLASH_SUPPORT 979f73329eeSSimon Glass for details. 980f73329eeSSimon Glass 9811e725e27SMarek Vasutconfig TPL_SPI_LOAD 9821e725e27SMarek Vasut bool "Support loading from SPI flash" 9831e725e27SMarek Vasut depends on TPL_SPI_FLASH_SUPPORT 9841e725e27SMarek Vasut help 9851e725e27SMarek Vasut Enable support for loading next stage, U-Boot or otherwise, from 9861e725e27SMarek Vasut SPI NOR in U-Boot TPL. 9871e725e27SMarek Vasut 988f73329eeSSimon Glassconfig TPL_SPI_SUPPORT 989f73329eeSSimon Glass bool "Support SPI drivers" 990f73329eeSSimon Glass help 991616bd09eSPhilipp Tomsich Enable support for using SPI in TPL. See SPL_SPI_SUPPORT for 992f73329eeSSimon Glass details. 993f73329eeSSimon Glass 9946ce3d67cSMarek Vasutconfig TPL_YMODEM_SUPPORT 9956ce3d67cSMarek Vasut bool "Support loading using Ymodem" 9963bac19ceSAlex Kiernan depends on TPL_SERIAL_SUPPORT 9976ce3d67cSMarek Vasut help 9986ce3d67cSMarek Vasut While loading from serial is slow it can be a useful backup when 9996ce3d67cSMarek Vasut there is no other option. The Ymodem protocol provides a reliable 10006ce3d67cSMarek Vasut means of transmitting U-Boot over a serial line for using in TPL, 10016ce3d67cSMarek Vasut with a checksum to ensure correctness. 10026ce3d67cSMarek Vasut 1003226498b8STom Riniendif # TPL 1004226498b8STom Rini 1005226498b8STom Riniendif # SPL 100611bde1cdSSimon Glassendmenu 1007