blob: 7561335bfd8482544dee19c1c1d1d14dc860e481 [file] [log] [blame]
Simon Glass11bde1c2016-09-13 07:05:23 -06001menu "SPL / TPL"
2
Simon Glassc2ae7d82016-09-12 23:18:22 -06003config SUPPORT_SPL
4 bool
5
6config SUPPORT_TPL
7 bool
8
B, Ravi66928af2017-05-04 15:45:29 +05309config SPL_DFU_NO_RESET
10 bool
11
Simon Glassc2ae7d82016-09-12 23:18:22 -060012config SPL
13 bool
14 depends on SUPPORT_SPL
15 prompt "Enable SPL"
16 help
17 If you want to build SPL as well as the normal image, say Y.
18
Tom Rini75670c82018-02-06 12:15:38 -050019config SPL_FRAMEWORK
20 bool "Support SPL based upon the common SPL framework"
21 depends on SPL
22 default y
23 help
24 Enable the SPL framework under common/spl/. This framework
25 supports MMC, NAND and YMODEM and other methods loading of U-Boot
26 and the Linux Kernel. If unsure, say Y.
27
Philippe Reynesa9a3aad2019-09-19 16:18:39 +020028config SPL_FRAMEWORK_BOARD_INIT_F
29 bool "Define a generic function board_init_f"
30 depends on SPL_FRAMEWORK
31 help
32 Define a generic function board_init_f that:
33 - initialize the spl (spl_early_init)
34 - initialize the serial (preloader_console_init)
35 Unless you want to provide your own board_init_f, you should say Y.
36
Simon Goldschmidt25770152019-05-24 22:07:04 +020037config SPL_SIZE_LIMIT
Simon Glassb51882d2019-09-25 08:56:28 -060038 hex "Maximum size of SPL image"
Simon Goldschmidt25770152019-05-24 22:07:04 +020039 depends on SPL
Ovidiu Panait2dfdd0c2020-09-25 21:12:56 +030040 default 0x11000 if ARCH_MX6 && !MX6_OCRAM_256KB
41 default 0x31000 if ARCH_MX6 && MX6_OCRAM_256KB
42 default 0x0
Simon Goldschmidt25770152019-05-24 22:07:04 +020043 help
44 Specifies the maximum length of the U-Boot SPL image.
45 If this value is zero, it is ignored.
46
47config SPL_SIZE_LIMIT_SUBTRACT_GD
48 bool "SPL image size check: provide space for global data"
49 depends on SPL_SIZE_LIMIT > 0
50 help
51 If enabled, aligned size of global data is reserved in
52 SPL_SIZE_LIMIT check to ensure such an image does not overflow SRAM
53 if SPL_SIZE_LIMIT describes the size of SRAM available for SPL when
54 pre-reloc global data is put into this SRAM, too.
55
56config SPL_SIZE_LIMIT_SUBTRACT_MALLOC
57 bool "SPL image size check: provide space for malloc() pool before relocation"
58 depends on SPL_SIZE_LIMIT > 0
59 help
60 If enabled, SPL_SYS_MALLOC_F_LEN is reserved in SPL_SIZE_LIMIT check
61 to ensure such an image does not overflow SRAM if SPL_SIZE_LIMIT
62 describes the size of SRAM available for SPL when pre-reloc malloc
63 pool is put into this SRAM, too.
64
65config SPL_SIZE_LIMIT_PROVIDE_STACK
66 hex "SPL image size check: provide stack space before relocation"
67 depends on SPL_SIZE_LIMIT > 0
68 default 0
69 help
70 If set, this size is reserved in SPL_SIZE_LIMIT check to ensure such
71 an image does not overflow SRAM if SPL_SIZE_LIMIT describes the size
72 of SRAM available for SPL when the stack required before reolcation
73 uses this SRAM, too.
74
Simon Goldschmidtd8c03322019-07-16 22:30:36 +020075config SPL_SYS_STACK_F_CHECK_BYTE
76 hex
77 default 0xaa
78 help
79 Constant used to check the stack
80
81config SPL_SYS_REPORT_STACK_F_USAGE
82 depends on SPL_SIZE_LIMIT_PROVIDE_STACK != 0
83 bool "Check and report stack usage in SPL before relocation"
84 help
85 If this option is enabled, the initial SPL stack is filled with 0xaa
86 very early, up to the size configured with
87 SPL_SIZE_LIMIT_PROVIDE_STACK.
88 Later when SPL is done using this initial stack and switches to a
89 stack in DRAM, the actually used size of this initial stack is
90 reported by examining the memory and searching for the lowest
91 occurrence of non 0xaa bytes.
92 This default implementation works for stacks growing down only.
93
Alison Wang5d168ad2019-12-04 06:21:55 +000094menu "PowerPC and LayerScape SPL Boot options"
Tom Rinidb4080d2019-06-01 14:20:25 -040095
96config SPL_NAND_BOOT
97 bool "Load SPL from NAND flash"
Alison Wang5d168ad2019-12-04 06:21:55 +000098 depends on PPC && (SUPPORT_SPL && !SPL_FRAMEWORK)
Tom Rinidb4080d2019-06-01 14:20:25 -040099
100config SPL_MMC_BOOT
101 bool "Load SPL from SD Card / eMMC"
Alison Wang5d168ad2019-12-04 06:21:55 +0000102 depends on PPC && (SUPPORT_SPL && !SPL_FRAMEWORK)
Tom Rinidb4080d2019-06-01 14:20:25 -0400103
104config SPL_SPI_BOOT
105 bool "Load SPL from SPI flash"
Alison Wang5d168ad2019-12-04 06:21:55 +0000106 depends on PPC && (SUPPORT_SPL && !SPL_FRAMEWORK)
Tom Rinidb4080d2019-06-01 14:20:25 -0400107
108config SPL_FSL_PBL
109 bool "Create SPL in Freescale PBI format"
Alison Wang5d168ad2019-12-04 06:21:55 +0000110 depends on (PPC || ARCH_LS1021A || ARCH_LS1043A || ARCH_LS1046A) && \
111 SUPPORT_SPL
Tom Rinidb4080d2019-06-01 14:20:25 -0400112 help
113 Create boot binary having SPL binary in PBI format concatenated with
114 u-boot binary.
115
Simon Glass38d6b7e2020-12-22 19:30:21 -0700116config SPL_ALLOC_BD
117 bool "Allocate memory for bd_info"
118 default y if X86 || SANDBOX
119 help
120 Some boards don't allocate space for this in their board_init_f()
121 code. In this case U-Boot can allocate space for gd->bd in the
122 standard SPL flow (board_init_r()). Enable this option to support
123 this feature.
124
Tom Rinidb4080d2019-06-01 14:20:25 -0400125endmenu
126
Simon Glassb0edea32018-11-15 18:44:09 -0700127config HANDOFF
128 bool "Pass hand-off information from SPL to U-Boot proper"
Ovidiu Panait2a7c9ab2020-11-28 10:43:19 +0200129 depends on SPL && BLOBLIST
Simon Glassb0edea32018-11-15 18:44:09 -0700130 help
131 It is useful to be able to pass information from SPL to U-Boot
132 proper to preserve state that is known in SPL and is needed in U-Boot.
133 Enable this to locate the handoff information in U-Boot proper, early
134 in boot. It is available in gd->handoff. The state state is set up
135 in SPL (or TPL if that is being used).
136
Tom Rini226498b2017-05-22 19:21:57 +0000137if SPL
138
Simon Glassb0edea32018-11-15 18:44:09 -0700139config SPL_HANDOFF
140 bool "Pass hand-off information from SPL to U-Boot proper"
Simon Glassa7da3d92019-09-25 08:11:17 -0600141 depends on HANDOFF && SPL_BLOBLIST
Simon Glassb0edea32018-11-15 18:44:09 -0700142 default y
143 help
144 This option enables SPL to write handoff information. This can be
145 used to pass information like the size of SDRAM from SPL to U-Boot
146 proper. Also SPL can receive information from TPL in the same place
147 if that is enabled.
148
Philipp Tomsichdd6fbcb2017-07-28 19:20:49 +0200149config SPL_LDSCRIPT
150 string "Linker script for the SPL stage"
Tom Rinia356e7a2020-03-11 18:11:11 -0400151 default "arch/\$(ARCH)/cpu/u-boot-spl.lds"
Philipp Tomsichdd6fbcb2017-07-28 19:20:49 +0200152 help
153 The SPL stage will usually require a different linker-script
154 (as it runs from a different memory region) than the regular
155 U-Boot stage. Set this to the path of the linker-script to
156 be used for SPL.
157
Simon Goldschmidtf89d6132018-09-30 14:31:53 +0200158config SPL_TEXT_BASE
159 hex "SPL Text Base"
160 default ISW_ENTRY_ADDR if AM43XX || AM33XX || OMAP54XX || ARCH_KEYSTONE
Andre Przywara9340d8f2019-05-27 01:45:11 +0100161 default 0x10060 if MACH_SUN50I || MACH_SUN50I_H5 || MACH_SUN9I
162 default 0x20060 if MACH_SUN50I_H6
163 default 0x00060 if ARCH_SUNXI
Michal Simek0413f9c2019-09-11 08:49:31 +0200164 default 0xfffc0000 if ARCH_ZYNQMP
Simon Goldschmidtf89d6132018-09-30 14:31:53 +0200165 default 0x0
166 help
167 The address in memory that SPL will be running from.
168
Ley Foon Tan0680f1b2017-05-03 17:13:32 +0800169config SPL_BOARD_INIT
Ley Foon Tan0680f1b2017-05-03 17:13:32 +0800170 bool "Call board-specific initialization in SPL"
171 help
172 If this option is enabled, U-Boot will call the function
173 spl_board_init() from board_init_r(). This function should be
174 provided by the board.
175
Philipp Tomsich225d30b2017-06-22 23:38:36 +0200176config SPL_BOOTROM_SUPPORT
177 bool "Support returning to the BOOTROM"
178 help
179 Some platforms (e.g. the Rockchip RK3368) provide support in their
180 ROM for loading the next boot-stage after performing basic setup
181 from the SPL stage.
182
183 Enable this option, to return to the BOOTROM through the
184 BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
185 boot device list, if not implemented for a given board)
186
Lukasz Majewskiafa96092018-05-02 16:10:50 +0200187config SPL_BOOTCOUNT_LIMIT
188 bool "Support bootcount in SPL"
189 depends on SPL_ENV_SUPPORT
190 help
191 On some boards, which use 'falcon' mode, it is necessary to check
192 and increment the number of boot attempts. Such boards do not
193 use proper U-Boot for normal boot flow and hence needs those
194 adjustments to be done in the SPL.
195
Andrew F. Davis24eb39b2017-02-16 11:18:38 -0600196config SPL_RAW_IMAGE_SUPPORT
197 bool "Support SPL loading and booting of RAW images"
Andrew F. Davis24eb39b2017-02-16 11:18:38 -0600198 default n if (ARCH_MX6 && (SPL_MMC_SUPPORT || SPL_SATA_SUPPORT))
Andrew F. Davisae9b57b2017-02-16 11:18:40 -0600199 default y if !TI_SECURE_DEVICE
Andrew F. Davis24eb39b2017-02-16 11:18:38 -0600200 help
201 SPL will support loading and booting a RAW image when this option
202 is y. If this is not set, SPL will move on to other available
203 boot media to find a suitable image.
204
Andrew F. Davis722a6b12017-02-16 11:18:39 -0600205config SPL_LEGACY_IMAGE_SUPPORT
206 bool "Support SPL loading and booting of Legacy images"
Tom Rini11bd2fa2019-05-23 07:14:08 -0400207 default y if !TI_SECURE_DEVICE && !SPL_LOAD_FIT
Andrew F. Davis722a6b12017-02-16 11:18:39 -0600208 help
209 SPL will support loading and booting Legacy images when this option
210 is y. If this is not set, SPL will move on to other available
211 boot media to find a suitable image.
212
Simon Goldschmidtdae5c2d2019-02-10 21:34:37 +0100213config SPL_LEGACY_IMAGE_CRC_CHECK
214 bool "Check CRC of Legacy images"
215 depends on SPL_LEGACY_IMAGE_SUPPORT
216 select SPL_CRC32_SUPPORT
217 help
218 Enable this to check the CRC of Legacy images. While this increases
219 reliability, it affects both code size and boot duration.
220 If disabled, Legacy images are booted if the image magic and size
221 are correct, without further integrity checks.
222
Simon Glassc2ae7d82016-09-12 23:18:22 -0600223config SPL_SYS_MALLOC_SIMPLE
224 bool
Simon Glassc2ae7d82016-09-12 23:18:22 -0600225 prompt "Only use malloc_simple functions in the SPL"
226 help
227 Say Y here to only use the *_simple malloc functions from
228 malloc_simple.c, rather then using the versions from dlmalloc.c;
229 this will make the SPL binary smaller at the cost of more heap
230 usage as the *_simple malloc functions do not re-use free-ed mem.
231
Philipp Tomsichd60b5f72017-06-30 18:57:25 +0200232config TPL_SYS_MALLOC_SIMPLE
233 bool
234 prompt "Only use malloc_simple functions in the TPL"
Adam Ford05705562019-08-13 14:32:30 -0500235 depends on TPL
Philipp Tomsichd60b5f72017-06-30 18:57:25 +0200236 help
237 Say Y here to only use the *_simple malloc functions from
238 malloc_simple.c, rather then using the versions from dlmalloc.c;
239 this will make the TPL binary smaller at the cost of more heap
240 usage as the *_simple malloc functions do not re-use free-ed mem.
241
Simon Glassc2ae7d82016-09-12 23:18:22 -0600242config SPL_STACK_R
Simon Glassc2ae7d82016-09-12 23:18:22 -0600243 bool "Enable SDRAM location for SPL stack"
244 help
245 SPL starts off execution in SRAM and thus typically has only a small
246 stack available. Since SPL sets up DRAM while in its board_init_f()
247 function, it is possible for the stack to move there before
248 board_init_r() is reached. This option enables a special SDRAM
249 location for the SPL stack. U-Boot SPL switches to this after
250 board_init_f() completes, and before board_init_r() starts.
251
252config SPL_STACK_R_ADDR
253 depends on SPL_STACK_R
254 hex "SDRAM location for SPL stack"
Tom Riniff6c3122017-09-17 11:44:49 -0400255 default 0x82000000 if ARCH_OMAP2PLUS
Simon Glassc2ae7d82016-09-12 23:18:22 -0600256 help
257 Specify the address in SDRAM for the SPL stack. This will be set up
258 before board_init_r() is called.
259
260config SPL_STACK_R_MALLOC_SIMPLE_LEN
261 depends on SPL_STACK_R && SPL_SYS_MALLOC_SIMPLE
262 hex "Size of malloc_simple heap after switching to DRAM SPL stack"
263 default 0x100000
264 help
265 Specify the amount of the stack to use as memory pool for
266 malloc_simple after switching the stack to DRAM. This may be set
267 to give board_init_r() a larger heap then the initial heap in
268 SRAM which is limited to SYS_MALLOC_F_LEN bytes.
269
270config SPL_SEPARATE_BSS
Simon Glassc2ae7d82016-09-12 23:18:22 -0600271 bool "BSS section is in a different memory region from text"
272 help
273 Some platforms need a large BSS region in SPL and can provide this
274 because RAM is already set up. In this case BSS can be moved to RAM.
275 This option should then be enabled so that the correct device tree
276 location is used. Normally we put the device tree at the end of BSS
277 but with this option enabled, it goes at _image_binary_end.
278
Simon Glassaedc08b2018-11-15 18:43:57 -0700279config SPL_BANNER_PRINT
280 bool "Enable output of the SPL banner 'U-Boot SPL ...'"
281 default y
282 help
283 If this option is enabled, SPL will print the banner with version
Thomas Hebb32f2ca22019-11-13 18:18:03 -0800284 info. Disabling this option could be useful to reduce SPL boot time
Simon Glassaedc08b2018-11-15 18:43:57 -0700285 (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
286
287config TPL_BANNER_PRINT
288 bool "Enable output of the TPL banner 'U-Boot TPL ...'"
Adam Ford05705562019-08-13 14:32:30 -0500289 depends on TPL
Simon Glassaedc08b2018-11-15 18:43:57 -0700290 default y
Anatolij Gustschin0292bc02018-01-25 18:45:22 +0100291 help
Thomas Hebb32f2ca22019-11-13 18:18:03 -0800292 If this option is enabled, TPL will print the banner with version
293 info. Disabling this option could be useful to reduce TPL boot time
Simon Glassaedc08b2018-11-15 18:43:57 -0700294 (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
Anatolij Gustschin0292bc02018-01-25 18:45:22 +0100295
Andreas Dannenberga5a5d992019-06-04 17:55:45 -0500296config SPL_EARLY_BSS
297 depends on ARM && !ARM64
298 bool "Allows initializing BSS early before entering board_init_f"
299 help
300 On some platform we have sufficient memory available early on to
301 allow setting up and using a basic BSS prior to entering
302 board_init_f. Activating this option will also de-activate the
303 clearing of BSS during the SPL relocation process, thus allowing
304 to carry state from board_init_f to board_init_r by way of BSS.
305
Simon Glassa807ab32016-09-24 18:19:56 -0600306config SPL_DISPLAY_PRINT
Simon Glassa807ab32016-09-24 18:19:56 -0600307 bool "Display a board-specific message in SPL"
308 help
309 If this option is enabled, U-Boot will call the function
310 spl_display_print() immediately after displaying the SPL console
311 banner ("U-Boot SPL ..."). This function should be provided by
312 the board.
313
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200314config SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
315 bool "MMC raw mode: by sector"
Fabio Estevam1da19382018-06-11 15:08:05 -0300316 default y if ARCH_SUNXI || ARCH_DAVINCI || ARCH_UNIPHIER || \
317 ARCH_MX6 || ARCH_MX7 || \
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200318 ARCH_ROCKCHIP || ARCH_MVEBU || ARCH_SOCFPGA || \
319 ARCH_AT91 || ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || \
Jagan Teki819da862020-05-29 11:33:37 +0530320 OMAP44XX || OMAP54XX || AM33XX || AM43XX || TARGET_SIFIVE_FU540
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200321 help
322 Use sector number for specifying U-Boot location on MMC/SD in
323 raw mode.
324
325config SYS_MMCSD_RAW_MODE_U_BOOT_SECTOR
326 hex "Address on the MMC to load U-Boot from"
Tom Rini226498b2017-05-22 19:21:57 +0000327 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200328 default 0x50 if ARCH_SUNXI
329 default 0x75 if ARCH_DAVINCI
Fabio Estevam1da19382018-06-11 15:08:05 -0300330 default 0x8a if ARCH_MX6 || ARCH_MX7
Kever Yang8f4d62b2017-11-02 15:16:34 +0800331 default 0x100 if ARCH_UNIPHIER
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200332 default 0x140 if ARCH_MVEBU
333 default 0x200 if ARCH_SOCFPGA || ARCH_AT91
334 default 0x300 if ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || OMAP44XX || \
Lokesh Vutla586bde92018-08-27 15:57:08 +0530335 OMAP54XX || AM33XX || AM43XX || ARCH_K3
Kever Yang8f4d62b2017-11-02 15:16:34 +0800336 default 0x4000 if ARCH_ROCKCHIP
Jagan Teki819da862020-05-29 11:33:37 +0530337 default 0x822 if TARGET_SIFIVE_FU540
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200338 help
339 Address on the MMC to load U-Boot from, when the MMC is being used
340 in raw mode. Units: MMC sectors (1 sector = 512 bytes).
341
Baruch Siache42afd82020-01-15 09:08:08 +0200342config SYS_MMCSD_RAW_MODE_U_BOOT_DATA_PART_OFFSET
343 hex "U-Boot main hardware partition image offset"
344 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
345 default 0x0
346 help
347 On some platforms SPL location depends on hardware partition. The ROM
348 code skips the MBR sector when loading SPL from main hardware data
349 partition. This adds offset to the main U-Boot image. Set this symbol
350 to the number of skipped sectors.
351
352 If unsure, leave the default.
353
Dalon Westergreen949123e2017-02-10 17:15:35 -0800354config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
355 bool "MMC Raw mode: by partition"
Dalon Westergreen949123e2017-02-10 17:15:35 -0800356 help
357 Use a partition for loading U-Boot when using MMC/SD in raw mode.
358
359config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION
360 hex "Partition to use to load U-Boot from"
Tom Rini226498b2017-05-22 19:21:57 +0000361 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
Dalon Westergreen949123e2017-02-10 17:15:35 -0800362 default 1
363 help
364 Partition on the MMC to load U-Boot from when the MMC is being
365 used in raw mode
366
Dalon Westergreenf0fb4fa2017-02-10 17:15:34 -0800367config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
368 bool "MMC raw mode: by partition type"
Tom Rini226498b2017-05-22 19:21:57 +0000369 depends on DOS_PARTITION && SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
Dalon Westergreenf0fb4fa2017-02-10 17:15:34 -0800370 help
371 Use partition type for specifying U-Boot partition on MMC/SD in
372 raw mode. U-Boot will be loaded from the first partition of this
373 type to be found.
374
375config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION_TYPE
376 hex "Partition Type on the MMC to load U-Boot from"
Tom Rini226498b2017-05-22 19:21:57 +0000377 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
Dalon Westergreenf0fb4fa2017-02-10 17:15:34 -0800378 help
379 Partition Type on the MMC to load U-Boot from, when the MMC is being
380 used in raw mode.
381
Anatolij Gustschin32ded502019-10-18 21:38:33 +0200382config SUPPORT_EMMC_BOOT_OVERRIDE_PART_CONFIG
383 bool "Override eMMC EXT_CSC_PART_CONFIG by user defined partition"
384 depends on SUPPORT_EMMC_BOOT
385 help
386 eMMC boot partition is normally configured by the bits of the EXT_CSD
387 register (EXT_CSC_PART_CONFIG), BOOT_PARTITION_ENABLE field. In some
388 cases it might be required in SPL to load the image from different
389 partition than the partition selected by EXT_CSC_PART_CONFIG register.
390 Enable this option if you intend to use an eMMC boot partition other
391 then selected via EXT_CSC_PART_CONFIG register and specify the custom
392 partition number by the CONFIG_SYS_MMCSD_RAW_MODE_EMMC_BOOT_PARTITION
393 option.
394
395config SYS_MMCSD_RAW_MODE_EMMC_BOOT_PARTITION
396 int "Number of the eMMC boot partition to use"
397 depends on SUPPORT_EMMC_BOOT_OVERRIDE_PART_CONFIG
398 default 1
399 help
400 eMMC boot partition number to use when the eMMC in raw mode and
401 the eMMC EXT_CSC_PART_CONFIG selection should be overridden in SPL
402 by user defined partition number.
403
Simon Glass11bde1c2016-09-13 07:05:23 -0600404config SPL_CRC32_SUPPORT
405 bool "Support CRC32"
Simon Goldschmidtdae5c2d2019-02-10 21:34:37 +0100406 default y if SPL_LEGACY_IMAGE_SUPPORT
Simon Glass11bde1c2016-09-13 07:05:23 -0600407 help
Simon Goldschmidtdae5c2d2019-02-10 21:34:37 +0100408 Enable this to support CRC32 in uImages or FIT images within SPL.
409 This is a 32-bit checksum value that can be used to verify images.
410 For FIT images, this is the least secure type of checksum, suitable
411 for detected accidental image corruption. For secure applications you
412 should consider SHA1 or SHA256.
Simon Glass11bde1c2016-09-13 07:05:23 -0600413
414config SPL_MD5_SUPPORT
415 bool "Support MD5"
416 depends on SPL_FIT
417 help
418 Enable this to support MD5 in FIT images within SPL. An MD5
419 checksum is a 128-bit hash value used to check that the image
420 contents have not been corrupted. Note that MD5 is not considered
421 secure as it is possible (with a brute-force attack) to adjust the
422 image while still retaining the same MD5 hash value. For secure
423 applications where images may be changed maliciously, you should
Reuben Dowled16b38f2020-04-16 17:36:52 +1200424 consider SHA256 or SHA384.
Simon Glass11bde1c2016-09-13 07:05:23 -0600425
426config SPL_SHA1_SUPPORT
427 bool "Support SHA1"
428 depends on SPL_FIT
Tom Rini089df182017-05-15 12:17:49 -0400429 select SHA1
Simon Glass11bde1c2016-09-13 07:05:23 -0600430 help
431 Enable this to support SHA1 in FIT images within SPL. A SHA1
432 checksum is a 160-bit (20-byte) hash value used to check that the
433 image contents have not been corrupted or maliciously altered.
434 While SHA1 is fairly secure it is coming to the end of its life
Vagrant Cascadian048a92e2019-05-03 14:28:37 -0800435 due to the expanding computing power available to brute-force
Reuben Dowled16b38f2020-04-16 17:36:52 +1200436 attacks. For more security, consider SHA256 or SHA384.
Simon Glass11bde1c2016-09-13 07:05:23 -0600437
438config SPL_SHA256_SUPPORT
439 bool "Support SHA256"
440 depends on SPL_FIT
Tom Rini089df182017-05-15 12:17:49 -0400441 select SHA256
Simon Glass11bde1c2016-09-13 07:05:23 -0600442 help
443 Enable this to support SHA256 in FIT images within SPL. A SHA256
444 checksum is a 256-bit (32-byte) hash value used to check that the
Reuben Dowled16b38f2020-04-16 17:36:52 +1200445 image contents have not been corrupted.
446
447config SPL_SHA384_SUPPORT
448 bool "Support SHA384"
449 depends on SPL_FIT
450 select SHA384
451 select SHA512_ALGO
452 help
453 Enable this to support SHA384 in FIT images within SPL. A SHA384
454 checksum is a 384-bit (48-byte) hash value used to check that the
455 image contents have not been corrupted. Use this for the highest
456 security.
457
458config SPL_SHA512_SUPPORT
459 bool "Support SHA512"
460 depends on SPL_FIT
461 select SHA512
462 select SHA512_ALGO
463 help
464 Enable this to support SHA512 in FIT images within SPL. A SHA512
465 checksum is a 512-bit (64-byte) hash value used to check that the
466 image contents have not been corrupted.
Simon Glass11bde1c2016-09-13 07:05:23 -0600467
Philipp Tomsich337bbb62017-11-24 13:26:03 +0100468config SPL_FIT_IMAGE_TINY
469 bool "Remove functionality from SPL FIT loading to reduce size"
470 depends on SPL_FIT
Icenowy Zheng6f796a92018-07-21 16:20:31 +0800471 default y if MACH_SUN50I || MACH_SUN50I_H5 || MACH_SUN50I_H6
Ye Lif6282cd2018-11-20 10:19:15 +0000472 default y if ARCH_IMX8M
Philipp Tomsich337bbb62017-11-24 13:26:03 +0100473 help
474 Enable this to reduce the size of the FIT image loading code
475 in SPL, if space for the SPL binary is very tight.
476
Samuel Hollandcf705532020-10-21 21:12:13 -0500477 This skips the recording of each loaded payload
Philipp Tomsich337bbb62017-11-24 13:26:03 +0100478 (i.e. loadable) into the FDT (modifying the loaded FDT to
479 ensure this information is available to the next image
480 invoked).
481
Rick Chen31dae222019-11-14 13:52:26 +0800482config SPL_CACHE_SUPPORT
483 bool "Support CACHE drivers"
484 help
485 Enable CACHE drivers in SPL. These drivers can keep data so that
486 future requests for that data can be served faster. Enable this option
487 to build the drivers in drivers/cache as part of an SPL build.
488
Simon Glass5e148df2017-01-16 07:03:29 -0700489config SPL_CPU_SUPPORT
490 bool "Support CPU drivers"
Simon Glass5e148df2017-01-16 07:03:29 -0700491 help
492 Enable this to support CPU drivers in SPL. These drivers can set
493 up CPUs and provide information about them such as the model and
494 name. This can be useful in SPL since setting up the CPUs earlier
495 may improve boot performance. Enable this option to build the
496 drivers in drivers/cpu as part of an SPL build.
497
Simon Glass11bde1c2016-09-13 07:05:23 -0600498config SPL_CRYPTO_SUPPORT
499 bool "Support crypto drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -0600500 help
501 Enable crypto drivers in SPL. These drivers can be used to
502 accelerate secure boot processing in secure applications. Enable
503 this option to build the drivers in drivers/crypto as part of an
504 SPL build.
505
506config SPL_HASH_SUPPORT
507 bool "Support hashing drivers"
Tom Rini089df182017-05-15 12:17:49 -0400508 select SHA1
509 select SHA256
Simon Glass11bde1c2016-09-13 07:05:23 -0600510 help
511 Enable hashing drivers in SPL. These drivers can be used to
512 accelerate secure boot processing in secure applications. Enable
513 this option to build system-specific drivers for hash acceleration
514 as part of an SPL build.
515
Simon Glass2d424eb2018-11-15 18:43:55 -0700516config TPL_HASH_SUPPORT
517 bool "Support hashing drivers in TPL"
Adam Forda0746672019-08-24 13:50:34 -0500518 depends on TPL
Simon Glass2d424eb2018-11-15 18:43:55 -0700519 select SHA1
520 select SHA256
521 help
522 Enable hashing drivers in SPL. These drivers can be used to
523 accelerate secure boot processing in secure applications. Enable
524 this option to build system-specific drivers for hash acceleration
525 as part of an SPL build.
526
Vignesh Raghavendra74326a32019-11-15 17:00:41 +0530527config SPL_DMA
Simon Glass11bde1c2016-09-13 07:05:23 -0600528 bool "Support DMA drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -0600529 help
530 Enable DMA (direct-memory-access) drivers in SPL. These drivers
531 can be used to handle memory-to-peripheral data transfer without
532 the CPU moving the data. Enable this option to build the drivers
533 in drivers/dma as part of an SPL build.
534
535config SPL_DRIVERS_MISC_SUPPORT
536 bool "Support misc drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -0600537 help
538 Enable miscellaneous drivers in SPL. These drivers perform various
539 tasks that don't fall nicely into other categories, Enable this
540 option to build the drivers in drivers/misc as part of an SPL
541 build, for those that support building in SPL (not all drivers do).
542
543config SPL_ENV_SUPPORT
544 bool "Support an environment"
Simon Glass11bde1c2016-09-13 07:05:23 -0600545 help
546 Enable environment support in SPL. The U-Boot environment provides
547 a number of settings (essentially name/value pairs) which can
548 control many aspects of U-Boot's operation. Normally this is not
549 needed in SPL as it has a much simpler task with less
550 configuration. But some boards use this to support 'Falcon' boot
551 on EXT2 and FAT, where SPL boots directly into Linux without
Simon Glass00caae62017-08-03 12:22:12 -0600552 starting U-Boot first. Enabling this option will make env_get()
Simon Glass382bee52017-08-03 12:22:09 -0600553 and env_set() available in SPL.
Simon Glass11bde1c2016-09-13 07:05:23 -0600554
B, Ravid2d9bdf2016-09-28 14:46:18 +0530555config SPL_SAVEENV
556 bool "Support save environment"
Tom Rini226498b2017-05-22 19:21:57 +0000557 depends on SPL_ENV_SUPPORT
Jean-Jacques Hiblotd6400c32018-01-04 15:23:32 +0100558 select SPL_MMC_WRITE if ENV_IS_IN_MMC
B, Ravid2d9bdf2016-09-28 14:46:18 +0530559 help
560 Enable save environment support in SPL after setenv. By default
561 the saveenv option is not provided in SPL, but some boards need
562 this support in 'Falcon' boot, where SPL need to boot from
563 different images based on environment variable set by OS. For
564 example OS may set "reboot_image" environment variable to
565 "recovery" inorder to boot recovery image by SPL. The SPL read
566 "reboot_image" and act accordingly and change the reboot_image
Shyam Saini919d25c2018-06-07 19:47:19 +0530567 to default mode using setenv and save the environment.
B, Ravid2d9bdf2016-09-28 14:46:18 +0530568
Simon Glass11bde1c2016-09-13 07:05:23 -0600569config SPL_ETH_SUPPORT
570 bool "Support Ethernet"
571 depends on SPL_ENV_SUPPORT
572 help
573 Enable access to the network subsystem and associated Ethernet
574 drivers in SPL. This permits SPL to load U-Boot over an Ethernet
575 link rather than from an on-board peripheral. Environment support
576 is required since the network stack uses a number of environment
577 variables. See also SPL_NET_SUPPORT.
578
Tien Fong Cheef4b40922019-01-23 14:20:05 +0800579config SPL_FS_EXT4
Simon Glass11bde1c2016-09-13 07:05:23 -0600580 bool "Support EXT filesystems"
Simon Glass11bde1c2016-09-13 07:05:23 -0600581 help
582 Enable support for EXT2/3/4 filesystems with SPL. This permits
583 U-Boot (or Linux in Falcon mode) to be loaded from an EXT
584 filesystem from within SPL. Support for the underlying block
585 device (e.g. MMC or USB) must be enabled separately.
586
Joao Marcos Costac5100612020-07-30 15:33:47 +0200587config SPL_FS_SQUASHFS
588 bool "Support SquashFS filesystems"
589 select FS_SQUASHFS
590 help
591 Enable support for SquashFS filesystems with SPL. This permits
592 U-Boot (or Linux in Falcon mode) to be loaded from a SquashFS
593 filesystem from within SPL. Support for the underlying block
594 device (e.g. MMC or USB) must be enabled separately.
595
Tien Fong Chee0c3a9ed2019-01-23 14:20:03 +0800596config SPL_FS_FAT
Simon Glass11bde1c2016-09-13 07:05:23 -0600597 bool "Support FAT filesystems"
Sekhar Norieedfb892017-06-02 17:53:59 +0530598 select FS_FAT
Simon Glass11bde1c2016-09-13 07:05:23 -0600599 help
600 Enable support for FAT and VFAT filesystems with SPL. This
601 permits U-Boot (or Linux in Falcon mode) to be loaded from a FAT
602 filesystem from within SPL. Support for the underlying block
603 device (e.g. MMC or USB) must be enabled separately.
604
Tien Fong Cheed8c3ea92019-01-23 14:20:04 +0800605config SPL_FAT_WRITE
606 bool "Support write for FAT filesystems"
607 help
608 Enable write support for FAT and VFAT filesystems with SPL.
609 Support for the underlying block device (e.g. MMC or USB) must be
610 enabled separately.
611
Michal Simek29bd8ad2020-09-09 14:41:56 +0200612config SPL_FPGA
Simon Glass11bde1c2016-09-13 07:05:23 -0600613 bool "Support FPGAs"
Simon Glass11bde1c2016-09-13 07:05:23 -0600614 help
615 Enable support for FPGAs in SPL. Field-programmable Gate Arrays
616 provide software-configurable hardware which is typically used to
617 implement peripherals (such as UARTs, LCD displays, MMC) or
618 accelerate custom processing functions, such as image processing
619 or machine learning. Sometimes it is useful to program the FPGA
620 as early as possible during boot, and this option can enable that
621 within SPL.
622
623config SPL_GPIO_SUPPORT
Simon Glass2d424eb2018-11-15 18:43:55 -0700624 bool "Support GPIO in SPL"
Simon Glass11bde1c2016-09-13 07:05:23 -0600625 help
626 Enable support for GPIOs (General-purpose Input/Output) in SPL.
627 GPIOs allow U-Boot to read the state of an input line (high or
628 low) and set the state of an output line. This can be used to
629 drive LEDs, control power to various system parts and read user
630 input. GPIOs can be useful in SPL to enable a 'sign-of-life' LED,
631 for example. Enable this option to build the drivers in
632 drivers/gpio as part of an SPL build.
633
634config SPL_I2C_SUPPORT
635 bool "Support I2C"
Simon Glass11bde1c2016-09-13 07:05:23 -0600636 help
637 Enable support for the I2C (Inter-Integrated Circuit) bus in SPL.
638 I2C works with a clock and data line which can be driven by a
639 one or more masters or slaves. It is a fairly complex bus but is
640 widely used as it only needs two lines for communication. Speeds of
641 400kbps are typical but up to 3.4Mbps is supported by some
642 hardware. I2C can be useful in SPL to configure power management
643 ICs (PMICs) before raising the CPU clock speed, for example.
644 Enable this option to build the drivers in drivers/i2c as part of
645 an SPL build.
646
647config SPL_LIBCOMMON_SUPPORT
648 bool "Support common libraries"
Simon Glass11bde1c2016-09-13 07:05:23 -0600649 help
650 Enable support for common U-Boot libraries within SPL. These
651 libraries include common code to deal with U-Boot images,
652 environment and USB, for example. This option is enabled on many
653 boards. Enable this option to build the code in common/ as part of
654 an SPL build.
655
656config SPL_LIBDISK_SUPPORT
Simon Goldschmidt00416702018-08-16 09:44:55 +0200657 bool "Support disk partitions"
Tom Rini91ff6862018-12-05 08:23:38 -0500658 select PARTITIONS
Simon Glass11bde1c2016-09-13 07:05:23 -0600659 help
660 Enable support for disk partitions within SPL. 'Disk' is something
661 of a misnomer as it includes non-spinning media such as flash (as
662 used in MMC and USB sticks). Partitions provide a way for a disk
663 to be split up into separate regions, with a partition table placed
664 at the start or end which describes the location and size of each
665 'partition'. These partitions are typically uses as individual block
666 devices, typically with an EXT2 or FAT filesystem in each. This
667 option enables whatever partition support has been enabled in
668 U-Boot to also be used in SPL. It brings in the code in disk/.
669
670config SPL_LIBGENERIC_SUPPORT
671 bool "Support generic libraries"
Simon Glass11bde1c2016-09-13 07:05:23 -0600672 help
673 Enable support for generic U-Boot libraries within SPL. These
674 libraries include generic code to deal with device tree, hashing,
675 printf(), compression and the like. This option is enabled on many
676 boards. Enable this option to build the code in lib/ as part of an
677 SPL build.
678
Lokesh Vutla88027412018-08-27 15:57:49 +0530679config SPL_DM_MAILBOX
680 bool "Support Mailbox"
681 help
682 Enable support for Mailbox within SPL. This enable the inter
683 processor communication protocols tobe used within SPL. Enable
684 this option to build the drivers in drivers/mailbox as part of
685 SPL build.
686
Simon Glass11bde1c2016-09-13 07:05:23 -0600687config SPL_MMC_SUPPORT
688 bool "Support MMC"
Tom Rini226498b2017-05-22 19:21:57 +0000689 depends on MMC
Tom Rini91ff6862018-12-05 08:23:38 -0500690 select HAVE_BLOCK_DEVICE
Simon Glass11bde1c2016-09-13 07:05:23 -0600691 help
692 Enable support for MMC (Multimedia Card) within SPL. This enables
693 the MMC protocol implementation and allows any enabled drivers to
694 be used within SPL. MMC can be used with or without disk partition
695 support depending on the application (SPL_LIBDISK_SUPPORT). Enable
696 this option to build the drivers in drivers/mmc as part of an SPL
697 build.
698
Adam Fordacc415a2020-07-03 10:17:30 -0500699config SYS_MMCSD_FS_BOOT_PARTITION
700 int "MMC Boot Partition"
701 default 1
702 help
703 Partition on the MMC to load U-Boot from when the MMC is being
704 used in fs mode
705
Ezequiel Garciabf7c01d2019-05-25 19:25:21 -0300706config SPL_MMC_TINY
707 bool "Tiny MMC framework in SPL"
708 depends on SPL_MMC_SUPPORT
709 default n
710 help
711 Enable MMC framework tinification support. This option is useful if
712 if your SPL is extremely size constrained. Heed the warning, enable
713 this option if and only if you know exactly what you are doing, if
714 you are reading this help text, you most likely have no idea :-)
715
716 The MMC framework is reduced to bare minimum to be useful. No malloc
717 support is needed for the MMC framework operation with this option
718 enabled. The framework supports exactly one MMC device and exactly
719 one MMC driver. The MMC driver can be adjusted to avoid any malloc
720 operations too, which can remove the need for malloc support in SPL
721 and thus further reduce footprint.
722
Jean-Jacques Hiblotd6400c32018-01-04 15:23:32 +0100723config SPL_MMC_WRITE
724 bool "MMC/SD/SDIO card support for write operations in SPL"
725 depends on SPL_MMC_SUPPORT
726 default n
727 help
728 Enable write access to MMC and SD Cards in SPL
729
730
Simon Glass11bde1c2016-09-13 07:05:23 -0600731config SPL_MPC8XXX_INIT_DDR_SUPPORT
732 bool "Support MPC8XXX DDR init"
Simon Glass11bde1c2016-09-13 07:05:23 -0600733 help
734 Enable support for DDR-SDRAM (double-data-rate synchronous dynamic
735 random-access memory) on the MPC8XXX family within SPL. This
736 allows DRAM to be set up before loading U-Boot into that DRAM,
737 where it can run.
738
739config SPL_MTD_SUPPORT
740 bool "Support MTD drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -0600741 help
742 Enable support for MTD (Memory Technology Device) within SPL. MTD
743 provides a block interface over raw NAND and can also be used with
744 SPI flash. This allows SPL to load U-Boot from supported MTD
745 devices. See SPL_NAND_SUPPORT and SPL_ONENAND_SUPPORT for how
746 to enable specific MTD drivers.
747
748config SPL_MUSB_NEW_SUPPORT
749 bool "Support new Mentor Graphics USB"
Simon Glass11bde1c2016-09-13 07:05:23 -0600750 help
751 Enable support for Mentor Graphics USB in SPL. This is a new
752 driver used by some boards. Enable this option to build
753 the drivers in drivers/usb/musb-new as part of an SPL build. The
754 old drivers are in drivers/usb/musb.
755
756config SPL_NAND_SUPPORT
757 bool "Support NAND flash"
Simon Glass11bde1c2016-09-13 07:05:23 -0600758 help
759 Enable support for NAND (Negative AND) flash in SPL. NAND flash
760 can be used to allow SPL to load U-Boot from supported devices.
Miquel Raynala430fa02018-08-16 17:30:07 +0200761 This enables the drivers in drivers/mtd/nand/raw as part of an SPL
Simon Glass11bde1c2016-09-13 07:05:23 -0600762 build.
763
Adam Ford0c4a6342020-07-03 08:09:44 -0500764config SPL_NAND_DRIVERS
765 bool "Use standard NAND driver"
766 help
767 SPL uses normal NAND drivers, not minimal drivers.
768
769config SPL_NAND_ECC
770 bool "Include standard software ECC in the SPL"
771
772config SPL_NAND_SIMPLE
773 bool "Support simple NAND drivers in SPL"
774 help
775 Support for NAND boot using simple NAND drivers that
776 expose the cmd_ctrl() interface.
777
Adam Ford38791062020-07-03 08:09:45 -0500778config SPL_NAND_BASE
779 depends on SPL_NAND_DRIVERS
780 bool "Use Base NAND Driver"
781 help
782 Include nand_base.c in the SPL.
783
784config SPL_NAND_IDENT
785 depends on SPL_NAND_BASE
786 bool "Use chip ID to identify NAND flash"
787 help
788 SPL uses the chip ID list to identify the NAND flash.
789
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200790config SPL_UBI
791 bool "Support UBI"
792 help
793 Enable support for loading payloads from UBI. See
794 README.ubispl for more info.
795
Lukasz Majewskif18845c2019-09-09 12:06:46 +0200796if SPL_DM
Ley Foon Tan5c9c71b2019-10-11 13:48:33 +0800797config SPL_CACHE
798 depends on CACHE
799 bool "Support cache drivers in SPL"
800 help
801 Enable support for cache drivers in SPL.
802
Lukasz Majewskif18845c2019-09-09 12:06:46 +0200803config SPL_DM_SPI
804 bool "Support SPI DM drivers in SPL"
805 help
806 Enable support for SPI DM drivers in SPL.
807
Lukasz Majewski56c40462020-06-04 23:11:53 +0800808config SPL_DM_SPI_FLASH
809 bool "Support SPI DM FLASH drivers in SPL"
810 help
811 Enable support for SPI DM flash drivers in SPL.
812
Lukasz Majewskif18845c2019-09-09 12:06:46 +0200813endif
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200814if SPL_UBI
Hamish Guthrie6ea31cc2019-05-15 15:15:59 +0200815config SPL_UBI_LOAD_BY_VOLNAME
816 bool "Support loading volumes by name"
817 help
818 This enables support for loading UBI volumes by name. When this
819 is set, CONFIG_SPL_UBI_LOAD_MONITOR_VOLNAME can be used to
820 configure the volume name from which to load U-Boot.
821
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200822config SPL_UBI_MAX_VOL_LEBS
823 int "Maximum number of LEBs per volume"
824 depends on SPL_UBI
825 help
826 The maximum number of logical eraseblocks which a static volume
827 to load can contain. Used for sizing the scan data structure.
828
829config SPL_UBI_MAX_PEB_SIZE
830 int "Maximum PEB size"
831 depends on SPL_UBI
832 help
833 The maximum physical erase block size.
834
835config SPL_UBI_MAX_PEBS
836 int "Maximum number of PEBs"
837 depends on SPL_UBI
838 help
839 The maximum physical erase block size. If not overridden by
840 board code, this value will be used as the actual number of PEBs.
841
842config SPL_UBI_PEB_OFFSET
843 int "Offset to first UBI PEB"
844 depends on SPL_UBI
845 help
846 The offset in number of PEBs from the start of flash to the first
847 PEB part of the UBI image.
848
849config SPL_UBI_VID_OFFSET
850 int "Offset to VID header"
851 depends on SPL_UBI
852
853config SPL_UBI_LEB_START
854 int "Offset to LEB in PEB"
855 depends on SPL_UBI
856 help
857 The offset in bytes to the LEB within a PEB.
858
859config SPL_UBI_INFO_ADDR
860 hex "Address to place UBI scan info"
861 depends on SPL_UBI
862 help
863 Address for ubispl to place the scan info. Read README.ubispl to
864 determine the required size
865
866config SPL_UBI_VOL_IDS
867 int "Maximum volume id"
868 depends on SPL_UBI
869 help
870 The maximum volume id which can be loaded. Used for sizing the
871 scan data structure.
872
873config SPL_UBI_LOAD_MONITOR_ID
874 int "id of U-Boot volume"
875 depends on SPL_UBI
876 help
877 The UBI volume id from which to load U-Boot
878
Hamish Guthrie6ea31cc2019-05-15 15:15:59 +0200879config SPL_UBI_LOAD_MONITOR_VOLNAME
880 string "volume name of U-Boot volume"
881 depends on SPL_UBI_LOAD_BY_VOLNAME
882 help
883 The UBI volume name from which to load U-Boot
884
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200885config SPL_UBI_LOAD_KERNEL_ID
886 int "id of kernel volume"
887 depends on SPL_OS_BOOT && SPL_UBI
888 help
889 The UBI volume id from which to load the kernel
890
891config SPL_UBI_LOAD_ARGS_ID
892 int "id of kernel args volume"
893 depends on SPL_OS_BOOT && SPL_UBI
894 help
895 The UBI volume id from which to load the device tree
896
Markus Klotzbuechera2257d32019-05-15 15:16:00 +0200897config UBI_SPL_SILENCE_MSG
898 bool "silence UBI SPL messages"
899 default n
900 help
901 Disable messages from UBI SPL. This leaves warnings
902 and errors enabled.
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200903
904endif # if SPL_UBI
905
Simon Glass11bde1c2016-09-13 07:05:23 -0600906config SPL_NET_SUPPORT
907 bool "Support networking"
Simon Glass11bde1c2016-09-13 07:05:23 -0600908 help
909 Enable support for network devices (such as Ethernet) in SPL.
910 This permits SPL to load U-Boot over a network link rather than
911 from an on-board peripheral. Environment support is required since
912 the network stack uses a number of environment variables. See also
913 SPL_ETH_SUPPORT.
914
915if SPL_NET_SUPPORT
916config SPL_NET_VCI_STRING
917 string "BOOTP Vendor Class Identifier string sent by SPL"
918 help
919 As defined by RFC 2132 the vendor class identifier field can be
920 sent by the client to identify the vendor type and configuration
921 of a client. This is often used in practice to allow for the DHCP
922 server to specify different files to load depending on if the ROM,
923 SPL or U-Boot itself makes the request
924endif # if SPL_NET_SUPPORT
925
926config SPL_NO_CPU_SUPPORT
927 bool "Drop CPU code in SPL"
Simon Glass11bde1c2016-09-13 07:05:23 -0600928 help
929 This is specific to the ARM926EJ-S CPU. It disables the standard
930 start.S start-up code, presumably so that a replacement can be
931 used on that CPU. You should not enable it unless you know what
932 you are doing.
933
934config SPL_NOR_SUPPORT
935 bool "Support NOR flash"
Simon Glass11bde1c2016-09-13 07:05:23 -0600936 help
937 Enable support for loading U-Boot from memory-mapped NOR (Negative
938 OR) flash in SPL. NOR flash is slow to write but fast to read, and
939 a memory-mapped device makes it very easy to access. Loading from
940 NOR is typically achieved with just a memcpy().
941
Vikas Manochac6d9e9d2017-05-28 12:55:11 -0700942config SPL_XIP_SUPPORT
943 bool "Support XIP"
944 depends on SPL
945 help
946 Enable support for execute in place of U-Boot or kernel image. There
947 is no need to copy image from flash to ram if flash supports execute
948 in place. Its very useful in systems having enough flash but not
949 enough ram to load the image.
950
Simon Glass11bde1c2016-09-13 07:05:23 -0600951config SPL_ONENAND_SUPPORT
952 bool "Support OneNAND flash"
Simon Glass11bde1c2016-09-13 07:05:23 -0600953 help
954 Enable support for OneNAND (Negative AND) flash in SPL. OneNAND is
955 a type of NAND flash and therefore can be used to allow SPL to
956 load U-Boot from supported devices. This enables the drivers in
957 drivers/mtd/onenand as part of an SPL build.
958
Heiko Schocherc20ae2f2016-10-06 07:55:15 +0200959config SPL_OS_BOOT
960 bool "Activate Falcon Mode"
Tom Rini226498b2017-05-22 19:21:57 +0000961 depends on !TI_SECURE_DEVICE
Heiko Schocherc20ae2f2016-10-06 07:55:15 +0200962 default n
963 help
964 Enable booting directly to an OS from SPL.
965 for more info read doc/README.falcon
966
Heiko Schocher29d3bc72016-10-06 07:55:16 +0200967if SPL_OS_BOOT
968config SYS_OS_BASE
969 hex "addr, where OS is found"
Tom Rini226498b2017-05-22 19:21:57 +0000970 depends on SPL_NOR_SUPPORT
Heiko Schocher29d3bc72016-10-06 07:55:16 +0200971 help
972 Specify the address, where the OS image is found, which
973 gets booted.
974
975endif # SPL_OS_BOOT
976
York Sun7550dbe2018-06-14 14:38:48 -0700977config SPL_PAYLOAD
978 string "SPL payload"
979 default "tpl/u-boot-with-tpl.bin" if TPL
980 default "u-boot.bin"
981 help
Chris Packham2dcfa052019-01-13 22:13:20 +1300982 Payload for SPL boot. For backward compatibility, default to
York Sun7550dbe2018-06-14 14:38:48 -0700983 u-boot.bin, i.e. RAW image without any header. In case of
984 TPL, tpl/u-boot-with-tpl.bin. For new boards, suggest to
985 use u-boot.img.
986
Sekhar Norid50d6812018-12-06 15:40:08 +0530987config SPL_PCI
Simon Glass2446b6b2017-01-16 07:03:30 -0700988 bool "Support PCI drivers"
Simon Glass2446b6b2017-01-16 07:03:30 -0700989 help
990 Enable support for PCI in SPL. For platforms that need PCI to boot,
991 or must perform some init using PCI in SPL, this provides the
992 necessary driver support. This enables the drivers in drivers/pci
993 as part of an SPL build.
994
Simon Glassbbe41ab2017-01-16 07:03:33 -0700995config SPL_PCH_SUPPORT
996 bool "Support PCH drivers"
Simon Glassbbe41ab2017-01-16 07:03:33 -0700997 help
998 Enable support for PCH (Platform Controller Hub) devices in SPL.
999 These are used to set up GPIOs and the SPI peripheral early in
1000 boot. This enables the drivers in drivers/pch as part of an SPL
1001 build.
1002
Simon Glass11bde1c2016-09-13 07:05:23 -06001003config SPL_POST_MEM_SUPPORT
1004 bool "Support POST drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -06001005 help
1006 Enable support for POST (Power-on Self Test) in SPL. POST is a
1007 procedure that checks that the hardware (CPU or board) appears to
1008 be functionally correctly. It is a sanity check that can be
1009 performed before booting. This enables the drivers in post/drivers
1010 as part of an SPL build.
1011
Ley Foon Tanbfc6bae2018-06-14 18:45:19 +08001012config SPL_DM_RESET
Patrick Delaunay0e373c02018-03-12 10:46:05 +01001013 bool "Support reset drivers"
1014 depends on SPL
1015 help
1016 Enable support for reset control in SPL.
1017 That can be useful in SPL to handle IP reset in driver, as in U-Boot,
1018 by using the generic reset API provided by driver model.
1019 This enables the drivers in drivers/reset as part of an SPL build.
1020
Simon Glass11bde1c2016-09-13 07:05:23 -06001021config SPL_POWER_SUPPORT
1022 bool "Support power drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -06001023 help
1024 Enable support for power control in SPL. This includes support
1025 for PMICs (Power-management Integrated Circuits) and some of the
1026 features provided by PMICs. In particular, voltage regulators can
1027 be used to enable/disable power and vary its voltage. That can be
1028 useful in SPL to turn on boot peripherals and adjust CPU voltage
1029 so that the clock speed can be increased. This enables the drivers
1030 in drivers/power, drivers/power/pmic and drivers/power/regulator
1031 as part of an SPL build.
1032
Peng Fane13278c2018-07-27 10:20:37 +08001033config SPL_POWER_DOMAIN
1034 bool "Support power domain drivers"
1035 help
1036 Enable support for power domain control in SPL. Many SoCs allow
1037 power to be applied to or removed from portions of the SoC (power
1038 domains). This may be used to save power. This API provides the
1039 means to control such power management hardware. This enables
1040 the drivers in drivers/power/domain as part of a SPL build.
1041
Stefan Agner22802f42016-12-23 07:51:53 +01001042config SPL_RAM_SUPPORT
1043 bool "Support booting from RAM"
Trevor Woerner18138ab2020-05-06 08:02:41 -04001044 default y if MICROBLAZE || ARCH_SOCFPGA || ARCH_TEGRA || ARCH_ZYNQ
Stefan Agner22802f42016-12-23 07:51:53 +01001045 help
1046 Enable booting of an image in RAM. The image can be preloaded or
1047 it can be loaded by SPL directly into RAM (e.g. using USB).
1048
Stefan Agnerf417d402016-12-23 07:51:52 +01001049config SPL_RAM_DEVICE
1050 bool "Support booting from preloaded image in RAM"
Stefan Agner22802f42016-12-23 07:51:53 +01001051 depends on SPL_RAM_SUPPORT
Trevor Woerner18138ab2020-05-06 08:02:41 -04001052 default y if MICROBLAZE || ARCH_SOCFPGA || ARCH_TEGRA || ARCH_ZYNQ
Stefan Agnerf417d402016-12-23 07:51:52 +01001053 help
1054 Enable booting of an image already loaded in RAM. The image has to
1055 be already in memory when SPL takes over, e.g. loaded by the boot
1056 ROM.
1057
Lokesh Vutla08c45312018-08-27 15:57:53 +05301058config SPL_REMOTEPROC
1059 bool "Support REMOTEPROCS"
1060 help
1061 Enable support for REMOTEPROCs in SPL. This permits to load
1062 a remote processor firmware in SPL.
1063
Simon Glass30bf8a02017-01-16 07:03:31 -07001064config SPL_RTC_SUPPORT
1065 bool "Support RTC drivers"
Simon Glass30bf8a02017-01-16 07:03:31 -07001066 help
1067 Enable RTC (Real-time Clock) support in SPL. This includes support
1068 for reading and setting the time. Some RTC devices also have some
1069 non-volatile (battery-backed) memory which is accessible if
1070 needed. This enables the drivers in drivers/rtc as part of an SPL
1071 build.
1072
Simon Glass11bde1c2016-09-13 07:05:23 -06001073config SPL_SATA_SUPPORT
1074 bool "Support loading from SATA"
Simon Glass11bde1c2016-09-13 07:05:23 -06001075 help
1076 Enable support for SATA (Serial AT attachment) in SPL. This allows
1077 use of SATA devices such as hard drives and flash drivers for
1078 loading U-Boot. SATA is used in higher-end embedded systems and
1079 can provide higher performance than MMC , at somewhat higher
1080 expense and power consumption. This enables loading from SATA
1081 using a configured device.
1082
Baruch Siach60ca9692019-07-14 17:54:21 +03001083config SPL_SATA_RAW_U_BOOT_USE_SECTOR
1084 bool "SATA raw mode: by sector"
1085 depends on SPL_SATA_SUPPORT
1086 help
1087 Use sector number for specifying U-Boot location on SATA disk in
1088 raw mode.
1089
1090config SPL_SATA_RAW_U_BOOT_SECTOR
1091 hex "Sector on the SATA disk to load U-Boot from"
1092 depends on SPL_SATA_RAW_U_BOOT_USE_SECTOR
1093 help
1094 Sector on the SATA disk to load U-Boot from, when the SATA disk is being
1095 used in raw mode. Units: SATA disk sectors (1 sector = 512 bytes).
1096
Simon Glass11bde1c2016-09-13 07:05:23 -06001097config SPL_SERIAL_SUPPORT
1098 bool "Support serial"
Alex Kiernan14ad44a2018-04-19 04:32:54 +00001099 select SPL_PRINTF
1100 select SPL_STRTO
Simon Glass11bde1c2016-09-13 07:05:23 -06001101 help
1102 Enable support for serial in SPL. This allows use of a serial UART
1103 for displaying messages while SPL is running. It also brings in
1104 printf() and panic() functions. This should normally be enabled
1105 unless there are space reasons not to. Even then, consider
Simon Glass27084c02019-09-25 08:56:27 -06001106 enabling SPL_USE_TINY_PRINTF which is a small printf() version.
Simon Glass11bde1c2016-09-13 07:05:23 -06001107
Simon Goldschmidtd024e992019-10-25 16:22:09 +02001108config SPL_SPI_SUPPORT
1109 bool "Support SPI drivers"
1110 help
1111 Enable support for using SPI in SPL. This is used for connecting
1112 to SPI flash for loading U-Boot. See SPL_SPI_FLASH_SUPPORT for
1113 more details on that. The SPI driver provides the transport for
1114 data between the SPI flash and the CPU. This option can be used to
1115 enable SPI drivers that are needed for other purposes also, such
1116 as a SPI PMIC.
1117
Simon Glass11bde1c2016-09-13 07:05:23 -06001118config SPL_SPI_FLASH_SUPPORT
1119 bool "Support SPI flash drivers"
Simon Goldschmidtd024e992019-10-25 16:22:09 +02001120 depends on SPL_SPI_SUPPORT
Simon Glass11bde1c2016-09-13 07:05:23 -06001121 help
1122 Enable support for using SPI flash in SPL, and loading U-Boot from
1123 SPI flash. SPI flash (Serial Peripheral Bus flash) is named after
1124 the SPI bus that is used to connect it to a system. It is a simple
1125 but fast bidirectional 4-wire bus (clock, chip select and two data
1126 lines). This enables the drivers in drivers/mtd/spi as part of an
1127 SPL build. This normally requires SPL_SPI_SUPPORT.
1128
Vignesh R0c6f1872019-02-05 11:29:20 +05301129if SPL_SPI_FLASH_SUPPORT
1130
Vignesh R778572d2019-02-05 11:29:25 +05301131config SPL_SPI_FLASH_TINY
1132 bool "Enable low footprint SPL SPI Flash support"
1133 depends on !SPI_FLASH_BAR
Vignesh R72875972019-02-05 11:29:26 +05301134 default y if SPI_FLASH
Vignesh R778572d2019-02-05 11:29:25 +05301135 help
1136 Enable lightweight SPL SPI Flash support that supports just reading
1137 data/images from flash. No support to write/erase flash. Enable
1138 this if you have SPL size limitations and don't need full
1139 fledged SPI flash support.
1140
Vignesh R0c6f1872019-02-05 11:29:20 +05301141config SPL_SPI_FLASH_SFDP_SUPPORT
1142 bool "SFDP table parsing support for SPI NOR flashes"
Vignesh R778572d2019-02-05 11:29:25 +05301143 depends on !SPI_FLASH_BAR && !SPL_SPI_FLASH_TINY
Vignesh R0c6f1872019-02-05 11:29:20 +05301144 help
1145 Enable support for parsing and auto discovery of parameters for
1146 SPI NOR flashes using Serial Flash Discoverable Parameters (SFDP)
1147 tables as per JESD216 standard in SPL.
1148
Lukasz Majewski56c40462020-06-04 23:11:53 +08001149config SPL_SPI_FLASH_MTD
1150 bool "Support for SPI flash MTD drivers in SPL"
1151 help
1152 Enable support for SPI flash MTD drivers in SPL.
1153
Marek Vasut55500432018-04-07 16:05:27 +02001154config SPL_SPI_LOAD
1155 bool "Support loading from SPI flash"
Marek Vasut55500432018-04-07 16:05:27 +02001156 help
1157 Enable support for loading next stage, U-Boot or otherwise, from
1158 SPI NOR in U-Boot SPL.
1159
Vignesh R0c6f1872019-02-05 11:29:20 +05301160endif # SPL_SPI_FLASH_SUPPORT
1161
Hannes Schmelzer1ee774d2019-08-22 15:41:46 +02001162config SYS_SPI_U_BOOT_OFFS
1163 hex "address of u-boot payload in SPI flash"
Andre Przywara671d64f2020-01-06 01:29:10 +00001164 default 0x8000 if ARCH_SUNXI
Hannes Schmelzer1ee774d2019-08-22 15:41:46 +02001165 default 0x0
1166 depends on SPL_SPI_LOAD || SPL_SPI_SUNXI
1167 help
1168 Address within SPI-Flash from where the u-boot payload is fetched
1169 from.
1170
Faiz Abbas8502f9f2017-11-14 16:12:31 +05301171config SPL_THERMAL
1172 bool "Driver support for thermal devices"
1173 help
1174 Enable support for temperature-sensing devices. Some SoCs have on-chip
1175 temperature sensors to permit warnings, speed throttling or even
1176 automatic power-off when the temperature gets too high or low. Other
1177 devices may be discrete but connected on a suitable bus.
1178
Simon Glass11bde1c2016-09-13 07:05:23 -06001179config SPL_USB_HOST_SUPPORT
1180 bool "Support USB host drivers"
Tom Rini91ff6862018-12-05 08:23:38 -05001181 select HAVE_BLOCK_DEVICE
Simon Glass11bde1c2016-09-13 07:05:23 -06001182 help
1183 Enable access to USB (Universal Serial Bus) host devices so that
1184 SPL can load U-Boot from a connected USB peripheral, such as a USB
1185 flash stick. While USB takes a little longer to start up than most
1186 buses, it is very flexible since many different types of storage
1187 device can be attached. This option enables the drivers in
1188 drivers/usb/host as part of an SPL build.
1189
Abel Vesa79536012019-02-01 16:40:07 +00001190config SPL_USB_STORAGE
Simon Glass11bde1c2016-09-13 07:05:23 -06001191 bool "Support loading from USB"
Abel Vesa79536012019-02-01 16:40:07 +00001192 depends on SPL_USB_HOST_SUPPORT && !(BLK && !DM_USB)
Simon Glass11bde1c2016-09-13 07:05:23 -06001193 help
1194 Enable support for USB devices in SPL. This allows use of USB
1195 devices such as hard drives and flash drivers for loading U-Boot.
1196 The actual drivers are enabled separately using the normal U-Boot
1197 config options. This enables loading from USB using a configured
1198 device.
1199
Jean-Jacques Hiblotf811e972019-01-10 15:44:13 +01001200config SPL_USB_GADGET
Stefan Agnere94793c2016-11-21 10:58:53 -08001201 bool "Suppport USB Gadget drivers"
Stefan Agnere94793c2016-11-21 10:58:53 -08001202 help
1203 Enable USB Gadget API which allows to enable USB device functions
1204 in SPL.
1205
Jean-Jacques Hiblotf811e972019-01-10 15:44:13 +01001206if SPL_USB_GADGET
Stefan Agnere94793c2016-11-21 10:58:53 -08001207
Faiz Abbasb432b1e2018-02-16 21:17:44 +05301208config SPL_USB_ETHER
Stefan Agnere94793c2016-11-21 10:58:53 -08001209 bool "Support USB Ethernet drivers"
1210 help
1211 Enable access to the USB network subsystem and associated
1212 drivers in SPL. This permits SPL to load U-Boot over a
1213 USB-connected Ethernet link (such as a USB Ethernet dongle) rather
1214 than from an onboard peripheral. Environment support is required
1215 since the network stack uses a number of environment variables.
1216 See also SPL_NET_SUPPORT and SPL_ETH_SUPPORT.
1217
Andrew F. Davis6536ca42019-01-17 13:43:02 -06001218config SPL_DFU
Fabio Estevamc3c19c22018-08-31 10:02:28 -03001219 bool "Support DFU (Device Firmware Upgrade)"
Stefan Agner59917032016-11-21 10:58:52 -08001220 select SPL_HASH_SUPPORT
B, Ravi66928af2017-05-04 15:45:29 +05301221 select SPL_DFU_NO_RESET
B, Ravi1b19cbd2017-05-04 15:45:28 +05301222 depends on SPL_RAM_SUPPORT
Stefan Agner59917032016-11-21 10:58:52 -08001223 help
Fabio Estevamc3c19c22018-08-31 10:02:28 -03001224 This feature enables the DFU (Device Firmware Upgrade) in SPL with
Stefan Agner59917032016-11-21 10:58:52 -08001225 RAM memory device support. The ROM code will load and execute
1226 the SPL built with dfu. The user can load binaries (u-boot/kernel) to
1227 selected device partition from host-pc using dfu-utils.
1228 This feature is useful to flash the binaries to factory or bare-metal
1229 boards using USB interface.
1230
1231choice
1232 bool "DFU device selection"
Andrew F. Davis6536ca42019-01-17 13:43:02 -06001233 depends on SPL_DFU
Stefan Agner59917032016-11-21 10:58:52 -08001234
1235config SPL_DFU_RAM
1236 bool "RAM device"
Andrew F. Davis6536ca42019-01-17 13:43:02 -06001237 depends on SPL_DFU && SPL_RAM_SUPPORT
Stefan Agner59917032016-11-21 10:58:52 -08001238 help
1239 select RAM/DDR memory device for loading binary images
1240 (u-boot/kernel) to the selected device partition using
1241 DFU and execute the u-boot/kernel from RAM.
1242
1243endchoice
1244
Stefan Agnera3774c12017-08-16 11:00:54 -07001245config SPL_USB_SDP_SUPPORT
1246 bool "Support SDP (Serial Download Protocol)"
Otavio Salvadord74fcee2020-09-29 23:14:29 -03001247 depends on SPL_SERIAL_SUPPORT
Stefan Agnera3774c12017-08-16 11:00:54 -07001248 help
1249 Enable Serial Download Protocol (SDP) device support in SPL. This
1250 allows to download images into memory and execute (jump to) them
1251 using the same protocol as implemented by the i.MX family's boot ROM.
Ye Li407e3842020-04-29 10:35:12 +08001252
1253config SPL_SDP_USB_DEV
1254 int "SDP USB controller index"
1255 default 0
1256 depends on SPL_USB_SDP_SUPPORT
1257 help
1258 Some boards have USB controller other than 0. Define this option
1259 so it can be used in compiled environment.
Stefan Agnere94793c2016-11-21 10:58:53 -08001260endif
1261
Simon Glass11bde1c2016-09-13 07:05:23 -06001262config SPL_WATCHDOG_SUPPORT
1263 bool "Support watchdog drivers"
Marek Vasut6874cb72019-06-09 03:46:21 +02001264 imply SPL_WDT if !HW_WATCHDOG
Simon Glass11bde1c2016-09-13 07:05:23 -06001265 help
1266 Enable support for watchdog drivers in SPL. A watchdog is
1267 typically a hardware peripheral which can reset the system when it
1268 detects no activity for a while (such as a software crash). This
1269 enables the drivers in drivers/watchdog as part of an SPL build.
1270
1271config SPL_YMODEM_SUPPORT
1272 bool "Support loading using Ymodem"
Alex Kiernan3bac19c2018-04-19 04:32:52 +00001273 depends on SPL_SERIAL_SUPPORT
Simon Glass11bde1c2016-09-13 07:05:23 -06001274 help
1275 While loading from serial is slow it can be a useful backup when
1276 there is no other option. The Ymodem protocol provides a reliable
1277 means of transmitting U-Boot over a serial line for using in SPL,
1278 with a checksum to ensure correctness.
1279
Philipp Tomsichaa122f62017-09-13 21:29:36 +02001280config SPL_ATF
Kever Yangbcc17262017-05-05 11:47:45 +08001281 bool "Support ARM Trusted Firmware"
Michal Simek975bacc2020-09-03 11:23:39 +02001282 depends on ARM64 && SPL_FIT
Kever Yangbcc17262017-05-05 11:47:45 +08001283 help
Philipp Tomsichd21fb632018-01-02 21:16:43 +01001284 ATF(ARM Trusted Firmware) is a component for ARM AArch64 which
1285 is loaded by SPL (which is considered as BL2 in ATF terminology).
Kever Yangbcc17262017-05-05 11:47:45 +08001286 More detail at: https://github.com/ARM-software/arm-trusted-firmware
1287
Michael Walle7b866822020-11-18 17:45:58 +01001288config SPL_ATF_LOAD_IMAGE_V2
1289 bool "Use the new LOAD_IMAGE_V2 parameter passing"
1290 depends on SPL_ATF
1291 help
1292 Some platforms use the newer LOAD_IMAGE_V2 parameter passing.
1293
1294 If you want to load a bl31 image from the SPL and need the new
1295 method, say Y.
1296
Philipp Tomsichd21fb632018-01-02 21:16:43 +01001297config SPL_ATF_NO_PLATFORM_PARAM
1298 bool "Pass no platform parameter"
1299 depends on SPL_ATF
1300 help
1301 While we expect to call a pointer to a valid FDT (or NULL)
1302 as the platform parameter to an ATF, some ATF versions are
1303 not U-Boot aware and have an insufficiently robust parameter
1304 validation to gracefully reject a FDT being passed.
1305
1306 If this option is enabled, the spl_atf os-type handler will
1307 always pass NULL for the platform parameter.
1308
1309 If your ATF is affected, say Y.
1310
Alex Kiernan3bf5f132018-03-15 22:11:46 +00001311config SPL_AM33XX_ENABLE_RTC32K_OSC
1312 bool "Enable the RTC32K OSC on AM33xx based platforms"
1313 default y if AM33XX
1314 help
1315 Enable access to the AM33xx RTC and select the external 32kHz clock
1316 source.
1317
Kever Yang70fe2872018-08-23 17:17:59 +08001318config SPL_OPTEE
1319 bool "Support OP-TEE Trusted OS"
1320 depends on ARM
1321 help
1322 OP-TEE is an open source Trusted OS which is loaded by SPL.
1323 More detail at: https://github.com/OP-TEE/optee_os
1324
Lukas Auer5e30e452019-08-21 21:14:44 +02001325config SPL_OPENSBI
1326 bool "Support RISC-V OpenSBI"
1327 depends on RISCV && SPL_RISCV_MMODE && RISCV_SMODE
1328 help
1329 OpenSBI is an open-source implementation of the RISC-V Supervisor Binary
1330 Interface (SBI) specification. U-Boot supports the OpenSBI FW_DYNAMIC
1331 firmware. It is loaded and started by U-Boot SPL.
1332
1333 More details are available at https://github.com/riscv/opensbi and
1334 https://github.com/riscv/riscv-sbi-doc
1335
1336config SPL_OPENSBI_LOAD_ADDR
1337 hex "OpenSBI load address"
1338 depends on SPL_OPENSBI
1339 help
1340 Load address of the OpenSBI binary.
1341
Tom Rini226498b2017-05-22 19:21:57 +00001342config TPL
1343 bool
1344 depends on SUPPORT_TPL
1345 prompt "Enable TPL"
1346 help
1347 If you want to build TPL as well as the normal image and SPL, say Y.
1348
1349if TPL
1350
Simon Glassc52b5e82019-10-20 21:31:52 -06001351config TPL_SIZE_LIMIT
1352 hex "Maximum size of TPL image"
1353 depends on TPL
Ovidiu Panait2dfdd0c2020-09-25 21:12:56 +03001354 default 0x0
Simon Glassc52b5e82019-10-20 21:31:52 -06001355 help
1356 Specifies the maximum length of the U-Boot TPL image.
1357 If this value is zero, it is ignored.
1358
Heiko Stuebner22b7b862019-07-16 10:12:02 +02001359config TPL_FRAMEWORK
1360 bool "Support TPL based upon the common SPL framework"
1361 default y if SPL_FRAMEWORK
1362 help
1363 Enable the SPL framework under common/spl/ for TPL builds.
1364 This framework supports MMC, NAND and YMODEM and other methods
1365 loading of U-Boot's SPL stage. If unsure, say Y.
1366
Simon Glassb0edea32018-11-15 18:44:09 -07001367config TPL_HANDOFF
1368 bool "Pass hand-off information from TPL to SPL and U-Boot proper"
Simon Glassa7da3d92019-09-25 08:11:17 -06001369 depends on HANDOFF && TPL_BLOBLIST
Simon Glassb0edea32018-11-15 18:44:09 -07001370 default y
1371 help
1372 This option enables TPL to write handoff information. This can be
1373 used to pass information like the size of SDRAM from TPL to U-Boot
1374 proper. The information is also available to SPL if it is useful
1375 there.
1376
Kever Yangaf2f4422018-01-20 18:00:26 +08001377config TPL_BOARD_INIT
1378 bool "Call board-specific initialization in TPL"
1379 help
1380 If this option is enabled, U-Boot will call the function
1381 spl_board_init() from board_init_r(). This function should be
1382 provided by the board.
1383
Philipp Tomsichdd6fbcb2017-07-28 19:20:49 +02001384config TPL_LDSCRIPT
1385 string "Linker script for the TPL stage"
1386 depends on TPL
Tom Rini2f41ade2019-01-22 17:09:26 -05001387 default "arch/arm/cpu/armv8/u-boot-spl.lds" if ARM64
Tom Rinia356e7a2020-03-11 18:11:11 -04001388 default "arch/\$(ARCH)/cpu/u-boot-spl.lds"
Philipp Tomsichdd6fbcb2017-07-28 19:20:49 +02001389 help
1390 The TPL stage will usually require a different linker-script
1391 (as it runs from a different memory region) than the regular
1392 U-Boot stage. Set this to the path of the linker-script to
1393 be used for TPL.
1394
Philipp Tomsichb3ed6ce2017-07-28 20:02:34 +02001395 May be left empty to trigger the Makefile infrastructure to
1396 fall back to the linker-script used for the SPL stage.
1397
1398config TPL_NEEDS_SEPARATE_TEXT_BASE
1399 bool "TPL needs a separate text-base"
1400 default n
1401 depends on TPL
1402 help
1403 Enable, if the TPL stage should not inherit its text-base
1404 from the SPL stage. When enabled, a base address for the
1405 .text sections of the TPL stage has to be set below.
1406
1407config TPL_NEEDS_SEPARATE_STACK
1408 bool "TPL needs a separate initial stack-pointer"
1409 default n
1410 depends on TPL
1411 help
1412 Enable, if the TPL stage should not inherit its initial
1413 stack-pointer from the settings for the SPL stage.
1414
1415config TPL_TEXT_BASE
1416 hex "Base address for the .text section of the TPL stage"
1417 depends on TPL_NEEDS_SEPARATE_TEXT_BASE
1418 help
1419 The base address for the .text section of the TPL stage.
1420
1421config TPL_MAX_SIZE
1422 int "Maximum size (in bytes) for the TPL stage"
Philipp Tomsich5aa49af2017-07-28 20:20:41 +02001423 default 0
Philipp Tomsichb3ed6ce2017-07-28 20:02:34 +02001424 depends on TPL
1425 help
1426 The maximum size (in bytes) of the TPL stage.
1427
1428config TPL_STACK
1429 hex "Address of the initial stack-pointer for the TPL stage"
1430 depends on TPL_NEEDS_SEPARATE_STACK
1431 help
1432 The address of the initial stack-pointer for the TPL stage.
1433 Usually this will be the (aligned) top-of-stack.
1434
Philipp Tomsicha954fa32017-07-04 14:24:53 +02001435config TPL_BOOTROM_SUPPORT
1436 bool "Support returning to the BOOTROM (from TPL)"
1437 help
1438 Some platforms (e.g. the Rockchip RK3368) provide support in their
1439 ROM for loading the next boot-stage after performing basic setup
1440 from the TPL stage.
1441
1442 Enable this option, to return to the BOOTROM through the
1443 BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
1444 boot device list, if not implemented for a given board)
1445
Philipp Tomsichc3916e72017-07-04 14:27:02 +02001446config TPL_DRIVERS_MISC_SUPPORT
1447 bool "Support misc drivers in TPL"
1448 help
1449 Enable miscellaneous drivers in TPL. These drivers perform various
1450 tasks that don't fall nicely into other categories, Enable this
1451 option to build the drivers in drivers/misc as part of an TPL
1452 build, for those that support building in TPL (not all drivers do).
1453
Simon Glassf73329e2016-09-12 23:18:27 -06001454config TPL_ENV_SUPPORT
1455 bool "Support an environment"
Simon Glassf73329e2016-09-12 23:18:27 -06001456 help
1457 Enable environment support in TPL. See SPL_ENV_SUPPORT for details.
1458
Simon Glass2d424eb2018-11-15 18:43:55 -07001459config TPL_GPIO_SUPPORT
1460 bool "Support GPIO in TPL"
1461 help
1462 Enable support for GPIOs (General-purpose Input/Output) in TPL.
1463 GPIOs allow U-Boot to read the state of an input line (high or
1464 low) and set the state of an output line. This can be used to
1465 drive LEDs, control power to various system parts and read user
1466 input. GPIOs can be useful in TPL to enable a 'sign-of-life' LED,
1467 for example. Enable this option to build the drivers in
1468 drivers/gpio as part of an TPL build.
1469
Simon Glassf73329e2016-09-12 23:18:27 -06001470config TPL_I2C_SUPPORT
1471 bool "Support I2C"
Simon Glassf73329e2016-09-12 23:18:27 -06001472 help
Philipp Tomsich616bd092017-07-28 17:03:03 +02001473 Enable support for the I2C bus in TPL. See SPL_I2C_SUPPORT for
Simon Glassf73329e2016-09-12 23:18:27 -06001474 details.
1475
1476config TPL_LIBCOMMON_SUPPORT
1477 bool "Support common libraries"
Simon Glassf73329e2016-09-12 23:18:27 -06001478 help
1479 Enable support for common U-Boot libraries within TPL. See
1480 SPL_LIBCOMMON_SUPPORT for details.
1481
1482config TPL_LIBGENERIC_SUPPORT
1483 bool "Support generic libraries"
Simon Glassf73329e2016-09-12 23:18:27 -06001484 help
1485 Enable support for generic U-Boot libraries within TPL. See
1486 SPL_LIBGENERIC_SUPPORT for details.
1487
1488config TPL_MPC8XXX_INIT_DDR_SUPPORT
1489 bool "Support MPC8XXX DDR init"
Simon Glassf73329e2016-09-12 23:18:27 -06001490 help
1491 Enable support for DDR-SDRAM on the MPC8XXX family within TPL. See
1492 SPL_MPC8XXX_INIT_DDR_SUPPORT for details.
1493
1494config TPL_MMC_SUPPORT
1495 bool "Support MMC"
Tom Rini226498b2017-05-22 19:21:57 +00001496 depends on MMC
Simon Glassf73329e2016-09-12 23:18:27 -06001497 help
1498 Enable support for MMC within TPL. See SPL_MMC_SUPPORT for details.
1499
1500config TPL_NAND_SUPPORT
1501 bool "Support NAND flash"
Simon Glassf73329e2016-09-12 23:18:27 -06001502 help
Philipp Tomsich616bd092017-07-28 17:03:03 +02001503 Enable support for NAND in TPL. See SPL_NAND_SUPPORT for details.
Simon Glassf73329e2016-09-12 23:18:27 -06001504
Sekhar Norid50d6812018-12-06 15:40:08 +05301505config TPL_PCI
Simon Glass2d424eb2018-11-15 18:43:55 -07001506 bool "Support PCI drivers"
1507 help
1508 Enable support for PCI in TPL. For platforms that need PCI to boot,
1509 or must perform some init using PCI in SPL, this provides the
1510 necessary driver support. This enables the drivers in drivers/pci
1511 as part of a TPL build.
1512
1513config TPL_PCH_SUPPORT
1514 bool "Support PCH drivers"
1515 help
1516 Enable support for PCH (Platform Controller Hub) devices in TPL.
1517 These are used to set up GPIOs and the SPI peripheral early in
1518 boot. This enables the drivers in drivers/pch as part of a TPL
1519 build.
1520
Marek Vasutd79dfd42018-04-07 17:03:45 +02001521config TPL_RAM_SUPPORT
1522 bool "Support booting from RAM"
1523 help
1524 Enable booting of an image in RAM. The image can be preloaded or
1525 it can be loaded by TPL directly into RAM (e.g. using USB).
1526
1527config TPL_RAM_DEVICE
1528 bool "Support booting from preloaded image in RAM"
1529 depends on TPL_RAM_SUPPORT
1530 help
1531 Enable booting of an image already loaded in RAM. The image has to
1532 be already in memory when TPL takes over, e.g. loaded by the boot
1533 ROM.
1534
Simon Glass2d424eb2018-11-15 18:43:55 -07001535config TPL_RTC_SUPPORT
1536 bool "Support RTC drivers"
1537 help
1538 Enable RTC (Real-time Clock) support in TPL. This includes support
1539 for reading and setting the time. Some RTC devices also have some
1540 non-volatile (battery-backed) memory which is accessible if
1541 needed. This enables the drivers in drivers/rtc as part of an TPL
1542 build.
1543
Simon Glassf73329e2016-09-12 23:18:27 -06001544config TPL_SERIAL_SUPPORT
1545 bool "Support serial"
Alex Kiernan14ad44a2018-04-19 04:32:54 +00001546 select TPL_PRINTF
1547 select TPL_STRTO
Simon Glassf73329e2016-09-12 23:18:27 -06001548 help
Philipp Tomsich616bd092017-07-28 17:03:03 +02001549 Enable support for serial in TPL. See SPL_SERIAL_SUPPORT for
Simon Glassf73329e2016-09-12 23:18:27 -06001550 details.
1551
1552config TPL_SPI_FLASH_SUPPORT
1553 bool "Support SPI flash drivers"
Simon Glassf73329e2016-09-12 23:18:27 -06001554 help
Philipp Tomsich616bd092017-07-28 17:03:03 +02001555 Enable support for using SPI flash in TPL. See SPL_SPI_FLASH_SUPPORT
Simon Glassf73329e2016-09-12 23:18:27 -06001556 for details.
1557
Simon Glassf38a2992020-07-19 10:15:31 -06001558config TPL_SPI_FLASH_TINY
1559 bool "Enable low footprint TPL SPI Flash support"
1560 depends on TPL_SPI_FLASH_SUPPORT && !SPI_FLASH_BAR
1561 default y if SPI_FLASH
1562 help
1563 Enable lightweight TPL SPI Flash support that supports just reading
1564 data/images from flash. No support to write/erase flash. Enable
1565 this if you have TPL size limitations and don't need full-fledged
1566 SPI flash support.
1567
Marek Vasut1e725e22018-04-07 16:05:46 +02001568config TPL_SPI_LOAD
1569 bool "Support loading from SPI flash"
1570 depends on TPL_SPI_FLASH_SUPPORT
1571 help
1572 Enable support for loading next stage, U-Boot or otherwise, from
1573 SPI NOR in U-Boot TPL.
1574
Simon Glassf73329e2016-09-12 23:18:27 -06001575config TPL_SPI_SUPPORT
1576 bool "Support SPI drivers"
Simon Glassf73329e2016-09-12 23:18:27 -06001577 help
Philipp Tomsich616bd092017-07-28 17:03:03 +02001578 Enable support for using SPI in TPL. See SPL_SPI_SUPPORT for
Simon Glassf73329e2016-09-12 23:18:27 -06001579 details.
1580
Lukasz Majewski56c40462020-06-04 23:11:53 +08001581config TPL_DM_SPI
1582 bool "Support SPI DM drivers in TPL"
1583 help
1584 Enable support for SPI DM drivers in TPL.
1585
1586config TPL_DM_SPI_FLASH
1587 bool "Support SPI DM FLASH drivers in TPL"
1588 help
1589 Enable support for SPI DM flash drivers in TPL.
1590
Marek Vasut6ce3d672018-04-07 16:06:11 +02001591config TPL_YMODEM_SUPPORT
1592 bool "Support loading using Ymodem"
Alex Kiernan3bac19c2018-04-19 04:32:52 +00001593 depends on TPL_SERIAL_SUPPORT
Marek Vasut6ce3d672018-04-07 16:06:11 +02001594 help
1595 While loading from serial is slow it can be a useful backup when
1596 there is no other option. The Ymodem protocol provides a reliable
1597 means of transmitting U-Boot over a serial line for using in TPL,
1598 with a checksum to ensure correctness.
1599
Tom Rini226498b2017-05-22 19:21:57 +00001600endif # TPL
1601
Eugen Hristev0be07872019-05-24 09:38:10 +03001602config SPL_AT91_MCK_BYPASS
1603 bool "Use external clock signal as a source of main clock for AT91 platforms"
1604 depends on ARCH_AT91
1605 default n
1606 help
1607 Use external 8 to 24 Mhz clock signal as source of main clock instead
1608 of an external crystal oscillator.
1609 This option disables the internal driving on the XOUT pin.
1610 The external source has to provide a stable clock on the XIN pin.
1611 If this option is disabled, the SoC expects a crystal oscillator
1612 that needs driving on both XIN and XOUT lines.
1613
Tom Rini226498b2017-05-22 19:21:57 +00001614endif # SPL
Simon Glass11bde1c2016-09-13 07:05:23 -06001615endmenu