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 43388027419SLokesh Vutlaconfig SPL_DM_MAILBOX 43488027419SLokesh Vutla bool "Support Mailbox" 43588027419SLokesh Vutla help 43688027419SLokesh Vutla Enable support for Mailbox within SPL. This enable the inter 43788027419SLokesh Vutla processor communication protocols tobe used within SPL. Enable 43888027419SLokesh Vutla this option to build the drivers in drivers/mailbox as part of 43988027419SLokesh Vutla SPL build. 44088027419SLokesh 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. 490*a430fa06SMiquel Raynal This enables the drivers in drivers/mtd/nand/raw 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 64508c45314SLokesh Vutlaconfig SPL_REMOTEPROC 64608c45314SLokesh Vutla bool "Support REMOTEPROCS" 64708c45314SLokesh Vutla help 64808c45314SLokesh Vutla Enable support for REMOTEPROCs in SPL. This permits to load 64908c45314SLokesh Vutla a remote processor firmware in SPL. 65008c45314SLokesh Vutla 65130bf8a0dSSimon Glassconfig SPL_RTC_SUPPORT 65230bf8a0dSSimon Glass bool "Support RTC drivers" 65330bf8a0dSSimon Glass help 65430bf8a0dSSimon Glass Enable RTC (Real-time Clock) support in SPL. This includes support 65530bf8a0dSSimon Glass for reading and setting the time. Some RTC devices also have some 65630bf8a0dSSimon Glass non-volatile (battery-backed) memory which is accessible if 65730bf8a0dSSimon Glass needed. This enables the drivers in drivers/rtc as part of an SPL 65830bf8a0dSSimon Glass build. 65930bf8a0dSSimon Glass 66011bde1cdSSimon Glassconfig SPL_SATA_SUPPORT 66111bde1cdSSimon Glass bool "Support loading from SATA" 66211bde1cdSSimon Glass help 66311bde1cdSSimon Glass Enable support for SATA (Serial AT attachment) in SPL. This allows 66411bde1cdSSimon Glass use of SATA devices such as hard drives and flash drivers for 66511bde1cdSSimon Glass loading U-Boot. SATA is used in higher-end embedded systems and 66611bde1cdSSimon Glass can provide higher performance than MMC , at somewhat higher 66711bde1cdSSimon Glass expense and power consumption. This enables loading from SATA 66811bde1cdSSimon Glass using a configured device. 66911bde1cdSSimon Glass 67011bde1cdSSimon Glassconfig SPL_SERIAL_SUPPORT 67111bde1cdSSimon Glass bool "Support serial" 67214ad44abSAlex Kiernan select SPL_PRINTF 67314ad44abSAlex Kiernan select SPL_STRTO 67411bde1cdSSimon Glass help 67511bde1cdSSimon Glass Enable support for serial in SPL. This allows use of a serial UART 67611bde1cdSSimon Glass for displaying messages while SPL is running. It also brings in 67711bde1cdSSimon Glass printf() and panic() functions. This should normally be enabled 67811bde1cdSSimon Glass unless there are space reasons not to. Even then, consider 67911bde1cdSSimon Glass enabling USE_TINY_PRINTF which is a small printf() version. 68011bde1cdSSimon Glass 68111bde1cdSSimon Glassconfig SPL_SPI_FLASH_SUPPORT 68211bde1cdSSimon Glass bool "Support SPI flash drivers" 68311bde1cdSSimon Glass help 68411bde1cdSSimon Glass Enable support for using SPI flash in SPL, and loading U-Boot from 68511bde1cdSSimon Glass SPI flash. SPI flash (Serial Peripheral Bus flash) is named after 68611bde1cdSSimon Glass the SPI bus that is used to connect it to a system. It is a simple 68711bde1cdSSimon Glass but fast bidirectional 4-wire bus (clock, chip select and two data 68811bde1cdSSimon Glass lines). This enables the drivers in drivers/mtd/spi as part of an 68911bde1cdSSimon Glass SPL build. This normally requires SPL_SPI_SUPPORT. 69011bde1cdSSimon Glass 69155500438SMarek Vasutconfig SPL_SPI_LOAD 69255500438SMarek Vasut bool "Support loading from SPI flash" 69355500438SMarek Vasut depends on SPL_SPI_FLASH_SUPPORT 69455500438SMarek Vasut help 69555500438SMarek Vasut Enable support for loading next stage, U-Boot or otherwise, from 69655500438SMarek Vasut SPI NOR in U-Boot SPL. 69755500438SMarek Vasut 69811bde1cdSSimon Glassconfig SPL_SPI_SUPPORT 69911bde1cdSSimon Glass bool "Support SPI drivers" 70011bde1cdSSimon Glass help 70111bde1cdSSimon Glass Enable support for using SPI in SPL. This is used for connecting 70211bde1cdSSimon Glass to SPI flash for loading U-Boot. See SPL_SPI_FLASH_SUPPORT for 70311bde1cdSSimon Glass more details on that. The SPI driver provides the transport for 70411bde1cdSSimon Glass data between the SPI flash and the CPU. This option can be used to 70511bde1cdSSimon Glass enable SPI drivers that are needed for other purposes also, such 70611bde1cdSSimon Glass as a SPI PMIC. 70711bde1cdSSimon Glass 7088502f9f6SFaiz Abbasconfig SPL_THERMAL 7098502f9f6SFaiz Abbas bool "Driver support for thermal devices" 7108502f9f6SFaiz Abbas help 7118502f9f6SFaiz Abbas Enable support for temperature-sensing devices. Some SoCs have on-chip 7128502f9f6SFaiz Abbas temperature sensors to permit warnings, speed throttling or even 7138502f9f6SFaiz Abbas automatic power-off when the temperature gets too high or low. Other 7148502f9f6SFaiz Abbas devices may be discrete but connected on a suitable bus. 7158502f9f6SFaiz Abbas 71611bde1cdSSimon Glassconfig SPL_USB_HOST_SUPPORT 71711bde1cdSSimon Glass bool "Support USB host drivers" 71811bde1cdSSimon Glass help 71911bde1cdSSimon Glass Enable access to USB (Universal Serial Bus) host devices so that 72011bde1cdSSimon Glass SPL can load U-Boot from a connected USB peripheral, such as a USB 72111bde1cdSSimon Glass flash stick. While USB takes a little longer to start up than most 72211bde1cdSSimon Glass buses, it is very flexible since many different types of storage 72311bde1cdSSimon Glass device can be attached. This option enables the drivers in 72411bde1cdSSimon Glass drivers/usb/host as part of an SPL build. 72511bde1cdSSimon Glass 72611bde1cdSSimon Glassconfig SPL_USB_SUPPORT 72711bde1cdSSimon Glass bool "Support loading from USB" 72811bde1cdSSimon Glass depends on SPL_USB_HOST_SUPPORT 72911bde1cdSSimon Glass help 73011bde1cdSSimon Glass Enable support for USB devices in SPL. This allows use of USB 73111bde1cdSSimon Glass devices such as hard drives and flash drivers for loading U-Boot. 73211bde1cdSSimon Glass The actual drivers are enabled separately using the normal U-Boot 73311bde1cdSSimon Glass config options. This enables loading from USB using a configured 73411bde1cdSSimon Glass device. 73511bde1cdSSimon Glass 736e94793c8SStefan Agnerconfig SPL_USB_GADGET_SUPPORT 737e94793c8SStefan Agner bool "Suppport USB Gadget drivers" 738e94793c8SStefan Agner help 739e94793c8SStefan Agner Enable USB Gadget API which allows to enable USB device functions 740e94793c8SStefan Agner in SPL. 741e94793c8SStefan Agner 742e94793c8SStefan Agnerif SPL_USB_GADGET_SUPPORT 743e94793c8SStefan Agner 744b432b1ebSFaiz Abbasconfig SPL_USB_ETHER 745e94793c8SStefan Agner bool "Support USB Ethernet drivers" 746e94793c8SStefan Agner help 747e94793c8SStefan Agner Enable access to the USB network subsystem and associated 748e94793c8SStefan Agner drivers in SPL. This permits SPL to load U-Boot over a 749e94793c8SStefan Agner USB-connected Ethernet link (such as a USB Ethernet dongle) rather 750e94793c8SStefan Agner than from an onboard peripheral. Environment support is required 751e94793c8SStefan Agner since the network stack uses a number of environment variables. 752e94793c8SStefan Agner See also SPL_NET_SUPPORT and SPL_ETH_SUPPORT. 753e94793c8SStefan Agner 7545991703eSStefan Agnerconfig SPL_DFU_SUPPORT 755c3c19c27SFabio Estevam bool "Support DFU (Device Firmware Upgrade)" 7565991703eSStefan Agner select SPL_HASH_SUPPORT 75766928afbSB, Ravi select SPL_DFU_NO_RESET 7581b19cbdbSB, Ravi depends on SPL_RAM_SUPPORT 7595991703eSStefan Agner help 760c3c19c27SFabio Estevam This feature enables the DFU (Device Firmware Upgrade) in SPL with 7615991703eSStefan Agner RAM memory device support. The ROM code will load and execute 7625991703eSStefan Agner the SPL built with dfu. The user can load binaries (u-boot/kernel) to 7635991703eSStefan Agner selected device partition from host-pc using dfu-utils. 7645991703eSStefan Agner This feature is useful to flash the binaries to factory or bare-metal 7655991703eSStefan Agner boards using USB interface. 7665991703eSStefan Agner 7675991703eSStefan Agnerchoice 7685991703eSStefan Agner bool "DFU device selection" 7695991703eSStefan Agner depends on SPL_DFU_SUPPORT 7705991703eSStefan Agner 7715991703eSStefan Agnerconfig SPL_DFU_RAM 7725991703eSStefan Agner bool "RAM device" 77322802f4eSStefan Agner depends on SPL_DFU_SUPPORT && SPL_RAM_SUPPORT 7745991703eSStefan Agner help 7755991703eSStefan Agner select RAM/DDR memory device for loading binary images 7765991703eSStefan Agner (u-boot/kernel) to the selected device partition using 7775991703eSStefan Agner DFU and execute the u-boot/kernel from RAM. 7785991703eSStefan Agner 7795991703eSStefan Agnerendchoice 7805991703eSStefan Agner 781a3774c1cSStefan Agnerconfig SPL_USB_SDP_SUPPORT 782a3774c1cSStefan Agner bool "Support SDP (Serial Download Protocol)" 783a3774c1cSStefan Agner help 784a3774c1cSStefan Agner Enable Serial Download Protocol (SDP) device support in SPL. This 785a3774c1cSStefan Agner allows to download images into memory and execute (jump to) them 786a3774c1cSStefan Agner using the same protocol as implemented by the i.MX family's boot ROM. 787e94793c8SStefan Agnerendif 788e94793c8SStefan Agner 78911bde1cdSSimon Glassconfig SPL_WATCHDOG_SUPPORT 79011bde1cdSSimon Glass bool "Support watchdog drivers" 79111bde1cdSSimon Glass help 79211bde1cdSSimon Glass Enable support for watchdog drivers in SPL. A watchdog is 79311bde1cdSSimon Glass typically a hardware peripheral which can reset the system when it 79411bde1cdSSimon Glass detects no activity for a while (such as a software crash). This 79511bde1cdSSimon Glass enables the drivers in drivers/watchdog as part of an SPL build. 79611bde1cdSSimon Glass 79711bde1cdSSimon Glassconfig SPL_YMODEM_SUPPORT 79811bde1cdSSimon Glass bool "Support loading using Ymodem" 7993bac19ceSAlex Kiernan depends on SPL_SERIAL_SUPPORT 80011bde1cdSSimon Glass help 80111bde1cdSSimon Glass While loading from serial is slow it can be a useful backup when 80211bde1cdSSimon Glass there is no other option. The Ymodem protocol provides a reliable 80311bde1cdSSimon Glass means of transmitting U-Boot over a serial line for using in SPL, 80411bde1cdSSimon Glass with a checksum to ensure correctness. 80511bde1cdSSimon Glass 806aa122f6bSPhilipp Tomsichconfig SPL_ATF 807bcc1726aSKever Yang bool "Support ARM Trusted Firmware" 808226498b8STom Rini depends on ARM64 809bcc1726aSKever Yang help 810d21fb63dSPhilipp Tomsich ATF(ARM Trusted Firmware) is a component for ARM AArch64 which 811bcc1726aSKever Yang is loaded by SPL (which is considered as BL2 in ATF terminology). 812bcc1726aSKever Yang More detail at: https://github.com/ARM-software/arm-trusted-firmware 813bcc1726aSKever Yang 814d21fb63dSPhilipp Tomsichconfig SPL_ATF_NO_PLATFORM_PARAM 815d21fb63dSPhilipp Tomsich bool "Pass no platform parameter" 816d21fb63dSPhilipp Tomsich depends on SPL_ATF 817d21fb63dSPhilipp Tomsich help 818d21fb63dSPhilipp Tomsich While we expect to call a pointer to a valid FDT (or NULL) 819d21fb63dSPhilipp Tomsich as the platform parameter to an ATF, some ATF versions are 820d21fb63dSPhilipp Tomsich not U-Boot aware and have an insufficiently robust parameter 821d21fb63dSPhilipp Tomsich validation to gracefully reject a FDT being passed. 822d21fb63dSPhilipp Tomsich 823d21fb63dSPhilipp Tomsich If this option is enabled, the spl_atf os-type handler will 824d21fb63dSPhilipp Tomsich always pass NULL for the platform parameter. 825d21fb63dSPhilipp Tomsich 826d21fb63dSPhilipp Tomsich If your ATF is affected, say Y. 827d21fb63dSPhilipp Tomsich 8283bf5f13cSAlex Kiernanconfig SPL_AM33XX_ENABLE_RTC32K_OSC 8293bf5f13cSAlex Kiernan bool "Enable the RTC32K OSC on AM33xx based platforms" 8303bf5f13cSAlex Kiernan default y if AM33XX 8313bf5f13cSAlex Kiernan help 8323bf5f13cSAlex Kiernan Enable access to the AM33xx RTC and select the external 32kHz clock 8333bf5f13cSAlex Kiernan source. 8343bf5f13cSAlex Kiernan 835226498b8STom Riniconfig TPL 836226498b8STom Rini bool 837226498b8STom Rini depends on SUPPORT_TPL 838226498b8STom Rini prompt "Enable TPL" 839226498b8STom Rini help 840226498b8STom Rini If you want to build TPL as well as the normal image and SPL, say Y. 841226498b8STom Rini 842226498b8STom Riniif TPL 843226498b8STom Rini 844af2f4426SKever Yangconfig TPL_BOARD_INIT 845af2f4426SKever Yang bool "Call board-specific initialization in TPL" 846af2f4426SKever Yang help 847af2f4426SKever Yang If this option is enabled, U-Boot will call the function 848af2f4426SKever Yang spl_board_init() from board_init_r(). This function should be 849af2f4426SKever Yang provided by the board. 850af2f4426SKever Yang 851dd6fbcb9SPhilipp Tomsichconfig TPL_LDSCRIPT 852dd6fbcb9SPhilipp Tomsich string "Linker script for the TPL stage" 853dd6fbcb9SPhilipp Tomsich depends on TPL 854dd6fbcb9SPhilipp Tomsich help 855dd6fbcb9SPhilipp Tomsich The TPL stage will usually require a different linker-script 856dd6fbcb9SPhilipp Tomsich (as it runs from a different memory region) than the regular 857dd6fbcb9SPhilipp Tomsich U-Boot stage. Set this to the path of the linker-script to 858dd6fbcb9SPhilipp Tomsich be used for TPL. 859dd6fbcb9SPhilipp Tomsich 860b3ed6ce7SPhilipp Tomsich May be left empty to trigger the Makefile infrastructure to 861b3ed6ce7SPhilipp Tomsich fall back to the linker-script used for the SPL stage. 862b3ed6ce7SPhilipp Tomsich 863b3ed6ce7SPhilipp Tomsichconfig TPL_NEEDS_SEPARATE_TEXT_BASE 864b3ed6ce7SPhilipp Tomsich bool "TPL needs a separate text-base" 865b3ed6ce7SPhilipp Tomsich default n 866b3ed6ce7SPhilipp Tomsich depends on TPL 867b3ed6ce7SPhilipp Tomsich help 868b3ed6ce7SPhilipp Tomsich Enable, if the TPL stage should not inherit its text-base 869b3ed6ce7SPhilipp Tomsich from the SPL stage. When enabled, a base address for the 870b3ed6ce7SPhilipp Tomsich .text sections of the TPL stage has to be set below. 871b3ed6ce7SPhilipp Tomsich 872b3ed6ce7SPhilipp Tomsichconfig TPL_NEEDS_SEPARATE_STACK 873b3ed6ce7SPhilipp Tomsich bool "TPL needs a separate initial stack-pointer" 874b3ed6ce7SPhilipp Tomsich default n 875b3ed6ce7SPhilipp Tomsich depends on TPL 876b3ed6ce7SPhilipp Tomsich help 877b3ed6ce7SPhilipp Tomsich Enable, if the TPL stage should not inherit its initial 878b3ed6ce7SPhilipp Tomsich stack-pointer from the settings for the SPL stage. 879b3ed6ce7SPhilipp Tomsich 880b3ed6ce7SPhilipp Tomsichconfig TPL_TEXT_BASE 881b3ed6ce7SPhilipp Tomsich hex "Base address for the .text section of the TPL stage" 882b3ed6ce7SPhilipp Tomsich depends on TPL_NEEDS_SEPARATE_TEXT_BASE 883b3ed6ce7SPhilipp Tomsich help 884b3ed6ce7SPhilipp Tomsich The base address for the .text section of the TPL stage. 885b3ed6ce7SPhilipp Tomsich 886b3ed6ce7SPhilipp Tomsichconfig TPL_MAX_SIZE 887b3ed6ce7SPhilipp Tomsich int "Maximum size (in bytes) for the TPL stage" 8885aa49af3SPhilipp Tomsich default 0 889b3ed6ce7SPhilipp Tomsich depends on TPL 890b3ed6ce7SPhilipp Tomsich help 891b3ed6ce7SPhilipp Tomsich The maximum size (in bytes) of the TPL stage. 892b3ed6ce7SPhilipp Tomsich 893b3ed6ce7SPhilipp Tomsichconfig TPL_STACK 894b3ed6ce7SPhilipp Tomsich hex "Address of the initial stack-pointer for the TPL stage" 895b3ed6ce7SPhilipp Tomsich depends on TPL_NEEDS_SEPARATE_STACK 896b3ed6ce7SPhilipp Tomsich help 897b3ed6ce7SPhilipp Tomsich The address of the initial stack-pointer for the TPL stage. 898b3ed6ce7SPhilipp Tomsich Usually this will be the (aligned) top-of-stack. 899b3ed6ce7SPhilipp Tomsich 900a954fa32SPhilipp Tomsichconfig TPL_BOOTROM_SUPPORT 901a954fa32SPhilipp Tomsich bool "Support returning to the BOOTROM (from TPL)" 902a954fa32SPhilipp Tomsich help 903a954fa32SPhilipp Tomsich Some platforms (e.g. the Rockchip RK3368) provide support in their 904a954fa32SPhilipp Tomsich ROM for loading the next boot-stage after performing basic setup 905a954fa32SPhilipp Tomsich from the TPL stage. 906a954fa32SPhilipp Tomsich 907a954fa32SPhilipp Tomsich Enable this option, to return to the BOOTROM through the 908a954fa32SPhilipp Tomsich BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the 909a954fa32SPhilipp Tomsich boot device list, if not implemented for a given board) 910a954fa32SPhilipp Tomsich 911c3916e7bSPhilipp Tomsichconfig TPL_DRIVERS_MISC_SUPPORT 912c3916e7bSPhilipp Tomsich bool "Support misc drivers in TPL" 913c3916e7bSPhilipp Tomsich help 914c3916e7bSPhilipp Tomsich Enable miscellaneous drivers in TPL. These drivers perform various 915c3916e7bSPhilipp Tomsich tasks that don't fall nicely into other categories, Enable this 916c3916e7bSPhilipp Tomsich option to build the drivers in drivers/misc as part of an TPL 917c3916e7bSPhilipp Tomsich build, for those that support building in TPL (not all drivers do). 918c3916e7bSPhilipp Tomsich 919f73329eeSSimon Glassconfig TPL_ENV_SUPPORT 920f73329eeSSimon Glass bool "Support an environment" 921f73329eeSSimon Glass help 922f73329eeSSimon Glass Enable environment support in TPL. See SPL_ENV_SUPPORT for details. 923f73329eeSSimon Glass 924f73329eeSSimon Glassconfig TPL_I2C_SUPPORT 925f73329eeSSimon Glass bool "Support I2C" 926f73329eeSSimon Glass help 927616bd09eSPhilipp Tomsich Enable support for the I2C bus in TPL. See SPL_I2C_SUPPORT for 928f73329eeSSimon Glass details. 929f73329eeSSimon Glass 930f73329eeSSimon Glassconfig TPL_LIBCOMMON_SUPPORT 931f73329eeSSimon Glass bool "Support common libraries" 932f73329eeSSimon Glass help 933f73329eeSSimon Glass Enable support for common U-Boot libraries within TPL. See 934f73329eeSSimon Glass SPL_LIBCOMMON_SUPPORT for details. 935f73329eeSSimon Glass 936f73329eeSSimon Glassconfig TPL_LIBGENERIC_SUPPORT 937f73329eeSSimon Glass bool "Support generic libraries" 938f73329eeSSimon Glass help 939f73329eeSSimon Glass Enable support for generic U-Boot libraries within TPL. See 940f73329eeSSimon Glass SPL_LIBGENERIC_SUPPORT for details. 941f73329eeSSimon Glass 942f73329eeSSimon Glassconfig TPL_MPC8XXX_INIT_DDR_SUPPORT 943f73329eeSSimon Glass bool "Support MPC8XXX DDR init" 944f73329eeSSimon Glass help 945f73329eeSSimon Glass Enable support for DDR-SDRAM on the MPC8XXX family within TPL. See 946f73329eeSSimon Glass SPL_MPC8XXX_INIT_DDR_SUPPORT for details. 947f73329eeSSimon Glass 948f73329eeSSimon Glassconfig TPL_MMC_SUPPORT 949f73329eeSSimon Glass bool "Support MMC" 950226498b8STom Rini depends on MMC 951f73329eeSSimon Glass help 952f73329eeSSimon Glass Enable support for MMC within TPL. See SPL_MMC_SUPPORT for details. 953f73329eeSSimon Glass 954f73329eeSSimon Glassconfig TPL_NAND_SUPPORT 955f73329eeSSimon Glass bool "Support NAND flash" 956f73329eeSSimon Glass help 957616bd09eSPhilipp Tomsich Enable support for NAND in TPL. See SPL_NAND_SUPPORT for details. 958f73329eeSSimon Glass 959d79dfd45SMarek Vasutconfig TPL_RAM_SUPPORT 960d79dfd45SMarek Vasut bool "Support booting from RAM" 961d79dfd45SMarek Vasut help 962d79dfd45SMarek Vasut Enable booting of an image in RAM. The image can be preloaded or 963d79dfd45SMarek Vasut it can be loaded by TPL directly into RAM (e.g. using USB). 964d79dfd45SMarek Vasut 965d79dfd45SMarek Vasutconfig TPL_RAM_DEVICE 966d79dfd45SMarek Vasut bool "Support booting from preloaded image in RAM" 967d79dfd45SMarek Vasut depends on TPL_RAM_SUPPORT 968d79dfd45SMarek Vasut help 969d79dfd45SMarek Vasut Enable booting of an image already loaded in RAM. The image has to 970d79dfd45SMarek Vasut be already in memory when TPL takes over, e.g. loaded by the boot 971d79dfd45SMarek Vasut ROM. 972d79dfd45SMarek Vasut 973f73329eeSSimon Glassconfig TPL_SERIAL_SUPPORT 974f73329eeSSimon Glass bool "Support serial" 97514ad44abSAlex Kiernan select TPL_PRINTF 97614ad44abSAlex Kiernan select TPL_STRTO 977f73329eeSSimon Glass help 978616bd09eSPhilipp Tomsich Enable support for serial in TPL. See SPL_SERIAL_SUPPORT for 979f73329eeSSimon Glass details. 980f73329eeSSimon Glass 981f73329eeSSimon Glassconfig TPL_SPI_FLASH_SUPPORT 982f73329eeSSimon Glass bool "Support SPI flash drivers" 983f73329eeSSimon Glass help 984616bd09eSPhilipp Tomsich Enable support for using SPI flash in TPL. See SPL_SPI_FLASH_SUPPORT 985f73329eeSSimon Glass for details. 986f73329eeSSimon Glass 9871e725e27SMarek Vasutconfig TPL_SPI_LOAD 9881e725e27SMarek Vasut bool "Support loading from SPI flash" 9891e725e27SMarek Vasut depends on TPL_SPI_FLASH_SUPPORT 9901e725e27SMarek Vasut help 9911e725e27SMarek Vasut Enable support for loading next stage, U-Boot or otherwise, from 9921e725e27SMarek Vasut SPI NOR in U-Boot TPL. 9931e725e27SMarek Vasut 994f73329eeSSimon Glassconfig TPL_SPI_SUPPORT 995f73329eeSSimon Glass bool "Support SPI drivers" 996f73329eeSSimon Glass help 997616bd09eSPhilipp Tomsich Enable support for using SPI in TPL. See SPL_SPI_SUPPORT for 998f73329eeSSimon Glass details. 999f73329eeSSimon Glass 10006ce3d67cSMarek Vasutconfig TPL_YMODEM_SUPPORT 10016ce3d67cSMarek Vasut bool "Support loading using Ymodem" 10023bac19ceSAlex Kiernan depends on TPL_SERIAL_SUPPORT 10036ce3d67cSMarek Vasut help 10046ce3d67cSMarek Vasut While loading from serial is slow it can be a useful backup when 10056ce3d67cSMarek Vasut there is no other option. The Ymodem protocol provides a reliable 10066ce3d67cSMarek Vasut means of transmitting U-Boot over a serial line for using in TPL, 10076ce3d67cSMarek Vasut with a checksum to ensure correctness. 10086ce3d67cSMarek Vasut 1009226498b8STom Riniendif # TPL 1010226498b8STom Rini 1011226498b8STom Riniendif # SPL 101211bde1cdSSimon Glassendmenu 1013