2014-07-30 05:08:15 +00:00
|
|
|
#
|
|
|
|
# For a description of the syntax of this configuration file,
|
2016-04-16 09:53:07 +00:00
|
|
|
# see the file Documentation/kbuild/kconfig-language.txt in the
|
|
|
|
# Linux kernel source tree.
|
2014-07-30 05:08:15 +00:00
|
|
|
#
|
2020-03-11 22:11:17 +00:00
|
|
|
mainmenu "U-Boot $(UBOOTVERSION) Configuration"
|
2014-07-30 05:08:15 +00:00
|
|
|
|
2020-05-18 18:48:00 +00:00
|
|
|
comment "Compiler: $(CC_VERSION_TEXT)"
|
|
|
|
|
2020-05-14 12:30:01 +00:00
|
|
|
source "scripts/Kconfig.include"
|
|
|
|
|
2015-02-24 13:26:19 +00:00
|
|
|
# Allow defaults in arch-specific code to override any given here
|
|
|
|
source "arch/Kconfig"
|
|
|
|
|
2014-07-30 05:08:15 +00:00
|
|
|
menu "General setup"
|
|
|
|
|
2017-10-19 21:49:19 +00:00
|
|
|
config BROKEN
|
|
|
|
bool
|
|
|
|
help
|
|
|
|
This option cannot be enabled. It is used as dependency
|
|
|
|
for broken and incomplete features.
|
|
|
|
|
2019-05-29 21:01:29 +00:00
|
|
|
config DEPRECATED
|
|
|
|
bool
|
|
|
|
help
|
|
|
|
This option cannot be enabled. It it used as a dependency for
|
|
|
|
code that relies on deprecated features that will be removed and
|
|
|
|
the conversion deadline has passed.
|
|
|
|
|
2014-08-22 10:42:27 +00:00
|
|
|
config LOCALVERSION
|
|
|
|
string "Local version - append to U-Boot release"
|
|
|
|
help
|
|
|
|
Append an extra string to the end of your U-Boot version.
|
2016-04-16 09:53:07 +00:00
|
|
|
This will show up in your boot log, for example.
|
2014-08-22 10:42:27 +00:00
|
|
|
The string you set here will be appended after the contents of
|
|
|
|
any files with a filename matching localversion* in your
|
|
|
|
object and source tree, in that order. Your total string can
|
|
|
|
be a maximum of 64 characters.
|
|
|
|
|
|
|
|
config LOCALVERSION_AUTO
|
|
|
|
bool "Automatically append version information to the version string"
|
|
|
|
default y
|
|
|
|
help
|
|
|
|
This will try to automatically determine if the current tree is a
|
2016-04-16 09:53:07 +00:00
|
|
|
release tree by looking for Git tags that belong to the current
|
2014-08-22 10:42:27 +00:00
|
|
|
top of tree revision.
|
|
|
|
|
|
|
|
A string of the format -gxxxxxxxx will be added to the localversion
|
2016-04-16 09:53:07 +00:00
|
|
|
if a Git-based tree is found. The string generated by this will be
|
2014-08-22 10:42:27 +00:00
|
|
|
appended after any matching localversion* files, and after the value
|
|
|
|
set in CONFIG_LOCALVERSION.
|
|
|
|
|
|
|
|
(The actual string used here is the first eight characters produced
|
|
|
|
by running the command:
|
|
|
|
|
|
|
|
$ git rev-parse --verify HEAD
|
|
|
|
|
|
|
|
which is done within the script "scripts/setlocalversion".)
|
|
|
|
|
2014-08-22 10:42:29 +00:00
|
|
|
config CC_OPTIMIZE_FOR_SIZE
|
|
|
|
bool "Optimize for size"
|
|
|
|
default y
|
|
|
|
help
|
|
|
|
Enabling this option will pass "-Os" instead of "-O2" to gcc
|
|
|
|
resulting in a smaller U-Boot image.
|
|
|
|
|
|
|
|
This option is enabled by default for U-Boot.
|
|
|
|
|
2020-05-14 12:30:07 +00:00
|
|
|
config OPTIMIZE_INLINING
|
2020-05-14 12:30:08 +00:00
|
|
|
bool "Allow compiler to uninline functions marked 'inline' in full U-Boot"
|
|
|
|
default n
|
|
|
|
help
|
|
|
|
This option determines if U-Boot forces gcc to inline the functions
|
|
|
|
developers have marked 'inline'. Doing so takes away freedom from gcc to
|
|
|
|
do what it thinks is best, which is desirable in some cases for size
|
|
|
|
reasons.
|
|
|
|
|
|
|
|
config SPL_OPTIMIZE_INLINING
|
|
|
|
bool "Allow compiler to uninline functions marked 'inline' in SPL"
|
|
|
|
depends on SPL
|
|
|
|
default n
|
|
|
|
help
|
|
|
|
This option determines if U-Boot forces gcc to inline the functions
|
|
|
|
developers have marked 'inline'. Doing so takes away freedom from gcc to
|
|
|
|
do what it thinks is best, which is desirable in some cases for size
|
|
|
|
reasons.
|
|
|
|
|
|
|
|
config TPL_OPTIMIZE_INLINING
|
|
|
|
bool "Allow compiler to uninline functions marked 'inline' in TPL"
|
|
|
|
depends on TPL
|
2020-05-14 12:30:07 +00:00
|
|
|
default n
|
|
|
|
help
|
|
|
|
This option determines if U-Boot forces gcc to inline the functions
|
|
|
|
developers have marked 'inline'. Doing so takes away freedom from gcc to
|
|
|
|
do what it thinks is best, which is desirable in some cases for size
|
|
|
|
reasons.
|
|
|
|
|
2018-04-09 15:11:45 +00:00
|
|
|
config CC_COVERAGE
|
|
|
|
bool "Enable code coverage analysis"
|
|
|
|
depends on SANDBOX
|
|
|
|
help
|
|
|
|
Enabling this option will pass "--coverage" to gcc to compile
|
|
|
|
and link code instrumented for coverage analysis.
|
|
|
|
|
2020-05-14 12:30:06 +00:00
|
|
|
config CC_HAS_ASM_INLINE
|
|
|
|
def_bool $(success,echo 'void foo(void) { asm inline (""); }' | $(CC) -x c - -c -o /dev/null)
|
|
|
|
|
2016-06-20 21:16:28 +00:00
|
|
|
config DISTRO_DEFAULTS
|
|
|
|
bool "Select defaults suitable for booting general purpose Linux distributions"
|
2018-07-23 13:55:15 +00:00
|
|
|
select AUTO_COMPLETE
|
|
|
|
select CMDLINE_EDITING
|
2016-08-12 12:31:16 +00:00
|
|
|
select CMD_BOOTI if ARM64
|
2018-07-23 13:55:15 +00:00
|
|
|
select CMD_BOOTZ if ARM && !ARM64
|
2018-04-13 20:26:31 +00:00
|
|
|
select CMD_DHCP if CMD_NET
|
2018-04-25 10:16:48 +00:00
|
|
|
select CMD_ENV_EXISTS
|
2016-06-20 21:16:28 +00:00
|
|
|
select CMD_EXT2
|
|
|
|
select CMD_EXT4
|
|
|
|
select CMD_FAT
|
|
|
|
select CMD_FS_GENERIC
|
2018-02-10 21:54:38 +00:00
|
|
|
select CMD_PART if PARTITIONS
|
2018-07-23 13:55:15 +00:00
|
|
|
select CMD_PING if CMD_NET
|
|
|
|
select CMD_PXE if NET
|
2019-11-25 08:07:38 +00:00
|
|
|
select CMD_SYSBOOT
|
2018-07-23 13:55:15 +00:00
|
|
|
select ENV_VARS_UBOOT_CONFIG
|
2016-06-20 21:16:28 +00:00
|
|
|
select HUSH_PARSER
|
2018-02-06 13:58:59 +00:00
|
|
|
select SUPPORT_RAW_INITRD
|
2018-07-23 13:55:15 +00:00
|
|
|
select SYS_LONGHELP
|
|
|
|
imply CMD_MII if NET
|
2018-10-18 07:33:03 +00:00
|
|
|
imply USB_STORAGE
|
2018-07-23 13:55:15 +00:00
|
|
|
imply USE_BOOTCOMMAND
|
2016-06-20 21:16:28 +00:00
|
|
|
help
|
|
|
|
Select this to enable various options and commands which are suitable
|
|
|
|
for building u-boot for booting general purpose Linux distributions.
|
|
|
|
|
2018-02-06 13:58:59 +00:00
|
|
|
config ENV_VARS_UBOOT_CONFIG
|
|
|
|
bool "Add arch, board, vendor and soc variables to default environment"
|
|
|
|
help
|
|
|
|
Define this in order to add variables describing the
|
|
|
|
U-Boot build configuration to the default environment.
|
|
|
|
These will be named arch, cpu, board, vendor, and soc.
|
|
|
|
Enabling this option will cause the following to be defined:
|
|
|
|
- CONFIG_SYS_ARCH
|
|
|
|
- CONFIG_SYS_CPU
|
|
|
|
- CONFIG_SYS_BOARD
|
|
|
|
- CONFIG_SYS_VENDOR
|
|
|
|
- CONFIG_SYS_SOC
|
|
|
|
|
2018-08-13 22:00:04 +00:00
|
|
|
config NR_DRAM_BANKS
|
|
|
|
int "Number of DRAM banks"
|
2020-04-19 13:58:34 +00:00
|
|
|
default 1 if ARCH_SUNXI || ARCH_OWL
|
2018-08-13 22:00:04 +00:00
|
|
|
default 4
|
|
|
|
help
|
|
|
|
This defines the number of DRAM banks.
|
|
|
|
|
2018-01-22 23:17:10 +00:00
|
|
|
config SYS_BOOT_GET_CMDLINE
|
|
|
|
bool "Enable kernel command line setup"
|
|
|
|
help
|
|
|
|
Enables allocating and saving kernel cmdline in space between
|
|
|
|
"bootm_low" and "bootm_low" + BOOTMAPSZ.
|
|
|
|
|
|
|
|
config SYS_BOOT_GET_KBD
|
|
|
|
bool "Enable kernel board information setup"
|
|
|
|
help
|
|
|
|
Enables allocating and saving a kernel copy of the bd_info in
|
|
|
|
space between "bootm_low" and "bootm_low" + BOOTMAPSZ.
|
|
|
|
|
2015-02-11 23:32:59 +00:00
|
|
|
config SYS_MALLOC_F
|
|
|
|
bool "Enable malloc() pool before relocation"
|
2015-03-19 10:42:55 +00:00
|
|
|
default y if DM
|
2018-12-03 11:37:17 +00:00
|
|
|
|
2015-02-11 23:32:59 +00:00
|
|
|
help
|
2016-04-16 09:53:07 +00:00
|
|
|
Before relocation, memory is very limited on many platforms. Still,
|
2015-02-11 23:32:59 +00:00
|
|
|
we can provide a small malloc() pool if needed. Driver model in
|
|
|
|
particular needs this to operate, so that it can allocate the
|
|
|
|
initial serial device and any others that are needed.
|
|
|
|
|
|
|
|
config SYS_MALLOC_F_LEN
|
|
|
|
hex "Size of malloc() pool before relocation"
|
|
|
|
depends on SYS_MALLOC_F
|
2018-04-12 16:09:58 +00:00
|
|
|
default 0x1000 if AM33XX
|
2018-12-03 11:37:17 +00:00
|
|
|
default 0x2800 if SANDBOX
|
2019-05-03 17:05:04 +00:00
|
|
|
default 0x2000 if (ARCH_IMX8 || ARCH_IMX8M || ARCH_MX7 || \
|
2019-12-31 07:33:40 +00:00
|
|
|
ARCH_MX7ULP || ARCH_MX6 || ARCH_MX5 || \
|
|
|
|
ARCH_LS1012A || ARCH_LS1021A || ARCH_LS1043A || \
|
2020-06-07 09:54:00 +00:00
|
|
|
ARCH_LS1046A || ARCH_QEMU)
|
2015-02-11 23:32:59 +00:00
|
|
|
default 0x400
|
|
|
|
help
|
2016-04-16 09:53:07 +00:00
|
|
|
Before relocation, memory is very limited on many platforms. Still,
|
2015-02-11 23:32:59 +00:00
|
|
|
we can provide a small malloc() pool if needed. Driver model in
|
|
|
|
particular needs this to operate, so that it can allocate the
|
|
|
|
initial serial device and any others that are needed.
|
|
|
|
|
2018-07-20 09:41:38 +00:00
|
|
|
config SYS_MALLOC_LEN
|
|
|
|
hex "Define memory for Dynamic allocation"
|
2019-08-19 07:01:24 +00:00
|
|
|
depends on ARCH_ZYNQ || ARCH_VERSAL || ARCH_STM32MP || ARCH_ROCKCHIP
|
|
|
|
default 0x2000000 if ARCH_ROCKCHIP
|
2018-07-20 09:41:38 +00:00
|
|
|
help
|
|
|
|
This defines memory to be allocated for Dynamic allocation
|
|
|
|
TODO: Use for other architectures
|
|
|
|
|
2017-07-24 09:43:34 +00:00
|
|
|
config SPL_SYS_MALLOC_F_LEN
|
2018-07-24 12:47:43 +00:00
|
|
|
hex "Size of malloc() pool in SPL before relocation"
|
2019-08-13 19:32:30 +00:00
|
|
|
depends on SYS_MALLOC_F && SPL
|
ARM: rmobile: Add recovery SPL for R-Car Gen3
Build an SPL which can be started via SCIF download mode on R-Car Gen3
and allows loading and executing U-Boot uImage with the next stage code.
This is also useful for starting e.g. ATF BL2, which inits the hardware
and returns to the U-Boot SPL, which can then load e.g. U-Boot proper.
The H3, M3-W, M3-N SoCs have plenty of SRAM for storing the U-Boot SPL
while the payload, e.g. ATF BL2, executes, so there is no problem here.
However, E3 and D3 have much less SRAM, hence the loader uses a trick
where it copies itself beyond the area used by BL2 and executes from
there. That area is 32kiB large and not enough to hold U-Boot SPL, BSS,
stack and malloc area, so the later two are placed at +0x4000 offset
from start of SRAM, another area not used by ATF BL2. To make things
even more complicated, the SCIF loader cannot load to the upper 32kiB
of the SRAM directly, hence the copying approach.
Signed-off-by: Marek Vasut <marek.vasut+renesas@gmail.com>
Cc: Nobuhiro Iwamatsu <iwamatsu@nigauri.org>
2018-10-03 10:44:13 +00:00
|
|
|
default 0x2800 if RCAR_GEN3
|
2018-07-24 12:47:43 +00:00
|
|
|
default SYS_MALLOC_F_LEN
|
|
|
|
help
|
|
|
|
Before relocation, memory is very limited on many platforms. Still,
|
|
|
|
we can provide a small malloc() pool if needed. Driver model in
|
|
|
|
particular needs this to operate, so that it can allocate the
|
|
|
|
initial serial device and any others that are needed.
|
2017-07-28 09:06:03 +00:00
|
|
|
|
|
|
|
config TPL_SYS_MALLOC_F_LEN
|
2018-07-24 12:47:43 +00:00
|
|
|
hex "Size of malloc() pool in TPL before relocation"
|
2019-08-13 19:32:30 +00:00
|
|
|
depends on SYS_MALLOC_F && TPL
|
2018-07-24 12:47:43 +00:00
|
|
|
default SYS_MALLOC_F_LEN
|
|
|
|
help
|
|
|
|
Before relocation, memory is very limited on many platforms. Still,
|
|
|
|
we can provide a small malloc() pool if needed. Driver model in
|
|
|
|
particular needs this to operate, so that it can allocate the
|
|
|
|
initial serial device and any others that are needed.
|
2017-07-24 09:43:34 +00:00
|
|
|
|
2014-11-14 08:34:29 +00:00
|
|
|
menuconfig EXPERT
|
2015-03-04 13:01:24 +00:00
|
|
|
bool "Configure standard U-Boot features (expert users)"
|
|
|
|
default y
|
|
|
|
help
|
|
|
|
This option allows certain base U-Boot options and settings
|
|
|
|
to be disabled or tweaked. This is for specialized
|
|
|
|
environments which can tolerate a "non-standard" U-Boot.
|
2016-04-16 09:53:07 +00:00
|
|
|
Use this only if you really know what you are doing.
|
2015-03-04 13:01:24 +00:00
|
|
|
|
|
|
|
if EXPERT
|
|
|
|
config SYS_MALLOC_CLEAR_ON_INIT
|
|
|
|
bool "Init with zeros the memory reserved for malloc (slow)"
|
|
|
|
default y
|
|
|
|
help
|
|
|
|
This setting is enabled by default. The reserved malloc
|
|
|
|
memory is initialized with zeros, so first malloc calls
|
|
|
|
will return the pointer to the zeroed memory. But this
|
|
|
|
slows the boot time.
|
|
|
|
|
|
|
|
It is recommended to disable it, when CONFIG_SYS_MALLOC_LEN
|
|
|
|
value, has more than few MiB, e.g. when uses bzip2 or bmp logo.
|
|
|
|
Then the boot time can be significantly reduced.
|
|
|
|
Warning:
|
|
|
|
When disabling this, please check if malloc calls, maybe
|
2016-04-16 09:53:07 +00:00
|
|
|
should be replaced by calloc - if one expects zeroed memory.
|
2016-06-30 16:52:20 +00:00
|
|
|
|
2020-04-29 16:23:07 +00:00
|
|
|
config SYS_MALLOC_DEFAULT_TO_INIT
|
|
|
|
bool "Default malloc to init while reserving the memory for it"
|
|
|
|
default n
|
|
|
|
help
|
|
|
|
It may happen that one needs to move the dynamic allocation
|
|
|
|
from one to another memory range, eg. when moving the malloc
|
|
|
|
from the limited static to a potentially large dynamic (DDR)
|
|
|
|
memory.
|
|
|
|
|
|
|
|
If so then on top of setting the updated memory aside one
|
|
|
|
needs to bring the malloc init.
|
|
|
|
|
|
|
|
If such a scenario is sought choose yes.
|
|
|
|
|
2016-06-30 16:52:20 +00:00
|
|
|
config TOOLS_DEBUG
|
|
|
|
bool "Enable debug information for tools"
|
|
|
|
help
|
|
|
|
Enable generation of debug information for tools such as mkimage.
|
|
|
|
This can be used for debugging purposes. With debug information
|
|
|
|
it is possible to set breakpoints on particular lines, single-step
|
|
|
|
debug through the source code, etc.
|
|
|
|
|
2017-01-02 21:32:13 +00:00
|
|
|
endif # EXPERT
|
2016-07-25 10:56:03 +00:00
|
|
|
|
|
|
|
config PHYS_64BIT
|
|
|
|
bool "64bit physical address support"
|
|
|
|
help
|
|
|
|
Say Y here to support 64bit physical memory address.
|
|
|
|
This can be used not only for 64bit SoCs, but also for
|
2019-01-13 09:13:19 +00:00
|
|
|
large physical address extension on 32bit SoCs.
|
2016-07-25 10:56:03 +00:00
|
|
|
|
2020-07-19 19:55:52 +00:00
|
|
|
config HAS_ROM
|
|
|
|
bool
|
|
|
|
select BINMAN
|
|
|
|
help
|
|
|
|
Enables building of a u-boot.rom target. This collects U-Boot and
|
|
|
|
any necessary binary blobs.
|
|
|
|
|
|
|
|
config ROM_NEEDS_BLOBS
|
|
|
|
bool
|
|
|
|
depends on HAS_ROM
|
|
|
|
help
|
|
|
|
Enable this if building the u-boot.rom target needs binary blobs, and
|
2020-07-19 19:56:04 +00:00
|
|
|
so cannot be done normally. In this case, U-Boot will only build the
|
|
|
|
ROM if the required blobs exist. If not, you will see an warning like:
|
|
|
|
|
|
|
|
Image 'main-section' is missing external blobs and is non-functional:
|
|
|
|
intel-descriptor intel-me intel-refcode intel-vga intel-mrc
|
2020-07-19 19:55:52 +00:00
|
|
|
|
2017-10-16 18:08:38 +00:00
|
|
|
config BUILD_ROM
|
|
|
|
bool "Build U-Boot as BIOS replacement"
|
2020-07-19 19:55:52 +00:00
|
|
|
depends on HAS_ROM
|
|
|
|
default y if !ROM_NEEDS_BLOBS
|
2017-10-16 18:08:38 +00:00
|
|
|
help
|
|
|
|
This option allows to build a ROM version of U-Boot.
|
|
|
|
The build process generally requires several binary blobs
|
|
|
|
which are not shipped in the U-Boot source tree.
|
2020-02-28 14:18:11 +00:00
|
|
|
Please, see doc/arch/x86.rst for details.
|
2017-10-16 18:08:38 +00:00
|
|
|
|
2019-04-03 13:24:50 +00:00
|
|
|
config SPL_IMAGE
|
|
|
|
string "SPL image used in the combined SPL+U-Boot image"
|
|
|
|
default "spl/boot.bin" if ARCH_AT91 && SPL_NAND_SUPPORT
|
|
|
|
default "spl/u-boot-spl.bin"
|
2019-08-13 19:32:30 +00:00
|
|
|
depends on SPL
|
2019-04-03 13:24:50 +00:00
|
|
|
help
|
|
|
|
Select the SPL build target that shall be generated by the SPL
|
|
|
|
build process (default spl/u-boot-spl.bin). This image will be
|
|
|
|
used to generate a combined image with SPL and main U-Boot
|
|
|
|
proper as one single image.
|
|
|
|
|
2019-01-18 07:22:49 +00:00
|
|
|
config BUILD_TARGET
|
|
|
|
string "Build target special images"
|
2019-03-20 20:15:21 +00:00
|
|
|
default "u-boot-with-spl.sfp" if TARGET_SOCFPGA_ARRIA10
|
|
|
|
default "u-boot-with-spl.sfp" if TARGET_SOCFPGA_GEN5
|
2019-02-07 11:21:16 +00:00
|
|
|
default "u-boot-spl.kwb" if ARCH_MVEBU && SPL
|
2019-01-18 07:22:49 +00:00
|
|
|
default "u-boot-elf.srec" if RCAR_GEN3
|
2020-07-19 19:56:12 +00:00
|
|
|
default "u-boot.itb" if !BINMAN && SPL_LOAD_FIT && (ARCH_ROCKCHIP || \
|
2019-10-02 13:55:57 +00:00
|
|
|
ARCH_SUNXI || RISCV || ARCH_ZYNQMP)
|
2020-05-06 12:02:40 +00:00
|
|
|
default "u-boot.kwb" if ARCH_KIRKWOOD
|
2019-04-03 13:24:50 +00:00
|
|
|
default "u-boot-with-spl.bin" if ARCH_AT91 && SPL_NAND_SUPPORT
|
2019-09-20 16:09:10 +00:00
|
|
|
default "u-boot-with-spl.imx" if ARCH_MX6 && SPL
|
2019-01-18 07:22:49 +00:00
|
|
|
help
|
|
|
|
Some SoCs need special image types (e.g. U-Boot binary
|
|
|
|
with a special header) as build targets. By defining
|
|
|
|
CONFIG_BUILD_TARGET in the SoC / board header, this
|
|
|
|
special image will be automatically built upon calling
|
|
|
|
make / buildman.
|
|
|
|
|
2019-06-02 12:57:32 +00:00
|
|
|
config SYS_CUSTOM_LDSCRIPT
|
|
|
|
bool "Use a custom location for the U-Boot linker script"
|
|
|
|
help
|
|
|
|
Normally when linking U-Boot we will look in the board directory,
|
|
|
|
the CPU directory and finally the "cpu" directory of the architecture
|
|
|
|
for the ile "u-boot.lds" and use that as our linker. However, in
|
|
|
|
some cases we need to provide a different linker script. To do so,
|
|
|
|
enable this option and then provide the location under
|
|
|
|
CONFIG_SYS_LDSCRIPT.
|
|
|
|
|
|
|
|
config SYS_LDSCRIPT
|
|
|
|
depends on SYS_CUSTOM_LDSCRIPT
|
|
|
|
string "Custom ldscript location"
|
|
|
|
help
|
|
|
|
Path within the source tree to the linker script to use for the
|
|
|
|
main U-Boot binary.
|
|
|
|
|
2019-10-22 19:29:46 +00:00
|
|
|
config ERR_PTR_OFFSET
|
|
|
|
hex
|
|
|
|
default 0x0
|
|
|
|
help
|
|
|
|
Some U-Boot pointers have redundant information, so we can use a
|
|
|
|
scheme where we can return either an error code or a pointer with the
|
|
|
|
same return value. The default implementation just casts the pointer
|
|
|
|
to a number, however, this may fail on platforms where the end of the
|
|
|
|
address range is used for valid pointers (e.g. 0xffffff00 is a valid
|
|
|
|
heap pointer in socfpga SPL).
|
|
|
|
For such platforms, this value provides an upper range of those error
|
|
|
|
pointer values - up to 'MAX_ERRNO' bytes below this value must be
|
|
|
|
unused/invalid addresses.
|
|
|
|
|
2020-03-30 11:58:59 +00:00
|
|
|
config PLATFORM_ELFENTRY
|
|
|
|
string
|
|
|
|
default "__start" if MIPS
|
|
|
|
default "_start"
|
|
|
|
|
2020-07-29 10:37:35 +00:00
|
|
|
config STACK_SIZE
|
|
|
|
hex "Define max stack size that can be used by U-Boot"
|
|
|
|
default 0x4000000 if ARCH_VERSAL || ARCH_ZYNQMP
|
|
|
|
default 0x200000 if MICROBLAZE
|
|
|
|
default 0x1000000
|
|
|
|
help
|
|
|
|
Define Max stack size that can be used by U-Boot. This value is used
|
|
|
|
by the UEFI sub-system. On some boards initrd_high is calculated as
|
|
|
|
base stack pointer minus this stack size.
|
|
|
|
|
2014-11-26 09:42:31 +00:00
|
|
|
endmenu # General setup
|
|
|
|
|
2014-08-22 10:42:27 +00:00
|
|
|
menu "Boot images"
|
|
|
|
|
2017-08-25 21:50:27 +00:00
|
|
|
config ANDROID_BOOT_IMAGE
|
|
|
|
bool "Enable support for Android Boot Images"
|
|
|
|
default y if FASTBOOT
|
|
|
|
help
|
|
|
|
This enables support for booting images which use the Android
|
|
|
|
image format header.
|
|
|
|
|
2014-11-13 10:29:06 +00:00
|
|
|
config FIT
|
|
|
|
bool "Support Flattened Image Tree"
|
2017-03-15 01:19:06 +00:00
|
|
|
select MD5
|
2017-05-15 16:17:49 +00:00
|
|
|
select SHA1
|
2014-11-13 10:29:06 +00:00
|
|
|
help
|
2017-01-02 21:32:13 +00:00
|
|
|
This option allows you to boot the new uImage structure,
|
2014-11-13 10:29:06 +00:00
|
|
|
Flattened Image Tree. FIT is formally a FDT, which can include
|
|
|
|
images of various types (kernel, FDT blob, ramdisk, etc.)
|
|
|
|
in a single blob. To boot this new uImage structure,
|
2015-08-26 14:54:45 +00:00
|
|
|
pass the address of the blob to the "bootm" command.
|
2016-02-23 05:55:43 +00:00
|
|
|
FIT is very flexible, supporting compression, multiple images,
|
|
|
|
multiple configurations, verification through hashing and also
|
2017-01-02 21:32:13 +00:00
|
|
|
verified boot (secure boot using RSA).
|
2014-11-13 10:29:06 +00:00
|
|
|
|
2017-01-02 21:32:13 +00:00
|
|
|
if FIT
|
2014-11-13 10:29:06 +00:00
|
|
|
|
2018-11-20 10:19:11 +00:00
|
|
|
config FIT_EXTERNAL_OFFSET
|
2019-05-15 21:10:04 +00:00
|
|
|
hex "FIT external data offset"
|
2018-11-20 10:19:11 +00:00
|
|
|
default 0x0
|
|
|
|
help
|
|
|
|
This specifies a data offset in fit image.
|
|
|
|
The offset is from data payload offset to the beginning of
|
|
|
|
fit image header. When specifies a offset, specific data
|
|
|
|
could be put in the hole between data payload and fit image
|
|
|
|
header, such as CSF data on i.MX platform.
|
|
|
|
|
2017-05-15 16:17:48 +00:00
|
|
|
config FIT_ENABLE_SHA256_SUPPORT
|
|
|
|
bool "Support SHA256 checksum of FIT image contents"
|
|
|
|
default y
|
2018-07-23 13:55:15 +00:00
|
|
|
select SHA256
|
2017-05-15 16:17:48 +00:00
|
|
|
help
|
|
|
|
Enable this to support SHA256 checksum of FIT image contents. A
|
|
|
|
SHA256 checksum is a 256-bit (32-byte) hash value used to check that
|
2020-04-16 05:36:52 +00:00
|
|
|
the image contents have not been corrupted.
|
|
|
|
|
|
|
|
config FIT_ENABLE_SHA384_SUPPORT
|
|
|
|
bool "Support SHA384 checksum of FIT image contents"
|
|
|
|
default n
|
|
|
|
select SHA384
|
|
|
|
help
|
|
|
|
Enable this to support SHA384 checksum of FIT image contents. A
|
|
|
|
SHA384 checksum is a 384-bit (48-byte) hash value used to check that
|
|
|
|
the image contents have not been corrupted. Use this for the highest
|
|
|
|
security.
|
|
|
|
|
|
|
|
config FIT_ENABLE_SHA512_SUPPORT
|
|
|
|
bool "Support SHA512 checksum of FIT image contents"
|
|
|
|
default n
|
|
|
|
select SHA512
|
|
|
|
help
|
|
|
|
Enable this to support SHA512 checksum of FIT image contents. A
|
|
|
|
SHA512 checksum is a 512-bit (64-byte) hash value used to check that
|
|
|
|
the image contents have not been corrupted.
|
2017-05-15 16:17:48 +00:00
|
|
|
|
2014-11-13 10:29:06 +00:00
|
|
|
config FIT_SIGNATURE
|
2015-01-23 10:31:51 +00:00
|
|
|
bool "Enable signature verification of FIT uImages"
|
2015-02-05 03:16:14 +00:00
|
|
|
depends on DM
|
2018-05-02 10:07:18 +00:00
|
|
|
select HASH
|
2018-07-23 13:55:15 +00:00
|
|
|
select RSA
|
2020-02-21 06:12:55 +00:00
|
|
|
select RSA_VERIFY
|
|
|
|
select IMAGE_SIGN_INFO
|
2014-11-13 10:29:06 +00:00
|
|
|
help
|
|
|
|
This option enables signature verification of FIT uImages,
|
2015-02-20 07:21:46 +00:00
|
|
|
using a hash signed and verified using RSA. If
|
|
|
|
CONFIG_SHA_PROG_HW_ACCEL is defined, i.e support for progressive
|
2017-01-02 21:32:13 +00:00
|
|
|
hashing is available using hardware, then the RSA library will use
|
2016-02-23 05:55:43 +00:00
|
|
|
it. See doc/uImage.FIT/signature.txt for more details.
|
|
|
|
|
|
|
|
WARNING: When relying on signed FIT images with a required signature
|
|
|
|
check the legacy image format is disabled by default, so that
|
|
|
|
unsigned images cannot be loaded. If a board needs the legacy image
|
|
|
|
format support in this case, enable it using
|
2019-05-23 11:14:07 +00:00
|
|
|
CONFIG_LEGACY_IMAGE_FORMAT.
|
2016-02-23 05:55:43 +00:00
|
|
|
|
2018-06-09 15:38:05 +00:00
|
|
|
config FIT_SIGNATURE_MAX_SIZE
|
|
|
|
hex "Max size of signed FIT structures"
|
|
|
|
depends on FIT_SIGNATURE
|
|
|
|
default 0x10000000
|
|
|
|
help
|
|
|
|
This option sets a max size in bytes for verified FIT uImages.
|
|
|
|
A sane value of 256MB protects corrupted DTB structures from overlapping
|
|
|
|
device memory. Assure this size does not extend past expected storage
|
|
|
|
space.
|
|
|
|
|
2018-11-14 12:51:01 +00:00
|
|
|
config FIT_ENABLE_RSASSA_PSS_SUPPORT
|
|
|
|
bool "Support rsassa-pss signature scheme of FIT image contents"
|
|
|
|
depends on FIT_SIGNATURE
|
|
|
|
default n
|
|
|
|
help
|
|
|
|
Enable this to support the pss padding algorithm as described
|
|
|
|
in the rfc8017 (https://tools.ietf.org/html/rfc8017).
|
|
|
|
|
2019-12-18 17:25:41 +00:00
|
|
|
config FIT_CIPHER
|
|
|
|
bool "Enable ciphering data in a FIT uImages"
|
|
|
|
depends on DM
|
|
|
|
select AES
|
|
|
|
help
|
|
|
|
Enable the feature of data ciphering/unciphering in the tool mkimage
|
|
|
|
and in the u-boot support of the FIT image.
|
|
|
|
|
2017-01-02 21:32:13 +00:00
|
|
|
config FIT_VERBOSE
|
|
|
|
bool "Show verbose messages when FIT images fail"
|
|
|
|
help
|
|
|
|
Generally a system will have valid FIT images so debug messages
|
|
|
|
are a waste of code space. If you are debugging your images then
|
|
|
|
you can enable this option to get more verbose information about
|
|
|
|
failures.
|
2016-06-10 02:18:44 +00:00
|
|
|
|
2016-02-23 05:55:43 +00:00
|
|
|
config FIT_BEST_MATCH
|
|
|
|
bool "Select the best match for the kernel device tree"
|
|
|
|
help
|
|
|
|
When no configuration is explicitly selected, default to the
|
|
|
|
one whose fdt's compatibility field best matches that of
|
|
|
|
U-Boot itself. A match is considered "best" if it matches the
|
|
|
|
most specific compatibility entry of U-Boot's fdt's root node.
|
|
|
|
The order of entries in the configuration's fdt is ignored.
|
|
|
|
|
2017-01-02 21:32:13 +00:00
|
|
|
config FIT_IMAGE_POST_PROCESS
|
|
|
|
bool "Enable post-processing of FIT artifacts after loading by U-Boot"
|
|
|
|
depends on TI_SECURE_DEVICE
|
2016-02-23 05:55:43 +00:00
|
|
|
help
|
2017-01-02 21:32:13 +00:00
|
|
|
Allows doing any sort of manipulation to blobs after they got extracted
|
|
|
|
from FIT images like stripping off headers or modifying the size of the
|
|
|
|
blob, verification, authentication, decryption etc. in a platform or
|
|
|
|
board specific way. In order to use this feature a platform or board-
|
|
|
|
specific implementation of board_fit_image_post_process() must be
|
|
|
|
provided. Also, anything done during this post-processing step would
|
|
|
|
need to be comprehended in how the images were prepared before being
|
|
|
|
injected into the FIT creation (i.e. the blobs would have been pre-
|
|
|
|
processed before being added to the FIT image).
|
|
|
|
|
2017-05-22 18:15:16 +00:00
|
|
|
if SPL
|
|
|
|
|
2017-01-02 21:32:13 +00:00
|
|
|
config SPL_FIT
|
|
|
|
bool "Support Flattened Image Tree within SPL"
|
|
|
|
depends on SPL
|
2017-04-26 00:32:38 +00:00
|
|
|
select SPL_OF_LIBFDT
|
2017-01-02 21:32:13 +00:00
|
|
|
|
2018-05-12 22:22:52 +00:00
|
|
|
config SPL_FIT_PRINT
|
|
|
|
bool "Support FIT printing within SPL"
|
|
|
|
depends on SPL_FIT
|
|
|
|
help
|
|
|
|
Support printing the content of the fitImage in a verbose manner in SPL.
|
|
|
|
|
2017-01-02 21:32:13 +00:00
|
|
|
config SPL_FIT_SIGNATURE
|
|
|
|
bool "Enable signature verification of FIT firmware within SPL"
|
|
|
|
depends on SPL_DM
|
2017-04-26 00:32:38 +00:00
|
|
|
select SPL_FIT
|
2020-06-18 14:23:28 +00:00
|
|
|
select SPL_CRYPTO_SUPPORT
|
2020-06-18 14:23:27 +00:00
|
|
|
select SPL_HASH_SUPPORT
|
2017-01-02 21:32:13 +00:00
|
|
|
select SPL_RSA
|
2020-02-21 06:12:55 +00:00
|
|
|
select SPL_RSA_VERIFY
|
2020-04-15 16:46:21 +00:00
|
|
|
select SPL_IMAGE_SIGN_INFO
|
2017-01-02 21:32:13 +00:00
|
|
|
|
|
|
|
config SPL_LOAD_FIT
|
2019-05-25 20:53:42 +00:00
|
|
|
bool "Enable SPL loading U-Boot as a FIT (basic fitImage features)"
|
2017-04-26 00:32:38 +00:00
|
|
|
select SPL_FIT
|
2017-01-02 21:32:13 +00:00
|
|
|
help
|
|
|
|
Normally with the SPL framework a legacy image is generated as part
|
|
|
|
of the build. This contains U-Boot along with information as to
|
|
|
|
where it should be loaded. This option instead enables generation
|
|
|
|
of a FIT (Flat Image Tree) which provides more flexibility. In
|
|
|
|
particular it can handle selecting from multiple device tree
|
|
|
|
and passing the correct one to U-Boot.
|
|
|
|
|
2020-07-06 07:35:00 +00:00
|
|
|
config SPL_LOAD_FIT_ADDRESS
|
|
|
|
hex "load address of fit image"
|
|
|
|
depends on SPL_LOAD_FIT
|
|
|
|
default 0x0
|
|
|
|
help
|
|
|
|
Specify the load address of the fit image that will be loaded
|
|
|
|
by SPL.
|
|
|
|
|
2019-10-22 14:39:11 +00:00
|
|
|
config SPL_LOAD_FIT_APPLY_OVERLAY
|
|
|
|
bool "Enable SPL applying DT overlays from FIT"
|
|
|
|
depends on SPL_LOAD_FIT
|
|
|
|
select OF_LIBFDT_OVERLAY
|
|
|
|
help
|
|
|
|
The device tree is loaded from the FIT image. Allow the SPL is to
|
|
|
|
also load device-tree overlays from the FIT image an apply them
|
|
|
|
over the device tree.
|
|
|
|
|
2019-10-22 14:39:13 +00:00
|
|
|
config SPL_LOAD_FIT_APPLY_OVERLAY_BUF_SZ
|
|
|
|
depends on SPL_LOAD_FIT_APPLY_OVERLAY
|
|
|
|
default 0x10000
|
|
|
|
hex "size of temporary buffer used to load the overlays"
|
|
|
|
help
|
|
|
|
The size of the area where the overlays will be loaded and
|
|
|
|
uncompress. Must be at least as large as biggest overlay
|
|
|
|
(uncompressed)
|
|
|
|
|
2018-05-12 22:23:17 +00:00
|
|
|
config SPL_LOAD_FIT_FULL
|
2019-05-25 20:53:42 +00:00
|
|
|
bool "Enable SPL loading U-Boot as a FIT (full fitImage features)"
|
2018-05-12 22:23:17 +00:00
|
|
|
select SPL_FIT
|
|
|
|
help
|
|
|
|
Normally with the SPL framework a legacy image is generated as part
|
|
|
|
of the build. This contains U-Boot along with information as to
|
|
|
|
where it should be loaded. This option instead enables generation
|
|
|
|
of a FIT (Flat Image Tree) which provides more flexibility. In
|
|
|
|
particular it can handle selecting from multiple device tree
|
|
|
|
and passing the correct one to U-Boot.
|
|
|
|
|
2017-01-02 21:32:13 +00:00
|
|
|
config SPL_FIT_IMAGE_POST_PROCESS
|
|
|
|
bool "Enable post-processing of FIT artifacts after loading by the SPL"
|
2017-10-02 13:42:55 +00:00
|
|
|
depends on SPL_LOAD_FIT
|
2017-01-02 21:32:13 +00:00
|
|
|
help
|
|
|
|
Allows doing any sort of manipulation to blobs after they got extracted
|
|
|
|
from the U-Boot FIT image like stripping off headers or modifying the
|
|
|
|
size of the blob, verification, authentication, decryption etc. in a
|
|
|
|
platform or board specific way. In order to use this feature a platform
|
|
|
|
or board-specific implementation of board_fit_image_post_process() must
|
|
|
|
be provided. Also, anything done during this post-processing step would
|
|
|
|
need to be comprehended in how the images were prepared before being
|
|
|
|
injected into the FIT creation (i.e. the blobs would have been pre-
|
|
|
|
processed before being added to the FIT image).
|
|
|
|
|
2017-04-26 00:32:45 +00:00
|
|
|
config SPL_FIT_SOURCE
|
|
|
|
string ".its source file for U-Boot FIT image"
|
|
|
|
depends on SPL_FIT
|
|
|
|
help
|
|
|
|
Specifies a (platform specific) FIT source file to generate the
|
|
|
|
U-Boot FIT image. This could specify further image to load and/or
|
|
|
|
execute.
|
|
|
|
|
2020-07-19 19:56:10 +00:00
|
|
|
config USE_SPL_FIT_GENERATOR
|
|
|
|
bool "Use a script to generate the .its script"
|
|
|
|
default y if SPL_FIT
|
|
|
|
|
2017-04-26 00:32:45 +00:00
|
|
|
config SPL_FIT_GENERATOR
|
|
|
|
string ".its file generator script for U-Boot FIT image"
|
2020-07-19 19:56:10 +00:00
|
|
|
depends on USE_SPL_FIT_GENERATOR
|
2017-04-26 00:32:48 +00:00
|
|
|
default "board/sunxi/mksunxi_fit_atf.sh" if SPL_LOAD_FIT && ARCH_SUNXI
|
2019-05-08 05:41:42 +00:00
|
|
|
default "arch/arm/mach-rockchip/make_fit_atf.py" if SPL_LOAD_FIT && ARCH_ROCKCHIP
|
2019-10-02 13:55:57 +00:00
|
|
|
default "arch/arm/mach-zynqmp/mkimage_fit_atf.sh" if SPL_LOAD_FIT && ARCH_ZYNQMP
|
2019-08-21 19:14:48 +00:00
|
|
|
default "arch/riscv/lib/mkimage_fit_opensbi.sh" if SPL_LOAD_FIT && RISCV
|
2017-04-26 00:32:45 +00:00
|
|
|
help
|
|
|
|
Specifies a (platform specific) script file to generate the FIT
|
|
|
|
source file used to build the U-Boot FIT image file. This gets
|
|
|
|
passed a list of supported device tree file stub names to
|
|
|
|
include in the generated image.
|
|
|
|
|
2017-05-22 18:15:16 +00:00
|
|
|
endif # SPL
|
|
|
|
|
2017-01-02 21:32:13 +00:00
|
|
|
endif # FIT
|
2016-02-23 05:55:43 +00:00
|
|
|
|
2019-05-23 11:14:07 +00:00
|
|
|
config LEGACY_IMAGE_FORMAT
|
2018-04-20 21:25:38 +00:00
|
|
|
bool "Enable support for the legacy image format"
|
|
|
|
default y if !FIT_SIGNATURE
|
|
|
|
help
|
|
|
|
This option enables the legacy image format. It is enabled by
|
|
|
|
default for backward compatibility, unless FIT_SIGNATURE is
|
|
|
|
set where it is disabled so that unsigned images cannot be
|
|
|
|
loaded. If a board needs the legacy image format support in this
|
|
|
|
case, enable it here.
|
|
|
|
|
2016-02-23 05:55:43 +00:00
|
|
|
config OF_BOARD_SETUP
|
|
|
|
bool "Set up board-specific details in device tree before boot"
|
|
|
|
depends on OF_LIBFDT
|
|
|
|
help
|
|
|
|
This causes U-Boot to call ft_board_setup() before booting into
|
|
|
|
the Operating System. This function can set up various
|
|
|
|
board-specific information in the device tree for use by the OS.
|
|
|
|
The device tree is then passed to the OS.
|
|
|
|
|
|
|
|
config OF_SYSTEM_SETUP
|
|
|
|
bool "Set up system-specific details in device tree before boot"
|
|
|
|
depends on OF_LIBFDT
|
|
|
|
help
|
|
|
|
This causes U-Boot to call ft_system_setup() before booting into
|
|
|
|
the Operating System. This function can set up various
|
|
|
|
system-specific information in the device tree for use by the OS.
|
|
|
|
The device tree is then passed to the OS.
|
|
|
|
|
|
|
|
config OF_STDOUT_VIA_ALIAS
|
|
|
|
bool "Update the device-tree stdout alias from U-Boot"
|
|
|
|
depends on OF_LIBFDT
|
|
|
|
help
|
|
|
|
This uses U-Boot's serial alias from the aliases node to update
|
|
|
|
the device tree passed to the OS. The "linux,stdout-path" property
|
|
|
|
in the chosen node is set to point to the correct serial node.
|
|
|
|
This option currently references CONFIG_CONS_INDEX, which is
|
|
|
|
incorrect when used with device tree as this option does not
|
|
|
|
exist / should not be used.
|
2014-11-13 10:29:06 +00:00
|
|
|
|
2014-07-30 05:08:15 +00:00
|
|
|
config SYS_EXTRA_OPTIONS
|
|
|
|
string "Extra Options (DEPRECATED)"
|
|
|
|
help
|
|
|
|
The old configuration infrastructure (= mkconfig + boards.cfg)
|
2014-09-16 07:32:58 +00:00
|
|
|
provided the extra options field. If you have something like
|
2014-07-30 05:08:15 +00:00
|
|
|
"HAS_BAR,BAZ=64", the optional options
|
|
|
|
#define CONFIG_HAS
|
|
|
|
#define CONFIG_BAZ 64
|
|
|
|
will be defined in include/config.h.
|
|
|
|
This option was prepared for the smooth migration from the old
|
|
|
|
configuration to Kconfig. Since this option will be removed sometime,
|
|
|
|
new boards should not use this option.
|
|
|
|
|
2019-12-07 04:42:29 +00:00
|
|
|
config HAVE_SYS_TEXT_BASE
|
|
|
|
bool
|
2018-02-03 17:10:38 +00:00
|
|
|
depends on !NIOS2 && !XTENSA
|
2015-08-04 18:33:41 +00:00
|
|
|
depends on !EFI_APP
|
2019-12-07 04:42:29 +00:00
|
|
|
default y
|
|
|
|
|
|
|
|
config SYS_TEXT_BASE
|
|
|
|
depends on HAVE_SYS_TEXT_BASE
|
2018-08-27 10:27:08 +00:00
|
|
|
default 0x80800000 if ARCH_OMAP2PLUS || ARCH_K3
|
2018-03-03 23:49:02 +00:00
|
|
|
default 0x4a000000 if ARCH_SUNXI && !MACH_SUN9I && !MACH_SUN8I_V3S
|
|
|
|
default 0x2a000000 if ARCH_SUNXI && MACH_SUN9I
|
|
|
|
default 0x42e00000 if ARCH_SUNXI && MACH_SUN8I_V3S
|
2014-10-30 06:30:58 +00:00
|
|
|
hex "Text Base"
|
|
|
|
help
|
2018-02-03 17:10:38 +00:00
|
|
|
The address in memory that U-Boot will be running from, initially.
|
2014-10-30 06:30:58 +00:00
|
|
|
|
2015-01-13 15:49:01 +00:00
|
|
|
config SYS_CLK_FREQ
|
2019-01-21 08:17:53 +00:00
|
|
|
depends on ARC || ARCH_SUNXI || MPC83xx
|
2015-01-13 15:49:01 +00:00
|
|
|
int "CPU clock frequency"
|
|
|
|
help
|
|
|
|
TODO: Move CONFIG_SYS_CLK_FREQ for all the architecture
|
|
|
|
|
2016-11-26 02:02:10 +00:00
|
|
|
config ARCH_FIXUP_FDT_MEMORY
|
|
|
|
bool "Enable arch_fixup_memory_banks() call"
|
2016-07-28 07:06:41 +00:00
|
|
|
default y
|
|
|
|
help
|
|
|
|
Enable FDT memory map syncup before OS boot. This feature can be
|
|
|
|
used for booting OS with different memory setup where the part of
|
|
|
|
the memory location should be used for different purpose.
|
|
|
|
|
2014-08-22 10:42:27 +00:00
|
|
|
endmenu # Boot images
|
2014-07-30 05:08:15 +00:00
|
|
|
|
2017-01-31 11:17:04 +00:00
|
|
|
source "api/Kconfig"
|
|
|
|
|
2014-09-16 07:32:58 +00:00
|
|
|
source "common/Kconfig"
|
|
|
|
|
2016-01-18 03:53:51 +00:00
|
|
|
source "cmd/Kconfig"
|
|
|
|
|
2017-01-27 10:00:35 +00:00
|
|
|
source "disk/Kconfig"
|
|
|
|
|
2014-09-22 10:59:05 +00:00
|
|
|
source "dts/Kconfig"
|
|
|
|
|
2017-08-03 18:21:49 +00:00
|
|
|
source "env/Kconfig"
|
|
|
|
|
2014-09-16 07:32:58 +00:00
|
|
|
source "net/Kconfig"
|
|
|
|
|
|
|
|
source "drivers/Kconfig"
|
|
|
|
|
|
|
|
source "fs/Kconfig"
|
|
|
|
|
|
|
|
source "lib/Kconfig"
|
2015-02-06 04:41:37 +00:00
|
|
|
|
|
|
|
source "test/Kconfig"
|