blob: 10d9cdd0c286d206d20d8887545d0d34f6a8fbe5 [file] [log] [blame]
Simon Glass7eec8842022-04-30 00:56:52 -06001menu "SPL / TPL / VPL"
Simon Glass1e3911a2016-09-13 07:05:23 -06002
Simon Glassffe19762016-09-12 23:18:22 -06003config SUPPORT_SPL
4 bool
5
6config SUPPORT_TPL
7 bool
8
Simon Glass7eec8842022-04-30 00:56:52 -06009config SUPPORT_VPL
10 bool
11
B, Ravi4cca5cf2017-05-04 15:45:29 +053012config SPL_DFU_NO_RESET
13 bool
14
Simon Glassffe19762016-09-12 23:18:22 -060015config SPL
16 bool
17 depends on SUPPORT_SPL
18 prompt "Enable SPL"
19 help
20 If you want to build SPL as well as the normal image, say Y.
21
Tom Rini623d67e2018-02-06 12:15:38 -050022config SPL_FRAMEWORK
23 bool "Support SPL based upon the common SPL framework"
24 depends on SPL
25 default y
26 help
27 Enable the SPL framework under common/spl/. This framework
28 supports MMC, NAND and YMODEM and other methods loading of U-Boot
29 and the Linux Kernel. If unsure, say Y.
30
Philippe Reynesc4510f42019-09-19 16:18:39 +020031config SPL_FRAMEWORK_BOARD_INIT_F
32 bool "Define a generic function board_init_f"
33 depends on SPL_FRAMEWORK
34 help
35 Define a generic function board_init_f that:
36 - initialize the spl (spl_early_init)
37 - initialize the serial (preloader_console_init)
38 Unless you want to provide your own board_init_f, you should say Y.
39
Simon Goldschmidtc2722832019-05-24 22:07:04 +020040config SPL_SIZE_LIMIT
Simon Glassa8f0c942019-09-25 08:56:28 -060041 hex "Maximum size of SPL image"
Simon Goldschmidtc2722832019-05-24 22:07:04 +020042 depends on SPL
Ovidiu Panaitb7232622020-09-25 21:12:56 +030043 default 0x11000 if ARCH_MX6 && !MX6_OCRAM_256KB
44 default 0x31000 if ARCH_MX6 && MX6_OCRAM_256KB
45 default 0x0
Simon Goldschmidtc2722832019-05-24 22:07:04 +020046 help
47 Specifies the maximum length of the U-Boot SPL image.
48 If this value is zero, it is ignored.
49
50config SPL_SIZE_LIMIT_SUBTRACT_GD
51 bool "SPL image size check: provide space for global data"
52 depends on SPL_SIZE_LIMIT > 0
53 help
54 If enabled, aligned size of global data is reserved in
55 SPL_SIZE_LIMIT check to ensure such an image does not overflow SRAM
56 if SPL_SIZE_LIMIT describes the size of SRAM available for SPL when
57 pre-reloc global data is put into this SRAM, too.
58
59config SPL_SIZE_LIMIT_SUBTRACT_MALLOC
60 bool "SPL image size check: provide space for malloc() pool before relocation"
61 depends on SPL_SIZE_LIMIT > 0
62 help
63 If enabled, SPL_SYS_MALLOC_F_LEN is reserved in SPL_SIZE_LIMIT check
64 to ensure such an image does not overflow SRAM if SPL_SIZE_LIMIT
65 describes the size of SRAM available for SPL when pre-reloc malloc
66 pool is put into this SRAM, too.
67
68config SPL_SIZE_LIMIT_PROVIDE_STACK
69 hex "SPL image size check: provide stack space before relocation"
70 depends on SPL_SIZE_LIMIT > 0
71 default 0
72 help
73 If set, this size is reserved in SPL_SIZE_LIMIT check to ensure such
74 an image does not overflow SRAM if SPL_SIZE_LIMIT describes the size
75 of SRAM available for SPL when the stack required before reolcation
76 uses this SRAM, too.
77
Tom Riniabb0f522022-05-16 17:20:26 -040078config SPL_MAX_SIZE
79 hex "Maximum size of the SPL image, excluding BSS"
80 default 0x30000 if ARCH_MX6 && MX6_OCRAM_256KB
81 default 0x1b000 if AM33XX && !TI_SECURE_DEVICE
82 default 0x10000 if ARCH_MX6 && !MX6_OCRAM_256KB
83 default 0x7fa0 if SUNXI_SRAM_ADDRESS = 0x10000
84 default 0x7fa0 if SUNXI_SRAM_ADDRESS = 0x20000 && !MACH_SUN50I_H616
85 default 0x7000 if RCAR_GEN3
86 default 0x5fa0 if SUNXI_SRAM_ADDRESS = 0x0
87 default 0x0
88 help
89 Maximum size of the SPL image (text, data, rodata, and linker lists
90 sections), BSS excluded. When defined, the linker checks that the
91 actual size does not exceed it.
92
93config SPL_PAD_TO
94 hex "Offset to which the SPL should be padded before appending the SPL payload"
95 default 0x31000 if ARCH_MX6 && MX6_OCRAM_256KB
96 default 0x11000 if ARCH_MX7 || (ARCH_MX6 && !MX6_OCRAM_256KB)
97 default 0x10000 if ARCH_KEYSTONE
98 default 0x8000 if ARCH_SUNXI && !MACH_SUN50I_H616
99 default TPL_MAX_SIZE if TPL_MAX_SIZE > SPL_MAX_SIZE
100 default SPL_MAX_SIZE
101 help
102 Image offset to which the SPL should be padded before appending the
103 SPL payload. By default, this is defined as CONFIG_SPL_MAX_SIZE, or 0 if
104 CONFIG_SPL_MAX_SIZE is undefined. CONFIG_SPL_PAD_TO must be either
105 0, meaning to append the SPL payload without any padding, or >=
106 CONFIG_SPL_MAX_SIZE.
107
Tom Rini65aa1242022-05-27 10:19:45 -0400108config SPL_HAS_BSS_LINKER_SECTION
109 depends on SPL_FRAMEWORK
110 bool "Use a specific address for the BSS via the linker script"
111 default y if ARCH_SUNXI || ARCH_MX6 || ARCH_OMAP2PLUS || MIPS || RISCV
112
113config SPL_BSS_START_ADDR
114 hex "Link address for the BSS within the SPL binary"
115 depends on SPL_HAS_BSS_LINKER_SECTION
116 default 0x88200000 if (ARCH_MX6 && (MX6SX || MX6SL || MX6UL || MX6ULL)) || ARCH_MX7
117 default 0x18200000 if ARCH_MX6 && !(MX6SX || MX6SL || MX6UL || MX6ULL)
118 default 0x80a00000 if ARCH_OMAP2PLUS
119 default 0x81f80000 if ARCH_SUNXI && MACH_SUNIV
120 default 0x4ff80000 if ARCH_SUNXI && !(MACH_SUN9I || MACH_SUNIV)
121 default 0x2ff80000 if ARCH_SUNXI && MACH_SUN9I
122
Tom Rini0cb89e72022-05-19 15:09:22 -0400123choice
124 prompt "Enforce SPL BSS limit"
125 depends on SPL && !PPC
126 default SPL_BSS_LIMIT
127 help
128 In some platforms we only want to enforce a limit on the size of the
129 BSS in memory. On other platforms we need to enforce a limit on the
130 whole of the memory allocation as we're strictly limited to a small
131 typically non-DRAM location. Finally, other platforms do not enforce
132 a memory limit within SPL.
133
134config SPL_NO_BSS_LIMIT
135 bool "Do not enforce a build time limit on the size of the BSS"
136
137config SPL_BSS_LIMIT
138 bool "Enforce a limit on the size of the BSS only"
139
140config SPL_FOOTPRINT_LIMIT
141 bool "Enforce a limit on the whole of memory allocated to SPL, BSS included"
142
143endchoice
144
145config SPL_BSS_MAX_SIZE
146 hex "Maximum size in memory allocated to the SPL BSS"
147 depends on SPL_BSS_LIMIT
148 default 0x100000 if ARCH_MX6 || RISCV
149 default 0x80000 if ARCH_OMAP2PLUS || ARCH_SUNXI
150 help
151 When non-zero, the linker checks that the actual memory used by SPL
152 from __bss_start to __bss_end does not exceed it.
153
154config SPL_MAX_FOOTPRINT
155 hex "Maximum size in memory allocated to the SPL, BSS included"
156 depends on SPL_FOOTPRINT_LIMIT
157 help
158 When non-zero, the linker checks that the actual memory used by SPL
159 from _start to __bss_end does not exceed it.
160
Simon Goldschmidt0b820852019-07-16 22:30:36 +0200161config SPL_SYS_STACK_F_CHECK_BYTE
162 hex
163 default 0xaa
164 help
165 Constant used to check the stack
166
167config SPL_SYS_REPORT_STACK_F_USAGE
168 depends on SPL_SIZE_LIMIT_PROVIDE_STACK != 0
169 bool "Check and report stack usage in SPL before relocation"
170 help
171 If this option is enabled, the initial SPL stack is filled with 0xaa
172 very early, up to the size configured with
173 SPL_SIZE_LIMIT_PROVIDE_STACK.
174 Later when SPL is done using this initial stack and switches to a
175 stack in DRAM, the actually used size of this initial stack is
176 reported by examining the memory and searching for the lowest
177 occurrence of non 0xaa bytes.
178 This default implementation works for stacks growing down only.
179
Simon Glass58254e02021-07-05 16:32:57 -0600180config SPL_SHOW_ERRORS
181 bool "Show more information when something goes wrong"
182 help
183 This enabled more verbose error messages and checking when something
184 goes wrong in SPL. For example, it shows the error code when U-Boot
185 cannot be located. This can help to diagnose the problem and figure
186 out a fix, particularly during development.
187
188 This adds a small amount to SPL code size, perhaps 100 bytes.
189
Simon Glass02b87002022-02-08 11:49:48 -0700190config SPL_BINMAN_SYMBOLS
191 bool "Declare binman symbols in SPL"
192 depends on SPL_FRAMEWORK && BINMAN
193 default y
194 help
195 This enables use of symbols in SPL which refer to U-Boot, enabling SPL
196 to obtain the location of U-Boot simply by calling spl_get_image_pos()
197 and spl_get_image_size().
198
199 For this to work, you must have a U-Boot image in the binman image, so
200 binman can update SPL with the location of it.
201
Alison Wangb846d182019-12-04 06:21:55 +0000202menu "PowerPC and LayerScape SPL Boot options"
Tom Rinie5678e42019-06-01 14:20:25 -0400203
204config SPL_NAND_BOOT
205 bool "Load SPL from NAND flash"
Alison Wangb846d182019-12-04 06:21:55 +0000206 depends on PPC && (SUPPORT_SPL && !SPL_FRAMEWORK)
Tom Rinie5678e42019-06-01 14:20:25 -0400207
208config SPL_MMC_BOOT
209 bool "Load SPL from SD Card / eMMC"
Alison Wangb846d182019-12-04 06:21:55 +0000210 depends on PPC && (SUPPORT_SPL && !SPL_FRAMEWORK)
Tom Rinie5678e42019-06-01 14:20:25 -0400211
212config SPL_SPI_BOOT
213 bool "Load SPL from SPI flash"
Alison Wangb846d182019-12-04 06:21:55 +0000214 depends on PPC && (SUPPORT_SPL && !SPL_FRAMEWORK)
Tom Rinie5678e42019-06-01 14:20:25 -0400215
216config SPL_FSL_PBL
217 bool "Create SPL in Freescale PBI format"
Alison Wangb846d182019-12-04 06:21:55 +0000218 depends on (PPC || ARCH_LS1021A || ARCH_LS1043A || ARCH_LS1046A) && \
219 SUPPORT_SPL
Tom Rinie5678e42019-06-01 14:20:25 -0400220 help
221 Create boot binary having SPL binary in PBI format concatenated with
222 u-boot binary.
223
Tom Rini17845c52022-05-21 11:26:27 -0400224config SPL_SYS_CCSR_DO_NOT_RELOCATE
225 bool "Ensures that CCSR is not relocated"
226 depends on PPC
227 help
228 If this is defined, then CONFIG_SYS_CCSRBAR_PHYS will be forced to a
229 value that ensures that CCSR is not relocated.
230
231config TPL_SYS_CCSR_DO_NOT_RELOCATE
232 def_bool y
233 depends on SPL_SYS_CCSR_DO_NOT_RELOCATE
234
Tom Rinie5678e42019-06-01 14:20:25 -0400235endmenu
236
Tom Rini6de36a72022-05-26 16:59:30 -0400237menu "PowerPC SPL / TPL specific options"
238 depends on PPC && (SPL && !SPL_FRAMEWORK)
Tom Rini6b15c162022-05-13 12:26:35 -0400239
240config SPL_INIT_MINIMAL
241 bool "Arch init code will be built for a very small image"
242
243config SPL_FLUSH_IMAGE
244 bool "Clean dcache and invalidate icache after loading the image"
245
246config SPL_SKIP_RELOCATE
247 bool "Skip relocating SPL"
248
Tom Rini6de36a72022-05-26 16:59:30 -0400249config SPL_RELOC_TEXT_BASE
250 hex "Address to relocate SPL to"
251 default SPL_TEXT_BASE
252 help
253 If unspecified, this is equal to CONFIG_SPL_TEXT_BASE (i.e. no
254 relocation is done).
255
256config SPL_RELOC_STACK
257 hex "Address of the start of the stack SPL will use after relocation."
258 help
259 If unspecified, this is equal to CONFIG_SYS_SPL_MALLOC_START. Starting
260 address of the malloc pool used in SPL. When this option is set the full
261 malloc is used in SPL and it is set up by spl_init() and before that, the
262 simple malloc() can be used if CONFIG_SYS_MALLOC_F is defined.
263
264config SPL_RELOC_MALLOC
265 bool "SPL has malloc pool after relocation"
266
267config SPL_RELOC_MALLOC_ADDR
268 hex "Address of malloc pool in SPL"
269 depends on SPL_RELOC_MALLOC
270
271config SPL_RELOC_MALLOC_SIZE
272 hex "Size of malloc pool in SPL"
273 depends on SPL_RELOC_MALLOC
274
275config TPL_RELOC_TEXT_BASE
276 hex "Address to relocate TPL to"
277 depends on TPL
278 default TPL_TEXT_BASE
279 help
280 If unspecified, this is equal to CONFIG_TPL_TEXT_BASE (i.e. no
281 relocation is done).
282
283config TPL_RELOC_STACK
284 hex "Address of the start of the stack TPL will use after relocation."
285 depends on TPL
286 help
287 If unspecified, this is equal to CONFIG_SYS_TPL_MALLOC_START. Starting
288 address of the malloc pool used in TPL. When this option is set the full
289 malloc is used in TPL and it is set up by spl_init() and before that, the
290 simple malloc() can be used if CONFIG_SYS_MALLOC_F is defined.
291
292config TPL_RELOC_MALLOC
293 bool "TPL has malloc pool after relocation"
294 depends on TPL
295
296config TPL_RELOC_MALLOC_ADDR
297 hex "Address of malloc pool in TPL"
298 depends on TPL_RELOC_MALLOC
299
300config TPL_RELOC_MALLOC_SIZE
301 hex "Size of malloc pool in TPL"
302 depends on TPL_RELOC_MALLOC
303
Tom Rini6b15c162022-05-13 12:26:35 -0400304endmenu
305
Simon Glasse14f1a22018-11-15 18:44:09 -0700306config HANDOFF
307 bool "Pass hand-off information from SPL to U-Boot proper"
Ovidiu Panaitf97049f2020-11-28 10:43:19 +0200308 depends on SPL && BLOBLIST
Simon Glasse14f1a22018-11-15 18:44:09 -0700309 help
310 It is useful to be able to pass information from SPL to U-Boot
311 proper to preserve state that is known in SPL and is needed in U-Boot.
312 Enable this to locate the handoff information in U-Boot proper, early
313 in boot. It is available in gd->handoff. The state state is set up
314 in SPL (or TPL if that is being used).
315
Tom Rini3c82f982017-05-22 19:21:57 +0000316if SPL
317
Simon Glasse14f1a22018-11-15 18:44:09 -0700318config SPL_HANDOFF
319 bool "Pass hand-off information from SPL to U-Boot proper"
Simon Glass540ee8d2019-09-25 08:11:17 -0600320 depends on HANDOFF && SPL_BLOBLIST
Simon Glasse14f1a22018-11-15 18:44:09 -0700321 default y
322 help
323 This option enables SPL to write handoff information. This can be
324 used to pass information like the size of SDRAM from SPL to U-Boot
325 proper. Also SPL can receive information from TPL in the same place
326 if that is enabled.
327
Philipp Tomsichbe1c53a2017-07-28 19:20:49 +0200328config SPL_LDSCRIPT
329 string "Linker script for the SPL stage"
Tom Rini067b9ff2020-03-11 18:11:11 -0400330 default "arch/\$(ARCH)/cpu/u-boot-spl.lds"
Philipp Tomsichbe1c53a2017-07-28 19:20:49 +0200331 help
332 The SPL stage will usually require a different linker-script
333 (as it runs from a different memory region) than the regular
334 U-Boot stage. Set this to the path of the linker-script to
335 be used for SPL.
336
Simon Goldschmidtcc4078c2018-09-30 14:31:53 +0200337config SPL_TEXT_BASE
338 hex "SPL Text Base"
339 default ISW_ENTRY_ADDR if AM43XX || AM33XX || OMAP54XX || ARCH_KEYSTONE
Andre Przywarad38c8ad2019-05-27 01:45:11 +0100340 default 0x10060 if MACH_SUN50I || MACH_SUN50I_H5 || MACH_SUN9I
Jernej Skrabecda8ae612021-01-11 21:11:34 +0100341 default 0x20060 if SUN50I_GEN_H6
Andre Przywarad38c8ad2019-05-27 01:45:11 +0100342 default 0x00060 if ARCH_SUNXI
Michal Simekad336ea2019-09-11 08:49:31 +0200343 default 0xfffc0000 if ARCH_ZYNQMP
Simon Goldschmidtcc4078c2018-09-30 14:31:53 +0200344 default 0x0
345 help
346 The address in memory that SPL will be running from.
347
Ley Foon Tan48fcc4a2017-05-03 17:13:32 +0800348config SPL_BOARD_INIT
Ley Foon Tan48fcc4a2017-05-03 17:13:32 +0800349 bool "Call board-specific initialization in SPL"
350 help
351 If this option is enabled, U-Boot will call the function
352 spl_board_init() from board_init_r(). This function should be
353 provided by the board.
354
Simon Glasse7ca7da2022-04-30 00:56:53 -0600355config VPL_BOARD_INIT
356 bool "Call board-specific initialization in VPL"
357 help
358 If this option is enabled, U-Boot will call the function
359 spl_board_init() from board_init_r(). This function should be
360 provided by the board.
361
Philipp Tomsich83ad7022017-06-22 23:38:36 +0200362config SPL_BOOTROM_SUPPORT
Michal Simek0606f9e2021-05-20 13:08:44 +0200363 bool "Support returning to the BOOTROM"
Philipp Tomsich83ad7022017-06-22 23:38:36 +0200364 help
365 Some platforms (e.g. the Rockchip RK3368) provide support in their
366 ROM for loading the next boot-stage after performing basic setup
367 from the SPL stage.
368
369 Enable this option, to return to the BOOTROM through the
370 BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
371 boot device list, if not implemented for a given board)
372
Lukasz Majewski97c995d2018-05-02 16:10:50 +0200373config SPL_BOOTCOUNT_LIMIT
374 bool "Support bootcount in SPL"
Philippe Reynes8d82a202020-12-11 19:56:47 +0100375 depends on SPL_ENV_SUPPORT && !TPL_BOOTCOUNT_LIMIT
Lukasz Majewski97c995d2018-05-02 16:10:50 +0200376 help
377 On some boards, which use 'falcon' mode, it is necessary to check
378 and increment the number of boot attempts. Such boards do not
379 use proper U-Boot for normal boot flow and hence needs those
380 adjustments to be done in the SPL.
381
Andrew F. Davisb4be3c32017-02-16 11:18:38 -0600382config SPL_RAW_IMAGE_SUPPORT
383 bool "Support SPL loading and booting of RAW images"
Simon Glass081a45a2021-08-08 12:20:17 -0600384 default n if (ARCH_MX6 && (SPL_MMC || SPL_SATA))
Andrew Davis4c1f4762022-05-04 15:52:26 -0500385 default y
386 depends on !TI_SECURE_DEVICE
Andrew F. Davisb4be3c32017-02-16 11:18:38 -0600387 help
388 SPL will support loading and booting a RAW image when this option
389 is y. If this is not set, SPL will move on to other available
390 boot media to find a suitable image.
391
Andrew Davis360ec6a2022-05-04 15:52:25 -0500392config SPL_LEGACY_IMAGE_FORMAT
Andrew F. Davis74630342017-02-16 11:18:39 -0600393 bool "Support SPL loading and booting of Legacy images"
Andrew Davis4c1f4762022-05-04 15:52:26 -0500394 default y if !SPL_LOAD_FIT
395 depends on !TI_SECURE_DEVICE
Andrew F. Davis74630342017-02-16 11:18:39 -0600396 help
397 SPL will support loading and booting Legacy images when this option
398 is y. If this is not set, SPL will move on to other available
399 boot media to find a suitable image.
400
Simon Goldschmidt17140472019-02-10 21:34:37 +0100401config SPL_LEGACY_IMAGE_CRC_CHECK
402 bool "Check CRC of Legacy images"
Andrew Davis360ec6a2022-05-04 15:52:25 -0500403 depends on SPL_LEGACY_IMAGE_FORMAT
Simon Glassefc12232021-07-14 17:05:32 -0500404 select SPL_CRC32
Simon Goldschmidt17140472019-02-10 21:34:37 +0100405 help
406 Enable this to check the CRC of Legacy images. While this increases
407 reliability, it affects both code size and boot duration.
408 If disabled, Legacy images are booted if the image magic and size
409 are correct, without further integrity checks.
410
Simon Glassffe19762016-09-12 23:18:22 -0600411config SPL_SYS_MALLOC_SIMPLE
412 bool
Simon Glassffe19762016-09-12 23:18:22 -0600413 prompt "Only use malloc_simple functions in the SPL"
414 help
415 Say Y here to only use the *_simple malloc functions from
416 malloc_simple.c, rather then using the versions from dlmalloc.c;
417 this will make the SPL binary smaller at the cost of more heap
418 usage as the *_simple malloc functions do not re-use free-ed mem.
419
Philipp Tomsich0c8e75c2017-06-30 18:57:25 +0200420config TPL_SYS_MALLOC_SIMPLE
421 bool
422 prompt "Only use malloc_simple functions in the TPL"
Adam Ford43a1e2d2019-08-13 14:32:30 -0500423 depends on TPL
Philipp Tomsich0c8e75c2017-06-30 18:57:25 +0200424 help
425 Say Y here to only use the *_simple malloc functions from
426 malloc_simple.c, rather then using the versions from dlmalloc.c;
427 this will make the TPL binary smaller at the cost of more heap
428 usage as the *_simple malloc functions do not re-use free-ed mem.
429
Tom Rini8a14ac42022-05-26 13:13:21 -0400430config SPL_SHARES_INIT_SP_ADDR
431 bool "SPL and U-Boot use the same initial stack pointer location"
432 depends on (ARM || ARCH_JZ47XX || MICROBLAZE || RISCV) && SPL_FRAMEWORK
Tom Rinied83ed92022-05-26 13:46:32 -0400433 default n if ARCH_SUNXI || ARCH_MX6 || ARCH_MX7
Tom Rini8a14ac42022-05-26 13:13:21 -0400434 default y
435 help
436 In many cases, we can use the same initial stack pointer address for
437 both SPL and U-Boot itself. If you need to specify a different address
438 however, say N here and then set a different value in CONFIG_SPL_STACK.
439
440config SPL_STACK
441 hex "Initial stack pointer location"
442 depends on (ARM || ARCH_JZ47XX || MICROBLAZE || RISCV) && SPL_FRAMEWORK
443 depends on !SPL_SHARES_INIT_SP_ADDR
Tom Rinied83ed92022-05-26 13:46:32 -0400444 default 0x946bb8 if ARCH_MX7
Tom Rini55242432022-05-26 13:36:17 -0400445 default 0x93ffb8 if ARCH_MX6 && MX6_OCRAM_256KB
446 default 0x91ffb8 if ARCH_MX6 && !MX6_OCRAM_256KB
Tom Rini8a14ac42022-05-26 13:13:21 -0400447 help
448 Address of the start of the stack SPL will use before SDRAM is
449 initialized.
450
Simon Glassffe19762016-09-12 23:18:22 -0600451config SPL_STACK_R
Simon Glassffe19762016-09-12 23:18:22 -0600452 bool "Enable SDRAM location for SPL stack"
453 help
454 SPL starts off execution in SRAM and thus typically has only a small
455 stack available. Since SPL sets up DRAM while in its board_init_f()
456 function, it is possible for the stack to move there before
457 board_init_r() is reached. This option enables a special SDRAM
458 location for the SPL stack. U-Boot SPL switches to this after
459 board_init_f() completes, and before board_init_r() starts.
460
461config SPL_STACK_R_ADDR
462 depends on SPL_STACK_R
463 hex "SDRAM location for SPL stack"
Tom Rinic37e0cf2017-09-17 11:44:49 -0400464 default 0x82000000 if ARCH_OMAP2PLUS
Simon Glassffe19762016-09-12 23:18:22 -0600465 help
466 Specify the address in SDRAM for the SPL stack. This will be set up
467 before board_init_r() is called.
468
469config SPL_STACK_R_MALLOC_SIMPLE_LEN
470 depends on SPL_STACK_R && SPL_SYS_MALLOC_SIMPLE
471 hex "Size of malloc_simple heap after switching to DRAM SPL stack"
472 default 0x100000
473 help
474 Specify the amount of the stack to use as memory pool for
475 malloc_simple after switching the stack to DRAM. This may be set
476 to give board_init_r() a larger heap then the initial heap in
477 SRAM which is limited to SYS_MALLOC_F_LEN bytes.
478
479config SPL_SEPARATE_BSS
Simon Glassffe19762016-09-12 23:18:22 -0600480 bool "BSS section is in a different memory region from text"
481 help
482 Some platforms need a large BSS region in SPL and can provide this
483 because RAM is already set up. In this case BSS can be moved to RAM.
484 This option should then be enabled so that the correct device tree
485 location is used. Normally we put the device tree at the end of BSS
486 but with this option enabled, it goes at _image_binary_end.
487
Tom Rini166e3222022-05-27 12:48:32 -0400488config SYS_SPL_MALLOC
489 bool "Enable malloc pool in SPL"
490 depends on SPL_FRAMEWORK
491
492config HAS_CUSTOM_SPL_MALLOC_START
493 bool "For the SPL malloc pool, define a custom starting address"
494 depends on SYS_SPL_MALLOC
495
496config CUSTOM_SYS_SPL_MALLOC_ADDR
497 hex "SPL malloc addr"
498 depends on HAS_CUSTOM_SPL_MALLOC_START
499
500config SYS_SPL_MALLOC_SIZE
501 hex "Size of the SPL malloc pool"
502 depends on SYS_SPL_MALLOC
503 default 0x100000
504
Simon Glass5b21b342021-03-15 17:25:35 +1300505config SPL_READ_ONLY
506 bool
507 depends on SPL_OF_PLATDATA
508 # Bind cannot be supported because the udevice structs are in read-only
509 # memory so we cannot update the linked lists.
510 select SPL_OF_PLATDATA_NO_BIND
511 select SPL_OF_PLATDATA_RT
512 help
513 Some platforms (e.g. x86 Apollo Lake) load SPL into a read-only
514 section of memory. This means that of-platdata must make a copy (in
515 writeable memory) of anything it wants to modify, such as
516 device-private data.
517
Simon Glass7eec8842022-04-30 00:56:52 -0600518config TPL_SEPARATE_BSS
519 bool "BSS section is in a different memory region from text"
520 default y if SPL_SEPARATE_BSS
521 help
522 Some platforms need a large BSS region in TPL and can provide this
523 because RAM is already set up. In this case BSS can be moved to RAM.
524 This option should then be enabled so that the correct device tree
525 location is used. Normally we put the device tree at the end of BSS
526 but with this option enabled, it goes at _image_binary_end.
527
Simon Glass6324cce2018-11-15 18:43:57 -0700528config SPL_BANNER_PRINT
529 bool "Enable output of the SPL banner 'U-Boot SPL ...'"
530 default y
531 help
532 If this option is enabled, SPL will print the banner with version
Thomas Hebbfd37f242019-11-13 18:18:03 -0800533 info. Disabling this option could be useful to reduce SPL boot time
Simon Glass6324cce2018-11-15 18:43:57 -0700534 (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
535
536config TPL_BANNER_PRINT
537 bool "Enable output of the TPL banner 'U-Boot TPL ...'"
Adam Ford43a1e2d2019-08-13 14:32:30 -0500538 depends on TPL
Simon Glass6324cce2018-11-15 18:43:57 -0700539 default y
Anatolij Gustschin6fe74d22018-01-25 18:45:22 +0100540 help
Thomas Hebbfd37f242019-11-13 18:18:03 -0800541 If this option is enabled, TPL will print the banner with version
542 info. Disabling this option could be useful to reduce TPL boot time
Simon Glass6324cce2018-11-15 18:43:57 -0700543 (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
Anatolij Gustschin6fe74d22018-01-25 18:45:22 +0100544
Andreas Dannenbergaa4ad4b2019-06-04 17:55:45 -0500545config SPL_EARLY_BSS
546 depends on ARM && !ARM64
547 bool "Allows initializing BSS early before entering board_init_f"
548 help
549 On some platform we have sufficient memory available early on to
550 allow setting up and using a basic BSS prior to entering
551 board_init_f. Activating this option will also de-activate the
552 clearing of BSS during the SPL relocation process, thus allowing
553 to carry state from board_init_f to board_init_r by way of BSS.
554
Simon Glassf481ab12016-09-24 18:19:56 -0600555config SPL_DISPLAY_PRINT
Simon Glassf481ab12016-09-24 18:19:56 -0600556 bool "Display a board-specific message in SPL"
557 help
558 If this option is enabled, U-Boot will call the function
559 spl_display_print() immediately after displaying the SPL console
560 banner ("U-Boot SPL ..."). This function should be provided by
561 the board.
562
Semen Protsenko7e3ba482016-11-16 19:19:05 +0200563config SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
564 bool "MMC raw mode: by sector"
Fabio Estevam22a1fab2018-06-11 15:08:05 -0300565 default y if ARCH_SUNXI || ARCH_DAVINCI || ARCH_UNIPHIER || \
566 ARCH_MX6 || ARCH_MX7 || \
Semen Protsenko7e3ba482016-11-16 19:19:05 +0200567 ARCH_ROCKCHIP || ARCH_MVEBU || ARCH_SOCFPGA || \
568 ARCH_AT91 || ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || \
Bin Menge9ead4a2021-03-17 11:10:58 +0800569 OMAP44XX || OMAP54XX || AM33XX || AM43XX || \
Green Wan2e5da522021-05-27 06:52:13 -0700570 TARGET_SIFIVE_UNLEASHED || TARGET_SIFIVE_UNMATCHED
Semen Protsenko7e3ba482016-11-16 19:19:05 +0200571 help
572 Use sector number for specifying U-Boot location on MMC/SD in
573 raw mode.
574
575config SYS_MMCSD_RAW_MODE_U_BOOT_SECTOR
576 hex "Address on the MMC to load U-Boot from"
Tom Rini3c82f982017-05-22 19:21:57 +0000577 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
Andre Przywarad42cbee2021-01-11 21:11:39 +0100578 default 0x40 if ARCH_SUNXI
Semen Protsenko7e3ba482016-11-16 19:19:05 +0200579 default 0x75 if ARCH_DAVINCI
Fabio Estevam22a1fab2018-06-11 15:08:05 -0300580 default 0x8a if ARCH_MX6 || ARCH_MX7
Kever Yang6cc131d2017-11-02 15:16:34 +0800581 default 0x100 if ARCH_UNIPHIER
Pali Rohárcf97b822021-07-23 11:14:29 +0200582 default 0x0 if ARCH_MVEBU
Semen Protsenko7e3ba482016-11-16 19:19:05 +0200583 default 0x200 if ARCH_SOCFPGA || ARCH_AT91
584 default 0x300 if ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || OMAP44XX || \
Lokesh Vutla9bdec002018-08-27 15:57:08 +0530585 OMAP54XX || AM33XX || AM43XX || ARCH_K3
Kever Yang6cc131d2017-11-02 15:16:34 +0800586 default 0x4000 if ARCH_ROCKCHIP
Green Wan2e5da522021-05-27 06:52:13 -0700587 default 0x822 if TARGET_SIFIVE_UNLEASHED || TARGET_SIFIVE_UNMATCHED
Semen Protsenko7e3ba482016-11-16 19:19:05 +0200588 help
589 Address on the MMC to load U-Boot from, when the MMC is being used
590 in raw mode. Units: MMC sectors (1 sector = 512 bytes).
591
Baruch Siachfef81be2020-01-15 09:08:08 +0200592config SYS_MMCSD_RAW_MODE_U_BOOT_DATA_PART_OFFSET
593 hex "U-Boot main hardware partition image offset"
594 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
Andre Przywarad42cbee2021-01-11 21:11:39 +0100595 default 0x10 if ARCH_SUNXI
Baruch Siachfef81be2020-01-15 09:08:08 +0200596 default 0x0
597 help
598 On some platforms SPL location depends on hardware partition. The ROM
599 code skips the MBR sector when loading SPL from main hardware data
600 partition. This adds offset to the main U-Boot image. Set this symbol
601 to the number of skipped sectors.
602
603 If unsure, leave the default.
604
Dalon Westergreenf5ba9852017-02-10 17:15:35 -0800605config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
606 bool "MMC Raw mode: by partition"
Dalon Westergreenf5ba9852017-02-10 17:15:35 -0800607 help
608 Use a partition for loading U-Boot when using MMC/SD in raw mode.
609
610config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION
611 hex "Partition to use to load U-Boot from"
Tom Rini3c82f982017-05-22 19:21:57 +0000612 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
Dalon Westergreenf5ba9852017-02-10 17:15:35 -0800613 default 1
614 help
615 Partition on the MMC to load U-Boot from when the MMC is being
616 used in raw mode
617
Dalon Westergreen8d770f42017-02-10 17:15:34 -0800618config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
619 bool "MMC raw mode: by partition type"
Tom Rini3c82f982017-05-22 19:21:57 +0000620 depends on DOS_PARTITION && SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
Dalon Westergreen8d770f42017-02-10 17:15:34 -0800621 help
622 Use partition type for specifying U-Boot partition on MMC/SD in
623 raw mode. U-Boot will be loaded from the first partition of this
624 type to be found.
625
626config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION_TYPE
627 hex "Partition Type on the MMC to load U-Boot from"
Tom Rini3c82f982017-05-22 19:21:57 +0000628 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
Dalon Westergreen8d770f42017-02-10 17:15:34 -0800629 help
630 Partition Type on the MMC to load U-Boot from, when the MMC is being
631 used in raw mode.
632
Anatolij Gustschin137b8732019-10-18 21:38:33 +0200633config SUPPORT_EMMC_BOOT_OVERRIDE_PART_CONFIG
634 bool "Override eMMC EXT_CSC_PART_CONFIG by user defined partition"
635 depends on SUPPORT_EMMC_BOOT
636 help
637 eMMC boot partition is normally configured by the bits of the EXT_CSD
638 register (EXT_CSC_PART_CONFIG), BOOT_PARTITION_ENABLE field. In some
639 cases it might be required in SPL to load the image from different
640 partition than the partition selected by EXT_CSC_PART_CONFIG register.
641 Enable this option if you intend to use an eMMC boot partition other
642 then selected via EXT_CSC_PART_CONFIG register and specify the custom
643 partition number by the CONFIG_SYS_MMCSD_RAW_MODE_EMMC_BOOT_PARTITION
644 option.
645
646config SYS_MMCSD_RAW_MODE_EMMC_BOOT_PARTITION
647 int "Number of the eMMC boot partition to use"
648 depends on SUPPORT_EMMC_BOOT_OVERRIDE_PART_CONFIG
649 default 1
650 help
651 eMMC boot partition number to use when the eMMC in raw mode and
652 the eMMC EXT_CSC_PART_CONFIG selection should be overridden in SPL
653 by user defined partition number.
654
Simon Glassefc12232021-07-14 17:05:32 -0500655config SPL_CRC32
Simon Glass1e3911a2016-09-13 07:05:23 -0600656 bool "Support CRC32"
Andrew Davis360ec6a2022-05-04 15:52:25 -0500657 default y if SPL_LEGACY_IMAGE_FORMAT || SPL_EFI_PARTITION
Simon Glass577226c2021-09-25 19:43:24 -0600658 default y if SPL_ENV_SUPPORT || TPL_BLOBLIST
Simon Glass1e3911a2016-09-13 07:05:23 -0600659 help
Simon Goldschmidt17140472019-02-10 21:34:37 +0100660 Enable this to support CRC32 in uImages or FIT images within SPL.
661 This is a 32-bit checksum value that can be used to verify images.
662 For FIT images, this is the least secure type of checksum, suitable
663 for detected accidental image corruption. For secure applications you
664 should consider SHA1 or SHA256.
Simon Glass1e3911a2016-09-13 07:05:23 -0600665
Simon Glasse025c652021-07-14 17:05:33 -0500666config SPL_MD5
Simon Glass1e3911a2016-09-13 07:05:23 -0600667 bool "Support MD5"
668 depends on SPL_FIT
669 help
670 Enable this to support MD5 in FIT images within SPL. An MD5
671 checksum is a 128-bit hash value used to check that the image
672 contents have not been corrupted. Note that MD5 is not considered
673 secure as it is possible (with a brute-force attack) to adjust the
674 image while still retaining the same MD5 hash value. For secure
675 applications where images may be changed maliciously, you should
Reuben Dowle1908fd92020-04-16 17:36:52 +1200676 consider SHA256 or SHA384.
Simon Glass1e3911a2016-09-13 07:05:23 -0600677
Philipp Tomsich4faa0112017-11-24 13:26:03 +0100678config SPL_FIT_IMAGE_TINY
679 bool "Remove functionality from SPL FIT loading to reduce size"
680 depends on SPL_FIT
Jernej Skrabecda8ae612021-01-11 21:11:34 +0100681 default y if MACH_SUN50I || MACH_SUN50I_H5 || SUN50I_GEN_H6
Ye Lid08aeb62018-11-20 10:19:15 +0000682 default y if ARCH_IMX8M
Philipp Tomsich4faa0112017-11-24 13:26:03 +0100683 help
684 Enable this to reduce the size of the FIT image loading code
685 in SPL, if space for the SPL binary is very tight.
686
Samuel Hollande646f512020-10-21 21:12:13 -0500687 This skips the recording of each loaded payload
Philipp Tomsich4faa0112017-11-24 13:26:03 +0100688 (i.e. loadable) into the FDT (modifying the loaded FDT to
689 ensure this information is available to the next image
690 invoked).
691
Simon Glassde3fd532021-08-08 12:20:15 -0600692config SPL_CACHE
Rick Chen8b4ee5f2019-11-14 13:52:26 +0800693 bool "Support CACHE drivers"
694 help
695 Enable CACHE drivers in SPL. These drivers can keep data so that
696 future requests for that data can be served faster. Enable this option
697 to build the drivers in drivers/cache as part of an SPL build.
698
Simon Glass2f002162021-03-15 18:11:18 +1300699config SPL_CPU
Simon Glasseca677f2017-01-16 07:03:29 -0700700 bool "Support CPU drivers"
Simon Glasseca677f2017-01-16 07:03:29 -0700701 help
702 Enable this to support CPU drivers in SPL. These drivers can set
703 up CPUs and provide information about them such as the model and
704 name. This can be useful in SPL since setting up the CPUs earlier
705 may improve boot performance. Enable this option to build the
706 drivers in drivers/cpu as part of an SPL build.
707
Simon Glassa8437ce2021-07-10 21:14:25 -0600708config SPL_CRYPTO
Simon Glass1e3911a2016-09-13 07:05:23 -0600709 bool "Support crypto drivers"
Simon Glass1e3911a2016-09-13 07:05:23 -0600710 help
711 Enable crypto drivers in SPL. These drivers can be used to
712 accelerate secure boot processing in secure applications. Enable
713 this option to build the drivers in drivers/crypto as part of an
714 SPL build.
715
Vignesh Raghavendra3d2ba9c2019-11-15 17:00:41 +0530716config SPL_DMA
Simon Glass1e3911a2016-09-13 07:05:23 -0600717 bool "Support DMA drivers"
Simon Glass1e3911a2016-09-13 07:05:23 -0600718 help
719 Enable DMA (direct-memory-access) drivers in SPL. These drivers
720 can be used to handle memory-to-peripheral data transfer without
721 the CPU moving the data. Enable this option to build the drivers
722 in drivers/dma as part of an SPL build.
723
Simon Glass284cb9c2021-07-10 21:14:31 -0600724config SPL_DRIVERS_MISC
Simon Glass1e3911a2016-09-13 07:05:23 -0600725 bool "Support misc drivers"
Simon Glass1e3911a2016-09-13 07:05:23 -0600726 help
727 Enable miscellaneous drivers in SPL. These drivers perform various
728 tasks that don't fall nicely into other categories, Enable this
729 option to build the drivers in drivers/misc as part of an SPL
730 build, for those that support building in SPL (not all drivers do).
731
732config SPL_ENV_SUPPORT
733 bool "Support an environment"
Simon Glass1e3911a2016-09-13 07:05:23 -0600734 help
735 Enable environment support in SPL. The U-Boot environment provides
736 a number of settings (essentially name/value pairs) which can
737 control many aspects of U-Boot's operation. Normally this is not
738 needed in SPL as it has a much simpler task with less
739 configuration. But some boards use this to support 'Falcon' boot
740 on EXT2 and FAT, where SPL boots directly into Linux without
Simon Glass64b723f2017-08-03 12:22:12 -0600741 starting U-Boot first. Enabling this option will make env_get()
Simon Glass6a38e412017-08-03 12:22:09 -0600742 and env_set() available in SPL.
Simon Glass1e3911a2016-09-13 07:05:23 -0600743
B, Ravie94b0242016-09-28 14:46:18 +0530744config SPL_SAVEENV
745 bool "Support save environment"
Tom Rini3c82f982017-05-22 19:21:57 +0000746 depends on SPL_ENV_SUPPORT
Jean-Jacques Hiblotd0531672018-01-04 15:23:32 +0100747 select SPL_MMC_WRITE if ENV_IS_IN_MMC
B, Ravie94b0242016-09-28 14:46:18 +0530748 help
749 Enable save environment support in SPL after setenv. By default
750 the saveenv option is not provided in SPL, but some boards need
751 this support in 'Falcon' boot, where SPL need to boot from
752 different images based on environment variable set by OS. For
753 example OS may set "reboot_image" environment variable to
754 "recovery" inorder to boot recovery image by SPL. The SPL read
755 "reboot_image" and act accordingly and change the reboot_image
Shyam Sainiefe757c2018-06-07 19:47:19 +0530756 to default mode using setenv and save the environment.
B, Ravie94b0242016-09-28 14:46:18 +0530757
Simon Glasse5cd9a42021-07-10 21:14:26 -0600758config SPL_ETH
Simon Glass1e3911a2016-09-13 07:05:23 -0600759 bool "Support Ethernet"
760 depends on SPL_ENV_SUPPORT
Simon Glass1d926242021-08-08 12:20:31 -0600761 depends on SPL_NET
Simon Glass1e3911a2016-09-13 07:05:23 -0600762 help
763 Enable access to the network subsystem and associated Ethernet
764 drivers in SPL. This permits SPL to load U-Boot over an Ethernet
765 link rather than from an on-board peripheral. Environment support
766 is required since the network stack uses a number of environment
Simon Glass041a0ac2021-08-08 12:20:30 -0600767 variables. See also SPL_NET.
Simon Glass1e3911a2016-09-13 07:05:23 -0600768
Tien Fong Chee6091dd12019-01-23 14:20:05 +0800769config SPL_FS_EXT4
Simon Glass1e3911a2016-09-13 07:05:23 -0600770 bool "Support EXT filesystems"
Simon Glass1e3911a2016-09-13 07:05:23 -0600771 help
772 Enable support for EXT2/3/4 filesystems with SPL. This permits
773 U-Boot (or Linux in Falcon mode) to be loaded from an EXT
774 filesystem from within SPL. Support for the underlying block
775 device (e.g. MMC or USB) must be enabled separately.
776
Joao Marcos Costa29da3742020-07-30 15:33:47 +0200777config SPL_FS_SQUASHFS
778 bool "Support SquashFS filesystems"
779 select FS_SQUASHFS
780 help
781 Enable support for SquashFS filesystems with SPL. This permits
782 U-Boot (or Linux in Falcon mode) to be loaded from a SquashFS
783 filesystem from within SPL. Support for the underlying block
784 device (e.g. MMC or USB) must be enabled separately.
785
Tien Fong Chee6fd0a712019-01-23 14:20:03 +0800786config SPL_FS_FAT
Simon Glass1e3911a2016-09-13 07:05:23 -0600787 bool "Support FAT filesystems"
Sekhar Nori1909a7b2017-06-02 17:53:59 +0530788 select FS_FAT
Simon Glass1e3911a2016-09-13 07:05:23 -0600789 help
790 Enable support for FAT and VFAT filesystems with SPL. This
791 permits U-Boot (or Linux in Falcon mode) to be loaded from a FAT
792 filesystem from within SPL. Support for the underlying block
793 device (e.g. MMC or USB) must be enabled separately.
794
Tom Rinia4f2ab92022-05-13 17:12:35 -0400795config SPL_FS_LOAD_PAYLOAD_NAME
796 string "File to load for U-Boot from the filesystem"
797 depends on SPL_FS_EXT4 || SPL_FS_FAT || SPL_FS_SQUASHFS
798 default "tispl.bin" if SYS_K3_SPL_ATF
799 default "u-boot.itb" if SPL_LOAD_FIT
800 default "u-boot.img"
801 help
802 Filename to read to load U-Boot when reading from filesystem.
803
804config SPL_FS_LOAD_KERNEL_NAME
805 string "File to load for the OS kernel from the filesystem"
806 depends on (SPL_FS_EXT4 || SPL_FS_FAT || SPL_FS_SQUASHFS) && SPL_OS_BOOT
807 default "uImage"
808 help
809 Filename to read to load for the OS kernel when reading from the
810 filesystem.
811
812config SPL_FS_LOAD_ARGS_NAME
813 string "File to load for the OS kernel argument parameters from the filesystem"
814 depends on (SPL_FS_EXT4 || SPL_FS_FAT || SPL_FS_SQUASHFS) && SPL_OS_BOOT
815 default "args"
816 help
817 Filename to read to load for the OS kernel argument parameters from
818 the filesystem.
819
Tien Fong Chee87fda0c2019-01-23 14:20:04 +0800820config SPL_FAT_WRITE
821 bool "Support write for FAT filesystems"
822 help
823 Enable write support for FAT and VFAT filesystems with SPL.
824 Support for the underlying block device (e.g. MMC or USB) must be
825 enabled separately.
826
Michal Simek1aab1142020-09-09 14:41:56 +0200827config SPL_FPGA
Simon Glass1e3911a2016-09-13 07:05:23 -0600828 bool "Support FPGAs"
Simon Glass1e3911a2016-09-13 07:05:23 -0600829 help
830 Enable support for FPGAs in SPL. Field-programmable Gate Arrays
831 provide software-configurable hardware which is typically used to
832 implement peripherals (such as UARTs, LCD displays, MMC) or
833 accelerate custom processing functions, such as image processing
834 or machine learning. Sometimes it is useful to program the FPGA
835 as early as possible during boot, and this option can enable that
836 within SPL.
837
Simon Glass035939e2021-07-10 21:14:30 -0600838config SPL_GPIO
Simon Glass592d5b92018-11-15 18:43:55 -0700839 bool "Support GPIO in SPL"
Simon Glass1e3911a2016-09-13 07:05:23 -0600840 help
841 Enable support for GPIOs (General-purpose Input/Output) in SPL.
842 GPIOs allow U-Boot to read the state of an input line (high or
843 low) and set the state of an output line. This can be used to
844 drive LEDs, control power to various system parts and read user
845 input. GPIOs can be useful in SPL to enable a 'sign-of-life' LED,
846 for example. Enable this option to build the drivers in
847 drivers/gpio as part of an SPL build.
848
Simon Glassbccfc2e2021-07-10 21:14:36 -0600849config SPL_I2C
Simon Glass1e3911a2016-09-13 07:05:23 -0600850 bool "Support I2C"
Simon Glass1e3911a2016-09-13 07:05:23 -0600851 help
852 Enable support for the I2C (Inter-Integrated Circuit) bus in SPL.
853 I2C works with a clock and data line which can be driven by a
854 one or more masters or slaves. It is a fairly complex bus but is
855 widely used as it only needs two lines for communication. Speeds of
856 400kbps are typical but up to 3.4Mbps is supported by some
857 hardware. I2C can be useful in SPL to configure power management
858 ICs (PMICs) before raising the CPU clock speed, for example.
859 Enable this option to build the drivers in drivers/i2c as part of
860 an SPL build.
861
862config SPL_LIBCOMMON_SUPPORT
863 bool "Support common libraries"
Simon Glass1e3911a2016-09-13 07:05:23 -0600864 help
865 Enable support for common U-Boot libraries within SPL. These
866 libraries include common code to deal with U-Boot images,
867 environment and USB, for example. This option is enabled on many
868 boards. Enable this option to build the code in common/ as part of
869 an SPL build.
870
871config SPL_LIBDISK_SUPPORT
Simon Goldschmidt62067052018-08-16 09:44:55 +0200872 bool "Support disk partitions"
Tom Rini1794ae62018-12-05 08:23:38 -0500873 select PARTITIONS
Simon Glass1e3911a2016-09-13 07:05:23 -0600874 help
875 Enable support for disk partitions within SPL. 'Disk' is something
876 of a misnomer as it includes non-spinning media such as flash (as
877 used in MMC and USB sticks). Partitions provide a way for a disk
878 to be split up into separate regions, with a partition table placed
879 at the start or end which describes the location and size of each
880 'partition'. These partitions are typically uses as individual block
881 devices, typically with an EXT2 or FAT filesystem in each. This
882 option enables whatever partition support has been enabled in
883 U-Boot to also be used in SPL. It brings in the code in disk/.
884
885config SPL_LIBGENERIC_SUPPORT
886 bool "Support generic libraries"
Simon Glass1e3911a2016-09-13 07:05:23 -0600887 help
888 Enable support for generic U-Boot libraries within SPL. These
889 libraries include generic code to deal with device tree, hashing,
890 printf(), compression and the like. This option is enabled on many
891 boards. Enable this option to build the code in lib/ as part of an
892 SPL build.
893
Lokesh Vutla2aeb9342018-08-27 15:57:49 +0530894config SPL_DM_MAILBOX
895 bool "Support Mailbox"
896 help
897 Enable support for Mailbox within SPL. This enable the inter
898 processor communication protocols tobe used within SPL. Enable
899 this option to build the drivers in drivers/mailbox as part of
900 SPL build.
901
Simon Glassb58bfe02021-08-08 12:20:09 -0600902config SPL_MMC
Simon Glass1e3911a2016-09-13 07:05:23 -0600903 bool "Support MMC"
Tom Rini3c82f982017-05-22 19:21:57 +0000904 depends on MMC
Tom Rini1794ae62018-12-05 08:23:38 -0500905 select HAVE_BLOCK_DEVICE
Simon Glass1e3911a2016-09-13 07:05:23 -0600906 help
907 Enable support for MMC (Multimedia Card) within SPL. This enables
908 the MMC protocol implementation and allows any enabled drivers to
909 be used within SPL. MMC can be used with or without disk partition
910 support depending on the application (SPL_LIBDISK_SUPPORT). Enable
911 this option to build the drivers in drivers/mmc as part of an SPL
912 build.
913
Adam Ford98a87cf2020-07-03 10:17:30 -0500914config SYS_MMCSD_FS_BOOT_PARTITION
915 int "MMC Boot Partition"
916 default 1
917 help
918 Partition on the MMC to load U-Boot from when the MMC is being
Jérôme Carreterod0a8e592022-03-15 16:34:51 -0400919 used in fs mode.
920 Use -1 as a special value to use the first bootable partition.
Adam Ford98a87cf2020-07-03 10:17:30 -0500921
Ezequiel Garcia66983182019-05-25 19:25:21 -0300922config SPL_MMC_TINY
923 bool "Tiny MMC framework in SPL"
Simon Glassb58bfe02021-08-08 12:20:09 -0600924 depends on SPL_MMC
Ezequiel Garcia66983182019-05-25 19:25:21 -0300925 help
926 Enable MMC framework tinification support. This option is useful if
927 if your SPL is extremely size constrained. Heed the warning, enable
928 this option if and only if you know exactly what you are doing, if
929 you are reading this help text, you most likely have no idea :-)
930
931 The MMC framework is reduced to bare minimum to be useful. No malloc
932 support is needed for the MMC framework operation with this option
933 enabled. The framework supports exactly one MMC device and exactly
934 one MMC driver. The MMC driver can be adjusted to avoid any malloc
935 operations too, which can remove the need for malloc support in SPL
936 and thus further reduce footprint.
937
Jean-Jacques Hiblotd0531672018-01-04 15:23:32 +0100938config SPL_MMC_WRITE
939 bool "MMC/SD/SDIO card support for write operations in SPL"
Simon Glassb58bfe02021-08-08 12:20:09 -0600940 depends on SPL_MMC
Jean-Jacques Hiblotd0531672018-01-04 15:23:32 +0100941 help
942 Enable write access to MMC and SD Cards in SPL
943
944
Simon Glass64571062021-08-08 12:20:16 -0600945config SPL_MPC8XXX_INIT_DDR
Simon Glass1e3911a2016-09-13 07:05:23 -0600946 bool "Support MPC8XXX DDR init"
Simon Glass1e3911a2016-09-13 07:05:23 -0600947 help
948 Enable support for DDR-SDRAM (double-data-rate synchronous dynamic
949 random-access memory) on the MPC8XXX family within SPL. This
950 allows DRAM to be set up before loading U-Boot into that DRAM,
951 where it can run.
952
953config SPL_MTD_SUPPORT
954 bool "Support MTD drivers"
Simon Glass1e3911a2016-09-13 07:05:23 -0600955 help
956 Enable support for MTD (Memory Technology Device) within SPL. MTD
957 provides a block interface over raw NAND and can also be used with
958 SPI flash. This allows SPL to load U-Boot from supported MTD
959 devices. See SPL_NAND_SUPPORT and SPL_ONENAND_SUPPORT for how
960 to enable specific MTD drivers.
961
Simon Glass762b9972021-07-10 21:14:27 -0600962config SPL_MUSB_NEW
Simon Glass1e3911a2016-09-13 07:05:23 -0600963 bool "Support new Mentor Graphics USB"
Simon Glass1e3911a2016-09-13 07:05:23 -0600964 help
965 Enable support for Mentor Graphics USB in SPL. This is a new
966 driver used by some boards. Enable this option to build
967 the drivers in drivers/usb/musb-new as part of an SPL build. The
968 old drivers are in drivers/usb/musb.
969
970config SPL_NAND_SUPPORT
971 bool "Support NAND flash"
Simon Glass1e3911a2016-09-13 07:05:23 -0600972 help
973 Enable support for NAND (Negative AND) flash in SPL. NAND flash
974 can be used to allow SPL to load U-Boot from supported devices.
Miquel Raynal1f1ae152018-08-16 17:30:07 +0200975 This enables the drivers in drivers/mtd/nand/raw as part of an SPL
Simon Glass1e3911a2016-09-13 07:05:23 -0600976 build.
977
Tom Rini2d03b912022-05-13 12:46:23 -0400978config SPL_NAND_RAW_ONLY
979 bool "Support to boot only raw u-boot.bin images"
980 depends on SPL_NAND_SUPPORT
981 help
982 Use this only if you need to save space.
983
Adam Ford3a383772020-07-03 08:09:44 -0500984config SPL_NAND_DRIVERS
985 bool "Use standard NAND driver"
986 help
987 SPL uses normal NAND drivers, not minimal drivers.
988
989config SPL_NAND_ECC
Tom Rini2d03b912022-05-13 12:46:23 -0400990 bool "Include standard ECC in SPL"
991
992config SPL_NAND_SOFTECC
993 bool "Use software ECC in SPL"
994 depends on SPL_NAND_ECC
Adam Ford3a383772020-07-03 08:09:44 -0500995
996config SPL_NAND_SIMPLE
997 bool "Support simple NAND drivers in SPL"
998 help
999 Support for NAND boot using simple NAND drivers that
1000 expose the cmd_ctrl() interface.
1001
Adam Ford5e56ad02020-07-03 08:09:45 -05001002config SPL_NAND_BASE
1003 depends on SPL_NAND_DRIVERS
1004 bool "Use Base NAND Driver"
Michal Simek0606f9e2021-05-20 13:08:44 +02001005 help
1006 Include nand_base.c in the SPL.
Adam Ford5e56ad02020-07-03 08:09:45 -05001007
1008config SPL_NAND_IDENT
1009 depends on SPL_NAND_BASE
1010 bool "Use chip ID to identify NAND flash"
1011 help
1012 SPL uses the chip ID list to identify the NAND flash.
1013
Markus Klotzbuecherf5aa1762019-05-15 15:15:57 +02001014config SPL_UBI
1015 bool "Support UBI"
1016 help
1017 Enable support for loading payloads from UBI. See
1018 README.ubispl for more info.
1019
Lukasz Majewski7766ce02019-09-09 12:06:46 +02001020if SPL_DM
1021config SPL_DM_SPI
1022 bool "Support SPI DM drivers in SPL"
1023 help
1024 Enable support for SPI DM drivers in SPL.
1025
Lukasz Majewski76f442982020-06-04 23:11:53 +08001026config SPL_DM_SPI_FLASH
1027 bool "Support SPI DM FLASH drivers in SPL"
1028 help
1029 Enable support for SPI DM flash drivers in SPL.
1030
Lukasz Majewski7766ce02019-09-09 12:06:46 +02001031endif
Markus Klotzbuecherf5aa1762019-05-15 15:15:57 +02001032if SPL_UBI
Hamish Guthrie3ce740d2019-05-15 15:15:59 +02001033config SPL_UBI_LOAD_BY_VOLNAME
1034 bool "Support loading volumes by name"
1035 help
1036 This enables support for loading UBI volumes by name. When this
1037 is set, CONFIG_SPL_UBI_LOAD_MONITOR_VOLNAME can be used to
1038 configure the volume name from which to load U-Boot.
1039
Markus Klotzbuecherf5aa1762019-05-15 15:15:57 +02001040config SPL_UBI_MAX_VOL_LEBS
1041 int "Maximum number of LEBs per volume"
1042 depends on SPL_UBI
1043 help
1044 The maximum number of logical eraseblocks which a static volume
1045 to load can contain. Used for sizing the scan data structure.
1046
1047config SPL_UBI_MAX_PEB_SIZE
1048 int "Maximum PEB size"
1049 depends on SPL_UBI
1050 help
1051 The maximum physical erase block size.
1052
1053config SPL_UBI_MAX_PEBS
1054 int "Maximum number of PEBs"
1055 depends on SPL_UBI
1056 help
1057 The maximum physical erase block size. If not overridden by
1058 board code, this value will be used as the actual number of PEBs.
1059
1060config SPL_UBI_PEB_OFFSET
1061 int "Offset to first UBI PEB"
1062 depends on SPL_UBI
1063 help
1064 The offset in number of PEBs from the start of flash to the first
1065 PEB part of the UBI image.
1066
1067config SPL_UBI_VID_OFFSET
1068 int "Offset to VID header"
1069 depends on SPL_UBI
1070
1071config SPL_UBI_LEB_START
1072 int "Offset to LEB in PEB"
1073 depends on SPL_UBI
1074 help
1075 The offset in bytes to the LEB within a PEB.
1076
1077config SPL_UBI_INFO_ADDR
1078 hex "Address to place UBI scan info"
1079 depends on SPL_UBI
1080 help
1081 Address for ubispl to place the scan info. Read README.ubispl to
1082 determine the required size
1083
1084config SPL_UBI_VOL_IDS
1085 int "Maximum volume id"
1086 depends on SPL_UBI
1087 help
1088 The maximum volume id which can be loaded. Used for sizing the
1089 scan data structure.
1090
1091config SPL_UBI_LOAD_MONITOR_ID
1092 int "id of U-Boot volume"
1093 depends on SPL_UBI
1094 help
1095 The UBI volume id from which to load U-Boot
1096
Hamish Guthrie3ce740d2019-05-15 15:15:59 +02001097config SPL_UBI_LOAD_MONITOR_VOLNAME
1098 string "volume name of U-Boot volume"
1099 depends on SPL_UBI_LOAD_BY_VOLNAME
1100 help
1101 The UBI volume name from which to load U-Boot
1102
Markus Klotzbuecherf5aa1762019-05-15 15:15:57 +02001103config SPL_UBI_LOAD_KERNEL_ID
1104 int "id of kernel volume"
1105 depends on SPL_OS_BOOT && SPL_UBI
1106 help
1107 The UBI volume id from which to load the kernel
1108
1109config SPL_UBI_LOAD_ARGS_ID
1110 int "id of kernel args volume"
1111 depends on SPL_OS_BOOT && SPL_UBI
1112 help
1113 The UBI volume id from which to load the device tree
1114
Markus Klotzbuechercfe40f42019-05-15 15:16:00 +02001115config UBI_SPL_SILENCE_MSG
1116 bool "silence UBI SPL messages"
Markus Klotzbuechercfe40f42019-05-15 15:16:00 +02001117 help
1118 Disable messages from UBI SPL. This leaves warnings
1119 and errors enabled.
Markus Klotzbuecherf5aa1762019-05-15 15:15:57 +02001120
1121endif # if SPL_UBI
1122
Simon Glass041a0ac2021-08-08 12:20:30 -06001123config SPL_NET
Simon Glass1e3911a2016-09-13 07:05:23 -06001124 bool "Support networking"
Simon Glass1e3911a2016-09-13 07:05:23 -06001125 help
1126 Enable support for network devices (such as Ethernet) in SPL.
1127 This permits SPL to load U-Boot over a network link rather than
1128 from an on-board peripheral. Environment support is required since
1129 the network stack uses a number of environment variables. See also
Simon Glasse5cd9a42021-07-10 21:14:26 -06001130 SPL_ETH.
Simon Glass1e3911a2016-09-13 07:05:23 -06001131
Simon Glass041a0ac2021-08-08 12:20:30 -06001132if SPL_NET
Simon Glass1e3911a2016-09-13 07:05:23 -06001133config SPL_NET_VCI_STRING
1134 string "BOOTP Vendor Class Identifier string sent by SPL"
1135 help
1136 As defined by RFC 2132 the vendor class identifier field can be
1137 sent by the client to identify the vendor type and configuration
1138 of a client. This is often used in practice to allow for the DHCP
1139 server to specify different files to load depending on if the ROM,
1140 SPL or U-Boot itself makes the request
Simon Glass041a0ac2021-08-08 12:20:30 -06001141endif # if SPL_NET
Simon Glass1e3911a2016-09-13 07:05:23 -06001142
1143config SPL_NO_CPU_SUPPORT
1144 bool "Drop CPU code in SPL"
Simon Glass1e3911a2016-09-13 07:05:23 -06001145 help
1146 This is specific to the ARM926EJ-S CPU. It disables the standard
1147 start.S start-up code, presumably so that a replacement can be
1148 used on that CPU. You should not enable it unless you know what
1149 you are doing.
1150
1151config SPL_NOR_SUPPORT
1152 bool "Support NOR flash"
Simon Glass1e3911a2016-09-13 07:05:23 -06001153 help
1154 Enable support for loading U-Boot from memory-mapped NOR (Negative
1155 OR) flash in SPL. NOR flash is slow to write but fast to read, and
1156 a memory-mapped device makes it very easy to access. Loading from
1157 NOR is typically achieved with just a memcpy().
1158
Vikas Manocha9e582652017-05-28 12:55:11 -07001159config SPL_XIP_SUPPORT
1160 bool "Support XIP"
1161 depends on SPL
1162 help
1163 Enable support for execute in place of U-Boot or kernel image. There
1164 is no need to copy image from flash to ram if flash supports execute
1165 in place. Its very useful in systems having enough flash but not
1166 enough ram to load the image.
1167
Simon Glass1e3911a2016-09-13 07:05:23 -06001168config SPL_ONENAND_SUPPORT
1169 bool "Support OneNAND flash"
Simon Glass1e3911a2016-09-13 07:05:23 -06001170 help
1171 Enable support for OneNAND (Negative AND) flash in SPL. OneNAND is
1172 a type of NAND flash and therefore can be used to allow SPL to
1173 load U-Boot from supported devices. This enables the drivers in
1174 drivers/mtd/onenand as part of an SPL build.
1175
Heiko Schocher1d12ba22016-10-06 07:55:15 +02001176config SPL_OS_BOOT
1177 bool "Activate Falcon Mode"
Tom Rini3c82f982017-05-22 19:21:57 +00001178 depends on !TI_SECURE_DEVICE
Heiko Schocher1d12ba22016-10-06 07:55:15 +02001179 help
1180 Enable booting directly to an OS from SPL.
1181 for more info read doc/README.falcon
1182
Heiko Schocher65928932016-10-06 07:55:16 +02001183if SPL_OS_BOOT
1184config SYS_OS_BASE
1185 hex "addr, where OS is found"
Tom Rini3c82f982017-05-22 19:21:57 +00001186 depends on SPL_NOR_SUPPORT
Heiko Schocher65928932016-10-06 07:55:16 +02001187 help
1188 Specify the address, where the OS image is found, which
1189 gets booted.
1190
1191endif # SPL_OS_BOOT
1192
Alexandru Gagniuc99426c82021-12-30 10:39:59 -06001193config SPL_FALCON_BOOT_MMCSD
1194 bool "Enable Falcon boot from MMC or SD media"
1195 depends on SPL_OS_BOOT && SPL_MMC
1196 help
1197 Select this if the Falcon mode OS image mode is on MMC or SD media.
1198
1199config SYS_MMCSD_RAW_MODE_KERNEL_SECTOR
1200 hex "Falcon mode: Sector to load kernel uImage from MMC"
1201 depends on SPL_FALCON_BOOT_MMCSD
1202 help
1203 When Falcon mode is used with an MMC or SD media, SPL needs to know
1204 where to look for the kernel uImage. The image is expected to begin
1205 at the raw MMC specified in this config.
1206 Note that the Falcon mode image can also be a FIT, if FIT support is
1207 enabled.
1208
York Sun53492672018-06-14 14:38:48 -07001209config SPL_PAYLOAD
1210 string "SPL payload"
1211 default "tpl/u-boot-with-tpl.bin" if TPL
1212 default "u-boot.bin"
1213 help
Chris Packham37bc3162019-01-13 22:13:20 +13001214 Payload for SPL boot. For backward compatibility, default to
York Sun53492672018-06-14 14:38:48 -07001215 u-boot.bin, i.e. RAW image without any header. In case of
1216 TPL, tpl/u-boot-with-tpl.bin. For new boards, suggest to
1217 use u-boot.img.
1218
Sekhar Nori9108d922018-12-06 15:40:08 +05301219config SPL_PCI
Simon Glass6569f3a2017-01-16 07:03:30 -07001220 bool "Support PCI drivers"
Simon Glass6569f3a2017-01-16 07:03:30 -07001221 help
1222 Enable support for PCI in SPL. For platforms that need PCI to boot,
1223 or must perform some init using PCI in SPL, this provides the
1224 necessary driver support. This enables the drivers in drivers/pci
1225 as part of an SPL build.
1226
Simon Glassff67f232021-08-08 12:20:10 -06001227config SPL_PCH
Simon Glass36258a52017-01-16 07:03:33 -07001228 bool "Support PCH drivers"
Simon Glass36258a52017-01-16 07:03:33 -07001229 help
1230 Enable support for PCH (Platform Controller Hub) devices in SPL.
1231 These are used to set up GPIOs and the SPI peripheral early in
1232 boot. This enables the drivers in drivers/pch as part of an SPL
1233 build.
1234
Simon Glass1e3911a2016-09-13 07:05:23 -06001235config SPL_POST_MEM_SUPPORT
1236 bool "Support POST drivers"
Simon Glass1e3911a2016-09-13 07:05:23 -06001237 help
1238 Enable support for POST (Power-on Self Test) in SPL. POST is a
1239 procedure that checks that the hardware (CPU or board) appears to
1240 be functionally correctly. It is a sanity check that can be
1241 performed before booting. This enables the drivers in post/drivers
1242 as part of an SPL build.
1243
Ley Foon Tan9caf7122018-06-14 18:45:19 +08001244config SPL_DM_RESET
Patrick Delaunay329827a2018-03-12 10:46:05 +01001245 bool "Support reset drivers"
1246 depends on SPL
1247 help
1248 Enable support for reset control in SPL.
1249 That can be useful in SPL to handle IP reset in driver, as in U-Boot,
1250 by using the generic reset API provided by driver model.
1251 This enables the drivers in drivers/reset as part of an SPL build.
1252
Simon Glasse91ac4c2021-07-10 21:14:24 -06001253config SPL_POWER
Simon Glass1e3911a2016-09-13 07:05:23 -06001254 bool "Support power drivers"
Simon Glass1e3911a2016-09-13 07:05:23 -06001255 help
1256 Enable support for power control in SPL. This includes support
1257 for PMICs (Power-management Integrated Circuits) and some of the
1258 features provided by PMICs. In particular, voltage regulators can
1259 be used to enable/disable power and vary its voltage. That can be
1260 useful in SPL to turn on boot peripherals and adjust CPU voltage
1261 so that the clock speed can be increased. This enables the drivers
1262 in drivers/power, drivers/power/pmic and drivers/power/regulator
1263 as part of an SPL build.
1264
Peng Fan3775fed2018-07-27 10:20:37 +08001265config SPL_POWER_DOMAIN
1266 bool "Support power domain drivers"
Simon Glassa0e44872021-08-08 12:20:29 -06001267 select SPL_POWER
Peng Fan3775fed2018-07-27 10:20:37 +08001268 help
1269 Enable support for power domain control in SPL. Many SoCs allow
1270 power to be applied to or removed from portions of the SoC (power
1271 domains). This may be used to save power. This API provides the
1272 means to control such power management hardware. This enables
1273 the drivers in drivers/power/domain as part of a SPL build.
1274
Stefan Agnercd01e642016-12-23 07:51:53 +01001275config SPL_RAM_SUPPORT
1276 bool "Support booting from RAM"
Trevor Woerner513f6402020-05-06 08:02:41 -04001277 default y if MICROBLAZE || ARCH_SOCFPGA || ARCH_TEGRA || ARCH_ZYNQ
Stefan Agnercd01e642016-12-23 07:51:53 +01001278 help
1279 Enable booting of an image in RAM. The image can be preloaded or
1280 it can be loaded by SPL directly into RAM (e.g. using USB).
1281
Stefan Agnere2eaac12016-12-23 07:51:52 +01001282config SPL_RAM_DEVICE
1283 bool "Support booting from preloaded image in RAM"
Stefan Agnercd01e642016-12-23 07:51:53 +01001284 depends on SPL_RAM_SUPPORT
Trevor Woerner513f6402020-05-06 08:02:41 -04001285 default y if MICROBLAZE || ARCH_SOCFPGA || ARCH_TEGRA || ARCH_ZYNQ
Stefan Agnere2eaac12016-12-23 07:51:52 +01001286 help
1287 Enable booting of an image already loaded in RAM. The image has to
1288 be already in memory when SPL takes over, e.g. loaded by the boot
1289 ROM.
1290
Lokesh Vutla1a6f8e02018-08-27 15:57:53 +05301291config SPL_REMOTEPROC
1292 bool "Support REMOTEPROCS"
1293 help
1294 Enable support for REMOTEPROCs in SPL. This permits to load
1295 a remote processor firmware in SPL.
1296
Simon Glass31985312021-08-08 12:20:11 -06001297config SPL_RTC
Simon Glassb69691b2017-01-16 07:03:31 -07001298 bool "Support RTC drivers"
Simon Glassb69691b2017-01-16 07:03:31 -07001299 help
1300 Enable RTC (Real-time Clock) support in SPL. This includes support
1301 for reading and setting the time. Some RTC devices also have some
1302 non-volatile (battery-backed) memory which is accessible if
1303 needed. This enables the drivers in drivers/rtc as part of an SPL
1304 build.
1305
Simon Glass081a45a2021-08-08 12:20:17 -06001306config SPL_SATA
Simon Glass1e3911a2016-09-13 07:05:23 -06001307 bool "Support loading from SATA"
Simon Glass1e3911a2016-09-13 07:05:23 -06001308 help
1309 Enable support for SATA (Serial AT attachment) in SPL. This allows
1310 use of SATA devices such as hard drives and flash drivers for
1311 loading U-Boot. SATA is used in higher-end embedded systems and
1312 can provide higher performance than MMC , at somewhat higher
1313 expense and power consumption. This enables loading from SATA
1314 using a configured device.
1315
Baruch Siachc9eff6a2019-07-14 17:54:21 +03001316config SPL_SATA_RAW_U_BOOT_USE_SECTOR
1317 bool "SATA raw mode: by sector"
Simon Glass081a45a2021-08-08 12:20:17 -06001318 depends on SPL_SATA
Pali Rohárcf97b822021-07-23 11:14:29 +02001319 default y if ARCH_MVEBU
Baruch Siachc9eff6a2019-07-14 17:54:21 +03001320 help
1321 Use sector number for specifying U-Boot location on SATA disk in
1322 raw mode.
1323
1324config SPL_SATA_RAW_U_BOOT_SECTOR
1325 hex "Sector on the SATA disk to load U-Boot from"
1326 depends on SPL_SATA_RAW_U_BOOT_USE_SECTOR
Pali Rohárcf97b822021-07-23 11:14:29 +02001327 default 0x1 if ARCH_MVEBU
Baruch Siachc9eff6a2019-07-14 17:54:21 +03001328 help
1329 Sector on the SATA disk to load U-Boot from, when the SATA disk is being
1330 used in raw mode. Units: SATA disk sectors (1 sector = 512 bytes).
1331
Simon Glassf4d60392021-08-08 12:20:12 -06001332config SPL_SERIAL
Simon Glass1e3911a2016-09-13 07:05:23 -06001333 bool "Support serial"
Alex Kiernan5b404282018-04-19 04:32:54 +00001334 select SPL_PRINTF
1335 select SPL_STRTO
Simon Glass1e3911a2016-09-13 07:05:23 -06001336 help
1337 Enable support for serial in SPL. This allows use of a serial UART
1338 for displaying messages while SPL is running. It also brings in
1339 printf() and panic() functions. This should normally be enabled
1340 unless there are space reasons not to. Even then, consider
Simon Glass7611ac62019-09-25 08:56:27 -06001341 enabling SPL_USE_TINY_PRINTF which is a small printf() version.
Simon Glass1e3911a2016-09-13 07:05:23 -06001342
Simon Glassa5820472021-08-08 12:20:14 -06001343config SPL_SPI
Simon Goldschmidt3a025332019-10-25 16:22:09 +02001344 bool "Support SPI drivers"
1345 help
1346 Enable support for using SPI in SPL. This is used for connecting
1347 to SPI flash for loading U-Boot. See SPL_SPI_FLASH_SUPPORT for
1348 more details on that. The SPI driver provides the transport for
1349 data between the SPI flash and the CPU. This option can be used to
1350 enable SPI drivers that are needed for other purposes also, such
1351 as a SPI PMIC.
1352
Simon Glass1e3911a2016-09-13 07:05:23 -06001353config SPL_SPI_FLASH_SUPPORT
1354 bool "Support SPI flash drivers"
Simon Glassa5820472021-08-08 12:20:14 -06001355 depends on SPL_SPI
Simon Glass1e3911a2016-09-13 07:05:23 -06001356 help
1357 Enable support for using SPI flash in SPL, and loading U-Boot from
1358 SPI flash. SPI flash (Serial Peripheral Bus flash) is named after
1359 the SPI bus that is used to connect it to a system. It is a simple
1360 but fast bidirectional 4-wire bus (clock, chip select and two data
1361 lines). This enables the drivers in drivers/mtd/spi as part of an
Simon Glassa5820472021-08-08 12:20:14 -06001362 SPL build. This normally requires SPL_SPI.
Simon Glass1e3911a2016-09-13 07:05:23 -06001363
Vignesh R4d848c92019-02-05 11:29:20 +05301364if SPL_SPI_FLASH_SUPPORT
1365
Vignesh R3f5fb8b2019-02-05 11:29:25 +05301366config SPL_SPI_FLASH_TINY
1367 bool "Enable low footprint SPL SPI Flash support"
1368 depends on !SPI_FLASH_BAR
Vignesh Rf53872d2019-02-05 11:29:26 +05301369 default y if SPI_FLASH
Vignesh R3f5fb8b2019-02-05 11:29:25 +05301370 help
1371 Enable lightweight SPL SPI Flash support that supports just reading
1372 data/images from flash. No support to write/erase flash. Enable
1373 this if you have SPL size limitations and don't need full
1374 fledged SPI flash support.
1375
Vignesh R4d848c92019-02-05 11:29:20 +05301376config SPL_SPI_FLASH_SFDP_SUPPORT
1377 bool "SFDP table parsing support for SPI NOR flashes"
Vignesh R3f5fb8b2019-02-05 11:29:25 +05301378 depends on !SPI_FLASH_BAR && !SPL_SPI_FLASH_TINY
Vignesh R4d848c92019-02-05 11:29:20 +05301379 help
1380 Enable support for parsing and auto discovery of parameters for
1381 SPI NOR flashes using Serial Flash Discoverable Parameters (SFDP)
1382 tables as per JESD216 standard in SPL.
1383
Lukasz Majewski76f442982020-06-04 23:11:53 +08001384config SPL_SPI_FLASH_MTD
1385 bool "Support for SPI flash MTD drivers in SPL"
1386 help
1387 Enable support for SPI flash MTD drivers in SPL.
1388
Marek Vasute2542252018-04-07 16:05:27 +02001389config SPL_SPI_LOAD
1390 bool "Support loading from SPI flash"
Marek Vasute2542252018-04-07 16:05:27 +02001391 help
1392 Enable support for loading next stage, U-Boot or otherwise, from
1393 SPI NOR in U-Boot SPL.
1394
Vignesh R4d848c92019-02-05 11:29:20 +05301395endif # SPL_SPI_FLASH_SUPPORT
1396
Hannes Schmelzer38df9972019-08-22 15:41:46 +02001397config SYS_SPI_U_BOOT_OFFS
1398 hex "address of u-boot payload in SPI flash"
Andre Przywarae6d9fc02020-01-06 01:29:10 +00001399 default 0x8000 if ARCH_SUNXI
Hannes Schmelzer38df9972019-08-22 15:41:46 +02001400 default 0x0
1401 depends on SPL_SPI_LOAD || SPL_SPI_SUNXI
1402 help
1403 Address within SPI-Flash from where the u-boot payload is fetched
1404 from.
1405
Faiz Abbasae1627c2017-11-14 16:12:31 +05301406config SPL_THERMAL
1407 bool "Driver support for thermal devices"
1408 help
1409 Enable support for temperature-sensing devices. Some SoCs have on-chip
1410 temperature sensors to permit warnings, speed throttling or even
1411 automatic power-off when the temperature gets too high or low. Other
1412 devices may be discrete but connected on a suitable bus.
1413
Simon Glass1f2440c2021-07-10 21:14:29 -06001414config SPL_USB_HOST
Simon Glass1e3911a2016-09-13 07:05:23 -06001415 bool "Support USB host drivers"
Tom Rini1794ae62018-12-05 08:23:38 -05001416 select HAVE_BLOCK_DEVICE
Simon Glass1e3911a2016-09-13 07:05:23 -06001417 help
1418 Enable access to USB (Universal Serial Bus) host devices so that
1419 SPL can load U-Boot from a connected USB peripheral, such as a USB
1420 flash stick. While USB takes a little longer to start up than most
1421 buses, it is very flexible since many different types of storage
1422 device can be attached. This option enables the drivers in
1423 drivers/usb/host as part of an SPL build.
1424
Abel Vesa5ea11ba52019-02-01 16:40:07 +00001425config SPL_USB_STORAGE
Simon Glass1e3911a2016-09-13 07:05:23 -06001426 bool "Support loading from USB"
Simon Glass1f2440c2021-07-10 21:14:29 -06001427 depends on SPL_USB_HOST && !(BLK && !DM_USB)
Simon Glass1e3911a2016-09-13 07:05:23 -06001428 help
1429 Enable support for USB devices in SPL. This allows use of USB
1430 devices such as hard drives and flash drivers for loading U-Boot.
1431 The actual drivers are enabled separately using the normal U-Boot
1432 config options. This enables loading from USB using a configured
1433 device.
1434
Jean-Jacques Hiblot6a228522019-01-10 15:44:13 +01001435config SPL_USB_GADGET
Stefan Agner0489c3b2016-11-21 10:58:53 -08001436 bool "Suppport USB Gadget drivers"
Stefan Agner0489c3b2016-11-21 10:58:53 -08001437 help
1438 Enable USB Gadget API which allows to enable USB device functions
1439 in SPL.
1440
Jean-Jacques Hiblot6a228522019-01-10 15:44:13 +01001441if SPL_USB_GADGET
Stefan Agner0489c3b2016-11-21 10:58:53 -08001442
Faiz Abbasc01553b2018-02-16 21:17:44 +05301443config SPL_USB_ETHER
Stefan Agner0489c3b2016-11-21 10:58:53 -08001444 bool "Support USB Ethernet drivers"
Simon Glass1d926242021-08-08 12:20:31 -06001445 depends on SPL_NET
Stefan Agner0489c3b2016-11-21 10:58:53 -08001446 help
1447 Enable access to the USB network subsystem and associated
1448 drivers in SPL. This permits SPL to load U-Boot over a
1449 USB-connected Ethernet link (such as a USB Ethernet dongle) rather
1450 than from an onboard peripheral. Environment support is required
1451 since the network stack uses a number of environment variables.
Simon Glass041a0ac2021-08-08 12:20:30 -06001452 See also SPL_NET and SPL_ETH.
Stefan Agner0489c3b2016-11-21 10:58:53 -08001453
Andrew F. Davis6d932e62019-01-17 13:43:02 -06001454config SPL_DFU
Fabio Estevam96bdff52018-08-31 10:02:28 -03001455 bool "Support DFU (Device Firmware Upgrade)"
Alexandru Gagniuc97464ff2021-09-02 19:54:19 -05001456 select SPL_HASH
B, Ravi4cca5cf2017-05-04 15:45:29 +05301457 select SPL_DFU_NO_RESET
B, Ravi7e0c0ea2017-05-04 15:45:28 +05301458 depends on SPL_RAM_SUPPORT
Stefan Agnere542edd2016-11-21 10:58:52 -08001459 help
Fabio Estevam96bdff52018-08-31 10:02:28 -03001460 This feature enables the DFU (Device Firmware Upgrade) in SPL with
Stefan Agnere542edd2016-11-21 10:58:52 -08001461 RAM memory device support. The ROM code will load and execute
1462 the SPL built with dfu. The user can load binaries (u-boot/kernel) to
1463 selected device partition from host-pc using dfu-utils.
1464 This feature is useful to flash the binaries to factory or bare-metal
1465 boards using USB interface.
1466
1467choice
1468 bool "DFU device selection"
Andrew F. Davis6d932e62019-01-17 13:43:02 -06001469 depends on SPL_DFU
Stefan Agnere542edd2016-11-21 10:58:52 -08001470
1471config SPL_DFU_RAM
1472 bool "RAM device"
Andrew F. Davis6d932e62019-01-17 13:43:02 -06001473 depends on SPL_DFU && SPL_RAM_SUPPORT
Stefan Agnere542edd2016-11-21 10:58:52 -08001474 help
1475 select RAM/DDR memory device for loading binary images
1476 (u-boot/kernel) to the selected device partition using
1477 DFU and execute the u-boot/kernel from RAM.
1478
1479endchoice
1480
Stefan Agnerd0d9d212017-08-16 11:00:54 -07001481config SPL_USB_SDP_SUPPORT
1482 bool "Support SDP (Serial Download Protocol)"
Simon Glassf4d60392021-08-08 12:20:12 -06001483 depends on SPL_SERIAL
Stefan Agnerd0d9d212017-08-16 11:00:54 -07001484 help
1485 Enable Serial Download Protocol (SDP) device support in SPL. This
1486 allows to download images into memory and execute (jump to) them
1487 using the same protocol as implemented by the i.MX family's boot ROM.
Ye Lif7ac6fd2020-04-29 10:35:12 +08001488
1489config SPL_SDP_USB_DEV
1490 int "SDP USB controller index"
1491 default 0
1492 depends on SPL_USB_SDP_SUPPORT
1493 help
1494 Some boards have USB controller other than 0. Define this option
1495 so it can be used in compiled environment.
Stefan Agner0489c3b2016-11-21 10:58:53 -08001496endif
1497
Simon Glass1ba1d4e2021-07-10 21:14:28 -06001498config SPL_WATCHDOG
Simon Glass1e3911a2016-09-13 07:05:23 -06001499 bool "Support watchdog drivers"
Marek Vasut55ec91b2019-06-09 03:46:21 +02001500 imply SPL_WDT if !HW_WATCHDOG
Simon Glass1e3911a2016-09-13 07:05:23 -06001501 help
1502 Enable support for watchdog drivers in SPL. A watchdog is
1503 typically a hardware peripheral which can reset the system when it
1504 detects no activity for a while (such as a software crash). This
1505 enables the drivers in drivers/watchdog as part of an SPL build.
1506
1507config SPL_YMODEM_SUPPORT
1508 bool "Support loading using Ymodem"
Simon Glassf4d60392021-08-08 12:20:12 -06001509 depends on SPL_SERIAL
Simon Glass1e3911a2016-09-13 07:05:23 -06001510 help
1511 While loading from serial is slow it can be a useful backup when
1512 there is no other option. The Ymodem protocol provides a reliable
1513 means of transmitting U-Boot over a serial line for using in SPL,
1514 with a checksum to ensure correctness.
1515
Philipp Tomsichf6618812017-09-13 21:29:36 +02001516config SPL_ATF
Kever Yang6e79a912017-05-05 11:47:45 +08001517 bool "Support ARM Trusted Firmware"
Michal Simek38183e62020-09-03 11:23:39 +02001518 depends on ARM64 && SPL_FIT
Kever Yang6e79a912017-05-05 11:47:45 +08001519 help
Philipp Tomsichc4078af2018-01-02 21:16:43 +01001520 ATF(ARM Trusted Firmware) is a component for ARM AArch64 which
1521 is loaded by SPL (which is considered as BL2 in ATF terminology).
Kever Yang6e79a912017-05-05 11:47:45 +08001522 More detail at: https://github.com/ARM-software/arm-trusted-firmware
1523
Michael Walleafaf6ea2020-11-18 17:45:58 +01001524config SPL_ATF_LOAD_IMAGE_V2
1525 bool "Use the new LOAD_IMAGE_V2 parameter passing"
1526 depends on SPL_ATF
1527 help
1528 Some platforms use the newer LOAD_IMAGE_V2 parameter passing.
1529
1530 If you want to load a bl31 image from the SPL and need the new
1531 method, say Y.
1532
Philipp Tomsichc4078af2018-01-02 21:16:43 +01001533config SPL_ATF_NO_PLATFORM_PARAM
Michal Simek0606f9e2021-05-20 13:08:44 +02001534 bool "Pass no platform parameter"
Philipp Tomsichc4078af2018-01-02 21:16:43 +01001535 depends on SPL_ATF
1536 help
1537 While we expect to call a pointer to a valid FDT (or NULL)
1538 as the platform parameter to an ATF, some ATF versions are
1539 not U-Boot aware and have an insufficiently robust parameter
1540 validation to gracefully reject a FDT being passed.
1541
1542 If this option is enabled, the spl_atf os-type handler will
1543 always pass NULL for the platform parameter.
1544
1545 If your ATF is affected, say Y.
1546
Alex Kiernan10238ef2018-03-15 22:11:46 +00001547config SPL_AM33XX_ENABLE_RTC32K_OSC
1548 bool "Enable the RTC32K OSC on AM33xx based platforms"
1549 default y if AM33XX
1550 help
1551 Enable access to the AM33xx RTC and select the external 32kHz clock
1552 source.
1553
Patrick Delaunaya7ca4802021-09-02 11:56:16 +02001554config SPL_OPTEE_IMAGE
1555 bool "Support OP-TEE Trusted OS image in SPL"
Kever Yanga28d42c2018-08-23 17:17:59 +08001556 depends on ARM
1557 help
Patrick Delaunaya7ca4802021-09-02 11:56:16 +02001558 OP-TEE is an open source Trusted OS which is loaded by SPL.
Kever Yanga28d42c2018-08-23 17:17:59 +08001559 More detail at: https://github.com/OP-TEE/optee_os
1560
Lukas Auer515b9342019-08-21 21:14:44 +02001561config SPL_OPENSBI
1562 bool "Support RISC-V OpenSBI"
1563 depends on RISCV && SPL_RISCV_MMODE && RISCV_SMODE
1564 help
1565 OpenSBI is an open-source implementation of the RISC-V Supervisor Binary
1566 Interface (SBI) specification. U-Boot supports the OpenSBI FW_DYNAMIC
1567 firmware. It is loaded and started by U-Boot SPL.
1568
1569 More details are available at https://github.com/riscv/opensbi and
1570 https://github.com/riscv/riscv-sbi-doc
1571
1572config SPL_OPENSBI_LOAD_ADDR
1573 hex "OpenSBI load address"
1574 depends on SPL_OPENSBI
1575 help
1576 Load address of the OpenSBI binary.
1577
Tom Rini3c82f982017-05-22 19:21:57 +00001578config TPL
1579 bool
1580 depends on SUPPORT_TPL
1581 prompt "Enable TPL"
1582 help
1583 If you want to build TPL as well as the normal image and SPL, say Y.
1584
1585if TPL
1586
Simon Glassdb372a82019-10-20 21:31:52 -06001587config TPL_SIZE_LIMIT
1588 hex "Maximum size of TPL image"
1589 depends on TPL
Ovidiu Panaitb7232622020-09-25 21:12:56 +03001590 default 0x0
Simon Glassdb372a82019-10-20 21:31:52 -06001591 help
1592 Specifies the maximum length of the U-Boot TPL image.
1593 If this value is zero, it is ignored.
1594
Simon Glass02b87002022-02-08 11:49:48 -07001595config TPL_BINMAN_SYMBOLS
Simon Glass42c5ecc2022-03-05 20:18:55 -07001596 bool "Declare binman symbols in TPL"
Simon Glass02b87002022-02-08 11:49:48 -07001597 depends on SPL_FRAMEWORK && BINMAN
1598 default y
1599 help
Simon Glass42c5ecc2022-03-05 20:18:55 -07001600 This enables use of symbols in TPL which refer to U-Boot, enabling TPL
Simon Glass02b87002022-02-08 11:49:48 -07001601 to obtain the location of U-Boot simply by calling spl_get_image_pos()
1602 and spl_get_image_size().
1603
1604 For this to work, you must have a U-Boot image in the binman image, so
Simon Glass42c5ecc2022-03-05 20:18:55 -07001605 binman can update TPL with the location of it.
Simon Glass02b87002022-02-08 11:49:48 -07001606
Heiko Stuebner4a0da7c2019-07-16 10:12:02 +02001607config TPL_FRAMEWORK
1608 bool "Support TPL based upon the common SPL framework"
1609 default y if SPL_FRAMEWORK
1610 help
1611 Enable the SPL framework under common/spl/ for TPL builds.
1612 This framework supports MMC, NAND and YMODEM and other methods
1613 loading of U-Boot's SPL stage. If unsure, say Y.
1614
Simon Glasse14f1a22018-11-15 18:44:09 -07001615config TPL_HANDOFF
1616 bool "Pass hand-off information from TPL to SPL and U-Boot proper"
Simon Glass540ee8d2019-09-25 08:11:17 -06001617 depends on HANDOFF && TPL_BLOBLIST
Simon Glasse14f1a22018-11-15 18:44:09 -07001618 default y
1619 help
1620 This option enables TPL to write handoff information. This can be
1621 used to pass information like the size of SDRAM from TPL to U-Boot
1622 proper. The information is also available to SPL if it is useful
1623 there.
1624
Kever Yang2b5994b2018-01-20 18:00:26 +08001625config TPL_BOARD_INIT
1626 bool "Call board-specific initialization in TPL"
1627 help
1628 If this option is enabled, U-Boot will call the function
1629 spl_board_init() from board_init_r(). This function should be
1630 provided by the board.
1631
Philippe Reynes8d82a202020-12-11 19:56:47 +01001632config TPL_BOOTCOUNT_LIMIT
1633 bool "Support bootcount in TPL"
1634 depends on TPL_ENV_SUPPORT
1635 help
1636 If this option is enabled, the TPL will support bootcount.
1637 For example, it may be useful to choose the device to boot.
1638
Philipp Tomsichbe1c53a2017-07-28 19:20:49 +02001639config TPL_LDSCRIPT
Michal Simek0606f9e2021-05-20 13:08:44 +02001640 string "Linker script for the TPL stage"
Philipp Tomsichbe1c53a2017-07-28 19:20:49 +02001641 depends on TPL
Tom Rini2aaa27d2019-01-22 17:09:26 -05001642 default "arch/arm/cpu/armv8/u-boot-spl.lds" if ARM64
Tom Rini067b9ff2020-03-11 18:11:11 -04001643 default "arch/\$(ARCH)/cpu/u-boot-spl.lds"
Philipp Tomsichbe1c53a2017-07-28 19:20:49 +02001644 help
1645 The TPL stage will usually require a different linker-script
1646 (as it runs from a different memory region) than the regular
1647 U-Boot stage. Set this to the path of the linker-script to
1648 be used for TPL.
1649
Philipp Tomsichdeff59a2017-07-28 20:02:34 +02001650 May be left empty to trigger the Makefile infrastructure to
1651 fall back to the linker-script used for the SPL stage.
1652
Philipp Tomsichdeff59a2017-07-28 20:02:34 +02001653config TPL_NEEDS_SEPARATE_STACK
Michal Simek0606f9e2021-05-20 13:08:44 +02001654 bool "TPL needs a separate initial stack-pointer"
Philipp Tomsichdeff59a2017-07-28 20:02:34 +02001655 depends on TPL
1656 help
1657 Enable, if the TPL stage should not inherit its initial
1658 stack-pointer from the settings for the SPL stage.
1659
Simon Glassa0e44872021-08-08 12:20:29 -06001660config TPL_POWER
1661 bool "Support power drivers"
1662 help
1663 Enable support for power control in TPL. This includes support
1664 for PMICs (Power-management Integrated Circuits) and some of the
1665 features provided by PMICs. In particular, voltage regulators can
1666 be used to enable/disable power and vary its voltage. That can be
1667 useful in TPL to turn on boot peripherals and adjust CPU voltage
1668 so that the clock speed can be increased. This enables the drivers
1669 in drivers/power, drivers/power/pmic and drivers/power/regulator
1670 as part of an TPL build.
1671
Philipp Tomsichdeff59a2017-07-28 20:02:34 +02001672config TPL_TEXT_BASE
Michal Simek0606f9e2021-05-20 13:08:44 +02001673 hex "Base address for the .text section of the TPL stage"
Simon Glass9b68f4b2022-02-28 12:08:30 -07001674 default 0
Philipp Tomsichdeff59a2017-07-28 20:02:34 +02001675 help
1676 The base address for the .text section of the TPL stage.
1677
1678config TPL_MAX_SIZE
Tom Riniabb0f522022-05-16 17:20:26 -04001679 hex "Maximum size (in bytes) for the TPL stage"
1680 default 0x2e000 if ROCKCHIP_RK3399
1681 default 0x8000 if ROCKCHIP_RK3288
1682 default 0x7000 if ROCKCHIP_RK322X || ROCKCHIP_RK3328 || ROCKCHIP_RK3368
1683 default 0x2800 if ROCKCHIP_PX30
1684 default 0x0
Philipp Tomsichdeff59a2017-07-28 20:02:34 +02001685 help
1686 The maximum size (in bytes) of the TPL stage.
1687
Tom Riniabb0f522022-05-16 17:20:26 -04001688config TPL_PAD_TO
1689 hex "Offset to which the TPL should be padded before appending the TPL payload"
1690 depends on !TPL_FRAMEWORK && PPC
1691 default TPL_MAX_SIZE
1692 help
1693 Image offset to which the TPL should be padded before appending the
1694 TPL payload. By default, this is defined as CONFIG_TPL_MAX_SIZE, or 0 if
1695 CONFIG_TPL_MAX_SIZE is undefined. CONFIG_TPL_PAD_TO must be either
1696 0, meaning to append the TPL payload without any padding, or >=
1697 CONFIG_TPL_MAX_SIZE.
1698
Philipp Tomsichdeff59a2017-07-28 20:02:34 +02001699config TPL_STACK
Michal Simek0606f9e2021-05-20 13:08:44 +02001700 hex "Address of the initial stack-pointer for the TPL stage"
Philipp Tomsichdeff59a2017-07-28 20:02:34 +02001701 depends on TPL_NEEDS_SEPARATE_STACK
1702 help
1703 The address of the initial stack-pointer for the TPL stage.
1704 Usually this will be the (aligned) top-of-stack.
1705
Simon Glass5b21b342021-03-15 17:25:35 +13001706config TPL_READ_ONLY
1707 bool
1708 depends on TPL_OF_PLATDATA
1709 select TPL_OF_PLATDATA_NO_BIND
1710 select TPL_OF_PLATDATA_RT
1711 help
1712 Some platforms (e.g. x86 Apollo Lake) load SPL into a read-only
1713 section of memory. This means that of-platdata must make a copy (in
1714 writeable memory) of anything it wants to modify, such as
1715 device-private data.
1716
Philipp Tomsich2706fb12017-07-04 14:24:53 +02001717config TPL_BOOTROM_SUPPORT
Michal Simek0606f9e2021-05-20 13:08:44 +02001718 bool "Support returning to the BOOTROM (from TPL)"
Philipp Tomsich2706fb12017-07-04 14:24:53 +02001719 help
1720 Some platforms (e.g. the Rockchip RK3368) provide support in their
1721 ROM for loading the next boot-stage after performing basic setup
1722 from the TPL stage.
1723
1724 Enable this option, to return to the BOOTROM through the
1725 BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
1726 boot device list, if not implemented for a given board)
1727
Simon Glass577226c2021-09-25 19:43:24 -06001728config TPL_CRC32
1729 bool "Support CRC32 in TPL"
1730 default y if TPL_ENV_SUPPORT || TPL_BLOBLIST
1731 help
1732 Enable this to support CRC32 in uImages or FIT images within SPL.
1733 This is a 32-bit checksum value that can be used to verify images.
1734 For FIT images, this is the least secure type of checksum, suitable
1735 for detected accidental image corruption. For secure applications you
1736 should consider SHA1 or SHA256.
1737
Simon Glass284cb9c2021-07-10 21:14:31 -06001738config TPL_DRIVERS_MISC
Philipp Tomsich0e221882017-07-04 14:27:02 +02001739 bool "Support misc drivers in TPL"
1740 help
1741 Enable miscellaneous drivers in TPL. These drivers perform various
1742 tasks that don't fall nicely into other categories, Enable this
1743 option to build the drivers in drivers/misc as part of an TPL
1744 build, for those that support building in TPL (not all drivers do).
1745
Simon Glass688be332016-09-12 23:18:27 -06001746config TPL_ENV_SUPPORT
1747 bool "Support an environment"
Simon Glass688be332016-09-12 23:18:27 -06001748 help
1749 Enable environment support in TPL. See SPL_ENV_SUPPORT for details.
1750
Simon Glass035939e2021-07-10 21:14:30 -06001751config TPL_GPIO
Simon Glass592d5b92018-11-15 18:43:55 -07001752 bool "Support GPIO in TPL"
1753 help
1754 Enable support for GPIOs (General-purpose Input/Output) in TPL.
1755 GPIOs allow U-Boot to read the state of an input line (high or
1756 low) and set the state of an output line. This can be used to
1757 drive LEDs, control power to various system parts and read user
1758 input. GPIOs can be useful in TPL to enable a 'sign-of-life' LED,
1759 for example. Enable this option to build the drivers in
1760 drivers/gpio as part of an TPL build.
1761
Simon Glassbccfc2e2021-07-10 21:14:36 -06001762config TPL_I2C
Simon Glass688be332016-09-12 23:18:27 -06001763 bool "Support I2C"
Simon Glass688be332016-09-12 23:18:27 -06001764 help
Simon Glassbccfc2e2021-07-10 21:14:36 -06001765 Enable support for the I2C bus in TPL. See SPL_I2C for
Simon Glass688be332016-09-12 23:18:27 -06001766 details.
1767
1768config TPL_LIBCOMMON_SUPPORT
1769 bool "Support common libraries"
Simon Glass688be332016-09-12 23:18:27 -06001770 help
1771 Enable support for common U-Boot libraries within TPL. See
1772 SPL_LIBCOMMON_SUPPORT for details.
1773
1774config TPL_LIBGENERIC_SUPPORT
1775 bool "Support generic libraries"
Simon Glass688be332016-09-12 23:18:27 -06001776 help
1777 Enable support for generic U-Boot libraries within TPL. See
1778 SPL_LIBGENERIC_SUPPORT for details.
1779
Simon Glass64571062021-08-08 12:20:16 -06001780config TPL_MPC8XXX_INIT_DDR
Simon Glass688be332016-09-12 23:18:27 -06001781 bool "Support MPC8XXX DDR init"
Simon Glass688be332016-09-12 23:18:27 -06001782 help
1783 Enable support for DDR-SDRAM on the MPC8XXX family within TPL. See
Simon Glass64571062021-08-08 12:20:16 -06001784 SPL_MPC8XXX_INIT_DDR for details.
Simon Glass688be332016-09-12 23:18:27 -06001785
Simon Glassb58bfe02021-08-08 12:20:09 -06001786config TPL_MMC
Simon Glass688be332016-09-12 23:18:27 -06001787 bool "Support MMC"
Tom Rini3c82f982017-05-22 19:21:57 +00001788 depends on MMC
Simon Glass688be332016-09-12 23:18:27 -06001789 help
Simon Glassb58bfe02021-08-08 12:20:09 -06001790 Enable support for MMC within TPL. See SPL_MMC for details.
Simon Glass688be332016-09-12 23:18:27 -06001791
1792config TPL_NAND_SUPPORT
1793 bool "Support NAND flash"
Simon Glass688be332016-09-12 23:18:27 -06001794 help
Philipp Tomsich6c7a88e2017-07-28 17:03:03 +02001795 Enable support for NAND in TPL. See SPL_NAND_SUPPORT for details.
Simon Glass688be332016-09-12 23:18:27 -06001796
Sekhar Nori9108d922018-12-06 15:40:08 +05301797config TPL_PCI
Simon Glass592d5b92018-11-15 18:43:55 -07001798 bool "Support PCI drivers"
1799 help
1800 Enable support for PCI in TPL. For platforms that need PCI to boot,
1801 or must perform some init using PCI in SPL, this provides the
1802 necessary driver support. This enables the drivers in drivers/pci
1803 as part of a TPL build.
1804
Simon Glassff67f232021-08-08 12:20:10 -06001805config TPL_PCH
Simon Glass592d5b92018-11-15 18:43:55 -07001806 bool "Support PCH drivers"
1807 help
1808 Enable support for PCH (Platform Controller Hub) devices in TPL.
1809 These are used to set up GPIOs and the SPI peripheral early in
1810 boot. This enables the drivers in drivers/pch as part of a TPL
1811 build.
1812
Marek Vasut84493722018-04-07 17:03:45 +02001813config TPL_RAM_SUPPORT
1814 bool "Support booting from RAM"
1815 help
1816 Enable booting of an image in RAM. The image can be preloaded or
1817 it can be loaded by TPL directly into RAM (e.g. using USB).
1818
1819config TPL_RAM_DEVICE
1820 bool "Support booting from preloaded image in RAM"
1821 depends on TPL_RAM_SUPPORT
1822 help
1823 Enable booting of an image already loaded in RAM. The image has to
1824 be already in memory when TPL takes over, e.g. loaded by the boot
1825 ROM.
1826
Simon Glass31985312021-08-08 12:20:11 -06001827config TPL_RTC
Simon Glass592d5b92018-11-15 18:43:55 -07001828 bool "Support RTC drivers"
1829 help
1830 Enable RTC (Real-time Clock) support in TPL. This includes support
1831 for reading and setting the time. Some RTC devices also have some
1832 non-volatile (battery-backed) memory which is accessible if
1833 needed. This enables the drivers in drivers/rtc as part of an TPL
1834 build.
1835
Simon Glassf4d60392021-08-08 12:20:12 -06001836config TPL_SERIAL
Simon Glass688be332016-09-12 23:18:27 -06001837 bool "Support serial"
Alex Kiernan5b404282018-04-19 04:32:54 +00001838 select TPL_PRINTF
1839 select TPL_STRTO
Simon Glass688be332016-09-12 23:18:27 -06001840 help
Simon Glassf4d60392021-08-08 12:20:12 -06001841 Enable support for serial in TPL. See SPL_SERIAL for
Simon Glass688be332016-09-12 23:18:27 -06001842 details.
1843
1844config TPL_SPI_FLASH_SUPPORT
1845 bool "Support SPI flash drivers"
Simon Glass688be332016-09-12 23:18:27 -06001846 help
Philipp Tomsich6c7a88e2017-07-28 17:03:03 +02001847 Enable support for using SPI flash in TPL. See SPL_SPI_FLASH_SUPPORT
Simon Glass688be332016-09-12 23:18:27 -06001848 for details.
1849
Simon Glass4ec73132020-07-19 10:15:31 -06001850config TPL_SPI_FLASH_TINY
1851 bool "Enable low footprint TPL SPI Flash support"
1852 depends on TPL_SPI_FLASH_SUPPORT && !SPI_FLASH_BAR
1853 default y if SPI_FLASH
1854 help
1855 Enable lightweight TPL SPI Flash support that supports just reading
1856 data/images from flash. No support to write/erase flash. Enable
1857 this if you have TPL size limitations and don't need full-fledged
1858 SPI flash support.
1859
Marek Vasute6b94da2018-04-07 16:05:46 +02001860config TPL_SPI_LOAD
1861 bool "Support loading from SPI flash"
1862 depends on TPL_SPI_FLASH_SUPPORT
1863 help
1864 Enable support for loading next stage, U-Boot or otherwise, from
1865 SPI NOR in U-Boot TPL.
1866
Simon Glassa5820472021-08-08 12:20:14 -06001867config TPL_SPI
Simon Glass688be332016-09-12 23:18:27 -06001868 bool "Support SPI drivers"
Simon Glass688be332016-09-12 23:18:27 -06001869 help
Simon Glassa5820472021-08-08 12:20:14 -06001870 Enable support for using SPI in TPL. See SPL_SPI for
Simon Glass688be332016-09-12 23:18:27 -06001871 details.
1872
Lukasz Majewski76f442982020-06-04 23:11:53 +08001873config TPL_DM_SPI
1874 bool "Support SPI DM drivers in TPL"
1875 help
1876 Enable support for SPI DM drivers in TPL.
1877
1878config TPL_DM_SPI_FLASH
1879 bool "Support SPI DM FLASH drivers in TPL"
1880 help
1881 Enable support for SPI DM flash drivers in TPL.
1882
Marek Vasut04774242018-04-07 16:06:11 +02001883config TPL_YMODEM_SUPPORT
1884 bool "Support loading using Ymodem"
Simon Glassf4d60392021-08-08 12:20:12 -06001885 depends on TPL_SERIAL
Marek Vasut04774242018-04-07 16:06:11 +02001886 help
1887 While loading from serial is slow it can be a useful backup when
1888 there is no other option. The Ymodem protocol provides a reliable
1889 means of transmitting U-Boot over a serial line for using in TPL,
1890 with a checksum to ensure correctness.
1891
Tom Rini3c82f982017-05-22 19:21:57 +00001892endif # TPL
1893
Simon Glasse7ca7da2022-04-30 00:56:53 -06001894config VPL
1895 bool
1896 depends on SUPPORT_SPL
1897 prompt "Enable VPL"
1898 help
1899 If you want to build VPL as well as the normal image, TPL and SPL,
1900 say Y.
1901
1902if VPL
1903
1904config VPL_BANNER_PRINT
1905 bool "Enable output of the VPL banner 'U-Boot VPL ...'"
1906 depends on VPL
1907 default y
1908 help
1909 If this option is enabled, VPL will print the banner with version
1910 info. Disabling this option could be useful to reduce VPL boot time
1911 (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
1912
1913config VPL_BOARD_INIT
1914 bool "Call board-specific initialization in VPL"
1915 help
1916 If this option is enabled, U-Boot will call the function
1917 spl_board_init() from board_init_r(). This function should be
1918 provided by the board.
1919
1920config VPL_CACHE
1921 depends on CACHE
1922 bool "Support cache drivers in VPL"
1923 help
1924 Enable support for cache drivers in VPL.
1925
1926config VPL_CRC32
1927 bool "Support CRC32 in VPL"
1928 default y if VPL_ENV_SUPPORT || VPL_BLOBLIST
1929 help
1930 Enable this to support CRC32 in uImages or FIT images within VPL.
1931 This is a 32-bit checksum value that can be used to verify images.
1932 For FIT images, this is the least secure type of checksum, suitable
1933 for detected accidental image corruption. For secure applications you
1934 should consider SHA1 or SHA256.
1935
1936config VPL_DM_SPI
1937 bool "Support SPI DM drivers in VPL"
1938 help
1939 Enable support for SPI DM drivers in VPL.
1940
1941config VPL_DM_SPI_FLASH
1942 bool "Support SPI DM FLASH drivers in VPL"
1943 help
1944 Enable support for SPI DM flash drivers in VPL.
1945
1946config VPL_FRAMEWORK
1947 bool "Support VPL based upon the common SPL framework"
1948 default y
1949 help
1950 Enable the SPL framework under common/spl/ for VPL builds.
1951 This framework supports MMC, NAND and YMODEM and other methods
1952 loading of U-Boot's next stage. If unsure, say Y.
1953
1954config VPL_HANDOFF
1955 bool "Pass hand-off information from VPL to SPL"
1956 depends on HANDOFF && VPL_BLOBLIST
1957 default y
1958 help
1959 This option enables VPL to write handoff information. This can be
1960 used to pass information like the size of SDRAM from VPL to SPL. Also
1961 VPL can receive information from TPL in the same place if that is
1962 enabled.
1963
1964config VPL_LIBCOMMON_SUPPORT
1965 bool "Support common libraries"
1966 default y if SPL_LIBCOMMON_SUPPORT
1967 help
1968 Enable support for common U-Boot libraries within VPL. See
1969 SPL_LIBCOMMON_SUPPORT for details.
1970
1971config VPL_LIBGENERIC_SUPPORT
1972 bool "Support generic libraries"
1973 default y if SPL_LIBGENERIC_SUPPORT
1974 help
1975 Enable support for generic U-Boot libraries within VPL. These
1976 libraries include generic code to deal with device tree, hashing,
1977 printf(), compression and the like. This option is enabled on many
1978 boards. Enable this option to build the code in lib/ as part of a
1979 VPL build.
1980
1981config VPL_DRIVERS_MISC
1982 bool "Support misc drivers"
1983 default y if TPL_DRIVERS_MISC
1984 help
1985 Enable miscellaneous drivers in VPL. These drivers perform various
1986 tasks that don't fall nicely into other categories, Enable this
1987 option to build the drivers in drivers/misc as part of a VPL
1988 build, for those that support building in VPL (not all drivers do).
1989
1990config VPL_ENV_SUPPORT
1991 bool "Support an environment"
1992 help
1993 Enable environment support in VPL. The U-Boot environment provides
1994 a number of settings (essentially name/value pairs) which can
1995 control many aspects of U-Boot's operation. Enabling this option will
1996 make env_get() and env_set() available in VSPL.
1997
1998config VPL_GPIO
1999 bool "Support GPIO in VPL"
2000 default y if SPL_GPIO
2001 help
2002 Enable support for GPIOs (General-purpose Input/Output) in VPL.
2003 GPIOs allow U-Boot to read the state of an input line (high or
2004 low) and set the state of an output line. This can be used to
2005 drive LEDs, control power to various system parts and read user
2006 input. GPIOs can be useful in VPL to enable a 'sign-of-life' LED,
2007 for example. Enable this option to build the drivers in
2008 drivers/gpio as part of a VPL build.
2009
2010config VPL_HANDOFF
2011 bool "Pass hand-off information from VPL to SPL and U-Boot proper"
2012 depends on HANDOFF && VPL_BLOBLIST
2013 default y
2014 help
2015 This option enables VPL to write handoff information. This can be
2016 used to pass information like the size of SDRAM from VPL to U-Boot
2017 proper. The information is also available to VPL if it is useful
2018 there.
2019
2020config VPL_HASH
2021 bool "Support hashing drivers in VPL"
2022 depends on VPL
2023 select SHA1
2024 select SHA256
2025 help
2026 Enable hashing drivers in VPL. These drivers can be used to
2027 accelerate secure boot processing in secure applications. Enable
2028 this option to build system-specific drivers for hash acceleration
2029 as part of a VPL build.
2030
2031config VPL_I2C_SUPPORT
2032 bool "Support I2C in VPL"
2033 default y if SPL_I2C_SUPPORT
2034 help
2035 Enable support for the I2C bus in VPL. Vee SPL_I2C_SUPPORT for
2036 details.
2037
2038config VPL_PCH_SUPPORT
2039 bool "Support PCH drivers"
2040 default y if TPL_PCH_SUPPORT
2041 help
2042 Enable support for PCH (Platform Controller Hub) devices in VPL.
2043 These are used to set up GPIOs and the SPI peripheral early in
2044 boot. This enables the drivers in drivers/pch as part of a VPL
2045 build.
2046
2047config VPL_PCI
2048 bool "Support PCI drivers"
2049 default y if SPL_PCI
2050 help
2051 Enable support for PCI in VPL. For platforms that need PCI to boot,
2052 or must perform some init using PCI in VPL, this provides the
2053 necessary driver support. This enables the drivers in drivers/pci
2054 as part of a VPL build.
2055
2056config VPL_RTC
2057 bool "Support RTC drivers"
2058 help
2059 Enable RTC (Real-time Clock) support in VPL. This includes support
2060 for reading and setting the time. Some RTC devices also have some
2061 non-volatile (battery-backed) memory which is accessible if
2062 needed. This enables the drivers in drivers/rtc as part of a VPL
2063 build.
2064
2065config VPL_SERIAL
2066 bool "Support serial"
2067 default y if TPL_SERIAL
2068 select VPL_PRINTF
2069 select VPL_STRTO
2070 help
2071 Enable support for serial in VPL. See SPL_SERIAL_SUPPORT for
2072 details.
2073
2074config VPL_SIZE_LIMIT
2075 hex "Maximum size of VPL image"
2076 depends on VPL
2077 default 0x0
2078 help
2079 Specifies the maximum length of the U-Boot VPL image.
2080 If this value is zero, it is ignored.
2081
2082config VPL_SPI
2083 bool "Support SPI drivers"
2084 help
2085 Enable support for using SPI in VPL. See SPL_SPI_SUPPORT for
2086 details.
2087
2088config VPL_SPI_FLASH_SUPPORT
2089 bool "Support SPI flash drivers"
2090 help
2091 Enable support for using SPI flash in VPL, and loading U-Boot from
2092 SPI flash. SPI flash (Serial Peripheral Bus flash) is named after
2093 the SPI bus that is used to connect it to a system. It is a simple
2094 but fast bidirectional 4-wire bus (clock, chip select and two data
2095 lines). This enables the drivers in drivers/mtd/spi as part of a
2096 VPL build. This normally requires VPL_SPI_SUPPORT.
2097
2098config VPL_TEXT_BASE
2099 hex "VPL Text Base"
2100 default 0x0
2101 help
2102 The address in memory that VPL will be running from.
2103
2104endif # VPL
2105
Eugen Hristevfdd833e2019-05-24 09:38:10 +03002106config SPL_AT91_MCK_BYPASS
2107 bool "Use external clock signal as a source of main clock for AT91 platforms"
2108 depends on ARCH_AT91
Eugen Hristevfdd833e2019-05-24 09:38:10 +03002109 help
2110 Use external 8 to 24 Mhz clock signal as source of main clock instead
2111 of an external crystal oscillator.
2112 This option disables the internal driving on the XOUT pin.
2113 The external source has to provide a stable clock on the XIN pin.
2114 If this option is disabled, the SoC expects a crystal oscillator
2115 that needs driving on both XIN and XOUT lines.
2116
Tom Rini3c82f982017-05-22 19:21:57 +00002117endif # SPL
Simon Glass1e3911a2016-09-13 07:05:23 -06002118endmenu