blob: 5978fb2934325e474de2bab0f21926c834ce1487 [file] [log] [blame]
Simon Glass11bde1c2016-09-13 07:05:23 -06001menu "SPL / TPL"
2
Simon Glassc2ae7d82016-09-12 23:18:22 -06003config SUPPORT_SPL
4 bool
5
6config SUPPORT_TPL
7 bool
8
B, Ravi66928af2017-05-04 15:45:29 +05309config SPL_DFU_NO_RESET
10 bool
11
Simon Glassc2ae7d82016-09-12 23:18:22 -060012config SPL
13 bool
14 depends on SUPPORT_SPL
15 prompt "Enable SPL"
16 help
17 If you want to build SPL as well as the normal image, say Y.
18
Tom Rini75670c82018-02-06 12:15:38 -050019config SPL_FRAMEWORK
20 bool "Support SPL based upon the common SPL framework"
21 depends on SPL
22 default y
23 help
24 Enable the SPL framework under common/spl/. This framework
25 supports MMC, NAND and YMODEM and other methods loading of U-Boot
26 and the Linux Kernel. If unsure, say Y.
27
Simon Goldschmidt25770152019-05-24 22:07:04 +020028config SPL_SIZE_LIMIT
Tom Rini6d277fb2019-06-07 20:39:32 -040029 int "Maximum size of SPL image"
Simon Goldschmidt25770152019-05-24 22:07:04 +020030 depends on SPL
Fabio Estevam23612532019-06-08 14:56:44 -030031 default 69632 if ARCH_MX6
Simon Goldschmidt25770152019-05-24 22:07:04 +020032 default 0
33 help
34 Specifies the maximum length of the U-Boot SPL image.
35 If this value is zero, it is ignored.
36
37config SPL_SIZE_LIMIT_SUBTRACT_GD
38 bool "SPL image size check: provide space for global data"
39 depends on SPL_SIZE_LIMIT > 0
40 help
41 If enabled, aligned size of global data is reserved in
42 SPL_SIZE_LIMIT check to ensure such an image does not overflow SRAM
43 if SPL_SIZE_LIMIT describes the size of SRAM available for SPL when
44 pre-reloc global data is put into this SRAM, too.
45
46config SPL_SIZE_LIMIT_SUBTRACT_MALLOC
47 bool "SPL image size check: provide space for malloc() pool before relocation"
48 depends on SPL_SIZE_LIMIT > 0
49 help
50 If enabled, SPL_SYS_MALLOC_F_LEN is reserved in SPL_SIZE_LIMIT check
51 to ensure such an image does not overflow SRAM if SPL_SIZE_LIMIT
52 describes the size of SRAM available for SPL when pre-reloc malloc
53 pool is put into this SRAM, too.
54
55config SPL_SIZE_LIMIT_PROVIDE_STACK
56 hex "SPL image size check: provide stack space before relocation"
57 depends on SPL_SIZE_LIMIT > 0
58 default 0
59 help
60 If set, this size is reserved in SPL_SIZE_LIMIT check to ensure such
61 an image does not overflow SRAM if SPL_SIZE_LIMIT describes the size
62 of SRAM available for SPL when the stack required before reolcation
63 uses this SRAM, too.
64
Tom Rinidb4080d2019-06-01 14:20:25 -040065menu "PowerPC SPL Boot options"
66 depends on PPC && (SUPPORT_SPL && !SPL_FRAMEWORK)
67
68config SPL_NAND_BOOT
69 bool "Load SPL from NAND flash"
70
71config SPL_MMC_BOOT
72 bool "Load SPL from SD Card / eMMC"
73
74config SPL_SPI_BOOT
75 bool "Load SPL from SPI flash"
76
77config SPL_FSL_PBL
78 bool "Create SPL in Freescale PBI format"
79 help
80 Create boot binary having SPL binary in PBI format concatenated with
81 u-boot binary.
82
83endmenu
84
Simon Glassb0edea32018-11-15 18:44:09 -070085config HANDOFF
86 bool "Pass hand-off information from SPL to U-Boot proper"
87 depends on BLOBLIST
88 help
89 It is useful to be able to pass information from SPL to U-Boot
90 proper to preserve state that is known in SPL and is needed in U-Boot.
91 Enable this to locate the handoff information in U-Boot proper, early
92 in boot. It is available in gd->handoff. The state state is set up
93 in SPL (or TPL if that is being used).
94
Tom Rini226498b2017-05-22 19:21:57 +000095if SPL
96
Simon Glassb0edea32018-11-15 18:44:09 -070097config SPL_HANDOFF
98 bool "Pass hand-off information from SPL to U-Boot proper"
99 depends on HANDOFF
100 default y
101 help
102 This option enables SPL to write handoff information. This can be
103 used to pass information like the size of SDRAM from SPL to U-Boot
104 proper. Also SPL can receive information from TPL in the same place
105 if that is enabled.
106
Philipp Tomsichdd6fbcb2017-07-28 19:20:49 +0200107config SPL_LDSCRIPT
108 string "Linker script for the SPL stage"
109 default "arch/$(ARCH)/cpu/u-boot-spl.lds"
Philipp Tomsichdd6fbcb2017-07-28 19:20:49 +0200110 help
111 The SPL stage will usually require a different linker-script
112 (as it runs from a different memory region) than the regular
113 U-Boot stage. Set this to the path of the linker-script to
114 be used for SPL.
115
Simon Goldschmidtf89d6132018-09-30 14:31:53 +0200116config SPL_TEXT_BASE
117 hex "SPL Text Base"
118 default ISW_ENTRY_ADDR if AM43XX || AM33XX || OMAP54XX || ARCH_KEYSTONE
Andre Przywara9340d8f2019-05-27 01:45:11 +0100119 default 0x10060 if MACH_SUN50I || MACH_SUN50I_H5 || MACH_SUN9I
120 default 0x20060 if MACH_SUN50I_H6
121 default 0x00060 if ARCH_SUNXI
Simon Goldschmidtf89d6132018-09-30 14:31:53 +0200122 default 0x0
123 help
124 The address in memory that SPL will be running from.
125
Ley Foon Tan0680f1b2017-05-03 17:13:32 +0800126config SPL_BOARD_INIT
Ley Foon Tan0680f1b2017-05-03 17:13:32 +0800127 bool "Call board-specific initialization in SPL"
128 help
129 If this option is enabled, U-Boot will call the function
130 spl_board_init() from board_init_r(). This function should be
131 provided by the board.
132
Philipp Tomsich225d30b2017-06-22 23:38:36 +0200133config SPL_BOOTROM_SUPPORT
134 bool "Support returning to the BOOTROM"
135 help
136 Some platforms (e.g. the Rockchip RK3368) provide support in their
137 ROM for loading the next boot-stage after performing basic setup
138 from the SPL stage.
139
140 Enable this option, to return to the BOOTROM through the
141 BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
142 boot device list, if not implemented for a given board)
143
Lukasz Majewskiafa96092018-05-02 16:10:50 +0200144config SPL_BOOTCOUNT_LIMIT
145 bool "Support bootcount in SPL"
146 depends on SPL_ENV_SUPPORT
147 help
148 On some boards, which use 'falcon' mode, it is necessary to check
149 and increment the number of boot attempts. Such boards do not
150 use proper U-Boot for normal boot flow and hence needs those
151 adjustments to be done in the SPL.
152
Andrew F. Davis24eb39b2017-02-16 11:18:38 -0600153config SPL_RAW_IMAGE_SUPPORT
154 bool "Support SPL loading and booting of RAW images"
Andrew F. Davis24eb39b2017-02-16 11:18:38 -0600155 default n if (ARCH_MX6 && (SPL_MMC_SUPPORT || SPL_SATA_SUPPORT))
Andrew F. Davisae9b57b2017-02-16 11:18:40 -0600156 default y if !TI_SECURE_DEVICE
Andrew F. Davis24eb39b2017-02-16 11:18:38 -0600157 help
158 SPL will support loading and booting a RAW image when this option
159 is y. If this is not set, SPL will move on to other available
160 boot media to find a suitable image.
161
Andrew F. Davis722a6b12017-02-16 11:18:39 -0600162config SPL_LEGACY_IMAGE_SUPPORT
163 bool "Support SPL loading and booting of Legacy images"
Tom Rini11bd2fa2019-05-23 07:14:08 -0400164 default y if !TI_SECURE_DEVICE && !SPL_LOAD_FIT
Andrew F. Davis722a6b12017-02-16 11:18:39 -0600165 help
166 SPL will support loading and booting Legacy images when this option
167 is y. If this is not set, SPL will move on to other available
168 boot media to find a suitable image.
169
Simon Goldschmidtdae5c2d2019-02-10 21:34:37 +0100170config SPL_LEGACY_IMAGE_CRC_CHECK
171 bool "Check CRC of Legacy images"
172 depends on SPL_LEGACY_IMAGE_SUPPORT
173 select SPL_CRC32_SUPPORT
174 help
175 Enable this to check the CRC of Legacy images. While this increases
176 reliability, it affects both code size and boot duration.
177 If disabled, Legacy images are booted if the image magic and size
178 are correct, without further integrity checks.
179
Simon Glassc2ae7d82016-09-12 23:18:22 -0600180config SPL_SYS_MALLOC_SIMPLE
181 bool
Simon Glassc2ae7d82016-09-12 23:18:22 -0600182 prompt "Only use malloc_simple functions in the SPL"
183 help
184 Say Y here to only use the *_simple malloc functions from
185 malloc_simple.c, rather then using the versions from dlmalloc.c;
186 this will make the SPL binary smaller at the cost of more heap
187 usage as the *_simple malloc functions do not re-use free-ed mem.
188
Philipp Tomsichd60b5f72017-06-30 18:57:25 +0200189config TPL_SYS_MALLOC_SIMPLE
190 bool
191 prompt "Only use malloc_simple functions in the TPL"
192 help
193 Say Y here to only use the *_simple malloc functions from
194 malloc_simple.c, rather then using the versions from dlmalloc.c;
195 this will make the TPL binary smaller at the cost of more heap
196 usage as the *_simple malloc functions do not re-use free-ed mem.
197
Simon Glassc2ae7d82016-09-12 23:18:22 -0600198config SPL_STACK_R
Simon Glassc2ae7d82016-09-12 23:18:22 -0600199 bool "Enable SDRAM location for SPL stack"
200 help
201 SPL starts off execution in SRAM and thus typically has only a small
202 stack available. Since SPL sets up DRAM while in its board_init_f()
203 function, it is possible for the stack to move there before
204 board_init_r() is reached. This option enables a special SDRAM
205 location for the SPL stack. U-Boot SPL switches to this after
206 board_init_f() completes, and before board_init_r() starts.
207
208config SPL_STACK_R_ADDR
209 depends on SPL_STACK_R
210 hex "SDRAM location for SPL stack"
Tom Riniff6c3122017-09-17 11:44:49 -0400211 default 0x82000000 if ARCH_OMAP2PLUS
Simon Glassc2ae7d82016-09-12 23:18:22 -0600212 help
213 Specify the address in SDRAM for the SPL stack. This will be set up
214 before board_init_r() is called.
215
216config SPL_STACK_R_MALLOC_SIMPLE_LEN
217 depends on SPL_STACK_R && SPL_SYS_MALLOC_SIMPLE
218 hex "Size of malloc_simple heap after switching to DRAM SPL stack"
219 default 0x100000
220 help
221 Specify the amount of the stack to use as memory pool for
222 malloc_simple after switching the stack to DRAM. This may be set
223 to give board_init_r() a larger heap then the initial heap in
224 SRAM which is limited to SYS_MALLOC_F_LEN bytes.
225
226config SPL_SEPARATE_BSS
Simon Glassc2ae7d82016-09-12 23:18:22 -0600227 bool "BSS section is in a different memory region from text"
228 help
229 Some platforms need a large BSS region in SPL and can provide this
230 because RAM is already set up. In this case BSS can be moved to RAM.
231 This option should then be enabled so that the correct device tree
232 location is used. Normally we put the device tree at the end of BSS
233 but with this option enabled, it goes at _image_binary_end.
234
Simon Glassaedc08b2018-11-15 18:43:57 -0700235config SPL_BANNER_PRINT
236 bool "Enable output of the SPL banner 'U-Boot SPL ...'"
237 default y
238 help
239 If this option is enabled, SPL will print the banner with version
240 info. Disabling this option could be useful to reduce TPL boot time
241 (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
242
243config TPL_BANNER_PRINT
244 bool "Enable output of the TPL banner 'U-Boot TPL ...'"
245 default y
Anatolij Gustschin0292bc02018-01-25 18:45:22 +0100246 help
247 If this option is enabled, SPL will not print the banner with version
Simon Glassaedc08b2018-11-15 18:43:57 -0700248 info. Disabling this option could be useful to reduce SPL boot time
249 (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
Anatolij Gustschin0292bc02018-01-25 18:45:22 +0100250
Andreas Dannenberga5a5d992019-06-04 17:55:45 -0500251config SPL_EARLY_BSS
252 depends on ARM && !ARM64
253 bool "Allows initializing BSS early before entering board_init_f"
254 help
255 On some platform we have sufficient memory available early on to
256 allow setting up and using a basic BSS prior to entering
257 board_init_f. Activating this option will also de-activate the
258 clearing of BSS during the SPL relocation process, thus allowing
259 to carry state from board_init_f to board_init_r by way of BSS.
260
Simon Glassa807ab32016-09-24 18:19:56 -0600261config SPL_DISPLAY_PRINT
Simon Glassa807ab32016-09-24 18:19:56 -0600262 bool "Display a board-specific message in SPL"
263 help
264 If this option is enabled, U-Boot will call the function
265 spl_display_print() immediately after displaying the SPL console
266 banner ("U-Boot SPL ..."). This function should be provided by
267 the board.
268
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200269config SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
270 bool "MMC raw mode: by sector"
Fabio Estevam1da19382018-06-11 15:08:05 -0300271 default y if ARCH_SUNXI || ARCH_DAVINCI || ARCH_UNIPHIER || \
272 ARCH_MX6 || ARCH_MX7 || \
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200273 ARCH_ROCKCHIP || ARCH_MVEBU || ARCH_SOCFPGA || \
274 ARCH_AT91 || ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || \
275 OMAP44XX || OMAP54XX || AM33XX || AM43XX
276 help
277 Use sector number for specifying U-Boot location on MMC/SD in
278 raw mode.
279
280config SYS_MMCSD_RAW_MODE_U_BOOT_SECTOR
281 hex "Address on the MMC to load U-Boot from"
Tom Rini226498b2017-05-22 19:21:57 +0000282 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200283 default 0x50 if ARCH_SUNXI
284 default 0x75 if ARCH_DAVINCI
Fabio Estevam1da19382018-06-11 15:08:05 -0300285 default 0x8a if ARCH_MX6 || ARCH_MX7
Kever Yang8f4d62b2017-11-02 15:16:34 +0800286 default 0x100 if ARCH_UNIPHIER
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200287 default 0x140 if ARCH_MVEBU
288 default 0x200 if ARCH_SOCFPGA || ARCH_AT91
289 default 0x300 if ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || OMAP44XX || \
Lokesh Vutla586bde92018-08-27 15:57:08 +0530290 OMAP54XX || AM33XX || AM43XX || ARCH_K3
Kever Yang8f4d62b2017-11-02 15:16:34 +0800291 default 0x4000 if ARCH_ROCKCHIP
Semen Protsenko38fed8a2016-11-16 19:19:05 +0200292 help
293 Address on the MMC to load U-Boot from, when the MMC is being used
294 in raw mode. Units: MMC sectors (1 sector = 512 bytes).
295
Dalon Westergreen949123e2017-02-10 17:15:35 -0800296config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
297 bool "MMC Raw mode: by partition"
Dalon Westergreen949123e2017-02-10 17:15:35 -0800298 help
299 Use a partition for loading U-Boot when using MMC/SD in raw mode.
300
301config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION
302 hex "Partition to use to load U-Boot from"
Tom Rini226498b2017-05-22 19:21:57 +0000303 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
Dalon Westergreen949123e2017-02-10 17:15:35 -0800304 default 1
305 help
306 Partition on the MMC to load U-Boot from when the MMC is being
307 used in raw mode
308
Dalon Westergreenf0fb4fa2017-02-10 17:15:34 -0800309config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
310 bool "MMC raw mode: by partition type"
Tom Rini226498b2017-05-22 19:21:57 +0000311 depends on DOS_PARTITION && SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
Dalon Westergreenf0fb4fa2017-02-10 17:15:34 -0800312 help
313 Use partition type for specifying U-Boot partition on MMC/SD in
314 raw mode. U-Boot will be loaded from the first partition of this
315 type to be found.
316
317config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION_TYPE
318 hex "Partition Type on the MMC to load U-Boot from"
Tom Rini226498b2017-05-22 19:21:57 +0000319 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
Dalon Westergreenf0fb4fa2017-02-10 17:15:34 -0800320 help
321 Partition Type on the MMC to load U-Boot from, when the MMC is being
322 used in raw mode.
323
Simon Glass11bde1c2016-09-13 07:05:23 -0600324config SPL_CRC32_SUPPORT
325 bool "Support CRC32"
Simon Goldschmidtdae5c2d2019-02-10 21:34:37 +0100326 default y if SPL_LEGACY_IMAGE_SUPPORT
Simon Glass11bde1c2016-09-13 07:05:23 -0600327 help
Simon Goldschmidtdae5c2d2019-02-10 21:34:37 +0100328 Enable this to support CRC32 in uImages or FIT images within SPL.
329 This is a 32-bit checksum value that can be used to verify images.
330 For FIT images, this is the least secure type of checksum, suitable
331 for detected accidental image corruption. For secure applications you
332 should consider SHA1 or SHA256.
Simon Glass11bde1c2016-09-13 07:05:23 -0600333
334config SPL_MD5_SUPPORT
335 bool "Support MD5"
336 depends on SPL_FIT
337 help
338 Enable this to support MD5 in FIT images within SPL. An MD5
339 checksum is a 128-bit hash value used to check that the image
340 contents have not been corrupted. Note that MD5 is not considered
341 secure as it is possible (with a brute-force attack) to adjust the
342 image while still retaining the same MD5 hash value. For secure
343 applications where images may be changed maliciously, you should
344 consider SHA1 or SHA256.
345
346config SPL_SHA1_SUPPORT
347 bool "Support SHA1"
348 depends on SPL_FIT
Tom Rini089df182017-05-15 12:17:49 -0400349 select SHA1
Simon Glass11bde1c2016-09-13 07:05:23 -0600350 help
351 Enable this to support SHA1 in FIT images within SPL. A SHA1
352 checksum is a 160-bit (20-byte) hash value used to check that the
353 image contents have not been corrupted or maliciously altered.
354 While SHA1 is fairly secure it is coming to the end of its life
Vagrant Cascadian048a92e2019-05-03 14:28:37 -0800355 due to the expanding computing power available to brute-force
Simon Glass11bde1c2016-09-13 07:05:23 -0600356 attacks. For more security, consider SHA256.
357
358config SPL_SHA256_SUPPORT
359 bool "Support SHA256"
360 depends on SPL_FIT
Tom Rini089df182017-05-15 12:17:49 -0400361 select SHA256
Simon Glass11bde1c2016-09-13 07:05:23 -0600362 help
363 Enable this to support SHA256 in FIT images within SPL. A SHA256
364 checksum is a 256-bit (32-byte) hash value used to check that the
365 image contents have not been corrupted. SHA256 is recommended for
366 use in secure applications since (as at 2016) there is no known
367 feasible attack that could produce a 'collision' with differing
368 input data. Use this for the highest security. Note that only the
369 SHA256 variant is supported: SHA512 and others are not currently
370 supported in U-Boot.
371
Philipp Tomsich337bbb62017-11-24 13:26:03 +0100372config SPL_FIT_IMAGE_TINY
373 bool "Remove functionality from SPL FIT loading to reduce size"
374 depends on SPL_FIT
Icenowy Zheng6f796a92018-07-21 16:20:31 +0800375 default y if MACH_SUN50I || MACH_SUN50I_H5 || MACH_SUN50I_H6
Ye Lif6282cd2018-11-20 10:19:15 +0000376 default y if ARCH_IMX8M
Philipp Tomsich337bbb62017-11-24 13:26:03 +0100377 help
378 Enable this to reduce the size of the FIT image loading code
379 in SPL, if space for the SPL binary is very tight.
380
381 This removes the detection of image types (which forces the
382 first image to be treated as having a U-Boot style calling
383 convention) and skips the recording of each loaded payload
384 (i.e. loadable) into the FDT (modifying the loaded FDT to
385 ensure this information is available to the next image
386 invoked).
387
Simon Glass5e148df2017-01-16 07:03:29 -0700388config SPL_CPU_SUPPORT
389 bool "Support CPU drivers"
Simon Glass5e148df2017-01-16 07:03:29 -0700390 help
391 Enable this to support CPU drivers in SPL. These drivers can set
392 up CPUs and provide information about them such as the model and
393 name. This can be useful in SPL since setting up the CPUs earlier
394 may improve boot performance. Enable this option to build the
395 drivers in drivers/cpu as part of an SPL build.
396
Simon Glass11bde1c2016-09-13 07:05:23 -0600397config SPL_CRYPTO_SUPPORT
398 bool "Support crypto drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -0600399 help
400 Enable crypto drivers in SPL. These drivers can be used to
401 accelerate secure boot processing in secure applications. Enable
402 this option to build the drivers in drivers/crypto as part of an
403 SPL build.
404
405config SPL_HASH_SUPPORT
406 bool "Support hashing drivers"
Tom Rini089df182017-05-15 12:17:49 -0400407 select SHA1
408 select SHA256
Simon Glass11bde1c2016-09-13 07:05:23 -0600409 help
410 Enable hashing drivers in SPL. These drivers can be used to
411 accelerate secure boot processing in secure applications. Enable
412 this option to build system-specific drivers for hash acceleration
413 as part of an SPL build.
414
Simon Glass2d424eb2018-11-15 18:43:55 -0700415config TPL_HASH_SUPPORT
416 bool "Support hashing drivers in TPL"
417 select SHA1
418 select SHA256
419 help
420 Enable hashing drivers in SPL. These drivers can be used to
421 accelerate secure boot processing in secure applications. Enable
422 this option to build system-specific drivers for hash acceleration
423 as part of an SPL build.
424
Simon Glass11bde1c2016-09-13 07:05:23 -0600425config SPL_DMA_SUPPORT
426 bool "Support DMA drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -0600427 help
428 Enable DMA (direct-memory-access) drivers in SPL. These drivers
429 can be used to handle memory-to-peripheral data transfer without
430 the CPU moving the data. Enable this option to build the drivers
431 in drivers/dma as part of an SPL build.
432
433config SPL_DRIVERS_MISC_SUPPORT
434 bool "Support misc drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -0600435 help
436 Enable miscellaneous drivers in SPL. These drivers perform various
437 tasks that don't fall nicely into other categories, Enable this
438 option to build the drivers in drivers/misc as part of an SPL
439 build, for those that support building in SPL (not all drivers do).
440
441config SPL_ENV_SUPPORT
442 bool "Support an environment"
Simon Glass11bde1c2016-09-13 07:05:23 -0600443 help
444 Enable environment support in SPL. The U-Boot environment provides
445 a number of settings (essentially name/value pairs) which can
446 control many aspects of U-Boot's operation. Normally this is not
447 needed in SPL as it has a much simpler task with less
448 configuration. But some boards use this to support 'Falcon' boot
449 on EXT2 and FAT, where SPL boots directly into Linux without
Simon Glass00caae62017-08-03 12:22:12 -0600450 starting U-Boot first. Enabling this option will make env_get()
Simon Glass382bee52017-08-03 12:22:09 -0600451 and env_set() available in SPL.
Simon Glass11bde1c2016-09-13 07:05:23 -0600452
B, Ravid2d9bdf2016-09-28 14:46:18 +0530453config SPL_SAVEENV
454 bool "Support save environment"
Tom Rini226498b2017-05-22 19:21:57 +0000455 depends on SPL_ENV_SUPPORT
Jean-Jacques Hiblotd6400c32018-01-04 15:23:32 +0100456 select SPL_MMC_WRITE if ENV_IS_IN_MMC
B, Ravid2d9bdf2016-09-28 14:46:18 +0530457 help
458 Enable save environment support in SPL after setenv. By default
459 the saveenv option is not provided in SPL, but some boards need
460 this support in 'Falcon' boot, where SPL need to boot from
461 different images based on environment variable set by OS. For
462 example OS may set "reboot_image" environment variable to
463 "recovery" inorder to boot recovery image by SPL. The SPL read
464 "reboot_image" and act accordingly and change the reboot_image
Shyam Saini919d25c2018-06-07 19:47:19 +0530465 to default mode using setenv and save the environment.
B, Ravid2d9bdf2016-09-28 14:46:18 +0530466
Simon Glass11bde1c2016-09-13 07:05:23 -0600467config SPL_ETH_SUPPORT
468 bool "Support Ethernet"
469 depends on SPL_ENV_SUPPORT
470 help
471 Enable access to the network subsystem and associated Ethernet
472 drivers in SPL. This permits SPL to load U-Boot over an Ethernet
473 link rather than from an on-board peripheral. Environment support
474 is required since the network stack uses a number of environment
475 variables. See also SPL_NET_SUPPORT.
476
Tien Fong Cheef4b40922019-01-23 14:20:05 +0800477config SPL_FS_EXT4
Simon Glass11bde1c2016-09-13 07:05:23 -0600478 bool "Support EXT filesystems"
Simon Glass11bde1c2016-09-13 07:05:23 -0600479 help
480 Enable support for EXT2/3/4 filesystems with SPL. This permits
481 U-Boot (or Linux in Falcon mode) to be loaded from an EXT
482 filesystem from within SPL. Support for the underlying block
483 device (e.g. MMC or USB) must be enabled separately.
484
Tien Fong Chee0c3a9ed2019-01-23 14:20:03 +0800485config SPL_FS_FAT
Simon Glass11bde1c2016-09-13 07:05:23 -0600486 bool "Support FAT filesystems"
Sekhar Norieedfb892017-06-02 17:53:59 +0530487 select FS_FAT
Simon Glass11bde1c2016-09-13 07:05:23 -0600488 help
489 Enable support for FAT and VFAT filesystems with SPL. This
490 permits U-Boot (or Linux in Falcon mode) to be loaded from a FAT
491 filesystem from within SPL. Support for the underlying block
492 device (e.g. MMC or USB) must be enabled separately.
493
Tien Fong Cheed8c3ea92019-01-23 14:20:04 +0800494config SPL_FAT_WRITE
495 bool "Support write for FAT filesystems"
496 help
497 Enable write support for FAT and VFAT filesystems with SPL.
498 Support for the underlying block device (e.g. MMC or USB) must be
499 enabled separately.
500
Simon Glass11bde1c2016-09-13 07:05:23 -0600501config SPL_FPGA_SUPPORT
502 bool "Support FPGAs"
Simon Glass11bde1c2016-09-13 07:05:23 -0600503 help
504 Enable support for FPGAs in SPL. Field-programmable Gate Arrays
505 provide software-configurable hardware which is typically used to
506 implement peripherals (such as UARTs, LCD displays, MMC) or
507 accelerate custom processing functions, such as image processing
508 or machine learning. Sometimes it is useful to program the FPGA
509 as early as possible during boot, and this option can enable that
510 within SPL.
511
512config SPL_GPIO_SUPPORT
Simon Glass2d424eb2018-11-15 18:43:55 -0700513 bool "Support GPIO in SPL"
Simon Glass11bde1c2016-09-13 07:05:23 -0600514 help
515 Enable support for GPIOs (General-purpose Input/Output) in SPL.
516 GPIOs allow U-Boot to read the state of an input line (high or
517 low) and set the state of an output line. This can be used to
518 drive LEDs, control power to various system parts and read user
519 input. GPIOs can be useful in SPL to enable a 'sign-of-life' LED,
520 for example. Enable this option to build the drivers in
521 drivers/gpio as part of an SPL build.
522
523config SPL_I2C_SUPPORT
524 bool "Support I2C"
Simon Glass11bde1c2016-09-13 07:05:23 -0600525 help
526 Enable support for the I2C (Inter-Integrated Circuit) bus in SPL.
527 I2C works with a clock and data line which can be driven by a
528 one or more masters or slaves. It is a fairly complex bus but is
529 widely used as it only needs two lines for communication. Speeds of
530 400kbps are typical but up to 3.4Mbps is supported by some
531 hardware. I2C can be useful in SPL to configure power management
532 ICs (PMICs) before raising the CPU clock speed, for example.
533 Enable this option to build the drivers in drivers/i2c as part of
534 an SPL build.
535
536config SPL_LIBCOMMON_SUPPORT
537 bool "Support common libraries"
Simon Glass11bde1c2016-09-13 07:05:23 -0600538 help
539 Enable support for common U-Boot libraries within SPL. These
540 libraries include common code to deal with U-Boot images,
541 environment and USB, for example. This option is enabled on many
542 boards. Enable this option to build the code in common/ as part of
543 an SPL build.
544
545config SPL_LIBDISK_SUPPORT
Simon Goldschmidt00416702018-08-16 09:44:55 +0200546 bool "Support disk partitions"
Tom Rini91ff6862018-12-05 08:23:38 -0500547 select PARTITIONS
Simon Glass11bde1c2016-09-13 07:05:23 -0600548 help
549 Enable support for disk partitions within SPL. 'Disk' is something
550 of a misnomer as it includes non-spinning media such as flash (as
551 used in MMC and USB sticks). Partitions provide a way for a disk
552 to be split up into separate regions, with a partition table placed
553 at the start or end which describes the location and size of each
554 'partition'. These partitions are typically uses as individual block
555 devices, typically with an EXT2 or FAT filesystem in each. This
556 option enables whatever partition support has been enabled in
557 U-Boot to also be used in SPL. It brings in the code in disk/.
558
559config SPL_LIBGENERIC_SUPPORT
560 bool "Support generic libraries"
Simon Glass11bde1c2016-09-13 07:05:23 -0600561 help
562 Enable support for generic U-Boot libraries within SPL. These
563 libraries include generic code to deal with device tree, hashing,
564 printf(), compression and the like. This option is enabled on many
565 boards. Enable this option to build the code in lib/ as part of an
566 SPL build.
567
Lokesh Vutla88027412018-08-27 15:57:49 +0530568config SPL_DM_MAILBOX
569 bool "Support Mailbox"
570 help
571 Enable support for Mailbox within SPL. This enable the inter
572 processor communication protocols tobe used within SPL. Enable
573 this option to build the drivers in drivers/mailbox as part of
574 SPL build.
575
Simon Glass11bde1c2016-09-13 07:05:23 -0600576config SPL_MMC_SUPPORT
577 bool "Support MMC"
Tom Rini226498b2017-05-22 19:21:57 +0000578 depends on MMC
Tom Rini91ff6862018-12-05 08:23:38 -0500579 select HAVE_BLOCK_DEVICE
Simon Glass11bde1c2016-09-13 07:05:23 -0600580 help
581 Enable support for MMC (Multimedia Card) within SPL. This enables
582 the MMC protocol implementation and allows any enabled drivers to
583 be used within SPL. MMC can be used with or without disk partition
584 support depending on the application (SPL_LIBDISK_SUPPORT). Enable
585 this option to build the drivers in drivers/mmc as part of an SPL
586 build.
587
Ezequiel Garciabf7c01d2019-05-25 19:25:21 -0300588config SPL_MMC_TINY
589 bool "Tiny MMC framework in SPL"
590 depends on SPL_MMC_SUPPORT
591 default n
592 help
593 Enable MMC framework tinification support. This option is useful if
594 if your SPL is extremely size constrained. Heed the warning, enable
595 this option if and only if you know exactly what you are doing, if
596 you are reading this help text, you most likely have no idea :-)
597
598 The MMC framework is reduced to bare minimum to be useful. No malloc
599 support is needed for the MMC framework operation with this option
600 enabled. The framework supports exactly one MMC device and exactly
601 one MMC driver. The MMC driver can be adjusted to avoid any malloc
602 operations too, which can remove the need for malloc support in SPL
603 and thus further reduce footprint.
604
Jean-Jacques Hiblotd6400c32018-01-04 15:23:32 +0100605config SPL_MMC_WRITE
606 bool "MMC/SD/SDIO card support for write operations in SPL"
607 depends on SPL_MMC_SUPPORT
608 default n
609 help
610 Enable write access to MMC and SD Cards in SPL
611
612
Simon Glass11bde1c2016-09-13 07:05:23 -0600613config SPL_MPC8XXX_INIT_DDR_SUPPORT
614 bool "Support MPC8XXX DDR init"
Simon Glass11bde1c2016-09-13 07:05:23 -0600615 help
616 Enable support for DDR-SDRAM (double-data-rate synchronous dynamic
617 random-access memory) on the MPC8XXX family within SPL. This
618 allows DRAM to be set up before loading U-Boot into that DRAM,
619 where it can run.
620
621config SPL_MTD_SUPPORT
622 bool "Support MTD drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -0600623 help
624 Enable support for MTD (Memory Technology Device) within SPL. MTD
625 provides a block interface over raw NAND and can also be used with
626 SPI flash. This allows SPL to load U-Boot from supported MTD
627 devices. See SPL_NAND_SUPPORT and SPL_ONENAND_SUPPORT for how
628 to enable specific MTD drivers.
629
630config SPL_MUSB_NEW_SUPPORT
631 bool "Support new Mentor Graphics USB"
Simon Glass11bde1c2016-09-13 07:05:23 -0600632 help
633 Enable support for Mentor Graphics USB in SPL. This is a new
634 driver used by some boards. Enable this option to build
635 the drivers in drivers/usb/musb-new as part of an SPL build. The
636 old drivers are in drivers/usb/musb.
637
638config SPL_NAND_SUPPORT
639 bool "Support NAND flash"
Simon Glass11bde1c2016-09-13 07:05:23 -0600640 help
641 Enable support for NAND (Negative AND) flash in SPL. NAND flash
642 can be used to allow SPL to load U-Boot from supported devices.
Miquel Raynala430fa02018-08-16 17:30:07 +0200643 This enables the drivers in drivers/mtd/nand/raw as part of an SPL
Simon Glass11bde1c2016-09-13 07:05:23 -0600644 build.
645
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200646config SPL_UBI
647 bool "Support UBI"
648 help
649 Enable support for loading payloads from UBI. See
650 README.ubispl for more info.
651
652if SPL_UBI
Hamish Guthrie6ea31cc2019-05-15 15:15:59 +0200653config SPL_UBI_LOAD_BY_VOLNAME
654 bool "Support loading volumes by name"
655 help
656 This enables support for loading UBI volumes by name. When this
657 is set, CONFIG_SPL_UBI_LOAD_MONITOR_VOLNAME can be used to
658 configure the volume name from which to load U-Boot.
659
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200660config SPL_UBI_MAX_VOL_LEBS
661 int "Maximum number of LEBs per volume"
662 depends on SPL_UBI
663 help
664 The maximum number of logical eraseblocks which a static volume
665 to load can contain. Used for sizing the scan data structure.
666
667config SPL_UBI_MAX_PEB_SIZE
668 int "Maximum PEB size"
669 depends on SPL_UBI
670 help
671 The maximum physical erase block size.
672
673config SPL_UBI_MAX_PEBS
674 int "Maximum number of PEBs"
675 depends on SPL_UBI
676 help
677 The maximum physical erase block size. If not overridden by
678 board code, this value will be used as the actual number of PEBs.
679
680config SPL_UBI_PEB_OFFSET
681 int "Offset to first UBI PEB"
682 depends on SPL_UBI
683 help
684 The offset in number of PEBs from the start of flash to the first
685 PEB part of the UBI image.
686
687config SPL_UBI_VID_OFFSET
688 int "Offset to VID header"
689 depends on SPL_UBI
690
691config SPL_UBI_LEB_START
692 int "Offset to LEB in PEB"
693 depends on SPL_UBI
694 help
695 The offset in bytes to the LEB within a PEB.
696
697config SPL_UBI_INFO_ADDR
698 hex "Address to place UBI scan info"
699 depends on SPL_UBI
700 help
701 Address for ubispl to place the scan info. Read README.ubispl to
702 determine the required size
703
704config SPL_UBI_VOL_IDS
705 int "Maximum volume id"
706 depends on SPL_UBI
707 help
708 The maximum volume id which can be loaded. Used for sizing the
709 scan data structure.
710
711config SPL_UBI_LOAD_MONITOR_ID
712 int "id of U-Boot volume"
713 depends on SPL_UBI
714 help
715 The UBI volume id from which to load U-Boot
716
Hamish Guthrie6ea31cc2019-05-15 15:15:59 +0200717config SPL_UBI_LOAD_MONITOR_VOLNAME
718 string "volume name of U-Boot volume"
719 depends on SPL_UBI_LOAD_BY_VOLNAME
720 help
721 The UBI volume name from which to load U-Boot
722
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200723config SPL_UBI_LOAD_KERNEL_ID
724 int "id of kernel volume"
725 depends on SPL_OS_BOOT && SPL_UBI
726 help
727 The UBI volume id from which to load the kernel
728
729config SPL_UBI_LOAD_ARGS_ID
730 int "id of kernel args volume"
731 depends on SPL_OS_BOOT && SPL_UBI
732 help
733 The UBI volume id from which to load the device tree
734
Markus Klotzbuechera2257d32019-05-15 15:16:00 +0200735config UBI_SPL_SILENCE_MSG
736 bool "silence UBI SPL messages"
737 default n
738 help
739 Disable messages from UBI SPL. This leaves warnings
740 and errors enabled.
Markus Klotzbuecherc67c3492019-05-15 15:15:57 +0200741
742endif # if SPL_UBI
743
Simon Glass11bde1c2016-09-13 07:05:23 -0600744config SPL_NET_SUPPORT
745 bool "Support networking"
Simon Glass11bde1c2016-09-13 07:05:23 -0600746 help
747 Enable support for network devices (such as Ethernet) in SPL.
748 This permits SPL to load U-Boot over a network link rather than
749 from an on-board peripheral. Environment support is required since
750 the network stack uses a number of environment variables. See also
751 SPL_ETH_SUPPORT.
752
753if SPL_NET_SUPPORT
754config SPL_NET_VCI_STRING
755 string "BOOTP Vendor Class Identifier string sent by SPL"
756 help
757 As defined by RFC 2132 the vendor class identifier field can be
758 sent by the client to identify the vendor type and configuration
759 of a client. This is often used in practice to allow for the DHCP
760 server to specify different files to load depending on if the ROM,
761 SPL or U-Boot itself makes the request
762endif # if SPL_NET_SUPPORT
763
764config SPL_NO_CPU_SUPPORT
765 bool "Drop CPU code in SPL"
Simon Glass11bde1c2016-09-13 07:05:23 -0600766 help
767 This is specific to the ARM926EJ-S CPU. It disables the standard
768 start.S start-up code, presumably so that a replacement can be
769 used on that CPU. You should not enable it unless you know what
770 you are doing.
771
772config SPL_NOR_SUPPORT
773 bool "Support NOR flash"
Simon Glass11bde1c2016-09-13 07:05:23 -0600774 help
775 Enable support for loading U-Boot from memory-mapped NOR (Negative
776 OR) flash in SPL. NOR flash is slow to write but fast to read, and
777 a memory-mapped device makes it very easy to access. Loading from
778 NOR is typically achieved with just a memcpy().
779
Vikas Manochac6d9e9d2017-05-28 12:55:11 -0700780config SPL_XIP_SUPPORT
781 bool "Support XIP"
782 depends on SPL
783 help
784 Enable support for execute in place of U-Boot or kernel image. There
785 is no need to copy image from flash to ram if flash supports execute
786 in place. Its very useful in systems having enough flash but not
787 enough ram to load the image.
788
Simon Glass11bde1c2016-09-13 07:05:23 -0600789config SPL_ONENAND_SUPPORT
790 bool "Support OneNAND flash"
Simon Glass11bde1c2016-09-13 07:05:23 -0600791 help
792 Enable support for OneNAND (Negative AND) flash in SPL. OneNAND is
793 a type of NAND flash and therefore can be used to allow SPL to
794 load U-Boot from supported devices. This enables the drivers in
795 drivers/mtd/onenand as part of an SPL build.
796
Heiko Schocherc20ae2f2016-10-06 07:55:15 +0200797config SPL_OS_BOOT
798 bool "Activate Falcon Mode"
Tom Rini226498b2017-05-22 19:21:57 +0000799 depends on !TI_SECURE_DEVICE
Heiko Schocherc20ae2f2016-10-06 07:55:15 +0200800 default n
801 help
802 Enable booting directly to an OS from SPL.
803 for more info read doc/README.falcon
804
Heiko Schocher29d3bc72016-10-06 07:55:16 +0200805if SPL_OS_BOOT
806config SYS_OS_BASE
807 hex "addr, where OS is found"
Tom Rini226498b2017-05-22 19:21:57 +0000808 depends on SPL_NOR_SUPPORT
Heiko Schocher29d3bc72016-10-06 07:55:16 +0200809 help
810 Specify the address, where the OS image is found, which
811 gets booted.
812
813endif # SPL_OS_BOOT
814
York Sun7550dbe2018-06-14 14:38:48 -0700815config SPL_PAYLOAD
816 string "SPL payload"
817 default "tpl/u-boot-with-tpl.bin" if TPL
818 default "u-boot.bin"
819 help
Chris Packham2dcfa052019-01-13 22:13:20 +1300820 Payload for SPL boot. For backward compatibility, default to
York Sun7550dbe2018-06-14 14:38:48 -0700821 u-boot.bin, i.e. RAW image without any header. In case of
822 TPL, tpl/u-boot-with-tpl.bin. For new boards, suggest to
823 use u-boot.img.
824
Sekhar Norid50d6812018-12-06 15:40:08 +0530825config SPL_PCI
Simon Glass2446b6b2017-01-16 07:03:30 -0700826 bool "Support PCI drivers"
Simon Glass2446b6b2017-01-16 07:03:30 -0700827 help
828 Enable support for PCI in SPL. For platforms that need PCI to boot,
829 or must perform some init using PCI in SPL, this provides the
830 necessary driver support. This enables the drivers in drivers/pci
831 as part of an SPL build.
832
Simon Glassbbe41ab2017-01-16 07:03:33 -0700833config SPL_PCH_SUPPORT
834 bool "Support PCH drivers"
Simon Glassbbe41ab2017-01-16 07:03:33 -0700835 help
836 Enable support for PCH (Platform Controller Hub) devices in SPL.
837 These are used to set up GPIOs and the SPI peripheral early in
838 boot. This enables the drivers in drivers/pch as part of an SPL
839 build.
840
Simon Glass11bde1c2016-09-13 07:05:23 -0600841config SPL_POST_MEM_SUPPORT
842 bool "Support POST drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -0600843 help
844 Enable support for POST (Power-on Self Test) in SPL. POST is a
845 procedure that checks that the hardware (CPU or board) appears to
846 be functionally correctly. It is a sanity check that can be
847 performed before booting. This enables the drivers in post/drivers
848 as part of an SPL build.
849
Ley Foon Tanbfc6bae2018-06-14 18:45:19 +0800850config SPL_DM_RESET
Patrick Delaunay0e373c02018-03-12 10:46:05 +0100851 bool "Support reset drivers"
852 depends on SPL
853 help
854 Enable support for reset control in SPL.
855 That can be useful in SPL to handle IP reset in driver, as in U-Boot,
856 by using the generic reset API provided by driver model.
857 This enables the drivers in drivers/reset as part of an SPL build.
858
Simon Glass11bde1c2016-09-13 07:05:23 -0600859config SPL_POWER_SUPPORT
860 bool "Support power drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -0600861 help
862 Enable support for power control in SPL. This includes support
863 for PMICs (Power-management Integrated Circuits) and some of the
864 features provided by PMICs. In particular, voltage regulators can
865 be used to enable/disable power and vary its voltage. That can be
866 useful in SPL to turn on boot peripherals and adjust CPU voltage
867 so that the clock speed can be increased. This enables the drivers
868 in drivers/power, drivers/power/pmic and drivers/power/regulator
869 as part of an SPL build.
870
Peng Fane13278c2018-07-27 10:20:37 +0800871config SPL_POWER_DOMAIN
872 bool "Support power domain drivers"
873 help
874 Enable support for power domain control in SPL. Many SoCs allow
875 power to be applied to or removed from portions of the SoC (power
876 domains). This may be used to save power. This API provides the
877 means to control such power management hardware. This enables
878 the drivers in drivers/power/domain as part of a SPL build.
879
Stefan Agner22802f42016-12-23 07:51:53 +0100880config SPL_RAM_SUPPORT
881 bool "Support booting from RAM"
Stefan Agner22802f42016-12-23 07:51:53 +0100882 default y if MICROBLAZE || ARCH_SOCFPGA || TEGRA || ARCH_ZYNQ
883 help
884 Enable booting of an image in RAM. The image can be preloaded or
885 it can be loaded by SPL directly into RAM (e.g. using USB).
886
Stefan Agnerf417d402016-12-23 07:51:52 +0100887config SPL_RAM_DEVICE
888 bool "Support booting from preloaded image in RAM"
Stefan Agner22802f42016-12-23 07:51:53 +0100889 depends on SPL_RAM_SUPPORT
Stefan Agnerf417d402016-12-23 07:51:52 +0100890 default y if MICROBLAZE || ARCH_SOCFPGA || TEGRA || ARCH_ZYNQ
891 help
892 Enable booting of an image already loaded in RAM. The image has to
893 be already in memory when SPL takes over, e.g. loaded by the boot
894 ROM.
895
Lokesh Vutla08c45312018-08-27 15:57:53 +0530896config SPL_REMOTEPROC
897 bool "Support REMOTEPROCS"
898 help
899 Enable support for REMOTEPROCs in SPL. This permits to load
900 a remote processor firmware in SPL.
901
Simon Glass30bf8a02017-01-16 07:03:31 -0700902config SPL_RTC_SUPPORT
903 bool "Support RTC drivers"
Simon Glass30bf8a02017-01-16 07:03:31 -0700904 help
905 Enable RTC (Real-time Clock) support in SPL. This includes support
906 for reading and setting the time. Some RTC devices also have some
907 non-volatile (battery-backed) memory which is accessible if
908 needed. This enables the drivers in drivers/rtc as part of an SPL
909 build.
910
Simon Glass11bde1c2016-09-13 07:05:23 -0600911config SPL_SATA_SUPPORT
912 bool "Support loading from SATA"
Simon Glass11bde1c2016-09-13 07:05:23 -0600913 help
914 Enable support for SATA (Serial AT attachment) in SPL. This allows
915 use of SATA devices such as hard drives and flash drivers for
916 loading U-Boot. SATA is used in higher-end embedded systems and
917 can provide higher performance than MMC , at somewhat higher
918 expense and power consumption. This enables loading from SATA
919 using a configured device.
920
921config SPL_SERIAL_SUPPORT
922 bool "Support serial"
Alex Kiernan14ad44a2018-04-19 04:32:54 +0000923 select SPL_PRINTF
924 select SPL_STRTO
Simon Glass11bde1c2016-09-13 07:05:23 -0600925 help
926 Enable support for serial in SPL. This allows use of a serial UART
927 for displaying messages while SPL is running. It also brings in
928 printf() and panic() functions. This should normally be enabled
929 unless there are space reasons not to. Even then, consider
930 enabling USE_TINY_PRINTF which is a small printf() version.
931
932config SPL_SPI_FLASH_SUPPORT
933 bool "Support SPI flash drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -0600934 help
935 Enable support for using SPI flash in SPL, and loading U-Boot from
936 SPI flash. SPI flash (Serial Peripheral Bus flash) is named after
937 the SPI bus that is used to connect it to a system. It is a simple
938 but fast bidirectional 4-wire bus (clock, chip select and two data
939 lines). This enables the drivers in drivers/mtd/spi as part of an
940 SPL build. This normally requires SPL_SPI_SUPPORT.
941
Vignesh R0c6f1872019-02-05 11:29:20 +0530942if SPL_SPI_FLASH_SUPPORT
943
Vignesh R778572d2019-02-05 11:29:25 +0530944config SPL_SPI_FLASH_TINY
945 bool "Enable low footprint SPL SPI Flash support"
946 depends on !SPI_FLASH_BAR
Vignesh R72875972019-02-05 11:29:26 +0530947 default y if SPI_FLASH
Vignesh R778572d2019-02-05 11:29:25 +0530948 help
949 Enable lightweight SPL SPI Flash support that supports just reading
950 data/images from flash. No support to write/erase flash. Enable
951 this if you have SPL size limitations and don't need full
952 fledged SPI flash support.
953
Vignesh R0c6f1872019-02-05 11:29:20 +0530954config SPL_SPI_FLASH_SFDP_SUPPORT
955 bool "SFDP table parsing support for SPI NOR flashes"
Vignesh R778572d2019-02-05 11:29:25 +0530956 depends on !SPI_FLASH_BAR && !SPL_SPI_FLASH_TINY
Vignesh R0c6f1872019-02-05 11:29:20 +0530957 help
958 Enable support for parsing and auto discovery of parameters for
959 SPI NOR flashes using Serial Flash Discoverable Parameters (SFDP)
960 tables as per JESD216 standard in SPL.
961
Marek Vasut55500432018-04-07 16:05:27 +0200962config SPL_SPI_LOAD
963 bool "Support loading from SPI flash"
Marek Vasut55500432018-04-07 16:05:27 +0200964 help
965 Enable support for loading next stage, U-Boot or otherwise, from
966 SPI NOR in U-Boot SPL.
967
Vignesh R0c6f1872019-02-05 11:29:20 +0530968endif # SPL_SPI_FLASH_SUPPORT
969
Simon Glass11bde1c2016-09-13 07:05:23 -0600970config SPL_SPI_SUPPORT
971 bool "Support SPI drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -0600972 help
973 Enable support for using SPI in SPL. This is used for connecting
974 to SPI flash for loading U-Boot. See SPL_SPI_FLASH_SUPPORT for
975 more details on that. The SPI driver provides the transport for
976 data between the SPI flash and the CPU. This option can be used to
977 enable SPI drivers that are needed for other purposes also, such
978 as a SPI PMIC.
979
Faiz Abbas8502f9f2017-11-14 16:12:31 +0530980config SPL_THERMAL
981 bool "Driver support for thermal devices"
982 help
983 Enable support for temperature-sensing devices. Some SoCs have on-chip
984 temperature sensors to permit warnings, speed throttling or even
985 automatic power-off when the temperature gets too high or low. Other
986 devices may be discrete but connected on a suitable bus.
987
Simon Glass11bde1c2016-09-13 07:05:23 -0600988config SPL_USB_HOST_SUPPORT
989 bool "Support USB host drivers"
Tom Rini91ff6862018-12-05 08:23:38 -0500990 select HAVE_BLOCK_DEVICE
Simon Glass11bde1c2016-09-13 07:05:23 -0600991 help
992 Enable access to USB (Universal Serial Bus) host devices so that
993 SPL can load U-Boot from a connected USB peripheral, such as a USB
994 flash stick. While USB takes a little longer to start up than most
995 buses, it is very flexible since many different types of storage
996 device can be attached. This option enables the drivers in
997 drivers/usb/host as part of an SPL build.
998
Abel Vesa79536012019-02-01 16:40:07 +0000999config SPL_USB_STORAGE
Simon Glass11bde1c2016-09-13 07:05:23 -06001000 bool "Support loading from USB"
Abel Vesa79536012019-02-01 16:40:07 +00001001 depends on SPL_USB_HOST_SUPPORT && !(BLK && !DM_USB)
Simon Glass11bde1c2016-09-13 07:05:23 -06001002 help
1003 Enable support for USB devices in SPL. This allows use of USB
1004 devices such as hard drives and flash drivers for loading U-Boot.
1005 The actual drivers are enabled separately using the normal U-Boot
1006 config options. This enables loading from USB using a configured
1007 device.
1008
Jean-Jacques Hiblotf811e972019-01-10 15:44:13 +01001009config SPL_USB_GADGET
Stefan Agnere94793c2016-11-21 10:58:53 -08001010 bool "Suppport USB Gadget drivers"
Stefan Agnere94793c2016-11-21 10:58:53 -08001011 help
1012 Enable USB Gadget API which allows to enable USB device functions
1013 in SPL.
1014
Jean-Jacques Hiblotf811e972019-01-10 15:44:13 +01001015if SPL_USB_GADGET
Stefan Agnere94793c2016-11-21 10:58:53 -08001016
Faiz Abbasb432b1e2018-02-16 21:17:44 +05301017config SPL_USB_ETHER
Stefan Agnere94793c2016-11-21 10:58:53 -08001018 bool "Support USB Ethernet drivers"
1019 help
1020 Enable access to the USB network subsystem and associated
1021 drivers in SPL. This permits SPL to load U-Boot over a
1022 USB-connected Ethernet link (such as a USB Ethernet dongle) rather
1023 than from an onboard peripheral. Environment support is required
1024 since the network stack uses a number of environment variables.
1025 See also SPL_NET_SUPPORT and SPL_ETH_SUPPORT.
1026
Andrew F. Davis6536ca42019-01-17 13:43:02 -06001027config SPL_DFU
Fabio Estevamc3c19c22018-08-31 10:02:28 -03001028 bool "Support DFU (Device Firmware Upgrade)"
Stefan Agner59917032016-11-21 10:58:52 -08001029 select SPL_HASH_SUPPORT
B, Ravi66928af2017-05-04 15:45:29 +05301030 select SPL_DFU_NO_RESET
B, Ravi1b19cbd2017-05-04 15:45:28 +05301031 depends on SPL_RAM_SUPPORT
Stefan Agner59917032016-11-21 10:58:52 -08001032 help
Fabio Estevamc3c19c22018-08-31 10:02:28 -03001033 This feature enables the DFU (Device Firmware Upgrade) in SPL with
Stefan Agner59917032016-11-21 10:58:52 -08001034 RAM memory device support. The ROM code will load and execute
1035 the SPL built with dfu. The user can load binaries (u-boot/kernel) to
1036 selected device partition from host-pc using dfu-utils.
1037 This feature is useful to flash the binaries to factory or bare-metal
1038 boards using USB interface.
1039
1040choice
1041 bool "DFU device selection"
Andrew F. Davis6536ca42019-01-17 13:43:02 -06001042 depends on SPL_DFU
Stefan Agner59917032016-11-21 10:58:52 -08001043
1044config SPL_DFU_RAM
1045 bool "RAM device"
Andrew F. Davis6536ca42019-01-17 13:43:02 -06001046 depends on SPL_DFU && SPL_RAM_SUPPORT
Stefan Agner59917032016-11-21 10:58:52 -08001047 help
1048 select RAM/DDR memory device for loading binary images
1049 (u-boot/kernel) to the selected device partition using
1050 DFU and execute the u-boot/kernel from RAM.
1051
1052endchoice
1053
Stefan Agnera3774c12017-08-16 11:00:54 -07001054config SPL_USB_SDP_SUPPORT
1055 bool "Support SDP (Serial Download Protocol)"
1056 help
1057 Enable Serial Download Protocol (SDP) device support in SPL. This
1058 allows to download images into memory and execute (jump to) them
1059 using the same protocol as implemented by the i.MX family's boot ROM.
Stefan Agnere94793c2016-11-21 10:58:53 -08001060endif
1061
Simon Glass11bde1c2016-09-13 07:05:23 -06001062config SPL_WATCHDOG_SUPPORT
1063 bool "Support watchdog drivers"
Simon Glass11bde1c2016-09-13 07:05:23 -06001064 help
1065 Enable support for watchdog drivers in SPL. A watchdog is
1066 typically a hardware peripheral which can reset the system when it
1067 detects no activity for a while (such as a software crash). This
1068 enables the drivers in drivers/watchdog as part of an SPL build.
1069
1070config SPL_YMODEM_SUPPORT
1071 bool "Support loading using Ymodem"
Alex Kiernan3bac19c2018-04-19 04:32:52 +00001072 depends on SPL_SERIAL_SUPPORT
Simon Glass11bde1c2016-09-13 07:05:23 -06001073 help
1074 While loading from serial is slow it can be a useful backup when
1075 there is no other option. The Ymodem protocol provides a reliable
1076 means of transmitting U-Boot over a serial line for using in SPL,
1077 with a checksum to ensure correctness.
1078
Philipp Tomsichaa122f62017-09-13 21:29:36 +02001079config SPL_ATF
Kever Yangbcc17262017-05-05 11:47:45 +08001080 bool "Support ARM Trusted Firmware"
Tom Rini226498b2017-05-22 19:21:57 +00001081 depends on ARM64
Kever Yangbcc17262017-05-05 11:47:45 +08001082 help
Philipp Tomsichd21fb632018-01-02 21:16:43 +01001083 ATF(ARM Trusted Firmware) is a component for ARM AArch64 which
1084 is loaded by SPL (which is considered as BL2 in ATF terminology).
Kever Yangbcc17262017-05-05 11:47:45 +08001085 More detail at: https://github.com/ARM-software/arm-trusted-firmware
1086
Philipp Tomsichd21fb632018-01-02 21:16:43 +01001087config SPL_ATF_NO_PLATFORM_PARAM
1088 bool "Pass no platform parameter"
1089 depends on SPL_ATF
1090 help
1091 While we expect to call a pointer to a valid FDT (or NULL)
1092 as the platform parameter to an ATF, some ATF versions are
1093 not U-Boot aware and have an insufficiently robust parameter
1094 validation to gracefully reject a FDT being passed.
1095
1096 If this option is enabled, the spl_atf os-type handler will
1097 always pass NULL for the platform parameter.
1098
1099 If your ATF is affected, say Y.
1100
Alex Kiernan3bf5f132018-03-15 22:11:46 +00001101config SPL_AM33XX_ENABLE_RTC32K_OSC
1102 bool "Enable the RTC32K OSC on AM33xx based platforms"
1103 default y if AM33XX
1104 help
1105 Enable access to the AM33xx RTC and select the external 32kHz clock
1106 source.
1107
Kever Yang70fe2872018-08-23 17:17:59 +08001108config SPL_OPTEE
1109 bool "Support OP-TEE Trusted OS"
1110 depends on ARM
1111 help
1112 OP-TEE is an open source Trusted OS which is loaded by SPL.
1113 More detail at: https://github.com/OP-TEE/optee_os
1114
Tom Rini226498b2017-05-22 19:21:57 +00001115config TPL
1116 bool
1117 depends on SUPPORT_TPL
1118 prompt "Enable TPL"
1119 help
1120 If you want to build TPL as well as the normal image and SPL, say Y.
1121
1122if TPL
1123
Simon Glassb0edea32018-11-15 18:44:09 -07001124config TPL_HANDOFF
1125 bool "Pass hand-off information from TPL to SPL and U-Boot proper"
1126 depends on HANDOFF
1127 default y
1128 help
1129 This option enables TPL to write handoff information. This can be
1130 used to pass information like the size of SDRAM from TPL to U-Boot
1131 proper. The information is also available to SPL if it is useful
1132 there.
1133
Kever Yangaf2f4422018-01-20 18:00:26 +08001134config TPL_BOARD_INIT
1135 bool "Call board-specific initialization in TPL"
1136 help
1137 If this option is enabled, U-Boot will call the function
1138 spl_board_init() from board_init_r(). This function should be
1139 provided by the board.
1140
Philipp Tomsichdd6fbcb2017-07-28 19:20:49 +02001141config TPL_LDSCRIPT
1142 string "Linker script for the TPL stage"
1143 depends on TPL
Tom Rini2f41ade2019-01-22 17:09:26 -05001144 default "arch/arm/cpu/armv8/u-boot-spl.lds" if ARM64
1145 default "arch/$(ARCH)/cpu/u-boot-spl.lds"
Philipp Tomsichdd6fbcb2017-07-28 19:20:49 +02001146 help
1147 The TPL stage will usually require a different linker-script
1148 (as it runs from a different memory region) than the regular
1149 U-Boot stage. Set this to the path of the linker-script to
1150 be used for TPL.
1151
Philipp Tomsichb3ed6ce2017-07-28 20:02:34 +02001152 May be left empty to trigger the Makefile infrastructure to
1153 fall back to the linker-script used for the SPL stage.
1154
1155config TPL_NEEDS_SEPARATE_TEXT_BASE
1156 bool "TPL needs a separate text-base"
1157 default n
1158 depends on TPL
1159 help
1160 Enable, if the TPL stage should not inherit its text-base
1161 from the SPL stage. When enabled, a base address for the
1162 .text sections of the TPL stage has to be set below.
1163
1164config TPL_NEEDS_SEPARATE_STACK
1165 bool "TPL needs a separate initial stack-pointer"
1166 default n
1167 depends on TPL
1168 help
1169 Enable, if the TPL stage should not inherit its initial
1170 stack-pointer from the settings for the SPL stage.
1171
1172config TPL_TEXT_BASE
1173 hex "Base address for the .text section of the TPL stage"
1174 depends on TPL_NEEDS_SEPARATE_TEXT_BASE
1175 help
1176 The base address for the .text section of the TPL stage.
1177
1178config TPL_MAX_SIZE
1179 int "Maximum size (in bytes) for the TPL stage"
Philipp Tomsich5aa49af2017-07-28 20:20:41 +02001180 default 0
Philipp Tomsichb3ed6ce2017-07-28 20:02:34 +02001181 depends on TPL
1182 help
1183 The maximum size (in bytes) of the TPL stage.
1184
1185config TPL_STACK
1186 hex "Address of the initial stack-pointer for the TPL stage"
1187 depends on TPL_NEEDS_SEPARATE_STACK
1188 help
1189 The address of the initial stack-pointer for the TPL stage.
1190 Usually this will be the (aligned) top-of-stack.
1191
Philipp Tomsicha954fa32017-07-04 14:24:53 +02001192config TPL_BOOTROM_SUPPORT
1193 bool "Support returning to the BOOTROM (from TPL)"
1194 help
1195 Some platforms (e.g. the Rockchip RK3368) provide support in their
1196 ROM for loading the next boot-stage after performing basic setup
1197 from the TPL stage.
1198
1199 Enable this option, to return to the BOOTROM through the
1200 BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
1201 boot device list, if not implemented for a given board)
1202
Philipp Tomsichc3916e72017-07-04 14:27:02 +02001203config TPL_DRIVERS_MISC_SUPPORT
1204 bool "Support misc drivers in TPL"
1205 help
1206 Enable miscellaneous drivers in TPL. These drivers perform various
1207 tasks that don't fall nicely into other categories, Enable this
1208 option to build the drivers in drivers/misc as part of an TPL
1209 build, for those that support building in TPL (not all drivers do).
1210
Simon Glassf73329e2016-09-12 23:18:27 -06001211config TPL_ENV_SUPPORT
1212 bool "Support an environment"
Simon Glassf73329e2016-09-12 23:18:27 -06001213 help
1214 Enable environment support in TPL. See SPL_ENV_SUPPORT for details.
1215
Simon Glass2d424eb2018-11-15 18:43:55 -07001216config TPL_GPIO_SUPPORT
1217 bool "Support GPIO in TPL"
1218 help
1219 Enable support for GPIOs (General-purpose Input/Output) in TPL.
1220 GPIOs allow U-Boot to read the state of an input line (high or
1221 low) and set the state of an output line. This can be used to
1222 drive LEDs, control power to various system parts and read user
1223 input. GPIOs can be useful in TPL to enable a 'sign-of-life' LED,
1224 for example. Enable this option to build the drivers in
1225 drivers/gpio as part of an TPL build.
1226
Simon Glassf73329e2016-09-12 23:18:27 -06001227config TPL_I2C_SUPPORT
1228 bool "Support I2C"
Simon Glassf73329e2016-09-12 23:18:27 -06001229 help
Philipp Tomsich616bd092017-07-28 17:03:03 +02001230 Enable support for the I2C bus in TPL. See SPL_I2C_SUPPORT for
Simon Glassf73329e2016-09-12 23:18:27 -06001231 details.
1232
1233config TPL_LIBCOMMON_SUPPORT
1234 bool "Support common libraries"
Simon Glassf73329e2016-09-12 23:18:27 -06001235 help
1236 Enable support for common U-Boot libraries within TPL. See
1237 SPL_LIBCOMMON_SUPPORT for details.
1238
1239config TPL_LIBGENERIC_SUPPORT
1240 bool "Support generic libraries"
Simon Glassf73329e2016-09-12 23:18:27 -06001241 help
1242 Enable support for generic U-Boot libraries within TPL. See
1243 SPL_LIBGENERIC_SUPPORT for details.
1244
1245config TPL_MPC8XXX_INIT_DDR_SUPPORT
1246 bool "Support MPC8XXX DDR init"
Simon Glassf73329e2016-09-12 23:18:27 -06001247 help
1248 Enable support for DDR-SDRAM on the MPC8XXX family within TPL. See
1249 SPL_MPC8XXX_INIT_DDR_SUPPORT for details.
1250
1251config TPL_MMC_SUPPORT
1252 bool "Support MMC"
Tom Rini226498b2017-05-22 19:21:57 +00001253 depends on MMC
Simon Glassf73329e2016-09-12 23:18:27 -06001254 help
1255 Enable support for MMC within TPL. See SPL_MMC_SUPPORT for details.
1256
1257config TPL_NAND_SUPPORT
1258 bool "Support NAND flash"
Simon Glassf73329e2016-09-12 23:18:27 -06001259 help
Philipp Tomsich616bd092017-07-28 17:03:03 +02001260 Enable support for NAND in TPL. See SPL_NAND_SUPPORT for details.
Simon Glassf73329e2016-09-12 23:18:27 -06001261
Sekhar Norid50d6812018-12-06 15:40:08 +05301262config TPL_PCI
Simon Glass2d424eb2018-11-15 18:43:55 -07001263 bool "Support PCI drivers"
1264 help
1265 Enable support for PCI in TPL. For platforms that need PCI to boot,
1266 or must perform some init using PCI in SPL, this provides the
1267 necessary driver support. This enables the drivers in drivers/pci
1268 as part of a TPL build.
1269
1270config TPL_PCH_SUPPORT
1271 bool "Support PCH drivers"
1272 help
1273 Enable support for PCH (Platform Controller Hub) devices in TPL.
1274 These are used to set up GPIOs and the SPI peripheral early in
1275 boot. This enables the drivers in drivers/pch as part of a TPL
1276 build.
1277
Marek Vasutd79dfd42018-04-07 17:03:45 +02001278config TPL_RAM_SUPPORT
1279 bool "Support booting from RAM"
1280 help
1281 Enable booting of an image in RAM. The image can be preloaded or
1282 it can be loaded by TPL directly into RAM (e.g. using USB).
1283
1284config TPL_RAM_DEVICE
1285 bool "Support booting from preloaded image in RAM"
1286 depends on TPL_RAM_SUPPORT
1287 help
1288 Enable booting of an image already loaded in RAM. The image has to
1289 be already in memory when TPL takes over, e.g. loaded by the boot
1290 ROM.
1291
Simon Glass2d424eb2018-11-15 18:43:55 -07001292config TPL_RTC_SUPPORT
1293 bool "Support RTC drivers"
1294 help
1295 Enable RTC (Real-time Clock) support in TPL. This includes support
1296 for reading and setting the time. Some RTC devices also have some
1297 non-volatile (battery-backed) memory which is accessible if
1298 needed. This enables the drivers in drivers/rtc as part of an TPL
1299 build.
1300
Simon Glassf73329e2016-09-12 23:18:27 -06001301config TPL_SERIAL_SUPPORT
1302 bool "Support serial"
Alex Kiernan14ad44a2018-04-19 04:32:54 +00001303 select TPL_PRINTF
1304 select TPL_STRTO
Simon Glassf73329e2016-09-12 23:18:27 -06001305 help
Philipp Tomsich616bd092017-07-28 17:03:03 +02001306 Enable support for serial in TPL. See SPL_SERIAL_SUPPORT for
Simon Glassf73329e2016-09-12 23:18:27 -06001307 details.
1308
1309config TPL_SPI_FLASH_SUPPORT
1310 bool "Support SPI flash drivers"
Simon Glassf73329e2016-09-12 23:18:27 -06001311 help
Philipp Tomsich616bd092017-07-28 17:03:03 +02001312 Enable support for using SPI flash in TPL. See SPL_SPI_FLASH_SUPPORT
Simon Glassf73329e2016-09-12 23:18:27 -06001313 for details.
1314
Marek Vasut1e725e22018-04-07 16:05:46 +02001315config TPL_SPI_LOAD
1316 bool "Support loading from SPI flash"
1317 depends on TPL_SPI_FLASH_SUPPORT
1318 help
1319 Enable support for loading next stage, U-Boot or otherwise, from
1320 SPI NOR in U-Boot TPL.
1321
Simon Glassf73329e2016-09-12 23:18:27 -06001322config TPL_SPI_SUPPORT
1323 bool "Support SPI drivers"
Simon Glassf73329e2016-09-12 23:18:27 -06001324 help
Philipp Tomsich616bd092017-07-28 17:03:03 +02001325 Enable support for using SPI in TPL. See SPL_SPI_SUPPORT for
Simon Glassf73329e2016-09-12 23:18:27 -06001326 details.
1327
Marek Vasut6ce3d672018-04-07 16:06:11 +02001328config TPL_YMODEM_SUPPORT
1329 bool "Support loading using Ymodem"
Alex Kiernan3bac19c2018-04-19 04:32:52 +00001330 depends on TPL_SERIAL_SUPPORT
Marek Vasut6ce3d672018-04-07 16:06:11 +02001331 help
1332 While loading from serial is slow it can be a useful backup when
1333 there is no other option. The Ymodem protocol provides a reliable
1334 means of transmitting U-Boot over a serial line for using in TPL,
1335 with a checksum to ensure correctness.
1336
Tom Rini226498b2017-05-22 19:21:57 +00001337endif # TPL
1338
Eugen Hristev0be07872019-05-24 09:38:10 +03001339config SPL_AT91_MCK_BYPASS
1340 bool "Use external clock signal as a source of main clock for AT91 platforms"
1341 depends on ARCH_AT91
1342 default n
1343 help
1344 Use external 8 to 24 Mhz clock signal as source of main clock instead
1345 of an external crystal oscillator.
1346 This option disables the internal driving on the XOUT pin.
1347 The external source has to provide a stable clock on the XIN pin.
1348 If this option is disabled, the SoC expects a crystal oscillator
1349 that needs driving on both XIN and XOUT lines.
1350
Tom Rini226498b2017-05-22 19:21:57 +00001351endif # SPL
Simon Glass11bde1c2016-09-13 07:05:23 -06001352endmenu