blob: fc284a5bffce275c545138a7c8243ae0923aafef [file] [log] [blame]
Simon Glassc2ae7d82016-09-12 23:18:22 -06001config SUPPORT_SPL
2 bool
3
4config SUPPORT_TPL
5 bool
6
Simon Glassf86ca5a2022-04-30 00:56:52 -06007config SUPPORT_VPL
8 bool
9
B, Ravi66928af2017-05-04 15:45:29 +053010config SPL_DFU_NO_RESET
11 bool
12
Simon Glassc2ae7d82016-09-12 23:18:22 -060013config SPL
Tom Riniab0c5f12022-05-30 17:11:23 -040014 bool "Enable SPL"
Simon Glassc2ae7d82016-09-12 23:18:22 -060015 depends on SUPPORT_SPL
Simon Glassc2ae7d82016-09-12 23:18:22 -060016 help
17 If you want to build SPL as well as the normal image, say Y.
18
Tom Riniab0c5f12022-05-30 17:11:23 -040019menu "SPL configuration options"
20 depends on SPL
21
Tom Rini75670c82018-02-06 12:15:38 -050022config SPL_FRAMEWORK
23 bool "Support SPL based upon the common SPL framework"
Tom Rini75670c82018-02-06 12:15:38 -050024 default y
25 help
26 Enable the SPL framework under common/spl/. This framework
27 supports MMC, NAND and YMODEM and other methods loading of U-Boot
28 and the Linux Kernel. If unsure, say Y.
29
Philippe Reynesa9a3aad2019-09-19 16:18:39 +020030config SPL_FRAMEWORK_BOARD_INIT_F
31 bool "Define a generic function board_init_f"
32 depends on SPL_FRAMEWORK
33 help
34 Define a generic function board_init_f that:
35 - initialize the spl (spl_early_init)
36 - initialize the serial (preloader_console_init)
37 Unless you want to provide your own board_init_f, you should say Y.
38
Simon Goldschmidt25770152019-05-24 22:07:04 +020039config SPL_SIZE_LIMIT
Simon Glassb51882d2019-09-25 08:56:28 -060040 hex "Maximum size of SPL image"
Ovidiu Panait2dfdd0c2020-09-25 21:12:56 +030041 default 0x11000 if ARCH_MX6 && !MX6_OCRAM_256KB
42 default 0x31000 if ARCH_MX6 && MX6_OCRAM_256KB
Pali Rohár4a08c262022-09-14 18:48:16 +020043 default 0x30000 if ARCH_MVEBU && ARMADA_32BIT
Ovidiu Panait2dfdd0c2020-09-25 21:12:56 +030044 default 0x0
Simon Goldschmidt25770152019-05-24 22:07:04 +020045 help
46 Specifies the maximum length of the U-Boot SPL image.
47 If this value is zero, it is ignored.
48
49config SPL_SIZE_LIMIT_SUBTRACT_GD
50 bool "SPL image size check: provide space for global data"
51 depends on SPL_SIZE_LIMIT > 0
52 help
53 If enabled, aligned size of global data is reserved in
54 SPL_SIZE_LIMIT check to ensure such an image does not overflow SRAM
55 if SPL_SIZE_LIMIT describes the size of SRAM available for SPL when
56 pre-reloc global data is put into this SRAM, too.
57
58config SPL_SIZE_LIMIT_SUBTRACT_MALLOC
59 bool "SPL image size check: provide space for malloc() pool before relocation"
60 depends on SPL_SIZE_LIMIT > 0
61 help
62 If enabled, SPL_SYS_MALLOC_F_LEN is reserved in SPL_SIZE_LIMIT check
63 to ensure such an image does not overflow SRAM if SPL_SIZE_LIMIT
64 describes the size of SRAM available for SPL when pre-reloc malloc
65 pool is put into this SRAM, too.
66
67config SPL_SIZE_LIMIT_PROVIDE_STACK
68 hex "SPL image size check: provide stack space before relocation"
69 depends on SPL_SIZE_LIMIT > 0
Tom Rinia077ac12023-08-02 11:09:43 -040070 default 0x0
Simon Goldschmidt25770152019-05-24 22:07:04 +020071 help
72 If set, this size is reserved in SPL_SIZE_LIMIT check to ensure such
73 an image does not overflow SRAM if SPL_SIZE_LIMIT describes the size
74 of SRAM available for SPL when the stack required before reolcation
75 uses this SRAM, too.
76
Tom Rinica8a3292022-05-16 17:20:26 -040077config SPL_MAX_SIZE
78 hex "Maximum size of the SPL image, excluding BSS"
79 default 0x30000 if ARCH_MX6 && MX6_OCRAM_256KB
80 default 0x1b000 if AM33XX && !TI_SECURE_DEVICE
81 default 0x10000 if ARCH_MX6 && !MX6_OCRAM_256KB
82 default 0x7fa0 if SUNXI_SRAM_ADDRESS = 0x10000
83 default 0x7fa0 if SUNXI_SRAM_ADDRESS = 0x20000 && !MACH_SUN50I_H616
Andre Przywara177040b2022-09-13 01:23:58 +010084 default 0xbfa0 if MACH_SUN50I_H616
Tom Rinica8a3292022-05-16 17:20:26 -040085 default 0x7000 if RCAR_GEN3
86 default 0x5fa0 if SUNXI_SRAM_ADDRESS = 0x0
Joel Stanleya1617532022-06-29 16:35:22 +093087 default 0x10000 if ASPEED_AST2600
Peng Fan658ff9d2022-07-26 16:40:31 +080088 default 0x27000 if IMX8MM && SPL_TEXT_BASE = 0x7E1000
Tom Rinica8a3292022-05-16 17:20:26 -040089 default 0x0
90 help
91 Maximum size of the SPL image (text, data, rodata, and linker lists
92 sections), BSS excluded. When defined, the linker checks that the
93 actual size does not exceed it.
94
95config SPL_PAD_TO
96 hex "Offset to which the SPL should be padded before appending the SPL payload"
97 default 0x31000 if ARCH_MX6 && MX6_OCRAM_256KB
98 default 0x11000 if ARCH_MX7 || (ARCH_MX6 && !MX6_OCRAM_256KB)
99 default 0x10000 if ARCH_KEYSTONE
100 default 0x8000 if ARCH_SUNXI && !MACH_SUN50I_H616
Stefan Roese8450b972022-10-28 14:46:29 +0200101 default 0x0 if ARCH_MTMIPS
Tom Rinica8a3292022-05-16 17:20:26 -0400102 default TPL_MAX_SIZE if TPL_MAX_SIZE > SPL_MAX_SIZE
103 default SPL_MAX_SIZE
104 help
105 Image offset to which the SPL should be padded before appending the
106 SPL payload. By default, this is defined as CONFIG_SPL_MAX_SIZE, or 0 if
107 CONFIG_SPL_MAX_SIZE is undefined. CONFIG_SPL_PAD_TO must be either
108 0, meaning to append the SPL payload without any padding, or >=
109 CONFIG_SPL_MAX_SIZE.
110
Tom Rini6600b352022-05-27 10:19:45 -0400111config SPL_HAS_BSS_LINKER_SECTION
112 depends on SPL_FRAMEWORK
113 bool "Use a specific address for the BSS via the linker script"
Stefan Herbrechtsmeierfcbc43b2022-07-14 15:47:33 +0200114 default y if ARCH_SUNXI || ARCH_MX6 || ARCH_OMAP2PLUS || MIPS || RISCV || ARCH_ZYNQMP
Tom Rini6600b352022-05-27 10:19:45 -0400115
116config SPL_BSS_START_ADDR
117 hex "Link address for the BSS within the SPL binary"
118 depends on SPL_HAS_BSS_LINKER_SECTION
119 default 0x88200000 if (ARCH_MX6 && (MX6SX || MX6SL || MX6UL || MX6ULL)) || ARCH_MX7
120 default 0x18200000 if ARCH_MX6 && !(MX6SX || MX6SL || MX6UL || MX6ULL)
121 default 0x80a00000 if ARCH_OMAP2PLUS
122 default 0x81f80000 if ARCH_SUNXI && MACH_SUNIV
123 default 0x4ff80000 if ARCH_SUNXI && !(MACH_SUN9I || MACH_SUNIV)
124 default 0x2ff80000 if ARCH_SUNXI && MACH_SUN9I
Stefan Herbrechtsmeierfcbc43b2022-07-14 15:47:33 +0200125 default 0x1000 if ARCH_ZYNQMP
Tom Rini6600b352022-05-27 10:19:45 -0400126
Tom Rini9b5f9ae2022-05-19 15:09:22 -0400127choice
128 prompt "Enforce SPL BSS limit"
Tom Riniab0c5f12022-05-30 17:11:23 -0400129 depends on !PPC
Tom Rini9b5f9ae2022-05-19 15:09:22 -0400130 default SPL_BSS_LIMIT
131 help
132 In some platforms we only want to enforce a limit on the size of the
133 BSS in memory. On other platforms we need to enforce a limit on the
134 whole of the memory allocation as we're strictly limited to a small
135 typically non-DRAM location. Finally, other platforms do not enforce
136 a memory limit within SPL.
137
138config SPL_NO_BSS_LIMIT
139 bool "Do not enforce a build time limit on the size of the BSS"
140
141config SPL_BSS_LIMIT
142 bool "Enforce a limit on the size of the BSS only"
143
144config SPL_FOOTPRINT_LIMIT
145 bool "Enforce a limit on the whole of memory allocated to SPL, BSS included"
146
147endchoice
148
149config SPL_BSS_MAX_SIZE
150 hex "Maximum size in memory allocated to the SPL BSS"
151 depends on SPL_BSS_LIMIT
152 default 0x100000 if ARCH_MX6 || RISCV
153 default 0x80000 if ARCH_OMAP2PLUS || ARCH_SUNXI
154 help
155 When non-zero, the linker checks that the actual memory used by SPL
156 from __bss_start to __bss_end does not exceed it.
157
158config SPL_MAX_FOOTPRINT
159 hex "Maximum size in memory allocated to the SPL, BSS included"
160 depends on SPL_FOOTPRINT_LIMIT
161 help
162 When non-zero, the linker checks that the actual memory used by SPL
163 from _start to __bss_end does not exceed it.
164
Simon Goldschmidtd8c03322019-07-16 22:30:36 +0200165config SPL_SYS_STACK_F_CHECK_BYTE
166 hex
167 default 0xaa
168 help
169 Constant used to check the stack
170
171config SPL_SYS_REPORT_STACK_F_USAGE
172 depends on SPL_SIZE_LIMIT_PROVIDE_STACK != 0
173 bool "Check and report stack usage in SPL before relocation"
174 help
175 If this option is enabled, the initial SPL stack is filled with 0xaa
176 very early, up to the size configured with
177 SPL_SIZE_LIMIT_PROVIDE_STACK.
178 Later when SPL is done using this initial stack and switches to a
179 stack in DRAM, the actually used size of this initial stack is
180 reported by examining the memory and searching for the lowest
181 occurrence of non 0xaa bytes.
182 This default implementation works for stacks growing down only.
183
Simon Glass7d84fbb2021-07-05 16:32:57 -0600184config SPL_SHOW_ERRORS
185 bool "Show more information when something goes wrong"
Sean Anderson06b1bca2023-11-08 11:48:35 -0500186 depends on SPL_LIBCOMMON_SUPPORT
Simon Glass7d84fbb2021-07-05 16:32:57 -0600187 help
188 This enabled more verbose error messages and checking when something
189 goes wrong in SPL. For example, it shows the error code when U-Boot
190 cannot be located. This can help to diagnose the problem and figure
191 out a fix, particularly during development.
192
193 This adds a small amount to SPL code size, perhaps 100 bytes.
194
Simon Glass38c04d82022-02-08 11:49:48 -0700195config SPL_BINMAN_SYMBOLS
196 bool "Declare binman symbols in SPL"
197 depends on SPL_FRAMEWORK && BINMAN
198 default y
199 help
Alper Nebi Yasakd8830cf2022-06-18 15:13:09 +0300200 This enables use of symbols in SPL which refer to other entries in
201 the same binman image as the SPL. These can be declared with the
202 binman_sym_declare(type, entry, prop) macro and accessed by the
203 binman_sym(type, entry, prop) macro defined in binman_sym.h.
Simon Glass38c04d82022-02-08 11:49:48 -0700204
Alper Nebi Yasakd8830cf2022-06-18 15:13:09 +0300205 See tools/binman/binman.rst for a detailed explanation.
206
207config SPL_BINMAN_UBOOT_SYMBOLS
208 bool "Declare binman symbols for U-Boot phases in SPL"
209 depends on SPL_BINMAN_SYMBOLS
Alper Nebi Yasak6516c9b2022-06-18 15:13:12 +0300210 default n if ARCH_IMX8M
Alper Nebi Yasakd8830cf2022-06-18 15:13:09 +0300211 default y
212 help
213 This enables use of symbols in SPL which refer to U-Boot phases,
214 enabling SPL to obtain the location and size of its next phase simply
215 by calling spl_get_image_pos() and spl_get_image_size().
216
217 For this to work, you must have all U-Boot phases in the same binman
218 image, so binman can update SPL with the locations of everything.
Simon Glass38c04d82022-02-08 11:49:48 -0700219
Tom Riniba787bb2022-05-30 17:01:22 -0400220source "common/spl/Kconfig.nxp"
Tom Rinib35316f2022-05-13 12:26:35 -0400221
Simon Glassb0edea32018-11-15 18:44:09 -0700222config HANDOFF
223 bool "Pass hand-off information from SPL to U-Boot proper"
Tom Riniab0c5f12022-05-30 17:11:23 -0400224 depends on BLOBLIST
Simon Glassb0edea32018-11-15 18:44:09 -0700225 help
226 It is useful to be able to pass information from SPL to U-Boot
227 proper to preserve state that is known in SPL and is needed in U-Boot.
228 Enable this to locate the handoff information in U-Boot proper, early
229 in boot. It is available in gd->handoff. The state state is set up
230 in SPL (or TPL if that is being used).
231
Simon Glassb0edea32018-11-15 18:44:09 -0700232config SPL_HANDOFF
233 bool "Pass hand-off information from SPL to U-Boot proper"
Simon Glassa7da3d92019-09-25 08:11:17 -0600234 depends on HANDOFF && SPL_BLOBLIST
Simon Glassb0edea32018-11-15 18:44:09 -0700235 default y
236 help
237 This option enables SPL to write handoff information. This can be
238 used to pass information like the size of SDRAM from SPL to U-Boot
239 proper. Also SPL can receive information from TPL in the same place
240 if that is enabled.
241
Philipp Tomsichdd6fbcb2017-07-28 19:20:49 +0200242config SPL_LDSCRIPT
243 string "Linker script for the SPL stage"
Tom Rini5858b902022-06-08 08:24:37 -0400244 default "arch/arm/cpu/arm926ejs/sunxi/u-boot-spl.lds" if MACH_SUNIV
245 default "arch/arm/cpu/armv7/sunxi/u-boot-spl.lds" if ARCH_SUNXI && !MACH_SUNIV && !ARM64
246 default "arch/arm/cpu/arm926ejs/mxs/u-boot-spl.lds" if (ARCH_MX23 || ARCH_MX28) && !SPL_FRAMEWORK
247 default "arch/arm/cpu/arm1136/u-boot-spl.lds" if CPU_ARM1136
248 default "arch/arm/cpu/armv8/u-boot-spl.lds" if ARCH_LS1043A || ARCH_LS1046A || ARCH_LS2080A
249 default "arch/arm/cpu/armv8/u-boot-spl.lds" if ARM64
250 default "arch/arm/mach-at91/arm926ejs/u-boot-spl.lds" if ARCH_AT91 && CPU_ARM926EJS
251 default "arch/arm/mach-at91/armv7/u-boot-spl.lds" if ARCH_AT91 && CPU_V7A
252 default "arch/arm/mach-omap2/u-boot-spl.lds" if ARCH_MX6 || ARCH_OMAP2PLUS || (ARCH_K3 && !ARM64)
253 default "arch/arm/mach-zynq/u-boot-spl.lds" if ARCH_ZYNQ
254 default "board/samsung/common/exynos-uboot-spl.lds" if ARCH_EXYNOS5 || ARCH_EXYNOS4
255 default "board/davinci/da8xxevm/u-boot-spl-da850evm.lds" if ARCH_DAVINCI
Tom Rinia356e7a2020-03-11 18:11:11 -0400256 default "arch/\$(ARCH)/cpu/u-boot-spl.lds"
Philipp Tomsichdd6fbcb2017-07-28 19:20:49 +0200257 help
258 The SPL stage will usually require a different linker-script
259 (as it runs from a different memory region) than the regular
260 U-Boot stage. Set this to the path of the linker-script to
261 be used for SPL.
262
Simon Goldschmidtf89d6132018-09-30 14:31:53 +0200263config SPL_TEXT_BASE
264 hex "SPL Text Base"
Andrew Davisa9ec2f62022-07-15 12:31:48 -0500265 default 0x402F4000 if AM43XX
266 default 0x402F0400 if AM33XX
267 default 0x40301350 if OMAP54XX
Andre Przywara9340d8f2019-05-27 01:45:11 +0100268 default 0x10060 if MACH_SUN50I || MACH_SUN50I_H5 || MACH_SUN9I
Andre Przywara4a9e89a2022-10-05 17:54:19 +0100269 default 0x20060 if SUN50I_GEN_H6 || SUNXI_GEN_NCAT2
Andre Przywara9340d8f2019-05-27 01:45:11 +0100270 default 0x00060 if ARCH_SUNXI
Michal Simek0413f9c2019-09-11 08:49:31 +0200271 default 0xfffc0000 if ARCH_ZYNQMP
Simon Goldschmidtf89d6132018-09-30 14:31:53 +0200272 default 0x0
273 help
274 The address in memory that SPL will be running from.
275
Ley Foon Tan0680f1b2017-05-03 17:13:32 +0800276config SPL_BOARD_INIT
Ley Foon Tan0680f1b2017-05-03 17:13:32 +0800277 bool "Call board-specific initialization in SPL"
278 help
279 If this option is enabled, U-Boot will call the function
280 spl_board_init() from board_init_r(). This function should be
281 provided by the board.
282
Sean Anderson5271e352023-11-08 11:48:43 -0500283config SPL_LOAD_BLOCK
284 bool
285 help
286 Support loading images from block devices. This adds a bl_len member
287 to struct spl_load_info.
288
Philipp Tomsich225d30b2017-06-22 23:38:36 +0200289config SPL_BOOTROM_SUPPORT
Michal Simekce869b52021-05-20 13:08:44 +0200290 bool "Support returning to the BOOTROM"
Sean Anderson5271e352023-11-08 11:48:43 -0500291 select SPL_LOAD_BLOCK if MACH_IMX
Philipp Tomsich225d30b2017-06-22 23:38:36 +0200292 help
293 Some platforms (e.g. the Rockchip RK3368) provide support in their
294 ROM for loading the next boot-stage after performing basic setup
295 from the SPL stage.
296
297 Enable this option, to return to the BOOTROM through the
298 BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
299 boot device list, if not implemented for a given board)
300
Lukasz Majewskiafa96092018-05-02 16:10:50 +0200301config SPL_BOOTCOUNT_LIMIT
302 bool "Support bootcount in SPL"
Philippe Reynes4d145f22020-12-11 19:56:47 +0100303 depends on SPL_ENV_SUPPORT && !TPL_BOOTCOUNT_LIMIT
Lukasz Majewskiafa96092018-05-02 16:10:50 +0200304 help
305 On some boards, which use 'falcon' mode, it is necessary to check
306 and increment the number of boot attempts. Such boards do not
307 use proper U-Boot for normal boot flow and hence needs those
308 adjustments to be done in the SPL.
309
Andrew F. Davis24eb39b2017-02-16 11:18:38 -0600310config SPL_RAW_IMAGE_SUPPORT
311 bool "Support SPL loading and booting of RAW images"
Pali Rohár35ed1762022-05-24 10:58:42 +0200312 default n if ARCH_MVEBU
Simon Glassf7560372021-08-08 12:20:17 -0600313 default n if (ARCH_MX6 && (SPL_MMC || SPL_SATA))
Andrew Davis11f32da2022-05-04 15:52:26 -0500314 default y
315 depends on !TI_SECURE_DEVICE
Andrew F. Davis24eb39b2017-02-16 11:18:38 -0600316 help
317 SPL will support loading and booting a RAW image when this option
318 is y. If this is not set, SPL will move on to other available
319 boot media to find a suitable image.
320
Andrew Davis6665ab12022-05-04 15:52:25 -0500321config SPL_LEGACY_IMAGE_FORMAT
Andrew F. Davis722a6b12017-02-16 11:18:39 -0600322 bool "Support SPL loading and booting of Legacy images"
Pali Rohár35ed1762022-05-24 10:58:42 +0200323 default n if ARCH_MVEBU
Andrew Davis11f32da2022-05-04 15:52:26 -0500324 default y if !SPL_LOAD_FIT
325 depends on !TI_SECURE_DEVICE
Andrew F. Davis722a6b12017-02-16 11:18:39 -0600326 help
327 SPL will support loading and booting Legacy images when this option
328 is y. If this is not set, SPL will move on to other available
329 boot media to find a suitable image.
330
Simon Goldschmidtdae5c2d2019-02-10 21:34:37 +0100331config SPL_LEGACY_IMAGE_CRC_CHECK
332 bool "Check CRC of Legacy images"
Andrew Davis6665ab12022-05-04 15:52:25 -0500333 depends on SPL_LEGACY_IMAGE_FORMAT
Simon Glass1e52db62021-07-14 17:05:32 -0500334 select SPL_CRC32
Simon Goldschmidtdae5c2d2019-02-10 21:34:37 +0100335 help
336 Enable this to check the CRC of Legacy images. While this increases
337 reliability, it affects both code size and boot duration.
338 If disabled, Legacy images are booted if the image magic and size
339 are correct, without further integrity checks.
340
Sean Anderson12b33392023-10-14 16:47:45 -0400341config SPL_LOAD_IMX_CONTAINER
342 bool "Enable SPL loading and booting of i.MX8 Containers"
343 depends on SPL
344 help
345 Support booting U-Boot from an i.MX8 container image. If you are not
346 using i.MX8, say 'n'.
347
348config IMX_CONTAINER_CFG
349 string "i.MX8 Container config file"
350 depends on SPL && SPL_LOAD_IMX_CONTAINER
351 help
352 Specify the cfg file for generating the container image which will be
353 loaded by SPL.
354
Simon Glassc2ae7d82016-09-12 23:18:22 -0600355config SPL_SYS_MALLOC_SIMPLE
Tom Riniab0c5f12022-05-30 17:11:23 -0400356 bool "Only use malloc_simple functions in the SPL"
Simon Glassc2ae7d82016-09-12 23:18:22 -0600357 help
358 Say Y here to only use the *_simple malloc functions from
359 malloc_simple.c, rather then using the versions from dlmalloc.c;
360 this will make the SPL binary smaller at the cost of more heap
361 usage as the *_simple malloc functions do not re-use free-ed mem.
362
Tom Rinif113d7d2022-05-26 13:13:21 -0400363config SPL_SHARES_INIT_SP_ADDR
364 bool "SPL and U-Boot use the same initial stack pointer location"
365 depends on (ARM || ARCH_JZ47XX || MICROBLAZE || RISCV) && SPL_FRAMEWORK
Tom Rini8b83b532022-05-26 13:46:32 -0400366 default n if ARCH_SUNXI || ARCH_MX6 || ARCH_MX7
Tom Rinif113d7d2022-05-26 13:13:21 -0400367 default y
368 help
369 In many cases, we can use the same initial stack pointer address for
370 both SPL and U-Boot itself. If you need to specify a different address
371 however, say N here and then set a different value in CONFIG_SPL_STACK.
372
373config SPL_STACK
374 hex "Initial stack pointer location"
375 depends on (ARM || ARCH_JZ47XX || MICROBLAZE || RISCV) && SPL_FRAMEWORK
376 depends on !SPL_SHARES_INIT_SP_ADDR
Tom Rini8b83b532022-05-26 13:46:32 -0400377 default 0x946bb8 if ARCH_MX7
Tom Rini23780392022-05-26 13:36:17 -0400378 default 0x93ffb8 if ARCH_MX6 && MX6_OCRAM_256KB
379 default 0x91ffb8 if ARCH_MX6 && !MX6_OCRAM_256KB
Andre Przywara177040b2022-09-13 01:23:58 +0100380 default 0x118000 if MACH_SUN50I_H6
381 default 0x58000 if MACH_SUN50I_H616
Andre Przywara95168d72022-09-06 15:59:57 +0100382 default 0x40000 if MACH_SUN8I_R528
Andre Przywara177040b2022-09-13 01:23:58 +0100383 default 0x54000 if MACH_SUN50I || MACH_SUN50I_H5
384 default 0x18000 if MACH_SUN9I
385 default 0x8000 if ARCH_SUNXI
Tom Rinif113d7d2022-05-26 13:13:21 -0400386 help
387 Address of the start of the stack SPL will use before SDRAM is
388 initialized.
389
Simon Glassc2ae7d82016-09-12 23:18:22 -0600390config SPL_STACK_R
Simon Glassc2ae7d82016-09-12 23:18:22 -0600391 bool "Enable SDRAM location for SPL stack"
392 help
393 SPL starts off execution in SRAM and thus typically has only a small
394 stack available. Since SPL sets up DRAM while in its board_init_f()
395 function, it is possible for the stack to move there before
396 board_init_r() is reached. This option enables a special SDRAM
397 location for the SPL stack. U-Boot SPL switches to this after
398 board_init_f() completes, and before board_init_r() starts.
399
400config SPL_STACK_R_ADDR
401 depends on SPL_STACK_R
402 hex "SDRAM location for SPL stack"
Tom Riniff6c3122017-09-17 11:44:49 -0400403 default 0x82000000 if ARCH_OMAP2PLUS
Simon Glassc2ae7d82016-09-12 23:18:22 -0600404 help
405 Specify the address in SDRAM for the SPL stack. This will be set up
406 before board_init_r() is called.
407
408config SPL_STACK_R_MALLOC_SIMPLE_LEN
409 depends on SPL_STACK_R && SPL_SYS_MALLOC_SIMPLE
410 hex "Size of malloc_simple heap after switching to DRAM SPL stack"
Neha Malcom Francise875cab2023-01-11 18:11:23 +0530411 default 0x400000 if ARCH_K3 && ARM64
Simon Glassc2ae7d82016-09-12 23:18:22 -0600412 default 0x100000
413 help
414 Specify the amount of the stack to use as memory pool for
415 malloc_simple after switching the stack to DRAM. This may be set
416 to give board_init_r() a larger heap then the initial heap in
417 SRAM which is limited to SYS_MALLOC_F_LEN bytes.
418
419config SPL_SEPARATE_BSS
Simon Glassc2ae7d82016-09-12 23:18:22 -0600420 bool "BSS section is in a different memory region from text"
421 help
422 Some platforms need a large BSS region in SPL and can provide this
423 because RAM is already set up. In this case BSS can be moved to RAM.
424 This option should then be enabled so that the correct device tree
425 location is used. Normally we put the device tree at the end of BSS
426 but with this option enabled, it goes at _image_binary_end.
427
Simon Glass82e26e02023-09-26 08:14:16 -0600428config SPL_SYS_MALLOC
Tom Rini10f6e4d2022-05-27 12:48:32 -0400429 bool "Enable malloc pool in SPL"
430 depends on SPL_FRAMEWORK
431
Simon Glass82e26e02023-09-26 08:14:16 -0600432config SPL_HAS_CUSTOM_MALLOC_START
Tom Rini10f6e4d2022-05-27 12:48:32 -0400433 bool "For the SPL malloc pool, define a custom starting address"
Simon Glass82e26e02023-09-26 08:14:16 -0600434 depends on SPL_SYS_MALLOC
Tom Rini10f6e4d2022-05-27 12:48:32 -0400435
Simon Glass82e26e02023-09-26 08:14:16 -0600436config SPL_CUSTOM_SYS_MALLOC_ADDR
Tom Rini10f6e4d2022-05-27 12:48:32 -0400437 hex "SPL malloc addr"
Simon Glass82e26e02023-09-26 08:14:16 -0600438 depends on SPL_HAS_CUSTOM_MALLOC_START
Tom Rini10f6e4d2022-05-27 12:48:32 -0400439
Simon Glass82e26e02023-09-26 08:14:16 -0600440config SPL_SYS_MALLOC_SIZE
Tom Rini10f6e4d2022-05-27 12:48:32 -0400441 hex "Size of the SPL malloc pool"
Simon Glass82e26e02023-09-26 08:14:16 -0600442 depends on SPL_SYS_MALLOC
Tom Rini10f6e4d2022-05-27 12:48:32 -0400443 default 0x100000
444
Simon Glass95a58252021-03-15 17:25:35 +1300445config SPL_READ_ONLY
446 bool
447 depends on SPL_OF_PLATDATA
448 # Bind cannot be supported because the udevice structs are in read-only
449 # memory so we cannot update the linked lists.
450 select SPL_OF_PLATDATA_NO_BIND
451 select SPL_OF_PLATDATA_RT
452 help
453 Some platforms (e.g. x86 Apollo Lake) load SPL into a read-only
454 section of memory. This means that of-platdata must make a copy (in
455 writeable memory) of anything it wants to modify, such as
456 device-private data.
457
Simon Glassaedc08b2018-11-15 18:43:57 -0700458config SPL_BANNER_PRINT
459 bool "Enable output of the SPL banner 'U-Boot SPL ...'"
460 default y
461 help
462 If this option is enabled, SPL will print the banner with version
Thomas Hebb32f2ca22019-11-13 18:18:03 -0800463 info. Disabling this option could be useful to reduce SPL boot time
Simon Glassaedc08b2018-11-15 18:43:57 -0700464 (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
465
Andreas Dannenberga5a5d992019-06-04 17:55:45 -0500466config SPL_EARLY_BSS
467 depends on ARM && !ARM64
468 bool "Allows initializing BSS early before entering board_init_f"
469 help
470 On some platform we have sufficient memory available early on to
471 allow setting up and using a basic BSS prior to entering
472 board_init_f. Activating this option will also de-activate the
473 clearing of BSS during the SPL relocation process, thus allowing
474 to carry state from board_init_f to board_init_r by way of BSS.
475
Simon Glassa807ab32016-09-24 18:19:56 -0600476config SPL_DISPLAY_PRINT
Simon Glassa807ab32016-09-24 18:19:56 -0600477 bool "Display a board-specific message in SPL"
478 help
479 If this option is enabled, U-Boot will call the function
480 spl_display_print() immediately after displaying the SPL console
481 banner ("U-Boot SPL ..."). This function should be provided by
482 the board.
483
Sean Anderson5d3401a2023-11-08 11:48:50 -0500484config SPL_SYS_MMCSD_RAW_MODE
485 bool
486 help
487 Support booting from an MMC without a filesystem.
488
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200489config SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
490 bool "MMC raw mode: by sector"
Fabio Estevam1da19382018-06-11 15:08:05 -0300491 default y if ARCH_SUNXI || ARCH_DAVINCI || ARCH_UNIPHIER || \
492 ARCH_MX6 || ARCH_MX7 || \
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200493 ARCH_ROCKCHIP || ARCH_MVEBU || ARCH_SOCFPGA || \
494 ARCH_AT91 || ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || \
Bin Mengae2d9502021-03-17 11:10:58 +0800495 OMAP44XX || OMAP54XX || AM33XX || AM43XX || \
Green Wan70415e12021-05-27 06:52:13 -0700496 TARGET_SIFIVE_UNLEASHED || TARGET_SIFIVE_UNMATCHED
Sean Anderson5271e352023-11-08 11:48:43 -0500497 select SPL_LOAD_BLOCK if SPL_MMC
Sean Anderson5d3401a2023-11-08 11:48:50 -0500498 select SPL_SYS_MMCSD_RAW_MODE if SPL_MMC
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200499 help
500 Use sector number for specifying U-Boot location on MMC/SD in
501 raw mode.
502
503config SYS_MMCSD_RAW_MODE_U_BOOT_SECTOR
504 hex "Address on the MMC to load U-Boot from"
Tom Rini226498b2017-05-22 19:21:57 +0000505 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
Andre Przywarac0b417b2021-01-11 21:11:39 +0100506 default 0x40 if ARCH_SUNXI
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200507 default 0x75 if ARCH_DAVINCI
Fabio Estevam1da19382018-06-11 15:08:05 -0300508 default 0x8a if ARCH_MX6 || ARCH_MX7
Kever Yang8f4d62b2017-11-02 15:16:34 +0800509 default 0x100 if ARCH_UNIPHIER
Pali Rohár2226ca12021-07-23 11:14:29 +0200510 default 0x0 if ARCH_MVEBU
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200511 default 0x200 if ARCH_SOCFPGA || ARCH_AT91
512 default 0x300 if ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || OMAP44XX || \
Lokesh Vutla586bde92018-08-27 15:57:08 +0530513 OMAP54XX || AM33XX || AM43XX || ARCH_K3
Kever Yang8f4d62b2017-11-02 15:16:34 +0800514 default 0x4000 if ARCH_ROCKCHIP
Green Wan70415e12021-05-27 06:52:13 -0700515 default 0x822 if TARGET_SIFIVE_UNLEASHED || TARGET_SIFIVE_UNMATCHED
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200516 help
517 Address on the MMC to load U-Boot from, when the MMC is being used
518 in raw mode. Units: MMC sectors (1 sector = 512 bytes).
519
Baruch Siache42afd82020-01-15 09:08:08 +0200520config SYS_MMCSD_RAW_MODE_U_BOOT_DATA_PART_OFFSET
521 hex "U-Boot main hardware partition image offset"
522 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
Andre Przywarac0b417b2021-01-11 21:11:39 +0100523 default 0x10 if ARCH_SUNXI
Baruch Siache42afd82020-01-15 09:08:08 +0200524 default 0x0
525 help
526 On some platforms SPL location depends on hardware partition. The ROM
527 code skips the MBR sector when loading SPL from main hardware data
528 partition. This adds offset to the main U-Boot image. Set this symbol
529 to the number of skipped sectors.
530
531 If unsure, leave the default.
532
Dalon Westergreen949123e2017-02-10 17:15:35 -0800533config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
534 bool "MMC Raw mode: by partition"
Sean Anderson5271e352023-11-08 11:48:43 -0500535 select SPL_LOAD_BLOCK if SPL_MMC
Sean Anderson5d3401a2023-11-08 11:48:50 -0500536 select SPL_SYS_MMCSD_RAW_MODE if SPL_MMC
Dalon Westergreen949123e2017-02-10 17:15:35 -0800537 help
538 Use a partition for loading U-Boot when using MMC/SD in raw mode.
539
540config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION
541 hex "Partition to use to load U-Boot from"
Tom Rini226498b2017-05-22 19:21:57 +0000542 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
Dalon Westergreen949123e2017-02-10 17:15:35 -0800543 default 1
544 help
545 Partition on the MMC to load U-Boot from when the MMC is being
546 used in raw mode
547
Dalon Westergreenf0fb4fa2017-02-10 17:15:34 -0800548config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
549 bool "MMC raw mode: by partition type"
Tom Rini226498b2017-05-22 19:21:57 +0000550 depends on DOS_PARTITION && SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
Dalon Westergreenf0fb4fa2017-02-10 17:15:34 -0800551 help
552 Use partition type for specifying U-Boot partition on MMC/SD in
553 raw mode. U-Boot will be loaded from the first partition of this
554 type to be found.
555
556config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION_TYPE
557 hex "Partition Type on the MMC to load U-Boot from"
Tom Rini226498b2017-05-22 19:21:57 +0000558 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
Dalon Westergreenf0fb4fa2017-02-10 17:15:34 -0800559 help
560 Partition Type on the MMC to load U-Boot from, when the MMC is being
561 used in raw mode.
562
Anatolij Gustschin32ded502019-10-18 21:38:33 +0200563config SUPPORT_EMMC_BOOT_OVERRIDE_PART_CONFIG
564 bool "Override eMMC EXT_CSC_PART_CONFIG by user defined partition"
565 depends on SUPPORT_EMMC_BOOT
566 help
567 eMMC boot partition is normally configured by the bits of the EXT_CSD
568 register (EXT_CSC_PART_CONFIG), BOOT_PARTITION_ENABLE field. In some
569 cases it might be required in SPL to load the image from different
570 partition than the partition selected by EXT_CSC_PART_CONFIG register.
571 Enable this option if you intend to use an eMMC boot partition other
572 then selected via EXT_CSC_PART_CONFIG register and specify the custom
573 partition number by the CONFIG_SYS_MMCSD_RAW_MODE_EMMC_BOOT_PARTITION
574 option.
575
576config SYS_MMCSD_RAW_MODE_EMMC_BOOT_PARTITION
577 int "Number of the eMMC boot partition to use"
578 depends on SUPPORT_EMMC_BOOT_OVERRIDE_PART_CONFIG
579 default 1
580 help
581 eMMC boot partition number to use when the eMMC in raw mode and
582 the eMMC EXT_CSC_PART_CONFIG selection should be overridden in SPL
583 by user defined partition number.
584
Philipp Tomsich337bbb62017-11-24 13:26:03 +0100585config SPL_FIT_IMAGE_TINY
586 bool "Remove functionality from SPL FIT loading to reduce size"
587 depends on SPL_FIT
Jernej Skrabec44726092021-01-11 21:11:34 +0100588 default y if MACH_SUN50I || MACH_SUN50I_H5 || SUN50I_GEN_H6
Peng Fan65c56bc2022-07-26 16:40:45 +0800589 default y if ARCH_IMX8M || ARCH_IMX9
Philipp Tomsich337bbb62017-11-24 13:26:03 +0100590 help
591 Enable this to reduce the size of the FIT image loading code
592 in SPL, if space for the SPL binary is very tight.
593
Samuel Hollandcf705532020-10-21 21:12:13 -0500594 This skips the recording of each loaded payload
Philipp Tomsich337bbb62017-11-24 13:26:03 +0100595 (i.e. loadable) into the FDT (modifying the loaded FDT to
596 ensure this information is available to the next image
597 invoked).
598
Simon Glassde213c72021-08-08 12:20:15 -0600599config SPL_CACHE
Rick Chen31dae222019-11-14 13:52:26 +0800600 bool "Support CACHE drivers"
601 help
602 Enable CACHE drivers in SPL. These drivers can keep data so that
603 future requests for that data can be served faster. Enable this option
604 to build the drivers in drivers/cache as part of an SPL build.
605
Simon Glass529d5f92021-03-15 18:11:18 +1300606config SPL_CPU
Simon Glass5e148df2017-01-16 07:03:29 -0700607 bool "Support CPU drivers"
Simon Glass5e148df2017-01-16 07:03:29 -0700608 help
609 Enable this to support CPU drivers in SPL. These drivers can set
610 up CPUs and provide information about them such as the model and
611 name. This can be useful in SPL since setting up the CPUs earlier
612 may improve boot performance. Enable this option to build the
613 drivers in drivers/cpu as part of an SPL build.
614
Simon Glass0c6bdbb2021-07-10 21:14:25 -0600615config SPL_CRYPTO
Simon Glass11bde1c2016-09-13 07:05:23 -0600616 bool "Support crypto drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -0600617 help
618 Enable crypto drivers in SPL. These drivers can be used to
619 accelerate secure boot processing in secure applications. Enable
620 this option to build the drivers in drivers/crypto as part of an
621 SPL build.
622
Vignesh Raghavendra74326a32019-11-15 17:00:41 +0530623config SPL_DMA
Simon Glass11bde1c2016-09-13 07:05:23 -0600624 bool "Support DMA drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -0600625 help
626 Enable DMA (direct-memory-access) drivers in SPL. These drivers
627 can be used to handle memory-to-peripheral data transfer without
628 the CPU moving the data. Enable this option to build the drivers
629 in drivers/dma as part of an SPL build.
630
Simon Glass9ca00682021-07-10 21:14:31 -0600631config SPL_DRIVERS_MISC
Simon Glass11bde1c2016-09-13 07:05:23 -0600632 bool "Support misc drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -0600633 help
634 Enable miscellaneous drivers in SPL. These drivers perform various
635 tasks that don't fall nicely into other categories, Enable this
636 option to build the drivers in drivers/misc as part of an SPL
637 build, for those that support building in SPL (not all drivers do).
638
639config SPL_ENV_SUPPORT
640 bool "Support an environment"
Simon Glass11bde1c2016-09-13 07:05:23 -0600641 help
642 Enable environment support in SPL. The U-Boot environment provides
643 a number of settings (essentially name/value pairs) which can
644 control many aspects of U-Boot's operation. Normally this is not
645 needed in SPL as it has a much simpler task with less
646 configuration. But some boards use this to support 'Falcon' boot
647 on EXT2 and FAT, where SPL boots directly into Linux without
Simon Glass00caae62017-08-03 12:22:12 -0600648 starting U-Boot first. Enabling this option will make env_get()
Simon Glass382bee52017-08-03 12:22:09 -0600649 and env_set() available in SPL.
Simon Glass11bde1c2016-09-13 07:05:23 -0600650
B, Ravid2d9bdf2016-09-28 14:46:18 +0530651config SPL_SAVEENV
652 bool "Support save environment"
Tom Rini226498b2017-05-22 19:21:57 +0000653 depends on SPL_ENV_SUPPORT
Jean-Jacques Hiblotd6400c32018-01-04 15:23:32 +0100654 select SPL_MMC_WRITE if ENV_IS_IN_MMC
B, Ravid2d9bdf2016-09-28 14:46:18 +0530655 help
656 Enable save environment support in SPL after setenv. By default
657 the saveenv option is not provided in SPL, but some boards need
658 this support in 'Falcon' boot, where SPL need to boot from
659 different images based on environment variable set by OS. For
660 example OS may set "reboot_image" environment variable to
661 "recovery" inorder to boot recovery image by SPL. The SPL read
662 "reboot_image" and act accordingly and change the reboot_image
Shyam Saini919d25c2018-06-07 19:47:19 +0530663 to default mode using setenv and save the environment.
B, Ravid2d9bdf2016-09-28 14:46:18 +0530664
Simon Glassf2d7a362021-07-10 21:14:26 -0600665config SPL_ETH
Simon Glass11bde1c2016-09-13 07:05:23 -0600666 bool "Support Ethernet"
667 depends on SPL_ENV_SUPPORT
Simon Glass9f664922021-08-08 12:20:31 -0600668 depends on SPL_NET
Simon Glass11bde1c2016-09-13 07:05:23 -0600669 help
670 Enable access to the network subsystem and associated Ethernet
671 drivers in SPL. This permits SPL to load U-Boot over an Ethernet
672 link rather than from an on-board peripheral. Environment support
673 is required since the network stack uses a number of environment
Simon Glass5ed16a92021-08-08 12:20:30 -0600674 variables. See also SPL_NET.
Simon Glass11bde1c2016-09-13 07:05:23 -0600675
Tien Fong Cheef4b40922019-01-23 14:20:05 +0800676config SPL_FS_EXT4
Simon Glass11bde1c2016-09-13 07:05:23 -0600677 bool "Support EXT filesystems"
Sean Anderson44071cd2023-10-14 16:47:49 -0400678 select SPL_CRC16 if EXT4_WRITE
Simon Glass11bde1c2016-09-13 07:05:23 -0600679 help
680 Enable support for EXT2/3/4 filesystems with SPL. This permits
681 U-Boot (or Linux in Falcon mode) to be loaded from an EXT
682 filesystem from within SPL. Support for the underlying block
683 device (e.g. MMC or USB) must be enabled separately.
684
Joao Marcos Costac5100612020-07-30 15:33:47 +0200685config SPL_FS_SQUASHFS
686 bool "Support SquashFS filesystems"
687 select FS_SQUASHFS
688 help
689 Enable support for SquashFS filesystems with SPL. This permits
690 U-Boot (or Linux in Falcon mode) to be loaded from a SquashFS
691 filesystem from within SPL. Support for the underlying block
692 device (e.g. MMC or USB) must be enabled separately.
693
Tien Fong Chee0c3a9ed2019-01-23 14:20:03 +0800694config SPL_FS_FAT
Simon Glass11bde1c2016-09-13 07:05:23 -0600695 bool "Support FAT filesystems"
Sekhar Norieedfb892017-06-02 17:53:59 +0530696 select FS_FAT
Simon Glass11bde1c2016-09-13 07:05:23 -0600697 help
698 Enable support for FAT and VFAT filesystems with SPL. This
699 permits U-Boot (or Linux in Falcon mode) to be loaded from a FAT
700 filesystem from within SPL. Support for the underlying block
701 device (e.g. MMC or USB) must be enabled separately.
702
Sean Anderson54a8d842023-11-08 11:48:58 -0500703config SPL_FS_FAT_DMA_ALIGN
704 bool "Use DMA-aligned buffers with FAT"
705 depends on SPL_FS_FAT
706 select SPL_LOAD_BLOCK
707 default y if SPL_LOAD_FIT
708 help
709 The FAT filesystem driver tries to ensure that the reads it issues to
710 the block subsystem use DMA-aligned buffers. If the supplied buffer is
711 not DMA-aligned, the FAT driver will use a bounce-buffer and read
712 block-by-block. This is separate from the bounce-buffer used by the
713 block subsystem (CONFIG_BOUNCE_BUFFER).
714
715 Enable this config to align buffers passed to the FAT filesystem
716 driver. This will speed up reads, but will increase the size of U-Boot
717 by around 60 bytes.
718
Tom Rini4a11e342022-05-13 17:12:35 -0400719config SPL_FS_LOAD_PAYLOAD_NAME
720 string "File to load for U-Boot from the filesystem"
Kautuk Consulac141552022-12-07 17:12:36 +0530721 depends on SPL_FS_EXT4 || SPL_FS_FAT || SPL_FS_SQUASHFS || SPL_SEMIHOSTING
Tom Rini4a11e342022-05-13 17:12:35 -0400722 default "tispl.bin" if SYS_K3_SPL_ATF
723 default "u-boot.itb" if SPL_LOAD_FIT
724 default "u-boot.img"
725 help
726 Filename to read to load U-Boot when reading from filesystem.
727
728config SPL_FS_LOAD_KERNEL_NAME
729 string "File to load for the OS kernel from the filesystem"
730 depends on (SPL_FS_EXT4 || SPL_FS_FAT || SPL_FS_SQUASHFS) && SPL_OS_BOOT
731 default "uImage"
732 help
733 Filename to read to load for the OS kernel when reading from the
734 filesystem.
735
736config SPL_FS_LOAD_ARGS_NAME
737 string "File to load for the OS kernel argument parameters from the filesystem"
738 depends on (SPL_FS_EXT4 || SPL_FS_FAT || SPL_FS_SQUASHFS) && SPL_OS_BOOT
739 default "args"
740 help
741 Filename to read to load for the OS kernel argument parameters from
742 the filesystem.
743
Tien Fong Cheed8c3ea92019-01-23 14:20:04 +0800744config SPL_FAT_WRITE
745 bool "Support write for FAT filesystems"
746 help
747 Enable write support for FAT and VFAT filesystems with SPL.
748 Support for the underlying block device (e.g. MMC or USB) must be
749 enabled separately.
750
Michal Simek29bd8ad2020-09-09 14:41:56 +0200751config SPL_FPGA
Simon Glass11bde1c2016-09-13 07:05:23 -0600752 bool "Support FPGAs"
Simon Glass11bde1c2016-09-13 07:05:23 -0600753 help
754 Enable support for FPGAs in SPL. Field-programmable Gate Arrays
755 provide software-configurable hardware which is typically used to
756 implement peripherals (such as UARTs, LCD displays, MMC) or
757 accelerate custom processing functions, such as image processing
758 or machine learning. Sometimes it is useful to program the FPGA
759 as early as possible during boot, and this option can enable that
760 within SPL.
761
Simon Glass83061db2021-07-10 21:14:30 -0600762config SPL_GPIO
Simon Glass2d424eb2018-11-15 18:43:55 -0700763 bool "Support GPIO in SPL"
Simon Glass11bde1c2016-09-13 07:05:23 -0600764 help
765 Enable support for GPIOs (General-purpose Input/Output) in SPL.
766 GPIOs allow U-Boot to read the state of an input line (high or
767 low) and set the state of an output line. This can be used to
768 drive LEDs, control power to various system parts and read user
769 input. GPIOs can be useful in SPL to enable a 'sign-of-life' LED,
770 for example. Enable this option to build the drivers in
771 drivers/gpio as part of an SPL build.
772
Simon Glass975e7cf2021-07-10 21:14:36 -0600773config SPL_I2C
Simon Glass11bde1c2016-09-13 07:05:23 -0600774 bool "Support I2C"
Simon Glass11bde1c2016-09-13 07:05:23 -0600775 help
776 Enable support for the I2C (Inter-Integrated Circuit) bus in SPL.
777 I2C works with a clock and data line which can be driven by a
778 one or more masters or slaves. It is a fairly complex bus but is
779 widely used as it only needs two lines for communication. Speeds of
780 400kbps are typical but up to 3.4Mbps is supported by some
781 hardware. I2C can be useful in SPL to configure power management
782 ICs (PMICs) before raising the CPU clock speed, for example.
783 Enable this option to build the drivers in drivers/i2c as part of
784 an SPL build.
785
786config SPL_LIBCOMMON_SUPPORT
787 bool "Support common libraries"
Simon Glass11bde1c2016-09-13 07:05:23 -0600788 help
789 Enable support for common U-Boot libraries within SPL. These
790 libraries include common code to deal with U-Boot images,
791 environment and USB, for example. This option is enabled on many
792 boards. Enable this option to build the code in common/ as part of
793 an SPL build.
794
795config SPL_LIBDISK_SUPPORT
Simon Goldschmidt00416702018-08-16 09:44:55 +0200796 bool "Support disk partitions"
Tom Rini91ff6862018-12-05 08:23:38 -0500797 select PARTITIONS
Simon Glass11bde1c2016-09-13 07:05:23 -0600798 help
799 Enable support for disk partitions within SPL. 'Disk' is something
800 of a misnomer as it includes non-spinning media such as flash (as
801 used in MMC and USB sticks). Partitions provide a way for a disk
802 to be split up into separate regions, with a partition table placed
803 at the start or end which describes the location and size of each
804 'partition'. These partitions are typically uses as individual block
805 devices, typically with an EXT2 or FAT filesystem in each. This
806 option enables whatever partition support has been enabled in
807 U-Boot to also be used in SPL. It brings in the code in disk/.
808
809config SPL_LIBGENERIC_SUPPORT
810 bool "Support generic libraries"
Simon Glass11bde1c2016-09-13 07:05:23 -0600811 help
812 Enable support for generic U-Boot libraries within SPL. These
813 libraries include generic code to deal with device tree, hashing,
814 printf(), compression and the like. This option is enabled on many
815 boards. Enable this option to build the code in lib/ as part of an
816 SPL build.
817
Lokesh Vutla88027412018-08-27 15:57:49 +0530818config SPL_DM_MAILBOX
819 bool "Support Mailbox"
Tom Rini4151f4f2022-05-31 10:24:55 -0400820 depends on SPL_DM
Lokesh Vutla88027412018-08-27 15:57:49 +0530821 help
822 Enable support for Mailbox within SPL. This enable the inter
823 processor communication protocols tobe used within SPL. Enable
824 this option to build the drivers in drivers/mailbox as part of
825 SPL build.
826
Roger Quadros3a82cd22022-10-20 16:30:47 +0300827config SPL_MEMORY
828 bool "Support Memory controller drivers"
829 help
830 Enable support for Memory Controller drivers within SPL.
831 These devices provide Memory bus interface to various devices like
832 SRAM, Ethernet adapters, FPGAs, etc.
833
Simon Glass103c5f12021-08-08 12:20:09 -0600834config SPL_MMC
Simon Glass11bde1c2016-09-13 07:05:23 -0600835 bool "Support MMC"
Tom Rini226498b2017-05-22 19:21:57 +0000836 depends on MMC
Simon Glass11bde1c2016-09-13 07:05:23 -0600837 help
838 Enable support for MMC (Multimedia Card) within SPL. This enables
839 the MMC protocol implementation and allows any enabled drivers to
840 be used within SPL. MMC can be used with or without disk partition
841 support depending on the application (SPL_LIBDISK_SUPPORT). Enable
842 this option to build the drivers in drivers/mmc as part of an SPL
843 build.
844
Pali Rohár718d1c72023-01-21 15:13:08 +0100845config SYS_MMCSD_FS_BOOT
846 bool "MMC FS Boot mode"
847 depends on SPL_MMC
848 default y if !ARCH_MVEBU
849 help
850 Enable MMC FS Boot mode. Partition is selected by option
851 SYS_MMCSD_FS_BOOT_PARTITION.
852
Adam Fordacc415a2020-07-03 10:17:30 -0500853config SYS_MMCSD_FS_BOOT_PARTITION
854 int "MMC Boot Partition"
Pali Rohár718d1c72023-01-21 15:13:08 +0100855 depends on SYS_MMCSD_FS_BOOT
Adam Fordacc415a2020-07-03 10:17:30 -0500856 default 1
857 help
858 Partition on the MMC to load U-Boot from when the MMC is being
Jérôme Carretero5fa973e2022-03-15 16:34:51 -0400859 used in fs mode.
860 Use -1 as a special value to use the first bootable partition.
Adam Fordacc415a2020-07-03 10:17:30 -0500861
Ezequiel Garciabf7c01d2019-05-25 19:25:21 -0300862config SPL_MMC_TINY
863 bool "Tiny MMC framework in SPL"
Simon Glass103c5f12021-08-08 12:20:09 -0600864 depends on SPL_MMC
Ezequiel Garciabf7c01d2019-05-25 19:25:21 -0300865 help
866 Enable MMC framework tinification support. This option is useful if
867 if your SPL is extremely size constrained. Heed the warning, enable
868 this option if and only if you know exactly what you are doing, if
869 you are reading this help text, you most likely have no idea :-)
870
871 The MMC framework is reduced to bare minimum to be useful. No malloc
872 support is needed for the MMC framework operation with this option
873 enabled. The framework supports exactly one MMC device and exactly
874 one MMC driver. The MMC driver can be adjusted to avoid any malloc
875 operations too, which can remove the need for malloc support in SPL
876 and thus further reduce footprint.
877
Jean-Jacques Hiblotd6400c32018-01-04 15:23:32 +0100878config SPL_MMC_WRITE
879 bool "MMC/SD/SDIO card support for write operations in SPL"
Simon Glass103c5f12021-08-08 12:20:09 -0600880 depends on SPL_MMC
Jean-Jacques Hiblotd6400c32018-01-04 15:23:32 +0100881 help
882 Enable write access to MMC and SD Cards in SPL
883
884
Simon Glass6f004ad2021-08-08 12:20:16 -0600885config SPL_MPC8XXX_INIT_DDR
Simon Glass11bde1c2016-09-13 07:05:23 -0600886 bool "Support MPC8XXX DDR init"
Simon Glass11bde1c2016-09-13 07:05:23 -0600887 help
888 Enable support for DDR-SDRAM (double-data-rate synchronous dynamic
889 random-access memory) on the MPC8XXX family within SPL. This
890 allows DRAM to be set up before loading U-Boot into that DRAM,
891 where it can run.
892
Sean Andersonb35df872023-11-04 16:37:47 -0400893config SPL_MTD
Simon Glass11bde1c2016-09-13 07:05:23 -0600894 bool "Support MTD drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -0600895 help
896 Enable support for MTD (Memory Technology Device) within SPL. MTD
897 provides a block interface over raw NAND and can also be used with
898 SPI flash. This allows SPL to load U-Boot from supported MTD
899 devices. See SPL_NAND_SUPPORT and SPL_ONENAND_SUPPORT for how
900 to enable specific MTD drivers.
901
Simon Glass89ddb0b2021-07-10 21:14:27 -0600902config SPL_MUSB_NEW
Simon Glass11bde1c2016-09-13 07:05:23 -0600903 bool "Support new Mentor Graphics USB"
Simon Glass11bde1c2016-09-13 07:05:23 -0600904 help
905 Enable support for Mentor Graphics USB in SPL. This is a new
906 driver used by some boards. Enable this option to build
907 the drivers in drivers/usb/musb-new as part of an SPL build. The
908 old drivers are in drivers/usb/musb.
909
910config SPL_NAND_SUPPORT
911 bool "Support NAND flash"
Sean Anderson5271e352023-11-08 11:48:43 -0500912 select SPL_LOAD_BLOCK
Simon Glass11bde1c2016-09-13 07:05:23 -0600913 help
914 Enable support for NAND (Negative AND) flash in SPL. NAND flash
915 can be used to allow SPL to load U-Boot from supported devices.
Miquel Raynala430fa02018-08-16 17:30:07 +0200916 This enables the drivers in drivers/mtd/nand/raw as part of an SPL
Simon Glass11bde1c2016-09-13 07:05:23 -0600917 build.
918
Tom Rinibab1b352022-05-13 12:46:23 -0400919config SPL_NAND_RAW_ONLY
920 bool "Support to boot only raw u-boot.bin images"
921 depends on SPL_NAND_SUPPORT
922 help
923 Use this only if you need to save space.
924
Adam Ford0c4a6342020-07-03 08:09:44 -0500925config SPL_NAND_DRIVERS
926 bool "Use standard NAND driver"
927 help
928 SPL uses normal NAND drivers, not minimal drivers.
929
930config SPL_NAND_ECC
Tom Rinibab1b352022-05-13 12:46:23 -0400931 bool "Include standard ECC in SPL"
932
933config SPL_NAND_SOFTECC
934 bool "Use software ECC in SPL"
935 depends on SPL_NAND_ECC
Adam Ford0c4a6342020-07-03 08:09:44 -0500936
937config SPL_NAND_SIMPLE
938 bool "Support simple NAND drivers in SPL"
939 help
940 Support for NAND boot using simple NAND drivers that
941 expose the cmd_ctrl() interface.
942
Adam Ford38791062020-07-03 08:09:45 -0500943config SPL_NAND_BASE
Weijie Gao4c4bf042022-05-20 11:23:53 +0800944 depends on SPL_NAND_SUPPORT
Adam Ford38791062020-07-03 08:09:45 -0500945 bool "Use Base NAND Driver"
Michal Simekce869b52021-05-20 13:08:44 +0200946 help
947 Include nand_base.c in the SPL.
Adam Ford38791062020-07-03 08:09:45 -0500948
949config SPL_NAND_IDENT
950 depends on SPL_NAND_BASE
951 bool "Use chip ID to identify NAND flash"
952 help
953 SPL uses the chip ID list to identify the NAND flash.
954
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200955config SPL_UBI
956 bool "Support UBI"
957 help
958 Enable support for loading payloads from UBI. See
959 README.ubispl for more info.
960
Tom Rini4151f4f2022-05-31 10:24:55 -0400961menu "UBI configuration for SPL"
962 depends on SPL_UBI
Lukasz Majewskif18845c2019-09-09 12:06:46 +0200963
Hamish Guthrie6ea31cc2019-05-15 15:15:59 +0200964config SPL_UBI_LOAD_BY_VOLNAME
965 bool "Support loading volumes by name"
966 help
967 This enables support for loading UBI volumes by name. When this
968 is set, CONFIG_SPL_UBI_LOAD_MONITOR_VOLNAME can be used to
969 configure the volume name from which to load U-Boot.
970
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200971config SPL_UBI_MAX_VOL_LEBS
972 int "Maximum number of LEBs per volume"
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200973 help
974 The maximum number of logical eraseblocks which a static volume
975 to load can contain. Used for sizing the scan data structure.
976
977config SPL_UBI_MAX_PEB_SIZE
978 int "Maximum PEB size"
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200979 help
980 The maximum physical erase block size.
981
982config SPL_UBI_MAX_PEBS
983 int "Maximum number of PEBs"
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200984 help
985 The maximum physical erase block size. If not overridden by
986 board code, this value will be used as the actual number of PEBs.
987
988config SPL_UBI_PEB_OFFSET
989 int "Offset to first UBI PEB"
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200990 help
991 The offset in number of PEBs from the start of flash to the first
992 PEB part of the UBI image.
993
994config SPL_UBI_VID_OFFSET
995 int "Offset to VID header"
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200996
997config SPL_UBI_LEB_START
998 int "Offset to LEB in PEB"
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200999 help
1000 The offset in bytes to the LEB within a PEB.
1001
1002config SPL_UBI_INFO_ADDR
1003 hex "Address to place UBI scan info"
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +02001004 help
1005 Address for ubispl to place the scan info. Read README.ubispl to
1006 determine the required size
1007
1008config SPL_UBI_VOL_IDS
1009 int "Maximum volume id"
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +02001010 help
1011 The maximum volume id which can be loaded. Used for sizing the
1012 scan data structure.
1013
1014config SPL_UBI_LOAD_MONITOR_ID
1015 int "id of U-Boot volume"
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +02001016 help
1017 The UBI volume id from which to load U-Boot
1018
Hamish Guthrie6ea31cc2019-05-15 15:15:59 +02001019config SPL_UBI_LOAD_MONITOR_VOLNAME
1020 string "volume name of U-Boot volume"
1021 depends on SPL_UBI_LOAD_BY_VOLNAME
1022 help
1023 The UBI volume name from which to load U-Boot
1024
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +02001025config SPL_UBI_LOAD_KERNEL_ID
1026 int "id of kernel volume"
Tom Rini4151f4f2022-05-31 10:24:55 -04001027 depends on SPL_OS_BOOT
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +02001028 help
1029 The UBI volume id from which to load the kernel
1030
1031config SPL_UBI_LOAD_ARGS_ID
1032 int "id of kernel args volume"
Tom Rini4151f4f2022-05-31 10:24:55 -04001033 depends on SPL_OS_BOOT
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +02001034 help
1035 The UBI volume id from which to load the device tree
1036
Markus Klotzbuechera2257d32019-05-15 15:16:00 +02001037config UBI_SPL_SILENCE_MSG
1038 bool "silence UBI SPL messages"
Markus Klotzbuechera2257d32019-05-15 15:16:00 +02001039 help
1040 Disable messages from UBI SPL. This leaves warnings
1041 and errors enabled.
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +02001042
Tom Rini4151f4f2022-05-31 10:24:55 -04001043endmenu
1044
1045config SPL_DM_SPI
1046 bool "Support SPI DM drivers in SPL"
1047 depends on SPL_DM
1048 help
1049 Enable support for SPI DM drivers in SPL.
1050
1051config SPL_DM_SPI_FLASH
1052 bool "Support SPI DM FLASH drivers in SPL"
1053 depends on SPL_DM
1054 help
1055 Enable support for SPI DM flash drivers in SPL.
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +02001056
Simon Glass5ed16a92021-08-08 12:20:30 -06001057config SPL_NET
Simon Glass11bde1c2016-09-13 07:05:23 -06001058 bool "Support networking"
Simon Glass11bde1c2016-09-13 07:05:23 -06001059 help
1060 Enable support for network devices (such as Ethernet) in SPL.
1061 This permits SPL to load U-Boot over a network link rather than
1062 from an on-board peripheral. Environment support is required since
1063 the network stack uses a number of environment variables. See also
Simon Glassf2d7a362021-07-10 21:14:26 -06001064 SPL_ETH.
Simon Glass11bde1c2016-09-13 07:05:23 -06001065
Simon Glass11bde1c2016-09-13 07:05:23 -06001066config SPL_NET_VCI_STRING
1067 string "BOOTP Vendor Class Identifier string sent by SPL"
Tom Rini4151f4f2022-05-31 10:24:55 -04001068 depends on SPL_NET
Simon Glass11bde1c2016-09-13 07:05:23 -06001069 help
1070 As defined by RFC 2132 the vendor class identifier field can be
1071 sent by the client to identify the vendor type and configuration
1072 of a client. This is often used in practice to allow for the DHCP
1073 server to specify different files to load depending on if the ROM,
1074 SPL or U-Boot itself makes the request
Simon Glass11bde1c2016-09-13 07:05:23 -06001075
1076config SPL_NO_CPU_SUPPORT
Tom Rini4151f4f2022-05-31 10:24:55 -04001077 def_bool y
1078 depends on (ARCH_MX23 || ARCH_MX28) && !SPL_FRAMEWORK
Simon Glass11bde1c2016-09-13 07:05:23 -06001079 help
1080 This is specific to the ARM926EJ-S CPU. It disables the standard
1081 start.S start-up code, presumably so that a replacement can be
1082 used on that CPU. You should not enable it unless you know what
1083 you are doing.
1084
1085config SPL_NOR_SUPPORT
1086 bool "Support NOR flash"
Simon Glass11bde1c2016-09-13 07:05:23 -06001087 help
1088 Enable support for loading U-Boot from memory-mapped NOR (Negative
1089 OR) flash in SPL. NOR flash is slow to write but fast to read, and
1090 a memory-mapped device makes it very easy to access. Loading from
1091 NOR is typically achieved with just a memcpy().
1092
Vikas Manochac6d9e9d2017-05-28 12:55:11 -07001093config SPL_XIP_SUPPORT
1094 bool "Support XIP"
Vikas Manochac6d9e9d2017-05-28 12:55:11 -07001095 help
1096 Enable support for execute in place of U-Boot or kernel image. There
1097 is no need to copy image from flash to ram if flash supports execute
1098 in place. Its very useful in systems having enough flash but not
1099 enough ram to load the image.
1100
Simon Glass11bde1c2016-09-13 07:05:23 -06001101config SPL_ONENAND_SUPPORT
1102 bool "Support OneNAND flash"
Simon Glass11bde1c2016-09-13 07:05:23 -06001103 help
1104 Enable support for OneNAND (Negative AND) flash in SPL. OneNAND is
1105 a type of NAND flash and therefore can be used to allow SPL to
1106 load U-Boot from supported devices. This enables the drivers in
1107 drivers/mtd/onenand as part of an SPL build.
1108
Heiko Schocherc20ae2f2016-10-06 07:55:15 +02001109config SPL_OS_BOOT
1110 bool "Activate Falcon Mode"
Tom Rini226498b2017-05-22 19:21:57 +00001111 depends on !TI_SECURE_DEVICE
Heiko Schocherc20ae2f2016-10-06 07:55:15 +02001112 help
1113 Enable booting directly to an OS from SPL.
1114 for more info read doc/README.falcon
1115
Simon Glass9cbdc3a2023-09-26 08:14:17 -06001116config SPL_PAYLOAD_ARGS_ADDR
Tom Rinib4b9a002022-05-27 22:06:52 -04001117 hex "Address in memory to load 'args' file for Falcon Mode to"
1118 depends on SPL_OS_BOOT
1119 default 0x88000000 if ARCH_OMAP2PLUS
1120 help
1121 Address in memory where the 'args' file, typically a device tree
1122 will be loaded in to memory.
1123
Tom Rini5fc1d582022-05-28 16:43:53 -04001124config SYS_NAND_SPL_KERNEL_OFFS
1125 hex "Address in memory to load the OS file for Falcon mode to"
1126 depends on SPL_OS_BOOT && SPL_NAND_SUPPORT
1127
Heiko Schocher29d3bc72016-10-06 07:55:16 +02001128config SYS_OS_BASE
1129 hex "addr, where OS is found"
Tom Rini4151f4f2022-05-31 10:24:55 -04001130 depends on SPL_OS_BOOT && SPL_NOR_SUPPORT
Heiko Schocher29d3bc72016-10-06 07:55:16 +02001131 help
1132 Specify the address, where the OS image is found, which
1133 gets booted.
1134
Alexandru Gagniuc22eb1522021-12-30 10:39:59 -06001135config SPL_FALCON_BOOT_MMCSD
1136 bool "Enable Falcon boot from MMC or SD media"
1137 depends on SPL_OS_BOOT && SPL_MMC
Sean Anderson5271e352023-11-08 11:48:43 -05001138 select SPL_LOAD_BLOCK
Sean Anderson5d3401a2023-11-08 11:48:50 -05001139 select SPL_SYS_MMCSD_RAW_MODE
Alexandru Gagniuc22eb1522021-12-30 10:39:59 -06001140 help
1141 Select this if the Falcon mode OS image mode is on MMC or SD media.
1142
1143config SYS_MMCSD_RAW_MODE_KERNEL_SECTOR
1144 hex "Falcon mode: Sector to load kernel uImage from MMC"
1145 depends on SPL_FALCON_BOOT_MMCSD
1146 help
1147 When Falcon mode is used with an MMC or SD media, SPL needs to know
1148 where to look for the kernel uImage. The image is expected to begin
1149 at the raw MMC specified in this config.
1150 Note that the Falcon mode image can also be a FIT, if FIT support is
1151 enabled.
1152
Tom Rini103d1ae2022-05-28 17:21:03 -04001153config SYS_MMCSD_RAW_MODE_ARGS_SECTOR
1154 hex "Falcon mode: Sector to load 'args' from MMC"
1155 depends on SPL_FALCON_BOOT_MMCSD
1156 help
1157 When Falcon mode is used with an MMC or SD media, SPL needs to know
1158 where to look for the OS 'args', typically a device tree. The
1159 contents are expected to begin at the raw MMC specified in this config.
1160 Note that if using a FIT image, this and the next option can be set to
1161 0x0.
1162
1163config SYS_MMCSD_RAW_MODE_ARGS_SECTORS
1164 hex "Falcon mode: Number of sectors to load for 'args' from MMC"
1165 depends on SPL_FALCON_BOOT_MMCSD && SYS_MMCSD_RAW_MODE_ARGS_SECTOR != 0x0
1166
York Sun7550dbe2018-06-14 14:38:48 -07001167config SPL_PAYLOAD
1168 string "SPL payload"
1169 default "tpl/u-boot-with-tpl.bin" if TPL
1170 default "u-boot.bin"
1171 help
Chris Packham2dcfa052019-01-13 22:13:20 +13001172 Payload for SPL boot. For backward compatibility, default to
York Sun7550dbe2018-06-14 14:38:48 -07001173 u-boot.bin, i.e. RAW image without any header. In case of
1174 TPL, tpl/u-boot-with-tpl.bin. For new boards, suggest to
1175 use u-boot.img.
1176
Sekhar Norid50d6812018-12-06 15:40:08 +05301177config SPL_PCI
Simon Glass2446b6b2017-01-16 07:03:30 -07001178 bool "Support PCI drivers"
Simon Glass2446b6b2017-01-16 07:03:30 -07001179 help
1180 Enable support for PCI in SPL. For platforms that need PCI to boot,
1181 or must perform some init using PCI in SPL, this provides the
1182 necessary driver support. This enables the drivers in drivers/pci
1183 as part of an SPL build.
1184
Simon Glass15042e72021-08-08 12:20:10 -06001185config SPL_PCH
Simon Glassbbe41ab2017-01-16 07:03:33 -07001186 bool "Support PCH drivers"
Simon Glassbbe41ab2017-01-16 07:03:33 -07001187 help
1188 Enable support for PCH (Platform Controller Hub) devices in SPL.
1189 These are used to set up GPIOs and the SPI peripheral early in
1190 boot. This enables the drivers in drivers/pch as part of an SPL
1191 build.
1192
Simon Glass11bde1c2016-09-13 07:05:23 -06001193config SPL_POST_MEM_SUPPORT
1194 bool "Support POST drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -06001195 help
1196 Enable support for POST (Power-on Self Test) in SPL. POST is a
1197 procedure that checks that the hardware (CPU or board) appears to
1198 be functionally correctly. It is a sanity check that can be
1199 performed before booting. This enables the drivers in post/drivers
1200 as part of an SPL build.
1201
Ley Foon Tanbfc6bae2018-06-14 18:45:19 +08001202config SPL_DM_RESET
Patrick Delaunay0e373c02018-03-12 10:46:05 +01001203 bool "Support reset drivers"
Tom Rini4151f4f2022-05-31 10:24:55 -04001204 depends on SPL_DM
Patrick Delaunay0e373c02018-03-12 10:46:05 +01001205 help
1206 Enable support for reset control in SPL.
1207 That can be useful in SPL to handle IP reset in driver, as in U-Boot,
1208 by using the generic reset API provided by driver model.
1209 This enables the drivers in drivers/reset as part of an SPL build.
1210
Simon Glass933b2f02021-07-10 21:14:24 -06001211config SPL_POWER
Simon Glass11bde1c2016-09-13 07:05:23 -06001212 bool "Support power drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -06001213 help
1214 Enable support for power control in SPL. This includes support
1215 for PMICs (Power-management Integrated Circuits) and some of the
1216 features provided by PMICs. In particular, voltage regulators can
1217 be used to enable/disable power and vary its voltage. That can be
1218 useful in SPL to turn on boot peripherals and adjust CPU voltage
1219 so that the clock speed can be increased. This enables the drivers
1220 in drivers/power, drivers/power/pmic and drivers/power/regulator
1221 as part of an SPL build.
1222
Peng Fane13278c2018-07-27 10:20:37 +08001223config SPL_POWER_DOMAIN
1224 bool "Support power domain drivers"
Simon Glassa4faf1f2021-08-08 12:20:29 -06001225 select SPL_POWER
Peng Fane13278c2018-07-27 10:20:37 +08001226 help
1227 Enable support for power domain control in SPL. Many SoCs allow
1228 power to be applied to or removed from portions of the SoC (power
1229 domains). This may be used to save power. This API provides the
1230 means to control such power management hardware. This enables
1231 the drivers in drivers/power/domain as part of a SPL build.
1232
Stefan Agner22802f42016-12-23 07:51:53 +01001233config SPL_RAM_SUPPORT
1234 bool "Support booting from RAM"
Trevor Woerner18138ab2020-05-06 08:02:41 -04001235 default y if MICROBLAZE || ARCH_SOCFPGA || ARCH_TEGRA || ARCH_ZYNQ
Stefan Agner22802f42016-12-23 07:51:53 +01001236 help
1237 Enable booting of an image in RAM. The image can be preloaded or
1238 it can be loaded by SPL directly into RAM (e.g. using USB).
1239
Stefan Agnerf417d402016-12-23 07:51:52 +01001240config SPL_RAM_DEVICE
1241 bool "Support booting from preloaded image in RAM"
Stefan Agner22802f42016-12-23 07:51:53 +01001242 depends on SPL_RAM_SUPPORT
Trevor Woerner18138ab2020-05-06 08:02:41 -04001243 default y if MICROBLAZE || ARCH_SOCFPGA || ARCH_TEGRA || ARCH_ZYNQ
Stefan Agnerf417d402016-12-23 07:51:52 +01001244 help
1245 Enable booting of an image already loaded in RAM. The image has to
1246 be already in memory when SPL takes over, e.g. loaded by the boot
1247 ROM.
1248
Lokesh Vutla08c45312018-08-27 15:57:53 +05301249config SPL_REMOTEPROC
1250 bool "Support REMOTEPROCS"
1251 help
1252 Enable support for REMOTEPROCs in SPL. This permits to load
1253 a remote processor firmware in SPL.
1254
Simon Glass73c6ff62021-08-08 12:20:11 -06001255config SPL_RTC
Simon Glass30bf8a02017-01-16 07:03:31 -07001256 bool "Support RTC drivers"
Simon Glass30bf8a02017-01-16 07:03:31 -07001257 help
1258 Enable RTC (Real-time Clock) support in SPL. This includes support
1259 for reading and setting the time. Some RTC devices also have some
1260 non-volatile (battery-backed) memory which is accessible if
1261 needed. This enables the drivers in drivers/rtc as part of an SPL
1262 build.
1263
Simon Glassf7560372021-08-08 12:20:17 -06001264config SPL_SATA
Simon Glass11bde1c2016-09-13 07:05:23 -06001265 bool "Support loading from SATA"
Simon Glass11bde1c2016-09-13 07:05:23 -06001266 help
1267 Enable support for SATA (Serial AT attachment) in SPL. This allows
1268 use of SATA devices such as hard drives and flash drivers for
1269 loading U-Boot. SATA is used in higher-end embedded systems and
1270 can provide higher performance than MMC , at somewhat higher
1271 expense and power consumption. This enables loading from SATA
1272 using a configured device.
1273
Tom Rinif16b1a62022-11-16 13:10:35 -05001274config SYS_SATA_FAT_BOOT_PARTITION
1275 int "Partition on the SATA disk to load U-Boot from"
1276 depends on SPL_SATA && SPL_FS_FAT
1277 default 1
1278
Baruch Siach60ca9692019-07-14 17:54:21 +03001279config SPL_SATA_RAW_U_BOOT_USE_SECTOR
1280 bool "SATA raw mode: by sector"
Simon Glassf7560372021-08-08 12:20:17 -06001281 depends on SPL_SATA
Pali Rohár2226ca12021-07-23 11:14:29 +02001282 default y if ARCH_MVEBU
Baruch Siach60ca9692019-07-14 17:54:21 +03001283 help
1284 Use sector number for specifying U-Boot location on SATA disk in
1285 raw mode.
1286
1287config SPL_SATA_RAW_U_BOOT_SECTOR
1288 hex "Sector on the SATA disk to load U-Boot from"
1289 depends on SPL_SATA_RAW_U_BOOT_USE_SECTOR
Pali Rohár2226ca12021-07-23 11:14:29 +02001290 default 0x1 if ARCH_MVEBU
Baruch Siach60ca9692019-07-14 17:54:21 +03001291 help
1292 Sector on the SATA disk to load U-Boot from, when the SATA disk is being
1293 used in raw mode. Units: SATA disk sectors (1 sector = 512 bytes).
1294
Mayuresh Chitalef3228a72023-06-03 19:32:53 +05301295config SPL_NVME
1296 bool "NVM Express device support"
1297 depends on BLK
Mayuresh Chitalef3228a72023-06-03 19:32:53 +05301298 select FS_LOADER
Mayuresh Chitale8ce6a2e2023-06-03 19:32:54 +05301299 select SPL_BLK_FS
Mayuresh Chitalef3228a72023-06-03 19:32:53 +05301300 help
1301 This option enables support for NVM Express devices.
1302 It supports basic functions of NVMe (read/write).
1303
1304config SPL_NVME_PCI
1305 bool "NVM Express PCI device support for SPL"
1306 depends on SPL_PCI && SPL_NVME
1307 help
1308 This option enables support for NVM Express PCI devices.
1309 This allows use of NVMe devices for loading u-boot.
1310
1311config SPL_NVME_BOOT_DEVICE
1312 hex "NVMe boot device number"
1313 depends on SPL_NVME
1314 default 0x0
1315
1316config SYS_NVME_BOOT_PARTITION
1317 hex "NVMe boot partition number"
1318 depends on SPL_NVME
1319 default 0x1
1320
Simon Glass2a736062021-08-08 12:20:12 -06001321config SPL_SERIAL
Simon Glass11bde1c2016-09-13 07:05:23 -06001322 bool "Support serial"
Alex Kiernan14ad44a2018-04-19 04:32:54 +00001323 select SPL_PRINTF
1324 select SPL_STRTO
Simon Glass11bde1c2016-09-13 07:05:23 -06001325 help
1326 Enable support for serial in SPL. This allows use of a serial UART
1327 for displaying messages while SPL is running. It also brings in
1328 printf() and panic() functions. This should normally be enabled
1329 unless there are space reasons not to. Even then, consider
Simon Glass27084c02019-09-25 08:56:27 -06001330 enabling SPL_USE_TINY_PRINTF which is a small printf() version.
Simon Glass11bde1c2016-09-13 07:05:23 -06001331
Simon Glassea2ca7e2021-08-08 12:20:14 -06001332config SPL_SPI
Simon Goldschmidtd024e992019-10-25 16:22:09 +02001333 bool "Support SPI drivers"
1334 help
1335 Enable support for using SPI in SPL. This is used for connecting
1336 to SPI flash for loading U-Boot. See SPL_SPI_FLASH_SUPPORT for
1337 more details on that. The SPI driver provides the transport for
1338 data between the SPI flash and the CPU. This option can be used to
1339 enable SPI drivers that are needed for other purposes also, such
1340 as a SPI PMIC.
1341
Simon Glass11bde1c2016-09-13 07:05:23 -06001342config SPL_SPI_FLASH_SUPPORT
1343 bool "Support SPI flash drivers"
Simon Glassea2ca7e2021-08-08 12:20:14 -06001344 depends on SPL_SPI
Simon Glass11bde1c2016-09-13 07:05:23 -06001345 help
1346 Enable support for using SPI flash in SPL, and loading U-Boot from
1347 SPI flash. SPI flash (Serial Peripheral Bus flash) is named after
1348 the SPI bus that is used to connect it to a system. It is a simple
1349 but fast bidirectional 4-wire bus (clock, chip select and two data
1350 lines). This enables the drivers in drivers/mtd/spi as part of an
Simon Glassea2ca7e2021-08-08 12:20:14 -06001351 SPL build. This normally requires SPL_SPI.
Simon Glass11bde1c2016-09-13 07:05:23 -06001352
Vignesh R0c6f1872019-02-05 11:29:20 +05301353if SPL_SPI_FLASH_SUPPORT
1354
Vignesh R778572d2019-02-05 11:29:25 +05301355config SPL_SPI_FLASH_TINY
1356 bool "Enable low footprint SPL SPI Flash support"
1357 depends on !SPI_FLASH_BAR
Vignesh R72875972019-02-05 11:29:26 +05301358 default y if SPI_FLASH
Vignesh R778572d2019-02-05 11:29:25 +05301359 help
1360 Enable lightweight SPL SPI Flash support that supports just reading
1361 data/images from flash. No support to write/erase flash. Enable
1362 this if you have SPL size limitations and don't need full
1363 fledged SPI flash support.
1364
Vignesh R0c6f1872019-02-05 11:29:20 +05301365config SPL_SPI_FLASH_SFDP_SUPPORT
1366 bool "SFDP table parsing support for SPI NOR flashes"
Vignesh R778572d2019-02-05 11:29:25 +05301367 depends on !SPI_FLASH_BAR && !SPL_SPI_FLASH_TINY
Vignesh R0c6f1872019-02-05 11:29:20 +05301368 help
1369 Enable support for parsing and auto discovery of parameters for
1370 SPI NOR flashes using Serial Flash Discoverable Parameters (SFDP)
1371 tables as per JESD216 standard in SPL.
1372
Lukasz Majewski56c40462020-06-04 23:11:53 +08001373config SPL_SPI_FLASH_MTD
1374 bool "Support for SPI flash MTD drivers in SPL"
1375 help
1376 Enable support for SPI flash MTD drivers in SPL.
1377
Marek Vasut55500432018-04-07 16:05:27 +02001378config SPL_SPI_LOAD
1379 bool "Support loading from SPI flash"
Marek Vasut55500432018-04-07 16:05:27 +02001380 help
1381 Enable support for loading next stage, U-Boot or otherwise, from
1382 SPI NOR in U-Boot SPL.
1383
Vignesh R0c6f1872019-02-05 11:29:20 +05301384endif # SPL_SPI_FLASH_SUPPORT
1385
Hannes Schmelzer1ee774d2019-08-22 15:41:46 +02001386config SYS_SPI_U_BOOT_OFFS
1387 hex "address of u-boot payload in SPI flash"
Andre Przywara671d64f2020-01-06 01:29:10 +00001388 default 0x8000 if ARCH_SUNXI
Hannes Schmelzer1ee774d2019-08-22 15:41:46 +02001389 default 0x0
1390 depends on SPL_SPI_LOAD || SPL_SPI_SUNXI
1391 help
1392 Address within SPI-Flash from where the u-boot payload is fetched
1393 from.
1394
Faiz Abbas8502f9f2017-11-14 16:12:31 +05301395config SPL_THERMAL
1396 bool "Driver support for thermal devices"
1397 help
1398 Enable support for temperature-sensing devices. Some SoCs have on-chip
1399 temperature sensors to permit warnings, speed throttling or even
1400 automatic power-off when the temperature gets too high or low. Other
1401 devices may be discrete but connected on a suitable bus.
1402
Simon Glass078111b2021-07-10 21:14:28 -06001403config SPL_WATCHDOG
Simon Glass11bde1c2016-09-13 07:05:23 -06001404 bool "Support watchdog drivers"
Marek Vasut6874cb72019-06-09 03:46:21 +02001405 imply SPL_WDT if !HW_WATCHDOG
Simon Glass11bde1c2016-09-13 07:05:23 -06001406 help
1407 Enable support for watchdog drivers in SPL. A watchdog is
1408 typically a hardware peripheral which can reset the system when it
1409 detects no activity for a while (such as a software crash). This
1410 enables the drivers in drivers/watchdog as part of an SPL build.
1411
1412config SPL_YMODEM_SUPPORT
1413 bool "Support loading using Ymodem"
Simon Glass2a736062021-08-08 12:20:12 -06001414 depends on SPL_SERIAL
Simon Glass11bde1c2016-09-13 07:05:23 -06001415 help
1416 While loading from serial is slow it can be a useful backup when
1417 there is no other option. The Ymodem protocol provides a reliable
1418 means of transmitting U-Boot over a serial line for using in SPL,
1419 with a checksum to ensure correctness.
1420
Philipp Tomsichaa122f62017-09-13 21:29:36 +02001421config SPL_ATF
Kever Yangbcc17262017-05-05 11:47:45 +08001422 bool "Support ARM Trusted Firmware"
Samuel Holland4b0a1f52022-10-30 23:26:19 -05001423 depends on ARM64
1424 depends on SPL_LOAD_FIT && !SPL_FIT_IMAGE_TINY
Kever Yangbcc17262017-05-05 11:47:45 +08001425 help
Philipp Tomsichd21fb632018-01-02 21:16:43 +01001426 ATF(ARM Trusted Firmware) is a component for ARM AArch64 which
1427 is loaded by SPL (which is considered as BL2 in ATF terminology).
Kever Yangbcc17262017-05-05 11:47:45 +08001428 More detail at: https://github.com/ARM-software/arm-trusted-firmware
1429
Michael Walle7b866822020-11-18 17:45:58 +01001430config SPL_ATF_LOAD_IMAGE_V2
1431 bool "Use the new LOAD_IMAGE_V2 parameter passing"
1432 depends on SPL_ATF
1433 help
1434 Some platforms use the newer LOAD_IMAGE_V2 parameter passing.
1435
1436 If you want to load a bl31 image from the SPL and need the new
1437 method, say Y.
1438
Philipp Tomsichd21fb632018-01-02 21:16:43 +01001439config SPL_ATF_NO_PLATFORM_PARAM
Michal Simekce869b52021-05-20 13:08:44 +02001440 bool "Pass no platform parameter"
Philipp Tomsichd21fb632018-01-02 21:16:43 +01001441 depends on SPL_ATF
1442 help
1443 While we expect to call a pointer to a valid FDT (or NULL)
1444 as the platform parameter to an ATF, some ATF versions are
1445 not U-Boot aware and have an insufficiently robust parameter
1446 validation to gracefully reject a FDT being passed.
1447
1448 If this option is enabled, the spl_atf os-type handler will
1449 always pass NULL for the platform parameter.
1450
1451 If your ATF is affected, say Y.
1452
Alex Kiernan3bf5f132018-03-15 22:11:46 +00001453config SPL_AM33XX_ENABLE_RTC32K_OSC
1454 bool "Enable the RTC32K OSC on AM33xx based platforms"
Tom Rini4151f4f2022-05-31 10:24:55 -04001455 depends on AM33XX
Alex Kiernan3bf5f132018-03-15 22:11:46 +00001456 default y if AM33XX
1457 help
1458 Enable access to the AM33xx RTC and select the external 32kHz clock
1459 source.
1460
Patrick Delaunay51827f92021-09-02 11:56:16 +02001461config SPL_OPTEE_IMAGE
1462 bool "Support OP-TEE Trusted OS image in SPL"
Kever Yang70fe2872018-08-23 17:17:59 +08001463 depends on ARM
Jagan Tekif3659712022-11-03 11:49:47 +05301464 depends on SPL_LOAD_FIT || SPL_LOAD_FIT_FULL
Kever Yang70fe2872018-08-23 17:17:59 +08001465 help
Patrick Delaunay51827f92021-09-02 11:56:16 +02001466 OP-TEE is an open source Trusted OS which is loaded by SPL.
Kever Yang70fe2872018-08-23 17:17:59 +08001467 More detail at: https://github.com/OP-TEE/optee_os
1468
Lukas Auer5e30e452019-08-21 21:14:44 +02001469config SPL_OPENSBI
1470 bool "Support RISC-V OpenSBI"
1471 depends on RISCV && SPL_RISCV_MMODE && RISCV_SMODE
Samuel Holland4b0a1f52022-10-30 23:26:19 -05001472 depends on SPL_LOAD_FIT && !SPL_FIT_IMAGE_TINY
Lukas Auer5e30e452019-08-21 21:14:44 +02001473 help
1474 OpenSBI is an open-source implementation of the RISC-V Supervisor Binary
1475 Interface (SBI) specification. U-Boot supports the OpenSBI FW_DYNAMIC
1476 firmware. It is loaded and started by U-Boot SPL.
1477
1478 More details are available at https://github.com/riscv/opensbi and
1479 https://github.com/riscv/riscv-sbi-doc
1480
1481config SPL_OPENSBI_LOAD_ADDR
1482 hex "OpenSBI load address"
1483 depends on SPL_OPENSBI
1484 help
1485 Load address of the OpenSBI binary.
1486
Nikita Shubinaa0eda12022-08-08 13:28:52 +03001487config SPL_OPENSBI_SCRATCH_OPTIONS
1488 hex "Scratch options passed to OpenSBI"
1489 default 0x1
1490 depends on SPL_OPENSBI
1491 help
Heinrich Schuchardt9eb0fc22023-07-04 02:14:21 +02001492 This bitmap of options is passed from U-Boot SPL to OpenSBI.
1493 As of OpenSBI 1.3 the following bits are defined:
1494 - SBI_SCRATCH_NO_BOOT_PRINTS = 0x1 (Disable prints during boot)
1495 - SBI_SCRATCH_DEBUG_PRINTS = 0x2 (Enable runtime debug prints)
Nikita Shubinaa0eda12022-08-08 13:28:52 +03001496
Tom Rinia62b7f02022-05-27 17:13:52 -04001497config SPL_TARGET
1498 string "Addtional build targets for 'make'"
1499 default "spl/u-boot-spl.srec" if RCAR_GEN2
1500 default "spl/u-boot-spl.scif" if RCAR_GEN3
1501 default ""
1502 help
1503 On some platforms we need to have 'make' run additional build target
1504 rules. If required on your platform, enter it here, otherwise leave blank.
1505
Simon Glass747093d2022-04-30 00:56:53 -06001506
Eugen Hristev0be07872019-05-24 09:38:10 +03001507config SPL_AT91_MCK_BYPASS
1508 bool "Use external clock signal as a source of main clock for AT91 platforms"
1509 depends on ARCH_AT91
Eugen Hristev0be07872019-05-24 09:38:10 +03001510 help
1511 Use external 8 to 24 Mhz clock signal as source of main clock instead
1512 of an external crystal oscillator.
1513 This option disables the internal driving on the XOUT pin.
1514 The external source has to provide a stable clock on the XIN pin.
1515 If this option is disabled, the SoC expects a crystal oscillator
1516 that needs driving on both XIN and XOUT lines.
Simon Glass11bde1c2016-09-13 07:05:23 -06001517endmenu
Tom Riniab0c5f12022-05-30 17:11:23 -04001518
1519config TPL
1520 depends on SUPPORT_TPL
1521 bool "Enable TPL"
1522 help
1523 If you want to build TPL as well as the normal image and SPL, say Y.
1524
1525source "common/spl/Kconfig.tpl"
1526
1527config VPL
1528 depends on SUPPORT_SPL
1529 bool "Enable VPL"
1530 help
1531 If you want to build VPL as well as the normal image, TPL and SPL,
1532 say Y.
1533
1534source "common/spl/Kconfig.vpl"