9 config SPL_DFU_NO_RESET
14 depends on SUPPORT_SPL
17 If you want to build SPL as well as the normal image, say Y.
20 bool "Support SPL based upon the common SPL framework"
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.
29 int "Maximum size of SPL image"
31 default 69632 if ARCH_MX6
34 Specifies the maximum length of the U-Boot SPL image.
35 If this value is zero, it is ignored.
37 config SPL_SIZE_LIMIT_SUBTRACT_GD
38 bool "SPL image size check: provide space for global data"
39 depends on SPL_SIZE_LIMIT > 0
41 If enabled, aligned size of global data is reserved in
42 SPL_SIZE_LIMIT check to ensure such an image does not overflow SRAM
43 if SPL_SIZE_LIMIT describes the size of SRAM available for SPL when
44 pre-reloc global data is put into this SRAM, too.
46 config SPL_SIZE_LIMIT_SUBTRACT_MALLOC
47 bool "SPL image size check: provide space for malloc() pool before relocation"
48 depends on SPL_SIZE_LIMIT > 0
50 If enabled, SPL_SYS_MALLOC_F_LEN is reserved in SPL_SIZE_LIMIT check
51 to ensure such an image does not overflow SRAM if SPL_SIZE_LIMIT
52 describes the size of SRAM available for SPL when pre-reloc malloc
53 pool is put into this SRAM, too.
55 config SPL_SIZE_LIMIT_PROVIDE_STACK
56 hex "SPL image size check: provide stack space before relocation"
57 depends on SPL_SIZE_LIMIT > 0
60 If set, this size is reserved in SPL_SIZE_LIMIT check to ensure such
61 an image does not overflow SRAM if SPL_SIZE_LIMIT describes the size
62 of SRAM available for SPL when the stack required before reolcation
65 menu "PowerPC SPL Boot options"
66 depends on PPC && (SUPPORT_SPL && !SPL_FRAMEWORK)
69 bool "Load SPL from NAND flash"
72 bool "Load SPL from SD Card / eMMC"
75 bool "Load SPL from SPI flash"
78 bool "Create SPL in Freescale PBI format"
80 Create boot binary having SPL binary in PBI format concatenated with
86 bool "Pass hand-off information from SPL to U-Boot proper"
89 It is useful to be able to pass information from SPL to U-Boot
90 proper to preserve state that is known in SPL and is needed in U-Boot.
91 Enable this to locate the handoff information in U-Boot proper, early
92 in boot. It is available in gd->handoff. The state state is set up
93 in SPL (or TPL if that is being used).
98 bool "Pass hand-off information from SPL to U-Boot proper"
102 This option enables SPL to write handoff information. This can be
103 used to pass information like the size of SDRAM from SPL to U-Boot
104 proper. Also SPL can receive information from TPL in the same place
108 string "Linker script for the SPL stage"
109 default "arch/$(ARCH)/cpu/u-boot-spl.lds"
111 The SPL stage will usually require a different linker-script
112 (as it runs from a different memory region) than the regular
113 U-Boot stage. Set this to the path of the linker-script to
118 default ISW_ENTRY_ADDR if AM43XX || AM33XX || OMAP54XX || ARCH_KEYSTONE
121 The address in memory that SPL will be running from.
123 config SPL_BOARD_INIT
124 bool "Call board-specific initialization in SPL"
126 If this option is enabled, U-Boot will call the function
127 spl_board_init() from board_init_r(). This function should be
128 provided by the board.
130 config SPL_BOOTROM_SUPPORT
131 bool "Support returning to the BOOTROM"
133 Some platforms (e.g. the Rockchip RK3368) provide support in their
134 ROM for loading the next boot-stage after performing basic setup
137 Enable this option, to return to the BOOTROM through the
138 BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
139 boot device list, if not implemented for a given board)
141 config SPL_BOOTCOUNT_LIMIT
142 bool "Support bootcount in SPL"
143 depends on SPL_ENV_SUPPORT
145 On some boards, which use 'falcon' mode, it is necessary to check
146 and increment the number of boot attempts. Such boards do not
147 use proper U-Boot for normal boot flow and hence needs those
148 adjustments to be done in the SPL.
150 config SPL_RAW_IMAGE_SUPPORT
151 bool "Support SPL loading and booting of RAW images"
152 default n if (ARCH_MX6 && (SPL_MMC_SUPPORT || SPL_SATA_SUPPORT))
153 default y if !TI_SECURE_DEVICE
155 SPL will support loading and booting a RAW image when this option
156 is y. If this is not set, SPL will move on to other available
157 boot media to find a suitable image.
159 config SPL_LEGACY_IMAGE_SUPPORT
160 bool "Support SPL loading and booting of Legacy images"
161 default y if !TI_SECURE_DEVICE
163 SPL will support loading and booting Legacy images when this option
164 is y. If this is not set, SPL will move on to other available
165 boot media to find a suitable image.
167 config SPL_LEGACY_IMAGE_CRC_CHECK
168 bool "Check CRC of Legacy images"
169 depends on SPL_LEGACY_IMAGE_SUPPORT
170 select SPL_CRC32_SUPPORT
172 Enable this to check the CRC of Legacy images. While this increases
173 reliability, it affects both code size and boot duration.
174 If disabled, Legacy images are booted if the image magic and size
175 are correct, without further integrity checks.
177 config SPL_SYS_MALLOC_SIMPLE
179 prompt "Only use malloc_simple functions in the SPL"
181 Say Y here to only use the *_simple malloc functions from
182 malloc_simple.c, rather then using the versions from dlmalloc.c;
183 this will make the SPL binary smaller at the cost of more heap
184 usage as the *_simple malloc functions do not re-use free-ed mem.
186 config TPL_SYS_MALLOC_SIMPLE
188 prompt "Only use malloc_simple functions in the TPL"
190 Say Y here to only use the *_simple malloc functions from
191 malloc_simple.c, rather then using the versions from dlmalloc.c;
192 this will make the TPL binary smaller at the cost of more heap
193 usage as the *_simple malloc functions do not re-use free-ed mem.
196 bool "Enable SDRAM location for SPL stack"
198 SPL starts off execution in SRAM and thus typically has only a small
199 stack available. Since SPL sets up DRAM while in its board_init_f()
200 function, it is possible for the stack to move there before
201 board_init_r() is reached. This option enables a special SDRAM
202 location for the SPL stack. U-Boot SPL switches to this after
203 board_init_f() completes, and before board_init_r() starts.
205 config SPL_STACK_R_ADDR
206 depends on SPL_STACK_R
207 hex "SDRAM location for SPL stack"
208 default 0x82000000 if ARCH_OMAP2PLUS
210 Specify the address in SDRAM for the SPL stack. This will be set up
211 before board_init_r() is called.
213 config SPL_STACK_R_MALLOC_SIMPLE_LEN
214 depends on SPL_STACK_R && SPL_SYS_MALLOC_SIMPLE
215 hex "Size of malloc_simple heap after switching to DRAM SPL stack"
218 Specify the amount of the stack to use as memory pool for
219 malloc_simple after switching the stack to DRAM. This may be set
220 to give board_init_r() a larger heap then the initial heap in
221 SRAM which is limited to SYS_MALLOC_F_LEN bytes.
223 config SPL_SEPARATE_BSS
224 bool "BSS section is in a different memory region from text"
226 Some platforms need a large BSS region in SPL and can provide this
227 because RAM is already set up. In this case BSS can be moved to RAM.
228 This option should then be enabled so that the correct device tree
229 location is used. Normally we put the device tree at the end of BSS
230 but with this option enabled, it goes at _image_binary_end.
232 config SPL_BANNER_PRINT
233 bool "Enable output of the SPL banner 'U-Boot SPL ...'"
236 If this option is enabled, SPL will print the banner with version
237 info. Disabling this option could be useful to reduce TPL boot time
238 (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
240 config TPL_BANNER_PRINT
241 bool "Enable output of the TPL banner 'U-Boot TPL ...'"
244 If this option is enabled, SPL will not print the banner with version
245 info. Disabling this option could be useful to reduce SPL boot time
246 (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
248 config SPL_DISPLAY_PRINT
249 bool "Display a board-specific message in SPL"
251 If this option is enabled, U-Boot will call the function
252 spl_display_print() immediately after displaying the SPL console
253 banner ("U-Boot SPL ..."). This function should be provided by
256 config SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
257 bool "MMC raw mode: by sector"
258 default y if ARCH_SUNXI || ARCH_DAVINCI || ARCH_UNIPHIER || \
259 ARCH_MX6 || ARCH_MX7 || \
260 ARCH_ROCKCHIP || ARCH_MVEBU || ARCH_SOCFPGA || \
261 ARCH_AT91 || ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || \
262 OMAP44XX || OMAP54XX || AM33XX || AM43XX
264 Use sector number for specifying U-Boot location on MMC/SD in
267 config SYS_MMCSD_RAW_MODE_U_BOOT_SECTOR
268 hex "Address on the MMC to load U-Boot from"
269 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
270 default 0x50 if ARCH_SUNXI
271 default 0x75 if ARCH_DAVINCI
272 default 0x8a if ARCH_MX6 || ARCH_MX7
273 default 0x100 if ARCH_UNIPHIER
274 default 0x140 if ARCH_MVEBU
275 default 0x200 if ARCH_SOCFPGA || ARCH_AT91
276 default 0x300 if ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || OMAP44XX || \
277 OMAP54XX || AM33XX || AM43XX || ARCH_K3
278 default 0x4000 if ARCH_ROCKCHIP
280 Address on the MMC to load U-Boot from, when the MMC is being used
281 in raw mode. Units: MMC sectors (1 sector = 512 bytes).
283 config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
284 bool "MMC Raw mode: by partition"
286 Use a partition for loading U-Boot when using MMC/SD in raw mode.
288 config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION
289 hex "Partition to use to load U-Boot from"
290 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
293 Partition on the MMC to load U-Boot from when the MMC is being
296 config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
297 bool "MMC raw mode: by partition type"
298 depends on DOS_PARTITION && SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
300 Use partition type for specifying U-Boot partition on MMC/SD in
301 raw mode. U-Boot will be loaded from the first partition of this
304 config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION_TYPE
305 hex "Partition Type on the MMC to load U-Boot from"
306 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
308 Partition Type on the MMC to load U-Boot from, when the MMC is being
311 config SPL_CRC32_SUPPORT
313 default y if SPL_LEGACY_IMAGE_SUPPORT
315 Enable this to support CRC32 in uImages or FIT images within SPL.
316 This is a 32-bit checksum value that can be used to verify images.
317 For FIT images, this is the least secure type of checksum, suitable
318 for detected accidental image corruption. For secure applications you
319 should consider SHA1 or SHA256.
321 config SPL_MD5_SUPPORT
325 Enable this to support MD5 in FIT images within SPL. An MD5
326 checksum is a 128-bit hash value used to check that the image
327 contents have not been corrupted. Note that MD5 is not considered
328 secure as it is possible (with a brute-force attack) to adjust the
329 image while still retaining the same MD5 hash value. For secure
330 applications where images may be changed maliciously, you should
331 consider SHA1 or SHA256.
333 config SPL_SHA1_SUPPORT
338 Enable this to support SHA1 in FIT images within SPL. A SHA1
339 checksum is a 160-bit (20-byte) hash value used to check that the
340 image contents have not been corrupted or maliciously altered.
341 While SHA1 is fairly secure it is coming to the end of its life
342 due to the expanding computing power available to brute-force
343 attacks. For more security, consider SHA256.
345 config SPL_SHA256_SUPPORT
346 bool "Support SHA256"
350 Enable this to support SHA256 in FIT images within SPL. A SHA256
351 checksum is a 256-bit (32-byte) hash value used to check that the
352 image contents have not been corrupted. SHA256 is recommended for
353 use in secure applications since (as at 2016) there is no known
354 feasible attack that could produce a 'collision' with differing
355 input data. Use this for the highest security. Note that only the
356 SHA256 variant is supported: SHA512 and others are not currently
359 config SPL_FIT_IMAGE_TINY
360 bool "Remove functionality from SPL FIT loading to reduce size"
362 default y if MACH_SUN50I || MACH_SUN50I_H5 || MACH_SUN50I_H6
363 default y if ARCH_IMX8M
365 Enable this to reduce the size of the FIT image loading code
366 in SPL, if space for the SPL binary is very tight.
368 This removes the detection of image types (which forces the
369 first image to be treated as having a U-Boot style calling
370 convention) and skips the recording of each loaded payload
371 (i.e. loadable) into the FDT (modifying the loaded FDT to
372 ensure this information is available to the next image
375 config SPL_CPU_SUPPORT
376 bool "Support CPU drivers"
378 Enable this to support CPU drivers in SPL. These drivers can set
379 up CPUs and provide information about them such as the model and
380 name. This can be useful in SPL since setting up the CPUs earlier
381 may improve boot performance. Enable this option to build the
382 drivers in drivers/cpu as part of an SPL build.
384 config SPL_CRYPTO_SUPPORT
385 bool "Support crypto drivers"
387 Enable crypto drivers in SPL. These drivers can be used to
388 accelerate secure boot processing in secure applications. Enable
389 this option to build the drivers in drivers/crypto as part of an
392 config SPL_HASH_SUPPORT
393 bool "Support hashing drivers"
397 Enable hashing drivers in SPL. These drivers can be used to
398 accelerate secure boot processing in secure applications. Enable
399 this option to build system-specific drivers for hash acceleration
400 as part of an SPL build.
402 config TPL_HASH_SUPPORT
403 bool "Support hashing drivers in TPL"
407 Enable hashing drivers in SPL. These drivers can be used to
408 accelerate secure boot processing in secure applications. Enable
409 this option to build system-specific drivers for hash acceleration
410 as part of an SPL build.
412 config SPL_DMA_SUPPORT
413 bool "Support DMA drivers"
415 Enable DMA (direct-memory-access) drivers in SPL. These drivers
416 can be used to handle memory-to-peripheral data transfer without
417 the CPU moving the data. Enable this option to build the drivers
418 in drivers/dma as part of an SPL build.
420 config SPL_DRIVERS_MISC_SUPPORT
421 bool "Support misc drivers"
423 Enable miscellaneous drivers in SPL. These drivers perform various
424 tasks that don't fall nicely into other categories, Enable this
425 option to build the drivers in drivers/misc as part of an SPL
426 build, for those that support building in SPL (not all drivers do).
428 config SPL_ENV_SUPPORT
429 bool "Support an environment"
431 Enable environment support in SPL. The U-Boot environment provides
432 a number of settings (essentially name/value pairs) which can
433 control many aspects of U-Boot's operation. Normally this is not
434 needed in SPL as it has a much simpler task with less
435 configuration. But some boards use this to support 'Falcon' boot
436 on EXT2 and FAT, where SPL boots directly into Linux without
437 starting U-Boot first. Enabling this option will make env_get()
438 and env_set() available in SPL.
441 bool "Support save environment"
442 depends on SPL_ENV_SUPPORT
443 select SPL_MMC_WRITE if ENV_IS_IN_MMC
445 Enable save environment support in SPL after setenv. By default
446 the saveenv option is not provided in SPL, but some boards need
447 this support in 'Falcon' boot, where SPL need to boot from
448 different images based on environment variable set by OS. For
449 example OS may set "reboot_image" environment variable to
450 "recovery" inorder to boot recovery image by SPL. The SPL read
451 "reboot_image" and act accordingly and change the reboot_image
452 to default mode using setenv and save the environment.
454 config SPL_ETH_SUPPORT
455 bool "Support Ethernet"
456 depends on SPL_ENV_SUPPORT
458 Enable access to the network subsystem and associated Ethernet
459 drivers in SPL. This permits SPL to load U-Boot over an Ethernet
460 link rather than from an on-board peripheral. Environment support
461 is required since the network stack uses a number of environment
462 variables. See also SPL_NET_SUPPORT.
465 bool "Support EXT filesystems"
467 Enable support for EXT2/3/4 filesystems with SPL. This permits
468 U-Boot (or Linux in Falcon mode) to be loaded from an EXT
469 filesystem from within SPL. Support for the underlying block
470 device (e.g. MMC or USB) must be enabled separately.
473 bool "Support FAT filesystems"
476 Enable support for FAT and VFAT filesystems with SPL. This
477 permits U-Boot (or Linux in Falcon mode) to be loaded from a FAT
478 filesystem from within SPL. Support for the underlying block
479 device (e.g. MMC or USB) must be enabled separately.
482 bool "Support write for FAT filesystems"
484 Enable write support for FAT and VFAT filesystems with SPL.
485 Support for the underlying block device (e.g. MMC or USB) must be
488 config SPL_FPGA_SUPPORT
491 Enable support for FPGAs in SPL. Field-programmable Gate Arrays
492 provide software-configurable hardware which is typically used to
493 implement peripherals (such as UARTs, LCD displays, MMC) or
494 accelerate custom processing functions, such as image processing
495 or machine learning. Sometimes it is useful to program the FPGA
496 as early as possible during boot, and this option can enable that
499 config SPL_GPIO_SUPPORT
500 bool "Support GPIO in SPL"
502 Enable support for GPIOs (General-purpose Input/Output) in SPL.
503 GPIOs allow U-Boot to read the state of an input line (high or
504 low) and set the state of an output line. This can be used to
505 drive LEDs, control power to various system parts and read user
506 input. GPIOs can be useful in SPL to enable a 'sign-of-life' LED,
507 for example. Enable this option to build the drivers in
508 drivers/gpio as part of an SPL build.
510 config SPL_I2C_SUPPORT
513 Enable support for the I2C (Inter-Integrated Circuit) bus in SPL.
514 I2C works with a clock and data line which can be driven by a
515 one or more masters or slaves. It is a fairly complex bus but is
516 widely used as it only needs two lines for communication. Speeds of
517 400kbps are typical but up to 3.4Mbps is supported by some
518 hardware. I2C can be useful in SPL to configure power management
519 ICs (PMICs) before raising the CPU clock speed, for example.
520 Enable this option to build the drivers in drivers/i2c as part of
523 config SPL_LIBCOMMON_SUPPORT
524 bool "Support common libraries"
526 Enable support for common U-Boot libraries within SPL. These
527 libraries include common code to deal with U-Boot images,
528 environment and USB, for example. This option is enabled on many
529 boards. Enable this option to build the code in common/ as part of
532 config SPL_LIBDISK_SUPPORT
533 bool "Support disk partitions"
536 Enable support for disk partitions within SPL. 'Disk' is something
537 of a misnomer as it includes non-spinning media such as flash (as
538 used in MMC and USB sticks). Partitions provide a way for a disk
539 to be split up into separate regions, with a partition table placed
540 at the start or end which describes the location and size of each
541 'partition'. These partitions are typically uses as individual block
542 devices, typically with an EXT2 or FAT filesystem in each. This
543 option enables whatever partition support has been enabled in
544 U-Boot to also be used in SPL. It brings in the code in disk/.
546 config SPL_LIBGENERIC_SUPPORT
547 bool "Support generic libraries"
549 Enable support for generic U-Boot libraries within SPL. These
550 libraries include generic code to deal with device tree, hashing,
551 printf(), compression and the like. This option is enabled on many
552 boards. Enable this option to build the code in lib/ as part of an
555 config SPL_DM_MAILBOX
556 bool "Support Mailbox"
558 Enable support for Mailbox within SPL. This enable the inter
559 processor communication protocols tobe used within SPL. Enable
560 this option to build the drivers in drivers/mailbox as part of
563 config SPL_MMC_SUPPORT
566 select HAVE_BLOCK_DEVICE
568 Enable support for MMC (Multimedia Card) within SPL. This enables
569 the MMC protocol implementation and allows any enabled drivers to
570 be used within SPL. MMC can be used with or without disk partition
571 support depending on the application (SPL_LIBDISK_SUPPORT). Enable
572 this option to build the drivers in drivers/mmc as part of an SPL
576 bool "MMC/SD/SDIO card support for write operations in SPL"
577 depends on SPL_MMC_SUPPORT
580 Enable write access to MMC and SD Cards in SPL
583 config SPL_MPC8XXX_INIT_DDR_SUPPORT
584 bool "Support MPC8XXX DDR init"
586 Enable support for DDR-SDRAM (double-data-rate synchronous dynamic
587 random-access memory) on the MPC8XXX family within SPL. This
588 allows DRAM to be set up before loading U-Boot into that DRAM,
591 config SPL_MTD_SUPPORT
592 bool "Support MTD drivers"
594 Enable support for MTD (Memory Technology Device) within SPL. MTD
595 provides a block interface over raw NAND and can also be used with
596 SPI flash. This allows SPL to load U-Boot from supported MTD
597 devices. See SPL_NAND_SUPPORT and SPL_ONENAND_SUPPORT for how
598 to enable specific MTD drivers.
600 config SPL_MUSB_NEW_SUPPORT
601 bool "Support new Mentor Graphics USB"
603 Enable support for Mentor Graphics USB in SPL. This is a new
604 driver used by some boards. Enable this option to build
605 the drivers in drivers/usb/musb-new as part of an SPL build. The
606 old drivers are in drivers/usb/musb.
608 config SPL_NAND_SUPPORT
609 bool "Support NAND flash"
611 Enable support for NAND (Negative AND) flash in SPL. NAND flash
612 can be used to allow SPL to load U-Boot from supported devices.
613 This enables the drivers in drivers/mtd/nand/raw as part of an SPL
616 config SPL_NET_SUPPORT
617 bool "Support networking"
619 Enable support for network devices (such as Ethernet) in SPL.
620 This permits SPL to load U-Boot over a network link rather than
621 from an on-board peripheral. Environment support is required since
622 the network stack uses a number of environment variables. See also
626 config SPL_NET_VCI_STRING
627 string "BOOTP Vendor Class Identifier string sent by SPL"
629 As defined by RFC 2132 the vendor class identifier field can be
630 sent by the client to identify the vendor type and configuration
631 of a client. This is often used in practice to allow for the DHCP
632 server to specify different files to load depending on if the ROM,
633 SPL or U-Boot itself makes the request
634 endif # if SPL_NET_SUPPORT
636 config SPL_NO_CPU_SUPPORT
637 bool "Drop CPU code in SPL"
639 This is specific to the ARM926EJ-S CPU. It disables the standard
640 start.S start-up code, presumably so that a replacement can be
641 used on that CPU. You should not enable it unless you know what
644 config SPL_NOR_SUPPORT
645 bool "Support NOR flash"
647 Enable support for loading U-Boot from memory-mapped NOR (Negative
648 OR) flash in SPL. NOR flash is slow to write but fast to read, and
649 a memory-mapped device makes it very easy to access. Loading from
650 NOR is typically achieved with just a memcpy().
652 config SPL_XIP_SUPPORT
656 Enable support for execute in place of U-Boot or kernel image. There
657 is no need to copy image from flash to ram if flash supports execute
658 in place. Its very useful in systems having enough flash but not
659 enough ram to load the image.
661 config SPL_ONENAND_SUPPORT
662 bool "Support OneNAND flash"
664 Enable support for OneNAND (Negative AND) flash in SPL. OneNAND is
665 a type of NAND flash and therefore can be used to allow SPL to
666 load U-Boot from supported devices. This enables the drivers in
667 drivers/mtd/onenand as part of an SPL build.
670 bool "Activate Falcon Mode"
671 depends on !TI_SECURE_DEVICE
674 Enable booting directly to an OS from SPL.
675 for more info read doc/README.falcon
679 hex "addr, where OS is found"
680 depends on SPL_NOR_SUPPORT
682 Specify the address, where the OS image is found, which
689 default "tpl/u-boot-with-tpl.bin" if TPL
692 Payload for SPL boot. For backward compatibility, default to
693 u-boot.bin, i.e. RAW image without any header. In case of
694 TPL, tpl/u-boot-with-tpl.bin. For new boards, suggest to
698 bool "Support PCI drivers"
700 Enable support for PCI in SPL. For platforms that need PCI to boot,
701 or must perform some init using PCI in SPL, this provides the
702 necessary driver support. This enables the drivers in drivers/pci
703 as part of an SPL build.
705 config SPL_PCH_SUPPORT
706 bool "Support PCH drivers"
708 Enable support for PCH (Platform Controller Hub) devices in SPL.
709 These are used to set up GPIOs and the SPI peripheral early in
710 boot. This enables the drivers in drivers/pch as part of an SPL
713 config SPL_POST_MEM_SUPPORT
714 bool "Support POST drivers"
716 Enable support for POST (Power-on Self Test) in SPL. POST is a
717 procedure that checks that the hardware (CPU or board) appears to
718 be functionally correctly. It is a sanity check that can be
719 performed before booting. This enables the drivers in post/drivers
720 as part of an SPL build.
723 bool "Support reset drivers"
726 Enable support for reset control in SPL.
727 That can be useful in SPL to handle IP reset in driver, as in U-Boot,
728 by using the generic reset API provided by driver model.
729 This enables the drivers in drivers/reset as part of an SPL build.
731 config SPL_POWER_SUPPORT
732 bool "Support power drivers"
734 Enable support for power control in SPL. This includes support
735 for PMICs (Power-management Integrated Circuits) and some of the
736 features provided by PMICs. In particular, voltage regulators can
737 be used to enable/disable power and vary its voltage. That can be
738 useful in SPL to turn on boot peripherals and adjust CPU voltage
739 so that the clock speed can be increased. This enables the drivers
740 in drivers/power, drivers/power/pmic and drivers/power/regulator
741 as part of an SPL build.
743 config SPL_POWER_DOMAIN
744 bool "Support power domain drivers"
746 Enable support for power domain control in SPL. Many SoCs allow
747 power to be applied to or removed from portions of the SoC (power
748 domains). This may be used to save power. This API provides the
749 means to control such power management hardware. This enables
750 the drivers in drivers/power/domain as part of a SPL build.
752 config SPL_RAM_SUPPORT
753 bool "Support booting from RAM"
754 default y if MICROBLAZE || ARCH_SOCFPGA || TEGRA || ARCH_ZYNQ
756 Enable booting of an image in RAM. The image can be preloaded or
757 it can be loaded by SPL directly into RAM (e.g. using USB).
759 config SPL_RAM_DEVICE
760 bool "Support booting from preloaded image in RAM"
761 depends on SPL_RAM_SUPPORT
762 default y if MICROBLAZE || ARCH_SOCFPGA || TEGRA || ARCH_ZYNQ
764 Enable booting of an image already loaded in RAM. The image has to
765 be already in memory when SPL takes over, e.g. loaded by the boot
768 config SPL_REMOTEPROC
769 bool "Support REMOTEPROCS"
771 Enable support for REMOTEPROCs in SPL. This permits to load
772 a remote processor firmware in SPL.
774 config SPL_RTC_SUPPORT
775 bool "Support RTC drivers"
777 Enable RTC (Real-time Clock) support in SPL. This includes support
778 for reading and setting the time. Some RTC devices also have some
779 non-volatile (battery-backed) memory which is accessible if
780 needed. This enables the drivers in drivers/rtc as part of an SPL
783 config SPL_SATA_SUPPORT
784 bool "Support loading from SATA"
786 Enable support for SATA (Serial AT attachment) in SPL. This allows
787 use of SATA devices such as hard drives and flash drivers for
788 loading U-Boot. SATA is used in higher-end embedded systems and
789 can provide higher performance than MMC , at somewhat higher
790 expense and power consumption. This enables loading from SATA
791 using a configured device.
793 config SPL_SERIAL_SUPPORT
794 bool "Support serial"
798 Enable support for serial in SPL. This allows use of a serial UART
799 for displaying messages while SPL is running. It also brings in
800 printf() and panic() functions. This should normally be enabled
801 unless there are space reasons not to. Even then, consider
802 enabling USE_TINY_PRINTF which is a small printf() version.
804 config SPL_SPI_FLASH_SUPPORT
805 bool "Support SPI flash drivers"
807 Enable support for using SPI flash in SPL, and loading U-Boot from
808 SPI flash. SPI flash (Serial Peripheral Bus flash) is named after
809 the SPI bus that is used to connect it to a system. It is a simple
810 but fast bidirectional 4-wire bus (clock, chip select and two data
811 lines). This enables the drivers in drivers/mtd/spi as part of an
812 SPL build. This normally requires SPL_SPI_SUPPORT.
814 if SPL_SPI_FLASH_SUPPORT
816 config SPL_SPI_FLASH_TINY
817 bool "Enable low footprint SPL SPI Flash support"
818 depends on !SPI_FLASH_BAR
819 default y if SPI_FLASH
821 Enable lightweight SPL SPI Flash support that supports just reading
822 data/images from flash. No support to write/erase flash. Enable
823 this if you have SPL size limitations and don't need full
824 fledged SPI flash support.
826 config SPL_SPI_FLASH_SFDP_SUPPORT
827 bool "SFDP table parsing support for SPI NOR flashes"
828 depends on !SPI_FLASH_BAR && !SPL_SPI_FLASH_TINY
830 Enable support for parsing and auto discovery of parameters for
831 SPI NOR flashes using Serial Flash Discoverable Parameters (SFDP)
832 tables as per JESD216 standard in SPL.
835 bool "Support loading from SPI flash"
837 Enable support for loading next stage, U-Boot or otherwise, from
838 SPI NOR in U-Boot SPL.
840 endif # SPL_SPI_FLASH_SUPPORT
842 config SPL_SPI_SUPPORT
843 bool "Support SPI drivers"
845 Enable support for using SPI in SPL. This is used for connecting
846 to SPI flash for loading U-Boot. See SPL_SPI_FLASH_SUPPORT for
847 more details on that. The SPI driver provides the transport for
848 data between the SPI flash and the CPU. This option can be used to
849 enable SPI drivers that are needed for other purposes also, such
853 bool "Driver support for thermal devices"
855 Enable support for temperature-sensing devices. Some SoCs have on-chip
856 temperature sensors to permit warnings, speed throttling or even
857 automatic power-off when the temperature gets too high or low. Other
858 devices may be discrete but connected on a suitable bus.
860 config SPL_USB_HOST_SUPPORT
861 bool "Support USB host drivers"
862 select HAVE_BLOCK_DEVICE
864 Enable access to USB (Universal Serial Bus) host devices so that
865 SPL can load U-Boot from a connected USB peripheral, such as a USB
866 flash stick. While USB takes a little longer to start up than most
867 buses, it is very flexible since many different types of storage
868 device can be attached. This option enables the drivers in
869 drivers/usb/host as part of an SPL build.
871 config SPL_USB_STORAGE
872 bool "Support loading from USB"
873 depends on SPL_USB_HOST_SUPPORT && !(BLK && !DM_USB)
875 Enable support for USB devices in SPL. This allows use of USB
876 devices such as hard drives and flash drivers for loading U-Boot.
877 The actual drivers are enabled separately using the normal U-Boot
878 config options. This enables loading from USB using a configured
881 config SPL_USB_GADGET
882 bool "Suppport USB Gadget drivers"
884 Enable USB Gadget API which allows to enable USB device functions
890 bool "Support USB Ethernet drivers"
892 Enable access to the USB network subsystem and associated
893 drivers in SPL. This permits SPL to load U-Boot over a
894 USB-connected Ethernet link (such as a USB Ethernet dongle) rather
895 than from an onboard peripheral. Environment support is required
896 since the network stack uses a number of environment variables.
897 See also SPL_NET_SUPPORT and SPL_ETH_SUPPORT.
900 bool "Support DFU (Device Firmware Upgrade)"
901 select SPL_HASH_SUPPORT
902 select SPL_DFU_NO_RESET
903 depends on SPL_RAM_SUPPORT
905 This feature enables the DFU (Device Firmware Upgrade) in SPL with
906 RAM memory device support. The ROM code will load and execute
907 the SPL built with dfu. The user can load binaries (u-boot/kernel) to
908 selected device partition from host-pc using dfu-utils.
909 This feature is useful to flash the binaries to factory or bare-metal
910 boards using USB interface.
913 bool "DFU device selection"
918 depends on SPL_DFU && SPL_RAM_SUPPORT
920 select RAM/DDR memory device for loading binary images
921 (u-boot/kernel) to the selected device partition using
922 DFU and execute the u-boot/kernel from RAM.
926 config SPL_USB_SDP_SUPPORT
927 bool "Support SDP (Serial Download Protocol)"
929 Enable Serial Download Protocol (SDP) device support in SPL. This
930 allows to download images into memory and execute (jump to) them
931 using the same protocol as implemented by the i.MX family's boot ROM.
934 config SPL_WATCHDOG_SUPPORT
935 bool "Support watchdog drivers"
937 Enable support for watchdog drivers in SPL. A watchdog is
938 typically a hardware peripheral which can reset the system when it
939 detects no activity for a while (such as a software crash). This
940 enables the drivers in drivers/watchdog as part of an SPL build.
942 config SPL_YMODEM_SUPPORT
943 bool "Support loading using Ymodem"
944 depends on SPL_SERIAL_SUPPORT
946 While loading from serial is slow it can be a useful backup when
947 there is no other option. The Ymodem protocol provides a reliable
948 means of transmitting U-Boot over a serial line for using in SPL,
949 with a checksum to ensure correctness.
952 bool "Support ARM Trusted Firmware"
955 ATF(ARM Trusted Firmware) is a component for ARM AArch64 which
956 is loaded by SPL (which is considered as BL2 in ATF terminology).
957 More detail at: https://github.com/ARM-software/arm-trusted-firmware
959 config SPL_ATF_NO_PLATFORM_PARAM
960 bool "Pass no platform parameter"
963 While we expect to call a pointer to a valid FDT (or NULL)
964 as the platform parameter to an ATF, some ATF versions are
965 not U-Boot aware and have an insufficiently robust parameter
966 validation to gracefully reject a FDT being passed.
968 If this option is enabled, the spl_atf os-type handler will
969 always pass NULL for the platform parameter.
971 If your ATF is affected, say Y.
973 config SPL_AM33XX_ENABLE_RTC32K_OSC
974 bool "Enable the RTC32K OSC on AM33xx based platforms"
977 Enable access to the AM33xx RTC and select the external 32kHz clock
981 bool "Support OP-TEE Trusted OS"
984 OP-TEE is an open source Trusted OS which is loaded by SPL.
985 More detail at: https://github.com/OP-TEE/optee_os
989 depends on SUPPORT_TPL
992 If you want to build TPL as well as the normal image and SPL, say Y.
997 bool "Pass hand-off information from TPL to SPL and U-Boot proper"
1001 This option enables TPL to write handoff information. This can be
1002 used to pass information like the size of SDRAM from TPL to U-Boot
1003 proper. The information is also available to SPL if it is useful
1006 config TPL_BOARD_INIT
1007 bool "Call board-specific initialization in TPL"
1009 If this option is enabled, U-Boot will call the function
1010 spl_board_init() from board_init_r(). This function should be
1011 provided by the board.
1014 string "Linker script for the TPL stage"
1016 default "arch/arm/cpu/armv8/u-boot-spl.lds" if ARM64
1017 default "arch/$(ARCH)/cpu/u-boot-spl.lds"
1019 The TPL stage will usually require a different linker-script
1020 (as it runs from a different memory region) than the regular
1021 U-Boot stage. Set this to the path of the linker-script to
1024 May be left empty to trigger the Makefile infrastructure to
1025 fall back to the linker-script used for the SPL stage.
1027 config TPL_NEEDS_SEPARATE_TEXT_BASE
1028 bool "TPL needs a separate text-base"
1032 Enable, if the TPL stage should not inherit its text-base
1033 from the SPL stage. When enabled, a base address for the
1034 .text sections of the TPL stage has to be set below.
1036 config TPL_NEEDS_SEPARATE_STACK
1037 bool "TPL needs a separate initial stack-pointer"
1041 Enable, if the TPL stage should not inherit its initial
1042 stack-pointer from the settings for the SPL stage.
1044 config TPL_TEXT_BASE
1045 hex "Base address for the .text section of the TPL stage"
1046 depends on TPL_NEEDS_SEPARATE_TEXT_BASE
1048 The base address for the .text section of the TPL stage.
1051 int "Maximum size (in bytes) for the TPL stage"
1055 The maximum size (in bytes) of the TPL stage.
1058 hex "Address of the initial stack-pointer for the TPL stage"
1059 depends on TPL_NEEDS_SEPARATE_STACK
1061 The address of the initial stack-pointer for the TPL stage.
1062 Usually this will be the (aligned) top-of-stack.
1064 config TPL_BOOTROM_SUPPORT
1065 bool "Support returning to the BOOTROM (from TPL)"
1067 Some platforms (e.g. the Rockchip RK3368) provide support in their
1068 ROM for loading the next boot-stage after performing basic setup
1071 Enable this option, to return to the BOOTROM through the
1072 BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
1073 boot device list, if not implemented for a given board)
1075 config TPL_DRIVERS_MISC_SUPPORT
1076 bool "Support misc drivers in TPL"
1078 Enable miscellaneous drivers in TPL. These drivers perform various
1079 tasks that don't fall nicely into other categories, Enable this
1080 option to build the drivers in drivers/misc as part of an TPL
1081 build, for those that support building in TPL (not all drivers do).
1083 config TPL_ENV_SUPPORT
1084 bool "Support an environment"
1086 Enable environment support in TPL. See SPL_ENV_SUPPORT for details.
1088 config TPL_GPIO_SUPPORT
1089 bool "Support GPIO in TPL"
1091 Enable support for GPIOs (General-purpose Input/Output) in TPL.
1092 GPIOs allow U-Boot to read the state of an input line (high or
1093 low) and set the state of an output line. This can be used to
1094 drive LEDs, control power to various system parts and read user
1095 input. GPIOs can be useful in TPL to enable a 'sign-of-life' LED,
1096 for example. Enable this option to build the drivers in
1097 drivers/gpio as part of an TPL build.
1099 config TPL_I2C_SUPPORT
1102 Enable support for the I2C bus in TPL. See SPL_I2C_SUPPORT for
1105 config TPL_LIBCOMMON_SUPPORT
1106 bool "Support common libraries"
1108 Enable support for common U-Boot libraries within TPL. See
1109 SPL_LIBCOMMON_SUPPORT for details.
1111 config TPL_LIBGENERIC_SUPPORT
1112 bool "Support generic libraries"
1114 Enable support for generic U-Boot libraries within TPL. See
1115 SPL_LIBGENERIC_SUPPORT for details.
1117 config TPL_MPC8XXX_INIT_DDR_SUPPORT
1118 bool "Support MPC8XXX DDR init"
1120 Enable support for DDR-SDRAM on the MPC8XXX family within TPL. See
1121 SPL_MPC8XXX_INIT_DDR_SUPPORT for details.
1123 config TPL_MMC_SUPPORT
1127 Enable support for MMC within TPL. See SPL_MMC_SUPPORT for details.
1129 config TPL_NAND_SUPPORT
1130 bool "Support NAND flash"
1132 Enable support for NAND in TPL. See SPL_NAND_SUPPORT for details.
1135 bool "Support PCI drivers"
1137 Enable support for PCI in TPL. For platforms that need PCI to boot,
1138 or must perform some init using PCI in SPL, this provides the
1139 necessary driver support. This enables the drivers in drivers/pci
1140 as part of a TPL build.
1142 config TPL_PCH_SUPPORT
1143 bool "Support PCH drivers"
1145 Enable support for PCH (Platform Controller Hub) devices in TPL.
1146 These are used to set up GPIOs and the SPI peripheral early in
1147 boot. This enables the drivers in drivers/pch as part of a TPL
1150 config TPL_RAM_SUPPORT
1151 bool "Support booting from RAM"
1153 Enable booting of an image in RAM. The image can be preloaded or
1154 it can be loaded by TPL directly into RAM (e.g. using USB).
1156 config TPL_RAM_DEVICE
1157 bool "Support booting from preloaded image in RAM"
1158 depends on TPL_RAM_SUPPORT
1160 Enable booting of an image already loaded in RAM. The image has to
1161 be already in memory when TPL takes over, e.g. loaded by the boot
1164 config TPL_RTC_SUPPORT
1165 bool "Support RTC drivers"
1167 Enable RTC (Real-time Clock) support in TPL. This includes support
1168 for reading and setting the time. Some RTC devices also have some
1169 non-volatile (battery-backed) memory which is accessible if
1170 needed. This enables the drivers in drivers/rtc as part of an TPL
1173 config TPL_SERIAL_SUPPORT
1174 bool "Support serial"
1178 Enable support for serial in TPL. See SPL_SERIAL_SUPPORT for
1181 config TPL_SPI_FLASH_SUPPORT
1182 bool "Support SPI flash drivers"
1184 Enable support for using SPI flash in TPL. See SPL_SPI_FLASH_SUPPORT
1188 bool "Support loading from SPI flash"
1189 depends on TPL_SPI_FLASH_SUPPORT
1191 Enable support for loading next stage, U-Boot or otherwise, from
1192 SPI NOR in U-Boot TPL.
1194 config TPL_SPI_SUPPORT
1195 bool "Support SPI drivers"
1197 Enable support for using SPI in TPL. See SPL_SPI_SUPPORT for
1200 config TPL_YMODEM_SUPPORT
1201 bool "Support loading using Ymodem"
1202 depends on TPL_SERIAL_SUPPORT
1204 While loading from serial is slow it can be a useful backup when
1205 there is no other option. The Ymodem protocol provides a reliable
1206 means of transmitting U-Boot over a serial line for using in TPL,
1207 with a checksum to ensure correctness.
1211 config SPL_AT91_MCK_BYPASS
1212 bool "Use external clock signal as a source of main clock for AT91 platforms"
1213 depends on ARCH_AT91
1216 Use external 8 to 24 Mhz clock signal as source of main clock instead
1217 of an external crystal oscillator.
1218 This option disables the internal driving on the XOUT pin.
1219 The external source has to provide a stable clock on the XIN pin.
1220 If this option is disabled, the SoC expects a crystal oscillator
1221 that needs driving on both XIN and XOUT lines.