1 menu "Library routines"
4 bool "Enable support for non-identity virtual-physical mappings"
6 Enables helper code for implementing non-identity virtual-physical
7 memory mappings for 32bit CPUs.
9 This library only works in the post-relocation phase.
11 config SYS_NUM_ADDR_MAP
12 int "Size of the address-map table"
16 Sets the number of entries in the virtual-physical mapping table.
19 bool "Access to physical memory region (> 4G)"
21 Some basic support is provided for operations on memory not
22 normally accessible to 32-bit U-Boot - e.g. some architectures
23 support access to more than 4G of memory on 32-bit
24 machines using physical address extension or similar.
25 Enable this to access this basic support, which only supports clearing
29 bool "Enable Software based BCH ECC"
31 Enables software based BCH ECC algorithm present in lib/bch.c
32 This is used by SoC platforms which do not have built-in ELM
33 hardware engine required for BCH ECC correction.
36 bool "Allow access to binman information in the device tree"
37 depends on BINMAN && DM && OF_CONTROL
38 default y if OF_SEPARATE || OF_EMBED
40 This enables U-Boot to access information about binman entries,
41 stored in the device tree in a binman node. Typical uses are to
42 locate entries in the firmware image. See binman.h for the available
45 config CC_OPTIMIZE_LIBS_FOR_SPEED
46 bool "Optimize libraries for speed"
48 Enabling this option will pass "-O2" to gcc when compiling
49 under "lib" directory.
55 default y if UT_UNICODE || EFI_LOADER || UFS || EFI_APP
57 Enables support for various conversions between different
58 character sets, such as between unicode representations and
59 different 'code pages'.
61 config DYNAMIC_CRC_TABLE
62 bool "Enable Dynamic tables for CRC"
64 Enable this option to calculate entries for CRC tables at runtime.
65 This can be helpful when reducing the size of the build image
67 config HAVE_ARCH_IOMAP
70 Enable this option if architecture provides io{read,write}{8,16,32}
71 I/O accessor functions.
73 config HAVE_PRIVATE_LIBGCC
86 select SPL_STRTO if !SPL_USE_TINY_PRINTF
91 select TPL_STRTO if !TPL_USE_TINY_PRINTF
119 config IMAGE_SPARSE_FILLBUF_SIZE
120 hex "Android sparse image CHUNK_TYPE_FILL buffer size"
122 depends on IMAGE_SPARSE
124 Set the size of the fill buffer used when processing CHUNK_TYPE_FILL
127 config USE_PRIVATE_LIBGCC
128 bool "Use private libgcc"
129 depends on HAVE_PRIVATE_LIBGCC
130 default y if HAVE_PRIVATE_LIBGCC && ((ARM && !ARM64) || MIPS)
132 This option allows you to use the built-in libgcc implementation
133 of U-Boot instead of the one provided by the compiler.
140 The frequency of the timer returned by get_timer().
141 get_timer() must operate in milliseconds and this option must be
144 config SPL_USE_TINY_PRINTF
145 bool "Enable tiny printf() version in SPL"
149 This option enables a tiny, stripped down printf version.
150 This should only be used in space limited environments,
151 like SPL versions with hard memory limits. This version
152 reduces the code size by about 2.5KiB on armv7.
154 The supported format specifiers are %c, %s, %u/%d and %x.
156 config TPL_USE_TINY_PRINTF
157 bool "Enable tiny printf() version in TPL"
159 default y if SPL_USE_TINY_PRINTF
161 This option enables a tiny, stripped down printf version.
162 This should only be used in space limited environments,
163 like SPL versions with hard memory limits. This version
164 reduces the code size by about 2.5KiB on armv7.
166 The supported format specifiers are %c, %s, %u/%d and %x.
169 bool "Do not reset the system on fatal error"
171 Define this option to stop the system in case of a fatal error,
172 so that you have to reset it manually. This is probably NOT a good
173 idea for an embedded system where you want the system to reboot
174 automatically as fast as possible, but it may be useful during
175 development since you can try to debug the conditions that lead to
179 bool "Enable regular expression support"
182 If this variable is defined, U-Boot is linked against the
183 SLRE (Super Light Regular Expression) library, which adds
184 regex support to some commands, for example "env grep" and
188 prompt "Pseudo-random library support type"
189 depends on NET_RANDOM_ETHADDR || RANDOM_UUID || CMD_UUID || \
190 RNG_SANDBOX || UT_LIB && AES || FAT_WRITE
193 Select the library to provide pseudo-random number generator
194 functions. LIB_HW_RAND supports certain hardware engines that
195 provide this functionality. If in doubt, select LIB_RAND.
198 bool "Pseudo-random library support"
201 bool "HW Engine for random library support"
208 Enable this if your arch or board can support generating ACPI
209 (Advanced Configuration and Power Interface) tables. In this case
210 U-Boot can generate these tables and pass them to the Operating
213 config GENERATE_ACPI_TABLE
214 bool "Generate an ACPI (Advanced Configuration and Power Interface) table"
215 depends on SUPPORT_ACPI
218 The Advanced Configuration and Power Interface (ACPI) specification
219 provides an open standard for device configuration and management
220 by the operating system. It defines platform-independent interfaces
221 for configuration and power management monitoring.
223 config SPL_TINY_MEMSET
224 bool "Use a very small memset() in SPL"
226 The faster memset() is the arch-specific one (if available) enabled
227 by CONFIG_USE_ARCH_MEMSET. If that is not enabled, we can still get
228 better performance by writing a word at a time. But in very
229 size-constrained environments even this may be too big. Enable this
230 option to reduce code size slightly at the cost of some speed.
232 config TPL_TINY_MEMSET
233 bool "Use a very small memset() in TPL"
235 The faster memset() is the arch-specific one (if available) enabled
236 by CONFIG_USE_ARCH_MEMSET. If that is not enabled, we can still get
237 better performance by writing a word at a time. But in very
238 size-constrained environments even this may be too big. Enable this
239 option to reduce code size slightly at the cost of some speed.
245 bool "Bit reverse library from Linux"
248 bool "Support for tracing of function calls and timing"
252 Enables function tracing within U-Boot. This allows recording of call
253 traces including timing information. The command can write data to
254 memory for exporting for analysis (e.g. using bootchart).
255 See doc/README.trace for full details.
257 config TRACE_BUFFER_SIZE
258 hex "Size of trace buffer in U-Boot"
262 Sets the size of the trace buffer in U-Boot. This is allocated from
263 memory during relocation. If this buffer is too small, the trace
264 history will be truncated, with later records omitted.
266 If early trace is enabled (i.e. before relocation), this buffer must
267 be large enough to include all the data from the early trace buffer as
268 well, since this is copied over to the main buffer during relocation.
270 A trace record is emitted for each function call and each record is
271 12 bytes (see struct trace_call). A suggested minimum size is 1MB. If
272 the size is too small then 'trace stats' will show a message saying
273 how many records were dropped due to buffer overflow.
275 config TRACE_CALL_DEPTH_LIMIT
276 int "Trace call depth limit"
280 Sets the maximum call depth up to which function calls are recorded.
283 bool "Enable tracing before relocation"
286 Sometimes it is helpful to trace execution of U-Boot before
287 relocation. This is possible by using a arch-specific, fixed buffer
288 position in memory. Enable this option to start tracing as early as
289 possible after U-Boot starts.
291 config TRACE_EARLY_SIZE
292 hex "Size of early trace buffer in U-Boot"
293 depends on TRACE_EARLY
296 Sets the size of the early trace buffer in bytes. This is used to hold
297 tracing information before relocation.
299 config TRACE_EARLY_CALL_DEPTH_LIMIT
300 int "Early trace call depth limit"
301 depends on TRACE_EARLY
304 Sets the maximum call depth up to which function calls are recorded
305 during early tracing.
307 config TRACE_EARLY_ADDR
308 hex "Address of early trace buffer in U-Boot"
309 depends on TRACE_EARLY
312 Sets the address of the early trace buffer in U-Boot. This memory
313 must be accessible before relocation.
315 A trace record is emitted for each function call and each record is
316 12 bytes (see struct trace_call). A suggested minimum size is 1MB. If
317 the size is too small then the message which says the amount of early
318 data being coped will the the same as the
321 bool "Enable circular buffer support"
323 source lib/dhry/Kconfig
325 menu "Security support"
328 bool "Support the AES algorithm"
330 This provides a means to encrypt and decrypt data using the AES
331 (Advanced Encryption Standard). This algorithm uses a symetric key
332 and is widely used as a streaming cipher. Different key lengths are
333 supported by the algorithm but only a 128-bit key is supported at
336 source lib/ecdsa/Kconfig
337 source lib/rsa/Kconfig
338 source lib/crypto/Kconfig
339 source lib/crypt/Kconfig
342 bool "Trusted Platform Module (TPM) Support"
345 This enables support for TPMs which can be used to provide security
346 features for your board. The TPM can be connected via LPC or I2C
347 and a sandbox TPM is provided for testing purposes. Use the 'tpm'
348 command to interactive the TPM. Driver model support is provided
349 for the low-level TPM interface, but only one TPM is supported at
350 a time by the TPM library.
353 bool "Trusted Platform Module (TPM) Support in SPL"
356 This enables support for TPMs which can be used to provide security
357 features for your board. The TPM can be connected via LPC or I2C
358 and a sandbox TPM is provided for testing purposes. Use the 'tpm'
359 command to interactive the TPM. Driver model support is provided
360 for the low-level TPM interface, but only one TPM is supported at
361 a time by the TPM library.
364 bool "Trusted Platform Module (TPM) Support in TPL"
367 This enables support for TPMs which can be used to provide security
368 features for your board. The TPM can be connected via LPC or I2C
369 and a sandbox TPM is provided for testing purposes. Use the 'tpm'
370 command to interactive the TPM. Driver model support is provided
371 for the low-level TPM interface, but only one TPM is supported at
372 a time by the TPM library.
376 menu "Android Verified Boot"
379 bool "Android Verified Boot 2.0 support"
380 depends on ANDROID_BOOT_IMAGE
382 This enables support of Android Verified Boot 2.0 which can be used
383 to assure the end user of the integrity of the software running on a
384 device. Introduces such features as boot chain of trust, rollback
389 menu "Hashing Support"
392 bool "Enable BLAKE2 support"
394 This option enables support of hashing using BLAKE2B algorithm.
395 The hash is calculated in software.
396 The BLAKE2 algorithm produces a hash value (digest) between 1 and
400 bool "Enable SHA1 support"
402 This option enables support of hashing using SHA1 algorithm.
403 The hash is calculated in software.
404 The SHA1 algorithm produces a 160-bit (20-byte) hash value
408 bool "Enable SHA256 support"
410 This option enables support of hashing using SHA256 algorithm.
411 The hash is calculated in software.
412 The SHA256 algorithm produces a 256-bit (32-byte) hash value
416 bool "Enable SHA512 support"
418 This option enables support of hashing using SHA512 algorithm.
419 The hash is calculated in software.
420 The SHA512 algorithm produces a 512-bit (64-byte) hash value
424 bool "Enable SHA384 support"
427 This option enables support of hashing using SHA384 algorithm.
428 The hash is calculated in software. This is also selects SHA512,
429 because these implementations share the bulk of the code..
430 The SHA384 algorithm produces a 384-bit (48-byte) hash value
434 bool "Enable hardware acceleration for SHA hash functions"
436 This option enables hardware acceleration for the SHA1 and SHA256
437 hashing algorithms. This affects the 'hash' command and also the
438 hash_lookup_algo() function.
443 bool "Enable SHA1 support in SPL"
446 This option enables support of hashing using SHA1 algorithm.
447 The hash is calculated in software.
448 The SHA1 algorithm produces a 160-bit (20-byte) hash value
452 bool "Enable SHA256 support in SPL"
455 This option enables support of hashing using SHA256 algorithm.
456 The hash is calculated in software.
457 The SHA256 algorithm produces a 256-bit (32-byte) hash value
461 bool "Enable SHA512 support in SPL"
464 This option enables support of hashing using SHA512 algorithm.
465 The hash is calculated in software.
466 The SHA512 algorithm produces a 512-bit (64-byte) hash value
470 bool "Enable SHA384 support in SPL"
474 This option enables support of hashing using SHA384 algorithm.
475 The hash is calculated in software. This is also selects SHA512,
476 because these implementations share the bulk of the code..
477 The SHA384 algorithm produces a 384-bit (48-byte) hash value
480 config SPL_SHA_HW_ACCEL
481 bool "Enable hardware acceleration for SHA hash functions"
482 default y if SHA_HW_ACCEL
484 This option enables hardware acceleration for the SHA1 and SHA256
485 hashing algorithms. This affects the 'hash' command and also the
486 hash_lookup_algo() function.
488 config SPL_SHA_PROG_HW_ACCEL
489 bool "Enable Progressive hashing support using hardware in SPL"
490 depends on SHA_PROG_HW_ACCEL
493 This option enables hardware-acceleration for SHA progressive
495 Data can be streamed in a block at a time and the hashing is
496 performed in hardware.
502 config SHA512_HW_ACCEL
503 bool "Enable hardware acceleration for SHA512"
506 This option enables hardware acceleration for the SHA384 and SHA512
507 hashing algorithms. This affects the 'hash' command and also the
508 hash_lookup_algo() function.
510 config SHA_PROG_HW_ACCEL
511 bool "Enable Progressive hashing support using hardware"
513 This option enables hardware-acceleration for SHA progressive
515 Data can be streamed in a block at a time and the hashing is
516 performed in hardware.
521 bool "Support MD5 algorithm"
523 This option enables MD5 support. MD5 is an algorithm designed
524 in 1991 that produces a 16-byte digest (or checksum) from its input
525 data. It has a number of vulnerabilities which preclude its use in
526 security applications, but it can be useful for providing a quick
527 checksum of a block of data.
530 bool "Support MD5 algorithm in SPL"
532 This option enables MD5 support in SPL. MD5 is an algorithm designed
533 in 1991 that produces a 16-byte digest (or checksum) from its input
534 data. It has a number of vulnerabilities which preclude its use in
535 security applications, but it can be useful for providing a quick
536 checksum of a block of data.
541 Enables CRC32 support in U-Boot. This is normally required.
551 menu "Compression Support"
554 bool "Enable LZ4 decompression support"
556 If this option is set, support for LZ4 compressed images
557 is included. The LZ4 algorithm can run in-place as long as the
558 compressed image is loaded to the end of the output buffer, and
559 trades lower compression ratios for much faster decompression.
561 NOTE: This implements the release version of the LZ4 frame
562 format as generated by default by the 'lz4' command line tool.
563 This is not the same as the outdated, less efficient legacy
564 frame format currently (2015) implemented in the Linux kernel
565 (generated by 'lz4 -l'). The two formats are incompatible.
568 bool "Enable LZMA decompression support"
570 This enables support for LZMA (Lempel-Ziv-Markov chain algorithm),
571 a dictionary compression algorithm that provides a high compression
572 ratio and fairly fast decompression speed. See also
573 CONFIG_CMD_LZMADEC which provides a decode command.
576 bool "Enable LZO decompression support"
578 This enables support for the LZO compression algorithm.
581 bool "Enable gzip decompression support"
585 This enables support for GZIP compression algorithm.
587 config ZLIB_UNCOMPRESS
588 bool "Enables zlib's uncompress() functionality"
590 This enables an extra zlib functionality: the uncompress() function,
591 which decompresses data from a buffer into another, knowing their
592 sizes. Unlike gunzip(), there is no header parsing.
594 config GZIP_COMPRESSED
599 bool "Enable bzip2 decompression support"
601 This enables support for BZIP2 compression algorithm.
607 This enables ZLIB compression lib.
610 bool "Enable Zstandard decompression support"
613 This enables Zstandard decompression library.
616 bool "Enable LZ4 decompression support in SPL"
618 This enables support for the LZ4 decompression algorithm in SPL. LZ4
619 is a lossless data compression algorithm that is focused on
620 fast compression and decompression speed. It belongs to the LZ77
621 family of byte-oriented compression schemes.
624 bool "Enable LZMA decompression support for SPL build"
626 This enables support for LZMA compression algorithm for SPL boot.
629 bool "Enable LZO decompression support in SPL"
631 This enables support for LZO compression algorithm in the SPL.
634 bool "Enable gzip decompression support for SPL build"
637 This enables support for the GZIP compression algorithm for SPL boot.
642 This enables compression lib for SPL boot.
645 bool "Enable Zstandard decompression support in SPL"
648 This enables Zstandard decompression library in the SPL.
653 bool "Enable function for getting errno-related string message"
655 The function errno_str(int errno), returns a pointer to the errno
656 corresponding text message:
657 - if errno is null or positive number - a pointer to "Success" message
658 - if errno is negative - a pointer to errno related message
661 bool "Enable hexdump"
663 This enables functions for printing dumps of binary data.
666 bool "Enable hexdump in SPL"
667 depends on SPL && HEXDUMP
669 This enables functions for printing dumps of binary data in
675 This enables functions for parsing command-line options.
678 bool "Enable the FDT library"
679 default y if OF_CONTROL
681 This enables the FDT library (libfdt). It provides functions for
682 accessing binary device tree images in memory, such as adding and
683 removing nodes and properties, scanning through the tree and finding
684 particular compatible nodes. The library operates on a flattened
685 version of the device tree.
687 config OF_LIBFDT_ASSUME_MASK
688 hex "Mask of conditions to assume for libfdt"
689 depends on OF_LIBFDT || FIT
692 Use this to change the assumptions made by libfdt about the
693 device tree it is working with. A value of 0 means that no assumptions
694 are made, and libfdt is able to deal with malicious data. A value of
695 0xff means all assumptions are made and any invalid data may cause
696 unsafe execution. See FDT_ASSUME_PERFECT, etc. in libfdt_internal.h
698 config OF_LIBFDT_OVERLAY
699 bool "Enable the FDT library overlay support"
701 default y if ARCH_OMAP2PLUS || ARCH_KEYSTONE
703 This enables the FDT library (libfdt) overlay support.
706 bool "Enable the FDT library for SPL"
707 default y if SPL_OF_CONTROL
709 This enables the FDT library (libfdt). It provides functions for
710 accessing binary device tree images in memory, such as adding and
711 removing nodes and properties, scanning through the tree and finding
712 particular compatible nodes. The library operates on a flattened
713 version of the device tree.
715 config SPL_OF_LIBFDT_ASSUME_MASK
716 hex "Mask of conditions to assume for libfdt"
717 depends on SPL_OF_LIBFDT || FIT
720 Use this to change the assumptions made by libfdt in SPL about the
721 device tree it is working with. A value of 0 means that no assumptions
722 are made, and libfdt is able to deal with malicious data. A value of
723 0xff means all assumptions are made and any invalid data may cause
724 unsafe execution. See FDT_ASSUME_PERFECT, etc. in libfdt_internal.h
727 bool "Enable the FDT library for TPL"
728 default y if TPL_OF_CONTROL
730 This enables the FDT library (libfdt). It provides functions for
731 accessing binary device tree images in memory, such as adding and
732 removing nodes and properties, scanning through the tree and finding
733 particular compatible nodes. The library operates on a flattened
734 version of the device tree.
736 config TPL_OF_LIBFDT_ASSUME_MASK
737 hex "Mask of conditions to assume for libfdt"
738 depends on TPL_OF_LIBFDT || FIT
741 Use this to change the assumptions made by libfdt in TPL about the
742 device tree it is working with. A value of 0 means that no assumptions
743 are made, and libfdt is able to deal with malicious data. A value of
744 0xff means all assumptions are made and any invalid data may cause
745 unsafe execution. See FDT_ASSUME_PERFECT, etc. in libfdt_internal.h
747 config FDT_FIXUP_PARTITIONS
748 bool "overwrite MTD partitions in DTS through defined in 'mtdparts'"
750 depends on CMD_MTDPARTS
752 Allow overwriting defined partitions in the device tree blob
753 using partition info defined in the 'mtdparts' environment
757 depends on (!EFI && !SYS_COREBOOT) || (ARM && EFI_LOADER)
759 config BLOBLIST_TABLES
760 bool "Put tables in a bloblist"
761 depends on X86 && BLOBLIST
763 Normally tables are placed at address 0xf0000 and can be up to 64KB
764 long. With this option, tables are instead placed in the bloblist
765 with a pointer from 0xf0000. The size can then be larger and the
766 tables can be placed high in memory.
768 config GENERATE_SMBIOS_TABLE
769 bool "Generate an SMBIOS (System Management BIOS) table"
771 depends on X86 || EFI_LOADER
773 The System Management BIOS (SMBIOS) specification addresses how
774 motherboard and system vendors present management information about
775 their products in a standard format by extending the BIOS interface
776 on Intel architecture systems.
778 Check http://www.dmtf.org/standards/smbios for details.
780 See also SMBIOS_SYSINFO which allows SMBIOS values to be provided in
784 bool "enable continued fraction calculation routines"
786 config SPL_LIB_RATIONAL
787 bool "enable continued fraction calculation routines for SPL"
795 ASN.1 (Abstract Syntax Notation One) is a standard interface
796 description language for defining data structures that can be
797 serialized and deserialized in a cross-platform way. It is
798 broadly used in telecommunications and computer networking,
799 and especially in cryptography (https://en.wikipedia.org/wiki/ASN.1).
800 This option enables the support of the asn1 compiler.
805 ASN.1 (Abstract Syntax Notation One) is a standard interface
806 description language for defining data structures that can be
807 serialized and deserialized in a cross-platform way. It is
808 broadly used in telecommunications and computer networking,
809 and especially in cryptography (https://en.wikipedia.org/wiki/ASN.1).
810 This option enables the support of the asn1 decoder.
812 config SPL_ASN1_DECODER
815 ASN.1 (Abstract Syntax Notation One) is a standard interface
816 description language for defining data structures that can be
817 serialized and deserialized in a cross-platform way. It is
818 broadly used in telecommunications and computer networking,
819 and especially in cryptography (https://en.wikipedia.org/wiki/ASN.1).
820 This option enables the support of the asn1 decoder in the SPL.
825 In computing, object identifiers or OIDs are an identifier mechanism
826 standardized by the International Telecommunication Union (ITU) and
827 ISO/IEC for naming any object, concept, or "thing" with a globally
828 unambiguous persistent name (https://en.wikipedia.org/wiki/Object_identifier).
829 Enable fast lookup object identifier registry.
831 config SPL_OID_REGISTRY
834 In computing, object identifiers or OIDs are an identifier mechanism
835 standardized by the International Telecommunication Union (ITU) and
836 ISO/IEC for naming any object, concept, or "thing" with a globally
837 unambiguous persistent name (https://en.wikipedia.org/wiki/Object_identifier).
838 Enable fast lookup object identifier registry in the SPL.
843 A simple parser for SMBIOS data.
845 source lib/efi/Kconfig
846 source lib/efi_loader/Kconfig
847 source lib/optee/Kconfig
850 bool "enable fdtdec test"
859 Support basic elf loading/validating functions.
860 This supports for 32 bit and 64 bit versions.
863 bool "Enable the logical memory blocks library (lmb)"
864 default y if ARC || ARM || M68K || MICROBLAZE || MIPS || \
865 NIOS2 || PPC || RISCV || SANDBOX || SH || X86 || XTENSA
867 Support the library logical memory blocks.
869 config LMB_USE_MAX_REGIONS
870 bool "Use a common number of memory and reserved regions in lmb lib"
874 Define the number of supported memory regions in the library logical
876 This feature allow to reduce the lmb library size by using compiler
877 optimization when LMB_MEMORY_REGIONS == LMB_RESERVED_REGIONS.
879 config LMB_MAX_REGIONS
880 int "Number of memory and reserved regions in lmb lib"
881 depends on LMB && LMB_USE_MAX_REGIONS
884 Define the number of supported regions, memory and reserved, in the
885 library logical memory blocks.
887 config LMB_MEMORY_REGIONS
888 int "Number of memory regions in lmb lib"
889 depends on LMB && !LMB_USE_MAX_REGIONS
892 Define the number of supported memory regions in the library logical
894 The minimal value is CONFIG_NR_DRAM_BANKS.
896 config LMB_RESERVED_REGIONS
897 int "Number of reserved regions in lmb lib"
898 depends on LMB && !LMB_USE_MAX_REGIONS
901 Define the number of supported reserved regions in the library logical
904 config PHANDLE_CHECK_SEQ
905 bool "Enable phandle check while getting sequence number"
907 When there are multiple device tree nodes with same name,
908 enable this config option to distinguish them using
909 phandles in fdtdec_get_alias_seq() function.