mirror of
https://github.com/AsahiLinux/u-boot
synced 2024-12-05 02:51:00 +00:00
9e70676cf5
The new opt-out setting, CONFIG_ENV_MMC_PARTITION, statically sets the MMC environment partition name. Prior to this patch, the only way to declare this partition name was by creating a 'u-boot,mmc-env-partition' parameter in the device-tree's /config node. This setting provides additional flexibility, particularly in cases where accessing the device-tree is not straightforward (e.g. QEMU). If undeclared, the device-tree's setting will be used. Signed-off-by: Emmanuel Di Fede <emmanuel.difede@cysec.com> Cc: Joe Hershberger <joe.hershberger@ni.com> Cc: Patrick Delaunay <patrick.delaunay@foss.st.com>
107 lines
4.4 KiB
Text
107 lines
4.4 KiB
Text
The /config node (Configuration Options)
|
|
----------------------------------------
|
|
|
|
A number of run-time configuration options are provided in the /config node
|
|
of the control device tree. You can access these using ofnode_conf_read_int(),
|
|
ofnode_conf_read_bool() and ofnode_conf_read_str().
|
|
|
|
These options are designed to affect the operation of U-Boot at runtime.
|
|
Runtime-configuration items can help avoid proliferation of different builds
|
|
with only minor changes, e.g. enabling and disabling console output. Items
|
|
here should be those that can usefully be set by the build system after U-Boot
|
|
is built.
|
|
|
|
Available options are:
|
|
|
|
bootcmd (string)
|
|
Allows overwriting of the boot command used by U-Boot on startup. If
|
|
present, U-Boot uses this command instead. Note that this feature can
|
|
work even if loading the environment is disabled, e.g. for security
|
|
reasons. See also bootsecure.
|
|
|
|
bootdelay (int)
|
|
This allows selecting of the U-Boot bootdelay, to control whether U-Boot
|
|
waits on boot or for how long. This allows this option to be configured
|
|
by the build system or by a previous-stage binary. For example, if the
|
|
images is being packed for testing or a user holds down a button, it may
|
|
allow a delay, but disable it for production.
|
|
|
|
u-boot,boot-led (string)
|
|
u-boot,error-led (string)
|
|
This is used to specify the label for an LED to indicate an error and
|
|
a successful boot, on supported hardware.
|
|
|
|
bootsecure (int)
|
|
Indicates that U-Boot should use secure_boot_cmd() to run commands,
|
|
rather than the normal CLI. This can be used in production images, to
|
|
restrict the amount of parsing done or the options available, to cut
|
|
back on the available surface for security attacks.
|
|
|
|
u-boot,efi-partition-entries-offset (int)
|
|
If present, this provides an offset (in bytes, from the start of a
|
|
device) that should be skipped over before the partition entries.
|
|
This is used by the EFI/GPT partition implementation when a device
|
|
is formatted.
|
|
|
|
This setting will override any values configured via Kconfig.
|
|
|
|
kernel-offset (int)
|
|
This allows setting the 'kernaddr' environment variable, used to select
|
|
the address to load the kernel. It is useful for systems that use U-Boot
|
|
to flash a device, so the scripts that do this know where to put the
|
|
kernel to be flashed.
|
|
|
|
load-environment (int)
|
|
Allows control over whether U-Boot loads its environment after
|
|
relocation (0=no, 1 or not present=yes).
|
|
|
|
u-boot,mmc-env-offset (int)
|
|
u-boot,mmc-env-offset-redundant (int)
|
|
If present, the values of the 'u-boot,mmc-env-offset' and/or
|
|
of the u-boot,mmc-env-offset-redundant' properties overrides
|
|
CONFIG_ENV_OFFSET and CONFIG_ENV_OFFSET_REDUND, respectively,
|
|
for SD/MMC devices.
|
|
|
|
Values are interpreted as the offset from the start of the
|
|
device, specified in bytes. It is assumed that the setting
|
|
will point at the beginning of a LBA and values that are not
|
|
LBA-aligned will be rounded up to the next LBA address.
|
|
|
|
u-boot,mmc-env-partition (int)
|
|
if present, the environment shall be placed at the last
|
|
CONFIG_ENV_SIZE blocks of the partition on the
|
|
CONFIG_SYS_MMC_ENV_DEV.
|
|
|
|
if u-boot,mmc-env-offset* is present, this setting will take
|
|
precedence. In that case, only if the partition is not found,
|
|
mmc-env-offset* will be tried.
|
|
|
|
Note that CONFIG_ENV_MMC_PARTITION overrides this device-tree setting.
|
|
|
|
u-boot,no-apm-finalize (bool)
|
|
For x86 devices running on coreboot, this tells U-Boot not to lock
|
|
down the Intel Management Engine (ME) registers. This allows U-Boot to
|
|
access the hardware more fully for platforms that need it.
|
|
|
|
u-boot,no-keyboard (bool)
|
|
Tells U-Boot not to expect an attached keyboard with a VGA console.
|
|
|
|
rootdisk-offset (int)
|
|
This allows setting the 'rootdisk' environment variable, used to select
|
|
the address to load the rootdisk. It is useful for systems that use
|
|
U-Boot to flash a device, so the scripts that do this know where to put
|
|
the root disk to be flashed.
|
|
|
|
silent-console (int)
|
|
If present and non-zero, the console is silenced by default on boot.
|
|
|
|
u-boot,spl-payload-offset (int)
|
|
If present (and SPL is controlled by the device-tree), this allows
|
|
to override the CONFIG_SYS_SPI_U_BOOT_OFFS setting using a value
|
|
from the device-tree.
|
|
|
|
sysreset-gpio (string)
|
|
If present (and supported by the specific board), indicates a
|
|
GPIO that can be set to trigger a system reset. It is assumed
|
|
that such a system reset will effect a complete platform reset,
|
|
being roughly equivalent to a power-on reset.
|