colin/u-boot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge tag 'doc-2025-07-rc4' of https://source.denx.de/u-boot/custodians/u-boot-efi

Browse Source 
Pull request doc-2025-07-rc4

Documentation:

* fix typo in gcc.rst
* correct EFI_TCG2_PROTOCOL_MEASURE_DTB description
* Add missing reference to firmware for BB-AI64
* Tidy up the bootefi-command docs
This commit is contained in:
Tom Rini
2025-06-07 08:18:54 -06:00
parent b3f69c1418 2018486f6c
commit 5a8dd2e0c8
4 changed files with 15 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
doc/board/beagle/j721e_beagleboneai64.rst
View File

@@ -83,6 +83,7 @@ Target Images
Copy the below images to an SD card and boot: Copy the below images to an SD card and boot:
* tiboot3-j721e-gp-evm.bin from R5 build as tiboot3.bin * tiboot3-j721e-gp-evm.bin from R5 build as tiboot3.bin
* sysfw-j721e-gp-evm.itb from R5 build as sysfw.itb
* tispl.bin_unsigned from Cortex-A build as tispl.bin * tispl.bin_unsigned from Cortex-A build as tispl.bin
* u-boot.img_unsigned from Cortex-A build as u-boot.img * u-boot.img_unsigned from Cortex-A build as u-boot.img

2
doc/build/gcc.rst vendored
View File

@@ -122,7 +122,7 @@ Out-of-tree building
~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~
By default building is performed locally and the objects are saved in the source By default building is performed locally and the objects are saved in the source
directory. To build out-out-tree use one of the two methods below: directory. To build out-of-tree use one of the two methods below:
Add O= parameter to the make command line: Add O= parameter to the make command line:

20
doc/usage/cmd/bootefi.rst
View File

@@ -20,19 +20,19 @@ Synopsis
Description Description
----------- -----------
The *bootefi* command is used to launch a UEFI binary which can be either of The *bootefi* command is used to launch a UEFI binary which can be any of
* UEFI application * UEFI application
* UEFI boot services driver * UEFI boot services driver
* UEFI run-time services driver * UEFI run-time services driver
An operating system requires a hardware description which can either be An operating system requires a hardware description which can either be
presented as ACPI table (CONFIG\_GENERATE\_ACPI\_TABLE=y) or as device-tree. presented as ACPI table (CONFIG_GENERATE_ACPI_TABLE=y) or as device-tree.
The load address of the device-tree may be provided as parameter *fdt\_addr*. If The load address of the device-tree may be provided as parameter *fdt_addr*. If
this address is not specified, the bootefi command will try to fall back in this address is not specified, the bootefi command will try to fall back in
sequence to: sequence to:
* the device-tree specified by environment variable *fdt\_addr* * the device-tree specified by environment variable *fdt_addr*
* the device-tree specified by environment variable *fdtcontroladdr* * the device-tree specified by environment variable *fdtcontroladdr*
The load address of the binary is specified by parameter *image_address*. A The load address of the binary is specified by parameter *image_address*. A
@@ -110,7 +110,7 @@ U-Boot can be compiled with UEFI unit tests. These unit tests are invoked using
the *bootefi selftest* sub-command. the *bootefi selftest* sub-command.
Which unit test is executed is controlled by the environment variable Which unit test is executed is controlled by the environment variable
*efi\_selftest*. If this variable is not set, all unit tests that are not marked *efi_selftest*. If this variable is not set, all unit tests that are not marked
as 'on request' are executed. as 'on request' are executed.
To show a list of the available unit tests the value *list* can be used To show a list of the available unit tests the value *list* can be used
@@ -126,7 +126,7 @@ To show a list of the available unit tests the value *list* can be used
'configuration tables' 'configuration tables'
... ...
A single test is selected for execution by setting the *efi\_selftest* A single test is selected for execution by setting the *efi_selftest*
environment variable to match one of the listed identifiers environment variable to match one of the listed identifiers
:: ::
@@ -140,10 +140,10 @@ return to the command line but require a board reset.
Configuration Configuration
------------- -------------
To use the *bootefi* command you must specify CONFIG\_CMD\_BOOTEFI=y. To use the *bootefi* command you must specify CONFIG_CMD_BOOTEFI=y.
The *bootefi bootmgr* sub-command requries CMD\_BOOTEFI\_BOOTMGR=y. The *bootefi bootmgr* sub-command requries CMD_BOOTEFI_BOOTMGR=y.
The *bootefi hello* sub-command requries CMD\_BOOTEFI\_HELLO=y. The *bootefi hello* sub-command requries CMD_BOOTEFI_HELLO=y.
The *bootefi selftest* sub-command depends on CMD\_BOOTEFI\_SELFTEST=y. The *bootefi selftest* sub-command depends on CMD_BOOTEFI_SELFTEST=y.
See also See also
-------- --------

7
lib/efi_loader/Kconfig
View File

@@ -443,10 +443,9 @@ config EFI_TCG2_PROTOCOL_MEASURE_DTB
help help
When enabled, the DTB image passed to the booted EFI image is When enabled, the DTB image passed to the booted EFI image is
measured using the EFI TCG2 protocol. Do not enable this feature if measured using the EFI TCG2 protocol. Do not enable this feature if
the passed DTB contains data that change across platform reboots the passed DTB contains data that changes across platform reboots
and cannot be used has a predictable measurement. Otherwise and cannot be used for a predictable measurement. Otherwise, this
this feature allows better measurement of the system boot feature allows for better measurement of the system boot sequence.
sequence.
config EFI_LOAD_FILE2_INITRD config EFI_LOAD_FILE2_INITRD
bool "EFI_FILE_LOAD2_PROTOCOL for Linux initial ramdisk" bool "EFI_FILE_LOAD2_PROTOCOL for Linux initial ramdisk"