Merge https://gitlab.denx.de/u-boot/custodians/u-boot-usb
[platform/kernel/u-boot.git] / common / spl / Kconfig
1 menu "SPL / TPL"
2
3 config SUPPORT_SPL
4         bool
5
6 config SUPPORT_TPL
7         bool
8
9 config SPL_DFU_NO_RESET
10         bool
11
12 config 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
19 config 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
28 config SPL_FRAMEWORK_BOARD_INIT_F
29         bool "Define a generic function board_init_f"
30         depends on SPL_FRAMEWORK
31         help
32           Define a generic function board_init_f that:
33           - initialize the spl (spl_early_init)
34           - initialize the serial (preloader_console_init)
35           Unless you want to provide your own board_init_f, you should say Y.
36
37 config SPL_SIZE_LIMIT
38         hex "Maximum size of SPL image"
39         depends on SPL
40         default 0x11000 if ARCH_MX6 && !MX6_OCRAM_256KB
41         default 0x31000 if ARCH_MX6 && MX6_OCRAM_256KB
42         default 0x0
43         help
44           Specifies the maximum length of the U-Boot SPL image.
45           If this value is zero, it is ignored.
46
47 config SPL_SIZE_LIMIT_SUBTRACT_GD
48         bool "SPL image size check: provide space for global data"
49         depends on SPL_SIZE_LIMIT > 0
50         help
51           If enabled, aligned size of global data is reserved in
52           SPL_SIZE_LIMIT check to ensure such an image does not overflow SRAM
53           if SPL_SIZE_LIMIT describes the size of SRAM available for SPL when
54           pre-reloc global data is put into this SRAM, too.
55
56 config SPL_SIZE_LIMIT_SUBTRACT_MALLOC
57         bool "SPL image size check: provide space for malloc() pool before relocation"
58         depends on SPL_SIZE_LIMIT > 0
59         help
60           If enabled, SPL_SYS_MALLOC_F_LEN is reserved in SPL_SIZE_LIMIT check
61           to ensure such an image does not overflow SRAM if SPL_SIZE_LIMIT
62           describes the size of SRAM available for SPL when pre-reloc malloc
63           pool is put into this SRAM, too.
64
65 config SPL_SIZE_LIMIT_PROVIDE_STACK
66         hex "SPL image size check: provide stack space before relocation"
67         depends on SPL_SIZE_LIMIT > 0
68         default 0
69         help
70           If set, this size is reserved in SPL_SIZE_LIMIT check to ensure such
71           an image does not overflow SRAM if SPL_SIZE_LIMIT describes the size
72           of SRAM available for SPL when the stack required before reolcation
73           uses this SRAM, too.
74
75 config SPL_SYS_STACK_F_CHECK_BYTE
76         hex
77         default 0xaa
78         help
79           Constant used to check the stack
80
81 config SPL_SYS_REPORT_STACK_F_USAGE
82         depends on SPL_SIZE_LIMIT_PROVIDE_STACK != 0
83         bool "Check and report stack usage in SPL before relocation"
84         help
85           If this option is enabled, the initial SPL stack is filled with 0xaa
86           very early, up to the size configured with
87           SPL_SIZE_LIMIT_PROVIDE_STACK.
88           Later when SPL is done using this initial stack and switches to a
89           stack in DRAM, the actually used size of this initial stack is
90           reported by examining the memory and searching for the lowest
91           occurrence of non 0xaa bytes.
92           This default implementation works for stacks growing down only.
93
94 config SPL_SHOW_ERRORS
95         bool "Show more information when something goes wrong"
96         help
97           This enabled more verbose error messages and checking when something
98           goes wrong in SPL. For example, it shows the error code when U-Boot
99           cannot be located. This can help to diagnose the problem and figure
100           out a fix, particularly during development.
101
102           This adds a small amount to SPL code size, perhaps 100 bytes.
103
104 config SPL_BINMAN_SYMBOLS
105         bool "Declare binman symbols in SPL"
106         depends on SPL_FRAMEWORK && BINMAN
107         default y
108         help
109           This enables use of symbols in SPL which refer to U-Boot, enabling SPL
110           to obtain the location of U-Boot simply by calling spl_get_image_pos()
111           and spl_get_image_size().
112
113           For this to work, you must have a U-Boot image in the binman image, so
114           binman can update SPL with the location of it.
115
116 menu "PowerPC and LayerScape SPL Boot options"
117
118 config SPL_NAND_BOOT
119         bool "Load SPL from NAND flash"
120         depends on PPC && (SUPPORT_SPL && !SPL_FRAMEWORK)
121
122 config SPL_MMC_BOOT
123         bool "Load SPL from SD Card / eMMC"
124         depends on PPC && (SUPPORT_SPL && !SPL_FRAMEWORK)
125
126 config SPL_SPI_BOOT
127         bool "Load SPL from SPI flash"
128         depends on PPC && (SUPPORT_SPL && !SPL_FRAMEWORK)
129
130 config SPL_FSL_PBL
131         bool "Create SPL in Freescale PBI format"
132         depends on (PPC || ARCH_LS1021A || ARCH_LS1043A || ARCH_LS1046A) && \
133                     SUPPORT_SPL
134         help
135           Create boot binary having SPL binary in PBI format concatenated with
136           u-boot binary.
137
138 endmenu
139
140 config HANDOFF
141         bool "Pass hand-off information from SPL to U-Boot proper"
142         depends on SPL && BLOBLIST
143         help
144           It is useful to be able to pass information from SPL to U-Boot
145           proper to preserve state that is known in SPL and is needed in U-Boot.
146           Enable this to locate the handoff information in U-Boot proper, early
147           in boot. It is available in gd->handoff. The state state is set up
148           in SPL (or TPL if that is being used).
149
150 if SPL
151
152 config SPL_HANDOFF
153         bool "Pass hand-off information from SPL to U-Boot proper"
154         depends on HANDOFF && SPL_BLOBLIST
155         default y
156         help
157           This option enables SPL to write handoff information. This can be
158           used to pass information like the size of SDRAM from SPL to U-Boot
159           proper. Also SPL can receive information from TPL in the same place
160           if that is enabled.
161
162 config SPL_LDSCRIPT
163         string "Linker script for the SPL stage"
164         default "arch/\$(ARCH)/cpu/u-boot-spl.lds"
165         help
166           The SPL stage will usually require a different linker-script
167           (as it runs from a different memory region) than the regular
168           U-Boot stage.  Set this to the path of the linker-script to
169           be used for SPL.
170
171 config SPL_TEXT_BASE
172         hex "SPL Text Base"
173         default ISW_ENTRY_ADDR if AM43XX || AM33XX || OMAP54XX || ARCH_KEYSTONE
174         default 0x10060 if MACH_SUN50I || MACH_SUN50I_H5 || MACH_SUN9I
175         default 0x20060 if SUN50I_GEN_H6
176         default 0x00060 if ARCH_SUNXI
177         default 0xfffc0000 if ARCH_ZYNQMP
178         default 0x0
179         help
180           The address in memory that SPL will be running from.
181
182 config SPL_BOARD_INIT
183         bool "Call board-specific initialization in SPL"
184         help
185           If this option is enabled, U-Boot will call the function
186           spl_board_init() from board_init_r(). This function should be
187           provided by the board.
188
189 config SPL_BOOTROM_SUPPORT
190         bool "Support returning to the BOOTROM"
191         help
192           Some platforms (e.g. the Rockchip RK3368) provide support in their
193           ROM for loading the next boot-stage after performing basic setup
194           from the SPL stage.
195
196           Enable this option, to return to the BOOTROM through the
197           BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
198           boot device list, if not implemented for a given board)
199
200 config SPL_BOOTCOUNT_LIMIT
201         bool "Support bootcount in SPL"
202         depends on SPL_ENV_SUPPORT && !TPL_BOOTCOUNT_LIMIT
203         help
204           On some boards, which use 'falcon' mode, it is necessary to check
205           and increment the number of boot attempts. Such boards do not
206           use proper U-Boot for normal boot flow and hence needs those
207           adjustments to be done in the SPL.
208
209 config SPL_RAW_IMAGE_SUPPORT
210         bool "Support SPL loading and booting of RAW images"
211         default n if (ARCH_MX6 && (SPL_MMC || SPL_SATA))
212         default y if !TI_SECURE_DEVICE
213         help
214           SPL will support loading and booting a RAW image when this option
215           is y. If this is not set, SPL will move on to other available
216           boot media to find a suitable image.
217
218 config SPL_LEGACY_IMAGE_SUPPORT
219         bool "Support SPL loading and booting of Legacy images"
220         default y if !TI_SECURE_DEVICE && !SPL_LOAD_FIT
221         help
222           SPL will support loading and booting Legacy images when this option
223           is y. If this is not set, SPL will move on to other available
224           boot media to find a suitable image.
225
226 config SPL_LEGACY_IMAGE_CRC_CHECK
227         bool "Check CRC of Legacy images"
228         depends on SPL_LEGACY_IMAGE_SUPPORT
229         select SPL_CRC32
230         help
231           Enable this to check the CRC of Legacy images. While this increases
232           reliability, it affects both code size and boot duration.
233           If disabled, Legacy images are booted if the image magic and size
234           are correct, without further integrity checks.
235
236 config SPL_SYS_MALLOC_SIMPLE
237         bool
238         prompt "Only use malloc_simple functions in the SPL"
239         help
240           Say Y here to only use the *_simple malloc functions from
241           malloc_simple.c, rather then using the versions from dlmalloc.c;
242           this will make the SPL binary smaller at the cost of more heap
243           usage as the *_simple malloc functions do not re-use free-ed mem.
244
245 config TPL_SYS_MALLOC_SIMPLE
246         bool
247         prompt "Only use malloc_simple functions in the TPL"
248         depends on TPL
249         help
250           Say Y here to only use the *_simple malloc functions from
251           malloc_simple.c, rather then using the versions from dlmalloc.c;
252           this will make the TPL binary smaller at the cost of more heap
253           usage as the *_simple malloc functions do not re-use free-ed mem.
254
255 config SPL_STACK_R
256         bool "Enable SDRAM location for SPL stack"
257         help
258           SPL starts off execution in SRAM and thus typically has only a small
259           stack available. Since SPL sets up DRAM while in its board_init_f()
260           function, it is possible for the stack to move there before
261           board_init_r() is reached. This option enables a special SDRAM
262           location for the SPL stack. U-Boot SPL switches to this after
263           board_init_f() completes, and before board_init_r() starts.
264
265 config SPL_STACK_R_ADDR
266         depends on SPL_STACK_R
267         hex "SDRAM location for SPL stack"
268         default 0x82000000 if ARCH_OMAP2PLUS
269         help
270           Specify the address in SDRAM for the SPL stack. This will be set up
271           before board_init_r() is called.
272
273 config SPL_STACK_R_MALLOC_SIMPLE_LEN
274         depends on SPL_STACK_R && SPL_SYS_MALLOC_SIMPLE
275         hex "Size of malloc_simple heap after switching to DRAM SPL stack"
276         default 0x100000
277         help
278           Specify the amount of the stack to use as memory pool for
279           malloc_simple after switching the stack to DRAM. This may be set
280           to give board_init_r() a larger heap then the initial heap in
281           SRAM which is limited to SYS_MALLOC_F_LEN bytes.
282
283 config SPL_SEPARATE_BSS
284         bool "BSS section is in a different memory region from text"
285         help
286           Some platforms need a large BSS region in SPL and can provide this
287           because RAM is already set up. In this case BSS can be moved to RAM.
288           This option should then be enabled so that the correct device tree
289           location is used. Normally we put the device tree at the end of BSS
290           but with this option enabled, it goes at _image_binary_end.
291
292 config SPL_READ_ONLY
293         bool
294         depends on SPL_OF_PLATDATA
295         # Bind cannot be supported because the udevice structs are in read-only
296         # memory so we cannot update the linked lists.
297         select SPL_OF_PLATDATA_NO_BIND
298         select SPL_OF_PLATDATA_RT
299         help
300           Some platforms (e.g. x86 Apollo Lake) load SPL into a read-only
301           section of memory. This means that of-platdata must make a copy (in
302           writeable memory) of anything it wants to modify, such as
303           device-private data.
304
305 config SPL_BANNER_PRINT
306         bool "Enable output of the SPL banner 'U-Boot SPL ...'"
307         default y
308         help
309           If this option is enabled, SPL will print the banner with version
310           info. Disabling this option could be useful to reduce SPL boot time
311           (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
312
313 config TPL_BANNER_PRINT
314         bool "Enable output of the TPL banner 'U-Boot TPL ...'"
315         depends on TPL
316         default y
317         help
318           If this option is enabled, TPL will print the banner with version
319           info. Disabling this option could be useful to reduce TPL boot time
320           (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
321
322 config SPL_EARLY_BSS
323         depends on ARM && !ARM64
324         bool "Allows initializing BSS early before entering board_init_f"
325         help
326           On some platform we have sufficient memory available early on to
327           allow setting up and using a basic BSS prior to entering
328           board_init_f. Activating this option will also de-activate the
329           clearing of BSS during the SPL relocation process, thus allowing
330           to carry state from board_init_f to board_init_r by way of BSS.
331
332 config SPL_DISPLAY_PRINT
333         bool "Display a board-specific message in SPL"
334         help
335           If this option is enabled, U-Boot will call the function
336           spl_display_print() immediately after displaying the SPL console
337           banner ("U-Boot SPL ..."). This function should be provided by
338           the board.
339
340 config SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
341         bool "MMC raw mode: by sector"
342         default y if ARCH_SUNXI || ARCH_DAVINCI || ARCH_UNIPHIER || \
343                      ARCH_MX6 || ARCH_MX7 || \
344                      ARCH_ROCKCHIP || ARCH_MVEBU ||  ARCH_SOCFPGA || \
345                      ARCH_AT91 || ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || \
346                      OMAP44XX || OMAP54XX || AM33XX || AM43XX || \
347                      TARGET_SIFIVE_UNLEASHED || TARGET_SIFIVE_UNMATCHED
348         help
349           Use sector number for specifying U-Boot location on MMC/SD in
350           raw mode.
351
352 config SYS_MMCSD_RAW_MODE_U_BOOT_SECTOR
353         hex "Address on the MMC to load U-Boot from"
354         depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
355         default 0x40 if ARCH_SUNXI
356         default 0x75 if ARCH_DAVINCI
357         default 0x8a if ARCH_MX6 || ARCH_MX7
358         default 0x100 if ARCH_UNIPHIER
359         default 0x0 if ARCH_MVEBU
360         default 0x200 if ARCH_SOCFPGA || ARCH_AT91
361         default 0x300 if ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || OMAP44XX || \
362                          OMAP54XX || AM33XX || AM43XX || ARCH_K3
363         default 0x4000 if ARCH_ROCKCHIP
364         default 0x822 if TARGET_SIFIVE_UNLEASHED || TARGET_SIFIVE_UNMATCHED
365         help
366           Address on the MMC to load U-Boot from, when the MMC is being used
367           in raw mode. Units: MMC sectors (1 sector = 512 bytes).
368
369 config SYS_MMCSD_RAW_MODE_U_BOOT_DATA_PART_OFFSET
370         hex "U-Boot main hardware partition image offset"
371         depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
372         default 0x10 if ARCH_SUNXI
373         default 0x0
374         help
375           On some platforms SPL location depends on hardware partition. The ROM
376           code skips the MBR sector when loading SPL from main hardware data
377           partition. This adds offset to the main U-Boot image. Set this symbol
378           to the number of skipped sectors.
379
380           If unsure, leave the default.
381
382 config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
383         bool "MMC Raw mode: by partition"
384         help
385           Use a partition for loading U-Boot when using MMC/SD in raw mode.
386
387 config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION
388         hex "Partition to use to load U-Boot from"
389         depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
390         default 1
391         help
392           Partition on the MMC to load U-Boot from when the MMC is being
393           used in raw mode
394
395 config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
396         bool "MMC raw mode: by partition type"
397         depends on DOS_PARTITION && SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
398         help
399           Use partition type for specifying U-Boot partition on MMC/SD in
400           raw mode. U-Boot will be loaded from the first partition of this
401           type to be found.
402
403 config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION_TYPE
404         hex "Partition Type on the MMC to load U-Boot from"
405         depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
406         help
407           Partition Type on the MMC to load U-Boot from, when the MMC is being
408           used in raw mode.
409
410 config SUPPORT_EMMC_BOOT_OVERRIDE_PART_CONFIG
411         bool "Override eMMC EXT_CSC_PART_CONFIG by user defined partition"
412         depends on SUPPORT_EMMC_BOOT
413         help
414           eMMC boot partition is normally configured by the bits of the EXT_CSD
415           register (EXT_CSC_PART_CONFIG), BOOT_PARTITION_ENABLE field. In some
416           cases it might be required in SPL to load the image from different
417           partition than the partition selected by EXT_CSC_PART_CONFIG register.
418           Enable this option if you intend to use an eMMC boot partition other
419           then selected via EXT_CSC_PART_CONFIG register and specify the custom
420           partition number by the CONFIG_SYS_MMCSD_RAW_MODE_EMMC_BOOT_PARTITION
421           option.
422
423 config SYS_MMCSD_RAW_MODE_EMMC_BOOT_PARTITION
424         int "Number of the eMMC boot partition to use"
425         depends on SUPPORT_EMMC_BOOT_OVERRIDE_PART_CONFIG
426         default 1
427         help
428           eMMC boot partition number to use when the eMMC in raw mode and
429           the eMMC EXT_CSC_PART_CONFIG selection should be overridden in SPL
430           by user defined partition number.
431
432 config SPL_CRC32
433         bool "Support CRC32"
434         default y if SPL_LEGACY_IMAGE_SUPPORT || SPL_EFI_PARTITION
435         default y if SPL_ENV_SUPPORT || TPL_BLOBLIST
436         help
437           Enable this to support CRC32 in uImages or FIT images within SPL.
438           This is a 32-bit checksum value that can be used to verify images.
439           For FIT images, this is the least secure type of checksum, suitable
440           for detected accidental image corruption. For secure applications you
441           should consider SHA1 or SHA256.
442
443 config SPL_MD5
444         bool "Support MD5"
445         depends on SPL_FIT
446         help
447           Enable this to support MD5 in FIT images within SPL. An MD5
448           checksum is a 128-bit hash value used to check that the image
449           contents have not been corrupted. Note that MD5 is not considered
450           secure as it is possible (with a brute-force attack) to adjust the
451           image while still retaining the same MD5 hash value. For secure
452           applications where images may be changed maliciously, you should
453           consider SHA256 or SHA384.
454
455 config SPL_FIT_IMAGE_TINY
456         bool "Remove functionality from SPL FIT loading to reduce size"
457         depends on SPL_FIT
458         default y if MACH_SUN50I || MACH_SUN50I_H5 || SUN50I_GEN_H6
459         default y if ARCH_IMX8M
460         help
461           Enable this to reduce the size of the FIT image loading code
462           in SPL, if space for the SPL binary is very tight.
463
464           This skips the recording of each loaded payload
465           (i.e. loadable) into the FDT (modifying the loaded FDT to
466           ensure this information is available to the next image
467           invoked).
468
469 config SPL_CACHE
470         bool "Support CACHE drivers"
471         help
472           Enable CACHE drivers in SPL. These drivers can keep data so that
473           future requests for that data can be served faster. Enable this option
474           to build the drivers in drivers/cache as part of an SPL build.
475
476 config SPL_CPU
477         bool "Support CPU drivers"
478         help
479           Enable this to support CPU drivers in SPL. These drivers can set
480           up CPUs and provide information about them such as the model and
481           name. This can be useful in SPL since setting up the CPUs earlier
482           may improve boot performance. Enable this option to build the
483           drivers in drivers/cpu as part of an SPL build.
484
485 config SPL_CRYPTO
486         bool "Support crypto drivers"
487         help
488           Enable crypto drivers in SPL. These drivers can be used to
489           accelerate secure boot processing in secure applications. Enable
490           this option to build the drivers in drivers/crypto as part of an
491           SPL build.
492
493 config SPL_DMA
494         bool "Support DMA drivers"
495         help
496           Enable DMA (direct-memory-access) drivers in SPL. These drivers
497           can be used to handle memory-to-peripheral data transfer without
498           the CPU moving the data. Enable this option to build the drivers
499           in drivers/dma as part of an SPL build.
500
501 config SPL_DRIVERS_MISC
502         bool "Support misc drivers"
503         help
504           Enable miscellaneous drivers in SPL. These drivers perform various
505           tasks that don't fall nicely into other categories, Enable this
506           option to build the drivers in drivers/misc as part of an SPL
507           build, for those that support building in SPL (not all drivers do).
508
509 config SPL_ENV_SUPPORT
510         bool "Support an environment"
511         help
512           Enable environment support in SPL. The U-Boot environment provides
513           a number of settings (essentially name/value pairs) which can
514           control many aspects of U-Boot's operation. Normally this is not
515           needed in SPL as it has a much simpler task with less
516           configuration. But some boards use this to support 'Falcon' boot
517           on EXT2 and FAT, where SPL boots directly into Linux without
518           starting U-Boot first. Enabling this option will make env_get()
519           and env_set() available in SPL.
520
521 config SPL_SAVEENV
522         bool "Support save environment"
523         depends on SPL_ENV_SUPPORT
524         select SPL_MMC_WRITE if ENV_IS_IN_MMC
525         help
526           Enable save environment support in SPL after setenv. By default
527           the saveenv option is not provided in SPL, but some boards need
528           this support in 'Falcon' boot, where SPL need to boot from
529           different images based on environment variable set by OS. For
530           example OS may set "reboot_image" environment variable to
531           "recovery" inorder to boot recovery image by SPL. The SPL read
532           "reboot_image" and act accordingly and change the reboot_image
533           to default mode using setenv and save the environment.
534
535 config SPL_ETH
536         bool "Support Ethernet"
537         depends on SPL_ENV_SUPPORT
538         depends on SPL_NET
539         help
540           Enable access to the network subsystem and associated Ethernet
541           drivers in SPL. This permits SPL to load U-Boot over an Ethernet
542           link rather than from an on-board peripheral. Environment support
543           is required since the network stack uses a number of environment
544           variables. See also SPL_NET.
545
546 config SPL_FS_EXT4
547         bool "Support EXT filesystems"
548         help
549           Enable support for EXT2/3/4 filesystems with SPL. This permits
550           U-Boot (or Linux in Falcon mode) to be loaded from an EXT
551           filesystem from within SPL. Support for the underlying block
552           device (e.g. MMC or USB) must be enabled separately.
553
554 config SPL_FS_SQUASHFS
555         bool "Support SquashFS filesystems"
556         select FS_SQUASHFS
557         help
558           Enable support for SquashFS filesystems with SPL. This permits
559           U-Boot (or Linux in Falcon mode) to be loaded from a SquashFS
560           filesystem from within SPL. Support for the underlying block
561           device (e.g. MMC or USB) must be enabled separately.
562
563 config SPL_FS_FAT
564         bool "Support FAT filesystems"
565         select FS_FAT
566         help
567           Enable support for FAT and VFAT filesystems with SPL. This
568           permits U-Boot (or Linux in Falcon mode) to be loaded from a FAT
569           filesystem from within SPL. Support for the underlying block
570           device (e.g. MMC or USB) must be enabled separately.
571
572 config SPL_FAT_WRITE
573         bool "Support write for FAT filesystems"
574         help
575           Enable write support for FAT and VFAT filesystems with SPL.
576           Support for the underlying block device (e.g. MMC or USB) must be
577           enabled separately.
578
579 config SPL_FPGA
580         bool "Support FPGAs"
581         help
582           Enable support for FPGAs in SPL. Field-programmable Gate Arrays
583           provide software-configurable hardware which is typically used to
584           implement peripherals (such as UARTs, LCD displays, MMC) or
585           accelerate custom processing functions, such as image processing
586           or machine learning. Sometimes it is useful to program the FPGA
587           as early as possible during boot, and this option can enable that
588           within SPL.
589
590 config SPL_GPIO
591         bool "Support GPIO in SPL"
592         help
593           Enable support for GPIOs (General-purpose Input/Output) in SPL.
594           GPIOs allow U-Boot to read the state of an input line (high or
595           low) and set the state of an output line. This can be used to
596           drive LEDs, control power to various system parts and read user
597           input. GPIOs can be useful in SPL to enable a 'sign-of-life' LED,
598           for example. Enable this option to build the drivers in
599           drivers/gpio as part of an SPL build.
600
601 config SPL_I2C
602         bool "Support I2C"
603         help
604           Enable support for the I2C (Inter-Integrated Circuit) bus in SPL.
605           I2C works with a clock and data line which can be driven by a
606           one or more masters or slaves. It is a fairly complex bus but is
607           widely used as it only needs two lines for communication. Speeds of
608           400kbps are typical but up to 3.4Mbps is supported by some
609           hardware. I2C can be useful in SPL to configure power management
610           ICs (PMICs) before raising the CPU clock speed, for example.
611           Enable this option to build the drivers in drivers/i2c as part of
612           an SPL build.
613
614 config SPL_LIBCOMMON_SUPPORT
615         bool "Support common libraries"
616         help
617           Enable support for common U-Boot libraries within SPL. These
618           libraries include common code to deal with U-Boot images,
619           environment and USB, for example. This option is enabled on many
620           boards. Enable this option to build the code in common/ as part of
621           an SPL build.
622
623 config SPL_LIBDISK_SUPPORT
624         bool "Support disk partitions"
625         select PARTITIONS
626         help
627           Enable support for disk partitions within SPL. 'Disk' is something
628           of a misnomer as it includes non-spinning media such as flash (as
629           used in MMC and USB sticks). Partitions provide a way for a disk
630           to be split up into separate regions, with a partition table placed
631           at the start or end which describes the location and size of each
632           'partition'. These partitions are typically uses as individual block
633           devices, typically with an EXT2 or FAT filesystem in each. This
634           option enables whatever partition support has been enabled in
635           U-Boot to also be used in SPL. It brings in the code in disk/.
636
637 config SPL_LIBGENERIC_SUPPORT
638         bool "Support generic libraries"
639         help
640           Enable support for generic U-Boot libraries within SPL. These
641           libraries include generic code to deal with device tree, hashing,
642           printf(), compression and the like. This option is enabled on many
643           boards. Enable this option to build the code in lib/ as part of an
644           SPL build.
645
646 config SPL_DM_MAILBOX
647         bool "Support Mailbox"
648         help
649           Enable support for Mailbox within SPL. This enable the inter
650           processor communication protocols tobe used within SPL. Enable
651           this option to build the drivers in drivers/mailbox as part of
652           SPL build.
653
654 config SPL_MMC
655         bool "Support MMC"
656         depends on MMC
657         select HAVE_BLOCK_DEVICE
658         help
659           Enable support for MMC (Multimedia Card) within SPL. This enables
660           the MMC protocol implementation and allows any enabled drivers to
661           be used within SPL. MMC can be used with or without disk partition
662           support depending on the application (SPL_LIBDISK_SUPPORT). Enable
663           this option to build the drivers in drivers/mmc as part of an SPL
664           build.
665
666 config SYS_MMCSD_FS_BOOT_PARTITION
667         int "MMC Boot Partition"
668         default 1
669         help
670           Partition on the MMC to load U-Boot from when the MMC is being
671           used in fs mode
672
673 config SPL_MMC_TINY
674         bool "Tiny MMC framework in SPL"
675         depends on SPL_MMC
676         help
677           Enable MMC framework tinification support. This option is useful if
678           if your SPL is extremely size constrained. Heed the warning, enable
679           this option if and only if you know exactly what you are doing, if
680           you are reading this help text, you most likely have no idea :-)
681
682           The MMC framework is reduced to bare minimum to be useful. No malloc
683           support is needed for the MMC framework operation with this option
684           enabled. The framework supports exactly one MMC device and exactly
685           one MMC driver. The MMC driver can be adjusted to avoid any malloc
686           operations too, which can remove the need for malloc support in SPL
687           and thus further reduce footprint.
688
689 config SPL_MMC_WRITE
690         bool "MMC/SD/SDIO card support for write operations in SPL"
691         depends on SPL_MMC
692         help
693           Enable write access to MMC and SD Cards in SPL
694
695
696 config SPL_MPC8XXX_INIT_DDR
697         bool "Support MPC8XXX DDR init"
698         help
699           Enable support for DDR-SDRAM (double-data-rate synchronous dynamic
700           random-access memory) on the MPC8XXX family within SPL. This
701           allows DRAM to be set up before loading U-Boot into that DRAM,
702           where it can run.
703
704 config SPL_MTD_SUPPORT
705         bool "Support MTD drivers"
706         help
707           Enable support for MTD (Memory Technology Device) within SPL. MTD
708           provides a block interface over raw NAND and can also be used with
709           SPI flash. This allows SPL to load U-Boot from supported MTD
710           devices. See SPL_NAND_SUPPORT and SPL_ONENAND_SUPPORT for how
711           to enable specific MTD drivers.
712
713 config SPL_MUSB_NEW
714         bool "Support new Mentor Graphics USB"
715         help
716           Enable support for Mentor Graphics USB in SPL. This is a new
717           driver used by some boards. Enable this option to build
718           the drivers in drivers/usb/musb-new as part of an SPL build. The
719           old drivers are in drivers/usb/musb.
720
721 config SPL_NAND_SUPPORT
722         bool "Support NAND flash"
723         help
724           Enable support for NAND (Negative AND) flash in SPL. NAND flash
725           can be used to allow SPL to load U-Boot from supported devices.
726           This enables the drivers in drivers/mtd/nand/raw as part of an SPL
727           build.
728
729 config SPL_NAND_DRIVERS
730         bool "Use standard NAND driver"
731         help
732           SPL uses normal NAND drivers, not minimal drivers.
733
734 config SPL_NAND_ECC
735         bool "Include standard software ECC in the SPL"
736
737 config SPL_NAND_SIMPLE
738         bool "Support simple NAND drivers in SPL"
739         help
740           Support for NAND boot using simple NAND drivers that
741           expose the cmd_ctrl() interface.
742
743 config SPL_NAND_BASE
744         depends on SPL_NAND_DRIVERS
745         bool "Use Base NAND Driver"
746         help
747           Include nand_base.c in the SPL.
748
749 config SPL_NAND_IDENT
750         depends on SPL_NAND_BASE
751         bool "Use chip ID to identify NAND flash"
752         help
753           SPL uses the chip ID list to identify the NAND flash.
754
755 config SPL_UBI
756         bool "Support UBI"
757         help
758           Enable support for loading payloads from UBI. See
759           README.ubispl for more info.
760
761 if SPL_DM
762 config SPL_DM_SPI
763         bool "Support SPI DM drivers in SPL"
764         help
765           Enable support for SPI DM drivers in SPL.
766
767 config SPL_DM_SPI_FLASH
768         bool "Support SPI DM FLASH drivers in SPL"
769         help
770           Enable support for SPI DM flash drivers in SPL.
771
772 endif
773 if SPL_UBI
774 config SPL_UBI_LOAD_BY_VOLNAME
775         bool "Support loading volumes by name"
776         help
777           This enables support for loading UBI volumes by name. When this
778           is set, CONFIG_SPL_UBI_LOAD_MONITOR_VOLNAME can be used to
779           configure the volume name from which to load U-Boot.
780
781 config SPL_UBI_MAX_VOL_LEBS
782         int "Maximum number of LEBs per volume"
783         depends on SPL_UBI
784         help
785           The maximum number of logical eraseblocks which a static volume
786           to load can contain. Used for sizing the scan data structure.
787
788 config SPL_UBI_MAX_PEB_SIZE
789         int "Maximum PEB size"
790         depends on SPL_UBI
791         help
792           The maximum physical erase block size.
793
794 config SPL_UBI_MAX_PEBS
795         int "Maximum number of PEBs"
796         depends on SPL_UBI
797         help
798           The maximum physical erase block size. If not overridden by
799           board code, this value will be used as the actual number of PEBs.
800
801 config SPL_UBI_PEB_OFFSET
802         int "Offset to first UBI PEB"
803         depends on SPL_UBI
804         help
805           The offset in number of PEBs from the start of flash to the first
806           PEB part of the UBI image.
807
808 config SPL_UBI_VID_OFFSET
809         int "Offset to VID header"
810         depends on SPL_UBI
811
812 config SPL_UBI_LEB_START
813         int "Offset to LEB in PEB"
814         depends on SPL_UBI
815         help
816           The offset in bytes to the LEB within a PEB.
817
818 config SPL_UBI_INFO_ADDR
819         hex "Address to place UBI scan info"
820         depends on SPL_UBI
821         help
822           Address for ubispl to place the scan info. Read README.ubispl to
823           determine the required size
824
825 config SPL_UBI_VOL_IDS
826         int "Maximum volume id"
827         depends on SPL_UBI
828         help
829           The maximum volume id which can be loaded. Used for sizing the
830           scan data structure.
831
832 config SPL_UBI_LOAD_MONITOR_ID
833         int "id of U-Boot volume"
834         depends on SPL_UBI
835         help
836           The UBI volume id from which to load U-Boot
837
838 config SPL_UBI_LOAD_MONITOR_VOLNAME
839         string "volume name of U-Boot volume"
840         depends on SPL_UBI_LOAD_BY_VOLNAME
841         help
842           The UBI volume name from which to load U-Boot
843
844 config SPL_UBI_LOAD_KERNEL_ID
845         int "id of kernel volume"
846         depends on SPL_OS_BOOT && SPL_UBI
847         help
848           The UBI volume id from which to load the kernel
849
850 config SPL_UBI_LOAD_ARGS_ID
851         int "id of kernel args volume"
852         depends on SPL_OS_BOOT && SPL_UBI
853         help
854           The UBI volume id from which to load the device tree
855
856 config UBI_SPL_SILENCE_MSG
857         bool "silence UBI SPL messages"
858         help
859           Disable messages from UBI SPL. This leaves warnings
860           and errors enabled.
861
862 endif   # if SPL_UBI
863
864 config SPL_NET
865         bool "Support networking"
866         help
867           Enable support for network devices (such as Ethernet) in SPL.
868           This permits SPL to load U-Boot over a network link rather than
869           from an on-board peripheral. Environment support is required since
870           the network stack uses a number of environment variables. See also
871           SPL_ETH.
872
873 if SPL_NET
874 config SPL_NET_VCI_STRING
875         string "BOOTP Vendor Class Identifier string sent by SPL"
876         help
877           As defined by RFC 2132 the vendor class identifier field can be
878           sent by the client to identify the vendor type and configuration
879           of a client.  This is often used in practice to allow for the DHCP
880           server to specify different files to load depending on if the ROM,
881           SPL or U-Boot itself makes the request
882 endif   # if SPL_NET
883
884 config SPL_NO_CPU_SUPPORT
885         bool "Drop CPU code in SPL"
886         help
887           This is specific to the ARM926EJ-S CPU. It disables the standard
888           start.S start-up code, presumably so that a replacement can be
889           used on that CPU. You should not enable it unless you know what
890           you are doing.
891
892 config SPL_NOR_SUPPORT
893         bool "Support NOR flash"
894         help
895           Enable support for loading U-Boot from memory-mapped NOR (Negative
896           OR) flash in SPL. NOR flash is slow to write but fast to read, and
897           a memory-mapped device makes it very easy to access. Loading from
898           NOR is typically achieved with just a memcpy().
899
900 config SPL_XIP_SUPPORT
901         bool "Support XIP"
902         depends on SPL
903         help
904           Enable support for execute in place of U-Boot or kernel image. There
905           is no need to copy image from flash to ram if flash supports execute
906           in place. Its very useful in systems having enough flash but not
907           enough ram to load the image.
908
909 config SPL_ONENAND_SUPPORT
910         bool "Support OneNAND flash"
911         help
912           Enable support for OneNAND (Negative AND) flash in SPL. OneNAND is
913           a type of NAND flash and therefore can be used to allow SPL to
914           load U-Boot from supported devices. This enables the drivers in
915           drivers/mtd/onenand as part of an SPL build.
916
917 config SPL_OS_BOOT
918         bool "Activate Falcon Mode"
919         depends on !TI_SECURE_DEVICE
920         help
921           Enable booting directly to an OS from SPL.
922           for more info read doc/README.falcon
923
924 if SPL_OS_BOOT
925 config SYS_OS_BASE
926         hex "addr, where OS is found"
927         depends on SPL_NOR_SUPPORT
928         help
929           Specify the address, where the OS image is found, which
930           gets booted.
931
932 endif # SPL_OS_BOOT
933
934 config SPL_FALCON_BOOT_MMCSD
935         bool "Enable Falcon boot from MMC or SD media"
936         depends on SPL_OS_BOOT && SPL_MMC
937         help
938           Select this if the Falcon mode OS image mode is on MMC or SD media.
939
940 config SYS_MMCSD_RAW_MODE_KERNEL_SECTOR
941         hex "Falcon mode: Sector to load kernel uImage from MMC"
942         depends on SPL_FALCON_BOOT_MMCSD
943         help
944           When Falcon mode is used with an MMC or SD media, SPL needs to know
945           where to look for the kernel uImage. The image is expected to begin
946           at the raw MMC specified in this config.
947           Note that the Falcon mode image can also be a FIT, if FIT support is
948           enabled.
949
950 config SPL_PAYLOAD
951         string "SPL payload"
952         default "tpl/u-boot-with-tpl.bin" if TPL
953         default "u-boot.bin"
954         help
955           Payload for SPL boot. For backward compatibility, default to
956           u-boot.bin, i.e. RAW image without any header. In case of
957           TPL, tpl/u-boot-with-tpl.bin. For new boards, suggest to
958           use u-boot.img.
959
960 config SPL_PCI
961         bool "Support PCI drivers"
962         help
963           Enable support for PCI in SPL. For platforms that need PCI to boot,
964           or must perform some init using PCI in SPL, this provides the
965           necessary driver support. This enables the drivers in drivers/pci
966           as part of an SPL build.
967
968 config SPL_PCH
969         bool "Support PCH drivers"
970         help
971           Enable support for PCH (Platform Controller Hub) devices in SPL.
972           These are used to set up GPIOs and the SPI peripheral early in
973           boot. This enables the drivers in drivers/pch as part of an SPL
974           build.
975
976 config SPL_POST_MEM_SUPPORT
977         bool "Support POST drivers"
978         help
979           Enable support for POST (Power-on Self Test) in SPL. POST is a
980           procedure that checks that the hardware (CPU or board) appears to
981           be functionally correctly. It is a sanity check that can be
982           performed before booting. This enables the drivers in post/drivers
983           as part of an SPL build.
984
985 config SPL_DM_RESET
986         bool "Support reset drivers"
987         depends on SPL
988         help
989           Enable support for reset control in SPL.
990           That can be useful in SPL to handle IP reset in driver, as in U-Boot,
991           by using the generic reset API provided by driver model.
992           This enables the drivers in drivers/reset as part of an SPL build.
993
994 config SPL_POWER
995         bool "Support power drivers"
996         help
997           Enable support for power control in SPL. This includes support
998           for PMICs (Power-management Integrated Circuits) and some of the
999           features provided by PMICs. In particular, voltage regulators can
1000           be used to enable/disable power and vary its voltage. That can be
1001           useful in SPL to turn on boot peripherals and adjust CPU voltage
1002           so that the clock speed can be increased. This enables the drivers
1003           in drivers/power, drivers/power/pmic and drivers/power/regulator
1004           as part of an SPL build.
1005
1006 config SPL_POWER_DOMAIN
1007         bool "Support power domain drivers"
1008         select SPL_POWER
1009         help
1010           Enable support for power domain control in SPL. Many SoCs allow
1011           power to be applied to or removed from portions of the SoC (power
1012           domains). This may be used to save power. This API provides the
1013           means to control such power management hardware. This enables
1014           the drivers in drivers/power/domain as part of a SPL build.
1015
1016 config SPL_RAM_SUPPORT
1017         bool "Support booting from RAM"
1018         default y if MICROBLAZE || ARCH_SOCFPGA || ARCH_TEGRA || ARCH_ZYNQ
1019         help
1020           Enable booting of an image in RAM. The image can be preloaded or
1021           it can be loaded by SPL directly into RAM (e.g. using USB).
1022
1023 config SPL_RAM_DEVICE
1024         bool "Support booting from preloaded image in RAM"
1025         depends on SPL_RAM_SUPPORT
1026         default y if MICROBLAZE || ARCH_SOCFPGA || ARCH_TEGRA || ARCH_ZYNQ
1027         help
1028           Enable booting of an image already loaded in RAM. The image has to
1029           be already in memory when SPL takes over, e.g. loaded by the boot
1030           ROM.
1031
1032 config SPL_REMOTEPROC
1033         bool "Support REMOTEPROCS"
1034         help
1035           Enable support for REMOTEPROCs in SPL. This permits to load
1036           a remote processor firmware in SPL.
1037
1038 config SPL_RTC
1039         bool "Support RTC drivers"
1040         help
1041           Enable RTC (Real-time Clock) support in SPL. This includes support
1042           for reading and setting the time. Some RTC devices also have some
1043           non-volatile (battery-backed) memory which is accessible if
1044           needed. This enables the drivers in drivers/rtc as part of an SPL
1045           build.
1046
1047 config SPL_SATA
1048         bool "Support loading from SATA"
1049         help
1050           Enable support for SATA (Serial AT attachment) in SPL. This allows
1051           use of SATA devices such as hard drives and flash drivers for
1052           loading U-Boot. SATA is used in higher-end embedded systems and
1053           can provide higher performance than MMC , at somewhat higher
1054           expense and power consumption. This enables loading from SATA
1055           using a configured device.
1056
1057 config SPL_SATA_RAW_U_BOOT_USE_SECTOR
1058         bool "SATA raw mode: by sector"
1059         depends on SPL_SATA
1060         default y if ARCH_MVEBU
1061         help
1062           Use sector number for specifying U-Boot location on SATA disk in
1063           raw mode.
1064
1065 config SPL_SATA_RAW_U_BOOT_SECTOR
1066         hex "Sector on the SATA disk to load U-Boot from"
1067         depends on SPL_SATA_RAW_U_BOOT_USE_SECTOR
1068         default 0x1 if ARCH_MVEBU
1069         help
1070           Sector on the SATA disk to load U-Boot from, when the SATA disk is being
1071           used in raw mode. Units: SATA disk sectors (1 sector = 512 bytes).
1072
1073 config SPL_SERIAL
1074         bool "Support serial"
1075         select SPL_PRINTF
1076         select SPL_STRTO
1077         help
1078           Enable support for serial in SPL. This allows use of a serial UART
1079           for displaying messages while SPL is running. It also brings in
1080           printf() and panic() functions. This should normally be enabled
1081           unless there are space reasons not to. Even then, consider
1082           enabling SPL_USE_TINY_PRINTF which is a small printf() version.
1083
1084 config SPL_SPI
1085         bool "Support SPI drivers"
1086         help
1087           Enable support for using SPI in SPL. This is used for connecting
1088           to SPI flash for loading U-Boot. See SPL_SPI_FLASH_SUPPORT for
1089           more details on that. The SPI driver provides the transport for
1090           data between the SPI flash and the CPU. This option can be used to
1091           enable SPI drivers that are needed for other purposes also, such
1092           as a SPI PMIC.
1093
1094 config SPL_SPI_FLASH_SUPPORT
1095         bool "Support SPI flash drivers"
1096         depends on SPL_SPI
1097         help
1098           Enable support for using SPI flash in SPL, and loading U-Boot from
1099           SPI flash. SPI flash (Serial Peripheral Bus flash) is named after
1100           the SPI bus that is used to connect it to a system. It is a simple
1101           but fast bidirectional 4-wire bus (clock, chip select and two data
1102           lines). This enables the drivers in drivers/mtd/spi as part of an
1103           SPL build. This normally requires SPL_SPI.
1104
1105 if SPL_SPI_FLASH_SUPPORT
1106
1107 config SPL_SPI_FLASH_TINY
1108         bool "Enable low footprint SPL SPI Flash support"
1109         depends on !SPI_FLASH_BAR
1110         default y if SPI_FLASH
1111         help
1112          Enable lightweight SPL SPI Flash support that supports just reading
1113          data/images from flash. No support to write/erase flash. Enable
1114          this if you have SPL size limitations and don't need full
1115          fledged SPI flash support.
1116
1117 config SPL_SPI_FLASH_SFDP_SUPPORT
1118         bool "SFDP table parsing support for SPI NOR flashes"
1119         depends on !SPI_FLASH_BAR && !SPL_SPI_FLASH_TINY
1120         help
1121          Enable support for parsing and auto discovery of parameters for
1122          SPI NOR flashes using Serial Flash Discoverable Parameters (SFDP)
1123          tables as per JESD216 standard in SPL.
1124
1125 config SPL_SPI_FLASH_MTD
1126         bool "Support for SPI flash MTD drivers in SPL"
1127         help
1128           Enable support for SPI flash MTD drivers in SPL.
1129
1130 config SPL_SPI_LOAD
1131         bool "Support loading from SPI flash"
1132         help
1133           Enable support for loading next stage, U-Boot or otherwise, from
1134           SPI NOR in U-Boot SPL.
1135
1136 endif # SPL_SPI_FLASH_SUPPORT
1137
1138 config SYS_SPI_U_BOOT_OFFS
1139         hex "address of u-boot payload in SPI flash"
1140         default 0x8000 if ARCH_SUNXI
1141         default 0x0
1142         depends on SPL_SPI_LOAD || SPL_SPI_SUNXI
1143         help
1144          Address within SPI-Flash from where the u-boot payload is fetched
1145          from.
1146
1147 config SPL_THERMAL
1148         bool "Driver support for thermal devices"
1149         help
1150           Enable support for temperature-sensing devices. Some SoCs have on-chip
1151           temperature sensors to permit warnings, speed throttling or even
1152           automatic power-off when the temperature gets too high or low. Other
1153           devices may be discrete but connected on a suitable bus.
1154
1155 config SPL_USB_HOST
1156         bool "Support USB host drivers"
1157         select HAVE_BLOCK_DEVICE
1158         help
1159           Enable access to USB (Universal Serial Bus) host devices so that
1160           SPL can load U-Boot from a connected USB peripheral, such as a USB
1161           flash stick. While USB takes a little longer to start up than most
1162           buses, it is very flexible since many different types of storage
1163           device can be attached. This option enables the drivers in
1164           drivers/usb/host as part of an SPL build.
1165
1166 config SPL_USB_STORAGE
1167         bool "Support loading from USB"
1168         depends on SPL_USB_HOST && !(BLK && !DM_USB)
1169         help
1170           Enable support for USB devices in SPL. This allows use of USB
1171           devices such as hard drives and flash drivers for loading U-Boot.
1172           The actual drivers are enabled separately using the normal U-Boot
1173           config options. This enables loading from USB using a configured
1174           device.
1175
1176 config SPL_USB_GADGET
1177         bool "Suppport USB Gadget drivers"
1178         help
1179           Enable USB Gadget API which allows to enable USB device functions
1180           in SPL.
1181
1182 if SPL_USB_GADGET
1183
1184 config SPL_USB_ETHER
1185         bool "Support USB Ethernet drivers"
1186         depends on SPL_NET
1187         help
1188           Enable access to the USB network subsystem and associated
1189           drivers in SPL. This permits SPL to load U-Boot over a
1190           USB-connected Ethernet link (such as a USB Ethernet dongle) rather
1191           than from an onboard peripheral. Environment support is required
1192           since the network stack uses a number of environment variables.
1193           See also SPL_NET and SPL_ETH.
1194
1195 config SPL_DFU
1196         bool "Support DFU (Device Firmware Upgrade)"
1197         select SPL_HASH
1198         select SPL_DFU_NO_RESET
1199         depends on SPL_RAM_SUPPORT
1200         help
1201           This feature enables the DFU (Device Firmware Upgrade) in SPL with
1202           RAM memory device support. The ROM code will load and execute
1203           the SPL built with dfu. The user can load binaries (u-boot/kernel) to
1204           selected device partition from host-pc using dfu-utils.
1205           This feature is useful to flash the binaries to factory or bare-metal
1206           boards using USB interface.
1207
1208 choice
1209         bool "DFU device selection"
1210         depends on SPL_DFU
1211
1212 config SPL_DFU_RAM
1213         bool "RAM device"
1214         depends on SPL_DFU && SPL_RAM_SUPPORT
1215         help
1216          select RAM/DDR memory device for loading binary images
1217          (u-boot/kernel) to the selected device partition using
1218          DFU and execute the u-boot/kernel from RAM.
1219
1220 endchoice
1221
1222 config SPL_USB_SDP_SUPPORT
1223         bool "Support SDP (Serial Download Protocol)"
1224         depends on SPL_SERIAL
1225         help
1226           Enable Serial Download Protocol (SDP) device support in SPL. This
1227           allows to download images into memory and execute (jump to) them
1228           using the same protocol as implemented by the i.MX family's boot ROM.
1229
1230 config SPL_SDP_USB_DEV
1231         int "SDP USB controller index"
1232         default 0
1233         depends on SPL_USB_SDP_SUPPORT
1234         help
1235           Some boards have USB controller other than 0. Define this option
1236           so it can be used in compiled environment.
1237 endif
1238
1239 config SPL_WATCHDOG
1240         bool "Support watchdog drivers"
1241         imply SPL_WDT if !HW_WATCHDOG
1242         help
1243           Enable support for watchdog drivers in SPL. A watchdog is
1244           typically a hardware peripheral which can reset the system when it
1245           detects no activity for a while (such as a software crash). This
1246           enables the drivers in drivers/watchdog as part of an SPL build.
1247
1248 config SPL_YMODEM_SUPPORT
1249         bool "Support loading using Ymodem"
1250         depends on SPL_SERIAL
1251         help
1252           While loading from serial is slow it can be a useful backup when
1253           there is no other option. The Ymodem protocol provides a reliable
1254           means of transmitting U-Boot over a serial line for using in SPL,
1255           with a checksum to ensure correctness.
1256
1257 config SPL_ATF
1258         bool "Support ARM Trusted Firmware"
1259         depends on ARM64 && SPL_FIT
1260         help
1261           ATF(ARM Trusted Firmware) is a component for ARM AArch64 which
1262           is loaded by SPL (which is considered as BL2 in ATF terminology).
1263           More detail at: https://github.com/ARM-software/arm-trusted-firmware
1264
1265 config SPL_ATF_LOAD_IMAGE_V2
1266         bool "Use the new LOAD_IMAGE_V2 parameter passing"
1267         depends on SPL_ATF
1268         help
1269           Some platforms use the newer LOAD_IMAGE_V2 parameter passing.
1270
1271           If you want to load a bl31 image from the SPL and need the new
1272           method, say Y.
1273
1274 config SPL_ATF_NO_PLATFORM_PARAM
1275         bool "Pass no platform parameter"
1276         depends on SPL_ATF
1277         help
1278           While we expect to call a pointer to a valid FDT (or NULL)
1279           as the platform parameter to an ATF, some ATF versions are
1280           not U-Boot aware and have an insufficiently robust parameter
1281           validation to gracefully reject a FDT being passed.
1282
1283           If this option is enabled, the spl_atf os-type handler will
1284           always pass NULL for the platform parameter.
1285
1286           If your ATF is affected, say Y.
1287
1288 config SPL_AM33XX_ENABLE_RTC32K_OSC
1289         bool "Enable the RTC32K OSC on AM33xx based platforms"
1290         default y if AM33XX
1291         help
1292           Enable access to the AM33xx RTC and select the external 32kHz clock
1293           source.
1294
1295 config SPL_OPTEE_IMAGE
1296         bool "Support OP-TEE Trusted OS image in SPL"
1297         depends on ARM
1298         help
1299           OP-TEE is an open source Trusted OS which is loaded by SPL.
1300           More detail at: https://github.com/OP-TEE/optee_os
1301
1302 config SPL_OPENSBI
1303         bool "Support RISC-V OpenSBI"
1304         depends on RISCV && SPL_RISCV_MMODE && RISCV_SMODE
1305         help
1306           OpenSBI is an open-source implementation of the RISC-V Supervisor Binary
1307           Interface (SBI) specification. U-Boot supports the OpenSBI FW_DYNAMIC
1308           firmware. It is loaded and started by U-Boot SPL.
1309
1310           More details are available at https://github.com/riscv/opensbi and
1311           https://github.com/riscv/riscv-sbi-doc
1312
1313 config SPL_OPENSBI_LOAD_ADDR
1314         hex "OpenSBI load address"
1315         depends on SPL_OPENSBI
1316         help
1317           Load address of the OpenSBI binary.
1318
1319 config TPL
1320         bool
1321         depends on SUPPORT_TPL
1322         prompt "Enable TPL"
1323         help
1324           If you want to build TPL as well as the normal image and SPL, say Y.
1325
1326 if TPL
1327
1328 config TPL_SIZE_LIMIT
1329         hex "Maximum size of TPL image"
1330         depends on TPL
1331         default 0x0
1332         help
1333           Specifies the maximum length of the U-Boot TPL image.
1334           If this value is zero, it is ignored.
1335
1336 config TPL_BINMAN_SYMBOLS
1337         bool "Declare binman symbols in SPL"
1338         depends on SPL_FRAMEWORK && BINMAN
1339         default y
1340         help
1341           This enables use of symbols in TPL which refer to U-Boot, enabling SPL
1342           to obtain the location of U-Boot simply by calling spl_get_image_pos()
1343           and spl_get_image_size().
1344
1345           For this to work, you must have a U-Boot image in the binman image, so
1346           binman can update SPL with the location of it.
1347
1348 config TPL_FRAMEWORK
1349         bool "Support TPL based upon the common SPL framework"
1350         default y if SPL_FRAMEWORK
1351         help
1352           Enable the SPL framework under common/spl/ for TPL builds.
1353           This framework supports MMC, NAND and YMODEM and other methods
1354           loading of U-Boot's SPL stage. If unsure, say Y.
1355
1356 config TPL_HANDOFF
1357         bool "Pass hand-off information from TPL to SPL and U-Boot proper"
1358         depends on HANDOFF && TPL_BLOBLIST
1359         default y
1360         help
1361           This option enables TPL to write handoff information. This can be
1362           used to pass information like the size of SDRAM from TPL to U-Boot
1363           proper. The information is also available to SPL if it is useful
1364           there.
1365
1366 config TPL_BOARD_INIT
1367         bool "Call board-specific initialization in TPL"
1368         help
1369           If this option is enabled, U-Boot will call the function
1370           spl_board_init() from board_init_r(). This function should be
1371           provided by the board.
1372
1373 config TPL_BOOTCOUNT_LIMIT
1374         bool "Support bootcount in TPL"
1375         depends on TPL_ENV_SUPPORT
1376         help
1377           If this option is enabled, the TPL will support bootcount.
1378           For example, it may be useful to choose the device to boot.
1379
1380 config TPL_LDSCRIPT
1381         string "Linker script for the TPL stage"
1382         depends on TPL
1383         default "arch/arm/cpu/armv8/u-boot-spl.lds" if ARM64
1384         default "arch/\$(ARCH)/cpu/u-boot-spl.lds"
1385         help
1386           The TPL stage will usually require a different linker-script
1387           (as it runs from a different memory region) than the regular
1388           U-Boot stage.  Set this to the path of the linker-script to
1389           be used for TPL.
1390
1391           May be left empty to trigger the Makefile infrastructure to
1392           fall back to the linker-script used for the SPL stage.
1393
1394 config TPL_NEEDS_SEPARATE_STACK
1395         bool "TPL needs a separate initial stack-pointer"
1396         depends on TPL
1397         help
1398           Enable, if the TPL stage should not inherit its initial
1399           stack-pointer from the settings for the SPL stage.
1400
1401 config TPL_POWER
1402         bool "Support power drivers"
1403         help
1404           Enable support for power control in TPL. This includes support
1405           for PMICs (Power-management Integrated Circuits) and some of the
1406           features provided by PMICs. In particular, voltage regulators can
1407           be used to enable/disable power and vary its voltage. That can be
1408           useful in TPL to turn on boot peripherals and adjust CPU voltage
1409           so that the clock speed can be increased. This enables the drivers
1410           in drivers/power, drivers/power/pmic and drivers/power/regulator
1411           as part of an TPL build.
1412
1413 config TPL_TEXT_BASE
1414         hex "Base address for the .text section of the TPL stage"
1415         help
1416           The base address for the .text section of the TPL stage.
1417
1418 config TPL_MAX_SIZE
1419         int "Maximum size (in bytes) for the TPL stage"
1420         default 0
1421         depends on TPL
1422         help
1423           The maximum size (in bytes) of the TPL stage.
1424
1425 config TPL_STACK
1426         hex "Address of the initial stack-pointer for the TPL stage"
1427         depends on TPL_NEEDS_SEPARATE_STACK
1428         help
1429           The address of the initial stack-pointer for the TPL stage.
1430           Usually this will be the (aligned) top-of-stack.
1431
1432 config TPL_READ_ONLY
1433         bool
1434         depends on TPL_OF_PLATDATA
1435         select TPL_OF_PLATDATA_NO_BIND
1436         select TPL_OF_PLATDATA_RT
1437         help
1438           Some platforms (e.g. x86 Apollo Lake) load SPL into a read-only
1439           section of memory. This means that of-platdata must make a copy (in
1440           writeable memory) of anything it wants to modify, such as
1441           device-private data.
1442
1443 config TPL_BOOTROM_SUPPORT
1444         bool "Support returning to the BOOTROM (from TPL)"
1445         help
1446           Some platforms (e.g. the Rockchip RK3368) provide support in their
1447           ROM for loading the next boot-stage after performing basic setup
1448           from the TPL stage.
1449
1450           Enable this option, to return to the BOOTROM through the
1451           BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
1452           boot device list, if not implemented for a given board)
1453
1454 config TPL_CRC32
1455         bool "Support CRC32 in TPL"
1456         default y if TPL_ENV_SUPPORT || TPL_BLOBLIST
1457         help
1458           Enable this to support CRC32 in uImages or FIT images within SPL.
1459           This is a 32-bit checksum value that can be used to verify images.
1460           For FIT images, this is the least secure type of checksum, suitable
1461           for detected accidental image corruption. For secure applications you
1462           should consider SHA1 or SHA256.
1463
1464 config TPL_DRIVERS_MISC
1465         bool "Support misc drivers in TPL"
1466         help
1467           Enable miscellaneous drivers in TPL. These drivers perform various
1468           tasks that don't fall nicely into other categories, Enable this
1469           option to build the drivers in drivers/misc as part of an TPL
1470           build, for those that support building in TPL (not all drivers do).
1471
1472 config TPL_ENV_SUPPORT
1473         bool "Support an environment"
1474         help
1475           Enable environment support in TPL. See SPL_ENV_SUPPORT for details.
1476
1477 config TPL_GPIO
1478         bool "Support GPIO in TPL"
1479         help
1480           Enable support for GPIOs (General-purpose Input/Output) in TPL.
1481           GPIOs allow U-Boot to read the state of an input line (high or
1482           low) and set the state of an output line. This can be used to
1483           drive LEDs, control power to various system parts and read user
1484           input. GPIOs can be useful in TPL to enable a 'sign-of-life' LED,
1485           for example. Enable this option to build the drivers in
1486           drivers/gpio as part of an TPL build.
1487
1488 config TPL_I2C
1489         bool "Support I2C"
1490         help
1491           Enable support for the I2C bus in TPL. See SPL_I2C for
1492           details.
1493
1494 config TPL_LIBCOMMON_SUPPORT
1495         bool "Support common libraries"
1496         help
1497           Enable support for common U-Boot libraries within TPL. See
1498           SPL_LIBCOMMON_SUPPORT for details.
1499
1500 config TPL_LIBGENERIC_SUPPORT
1501         bool "Support generic libraries"
1502         help
1503           Enable support for generic U-Boot libraries within TPL. See
1504           SPL_LIBGENERIC_SUPPORT for details.
1505
1506 config TPL_MPC8XXX_INIT_DDR
1507         bool "Support MPC8XXX DDR init"
1508         help
1509           Enable support for DDR-SDRAM on the MPC8XXX family within TPL. See
1510           SPL_MPC8XXX_INIT_DDR for details.
1511
1512 config TPL_MMC
1513         bool "Support MMC"
1514         depends on MMC
1515         help
1516           Enable support for MMC within TPL. See SPL_MMC for details.
1517
1518 config TPL_NAND_SUPPORT
1519         bool "Support NAND flash"
1520         help
1521           Enable support for NAND in TPL. See SPL_NAND_SUPPORT for details.
1522
1523 config TPL_PCI
1524         bool "Support PCI drivers"
1525         help
1526           Enable support for PCI in TPL. For platforms that need PCI to boot,
1527           or must perform some init using PCI in SPL, this provides the
1528           necessary driver support. This enables the drivers in drivers/pci
1529           as part of a TPL build.
1530
1531 config TPL_PCH
1532         bool "Support PCH drivers"
1533         help
1534           Enable support for PCH (Platform Controller Hub) devices in TPL.
1535           These are used to set up GPIOs and the SPI peripheral early in
1536           boot. This enables the drivers in drivers/pch as part of a TPL
1537           build.
1538
1539 config TPL_RAM_SUPPORT
1540         bool "Support booting from RAM"
1541         help
1542           Enable booting of an image in RAM. The image can be preloaded or
1543           it can be loaded by TPL directly into RAM (e.g. using USB).
1544
1545 config TPL_RAM_DEVICE
1546         bool "Support booting from preloaded image in RAM"
1547         depends on TPL_RAM_SUPPORT
1548         help
1549           Enable booting of an image already loaded in RAM. The image has to
1550           be already in memory when TPL takes over, e.g. loaded by the boot
1551           ROM.
1552
1553 config TPL_RTC
1554         bool "Support RTC drivers"
1555         help
1556           Enable RTC (Real-time Clock) support in TPL. This includes support
1557           for reading and setting the time. Some RTC devices also have some
1558           non-volatile (battery-backed) memory which is accessible if
1559           needed. This enables the drivers in drivers/rtc as part of an TPL
1560           build.
1561
1562 config TPL_SERIAL
1563         bool "Support serial"
1564         select TPL_PRINTF
1565         select TPL_STRTO
1566         help
1567           Enable support for serial in TPL. See SPL_SERIAL for
1568           details.
1569
1570 config TPL_SPI_FLASH_SUPPORT
1571         bool "Support SPI flash drivers"
1572         help
1573           Enable support for using SPI flash in TPL. See SPL_SPI_FLASH_SUPPORT
1574           for details.
1575
1576 config TPL_SPI_FLASH_TINY
1577         bool "Enable low footprint TPL SPI Flash support"
1578         depends on TPL_SPI_FLASH_SUPPORT && !SPI_FLASH_BAR
1579         default y if SPI_FLASH
1580         help
1581          Enable lightweight TPL SPI Flash support that supports just reading
1582          data/images from flash. No support to write/erase flash. Enable
1583          this if you have TPL size limitations and don't need full-fledged
1584          SPI flash support.
1585
1586 config TPL_SPI_LOAD
1587         bool "Support loading from SPI flash"
1588         depends on TPL_SPI_FLASH_SUPPORT
1589         help
1590           Enable support for loading next stage, U-Boot or otherwise, from
1591           SPI NOR in U-Boot TPL.
1592
1593 config TPL_SPI
1594         bool "Support SPI drivers"
1595         help
1596           Enable support for using SPI in TPL. See SPL_SPI for
1597           details.
1598
1599 config TPL_DM_SPI
1600         bool "Support SPI DM drivers in TPL"
1601         help
1602           Enable support for SPI DM drivers in TPL.
1603
1604 config TPL_DM_SPI_FLASH
1605         bool "Support SPI DM FLASH drivers in TPL"
1606         help
1607           Enable support for SPI DM flash drivers in TPL.
1608
1609 config TPL_YMODEM_SUPPORT
1610         bool "Support loading using Ymodem"
1611         depends on TPL_SERIAL
1612         help
1613           While loading from serial is slow it can be a useful backup when
1614           there is no other option. The Ymodem protocol provides a reliable
1615           means of transmitting U-Boot over a serial line for using in TPL,
1616           with a checksum to ensure correctness.
1617
1618 endif # TPL
1619
1620 config SPL_AT91_MCK_BYPASS
1621         bool "Use external clock signal as a source of main clock for AT91 platforms"
1622         depends on ARCH_AT91
1623         help
1624           Use external 8 to 24 Mhz clock signal as source of main clock instead
1625           of an external crystal oscillator.
1626           This option disables the internal driving on the XOUT pin.
1627           The external source has to provide a stable clock on the XIN pin.
1628           If this option is disabled, the SoC expects a crystal oscillator
1629           that needs driving on both XIN and XOUT lines.
1630
1631 endif # SPL
1632 endmenu