menu "TPL configuration options" depends on TPL config TPL_SIZE_LIMIT hex "Maximum size of TPL image" default 0x0 help Specifies the maximum length of the U-Boot TPL image. If this value is zero, it is ignored. config TPL_BINMAN_SYMBOLS bool "Support binman symbols in TPL" depends on TPL_FRAMEWORK && BINMAN default y help This enables use of symbols in TPL which refer to other entries in the same binman image as the TPL. These can be declared with the binman_sym_declare(type, entry, prop) macro and accessed by the binman_sym(type, entry, prop) macro defined in binman_sym.h. See tools/binman/binman.rst for a detailed explanation. config TPL_BINMAN_UBOOT_SYMBOLS bool "Declare binman symbols for U-Boot phases in TPL" depends on TPL_BINMAN_SYMBOLS default n if ARCH_IMX8M || ARCH_IMX9 default y help This enables use of symbols in TPL which refer to U-Boot phases, enabling TPL to obtain the location and size of its next phase simply by calling spl_get_image_pos() and spl_get_image_size(). For this to work, you must have all U-Boot phases in the same binman image, so binman can update TPL with the locations of everything. config TPL_FRAMEWORK bool "Support TPL based upon the common SPL framework" default y if SPL_FRAMEWORK help Enable the SPL framework under common/spl/ for TPL builds. This framework supports MMC, NAND and YMODEM and other methods loading of U-Boot's SPL stage. If unsure, say Y. config TPL_BANNER_PRINT bool "Enable output of the TPL banner 'U-Boot TPL ...'" depends on DEBUG_UART && TPL_SERIAL default y help If this option is enabled, TPL will print the banner with version info. Disabling this option could be useful to reduce TPL boot time (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud). config TPL_HANDOFF bool "Pass hand-off information from TPL to SPL and U-Boot proper" depends on HANDOFF && TPL_BLOBLIST default y help This option enables TPL to write handoff information. This can be used to pass information like the size of SDRAM from TPL to U-Boot proper. The information is also available to SPL if it is useful there. config TPL_BOARD_INIT bool "Call board-specific initialization in TPL" help If this option is enabled, U-Boot will call the function spl_board_init() from board_init_r(). This function should be provided by the board. config TPL_BOOTCOUNT_LIMIT bool "Support bootcount in TPL" depends on TPL_ENV_SUPPORT help If this option is enabled, the TPL will support bootcount. For example, it may be useful to choose the device to boot. config TPL_SYS_MALLOC_SIMPLE bool prompt "Only use malloc_simple functions in the TPL" help Say Y here to only use the *_simple malloc functions from malloc_simple.c, rather then using the versions from dlmalloc.c; this will make the TPL binary smaller at the cost of more heap usage as the *_simple malloc functions do not re-use free-ed mem. config TPL_SEPARATE_BSS bool "BSS section is in a different memory region from text" default y if SPL_SEPARATE_BSS help Some platforms need a large BSS region in TPL and can provide this because RAM is already set up. In this case BSS can be moved to RAM. This option should then be enabled so that the correct device tree location is used. Normally we put the device tree at the end of BSS but with this option enabled, it goes at _image_binary_end. config TPL_LDSCRIPT string "Linker script for the TPL stage" default "arch/arm/cpu/armv8/u-boot-spl.lds" if ARM64 default "arch/\$(ARCH)/cpu/u-boot-spl.lds" help The TPL stage will usually require a different linker-script (as it runs from a different memory region) than the regular U-Boot stage. Set this to the path of the linker-script to be used for TPL. May be left empty to trigger the Makefile infrastructure to fall back to the linker-script used for the SPL stage. config TPL_NEEDS_SEPARATE_STACK bool "TPL needs a separate initial stack-pointer" help Enable, if the TPL stage should not inherit its initial stack-pointer from the settings for the SPL stage. config TPL_POWER bool "Support power drivers" help Enable support for power control in TPL. This includes support for PMICs (Power-management Integrated Circuits) and some of the features provided by PMICs. In particular, voltage regulators can be used to enable/disable power and vary its voltage. That can be useful in TPL to turn on boot peripherals and adjust CPU voltage so that the clock speed can be increased. This enables the drivers in drivers/power, drivers/power/pmic and drivers/power/regulator as part of an TPL build. config TPL_TEXT_BASE hex "Base address for the .text section of the TPL stage" default 0x0 help The base address for the .text section of the TPL stage. config TPL_MAX_SIZE hex "Maximum size (in bytes) for the TPL stage" default 0x2e000 if ROCKCHIP_RK3399 default 0x8000 if ROCKCHIP_RK3288 || ROCKCHIP_RV1126 default 0x7000 if ROCKCHIP_RK322X || ROCKCHIP_RK3328 || ROCKCHIP_RK3368 default 0x2800 if ROCKCHIP_PX30 default 0x0 help The maximum size (in bytes) of the TPL stage. config TPL_STACK hex "Address of the initial stack-pointer for the TPL stage" depends on TPL_NEEDS_SEPARATE_STACK help The address of the initial stack-pointer for the TPL stage. Usually this will be the (aligned) top-of-stack. config TPL_READ_ONLY bool depends on TPL_OF_PLATDATA select TPL_OF_PLATDATA_NO_BIND select TPL_OF_PLATDATA_RT help Some platforms (e.g. x86 Apollo Lake) load SPL into a read-only section of memory. This means that of-platdata must make a copy (in writeable memory) of anything it wants to modify, such as device-private data. config TPL_BOOTROM_SUPPORT bool "Support returning to the BOOTROM (from TPL)" help Some platforms (e.g. the Rockchip RK3368) provide support in their ROM for loading the next boot-stage after performing basic setup from the TPL stage. Enable this option, to return to the BOOTROM through the BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the boot device list, if not implemented for a given board) config TPL_CRC32 bool "Support CRC32 in TPL" default y if TPL_ENV_SUPPORT || TPL_BLOBLIST help Enable this to support CRC32 in uImages or FIT images within SPL. This is a 32-bit checksum value that can be used to verify images. For FIT images, this is the least secure type of checksum, suitable for detected accidental image corruption. For secure applications you should consider SHA1 or SHA256. config TPL_DRIVERS_MISC bool "Support misc drivers in TPL" help Enable miscellaneous drivers in TPL. These drivers perform various tasks that don't fall nicely into other categories, Enable this option to build the drivers in drivers/misc as part of an TPL build, for those that support building in TPL (not all drivers do). config TPL_ENV_SUPPORT bool "Support an environment" help Enable environment support in TPL. See SPL_ENV_SUPPORT for details. config TPL_GPIO bool "Support GPIO in TPL" help Enable support for GPIOs (General-purpose Input/Output) in TPL. GPIOs allow U-Boot to read the state of an input line (high or low) and set the state of an output line. This can be used to drive LEDs, control power to various system parts and read user input. GPIOs can be useful in TPL to enable a 'sign-of-life' LED, for example. Enable this option to build the drivers in drivers/gpio as part of an TPL build. config TPL_I2C bool "Support I2C" help Enable support for the I2C bus in TPL. See SPL_I2C for details. config TPL_LIBCOMMON_SUPPORT bool "Support common libraries" help Enable support for common U-Boot libraries within TPL. See SPL_LIBCOMMON_SUPPORT for details. config TPL_LIBGENERIC_SUPPORT bool "Support generic libraries" help Enable support for generic U-Boot libraries within TPL. See SPL_LIBGENERIC_SUPPORT for details. config TPL_MPC8XXX_INIT_DDR bool "Support MPC8XXX DDR init" help Enable support for DDR-SDRAM on the MPC8XXX family within TPL. See SPL_MPC8XXX_INIT_DDR for details. config TPL_MMC bool "Support MMC" depends on MMC help Enable support for MMC within TPL. See SPL_MMC for details. config TPL_NAND_SUPPORT bool "Support NAND flash" help Enable support for NAND in TPL. See SPL_NAND_SUPPORT for details. config TPL_PCI bool "Support PCI drivers" help Enable support for PCI in TPL. For platforms that need PCI to boot, or must perform some init using PCI in SPL, this provides the necessary driver support. This enables the drivers in drivers/pci as part of a TPL build. config TPL_PCH bool "Support PCH drivers" help Enable support for PCH (Platform Controller Hub) devices in TPL. These are used to set up GPIOs and the SPI peripheral early in boot. This enables the drivers in drivers/pch as part of a TPL build. config TPL_RAM_SUPPORT bool "Support booting from RAM" help Enable booting of an image in RAM. The image can be preloaded or it can be loaded by TPL directly into RAM (e.g. using USB). config TPL_RAM_DEVICE bool "Support booting from preloaded image in RAM" depends on TPL_RAM_SUPPORT help Enable booting of an image already loaded in RAM. The image has to be already in memory when TPL takes over, e.g. loaded by the boot ROM. config TPL_RTC bool "Support RTC drivers" help Enable RTC (Real-time Clock) support in TPL. This includes support for reading and setting the time. Some RTC devices also have some non-volatile (battery-backed) memory which is accessible if needed. This enables the drivers in drivers/rtc as part of an TPL build. config TPL_SERIAL bool "Support serial" select TPL_PRINTF select TPL_STRTO help Enable support for serial in TPL. See SPL_SERIAL for details. config TPL_SPI_FLASH_SUPPORT bool "Support SPI flash drivers" help Enable support for using SPI flash in TPL. See SPL_SPI_FLASH_SUPPORT for details. config TPL_SPI_FLASH_TINY bool "Enable low footprint TPL SPI Flash support" depends on TPL_SPI_FLASH_SUPPORT && !SPI_FLASH_BAR default y if SPI_FLASH help Enable lightweight TPL SPI Flash support that supports just reading data/images from flash. No support to write/erase flash. Enable this if you have TPL size limitations and don't need full-fledged SPI flash support. config TPL_SPI_LOAD bool "Support loading from SPI flash" depends on TPL_SPI_FLASH_SUPPORT help Enable support for loading next stage, U-Boot or otherwise, from SPI NOR in U-Boot TPL. config TPL_SPI bool "Support SPI drivers" help Enable support for using SPI in TPL. See SPL_SPI for details. config TPL_DM_SPI bool "Support SPI DM drivers in TPL" help Enable support for SPI DM drivers in TPL. config TPL_DM_SPI_FLASH bool "Support SPI DM FLASH drivers in TPL" help Enable support for SPI DM flash drivers in TPL. config TPL_YMODEM_SUPPORT bool "Support loading using Ymodem" depends on TPL_SERIAL help While loading from serial is slow it can be a useful backup when there is no other option. The Ymodem protocol provides a reliable means of transmitting U-Boot over a serial line for using in TPL, with a checksum to ensure correctness. endmenu