diff options
author | Tom Rini <trini@konsulko.com> | 2022-02-26 10:21:39 -0500 |
---|---|---|
committer | Tom Rini <trini@konsulko.com> | 2022-02-26 10:21:39 -0500 |
commit | a900c7f8161b74fc66ec715e68e7244b53f04298 (patch) | |
tree | b5e161da65f1c397a6465a875e7e1a352ab83208 /doc | |
parent | 7228ef94824c6442546431582dad0e3794264501 (diff) | |
parent | 3fa9ed9ae3b30dd6e7f5e887c76d183ad72a44a2 (diff) |
Merge tag 'efi-2022-04-rc3' of https://source.denx.de/u-boot/custodians/u-boot-efi
Pull request for efi-2022-04-rc3
Documentation:
* add man-page for fatload
* add SMBIOS table page
UEFI:
* partial fix for UEFI secure boot with intermediate certs
* disable watchdog when returning to command line
* reset system after capsule update
Diffstat (limited to 'doc')
-rw-r--r-- | doc/arch/x86.rst | 2 | ||||
-rw-r--r-- | doc/develop/index.rst | 1 | ||||
-rw-r--r-- | doc/develop/smbios.rst | 22 | ||||
-rw-r--r-- | doc/usage/fatload.rst | 80 | ||||
-rw-r--r-- | doc/usage/index.rst | 1 |
5 files changed, 105 insertions, 1 deletions
diff --git a/doc/arch/x86.rst b/doc/arch/x86.rst index 5494155a51..634387ac09 100644 --- a/doc/arch/x86.rst +++ b/doc/arch/x86.rst @@ -732,7 +732,7 @@ SMBIOS tables To generate SMBIOS tables in U-Boot, for use by the OS, enable the CONFIG_GENERATE_SMBIOS_TABLE option. The easiest way to provide the values to use is via the device tree. For details see -device-tree-bindings/sysinfo/smbios.txt +:download:`smbios.txt <../device-tree-bindings/sysinfo/smbios.txt>`. TODO List --------- diff --git a/doc/develop/index.rst b/doc/develop/index.rst index 97148875ef..93ebfa485f 100644 --- a/doc/develop/index.rst +++ b/doc/develop/index.rst @@ -22,6 +22,7 @@ Implementation makefiles menus printf + smbios uefi/index version diff --git a/doc/develop/smbios.rst b/doc/develop/smbios.rst new file mode 100644 index 0000000000..a4efb0a0a3 --- /dev/null +++ b/doc/develop/smbios.rst @@ -0,0 +1,22 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +SMBIOS tables +============= + +The System Management BIOS (SMBIOS) table is used to deliver management +information from the firmware to the operating system. The content is +standardized in [1]_. + +In Linux you can use the dmidecode command to view the contents of the SMBIOS +table. + +When booting via UEFI the SMBIOS table is transferred as an UEFI configuration +table to the operating system. + +To generate SMBIOS tables in U-Boot, the CONFIG_GENERATE_SMBIOS_TABLE option +must be enabled. The easiest way to provide the values to use is via the device +tree. For details see +:download:`smbios.txt <../device-tree-bindings/sysinfo/smbios.txt>`. + +.. [1] `System Management BIOS (SMBIOS) Reference, version 3.5 + <https://www.dmtf.org/content/dmtf-releases-smbios-35>`_ diff --git a/doc/usage/fatload.rst b/doc/usage/fatload.rst new file mode 100644 index 0000000000..93acb27a53 --- /dev/null +++ b/doc/usage/fatload.rst @@ -0,0 +1,80 @@ +.. SPDX-License-Identifier: GPL-2.0+: + +fatload command +=============== + +Synopsis +-------- + +:: + + fatload <interface> [<dev[:part]> [<addr> [<filename> [bytes [pos]]]]] + +Description +----------- + +The fatload command is used to read a file from a FAT filesystem into memory. +You can always use the :doc:`load command <load>` instead. + +The number of transferred bytes is saved in the environment variable filesize. +The load address is saved in the environment variable fileaddr. + +interface + interface for accessing the block device (mmc, sata, scsi, usb, ....) + +dev + device number + +part + partition number, defaults to 0 (whole device) + +addr + load address, defaults to environment variable loadaddr or if loadaddr is + not set to configuration variable CONFIG_SYS_LOAD_ADDR + +filename + path to file, defaults to environment variable bootfile + +bytes + maximum number of bytes to load + +pos + number of bytes to skip + +addr, bytes, pos are hexadecimal numbers. + +If either 'pos' or 'bytes' are not aligned according to the minimum alignment +requirement for DMA transfer (ARCH_DMA_MINALIGN) additional buffering will be +used, a misaligned buffer warning will be printed, and performance will suffer +for the load. + +Example +------- + +:: + + => fatload mmc 0:1 ${kernel_addr_r} snp.efi + 149280 bytes read in 11 ms (12.9 MiB/s) + => + => fatload mmc 0:1 ${kernel_addr_r} snp.efi 1000000 + 149280 bytes read in 9 ms (15.8 MiB/s) + => + => fatload mmc 0:1 ${kernel_addr_r} snp.efi 1000000 100 + 149024 bytes read in 10 ms (14.2 MiB/s) + => + => fatload mmc 0:1 ${kernel_addr_r} snp.efi 10 + 16 bytes read in 1 ms (15.6 KiB/s) + => + +Configuration +------------- + +The fatload command is only available if CONFIG_CMD_FAT=y. + +Return value +------------ + +The return value $? is set to 0 (true) if the file was successfully loaded +even if the number of bytes is less then the specified length. + +If an error occurs, the return value $? is set to 1 (false). diff --git a/doc/usage/index.rst b/doc/usage/index.rst index 964d761e13..0aacf531b2 100644 --- a/doc/usage/index.rst +++ b/doc/usage/index.rst @@ -34,6 +34,7 @@ Shell commands exit false fatinfo + fatload for load loady |