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
619 Enable support for loading payloads from UBI. See
620 README.ubispl for more info.
623 config SPL_UBI_LOAD_BY_VOLNAME
624 bool "Support loading volumes by name"
626 This enables support for loading UBI volumes by name. When this
627 is set, CONFIG_SPL_UBI_LOAD_MONITOR_VOLNAME can be used to
628 configure the volume name from which to load U-Boot.
630 config SPL_UBI_MAX_VOL_LEBS
631 int "Maximum number of LEBs per volume"
634 The maximum number of logical eraseblocks which a static volume
635 to load can contain. Used for sizing the scan data structure.
637 config SPL_UBI_MAX_PEB_SIZE
638 int "Maximum PEB size"
641 The maximum physical erase block size.
643 config SPL_UBI_MAX_PEBS
644 int "Maximum number of PEBs"
647 The maximum physical erase block size. If not overridden by
648 board code, this value will be used as the actual number of PEBs.
650 config SPL_UBI_PEB_OFFSET
651 int "Offset to first UBI PEB"
654 The offset in number of PEBs from the start of flash to the first
655 PEB part of the UBI image.
657 config SPL_UBI_VID_OFFSET
658 int "Offset to VID header"
661 config SPL_UBI_LEB_START
662 int "Offset to LEB in PEB"
665 The offset in bytes to the LEB within a PEB.
667 config SPL_UBI_INFO_ADDR
668 hex "Address to place UBI scan info"
671 Address for ubispl to place the scan info. Read README.ubispl to
672 determine the required size
674 config SPL_UBI_VOL_IDS
675 int "Maximum volume id"
678 The maximum volume id which can be loaded. Used for sizing the
681 config SPL_UBI_LOAD_MONITOR_ID
682 int "id of U-Boot volume"
685 The UBI volume id from which to load U-Boot
687 config SPL_UBI_LOAD_MONITOR_VOLNAME
688 string "volume name of U-Boot volume"
689 depends on SPL_UBI_LOAD_BY_VOLNAME
691 The UBI volume name from which to load U-Boot
693 config SPL_UBI_LOAD_KERNEL_ID
694 int "id of kernel volume"
695 depends on SPL_OS_BOOT && SPL_UBI
697 The UBI volume id from which to load the kernel
699 config SPL_UBI_LOAD_ARGS_ID
700 int "id of kernel args volume"
701 depends on SPL_OS_BOOT && SPL_UBI
703 The UBI volume id from which to load the device tree
708 config SPL_NET_SUPPORT
709 bool "Support networking"
711 Enable support for network devices (such as Ethernet) in SPL.
712 This permits SPL to load U-Boot over a network link rather than
713 from an on-board peripheral. Environment support is required since
714 the network stack uses a number of environment variables. See also
718 config SPL_NET_VCI_STRING
719 string "BOOTP Vendor Class Identifier string sent by SPL"
721 As defined by RFC 2132 the vendor class identifier field can be
722 sent by the client to identify the vendor type and configuration
723 of a client. This is often used in practice to allow for the DHCP
724 server to specify different files to load depending on if the ROM,
725 SPL or U-Boot itself makes the request
726 endif # if SPL_NET_SUPPORT
728 config SPL_NO_CPU_SUPPORT
729 bool "Drop CPU code in SPL"
731 This is specific to the ARM926EJ-S CPU. It disables the standard
732 start.S start-up code, presumably so that a replacement can be
733 used on that CPU. You should not enable it unless you know what
736 config SPL_NOR_SUPPORT
737 bool "Support NOR flash"
739 Enable support for loading U-Boot from memory-mapped NOR (Negative
740 OR) flash in SPL. NOR flash is slow to write but fast to read, and
741 a memory-mapped device makes it very easy to access. Loading from
742 NOR is typically achieved with just a memcpy().
744 config SPL_XIP_SUPPORT
748 Enable support for execute in place of U-Boot or kernel image. There
749 is no need to copy image from flash to ram if flash supports execute
750 in place. Its very useful in systems having enough flash but not
751 enough ram to load the image.
753 config SPL_ONENAND_SUPPORT
754 bool "Support OneNAND flash"
756 Enable support for OneNAND (Negative AND) flash in SPL. OneNAND is
757 a type of NAND flash and therefore can be used to allow SPL to
758 load U-Boot from supported devices. This enables the drivers in
759 drivers/mtd/onenand as part of an SPL build.
762 bool "Activate Falcon Mode"
763 depends on !TI_SECURE_DEVICE
766 Enable booting directly to an OS from SPL.
767 for more info read doc/README.falcon
771 hex "addr, where OS is found"
772 depends on SPL_NOR_SUPPORT
774 Specify the address, where the OS image is found, which
781 default "tpl/u-boot-with-tpl.bin" if TPL
784 Payload for SPL boot. For backward compatibility, default to
785 u-boot.bin, i.e. RAW image without any header. In case of
786 TPL, tpl/u-boot-with-tpl.bin. For new boards, suggest to
790 bool "Support PCI drivers"
792 Enable support for PCI in SPL. For platforms that need PCI to boot,
793 or must perform some init using PCI in SPL, this provides the
794 necessary driver support. This enables the drivers in drivers/pci
795 as part of an SPL build.
797 config SPL_PCH_SUPPORT
798 bool "Support PCH drivers"
800 Enable support for PCH (Platform Controller Hub) devices in SPL.
801 These are used to set up GPIOs and the SPI peripheral early in
802 boot. This enables the drivers in drivers/pch as part of an SPL
805 config SPL_POST_MEM_SUPPORT
806 bool "Support POST drivers"
808 Enable support for POST (Power-on Self Test) in SPL. POST is a
809 procedure that checks that the hardware (CPU or board) appears to
810 be functionally correctly. It is a sanity check that can be
811 performed before booting. This enables the drivers in post/drivers
812 as part of an SPL build.
815 bool "Support reset drivers"
818 Enable support for reset control in SPL.
819 That can be useful in SPL to handle IP reset in driver, as in U-Boot,
820 by using the generic reset API provided by driver model.
821 This enables the drivers in drivers/reset as part of an SPL build.
823 config SPL_POWER_SUPPORT
824 bool "Support power drivers"
826 Enable support for power control in SPL. This includes support
827 for PMICs (Power-management Integrated Circuits) and some of the
828 features provided by PMICs. In particular, voltage regulators can
829 be used to enable/disable power and vary its voltage. That can be
830 useful in SPL to turn on boot peripherals and adjust CPU voltage
831 so that the clock speed can be increased. This enables the drivers
832 in drivers/power, drivers/power/pmic and drivers/power/regulator
833 as part of an SPL build.
835 config SPL_POWER_DOMAIN
836 bool "Support power domain drivers"
838 Enable support for power domain control in SPL. Many SoCs allow
839 power to be applied to or removed from portions of the SoC (power
840 domains). This may be used to save power. This API provides the
841 means to control such power management hardware. This enables
842 the drivers in drivers/power/domain as part of a SPL build.
844 config SPL_RAM_SUPPORT
845 bool "Support booting from RAM"
846 default y if MICROBLAZE || ARCH_SOCFPGA || TEGRA || ARCH_ZYNQ
848 Enable booting of an image in RAM. The image can be preloaded or
849 it can be loaded by SPL directly into RAM (e.g. using USB).
851 config SPL_RAM_DEVICE
852 bool "Support booting from preloaded image in RAM"
853 depends on SPL_RAM_SUPPORT
854 default y if MICROBLAZE || ARCH_SOCFPGA || TEGRA || ARCH_ZYNQ
856 Enable booting of an image already loaded in RAM. The image has to
857 be already in memory when SPL takes over, e.g. loaded by the boot
860 config SPL_REMOTEPROC
861 bool "Support REMOTEPROCS"
863 Enable support for REMOTEPROCs in SPL. This permits to load
864 a remote processor firmware in SPL.
866 config SPL_RTC_SUPPORT
867 bool "Support RTC drivers"
869 Enable RTC (Real-time Clock) support in SPL. This includes support
870 for reading and setting the time. Some RTC devices also have some
871 non-volatile (battery-backed) memory which is accessible if
872 needed. This enables the drivers in drivers/rtc as part of an SPL
875 config SPL_SATA_SUPPORT
876 bool "Support loading from SATA"
878 Enable support for SATA (Serial AT attachment) in SPL. This allows
879 use of SATA devices such as hard drives and flash drivers for
880 loading U-Boot. SATA is used in higher-end embedded systems and
881 can provide higher performance than MMC , at somewhat higher
882 expense and power consumption. This enables loading from SATA
883 using a configured device.
885 config SPL_SERIAL_SUPPORT
886 bool "Support serial"
890 Enable support for serial in SPL. This allows use of a serial UART
891 for displaying messages while SPL is running. It also brings in
892 printf() and panic() functions. This should normally be enabled
893 unless there are space reasons not to. Even then, consider
894 enabling USE_TINY_PRINTF which is a small printf() version.
896 config SPL_SPI_FLASH_SUPPORT
897 bool "Support SPI flash drivers"
899 Enable support for using SPI flash in SPL, and loading U-Boot from
900 SPI flash. SPI flash (Serial Peripheral Bus flash) is named after
901 the SPI bus that is used to connect it to a system. It is a simple
902 but fast bidirectional 4-wire bus (clock, chip select and two data
903 lines). This enables the drivers in drivers/mtd/spi as part of an
904 SPL build. This normally requires SPL_SPI_SUPPORT.
906 if SPL_SPI_FLASH_SUPPORT
908 config SPL_SPI_FLASH_TINY
909 bool "Enable low footprint SPL SPI Flash support"
910 depends on !SPI_FLASH_BAR
911 default y if SPI_FLASH
913 Enable lightweight SPL SPI Flash support that supports just reading
914 data/images from flash. No support to write/erase flash. Enable
915 this if you have SPL size limitations and don't need full
916 fledged SPI flash support.
918 config SPL_SPI_FLASH_SFDP_SUPPORT
919 bool "SFDP table parsing support for SPI NOR flashes"
920 depends on !SPI_FLASH_BAR && !SPL_SPI_FLASH_TINY
922 Enable support for parsing and auto discovery of parameters for
923 SPI NOR flashes using Serial Flash Discoverable Parameters (SFDP)
924 tables as per JESD216 standard in SPL.
927 bool "Support loading from SPI flash"
929 Enable support for loading next stage, U-Boot or otherwise, from
930 SPI NOR in U-Boot SPL.
932 endif # SPL_SPI_FLASH_SUPPORT
934 config SPL_SPI_SUPPORT
935 bool "Support SPI drivers"
937 Enable support for using SPI in SPL. This is used for connecting
938 to SPI flash for loading U-Boot. See SPL_SPI_FLASH_SUPPORT for
939 more details on that. The SPI driver provides the transport for
940 data between the SPI flash and the CPU. This option can be used to
941 enable SPI drivers that are needed for other purposes also, such
945 bool "Driver support for thermal devices"
947 Enable support for temperature-sensing devices. Some SoCs have on-chip
948 temperature sensors to permit warnings, speed throttling or even
949 automatic power-off when the temperature gets too high or low. Other
950 devices may be discrete but connected on a suitable bus.
952 config SPL_USB_HOST_SUPPORT
953 bool "Support USB host drivers"
954 select HAVE_BLOCK_DEVICE
956 Enable access to USB (Universal Serial Bus) host devices so that
957 SPL can load U-Boot from a connected USB peripheral, such as a USB
958 flash stick. While USB takes a little longer to start up than most
959 buses, it is very flexible since many different types of storage
960 device can be attached. This option enables the drivers in
961 drivers/usb/host as part of an SPL build.
963 config SPL_USB_STORAGE
964 bool "Support loading from USB"
965 depends on SPL_USB_HOST_SUPPORT && !(BLK && !DM_USB)
967 Enable support for USB devices in SPL. This allows use of USB
968 devices such as hard drives and flash drivers for loading U-Boot.
969 The actual drivers are enabled separately using the normal U-Boot
970 config options. This enables loading from USB using a configured
973 config SPL_USB_GADGET
974 bool "Suppport USB Gadget drivers"
976 Enable USB Gadget API which allows to enable USB device functions
982 bool "Support USB Ethernet drivers"
984 Enable access to the USB network subsystem and associated
985 drivers in SPL. This permits SPL to load U-Boot over a
986 USB-connected Ethernet link (such as a USB Ethernet dongle) rather
987 than from an onboard peripheral. Environment support is required
988 since the network stack uses a number of environment variables.
989 See also SPL_NET_SUPPORT and SPL_ETH_SUPPORT.
992 bool "Support DFU (Device Firmware Upgrade)"
993 select SPL_HASH_SUPPORT
994 select SPL_DFU_NO_RESET
995 depends on SPL_RAM_SUPPORT
997 This feature enables the DFU (Device Firmware Upgrade) in SPL with
998 RAM memory device support. The ROM code will load and execute
999 the SPL built with dfu. The user can load binaries (u-boot/kernel) to
1000 selected device partition from host-pc using dfu-utils.
1001 This feature is useful to flash the binaries to factory or bare-metal
1002 boards using USB interface.
1005 bool "DFU device selection"
1010 depends on SPL_DFU && SPL_RAM_SUPPORT
1012 select RAM/DDR memory device for loading binary images
1013 (u-boot/kernel) to the selected device partition using
1014 DFU and execute the u-boot/kernel from RAM.
1018 config SPL_USB_SDP_SUPPORT
1019 bool "Support SDP (Serial Download Protocol)"
1021 Enable Serial Download Protocol (SDP) device support in SPL. This
1022 allows to download images into memory and execute (jump to) them
1023 using the same protocol as implemented by the i.MX family's boot ROM.
1026 config SPL_WATCHDOG_SUPPORT
1027 bool "Support watchdog drivers"
1029 Enable support for watchdog drivers in SPL. A watchdog is
1030 typically a hardware peripheral which can reset the system when it
1031 detects no activity for a while (such as a software crash). This
1032 enables the drivers in drivers/watchdog as part of an SPL build.
1034 config SPL_YMODEM_SUPPORT
1035 bool "Support loading using Ymodem"
1036 depends on SPL_SERIAL_SUPPORT
1038 While loading from serial is slow it can be a useful backup when
1039 there is no other option. The Ymodem protocol provides a reliable
1040 means of transmitting U-Boot over a serial line for using in SPL,
1041 with a checksum to ensure correctness.
1044 bool "Support ARM Trusted Firmware"
1047 ATF(ARM Trusted Firmware) is a component for ARM AArch64 which
1048 is loaded by SPL (which is considered as BL2 in ATF terminology).
1049 More detail at: https://github.com/ARM-software/arm-trusted-firmware
1051 config SPL_ATF_NO_PLATFORM_PARAM
1052 bool "Pass no platform parameter"
1055 While we expect to call a pointer to a valid FDT (or NULL)
1056 as the platform parameter to an ATF, some ATF versions are
1057 not U-Boot aware and have an insufficiently robust parameter
1058 validation to gracefully reject a FDT being passed.
1060 If this option is enabled, the spl_atf os-type handler will
1061 always pass NULL for the platform parameter.
1063 If your ATF is affected, say Y.
1065 config SPL_AM33XX_ENABLE_RTC32K_OSC
1066 bool "Enable the RTC32K OSC on AM33xx based platforms"
1069 Enable access to the AM33xx RTC and select the external 32kHz clock
1073 bool "Support OP-TEE Trusted OS"
1076 OP-TEE is an open source Trusted OS which is loaded by SPL.
1077 More detail at: https://github.com/OP-TEE/optee_os
1081 depends on SUPPORT_TPL
1084 If you want to build TPL as well as the normal image and SPL, say Y.
1089 bool "Pass hand-off information from TPL to SPL and U-Boot proper"
1093 This option enables TPL to write handoff information. This can be
1094 used to pass information like the size of SDRAM from TPL to U-Boot
1095 proper. The information is also available to SPL if it is useful
1098 config TPL_BOARD_INIT
1099 bool "Call board-specific initialization in TPL"
1101 If this option is enabled, U-Boot will call the function
1102 spl_board_init() from board_init_r(). This function should be
1103 provided by the board.
1106 string "Linker script for the TPL stage"
1108 default "arch/arm/cpu/armv8/u-boot-spl.lds" if ARM64
1109 default "arch/$(ARCH)/cpu/u-boot-spl.lds"
1111 The TPL stage will usually require a different linker-script
1112 (as it runs from a different memory region) than the regular
1113 U-Boot stage. Set this to the path of the linker-script to
1116 May be left empty to trigger the Makefile infrastructure to
1117 fall back to the linker-script used for the SPL stage.
1119 config TPL_NEEDS_SEPARATE_TEXT_BASE
1120 bool "TPL needs a separate text-base"
1124 Enable, if the TPL stage should not inherit its text-base
1125 from the SPL stage. When enabled, a base address for the
1126 .text sections of the TPL stage has to be set below.
1128 config TPL_NEEDS_SEPARATE_STACK
1129 bool "TPL needs a separate initial stack-pointer"
1133 Enable, if the TPL stage should not inherit its initial
1134 stack-pointer from the settings for the SPL stage.
1136 config TPL_TEXT_BASE
1137 hex "Base address for the .text section of the TPL stage"
1138 depends on TPL_NEEDS_SEPARATE_TEXT_BASE
1140 The base address for the .text section of the TPL stage.
1143 int "Maximum size (in bytes) for the TPL stage"
1147 The maximum size (in bytes) of the TPL stage.
1150 hex "Address of the initial stack-pointer for the TPL stage"
1151 depends on TPL_NEEDS_SEPARATE_STACK
1153 The address of the initial stack-pointer for the TPL stage.
1154 Usually this will be the (aligned) top-of-stack.
1156 config TPL_BOOTROM_SUPPORT
1157 bool "Support returning to the BOOTROM (from TPL)"
1159 Some platforms (e.g. the Rockchip RK3368) provide support in their
1160 ROM for loading the next boot-stage after performing basic setup
1163 Enable this option, to return to the BOOTROM through the
1164 BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
1165 boot device list, if not implemented for a given board)
1167 config TPL_DRIVERS_MISC_SUPPORT
1168 bool "Support misc drivers in TPL"
1170 Enable miscellaneous drivers in TPL. These drivers perform various
1171 tasks that don't fall nicely into other categories, Enable this
1172 option to build the drivers in drivers/misc as part of an TPL
1173 build, for those that support building in TPL (not all drivers do).
1175 config TPL_ENV_SUPPORT
1176 bool "Support an environment"
1178 Enable environment support in TPL. See SPL_ENV_SUPPORT for details.
1180 config TPL_GPIO_SUPPORT
1181 bool "Support GPIO in TPL"
1183 Enable support for GPIOs (General-purpose Input/Output) in TPL.
1184 GPIOs allow U-Boot to read the state of an input line (high or
1185 low) and set the state of an output line. This can be used to
1186 drive LEDs, control power to various system parts and read user
1187 input. GPIOs can be useful in TPL to enable a 'sign-of-life' LED,
1188 for example. Enable this option to build the drivers in
1189 drivers/gpio as part of an TPL build.
1191 config TPL_I2C_SUPPORT
1194 Enable support for the I2C bus in TPL. See SPL_I2C_SUPPORT for
1197 config TPL_LIBCOMMON_SUPPORT
1198 bool "Support common libraries"
1200 Enable support for common U-Boot libraries within TPL. See
1201 SPL_LIBCOMMON_SUPPORT for details.
1203 config TPL_LIBGENERIC_SUPPORT
1204 bool "Support generic libraries"
1206 Enable support for generic U-Boot libraries within TPL. See
1207 SPL_LIBGENERIC_SUPPORT for details.
1209 config TPL_MPC8XXX_INIT_DDR_SUPPORT
1210 bool "Support MPC8XXX DDR init"
1212 Enable support for DDR-SDRAM on the MPC8XXX family within TPL. See
1213 SPL_MPC8XXX_INIT_DDR_SUPPORT for details.
1215 config TPL_MMC_SUPPORT
1219 Enable support for MMC within TPL. See SPL_MMC_SUPPORT for details.
1221 config TPL_NAND_SUPPORT
1222 bool "Support NAND flash"
1224 Enable support for NAND in TPL. See SPL_NAND_SUPPORT for details.
1227 bool "Support PCI drivers"
1229 Enable support for PCI in TPL. For platforms that need PCI to boot,
1230 or must perform some init using PCI in SPL, this provides the
1231 necessary driver support. This enables the drivers in drivers/pci
1232 as part of a TPL build.
1234 config TPL_PCH_SUPPORT
1235 bool "Support PCH drivers"
1237 Enable support for PCH (Platform Controller Hub) devices in TPL.
1238 These are used to set up GPIOs and the SPI peripheral early in
1239 boot. This enables the drivers in drivers/pch as part of a TPL
1242 config TPL_RAM_SUPPORT
1243 bool "Support booting from RAM"
1245 Enable booting of an image in RAM. The image can be preloaded or
1246 it can be loaded by TPL directly into RAM (e.g. using USB).
1248 config TPL_RAM_DEVICE
1249 bool "Support booting from preloaded image in RAM"
1250 depends on TPL_RAM_SUPPORT
1252 Enable booting of an image already loaded in RAM. The image has to
1253 be already in memory when TPL takes over, e.g. loaded by the boot
1256 config TPL_RTC_SUPPORT
1257 bool "Support RTC drivers"
1259 Enable RTC (Real-time Clock) support in TPL. This includes support
1260 for reading and setting the time. Some RTC devices also have some
1261 non-volatile (battery-backed) memory which is accessible if
1262 needed. This enables the drivers in drivers/rtc as part of an TPL
1265 config TPL_SERIAL_SUPPORT
1266 bool "Support serial"
1270 Enable support for serial in TPL. See SPL_SERIAL_SUPPORT for
1273 config TPL_SPI_FLASH_SUPPORT
1274 bool "Support SPI flash drivers"
1276 Enable support for using SPI flash in TPL. See SPL_SPI_FLASH_SUPPORT
1280 bool "Support loading from SPI flash"
1281 depends on TPL_SPI_FLASH_SUPPORT
1283 Enable support for loading next stage, U-Boot or otherwise, from
1284 SPI NOR in U-Boot TPL.
1286 config TPL_SPI_SUPPORT
1287 bool "Support SPI drivers"
1289 Enable support for using SPI in TPL. See SPL_SPI_SUPPORT for
1292 config TPL_YMODEM_SUPPORT
1293 bool "Support loading using Ymodem"
1294 depends on TPL_SERIAL_SUPPORT
1296 While loading from serial is slow it can be a useful backup when
1297 there is no other option. The Ymodem protocol provides a reliable
1298 means of transmitting U-Boot over a serial line for using in TPL,
1299 with a checksum to ensure correctness.
1303 config SPL_AT91_MCK_BYPASS
1304 bool "Use external clock signal as a source of main clock for AT91 platforms"
1305 depends on ARCH_AT91
1308 Use external 8 to 24 Mhz clock signal as source of main clock instead
1309 of an external crystal oscillator.
1310 This option disables the internal driving on the XOUT pin.
1311 The external source has to provide a stable clock on the XIN pin.
1312 If this option is disabled, the SoC expects a crystal oscillator
1313 that needs driving on both XIN and XOUT lines.