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 hex "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 config SPL_SYS_STACK_F_CHECK_BYTE
69 Constant used to check the stack
71 config SPL_SYS_REPORT_STACK_F_USAGE
72 depends on SPL_SIZE_LIMIT_PROVIDE_STACK != 0
73 bool "Check and report stack usage in SPL before relocation"
75 If this option is enabled, the initial SPL stack is filled with 0xaa
76 very early, up to the size configured with
77 SPL_SIZE_LIMIT_PROVIDE_STACK.
78 Later when SPL is done using this initial stack and switches to a
79 stack in DRAM, the actually used size of this initial stack is
80 reported by examining the memory and searching for the lowest
81 occurrence of non 0xaa bytes.
82 This default implementation works for stacks growing down only.
84 menu "PowerPC SPL Boot options"
85 depends on PPC && (SUPPORT_SPL && !SPL_FRAMEWORK)
88 bool "Load SPL from NAND flash"
91 bool "Load SPL from SD Card / eMMC"
94 bool "Load SPL from SPI flash"
97 bool "Create SPL in Freescale PBI format"
99 Create boot binary having SPL binary in PBI format concatenated with
105 bool "Pass hand-off information from SPL to U-Boot proper"
108 It is useful to be able to pass information from SPL to U-Boot
109 proper to preserve state that is known in SPL and is needed in U-Boot.
110 Enable this to locate the handoff information in U-Boot proper, early
111 in boot. It is available in gd->handoff. The state state is set up
112 in SPL (or TPL if that is being used).
117 bool "Pass hand-off information from SPL to U-Boot proper"
118 depends on HANDOFF && SPL_BLOBLIST
121 This option enables SPL to write handoff information. This can be
122 used to pass information like the size of SDRAM from SPL to U-Boot
123 proper. Also SPL can receive information from TPL in the same place
127 string "Linker script for the SPL stage"
128 default "arch/$(ARCH)/cpu/u-boot-spl.lds"
130 The SPL stage will usually require a different linker-script
131 (as it runs from a different memory region) than the regular
132 U-Boot stage. Set this to the path of the linker-script to
137 default ISW_ENTRY_ADDR if AM43XX || AM33XX || OMAP54XX || ARCH_KEYSTONE
138 default 0x10060 if MACH_SUN50I || MACH_SUN50I_H5 || MACH_SUN9I
139 default 0x20060 if MACH_SUN50I_H6
140 default 0x00060 if ARCH_SUNXI
143 The address in memory that SPL will be running from.
145 config SPL_BOARD_INIT
146 bool "Call board-specific initialization in SPL"
148 If this option is enabled, U-Boot will call the function
149 spl_board_init() from board_init_r(). This function should be
150 provided by the board.
152 config SPL_BOOTROM_SUPPORT
153 bool "Support returning to the BOOTROM"
155 Some platforms (e.g. the Rockchip RK3368) provide support in their
156 ROM for loading the next boot-stage after performing basic setup
159 Enable this option, to return to the BOOTROM through the
160 BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
161 boot device list, if not implemented for a given board)
163 config SPL_BOOTCOUNT_LIMIT
164 bool "Support bootcount in SPL"
165 depends on SPL_ENV_SUPPORT
167 On some boards, which use 'falcon' mode, it is necessary to check
168 and increment the number of boot attempts. Such boards do not
169 use proper U-Boot for normal boot flow and hence needs those
170 adjustments to be done in the SPL.
172 config SPL_RAW_IMAGE_SUPPORT
173 bool "Support SPL loading and booting of RAW images"
174 default n if (ARCH_MX6 && (SPL_MMC_SUPPORT || SPL_SATA_SUPPORT))
175 default y if !TI_SECURE_DEVICE
177 SPL will support loading and booting a RAW image when this option
178 is y. If this is not set, SPL will move on to other available
179 boot media to find a suitable image.
181 config SPL_LEGACY_IMAGE_SUPPORT
182 bool "Support SPL loading and booting of Legacy images"
183 default y if !TI_SECURE_DEVICE && !SPL_LOAD_FIT
185 SPL will support loading and booting Legacy images when this option
186 is y. If this is not set, SPL will move on to other available
187 boot media to find a suitable image.
189 config SPL_LEGACY_IMAGE_CRC_CHECK
190 bool "Check CRC of Legacy images"
191 depends on SPL_LEGACY_IMAGE_SUPPORT
192 select SPL_CRC32_SUPPORT
194 Enable this to check the CRC of Legacy images. While this increases
195 reliability, it affects both code size and boot duration.
196 If disabled, Legacy images are booted if the image magic and size
197 are correct, without further integrity checks.
199 config SPL_SYS_MALLOC_SIMPLE
201 prompt "Only use malloc_simple functions in the SPL"
203 Say Y here to only use the *_simple malloc functions from
204 malloc_simple.c, rather then using the versions from dlmalloc.c;
205 this will make the SPL binary smaller at the cost of more heap
206 usage as the *_simple malloc functions do not re-use free-ed mem.
208 config TPL_SYS_MALLOC_SIMPLE
210 prompt "Only use malloc_simple functions in the TPL"
213 Say Y here to only use the *_simple malloc functions from
214 malloc_simple.c, rather then using the versions from dlmalloc.c;
215 this will make the TPL binary smaller at the cost of more heap
216 usage as the *_simple malloc functions do not re-use free-ed mem.
219 bool "Enable SDRAM location for SPL stack"
221 SPL starts off execution in SRAM and thus typically has only a small
222 stack available. Since SPL sets up DRAM while in its board_init_f()
223 function, it is possible for the stack to move there before
224 board_init_r() is reached. This option enables a special SDRAM
225 location for the SPL stack. U-Boot SPL switches to this after
226 board_init_f() completes, and before board_init_r() starts.
228 config SPL_STACK_R_ADDR
229 depends on SPL_STACK_R
230 hex "SDRAM location for SPL stack"
231 default 0x82000000 if ARCH_OMAP2PLUS
233 Specify the address in SDRAM for the SPL stack. This will be set up
234 before board_init_r() is called.
236 config SPL_STACK_R_MALLOC_SIMPLE_LEN
237 depends on SPL_STACK_R && SPL_SYS_MALLOC_SIMPLE
238 hex "Size of malloc_simple heap after switching to DRAM SPL stack"
241 Specify the amount of the stack to use as memory pool for
242 malloc_simple after switching the stack to DRAM. This may be set
243 to give board_init_r() a larger heap then the initial heap in
244 SRAM which is limited to SYS_MALLOC_F_LEN bytes.
246 config SPL_SEPARATE_BSS
247 bool "BSS section is in a different memory region from text"
249 Some platforms need a large BSS region in SPL and can provide this
250 because RAM is already set up. In this case BSS can be moved to RAM.
251 This option should then be enabled so that the correct device tree
252 location is used. Normally we put the device tree at the end of BSS
253 but with this option enabled, it goes at _image_binary_end.
255 config SPL_BANNER_PRINT
256 bool "Enable output of the SPL banner 'U-Boot SPL ...'"
259 If this option is enabled, SPL will print the banner with version
260 info. Disabling this option could be useful to reduce TPL boot time
261 (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
263 config TPL_BANNER_PRINT
264 bool "Enable output of the TPL banner 'U-Boot TPL ...'"
268 If this option is enabled, SPL will not print the banner with version
269 info. Disabling this option could be useful to reduce SPL boot time
270 (e.g. approx. 6 ms faster, when output on i.MX6 with 115200 baud).
273 depends on ARM && !ARM64
274 bool "Allows initializing BSS early before entering board_init_f"
276 On some platform we have sufficient memory available early on to
277 allow setting up and using a basic BSS prior to entering
278 board_init_f. Activating this option will also de-activate the
279 clearing of BSS during the SPL relocation process, thus allowing
280 to carry state from board_init_f to board_init_r by way of BSS.
282 config SPL_DISPLAY_PRINT
283 bool "Display a board-specific message in SPL"
285 If this option is enabled, U-Boot will call the function
286 spl_display_print() immediately after displaying the SPL console
287 banner ("U-Boot SPL ..."). This function should be provided by
290 config SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
291 bool "MMC raw mode: by sector"
292 default y if ARCH_SUNXI || ARCH_DAVINCI || ARCH_UNIPHIER || \
293 ARCH_MX6 || ARCH_MX7 || \
294 ARCH_ROCKCHIP || ARCH_MVEBU || ARCH_SOCFPGA || \
295 ARCH_AT91 || ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || \
296 OMAP44XX || OMAP54XX || AM33XX || AM43XX
298 Use sector number for specifying U-Boot location on MMC/SD in
301 config SYS_MMCSD_RAW_MODE_U_BOOT_SECTOR
302 hex "Address on the MMC to load U-Boot from"
303 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_SECTOR
304 default 0x50 if ARCH_SUNXI
305 default 0x75 if ARCH_DAVINCI
306 default 0x8a if ARCH_MX6 || ARCH_MX7
307 default 0x100 if ARCH_UNIPHIER
308 default 0x140 if ARCH_MVEBU
309 default 0x200 if ARCH_SOCFPGA || ARCH_AT91
310 default 0x300 if ARCH_ZYNQ || ARCH_KEYSTONE || OMAP34XX || OMAP44XX || \
311 OMAP54XX || AM33XX || AM43XX || ARCH_K3
312 default 0x4000 if ARCH_ROCKCHIP
314 Address on the MMC to load U-Boot from, when the MMC is being used
315 in raw mode. Units: MMC sectors (1 sector = 512 bytes).
317 config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
318 bool "MMC Raw mode: by partition"
320 Use a partition for loading U-Boot when using MMC/SD in raw mode.
322 config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION
323 hex "Partition to use to load U-Boot from"
324 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
327 Partition on the MMC to load U-Boot from when the MMC is being
330 config SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
331 bool "MMC raw mode: by partition type"
332 depends on DOS_PARTITION && SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION
334 Use partition type for specifying U-Boot partition on MMC/SD in
335 raw mode. U-Boot will be loaded from the first partition of this
338 config SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION_TYPE
339 hex "Partition Type on the MMC to load U-Boot from"
340 depends on SYS_MMCSD_RAW_MODE_U_BOOT_USE_PARTITION_TYPE
342 Partition Type on the MMC to load U-Boot from, when the MMC is being
345 config SPL_CRC32_SUPPORT
347 default y if SPL_LEGACY_IMAGE_SUPPORT
349 Enable this to support CRC32 in uImages or FIT images within SPL.
350 This is a 32-bit checksum value that can be used to verify images.
351 For FIT images, this is the least secure type of checksum, suitable
352 for detected accidental image corruption. For secure applications you
353 should consider SHA1 or SHA256.
355 config SPL_MD5_SUPPORT
359 Enable this to support MD5 in FIT images within SPL. An MD5
360 checksum is a 128-bit hash value used to check that the image
361 contents have not been corrupted. Note that MD5 is not considered
362 secure as it is possible (with a brute-force attack) to adjust the
363 image while still retaining the same MD5 hash value. For secure
364 applications where images may be changed maliciously, you should
365 consider SHA1 or SHA256.
367 config SPL_SHA1_SUPPORT
372 Enable this to support SHA1 in FIT images within SPL. A SHA1
373 checksum is a 160-bit (20-byte) hash value used to check that the
374 image contents have not been corrupted or maliciously altered.
375 While SHA1 is fairly secure it is coming to the end of its life
376 due to the expanding computing power available to brute-force
377 attacks. For more security, consider SHA256.
379 config SPL_SHA256_SUPPORT
380 bool "Support SHA256"
384 Enable this to support SHA256 in FIT images within SPL. A SHA256
385 checksum is a 256-bit (32-byte) hash value used to check that the
386 image contents have not been corrupted. SHA256 is recommended for
387 use in secure applications since (as at 2016) there is no known
388 feasible attack that could produce a 'collision' with differing
389 input data. Use this for the highest security. Note that only the
390 SHA256 variant is supported: SHA512 and others are not currently
393 config SPL_FIT_IMAGE_TINY
394 bool "Remove functionality from SPL FIT loading to reduce size"
396 default y if MACH_SUN50I || MACH_SUN50I_H5 || MACH_SUN50I_H6
397 default y if ARCH_IMX8M
399 Enable this to reduce the size of the FIT image loading code
400 in SPL, if space for the SPL binary is very tight.
402 This removes the detection of image types (which forces the
403 first image to be treated as having a U-Boot style calling
404 convention) and skips the recording of each loaded payload
405 (i.e. loadable) into the FDT (modifying the loaded FDT to
406 ensure this information is available to the next image
409 config SPL_CPU_SUPPORT
410 bool "Support CPU drivers"
412 Enable this to support CPU drivers in SPL. These drivers can set
413 up CPUs and provide information about them such as the model and
414 name. This can be useful in SPL since setting up the CPUs earlier
415 may improve boot performance. Enable this option to build the
416 drivers in drivers/cpu as part of an SPL build.
418 config SPL_CRYPTO_SUPPORT
419 bool "Support crypto drivers"
421 Enable crypto drivers in SPL. These drivers can be used to
422 accelerate secure boot processing in secure applications. Enable
423 this option to build the drivers in drivers/crypto as part of an
426 config SPL_HASH_SUPPORT
427 bool "Support hashing drivers"
431 Enable hashing drivers in SPL. These drivers can be used to
432 accelerate secure boot processing in secure applications. Enable
433 this option to build system-specific drivers for hash acceleration
434 as part of an SPL build.
436 config TPL_HASH_SUPPORT
437 bool "Support hashing drivers in TPL"
442 Enable hashing drivers in SPL. These drivers can be used to
443 accelerate secure boot processing in secure applications. Enable
444 this option to build system-specific drivers for hash acceleration
445 as part of an SPL build.
447 config SPL_DMA_SUPPORT
448 bool "Support DMA drivers"
450 Enable DMA (direct-memory-access) drivers in SPL. These drivers
451 can be used to handle memory-to-peripheral data transfer without
452 the CPU moving the data. Enable this option to build the drivers
453 in drivers/dma as part of an SPL build.
455 config SPL_DRIVERS_MISC_SUPPORT
456 bool "Support misc drivers"
458 Enable miscellaneous drivers in SPL. These drivers perform various
459 tasks that don't fall nicely into other categories, Enable this
460 option to build the drivers in drivers/misc as part of an SPL
461 build, for those that support building in SPL (not all drivers do).
463 config SPL_ENV_SUPPORT
464 bool "Support an environment"
466 Enable environment support in SPL. The U-Boot environment provides
467 a number of settings (essentially name/value pairs) which can
468 control many aspects of U-Boot's operation. Normally this is not
469 needed in SPL as it has a much simpler task with less
470 configuration. But some boards use this to support 'Falcon' boot
471 on EXT2 and FAT, where SPL boots directly into Linux without
472 starting U-Boot first. Enabling this option will make env_get()
473 and env_set() available in SPL.
476 bool "Support save environment"
477 depends on SPL_ENV_SUPPORT
478 select SPL_MMC_WRITE if ENV_IS_IN_MMC
480 Enable save environment support in SPL after setenv. By default
481 the saveenv option is not provided in SPL, but some boards need
482 this support in 'Falcon' boot, where SPL need to boot from
483 different images based on environment variable set by OS. For
484 example OS may set "reboot_image" environment variable to
485 "recovery" inorder to boot recovery image by SPL. The SPL read
486 "reboot_image" and act accordingly and change the reboot_image
487 to default mode using setenv and save the environment.
489 config SPL_ETH_SUPPORT
490 bool "Support Ethernet"
491 depends on SPL_ENV_SUPPORT
493 Enable access to the network subsystem and associated Ethernet
494 drivers in SPL. This permits SPL to load U-Boot over an Ethernet
495 link rather than from an on-board peripheral. Environment support
496 is required since the network stack uses a number of environment
497 variables. See also SPL_NET_SUPPORT.
500 bool "Support EXT filesystems"
502 Enable support for EXT2/3/4 filesystems with SPL. This permits
503 U-Boot (or Linux in Falcon mode) to be loaded from an EXT
504 filesystem from within SPL. Support for the underlying block
505 device (e.g. MMC or USB) must be enabled separately.
508 bool "Support FAT filesystems"
511 Enable support for FAT and VFAT filesystems with SPL. This
512 permits U-Boot (or Linux in Falcon mode) to be loaded from a FAT
513 filesystem from within SPL. Support for the underlying block
514 device (e.g. MMC or USB) must be enabled separately.
517 bool "Support write for FAT filesystems"
519 Enable write support for FAT and VFAT filesystems with SPL.
520 Support for the underlying block device (e.g. MMC or USB) must be
523 config SPL_FPGA_SUPPORT
526 Enable support for FPGAs in SPL. Field-programmable Gate Arrays
527 provide software-configurable hardware which is typically used to
528 implement peripherals (such as UARTs, LCD displays, MMC) or
529 accelerate custom processing functions, such as image processing
530 or machine learning. Sometimes it is useful to program the FPGA
531 as early as possible during boot, and this option can enable that
534 config SPL_GPIO_SUPPORT
535 bool "Support GPIO in SPL"
537 Enable support for GPIOs (General-purpose Input/Output) in SPL.
538 GPIOs allow U-Boot to read the state of an input line (high or
539 low) and set the state of an output line. This can be used to
540 drive LEDs, control power to various system parts and read user
541 input. GPIOs can be useful in SPL to enable a 'sign-of-life' LED,
542 for example. Enable this option to build the drivers in
543 drivers/gpio as part of an SPL build.
545 config SPL_I2C_SUPPORT
548 Enable support for the I2C (Inter-Integrated Circuit) bus in SPL.
549 I2C works with a clock and data line which can be driven by a
550 one or more masters or slaves. It is a fairly complex bus but is
551 widely used as it only needs two lines for communication. Speeds of
552 400kbps are typical but up to 3.4Mbps is supported by some
553 hardware. I2C can be useful in SPL to configure power management
554 ICs (PMICs) before raising the CPU clock speed, for example.
555 Enable this option to build the drivers in drivers/i2c as part of
558 config SPL_LIBCOMMON_SUPPORT
559 bool "Support common libraries"
561 Enable support for common U-Boot libraries within SPL. These
562 libraries include common code to deal with U-Boot images,
563 environment and USB, for example. This option is enabled on many
564 boards. Enable this option to build the code in common/ as part of
567 config SPL_LIBDISK_SUPPORT
568 bool "Support disk partitions"
571 Enable support for disk partitions within SPL. 'Disk' is something
572 of a misnomer as it includes non-spinning media such as flash (as
573 used in MMC and USB sticks). Partitions provide a way for a disk
574 to be split up into separate regions, with a partition table placed
575 at the start or end which describes the location and size of each
576 'partition'. These partitions are typically uses as individual block
577 devices, typically with an EXT2 or FAT filesystem in each. This
578 option enables whatever partition support has been enabled in
579 U-Boot to also be used in SPL. It brings in the code in disk/.
581 config SPL_LIBGENERIC_SUPPORT
582 bool "Support generic libraries"
584 Enable support for generic U-Boot libraries within SPL. These
585 libraries include generic code to deal with device tree, hashing,
586 printf(), compression and the like. This option is enabled on many
587 boards. Enable this option to build the code in lib/ as part of an
590 config SPL_DM_MAILBOX
591 bool "Support Mailbox"
593 Enable support for Mailbox within SPL. This enable the inter
594 processor communication protocols tobe used within SPL. Enable
595 this option to build the drivers in drivers/mailbox as part of
598 config SPL_MMC_SUPPORT
601 select HAVE_BLOCK_DEVICE
603 Enable support for MMC (Multimedia Card) within SPL. This enables
604 the MMC protocol implementation and allows any enabled drivers to
605 be used within SPL. MMC can be used with or without disk partition
606 support depending on the application (SPL_LIBDISK_SUPPORT). Enable
607 this option to build the drivers in drivers/mmc as part of an SPL
611 bool "Tiny MMC framework in SPL"
612 depends on SPL_MMC_SUPPORT
615 Enable MMC framework tinification support. This option is useful if
616 if your SPL is extremely size constrained. Heed the warning, enable
617 this option if and only if you know exactly what you are doing, if
618 you are reading this help text, you most likely have no idea :-)
620 The MMC framework is reduced to bare minimum to be useful. No malloc
621 support is needed for the MMC framework operation with this option
622 enabled. The framework supports exactly one MMC device and exactly
623 one MMC driver. The MMC driver can be adjusted to avoid any malloc
624 operations too, which can remove the need for malloc support in SPL
625 and thus further reduce footprint.
628 bool "MMC/SD/SDIO card support for write operations in SPL"
629 depends on SPL_MMC_SUPPORT
632 Enable write access to MMC and SD Cards in SPL
635 config SPL_MPC8XXX_INIT_DDR_SUPPORT
636 bool "Support MPC8XXX DDR init"
638 Enable support for DDR-SDRAM (double-data-rate synchronous dynamic
639 random-access memory) on the MPC8XXX family within SPL. This
640 allows DRAM to be set up before loading U-Boot into that DRAM,
643 config SPL_MTD_SUPPORT
644 bool "Support MTD drivers"
646 Enable support for MTD (Memory Technology Device) within SPL. MTD
647 provides a block interface over raw NAND and can also be used with
648 SPI flash. This allows SPL to load U-Boot from supported MTD
649 devices. See SPL_NAND_SUPPORT and SPL_ONENAND_SUPPORT for how
650 to enable specific MTD drivers.
652 config SPL_MUSB_NEW_SUPPORT
653 bool "Support new Mentor Graphics USB"
655 Enable support for Mentor Graphics USB in SPL. This is a new
656 driver used by some boards. Enable this option to build
657 the drivers in drivers/usb/musb-new as part of an SPL build. The
658 old drivers are in drivers/usb/musb.
660 config SPL_NAND_SUPPORT
661 bool "Support NAND flash"
663 Enable support for NAND (Negative AND) flash in SPL. NAND flash
664 can be used to allow SPL to load U-Boot from supported devices.
665 This enables the drivers in drivers/mtd/nand/raw as part of an SPL
671 Enable support for loading payloads from UBI. See
672 README.ubispl for more info.
675 config SPL_UBI_LOAD_BY_VOLNAME
676 bool "Support loading volumes by name"
678 This enables support for loading UBI volumes by name. When this
679 is set, CONFIG_SPL_UBI_LOAD_MONITOR_VOLNAME can be used to
680 configure the volume name from which to load U-Boot.
682 config SPL_UBI_MAX_VOL_LEBS
683 int "Maximum number of LEBs per volume"
686 The maximum number of logical eraseblocks which a static volume
687 to load can contain. Used for sizing the scan data structure.
689 config SPL_UBI_MAX_PEB_SIZE
690 int "Maximum PEB size"
693 The maximum physical erase block size.
695 config SPL_UBI_MAX_PEBS
696 int "Maximum number of PEBs"
699 The maximum physical erase block size. If not overridden by
700 board code, this value will be used as the actual number of PEBs.
702 config SPL_UBI_PEB_OFFSET
703 int "Offset to first UBI PEB"
706 The offset in number of PEBs from the start of flash to the first
707 PEB part of the UBI image.
709 config SPL_UBI_VID_OFFSET
710 int "Offset to VID header"
713 config SPL_UBI_LEB_START
714 int "Offset to LEB in PEB"
717 The offset in bytes to the LEB within a PEB.
719 config SPL_UBI_INFO_ADDR
720 hex "Address to place UBI scan info"
723 Address for ubispl to place the scan info. Read README.ubispl to
724 determine the required size
726 config SPL_UBI_VOL_IDS
727 int "Maximum volume id"
730 The maximum volume id which can be loaded. Used for sizing the
733 config SPL_UBI_LOAD_MONITOR_ID
734 int "id of U-Boot volume"
737 The UBI volume id from which to load U-Boot
739 config SPL_UBI_LOAD_MONITOR_VOLNAME
740 string "volume name of U-Boot volume"
741 depends on SPL_UBI_LOAD_BY_VOLNAME
743 The UBI volume name from which to load U-Boot
745 config SPL_UBI_LOAD_KERNEL_ID
746 int "id of kernel volume"
747 depends on SPL_OS_BOOT && SPL_UBI
749 The UBI volume id from which to load the kernel
751 config SPL_UBI_LOAD_ARGS_ID
752 int "id of kernel args volume"
753 depends on SPL_OS_BOOT && SPL_UBI
755 The UBI volume id from which to load the device tree
757 config UBI_SPL_SILENCE_MSG
758 bool "silence UBI SPL messages"
761 Disable messages from UBI SPL. This leaves warnings
766 config SPL_NET_SUPPORT
767 bool "Support networking"
769 Enable support for network devices (such as Ethernet) in SPL.
770 This permits SPL to load U-Boot over a network link rather than
771 from an on-board peripheral. Environment support is required since
772 the network stack uses a number of environment variables. See also
776 config SPL_NET_VCI_STRING
777 string "BOOTP Vendor Class Identifier string sent by SPL"
779 As defined by RFC 2132 the vendor class identifier field can be
780 sent by the client to identify the vendor type and configuration
781 of a client. This is often used in practice to allow for the DHCP
782 server to specify different files to load depending on if the ROM,
783 SPL or U-Boot itself makes the request
784 endif # if SPL_NET_SUPPORT
786 config SPL_NO_CPU_SUPPORT
787 bool "Drop CPU code in SPL"
789 This is specific to the ARM926EJ-S CPU. It disables the standard
790 start.S start-up code, presumably so that a replacement can be
791 used on that CPU. You should not enable it unless you know what
794 config SPL_NOR_SUPPORT
795 bool "Support NOR flash"
797 Enable support for loading U-Boot from memory-mapped NOR (Negative
798 OR) flash in SPL. NOR flash is slow to write but fast to read, and
799 a memory-mapped device makes it very easy to access. Loading from
800 NOR is typically achieved with just a memcpy().
802 config SPL_XIP_SUPPORT
806 Enable support for execute in place of U-Boot or kernel image. There
807 is no need to copy image from flash to ram if flash supports execute
808 in place. Its very useful in systems having enough flash but not
809 enough ram to load the image.
811 config SPL_ONENAND_SUPPORT
812 bool "Support OneNAND flash"
814 Enable support for OneNAND (Negative AND) flash in SPL. OneNAND is
815 a type of NAND flash and therefore can be used to allow SPL to
816 load U-Boot from supported devices. This enables the drivers in
817 drivers/mtd/onenand as part of an SPL build.
820 bool "Activate Falcon Mode"
821 depends on !TI_SECURE_DEVICE
824 Enable booting directly to an OS from SPL.
825 for more info read doc/README.falcon
829 hex "addr, where OS is found"
830 depends on SPL_NOR_SUPPORT
832 Specify the address, where the OS image is found, which
839 default "tpl/u-boot-with-tpl.bin" if TPL
842 Payload for SPL boot. For backward compatibility, default to
843 u-boot.bin, i.e. RAW image without any header. In case of
844 TPL, tpl/u-boot-with-tpl.bin. For new boards, suggest to
848 bool "Support PCI drivers"
850 Enable support for PCI in SPL. For platforms that need PCI to boot,
851 or must perform some init using PCI in SPL, this provides the
852 necessary driver support. This enables the drivers in drivers/pci
853 as part of an SPL build.
855 config SPL_PCH_SUPPORT
856 bool "Support PCH drivers"
858 Enable support for PCH (Platform Controller Hub) devices in SPL.
859 These are used to set up GPIOs and the SPI peripheral early in
860 boot. This enables the drivers in drivers/pch as part of an SPL
863 config SPL_POST_MEM_SUPPORT
864 bool "Support POST drivers"
866 Enable support for POST (Power-on Self Test) in SPL. POST is a
867 procedure that checks that the hardware (CPU or board) appears to
868 be functionally correctly. It is a sanity check that can be
869 performed before booting. This enables the drivers in post/drivers
870 as part of an SPL build.
873 bool "Support reset drivers"
876 Enable support for reset control in SPL.
877 That can be useful in SPL to handle IP reset in driver, as in U-Boot,
878 by using the generic reset API provided by driver model.
879 This enables the drivers in drivers/reset as part of an SPL build.
881 config SPL_POWER_SUPPORT
882 bool "Support power drivers"
884 Enable support for power control in SPL. This includes support
885 for PMICs (Power-management Integrated Circuits) and some of the
886 features provided by PMICs. In particular, voltage regulators can
887 be used to enable/disable power and vary its voltage. That can be
888 useful in SPL to turn on boot peripherals and adjust CPU voltage
889 so that the clock speed can be increased. This enables the drivers
890 in drivers/power, drivers/power/pmic and drivers/power/regulator
891 as part of an SPL build.
893 config SPL_POWER_DOMAIN
894 bool "Support power domain drivers"
896 Enable support for power domain control in SPL. Many SoCs allow
897 power to be applied to or removed from portions of the SoC (power
898 domains). This may be used to save power. This API provides the
899 means to control such power management hardware. This enables
900 the drivers in drivers/power/domain as part of a SPL build.
902 config SPL_RAM_SUPPORT
903 bool "Support booting from RAM"
904 default y if MICROBLAZE || ARCH_SOCFPGA || TEGRA || ARCH_ZYNQ
906 Enable booting of an image in RAM. The image can be preloaded or
907 it can be loaded by SPL directly into RAM (e.g. using USB).
909 config SPL_RAM_DEVICE
910 bool "Support booting from preloaded image in RAM"
911 depends on SPL_RAM_SUPPORT
912 default y if MICROBLAZE || ARCH_SOCFPGA || TEGRA || ARCH_ZYNQ
914 Enable booting of an image already loaded in RAM. The image has to
915 be already in memory when SPL takes over, e.g. loaded by the boot
918 config SPL_REMOTEPROC
919 bool "Support REMOTEPROCS"
921 Enable support for REMOTEPROCs in SPL. This permits to load
922 a remote processor firmware in SPL.
924 config SPL_RTC_SUPPORT
925 bool "Support RTC drivers"
927 Enable RTC (Real-time Clock) support in SPL. This includes support
928 for reading and setting the time. Some RTC devices also have some
929 non-volatile (battery-backed) memory which is accessible if
930 needed. This enables the drivers in drivers/rtc as part of an SPL
933 config SPL_SATA_SUPPORT
934 bool "Support loading from SATA"
936 Enable support for SATA (Serial AT attachment) in SPL. This allows
937 use of SATA devices such as hard drives and flash drivers for
938 loading U-Boot. SATA is used in higher-end embedded systems and
939 can provide higher performance than MMC , at somewhat higher
940 expense and power consumption. This enables loading from SATA
941 using a configured device.
943 config SPL_SATA_RAW_U_BOOT_USE_SECTOR
944 bool "SATA raw mode: by sector"
945 depends on SPL_SATA_SUPPORT
947 Use sector number for specifying U-Boot location on SATA disk in
950 config SPL_SATA_RAW_U_BOOT_SECTOR
951 hex "Sector on the SATA disk to load U-Boot from"
952 depends on SPL_SATA_RAW_U_BOOT_USE_SECTOR
954 Sector on the SATA disk to load U-Boot from, when the SATA disk is being
955 used in raw mode. Units: SATA disk sectors (1 sector = 512 bytes).
957 config SPL_SERIAL_SUPPORT
958 bool "Support serial"
962 Enable support for serial in SPL. This allows use of a serial UART
963 for displaying messages while SPL is running. It also brings in
964 printf() and panic() functions. This should normally be enabled
965 unless there are space reasons not to. Even then, consider
966 enabling SPL_USE_TINY_PRINTF which is a small printf() version.
968 config SPL_SPI_FLASH_SUPPORT
969 bool "Support SPI flash drivers"
971 Enable support for using SPI flash in SPL, and loading U-Boot from
972 SPI flash. SPI flash (Serial Peripheral Bus flash) is named after
973 the SPI bus that is used to connect it to a system. It is a simple
974 but fast bidirectional 4-wire bus (clock, chip select and two data
975 lines). This enables the drivers in drivers/mtd/spi as part of an
976 SPL build. This normally requires SPL_SPI_SUPPORT.
978 if SPL_SPI_FLASH_SUPPORT
980 config SPL_SPI_FLASH_TINY
981 bool "Enable low footprint SPL SPI Flash support"
982 depends on !SPI_FLASH_BAR
983 default y if SPI_FLASH
985 Enable lightweight SPL SPI Flash support that supports just reading
986 data/images from flash. No support to write/erase flash. Enable
987 this if you have SPL size limitations and don't need full
988 fledged SPI flash support.
990 config SPL_SPI_FLASH_SFDP_SUPPORT
991 bool "SFDP table parsing support for SPI NOR flashes"
992 depends on !SPI_FLASH_BAR && !SPL_SPI_FLASH_TINY
994 Enable support for parsing and auto discovery of parameters for
995 SPI NOR flashes using Serial Flash Discoverable Parameters (SFDP)
996 tables as per JESD216 standard in SPL.
999 bool "Support loading from SPI flash"
1001 Enable support for loading next stage, U-Boot or otherwise, from
1002 SPI NOR in U-Boot SPL.
1004 endif # SPL_SPI_FLASH_SUPPORT
1006 config SYS_SPI_U_BOOT_OFFS
1007 hex "address of u-boot payload in SPI flash"
1009 depends on SPL_SPI_LOAD || SPL_SPI_SUNXI
1011 Address within SPI-Flash from where the u-boot payload is fetched
1014 config SPL_SPI_SUPPORT
1015 bool "Support SPI drivers"
1017 Enable support for using SPI in SPL. This is used for connecting
1018 to SPI flash for loading U-Boot. See SPL_SPI_FLASH_SUPPORT for
1019 more details on that. The SPI driver provides the transport for
1020 data between the SPI flash and the CPU. This option can be used to
1021 enable SPI drivers that are needed for other purposes also, such
1025 bool "Driver support for thermal devices"
1027 Enable support for temperature-sensing devices. Some SoCs have on-chip
1028 temperature sensors to permit warnings, speed throttling or even
1029 automatic power-off when the temperature gets too high or low. Other
1030 devices may be discrete but connected on a suitable bus.
1032 config SPL_USB_HOST_SUPPORT
1033 bool "Support USB host drivers"
1034 select HAVE_BLOCK_DEVICE
1036 Enable access to USB (Universal Serial Bus) host devices so that
1037 SPL can load U-Boot from a connected USB peripheral, such as a USB
1038 flash stick. While USB takes a little longer to start up than most
1039 buses, it is very flexible since many different types of storage
1040 device can be attached. This option enables the drivers in
1041 drivers/usb/host as part of an SPL build.
1043 config SPL_USB_STORAGE
1044 bool "Support loading from USB"
1045 depends on SPL_USB_HOST_SUPPORT && !(BLK && !DM_USB)
1047 Enable support for USB devices in SPL. This allows use of USB
1048 devices such as hard drives and flash drivers for loading U-Boot.
1049 The actual drivers are enabled separately using the normal U-Boot
1050 config options. This enables loading from USB using a configured
1053 config SPL_USB_GADGET
1054 bool "Suppport USB Gadget drivers"
1056 Enable USB Gadget API which allows to enable USB device functions
1061 config SPL_USB_ETHER
1062 bool "Support USB Ethernet drivers"
1064 Enable access to the USB network subsystem and associated
1065 drivers in SPL. This permits SPL to load U-Boot over a
1066 USB-connected Ethernet link (such as a USB Ethernet dongle) rather
1067 than from an onboard peripheral. Environment support is required
1068 since the network stack uses a number of environment variables.
1069 See also SPL_NET_SUPPORT and SPL_ETH_SUPPORT.
1072 bool "Support DFU (Device Firmware Upgrade)"
1073 select SPL_HASH_SUPPORT
1074 select SPL_DFU_NO_RESET
1075 depends on SPL_RAM_SUPPORT
1077 This feature enables the DFU (Device Firmware Upgrade) in SPL with
1078 RAM memory device support. The ROM code will load and execute
1079 the SPL built with dfu. The user can load binaries (u-boot/kernel) to
1080 selected device partition from host-pc using dfu-utils.
1081 This feature is useful to flash the binaries to factory or bare-metal
1082 boards using USB interface.
1085 bool "DFU device selection"
1090 depends on SPL_DFU && SPL_RAM_SUPPORT
1092 select RAM/DDR memory device for loading binary images
1093 (u-boot/kernel) to the selected device partition using
1094 DFU and execute the u-boot/kernel from RAM.
1098 config SPL_USB_SDP_SUPPORT
1099 bool "Support SDP (Serial Download Protocol)"
1101 Enable Serial Download Protocol (SDP) device support in SPL. This
1102 allows to download images into memory and execute (jump to) them
1103 using the same protocol as implemented by the i.MX family's boot ROM.
1106 config SPL_WATCHDOG_SUPPORT
1107 bool "Support watchdog drivers"
1108 imply SPL_WDT if !HW_WATCHDOG
1110 Enable support for watchdog drivers in SPL. A watchdog is
1111 typically a hardware peripheral which can reset the system when it
1112 detects no activity for a while (such as a software crash). This
1113 enables the drivers in drivers/watchdog as part of an SPL build.
1115 config SPL_YMODEM_SUPPORT
1116 bool "Support loading using Ymodem"
1117 depends on SPL_SERIAL_SUPPORT
1119 While loading from serial is slow it can be a useful backup when
1120 there is no other option. The Ymodem protocol provides a reliable
1121 means of transmitting U-Boot over a serial line for using in SPL,
1122 with a checksum to ensure correctness.
1125 bool "Support ARM Trusted Firmware"
1128 ATF(ARM Trusted Firmware) is a component for ARM AArch64 which
1129 is loaded by SPL (which is considered as BL2 in ATF terminology).
1130 More detail at: https://github.com/ARM-software/arm-trusted-firmware
1132 config SPL_ATF_NO_PLATFORM_PARAM
1133 bool "Pass no platform parameter"
1136 While we expect to call a pointer to a valid FDT (or NULL)
1137 as the platform parameter to an ATF, some ATF versions are
1138 not U-Boot aware and have an insufficiently robust parameter
1139 validation to gracefully reject a FDT being passed.
1141 If this option is enabled, the spl_atf os-type handler will
1142 always pass NULL for the platform parameter.
1144 If your ATF is affected, say Y.
1146 config SPL_AM33XX_ENABLE_RTC32K_OSC
1147 bool "Enable the RTC32K OSC on AM33xx based platforms"
1150 Enable access to the AM33xx RTC and select the external 32kHz clock
1154 bool "Support OP-TEE Trusted OS"
1157 OP-TEE is an open source Trusted OS which is loaded by SPL.
1158 More detail at: https://github.com/OP-TEE/optee_os
1161 bool "Support RISC-V OpenSBI"
1162 depends on RISCV && SPL_RISCV_MMODE && RISCV_SMODE
1164 OpenSBI is an open-source implementation of the RISC-V Supervisor Binary
1165 Interface (SBI) specification. U-Boot supports the OpenSBI FW_DYNAMIC
1166 firmware. It is loaded and started by U-Boot SPL.
1168 More details are available at https://github.com/riscv/opensbi and
1169 https://github.com/riscv/riscv-sbi-doc
1171 config SPL_OPENSBI_LOAD_ADDR
1172 hex "OpenSBI load address"
1173 depends on SPL_OPENSBI
1175 Load address of the OpenSBI binary.
1179 depends on SUPPORT_TPL
1182 If you want to build TPL as well as the normal image and SPL, say Y.
1187 bool "Pass hand-off information from TPL to SPL and U-Boot proper"
1188 depends on HANDOFF && TPL_BLOBLIST
1191 This option enables TPL to write handoff information. This can be
1192 used to pass information like the size of SDRAM from TPL to U-Boot
1193 proper. The information is also available to SPL if it is useful
1196 config TPL_BOARD_INIT
1197 bool "Call board-specific initialization in TPL"
1199 If this option is enabled, U-Boot will call the function
1200 spl_board_init() from board_init_r(). This function should be
1201 provided by the board.
1204 string "Linker script for the TPL stage"
1206 default "arch/arm/cpu/armv8/u-boot-spl.lds" if ARM64
1207 default "arch/$(ARCH)/cpu/u-boot-spl.lds"
1209 The TPL stage will usually require a different linker-script
1210 (as it runs from a different memory region) than the regular
1211 U-Boot stage. Set this to the path of the linker-script to
1214 May be left empty to trigger the Makefile infrastructure to
1215 fall back to the linker-script used for the SPL stage.
1217 config TPL_NEEDS_SEPARATE_TEXT_BASE
1218 bool "TPL needs a separate text-base"
1222 Enable, if the TPL stage should not inherit its text-base
1223 from the SPL stage. When enabled, a base address for the
1224 .text sections of the TPL stage has to be set below.
1226 config TPL_NEEDS_SEPARATE_STACK
1227 bool "TPL needs a separate initial stack-pointer"
1231 Enable, if the TPL stage should not inherit its initial
1232 stack-pointer from the settings for the SPL stage.
1234 config TPL_TEXT_BASE
1235 hex "Base address for the .text section of the TPL stage"
1236 depends on TPL_NEEDS_SEPARATE_TEXT_BASE
1238 The base address for the .text section of the TPL stage.
1241 int "Maximum size (in bytes) for the TPL stage"
1245 The maximum size (in bytes) of the TPL stage.
1248 hex "Address of the initial stack-pointer for the TPL stage"
1249 depends on TPL_NEEDS_SEPARATE_STACK
1251 The address of the initial stack-pointer for the TPL stage.
1252 Usually this will be the (aligned) top-of-stack.
1254 config TPL_BOOTROM_SUPPORT
1255 bool "Support returning to the BOOTROM (from TPL)"
1257 Some platforms (e.g. the Rockchip RK3368) provide support in their
1258 ROM for loading the next boot-stage after performing basic setup
1261 Enable this option, to return to the BOOTROM through the
1262 BOOT_DEVICE_BOOTROM (or fall-through to the next boot device in the
1263 boot device list, if not implemented for a given board)
1265 config TPL_DRIVERS_MISC_SUPPORT
1266 bool "Support misc drivers in TPL"
1268 Enable miscellaneous drivers in TPL. These drivers perform various
1269 tasks that don't fall nicely into other categories, Enable this
1270 option to build the drivers in drivers/misc as part of an TPL
1271 build, for those that support building in TPL (not all drivers do).
1273 config TPL_ENV_SUPPORT
1274 bool "Support an environment"
1276 Enable environment support in TPL. See SPL_ENV_SUPPORT for details.
1278 config TPL_GPIO_SUPPORT
1279 bool "Support GPIO in TPL"
1281 Enable support for GPIOs (General-purpose Input/Output) in TPL.
1282 GPIOs allow U-Boot to read the state of an input line (high or
1283 low) and set the state of an output line. This can be used to
1284 drive LEDs, control power to various system parts and read user
1285 input. GPIOs can be useful in TPL to enable a 'sign-of-life' LED,
1286 for example. Enable this option to build the drivers in
1287 drivers/gpio as part of an TPL build.
1289 config TPL_I2C_SUPPORT
1292 Enable support for the I2C bus in TPL. See SPL_I2C_SUPPORT for
1295 config TPL_LIBCOMMON_SUPPORT
1296 bool "Support common libraries"
1298 Enable support for common U-Boot libraries within TPL. See
1299 SPL_LIBCOMMON_SUPPORT for details.
1301 config TPL_LIBGENERIC_SUPPORT
1302 bool "Support generic libraries"
1304 Enable support for generic U-Boot libraries within TPL. See
1305 SPL_LIBGENERIC_SUPPORT for details.
1307 config TPL_MPC8XXX_INIT_DDR_SUPPORT
1308 bool "Support MPC8XXX DDR init"
1310 Enable support for DDR-SDRAM on the MPC8XXX family within TPL. See
1311 SPL_MPC8XXX_INIT_DDR_SUPPORT for details.
1313 config TPL_MMC_SUPPORT
1317 Enable support for MMC within TPL. See SPL_MMC_SUPPORT for details.
1319 config TPL_NAND_SUPPORT
1320 bool "Support NAND flash"
1322 Enable support for NAND in TPL. See SPL_NAND_SUPPORT for details.
1325 bool "Support PCI drivers"
1327 Enable support for PCI in TPL. For platforms that need PCI to boot,
1328 or must perform some init using PCI in SPL, this provides the
1329 necessary driver support. This enables the drivers in drivers/pci
1330 as part of a TPL build.
1332 config TPL_PCH_SUPPORT
1333 bool "Support PCH drivers"
1335 Enable support for PCH (Platform Controller Hub) devices in TPL.
1336 These are used to set up GPIOs and the SPI peripheral early in
1337 boot. This enables the drivers in drivers/pch as part of a TPL
1340 config TPL_RAM_SUPPORT
1341 bool "Support booting from RAM"
1343 Enable booting of an image in RAM. The image can be preloaded or
1344 it can be loaded by TPL directly into RAM (e.g. using USB).
1346 config TPL_RAM_DEVICE
1347 bool "Support booting from preloaded image in RAM"
1348 depends on TPL_RAM_SUPPORT
1350 Enable booting of an image already loaded in RAM. The image has to
1351 be already in memory when TPL takes over, e.g. loaded by the boot
1354 config TPL_RTC_SUPPORT
1355 bool "Support RTC drivers"
1357 Enable RTC (Real-time Clock) support in TPL. This includes support
1358 for reading and setting the time. Some RTC devices also have some
1359 non-volatile (battery-backed) memory which is accessible if
1360 needed. This enables the drivers in drivers/rtc as part of an TPL
1363 config TPL_SERIAL_SUPPORT
1364 bool "Support serial"
1368 Enable support for serial in TPL. See SPL_SERIAL_SUPPORT for
1371 config TPL_SPI_FLASH_SUPPORT
1372 bool "Support SPI flash drivers"
1374 Enable support for using SPI flash in TPL. See SPL_SPI_FLASH_SUPPORT
1378 bool "Support loading from SPI flash"
1379 depends on TPL_SPI_FLASH_SUPPORT
1381 Enable support for loading next stage, U-Boot or otherwise, from
1382 SPI NOR in U-Boot TPL.
1384 config TPL_SPI_SUPPORT
1385 bool "Support SPI drivers"
1387 Enable support for using SPI in TPL. See SPL_SPI_SUPPORT for
1390 config TPL_YMODEM_SUPPORT
1391 bool "Support loading using Ymodem"
1392 depends on TPL_SERIAL_SUPPORT
1394 While loading from serial is slow it can be a useful backup when
1395 there is no other option. The Ymodem protocol provides a reliable
1396 means of transmitting U-Boot over a serial line for using in TPL,
1397 with a checksum to ensure correctness.
1401 config SPL_AT91_MCK_BYPASS
1402 bool "Use external clock signal as a source of main clock for AT91 platforms"
1403 depends on ARCH_AT91
1406 Use external 8 to 24 Mhz clock signal as source of main clock instead
1407 of an external crystal oscillator.
1408 This option disables the internal driving on the XOUT pin.
1409 The external source has to provide a stable clock on the XIN pin.
1410 If this option is disabled, the SoC expects a crystal oscillator
1411 that needs driving on both XIN and XOUT lines.