Tom Rini | ba787bb | 2022-05-30 17:01:22 -0400 | [diff] [blame] | 1 | menu "TPL configuration options" |
| 2 | depends on TPL |
| 3 | |
| 4 | config TPL_SIZE_LIMIT |
| 5 | hex "Maximum size of TPL image" |
| 6 | default 0x0 |
| 7 | help |
| 8 | Specifies the maximum length of the U-Boot TPL image. |
| 9 | If this value is zero, it is ignored. |
| 10 | |
| 11 | config TPL_BINMAN_SYMBOLS |
| 12 | bool "Declare binman symbols in TPL" |
Alper Nebi Yasak | e09a8b9 | 2022-06-18 15:13:07 +0300 | [diff] [blame^] | 13 | depends on TPL_FRAMEWORK && BINMAN |
Tom Rini | ba787bb | 2022-05-30 17:01:22 -0400 | [diff] [blame] | 14 | default y |
| 15 | help |
| 16 | This enables use of symbols in TPL which refer to U-Boot, enabling TPL |
| 17 | to obtain the location of U-Boot simply by calling spl_get_image_pos() |
| 18 | and spl_get_image_size(). |
| 19 | |
| 20 | For this to work, you must have a U-Boot image in the binman image, so |
| 21 | binman can update TPL with the location of it. |
| 22 | |
| 23 | config TPL_FRAMEWORK |
| 24 | bool "Support TPL based upon the common SPL framework" |
| 25 | default y if SPL_FRAMEWORK |
| 26 | help |
| 27 | Enable the SPL framework under common/spl/ for TPL builds. |
| 28 | This framework supports MMC, NAND and YMODEM and other methods |
| 29 | loading of U-Boot's SPL stage. If unsure, say Y. |
| 30 | |
| 31 | config TPL_BANNER_PRINT |
| 32 | bool "Enable output of the TPL banner 'U-Boot TPL ...'" |
| 33 | default y |
| 34 | help |
| 35 | If this option is enabled, TPL will print the banner with version |
| 36 | info. Disabling this option could be useful to reduce TPL boot time |
| 37 | (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud). |
| 38 | |
| 39 | config TPL_HANDOFF |
| 40 | bool "Pass hand-off information from TPL to SPL and U-Boot proper" |
| 41 | depends on HANDOFF && TPL_BLOBLIST |
| 42 | default y |
| 43 | help |
| 44 | This option enables TPL to write handoff information. This can be |
| 45 | used to pass information like the size of SDRAM from TPL to U-Boot |
| 46 | proper. The information is also available to SPL if it is useful |
| 47 | there. |
| 48 | |
| 49 | config TPL_BOARD_INIT |
| 50 | bool "Call board-specific initialization in TPL" |
| 51 | help |
| 52 | If this option is enabled, U-Boot will call the function |
| 53 | spl_board_init() from board_init_r(). This function should be |
| 54 | provided by the board. |
| 55 | |
| 56 | config TPL_BOOTCOUNT_LIMIT |
| 57 | bool "Support bootcount in TPL" |
| 58 | depends on TPL_ENV_SUPPORT |
| 59 | help |
| 60 | If this option is enabled, the TPL will support bootcount. |
| 61 | For example, it may be useful to choose the device to boot. |
| 62 | |
| 63 | config TPL_SYS_MALLOC_SIMPLE |
| 64 | bool |
| 65 | prompt "Only use malloc_simple functions in the TPL" |
| 66 | help |
| 67 | Say Y here to only use the *_simple malloc functions from |
| 68 | malloc_simple.c, rather then using the versions from dlmalloc.c; |
| 69 | this will make the TPL binary smaller at the cost of more heap |
| 70 | usage as the *_simple malloc functions do not re-use free-ed mem. |
| 71 | |
| 72 | config TPL_SEPARATE_BSS |
| 73 | bool "BSS section is in a different memory region from text" |
| 74 | default y if SPL_SEPARATE_BSS |
| 75 | help |
| 76 | Some platforms need a large BSS region in TPL and can provide this |
| 77 | because RAM is already set up. In this case BSS can be moved to RAM. |
| 78 | This option should then be enabled so that the correct device tree |
| 79 | location is used. Normally we put the device tree at the end of BSS |
| 80 | but with this option enabled, it goes at _image_binary_end. |
| 81 | |
| 82 | config TPL_LDSCRIPT |
| 83 | string "Linker script for the TPL stage" |
| 84 | default "arch/arm/cpu/armv8/u-boot-spl.lds" if ARM64 |
| 85 | default "arch/\$(ARCH)/cpu/u-boot-spl.lds" |
| 86 | help |
| 87 | The TPL stage will usually require a different linker-script |
| 88 | (as it runs from a different memory region) than the regular |
| 89 | U-Boot stage. Set this to the path of the linker-script to |
| 90 | be used for TPL. |
| 91 | |
| 92 | May be left empty to trigger the Makefile infrastructure to |
| 93 | fall back to the linker-script used for the SPL stage. |
| 94 | |
| 95 | config TPL_NEEDS_SEPARATE_STACK |
| 96 | bool "TPL needs a separate initial stack-pointer" |
| 97 | help |
| 98 | Enable, if the TPL stage should not inherit its initial |
| 99 | stack-pointer from the settings for the SPL stage. |
| 100 | |
| 101 | config TPL_POWER |
| 102 | bool "Support power drivers" |
| 103 | help |
| 104 | Enable support for power control in TPL. This includes support |
| 105 | for PMICs (Power-management Integrated Circuits) and some of the |
| 106 | features provided by PMICs. In particular, voltage regulators can |
| 107 | be used to enable/disable power and vary its voltage. That can be |
| 108 | useful in TPL to turn on boot peripherals and adjust CPU voltage |
| 109 | so that the clock speed can be increased. This enables the drivers |
| 110 | in drivers/power, drivers/power/pmic and drivers/power/regulator |
| 111 | as part of an TPL build. |
| 112 | |
| 113 | config TPL_TEXT_BASE |
| 114 | hex "Base address for the .text section of the TPL stage" |
| 115 | default 0 |
| 116 | help |
| 117 | The base address for the .text section of the TPL stage. |
| 118 | |
| 119 | config TPL_MAX_SIZE |
| 120 | hex "Maximum size (in bytes) for the TPL stage" |
| 121 | default 0x2e000 if ROCKCHIP_RK3399 |
| 122 | default 0x8000 if ROCKCHIP_RK3288 |
| 123 | default 0x7000 if ROCKCHIP_RK322X || ROCKCHIP_RK3328 || ROCKCHIP_RK3368 |
| 124 | default 0x2800 if ROCKCHIP_PX30 |
| 125 | default 0x0 |
| 126 | help |
| 127 | The maximum size (in bytes) of the TPL stage. |
| 128 | |
| 129 | config TPL_STACK |
| 130 | hex "Address of the initial stack-pointer for the TPL stage" |
| 131 | depends on TPL_NEEDS_SEPARATE_STACK |
| 132 | help |
| 133 | The address of the initial stack-pointer for the TPL stage. |
| 134 | Usually this will be the (aligned) top-of-stack. |
| 135 | |
| 136 | config TPL_READ_ONLY |
| 137 | bool |
| 138 | depends on TPL_OF_PLATDATA |
| 139 | select TPL_OF_PLATDATA_NO_BIND |
| 140 | select TPL_OF_PLATDATA_RT |
| 141 | help |
| 142 | Some platforms (e.g. x86 Apollo Lake) load SPL into a read-only |
| 143 | section of memory. This means that of-platdata must make a copy (in |
| 144 | writeable memory) of anything it wants to modify, such as |
| 145 | device-private data. |
| 146 | |
| 147 | config TPL_BOOTROM_SUPPORT |
| 148 | bool "Support returning to the BOOTROM (from TPL)" |
| 149 | help |
| 150 | Some platforms (e.g. the Rockchip RK3368) provide support in their |
| 151 | ROM for loading the next boot-stage after performing basic setup |
| 152 | from the TPL stage. |
| 153 | |
| 154 | Enable this option, to return to the BOOTROM through the |
| 155 | BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the |
| 156 | boot device list, if not implemented for a given board) |
| 157 | |
| 158 | config TPL_CRC32 |
| 159 | bool "Support CRC32 in TPL" |
| 160 | default y if TPL_ENV_SUPPORT || TPL_BLOBLIST |
| 161 | help |
| 162 | Enable this to support CRC32 in uImages or FIT images within SPL. |
| 163 | This is a 32-bit checksum value that can be used to verify images. |
| 164 | For FIT images, this is the least secure type of checksum, suitable |
| 165 | for detected accidental image corruption. For secure applications you |
| 166 | should consider SHA1 or SHA256. |
| 167 | |
| 168 | config TPL_DRIVERS_MISC |
| 169 | bool "Support misc drivers in TPL" |
| 170 | help |
| 171 | Enable miscellaneous drivers in TPL. These drivers perform various |
| 172 | tasks that don't fall nicely into other categories, Enable this |
| 173 | option to build the drivers in drivers/misc as part of an TPL |
| 174 | build, for those that support building in TPL (not all drivers do). |
| 175 | |
| 176 | config TPL_ENV_SUPPORT |
| 177 | bool "Support an environment" |
| 178 | help |
| 179 | Enable environment support in TPL. See SPL_ENV_SUPPORT for details. |
| 180 | |
| 181 | config TPL_GPIO |
| 182 | bool "Support GPIO in TPL" |
| 183 | help |
| 184 | Enable support for GPIOs (General-purpose Input/Output) in TPL. |
| 185 | GPIOs allow U-Boot to read the state of an input line (high or |
| 186 | low) and set the state of an output line. This can be used to |
| 187 | drive LEDs, control power to various system parts and read user |
| 188 | input. GPIOs can be useful in TPL to enable a 'sign-of-life' LED, |
| 189 | for example. Enable this option to build the drivers in |
| 190 | drivers/gpio as part of an TPL build. |
| 191 | |
| 192 | config TPL_I2C |
| 193 | bool "Support I2C" |
| 194 | help |
| 195 | Enable support for the I2C bus in TPL. See SPL_I2C for |
| 196 | details. |
| 197 | |
| 198 | config TPL_LIBCOMMON_SUPPORT |
| 199 | bool "Support common libraries" |
| 200 | help |
| 201 | Enable support for common U-Boot libraries within TPL. See |
| 202 | SPL_LIBCOMMON_SUPPORT for details. |
| 203 | |
| 204 | config TPL_LIBGENERIC_SUPPORT |
| 205 | bool "Support generic libraries" |
| 206 | help |
| 207 | Enable support for generic U-Boot libraries within TPL. See |
| 208 | SPL_LIBGENERIC_SUPPORT for details. |
| 209 | |
| 210 | config TPL_MPC8XXX_INIT_DDR |
| 211 | bool "Support MPC8XXX DDR init" |
| 212 | help |
| 213 | Enable support for DDR-SDRAM on the MPC8XXX family within TPL. See |
| 214 | SPL_MPC8XXX_INIT_DDR for details. |
| 215 | |
| 216 | config TPL_MMC |
| 217 | bool "Support MMC" |
| 218 | depends on MMC |
| 219 | help |
| 220 | Enable support for MMC within TPL. See SPL_MMC for details. |
| 221 | |
| 222 | config TPL_NAND_SUPPORT |
| 223 | bool "Support NAND flash" |
| 224 | help |
| 225 | Enable support for NAND in TPL. See SPL_NAND_SUPPORT for details. |
| 226 | |
| 227 | config TPL_PCI |
| 228 | bool "Support PCI drivers" |
| 229 | help |
| 230 | Enable support for PCI in TPL. For platforms that need PCI to boot, |
| 231 | or must perform some init using PCI in SPL, this provides the |
| 232 | necessary driver support. This enables the drivers in drivers/pci |
| 233 | as part of a TPL build. |
| 234 | |
| 235 | config TPL_PCH |
| 236 | bool "Support PCH drivers" |
| 237 | help |
| 238 | Enable support for PCH (Platform Controller Hub) devices in TPL. |
| 239 | These are used to set up GPIOs and the SPI peripheral early in |
| 240 | boot. This enables the drivers in drivers/pch as part of a TPL |
| 241 | build. |
| 242 | |
| 243 | config TPL_RAM_SUPPORT |
| 244 | bool "Support booting from RAM" |
| 245 | help |
| 246 | Enable booting of an image in RAM. The image can be preloaded or |
| 247 | it can be loaded by TPL directly into RAM (e.g. using USB). |
| 248 | |
| 249 | config TPL_RAM_DEVICE |
| 250 | bool "Support booting from preloaded image in RAM" |
| 251 | depends on TPL_RAM_SUPPORT |
| 252 | help |
| 253 | Enable booting of an image already loaded in RAM. The image has to |
| 254 | be already in memory when TPL takes over, e.g. loaded by the boot |
| 255 | ROM. |
| 256 | |
| 257 | config TPL_RTC |
| 258 | bool "Support RTC drivers" |
| 259 | help |
| 260 | Enable RTC (Real-time Clock) support in TPL. This includes support |
| 261 | for reading and setting the time. Some RTC devices also have some |
| 262 | non-volatile (battery-backed) memory which is accessible if |
| 263 | needed. This enables the drivers in drivers/rtc as part of an TPL |
| 264 | build. |
| 265 | |
| 266 | config TPL_SERIAL |
| 267 | bool "Support serial" |
| 268 | select TPL_PRINTF |
| 269 | select TPL_STRTO |
| 270 | help |
| 271 | Enable support for serial in TPL. See SPL_SERIAL for |
| 272 | details. |
| 273 | |
| 274 | config TPL_SPI_FLASH_SUPPORT |
| 275 | bool "Support SPI flash drivers" |
| 276 | help |
| 277 | Enable support for using SPI flash in TPL. See SPL_SPI_FLASH_SUPPORT |
| 278 | for details. |
| 279 | |
| 280 | config TPL_SPI_FLASH_TINY |
| 281 | bool "Enable low footprint TPL SPI Flash support" |
| 282 | depends on TPL_SPI_FLASH_SUPPORT && !SPI_FLASH_BAR |
| 283 | default y if SPI_FLASH |
| 284 | help |
| 285 | Enable lightweight TPL SPI Flash support that supports just reading |
| 286 | data/images from flash. No support to write/erase flash. Enable |
| 287 | this if you have TPL size limitations and don't need full-fledged |
| 288 | SPI flash support. |
| 289 | |
| 290 | config TPL_SPI_LOAD |
| 291 | bool "Support loading from SPI flash" |
| 292 | depends on TPL_SPI_FLASH_SUPPORT |
| 293 | help |
| 294 | Enable support for loading next stage, U-Boot or otherwise, from |
| 295 | SPI NOR in U-Boot TPL. |
| 296 | |
| 297 | config TPL_SPI |
| 298 | bool "Support SPI drivers" |
| 299 | help |
| 300 | Enable support for using SPI in TPL. See SPL_SPI for |
| 301 | details. |
| 302 | |
| 303 | config TPL_DM_SPI |
| 304 | bool "Support SPI DM drivers in TPL" |
| 305 | help |
| 306 | Enable support for SPI DM drivers in TPL. |
| 307 | |
| 308 | config TPL_DM_SPI_FLASH |
| 309 | bool "Support SPI DM FLASH drivers in TPL" |
| 310 | help |
| 311 | Enable support for SPI DM flash drivers in TPL. |
| 312 | |
| 313 | config TPL_YMODEM_SUPPORT |
| 314 | bool "Support loading using Ymodem" |
| 315 | depends on TPL_SERIAL |
| 316 | help |
| 317 | While loading from serial is slow it can be a useful backup when |
| 318 | there is no other option. The Ymodem protocol provides a reliable |
| 319 | means of transmitting U-Boot over a serial line for using in TPL, |
| 320 | with a checksum to ensure correctness. |
| 321 | |
| 322 | endmenu |