efi_loader: remove superfluous check in efi_setup_loaded_image()
[oweals/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 HANDOFF
29         bool "Pass hand-off information from SPL to U-Boot proper"
30         depends on BLOBLIST
31         help
32           It is useful to be able to pass information from SPL to U-Boot
33           proper to preserve state that is known in SPL and is needed in U-Boot.
34           Enable this to locate the handoff information in U-Boot proper, early
35           in boot. It is available in gd->handoff. The state state is set up
36           in SPL (or TPL if that is being used).
37
38 if SPL
39
40 config SPL_HANDOFF
41         bool "Pass hand-off information from SPL to U-Boot proper"
42         depends on HANDOFF
43         default y
44         help
45           This option enables SPL to write handoff information. This can be
46           used to pass information like the size of SDRAM from SPL to U-Boot
47           proper. Also SPL can receive information from TPL in the same place
48           if that is enabled.
49
50 config SPL_LDSCRIPT
51         string "Linker script for the SPL stage"
52         default "arch/$(ARCH)/cpu/u-boot-spl.lds"
53         help
54           The SPL stage will usually require a different linker-script
55           (as it runs from a different memory region) than the regular
56           U-Boot stage.  Set this to the path of the linker-script to
57           be used for SPL.
58
59 config SPL_BOARD_INIT
60         bool "Call board-specific initialization in SPL"
61         help
62           If this option is enabled, U-Boot will call the function
63           spl_board_init() from board_init_r(). This function should be
64           provided by the board.
65
66 config SPL_BOOTROM_SUPPORT
67         bool "Support returning to the BOOTROM"
68         help
69           Some platforms (e.g. the Rockchip RK3368) provide support in their
70           ROM for loading the next boot-stage after performing basic setup
71           from the SPL stage.
72
73           Enable this option, to return to the BOOTROM through the
74           BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
75           boot device list, if not implemented for a given board)
76
77 config SPL_BOOTCOUNT_LIMIT
78         bool "Support bootcount in SPL"
79         depends on SPL_ENV_SUPPORT
80         help
81           On some boards, which use 'falcon' mode, it is necessary to check
82           and increment the number of boot attempts. Such boards do not
83           use proper U-Boot for normal boot flow and hence needs those
84           adjustments to be done in the SPL.
85
86 config SPL_RAW_IMAGE_SUPPORT
87         bool "Support SPL loading and booting of RAW images"
88         default n if (ARCH_MX6 && (SPL_MMC_SUPPORT || SPL_SATA_SUPPORT))
89         default y if !TI_SECURE_DEVICE
90         help
91           SPL will support loading and booting a RAW image when this option
92           is y. If this is not set, SPL will move on to other available
93           boot media to find a suitable image.
94
95 config SPL_LEGACY_IMAGE_SUPPORT
96         bool "Support SPL loading and booting of Legacy images"
97         default y if !TI_SECURE_DEVICE
98         help
99           SPL will support loading and booting Legacy images when this option
100           is y. If this is not set, SPL will move on to other available
101           boot media to find a suitable image.
102
103 config SPL_LEGACY_IMAGE_CRC_CHECK
104         bool "Check CRC of Legacy images"
105         depends on SPL_LEGACY_IMAGE_SUPPORT
106         select SPL_CRC32_SUPPORT
107         help
108           Enable this to check the CRC of Legacy images. While this increases
109           reliability, it affects both code size and boot duration.
110           If disabled, Legacy images are booted if the image magic and size
111           are correct, without further integrity checks.
112
113 config SPL_SYS_MALLOC_SIMPLE
114         bool
115         prompt "Only use malloc_simple functions in the SPL"
116         help
117           Say Y here to only use the *_simple malloc functions from
118           malloc_simple.c, rather then using the versions from dlmalloc.c;
119           this will make the SPL binary smaller at the cost of more heap
120           usage as the *_simple malloc functions do not re-use free-ed mem.
121
122 config TPL_SYS_MALLOC_SIMPLE
123         bool
124         prompt "Only use malloc_simple functions in the TPL"
125         help
126           Say Y here to only use the *_simple malloc functions from
127           malloc_simple.c, rather then using the versions from dlmalloc.c;
128           this will make the TPL binary smaller at the cost of more heap
129           usage as the *_simple malloc functions do not re-use free-ed mem.
130
131 config SPL_STACK_R
132         bool "Enable SDRAM location for SPL stack"
133         help
134           SPL starts off execution in SRAM and thus typically has only a small
135           stack available. Since SPL sets up DRAM while in its board_init_f()
136           function, it is possible for the stack to move there before
137           board_init_r() is reached. This option enables a special SDRAM
138           location for the SPL stack. U-Boot SPL switches to this after
139           board_init_f() completes, and before board_init_r() starts.
140
141 config SPL_STACK_R_ADDR
142         depends on SPL_STACK_R
143         hex "SDRAM location for SPL stack"
144         default 0x82000000 if ARCH_OMAP2PLUS
145         help
146           Specify the address in SDRAM for the SPL stack. This will be set up
147           before board_init_r() is called.
148
149 config SPL_STACK_R_MALLOC_SIMPLE_LEN
150         depends on SPL_STACK_R && SPL_SYS_MALLOC_SIMPLE
151         hex "Size of malloc_simple heap after switching to DRAM SPL stack"
152         default 0x100000
153         help
154           Specify the amount of the stack to use as memory pool for
155           malloc_simple after switching the stack to DRAM. This may be set
156           to give board_init_r() a larger heap then the initial heap in
157           SRAM which is limited to SYS_MALLOC_F_LEN bytes.
158
159 config SPL_SEPARATE_BSS
160         bool "BSS section is in a different memory region from text"
161         help
162           Some platforms need a large BSS region in SPL and can provide this
163           because RAM is already set up. In this case BSS can be moved to RAM.
164           This option should then be enabled so that the correct device tree
165           location is used. Normally we put the device tree at the end of BSS
166           but with this option enabled, it goes at _image_binary_end.
167
168 config SPL_BANNER_PRINT
169         bool "Enable output of the SPL banner 'U-Boot SPL ...'"
170         default y
171         help
172           If this option is enabled, SPL will print the banner with version
173           info. Disabling this option could be useful to reduce TPL boot time
174           (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
175
176 config TPL_BANNER_PRINT
177         bool "Enable output of the TPL banner 'U-Boot TPL ...'"
178         default y
179         help
180           If this option is enabled, SPL will not print the banner with version
181           info. Disabling this option could be useful to reduce SPL boot time
182           (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
183
184 config SPL_DISPLAY_PRINT
185         bool "Display a board-specific message in SPL"
186         help
187           If this option is enabled, U-Boot will call the function
188           spl_display_print() immediately after displaying the SPL console
189           banner ("U-Boot SPL ..."). This function should be provided by
190           the board.
191
192 config SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
193         bool "MMC raw mode: by sector"
194         default y if ARCH_SUNXI || ARCH_DAVINCI || ARCH_UNIPHIER || \
195                      ARCH_MX6 || ARCH_MX7 || \
196                      ARCH_ROCKCHIP || ARCH_MVEBU ||  ARCH_SOCFPGA || \
197                      ARCH_AT91 || ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || \
198                      OMAP44XX || OMAP54XX || AM33XX || AM43XX
199         help
200           Use sector number for specifying U-Boot location on MMC/SD in
201           raw mode.
202
203 config SYS_MMCSD_RAW_MODE_U_BOOT_SECTOR
204         hex "Address on the MMC to load U-Boot from"
205         depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
206         default 0x50 if ARCH_SUNXI
207         default 0x75 if ARCH_DAVINCI
208         default 0x8a if ARCH_MX6 || ARCH_MX7
209         default 0x100 if ARCH_UNIPHIER
210         default 0x140 if ARCH_MVEBU
211         default 0x200 if ARCH_SOCFPGA || ARCH_AT91
212         default 0x300 if ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || OMAP44XX || \
213                          OMAP54XX || AM33XX || AM43XX || ARCH_K3
214         default 0x4000 if ARCH_ROCKCHIP
215         help
216           Address on the MMC to load U-Boot from, when the MMC is being used
217           in raw mode. Units: MMC sectors (1 sector = 512 bytes).
218
219 config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
220         bool "MMC Raw mode: by partition"
221         help
222           Use a partition for loading U-Boot when using MMC/SD in raw mode.
223
224 config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION
225         hex "Partition to use to load U-Boot from"
226         depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
227         default 1
228         help
229           Partition on the MMC to load U-Boot from when the MMC is being
230           used in raw mode
231
232 config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
233         bool "MMC raw mode: by partition type"
234         depends on DOS_PARTITION && SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
235         help
236           Use partition type for specifying U-Boot partition on MMC/SD in
237           raw mode. U-Boot will be loaded from the first partition of this
238           type to be found.
239
240 config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION_TYPE
241         hex "Partition Type on the MMC to load U-Boot from"
242         depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
243         help
244           Partition Type on the MMC to load U-Boot from, when the MMC is being
245           used in raw mode.
246
247 config SPL_CRC32_SUPPORT
248         bool "Support CRC32"
249         default y if SPL_LEGACY_IMAGE_SUPPORT
250         help
251           Enable this to support CRC32 in uImages or FIT images within SPL.
252           This is a 32-bit checksum value that can be used to verify images.
253           For FIT images, this is the least secure type of checksum, suitable
254           for detected accidental image corruption. For secure applications you
255           should consider SHA1 or SHA256.
256
257 config SPL_MD5_SUPPORT
258         bool "Support MD5"
259         depends on SPL_FIT
260         help
261           Enable this to support MD5 in FIT images within SPL. An MD5
262           checksum is a 128-bit hash value used to check that the image
263           contents have not been corrupted. Note that MD5 is not considered
264           secure as it is possible (with a brute-force attack) to adjust the
265           image while still retaining the same MD5 hash value. For secure
266           applications where images may be changed maliciously, you should
267           consider SHA1 or SHA256.
268
269 config SPL_SHA1_SUPPORT
270         bool "Support SHA1"
271         depends on SPL_FIT
272         select SHA1
273         help
274           Enable this to support SHA1 in FIT images within SPL. A SHA1
275           checksum is a 160-bit (20-byte) hash value used to check that the
276           image contents have not been corrupted or maliciously altered.
277           While SHA1 is fairly secure it is coming to the end of its life
278           due to the expanding computing power avaiable to brute-force
279           attacks. For more security, consider SHA256.
280
281 config SPL_SHA256_SUPPORT
282         bool "Support SHA256"
283         depends on SPL_FIT
284         select SHA256
285         help
286           Enable this to support SHA256 in FIT images within SPL. A SHA256
287           checksum is a 256-bit (32-byte) hash value used to check that the
288           image contents have not been corrupted. SHA256 is recommended for
289           use in secure applications since (as at 2016) there is no known
290           feasible attack that could produce a 'collision' with differing
291           input data. Use this for the highest security. Note that only the
292           SHA256 variant is supported: SHA512 and others are not currently
293           supported in U-Boot.
294
295 config SPL_FIT_IMAGE_TINY
296         bool "Remove functionality from SPL FIT loading to reduce size"
297         depends on SPL_FIT
298         default y if MACH_SUN50I || MACH_SUN50I_H5 || MACH_SUN50I_H6
299         default y if ARCH_IMX8M
300         help
301           Enable this to reduce the size of the FIT image loading code
302           in SPL, if space for the SPL binary is very tight.
303
304           This removes the detection of image types (which forces the
305           first image to be treated as having a U-Boot style calling
306           convention) and skips the recording of each loaded payload
307           (i.e. loadable) into the FDT (modifying the loaded FDT to
308           ensure this information is available to the next image
309           invoked).
310
311 config SPL_CPU_SUPPORT
312         bool "Support CPU drivers"
313         help
314           Enable this to support CPU drivers in SPL. These drivers can set
315           up CPUs and provide information about them such as the model and
316           name. This can be useful in SPL since setting up the CPUs earlier
317           may improve boot performance. Enable this option to build the
318           drivers in drivers/cpu as part of an SPL build.
319
320 config SPL_CRYPTO_SUPPORT
321         bool "Support crypto drivers"
322         help
323           Enable crypto drivers in SPL. These drivers can be used to
324           accelerate secure boot processing in secure applications. Enable
325           this option to build the drivers in drivers/crypto as part of an
326           SPL build.
327
328 config SPL_HASH_SUPPORT
329         bool "Support hashing drivers"
330         select SHA1
331         select SHA256
332         help
333           Enable hashing drivers in SPL. These drivers can be used to
334           accelerate secure boot processing in secure applications. Enable
335           this option to build system-specific drivers for hash acceleration
336           as part of an SPL build.
337
338 config TPL_HASH_SUPPORT
339         bool "Support hashing drivers in TPL"
340         select SHA1
341         select SHA256
342         help
343           Enable hashing drivers in SPL. These drivers can be used to
344           accelerate secure boot processing in secure applications. Enable
345           this option to build system-specific drivers for hash acceleration
346           as part of an SPL build.
347
348 config SPL_DMA_SUPPORT
349         bool "Support DMA drivers"
350         help
351           Enable DMA (direct-memory-access) drivers in SPL. These drivers
352           can be used to handle memory-to-peripheral data transfer without
353           the CPU moving the data. Enable this option to build the drivers
354           in drivers/dma as part of an SPL build.
355
356 config SPL_DRIVERS_MISC_SUPPORT
357         bool "Support misc drivers"
358         help
359           Enable miscellaneous drivers in SPL. These drivers perform various
360           tasks that don't fall nicely into other categories, Enable this
361           option to build the drivers in drivers/misc as part of an SPL
362           build, for those that support building in SPL (not all drivers do).
363
364 config SPL_ENV_SUPPORT
365         bool "Support an environment"
366         help
367           Enable environment support in SPL. The U-Boot environment provides
368           a number of settings (essentially name/value pairs) which can
369           control many aspects of U-Boot's operation. Normally this is not
370           needed in SPL as it has a much simpler task with less
371           configuration. But some boards use this to support 'Falcon' boot
372           on EXT2 and FAT, where SPL boots directly into Linux without
373           starting U-Boot first. Enabling this option will make env_get()
374           and env_set() available in SPL.
375
376 config SPL_SAVEENV
377         bool "Support save environment"
378         depends on SPL_ENV_SUPPORT
379         select SPL_MMC_WRITE if ENV_IS_IN_MMC
380         help
381           Enable save environment support in SPL after setenv. By default
382           the saveenv option is not provided in SPL, but some boards need
383           this support in 'Falcon' boot, where SPL need to boot from
384           different images based on environment variable set by OS. For
385           example OS may set "reboot_image" environment variable to
386           "recovery" inorder to boot recovery image by SPL. The SPL read
387           "reboot_image" and act accordingly and change the reboot_image
388           to default mode using setenv and save the environment.
389
390 config SPL_ETH_SUPPORT
391         bool "Support Ethernet"
392         depends on SPL_ENV_SUPPORT
393         help
394           Enable access to the network subsystem and associated Ethernet
395           drivers in SPL. This permits SPL to load U-Boot over an Ethernet
396           link rather than from an on-board peripheral. Environment support
397           is required since the network stack uses a number of environment
398           variables. See also SPL_NET_SUPPORT.
399
400 config SPL_FS_EXT4
401         bool "Support EXT filesystems"
402         help
403           Enable support for EXT2/3/4 filesystems with SPL. This permits
404           U-Boot (or Linux in Falcon mode) to be loaded from an EXT
405           filesystem from within SPL. Support for the underlying block
406           device (e.g. MMC or USB) must be enabled separately.
407
408 config SPL_FS_FAT
409         bool "Support FAT filesystems"
410         select FS_FAT
411         help
412           Enable support for FAT and VFAT filesystems with SPL. This
413           permits U-Boot (or Linux in Falcon mode) to be loaded from a FAT
414           filesystem from within SPL. Support for the underlying block
415           device (e.g. MMC or USB) must be enabled separately.
416
417 config SPL_FAT_WRITE
418         bool "Support write for FAT filesystems"
419         help
420           Enable write support for FAT and VFAT filesystems with SPL.
421           Support for the underlying block device (e.g. MMC or USB) must be
422           enabled separately.
423
424 config SPL_FPGA_SUPPORT
425         bool "Support FPGAs"
426         help
427           Enable support for FPGAs in SPL. Field-programmable Gate Arrays
428           provide software-configurable hardware which is typically used to
429           implement peripherals (such as UARTs, LCD displays, MMC) or
430           accelerate custom processing functions, such as image processing
431           or machine learning. Sometimes it is useful to program the FPGA
432           as early as possible during boot, and this option can enable that
433           within SPL.
434
435 config SPL_GPIO_SUPPORT
436         bool "Support GPIO in SPL"
437         help
438           Enable support for GPIOs (General-purpose Input/Output) in SPL.
439           GPIOs allow U-Boot to read the state of an input line (high or
440           low) and set the state of an output line. This can be used to
441           drive LEDs, control power to various system parts and read user
442           input. GPIOs can be useful in SPL to enable a 'sign-of-life' LED,
443           for example. Enable this option to build the drivers in
444           drivers/gpio as part of an SPL build.
445
446 config SPL_I2C_SUPPORT
447         bool "Support I2C"
448         help
449           Enable support for the I2C (Inter-Integrated Circuit) bus in SPL.
450           I2C works with a clock and data line which can be driven by a
451           one or more masters or slaves. It is a fairly complex bus but is
452           widely used as it only needs two lines for communication. Speeds of
453           400kbps are typical but up to 3.4Mbps is supported by some
454           hardware. I2C can be useful in SPL to configure power management
455           ICs (PMICs) before raising the CPU clock speed, for example.
456           Enable this option to build the drivers in drivers/i2c as part of
457           an SPL build.
458
459 config SPL_LIBCOMMON_SUPPORT
460         bool "Support common libraries"
461         help
462           Enable support for common U-Boot libraries within SPL. These
463           libraries include common code to deal with U-Boot images,
464           environment and USB, for example. This option is enabled on many
465           boards. Enable this option to build the code in common/ as part of
466           an SPL build.
467
468 config SPL_LIBDISK_SUPPORT
469         bool "Support disk partitions"
470         select PARTITIONS
471         help
472           Enable support for disk partitions within SPL. 'Disk' is something
473           of a misnomer as it includes non-spinning media such as flash (as
474           used in MMC and USB sticks). Partitions provide a way for a disk
475           to be split up into separate regions, with a partition table placed
476           at the start or end which describes the location and size of each
477           'partition'. These partitions are typically uses as individual block
478           devices, typically with an EXT2 or FAT filesystem in each. This
479           option enables whatever partition support has been enabled in
480           U-Boot to also be used in SPL. It brings in the code in disk/.
481
482 config SPL_LIBGENERIC_SUPPORT
483         bool "Support generic libraries"
484         help
485           Enable support for generic U-Boot libraries within SPL. These
486           libraries include generic code to deal with device tree, hashing,
487           printf(), compression and the like. This option is enabled on many
488           boards. Enable this option to build the code in lib/ as part of an
489           SPL build.
490
491 config SPL_DM_MAILBOX
492         bool "Support Mailbox"
493         help
494           Enable support for Mailbox within SPL. This enable the inter
495           processor communication protocols tobe used within SPL. Enable
496           this option to build the drivers in drivers/mailbox as part of
497           SPL build.
498
499 config SPL_MMC_SUPPORT
500         bool "Support MMC"
501         depends on MMC
502         select HAVE_BLOCK_DEVICE
503         help
504           Enable support for MMC (Multimedia Card) within SPL. This enables
505           the MMC protocol implementation and allows any enabled drivers to
506           be used within SPL. MMC can be used with or without disk partition
507           support depending on the application (SPL_LIBDISK_SUPPORT). Enable
508           this option to build the drivers in drivers/mmc as part of an SPL
509           build.
510
511 config SPL_MMC_WRITE
512         bool "MMC/SD/SDIO card support for write operations in SPL"
513         depends on SPL_MMC_SUPPORT
514         default n
515         help
516           Enable write access to MMC and SD Cards in SPL
517
518
519 config SPL_MPC8XXX_INIT_DDR_SUPPORT
520         bool "Support MPC8XXX DDR init"
521         help
522           Enable support for DDR-SDRAM (double-data-rate synchronous dynamic
523           random-access memory) on the MPC8XXX family within SPL. This
524           allows DRAM to be set up before loading U-Boot into that DRAM,
525           where it can run.
526
527 config SPL_MTD_SUPPORT
528         bool "Support MTD drivers"
529         help
530           Enable support for MTD (Memory Technology Device) within SPL. MTD
531           provides a block interface over raw NAND and can also be used with
532           SPI flash. This allows SPL to load U-Boot from supported MTD
533           devices. See SPL_NAND_SUPPORT and SPL_ONENAND_SUPPORT for how
534           to enable specific MTD drivers.
535
536 config SPL_MUSB_NEW_SUPPORT
537         bool "Support new Mentor Graphics USB"
538         help
539           Enable support for Mentor Graphics USB in SPL. This is a new
540           driver used by some boards. Enable this option to build
541           the drivers in drivers/usb/musb-new as part of an SPL build. The
542           old drivers are in drivers/usb/musb.
543
544 config SPL_NAND_SUPPORT
545         bool "Support NAND flash"
546         help
547           Enable support for NAND (Negative AND) flash in SPL. NAND flash
548           can be used to allow SPL to load U-Boot from supported devices.
549           This enables the drivers in drivers/mtd/nand/raw as part of an SPL
550           build.
551
552 config SPL_NET_SUPPORT
553         bool "Support networking"
554         help
555           Enable support for network devices (such as Ethernet) in SPL.
556           This permits SPL to load U-Boot over a network link rather than
557           from an on-board peripheral. Environment support is required since
558           the network stack uses a number of environment variables. See also
559           SPL_ETH_SUPPORT.
560
561 if SPL_NET_SUPPORT
562 config SPL_NET_VCI_STRING
563         string "BOOTP Vendor Class Identifier string sent by SPL"
564         help
565           As defined by RFC 2132 the vendor class identifier field can be
566           sent by the client to identify the vendor type and configuration
567           of a client.  This is often used in practice to allow for the DHCP
568           server to specify different files to load depending on if the ROM,
569           SPL or U-Boot itself makes the request
570 endif   # if SPL_NET_SUPPORT
571
572 config SPL_NO_CPU_SUPPORT
573         bool "Drop CPU code in SPL"
574         help
575           This is specific to the ARM926EJ-S CPU. It disables the standard
576           start.S start-up code, presumably so that a replacement can be
577           used on that CPU. You should not enable it unless you know what
578           you are doing.
579
580 config SPL_NOR_SUPPORT
581         bool "Support NOR flash"
582         help
583           Enable support for loading U-Boot from memory-mapped NOR (Negative
584           OR) flash in SPL. NOR flash is slow to write but fast to read, and
585           a memory-mapped device makes it very easy to access. Loading from
586           NOR is typically achieved with just a memcpy().
587
588 config SPL_XIP_SUPPORT
589         bool "Support XIP"
590         depends on SPL
591         help
592           Enable support for execute in place of U-Boot or kernel image. There
593           is no need to copy image from flash to ram if flash supports execute
594           in place. Its very useful in systems having enough flash but not
595           enough ram to load the image.
596
597 config SPL_ONENAND_SUPPORT
598         bool "Support OneNAND flash"
599         help
600           Enable support for OneNAND (Negative AND) flash in SPL. OneNAND is
601           a type of NAND flash and therefore can be used to allow SPL to
602           load U-Boot from supported devices. This enables the drivers in
603           drivers/mtd/onenand as part of an SPL build.
604
605 config SPL_OS_BOOT
606         bool "Activate Falcon Mode"
607         depends on !TI_SECURE_DEVICE
608         default n
609         help
610           Enable booting directly to an OS from SPL.
611           for more info read doc/README.falcon
612
613 if SPL_OS_BOOT
614 config SYS_OS_BASE
615         hex "addr, where OS is found"
616         depends on SPL_NOR_SUPPORT
617         help
618           Specify the address, where the OS image is found, which
619           gets booted.
620
621 endif # SPL_OS_BOOT
622
623 config SPL_PAYLOAD
624         string "SPL payload"
625         default "tpl/u-boot-with-tpl.bin" if TPL
626         default "u-boot.bin"
627         help
628           Payload for SPL boot. For backward compatibility, default to
629           u-boot.bin, i.e. RAW image without any header. In case of
630           TPL, tpl/u-boot-with-tpl.bin. For new boards, suggest to
631           use u-boot.img.
632
633 config SPL_PCI
634         bool "Support PCI drivers"
635         help
636           Enable support for PCI in SPL. For platforms that need PCI to boot,
637           or must perform some init using PCI in SPL, this provides the
638           necessary driver support. This enables the drivers in drivers/pci
639           as part of an SPL build.
640
641 config SPL_PCH_SUPPORT
642         bool "Support PCH drivers"
643         help
644           Enable support for PCH (Platform Controller Hub) devices in SPL.
645           These are used to set up GPIOs and the SPI peripheral early in
646           boot. This enables the drivers in drivers/pch as part of an SPL
647           build.
648
649 config SPL_POST_MEM_SUPPORT
650         bool "Support POST drivers"
651         help
652           Enable support for POST (Power-on Self Test) in SPL. POST is a
653           procedure that checks that the hardware (CPU or board) appears to
654           be functionally correctly. It is a sanity check that can be
655           performed before booting. This enables the drivers in post/drivers
656           as part of an SPL build.
657
658 config SPL_DM_RESET
659         bool "Support reset drivers"
660         depends on SPL
661         help
662           Enable support for reset control in SPL.
663           That can be useful in SPL to handle IP reset in driver, as in U-Boot,
664           by using the generic reset API provided by driver model.
665           This enables the drivers in drivers/reset as part of an SPL build.
666
667 config SPL_POWER_SUPPORT
668         bool "Support power drivers"
669         help
670           Enable support for power control in SPL. This includes support
671           for PMICs (Power-management Integrated Circuits) and some of the
672           features provided by PMICs. In particular, voltage regulators can
673           be used to enable/disable power and vary its voltage. That can be
674           useful in SPL to turn on boot peripherals and adjust CPU voltage
675           so that the clock speed can be increased. This enables the drivers
676           in drivers/power, drivers/power/pmic and drivers/power/regulator
677           as part of an SPL build.
678
679 config SPL_POWER_DOMAIN
680         bool "Support power domain drivers"
681         help
682           Enable support for power domain control in SPL. Many SoCs allow
683           power to be applied to or removed from portions of the SoC (power
684           domains). This may be used to save power. This API provides the
685           means to control such power management hardware. This enables
686           the drivers in drivers/power/domain as part of a SPL build.
687
688 config SPL_RAM_SUPPORT
689         bool "Support booting from RAM"
690         default y if MICROBLAZE || ARCH_SOCFPGA || TEGRA || ARCH_ZYNQ
691         help
692           Enable booting of an image in RAM. The image can be preloaded or
693           it can be loaded by SPL directly into RAM (e.g. using USB).
694
695 config SPL_RAM_DEVICE
696         bool "Support booting from preloaded image in RAM"
697         depends on SPL_RAM_SUPPORT
698         default y if MICROBLAZE || ARCH_SOCFPGA || TEGRA || ARCH_ZYNQ
699         help
700           Enable booting of an image already loaded in RAM. The image has to
701           be already in memory when SPL takes over, e.g. loaded by the boot
702           ROM.
703
704 config SPL_REMOTEPROC
705         bool "Support REMOTEPROCS"
706         help
707           Enable support for REMOTEPROCs in SPL. This permits to load
708           a remote processor firmware in SPL.
709
710 config SPL_RTC_SUPPORT
711         bool "Support RTC drivers"
712         help
713           Enable RTC (Real-time Clock) support in SPL. This includes support
714           for reading and setting the time. Some RTC devices also have some
715           non-volatile (battery-backed) memory which is accessible if
716           needed. This enables the drivers in drivers/rtc as part of an SPL
717           build.
718
719 config SPL_SATA_SUPPORT
720         bool "Support loading from SATA"
721         help
722           Enable support for SATA (Serial AT attachment) in SPL. This allows
723           use of SATA devices such as hard drives and flash drivers for
724           loading U-Boot. SATA is used in higher-end embedded systems and
725           can provide higher performance than MMC , at somewhat higher
726           expense and power consumption. This enables loading from SATA
727           using a configured device.
728
729 config SPL_SERIAL_SUPPORT
730         bool "Support serial"
731         select SPL_PRINTF
732         select SPL_STRTO
733         help
734           Enable support for serial in SPL. This allows use of a serial UART
735           for displaying messages while SPL is running. It also brings in
736           printf() and panic() functions. This should normally be enabled
737           unless there are space reasons not to. Even then, consider
738           enabling USE_TINY_PRINTF which is a small printf() version.
739
740 config SPL_SPI_FLASH_SUPPORT
741         bool "Support SPI flash drivers"
742         help
743           Enable support for using SPI flash in SPL, and loading U-Boot from
744           SPI flash. SPI flash (Serial Peripheral Bus flash) is named after
745           the SPI bus that is used to connect it to a system. It is a simple
746           but fast bidirectional 4-wire bus (clock, chip select and two data
747           lines). This enables the drivers in drivers/mtd/spi as part of an
748           SPL build. This normally requires SPL_SPI_SUPPORT.
749
750 if SPL_SPI_FLASH_SUPPORT
751
752 config SPL_SPI_FLASH_TINY
753         bool "Enable low footprint SPL SPI Flash support"
754         depends on !SPI_FLASH_BAR
755         default y if SPI_FLASH
756         help
757          Enable lightweight SPL SPI Flash support that supports just reading
758          data/images from flash. No support to write/erase flash. Enable
759          this if you have SPL size limitations and don't need full
760          fledged SPI flash support.
761
762 config SPL_SPI_FLASH_SFDP_SUPPORT
763         bool "SFDP table parsing support for SPI NOR flashes"
764         depends on !SPI_FLASH_BAR && !SPL_SPI_FLASH_TINY
765         help
766          Enable support for parsing and auto discovery of parameters for
767          SPI NOR flashes using Serial Flash Discoverable Parameters (SFDP)
768          tables as per JESD216 standard in SPL.
769
770 config SPL_SPI_LOAD
771         bool "Support loading from SPI flash"
772         help
773           Enable support for loading next stage, U-Boot or otherwise, from
774           SPI NOR in U-Boot SPL.
775
776 endif # SPL_SPI_FLASH_SUPPORT
777
778 config SPL_SPI_SUPPORT
779         bool "Support SPI drivers"
780         help
781           Enable support for using SPI in SPL. This is used for connecting
782           to SPI flash for loading U-Boot. See SPL_SPI_FLASH_SUPPORT for
783           more details on that. The SPI driver provides the transport for
784           data between the SPI flash and the CPU. This option can be used to
785           enable SPI drivers that are needed for other purposes also, such
786           as a SPI PMIC.
787
788 config SPL_THERMAL
789         bool "Driver support for thermal devices"
790         help
791           Enable support for temperature-sensing devices. Some SoCs have on-chip
792           temperature sensors to permit warnings, speed throttling or even
793           automatic power-off when the temperature gets too high or low. Other
794           devices may be discrete but connected on a suitable bus.
795
796 config SPL_USB_HOST_SUPPORT
797         bool "Support USB host drivers"
798         select HAVE_BLOCK_DEVICE
799         help
800           Enable access to USB (Universal Serial Bus) host devices so that
801           SPL can load U-Boot from a connected USB peripheral, such as a USB
802           flash stick. While USB takes a little longer to start up than most
803           buses, it is very flexible since many different types of storage
804           device can be attached. This option enables the drivers in
805           drivers/usb/host as part of an SPL build.
806
807 config SPL_USB_STORAGE
808         bool "Support loading from USB"
809         depends on SPL_USB_HOST_SUPPORT && !(BLK && !DM_USB)
810         help
811           Enable support for USB devices in SPL. This allows use of USB
812           devices such as hard drives and flash drivers for loading U-Boot.
813           The actual drivers are enabled separately using the normal U-Boot
814           config options. This enables loading from USB using a configured
815           device.
816
817 config SPL_USB_GADGET
818         bool "Suppport USB Gadget drivers"
819         help
820           Enable USB Gadget API which allows to enable USB device functions
821           in SPL.
822
823 if SPL_USB_GADGET
824
825 config SPL_USB_ETHER
826         bool "Support USB Ethernet drivers"
827         help
828           Enable access to the USB network subsystem and associated
829           drivers in SPL. This permits SPL to load U-Boot over a
830           USB-connected Ethernet link (such as a USB Ethernet dongle) rather
831           than from an onboard peripheral. Environment support is required
832           since the network stack uses a number of environment variables.
833           See also SPL_NET_SUPPORT and SPL_ETH_SUPPORT.
834
835 config SPL_DFU
836         bool "Support DFU (Device Firmware Upgrade)"
837         select SPL_HASH_SUPPORT
838         select SPL_DFU_NO_RESET
839         depends on SPL_RAM_SUPPORT
840         help
841           This feature enables the DFU (Device Firmware Upgrade) in SPL with
842           RAM memory device support. The ROM code will load and execute
843           the SPL built with dfu. The user can load binaries (u-boot/kernel) to
844           selected device partition from host-pc using dfu-utils.
845           This feature is useful to flash the binaries to factory or bare-metal
846           boards using USB interface.
847
848 choice
849         bool "DFU device selection"
850         depends on SPL_DFU
851
852 config SPL_DFU_RAM
853         bool "RAM device"
854         depends on SPL_DFU && SPL_RAM_SUPPORT
855         help
856          select RAM/DDR memory device for loading binary images
857          (u-boot/kernel) to the selected device partition using
858          DFU and execute the u-boot/kernel from RAM.
859
860 endchoice
861
862 config SPL_USB_SDP_SUPPORT
863         bool "Support SDP (Serial Download Protocol)"
864         help
865           Enable Serial Download Protocol (SDP) device support in SPL. This
866           allows to download images into memory and execute (jump to) them
867           using the same protocol as implemented by the i.MX family's boot ROM.
868 endif
869
870 config SPL_WATCHDOG_SUPPORT
871         bool "Support watchdog drivers"
872         help
873           Enable support for watchdog drivers in SPL. A watchdog is
874           typically a hardware peripheral which can reset the system when it
875           detects no activity for a while (such as a software crash). This
876           enables the drivers in drivers/watchdog as part of an SPL build.
877
878 config SPL_YMODEM_SUPPORT
879         bool "Support loading using Ymodem"
880         depends on SPL_SERIAL_SUPPORT
881         help
882           While loading from serial is slow it can be a useful backup when
883           there is no other option. The Ymodem protocol provides a reliable
884           means of transmitting U-Boot over a serial line for using in SPL,
885           with a checksum to ensure correctness.
886
887 config SPL_ATF
888         bool "Support ARM Trusted Firmware"
889         depends on ARM64
890         help
891           ATF(ARM Trusted Firmware) is a component for ARM AArch64 which
892           is loaded by SPL (which is considered as BL2 in ATF terminology).
893           More detail at: https://github.com/ARM-software/arm-trusted-firmware
894
895 config SPL_ATF_NO_PLATFORM_PARAM
896         bool "Pass no platform parameter"
897         depends on SPL_ATF
898         help
899           While we expect to call a pointer to a valid FDT (or NULL)
900           as the platform parameter to an ATF, some ATF versions are
901           not U-Boot aware and have an insufficiently robust parameter
902           validation to gracefully reject a FDT being passed.
903
904           If this option is enabled, the spl_atf os-type handler will
905           always pass NULL for the platform parameter.
906
907           If your ATF is affected, say Y.
908
909 config SPL_AM33XX_ENABLE_RTC32K_OSC
910         bool "Enable the RTC32K OSC on AM33xx based platforms"
911         default y if AM33XX
912         help
913           Enable access to the AM33xx RTC and select the external 32kHz clock
914           source.
915
916 config SPL_OPTEE
917         bool "Support OP-TEE Trusted OS"
918         depends on ARM
919         help
920           OP-TEE is an open source Trusted OS  which is loaded by SPL.
921           More detail at: https://github.com/OP-TEE/optee_os
922
923 config TPL
924         bool
925         depends on SUPPORT_TPL
926         prompt "Enable TPL"
927         help
928           If you want to build TPL as well as the normal image and SPL, say Y.
929
930 if TPL
931
932 config TPL_HANDOFF
933         bool "Pass hand-off information from TPL to SPL and U-Boot proper"
934         depends on HANDOFF
935         default y
936         help
937           This option enables TPL to write handoff information. This can be
938           used to pass information like the size of SDRAM from TPL to U-Boot
939           proper. The information is also available to SPL if it is useful
940           there.
941
942 config TPL_BOARD_INIT
943         bool "Call board-specific initialization in TPL"
944         help
945           If this option is enabled, U-Boot will call the function
946           spl_board_init() from board_init_r(). This function should be
947           provided by the board.
948
949 config TPL_LDSCRIPT
950         string "Linker script for the TPL stage"
951         depends on TPL
952         default "arch/arm/cpu/armv8/u-boot-spl.lds" if ARM64
953         default "arch/$(ARCH)/cpu/u-boot-spl.lds"
954         help
955           The TPL stage will usually require a different linker-script
956           (as it runs from a different memory region) than the regular
957           U-Boot stage.  Set this to the path of the linker-script to
958           be used for TPL.
959
960           May be left empty to trigger the Makefile infrastructure to
961           fall back to the linker-script used for the SPL stage.
962
963 config TPL_NEEDS_SEPARATE_TEXT_BASE
964         bool "TPL needs a separate text-base"
965         default n
966         depends on TPL
967         help
968           Enable, if the TPL stage should not inherit its text-base
969           from the SPL stage.  When enabled, a base address for the
970           .text sections of the TPL stage has to be set below.
971
972 config TPL_NEEDS_SEPARATE_STACK
973         bool "TPL needs a separate initial stack-pointer"
974         default n
975         depends on TPL
976         help
977           Enable, if the TPL stage should not inherit its initial
978           stack-pointer from the settings for the SPL stage.
979
980 config TPL_TEXT_BASE
981         hex "Base address for the .text section of the TPL stage"
982         depends on TPL_NEEDS_SEPARATE_TEXT_BASE
983         help
984           The base address for the .text section of the TPL stage.
985
986 config TPL_MAX_SIZE
987         int "Maximum size (in bytes) for the TPL stage"
988         default 0
989         depends on TPL
990         help
991           The maximum size (in bytes) of the TPL stage.
992
993 config TPL_STACK
994         hex "Address of the initial stack-pointer for the TPL stage"
995         depends on TPL_NEEDS_SEPARATE_STACK
996         help
997           The address of the initial stack-pointer for the TPL stage.
998           Usually this will be the (aligned) top-of-stack.
999
1000 config TPL_BOOTROM_SUPPORT
1001         bool "Support returning to the BOOTROM (from TPL)"
1002         help
1003           Some platforms (e.g. the Rockchip RK3368) provide support in their
1004           ROM for loading the next boot-stage after performing basic setup
1005           from the TPL stage.
1006
1007           Enable this option, to return to the BOOTROM through the
1008           BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
1009           boot device list, if not implemented for a given board)
1010
1011 config TPL_DRIVERS_MISC_SUPPORT
1012         bool "Support misc drivers in TPL"
1013         help
1014           Enable miscellaneous drivers in TPL. These drivers perform various
1015           tasks that don't fall nicely into other categories, Enable this
1016           option to build the drivers in drivers/misc as part of an TPL
1017           build, for those that support building in TPL (not all drivers do).
1018
1019 config TPL_ENV_SUPPORT
1020         bool "Support an environment"
1021         help
1022           Enable environment support in TPL. See SPL_ENV_SUPPORT for details.
1023
1024 config TPL_GPIO_SUPPORT
1025         bool "Support GPIO in TPL"
1026         help
1027           Enable support for GPIOs (General-purpose Input/Output) in TPL.
1028           GPIOs allow U-Boot to read the state of an input line (high or
1029           low) and set the state of an output line. This can be used to
1030           drive LEDs, control power to various system parts and read user
1031           input. GPIOs can be useful in TPL to enable a 'sign-of-life' LED,
1032           for example. Enable this option to build the drivers in
1033           drivers/gpio as part of an TPL build.
1034
1035 config TPL_I2C_SUPPORT
1036         bool "Support I2C"
1037         help
1038           Enable support for the I2C bus in TPL. See SPL_I2C_SUPPORT for
1039           details.
1040
1041 config TPL_LIBCOMMON_SUPPORT
1042         bool "Support common libraries"
1043         help
1044           Enable support for common U-Boot libraries within TPL. See
1045           SPL_LIBCOMMON_SUPPORT for details.
1046
1047 config TPL_LIBGENERIC_SUPPORT
1048         bool "Support generic libraries"
1049         help
1050           Enable support for generic U-Boot libraries within TPL. See
1051           SPL_LIBGENERIC_SUPPORT for details.
1052
1053 config TPL_MPC8XXX_INIT_DDR_SUPPORT
1054         bool "Support MPC8XXX DDR init"
1055         help
1056           Enable support for DDR-SDRAM on the MPC8XXX family within TPL. See
1057           SPL_MPC8XXX_INIT_DDR_SUPPORT for details.
1058
1059 config TPL_MMC_SUPPORT
1060         bool "Support MMC"
1061         depends on MMC
1062         help
1063           Enable support for MMC within TPL. See SPL_MMC_SUPPORT for details.
1064
1065 config TPL_NAND_SUPPORT
1066         bool "Support NAND flash"
1067         help
1068           Enable support for NAND in TPL. See SPL_NAND_SUPPORT for details.
1069
1070 config TPL_PCI
1071         bool "Support PCI drivers"
1072         help
1073           Enable support for PCI in TPL. For platforms that need PCI to boot,
1074           or must perform some init using PCI in SPL, this provides the
1075           necessary driver support. This enables the drivers in drivers/pci
1076           as part of a TPL build.
1077
1078 config TPL_PCH_SUPPORT
1079         bool "Support PCH drivers"
1080         help
1081           Enable support for PCH (Platform Controller Hub) devices in TPL.
1082           These are used to set up GPIOs and the SPI peripheral early in
1083           boot. This enables the drivers in drivers/pch as part of a TPL
1084           build.
1085
1086 config TPL_RAM_SUPPORT
1087         bool "Support booting from RAM"
1088         help
1089           Enable booting of an image in RAM. The image can be preloaded or
1090           it can be loaded by TPL directly into RAM (e.g. using USB).
1091
1092 config TPL_RAM_DEVICE
1093         bool "Support booting from preloaded image in RAM"
1094         depends on TPL_RAM_SUPPORT
1095         help
1096           Enable booting of an image already loaded in RAM. The image has to
1097           be already in memory when TPL takes over, e.g. loaded by the boot
1098           ROM.
1099
1100 config TPL_RTC_SUPPORT
1101         bool "Support RTC drivers"
1102         help
1103           Enable RTC (Real-time Clock) support in TPL. This includes support
1104           for reading and setting the time. Some RTC devices also have some
1105           non-volatile (battery-backed) memory which is accessible if
1106           needed. This enables the drivers in drivers/rtc as part of an TPL
1107           build.
1108
1109 config TPL_SERIAL_SUPPORT
1110         bool "Support serial"
1111         select TPL_PRINTF
1112         select TPL_STRTO
1113         help
1114           Enable support for serial in TPL. See SPL_SERIAL_SUPPORT for
1115           details.
1116
1117 config TPL_SPI_FLASH_SUPPORT
1118         bool "Support SPI flash drivers"
1119         help
1120           Enable support for using SPI flash in TPL. See SPL_SPI_FLASH_SUPPORT
1121           for details.
1122
1123 config TPL_SPI_LOAD
1124         bool "Support loading from SPI flash"
1125         depends on TPL_SPI_FLASH_SUPPORT
1126         help
1127           Enable support for loading next stage, U-Boot or otherwise, from
1128           SPI NOR in U-Boot TPL.
1129
1130 config TPL_SPI_SUPPORT
1131         bool "Support SPI drivers"
1132         help
1133           Enable support for using SPI in TPL. See SPL_SPI_SUPPORT for
1134           details.
1135
1136 config TPL_YMODEM_SUPPORT
1137         bool "Support loading using Ymodem"
1138         depends on TPL_SERIAL_SUPPORT
1139         help
1140           While loading from serial is slow it can be a useful backup when
1141           there is no other option. The Ymodem protocol provides a reliable
1142           means of transmitting U-Boot over a serial line for using in TPL,
1143           with a checksum to ensure correctness.
1144
1145 endif # TPL
1146
1147 endif # SPL
1148 endmenu