December 2020 - U-Boot

[PATCH v6 0/7] Microchip PolarFire SoC support
by Padmarao Begari 21 Dec '20

21 Dec '20

This patch set adds Microchip PolarFire SoC Icicle Kit support to RISC-V U-Boot. The patches are based upon latest U-Boot tree (https://gitlab.denx.de/u-boot/u-boot.git) at commit id 5a1a8a63be8f7262a300eddafb18020926b12fb6 All drivers namely: NS16550 Serial, Microchip clock, Cadence eMMC and Cadence MACB Ethernet work fine on actual Microchip PolarFire SoC Icicle Kit. Changes in v6: - Update MACB driver for 32-bit/64-bit DMA based on struct mac_config - Rename microchip,mpfs-clock.h to microchip-mpfs-clock.h - Add dual-license GPL or MIT in the clock dt-binding - Move refclk device tree node under / device tree node - Remove the dtc warnings - Fix some typos in device tree and doc Changes in v5: - Replace compatible string "microchip,polarfire-soc" with "microchip,mpfs-icicle-kit" in the device tree - Use "mpfs" as identifier in place of "polarfire-soc", "pfsoc" - Fix some typos in doc - Rename the clock driver files clk_pfsoc_* to mpfs_clk_* - Rename pfsoc-clock.h to mpfs-clock.h Changes in v4: - Add dual-license GPL or MIT in the device tree - Replace microsemi compatible strings with microchip - Add MACB compatible string for Microchip PolarFire SoC ethernet - Update MACB driver for 32-bit/64-bit DMA based on compatible string Changes in v3: - Add 'default y if 64BIT' for config DMA_ADDR_T_64BIT - Update MACB driver for 32-bit/64-bit DMA based on design config register - Add phy-handle in MACB driver to read the phy address from device tree - Fix checkpatch warnings in the clock driver - Remove fu540 related compatible strings from soc device tree node - Move refclk device tree node under /soc device tree node - Use local-mac-address instead of mac-address in the device tree - Rename device tree to microchip-mpfs-icicle-kit.dts - Add U-Boot specific dts microchip-mpfs-icicle-kit-u-boot.dtsi file - Drop the imply DMA_ADDR_T_64BIT from board config - Fix some typos - Update doc with Microchip and Custom boot-flow Changes in v2: - Add clock frequency for the clint device tree node - Move peripheral device tree nodes under /soc device tree node - Device tree nodes are in order based on the address - Enable UART0 for U-Boot logs - Update doc for the U-Boot logs are on UART0 - Move clock and reset index source into patch4 - Remove "dma_addr_r" type in the macb driver - Add lower_32_bits() for 32-bit address in the macb driver - Add set_rate() returns the new clock rate in the clock driver Padmarao Begari (7): riscv: Add DMA 64-bit address support net: macb: Add DMA 64-bit address support for macb net: macb: Add phy address to read it from device tree clk: Add Microchip PolarFire SoC clock driver riscv: dts: Add device tree for Microchip Icicle Kit riscv: Add Microchip MPFS Icicle Kit support doc: board: Add Microchip MPFS Icicle Kit doc arch/riscv/Kconfig | 4 + arch/riscv/dts/Makefile | 1 + .../dts/microchip-mpfs-icicle-kit-u-boot.dtsi | 14 + arch/riscv/dts/microchip-mpfs-icicle-kit.dts | 421 +++++++++ arch/riscv/include/asm/types.h | 4 + board/microchip/mpfs_icicle/Kconfig | 23 + board/microchip/mpfs_icicle/mpfs_icicle.c | 99 ++- configs/microchip_mpfs_icicle_defconfig | 9 +- doc/board/index.rst | 1 + doc/board/microchip/index.rst | 9 + doc/board/microchip/mpfs_icicle.rst | 816 ++++++++++++++++++ drivers/clk/Kconfig | 1 + drivers/clk/Makefile | 1 + drivers/clk/microchip/Kconfig | 5 + drivers/clk/microchip/Makefile | 1 + drivers/clk/microchip/mpfs_clk.c | 127 +++ drivers/clk/microchip/mpfs_clk.h | 19 + drivers/clk/microchip/mpfs_clk_cfg.c | 134 +++ drivers/clk/microchip/mpfs_clk_periph.c | 173 ++++ drivers/net/macb.c | 144 +++- drivers/net/macb.h | 6 + include/configs/microchip_mpfs_icicle.h | 60 +- .../dt-bindings/clock/microchip-mpfs-clock.h | 45 + 23 files changed, 2055 insertions(+), 62 deletions(-) create mode 100644 arch/riscv/dts/microchip-mpfs-icicle-kit-u-boot.dtsi create mode 100644 arch/riscv/dts/microchip-mpfs-icicle-kit.dts create mode 100644 doc/board/microchip/index.rst create mode 100644 doc/board/microchip/mpfs_icicle.rst create mode 100644 drivers/clk/microchip/Kconfig create mode 100644 drivers/clk/microchip/Makefile create mode 100644 drivers/clk/microchip/mpfs_clk.c create mode 100644 drivers/clk/microchip/mpfs_clk.h create mode 100644 drivers/clk/microchip/mpfs_clk_cfg.c create mode 100644 drivers/clk/microchip/mpfs_clk_periph.c create mode 100644 include/dt-bindings/clock/microchip-mpfs-clock.h -- 2.17.1

4 14

[v4 00/17] Enable ARM Trusted Firmware for U-Boot
by Siew Chin Lim 21 Dec '20

21 Dec '20

This is the 4th version of patchset to enable ARM Trusted Firmware for U-Boot for Intel Stratix10 and Agilex platform. New U-boot flow with ARM Trusted Firmware (ATF) support: SPL (EL3) -> ATF-BL31 (EL3) -> U-Boot Proper (EL2) -> Linux (EL1) SPL loads the u-boot.itb which consist of: 1) u-boot-nodtb.bin (U-Boot Proper image) 2) u-boot.dtb (U-Boot Proper DTB) 3) bl31.bin (ATF-BL31 image) Patch status: Have changes: Patch 7, 8, 9, 16 Other patches unchanged. Detail changelog can find in commit message. v3->v4: -------- Patch 7: - Add secure register access helper functions for SoC 64bits These secure register access functions allow U-Boot proper running at EL2 (non-secure) to access System Manager's secure registers by calling the ATF's PSCI runtime services (EL3/secure). Patch 8: - Call secure register access helper function to set SDMMC's DRVSEL and SMPLSEL. Patch 9: - Call secure register access helper function to setup the PHY interface. patch 16: - Adjust BINMAN sequence in code, sorted by alphabetical order. No change on functionality. History: -------- [v1]: https://patchwork.ozlabs.org/project/uboot/cover/20200817043431.28718-1-che… [v2]: https://patchwork.ozlabs.org/project/uboot/cover/20201001091614.184612-1-el… [v3]: https://patchwork.ozlabs.org/project/uboot/cover/20201015122955.10259-1-ell… These patchsets have dependency on: arm: socfpga: soc64: Add timeout waiting for NOC idle ACK https://lists.denx.de/pipermail/u-boot/2020-August/423029.html Rename Stratix10 FPGA driver and support Agilex https://lists.denx.de/pipermail/u-boot/2020-August/422798.html SoCFPGA mailbox driver fixes and enhancements https://lists.denx.de/pipermail/u-boot/2020-August/423140.html arm: socfpga: soc64: Initialize timer in SPL only https://lists.denx.de/pipermail/u-boot/2020-July/419692.html arm: socfpga: soc64: Remove PHY interface setup from misc arch init https://lists.denx.de/pipermail/u-boot/2020-July/419690.html Enable sysreset support for SoCFPGA SoC64 platforms https://lists.denx.de/pipermail/u-boot/2020-August/422509.html arm: socfpga: soc64: Disable CONFIG_PSCI_RESET https://lists.denx.de/pipermail/u-boot/2020-August/423373.html Chee Hong Ang (14): arm: socfpga: Add function for checking description from FIT image arm: socfpga: soc64: Load FIT image with ATF support arm: socfpga: soc64: Override 'lowlevel_init' to support ATF arm: socfpga: Disable "spin-table" method for booting Linux arm: socfpga: soc64: Add SMC helper function for Intel SOCFPGA (64bits) arm: socfpga: soc64: Define SMC function identifiers for PSCI SiP services mmc: dwmmc: socfpga: Add ATF support for MMC driver net: designware: socfpga: Add ATF support for MAC driver arm: socfpga: soc64: Add ATF support for Reset Manager driver arm: socfpga: soc64: Add ATF support for FPGA reconfig driver arm: socfpga: mailbox: Add 'SYSTEM_RESET' PSCI support to mbox_reset_cold() arm: socfpga: soc64: SSBL shall not setup stack on OCRAM arm: socfpga: soc64: Skip handoff data access in SSBL configs: socfpga: Add defconfig for Agilex and Stratix 10 with ATF support Siew Chin Lim (3): arm: socfpga: Add secure register access helper functions for SoC 64bits arm: socfpga: dts: soc64: Add binman node of FIT image with ATF support arm: socfpga: soc64: Enable FIT image generation using binman Makefile | 7 + arch/arm/dts/socfpga_agilex-u-boot.dtsi | 4 +- arch/arm/dts/socfpga_soc64_fit-u-boot.dtsi | 120 +++++ arch/arm/dts/socfpga_stratix10-u-boot.dtsi | 8 + arch/arm/dts/socfpga_stratix10_socdk-u-boot.dtsi | 4 +- arch/arm/mach-socfpga/Kconfig | 4 +- arch/arm/mach-socfpga/Makefile | 5 + arch/arm/mach-socfpga/board.c | 12 +- .../mach-socfpga/include/mach/secure_reg_helper.h | 19 + arch/arm/mach-socfpga/include/mach/smc_api.h | 13 + arch/arm/mach-socfpga/lowlevel_init_soc64.S | 76 +++ arch/arm/mach-socfpga/mailbox_s10.c | 5 + arch/arm/mach-socfpga/reset_manager_s10.c | 13 + arch/arm/mach-socfpga/secure_reg_helper.c | 73 +++ arch/arm/mach-socfpga/smc_api.c | 56 ++ arch/arm/mach-socfpga/wrap_pll_config_s10.c | 3 +- configs/socfpga_agilex_atf_defconfig | 72 +++ configs/socfpga_stratix10_atf_defconfig | 74 +++ drivers/fpga/intel_sdm_mb.c | 139 +++++ drivers/mmc/socfpga_dw_mmc.c | 8 + drivers/net/dwmac_socfpga.c | 34 +- include/configs/socfpga_soc64_common.h | 24 +- include/linux/intel-smc.h | 573 +++++++++++++++++++++ 23 files changed, 1333 insertions(+), 13 deletions(-) create mode 100644 arch/arm/dts/socfpga_soc64_fit-u-boot.dtsi create mode 100644 arch/arm/dts/socfpga_stratix10-u-boot.dtsi create mode 100644 arch/arm/mach-socfpga/include/mach/secure_reg_helper.h create mode 100644 arch/arm/mach-socfpga/include/mach/smc_api.h create mode 100644 arch/arm/mach-socfpga/lowlevel_init_soc64.S create mode 100644 arch/arm/mach-socfpga/secure_reg_helper.c create mode 100644 arch/arm/mach-socfpga/smc_api.c create mode 100644 configs/socfpga_agilex_atf_defconfig create mode 100644 configs/socfpga_stratix10_atf_defconfig create mode 100644 include/linux/intel-smc.h -- 2.13.0

4 25

Re: [PATCH 1/4] nds32: Remove dead reset_cpu() implementation
by Rick Chen 21 Dec '20

21 Dec '20

> From: Harald Seiler [mailto:hws@denx.de] > Sent: Tuesday, December 15, 2020 11:48 PM > To: u-boot(a)lists.denx.de > Cc: Harald Seiler; Tom Rini; Simon Glass; Rick Jian-Zhi Chen(陳建志) > Subject: [PATCH 1/4] nds32: Remove dead reset_cpu() implementation > > nds32 is one of the only architectures which still have a reset_cpu() > implementation that makes use of the `addr` parameter. The rest of > U-Boot now ignores it and passes 0 everywhere. It turns out that even > here, reset_cpu() is no longer referenced anywhere; reset is either not > implemented (e.g. ae3xx) or realized using a WDT (e.g. ag101). > > Remove this left-over implementation in preparation for the removal of > the `addr` parameter in the entire tree. > > Cc: Rick Chen <rick(a)andestech.com> > Signed-off-by: Harald Seiler <hws(a)denx.de> > --- > arch/nds32/cpu/n1213/start.S | 22 ---------------------- > 1 file changed, 22 deletions(-) Reviewed-by: Rick Chen <rick(a)andestech.com>

1 0

[PATCH] board: kontron: sl28: reorder mmc devices
by Michael Walle 21 Dec '20

21 Dec '20

Since linux commit 2e6cde96873253fd9eb0f20afd8ffd18278cff75 ("arm64: dts: ls1028a: make the eMMC and SD card controllers use fixed indices") mmc0 is the eMMC and mmc1 is the SD card. Also swap it in u-boot to avoid any confusion by the user and to be aligned with linux. Signed-off-by: Michael Walle <michael(a)walle.cc> --- Hi Tom, u-boot 2021.01 will be the first version which supports the sl28 board. It would be nice if this patch still make it into the relase, so it will be consistent starting with the first u-boot version which supports the board. arch/arm/dts/fsl-ls1028a-kontron-sl28-u-boot.dtsi | 4 ++-- include/configs/kontron_sl28.h | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/arch/arm/dts/fsl-ls1028a-kontron-sl28-u-boot.dtsi b/arch/arm/dts/fsl-ls1028a-kontron-sl28-u-boot.dtsi index 2375549c6e..e63684c334 100644 --- a/arch/arm/dts/fsl-ls1028a-kontron-sl28-u-boot.dtsi +++ b/arch/arm/dts/fsl-ls1028a-kontron-sl28-u-boot.dtsi @@ -4,8 +4,8 @@ / { aliases { - mmc0 = &esdhc0; - mmc1 = &esdhc1; + mmc0 = &esdhc1; + mmc1 = &esdhc0; i2c0 = &i2c0; i2c1 = &i2c3; i2c2 = &i2c4; diff --git a/include/configs/kontron_sl28.h b/include/configs/kontron_sl28.h index afe512a8c7..442fb58b97 100644 --- a/include/configs/kontron_sl28.h +++ b/include/configs/kontron_sl28.h @@ -89,8 +89,8 @@ "ramdisk_addr_r=0x88080000\0" #define BOOT_TARGET_DEVICES(func) \ - func(MMC, mmc, 1) \ func(MMC, mmc, 0) \ + func(MMC, mmc, 1) \ func(NVME, nvme, 0) \ func(USB, usb, 0) \ func(DHCP, dhcp, 0) \ -- 2.20.1

2 2

Pull request for UEFI sub-system for efi-2021-01-rc4
by Heinrich Schuchardt 21 Dec '20

21 Dec '20

Dear Tom, The following changes since commit 51f65b506f37252acb3cd4184ef5e1fc20da13a2: Merge branch 'master' of git://git.denx.de/u-boot-usb (2020-12-16 17:43:33 -0500) are available in the Git repository at: https://gitlab.denx.de/u-boot/custodians/u-boot-efi.git tags/efi-2021-01-rc4 for you to fetch changes up to 77504ee6764994f18039f7f634a419a1606296b0: MAINTAINERS: add tools/efivar.py to EFI PAYLOAD (2020-12-20 17:40:06 +0100) No problems where reported by Gitlab: https://gitlab.denx.de/u-boot/custodians/u-boot-efi/-/pipelines/5630 ---------------------------------------------------------------- Pull request for UEFI sub-system for efi-2021-01-rc4 * Provide a tool to create a file with UEFI variables to preseed UEFI variable store. * Make size of UEFI variable store configurable. * Add man pages for commands 'bootefi' and 'button'. ---------------------------------------------------------------- Heinrich Schuchardt (4): doc: button command doc: man-page for bootefi command efi_loader: make variable store size customizable MAINTAINERS: add tools/efivar.py to EFI PAYLOAD Paulo Alcantara (1): tools: add a simple script to generate EFI variables MAINTAINERS | 2 + doc/usage/bootefi.rst | 135 ++++++++++++++++++ doc/usage/button.rst | 64 +++++++++ doc/usage/index.rst | 2 + include/efi_variable.h | 2 +- lib/efi_loader/Kconfig | 14 ++ tools/efivar.py | 380 +++++++++++++++++++++++++++++++++++++++++++++++++ 7 files changed, 598 insertions(+), 1 deletion(-) create mode 100644 doc/usage/bootefi.rst create mode 100644 doc/usage/button.rst create mode 100755 tools/efivar.py

2 1

Pull request: u-boot-spi/master
by Jagan Teki 21 Dec '20

21 Dec '20

Hi Tom, Please pull this PR. Travis-CI: https://travis-ci.com/github/openedev/u-boot-amarula/builds/209599920 thanks, Jagan. The following changes since commit a4391365995a00f196373cddd35d99f74a9e62ff: configs: Resync with savedefconfig (2020-12-16 10:58:24 -0500) are available in the Git repository at: https://gitlab.denx.de/u-boot/custodians/u-boot-spi master for you to fetch changes up to 936a645609145363b9580adeda831ab3d9ac1d78: mtd: spi-nor-ids: add Micron MT25QL01G flash (2020-12-18 16:19:33 +0530) ---------------------------------------------------------------- Biju Das (1): mtd: spi-nor-ids: Add Winbond W25M512JW flash entry Frieder Schrempf (3): mtd: spinand: Stop using spinand->oobbuf for buffering bad block markers mtd: spinand: Explicitly use MTD_OPS_RAW to write the bad block marker to OOB mtd: spinand: Do not erase the block before writing a bad block marker Hongwei Zhang (1): mtd: spi-nor-ids: add Micron MT25QL01G flash Jagan Teki (3): cl-som-imx7: Switch to DM_SPI/DM_SPI_FLASH cm_fx6: Switch to full DM-aware dh_imx6: Switch to full DM-aware Lad Prabhakar (1): mtd: spi-nor-ids: Add Winbond W25M512JV flash entry Mikhail Kshevetskiy (1): mtd: spinand: enable erasing of bad mtd blocks Patrick Delaunay (1): spi: migrate trace to dev and log macro in spi uclass Pengpeng Chen (1): spi: ca_sflash: Add CAxxxx SPI Flash Controller Robert Marko (1): mtd: spi-nor-ids: Add SECT_4K to mx25l12805d Sean Anderson (14): doc: Fix typo in FIT documentation spi: Fix typo in header spi: dw: Fix driving MOSI low while recieving spi: dw: Convert calls to debug to dev_* spi: dw: Rename "cs-gpio" to "cs-gpios" spi: dw: Use generic function to read reg address spi: dw: Rename registers to match datasheet spi: dw: Remove spi_enable_chip spi: dw: Rearrange struct dw_spi_priv spi: dw: Add SoC-specific compatible strings spi: dw: Add support for multiple CTRLR0 layouts spi: dw: Document devicetree binding spi: dw: Add mem_ops riscv: Add device tree bindings for SPI MAINTAINERS | 2 + arch/arc/dts/axs10x_mb.dtsi | 5 +- arch/arc/dts/hsdk-common.dtsi | 5 +- arch/arm/dts/socfpga.dtsi | 6 +- arch/arm/dts/socfpga_agilex.dtsi | 6 +- arch/arm/dts/socfpga_arria10.dtsi | 6 +- arch/arm/dts/socfpga_stratix10.dtsi | 6 +- arch/mips/dts/mscc,jr2.dtsi | 2 +- arch/mips/dts/mscc,ocelot.dtsi | 2 +- arch/riscv/dts/k210-maix-bit.dts | 46 +- arch/riscv/dts/k210.dtsi | 15 +- configs/cl-som-imx7_defconfig | 7 +- configs/cm_fx6_defconfig | 3 + configs/dh_imx6_defconfig | 3 + doc/device-tree-bindings/spi/snps,dw-apb-ssi.txt | 56 +++ doc/uImage.FIT/source_file_format.txt | 2 +- drivers/mtd/nand/core.c | 10 +- drivers/mtd/nand/spi/core.c | 24 +- drivers/mtd/spi/spi-nor-ids.c | 5 +- drivers/spi/Kconfig | 8 + drivers/spi/Makefile | 1 + drivers/spi/ca_sflash.c | 576 +++++++++++++++++++++++ drivers/spi/designware_spi.c | 405 ++++++++++++---- drivers/spi/spi-uclass.c | 51 +- include/configs/cm_fx6.h | 7 - include/configs/dh_imx6.h | 6 - include/spi.h | 2 +- 27 files changed, 1094 insertions(+), 173 deletions(-) create mode 100644 doc/device-tree-bindings/spi/snps,dw-apb-ssi.txt create mode 100644 drivers/spi/ca_sflash.c

2 1

[PULL u-boot] Please pull u-boot-amlogic-20201218
by Neil Armstrong 21 Dec '20

21 Dec '20

Hi Tom, A (hopefully) last PR for 2020 with an one-liner fixing the Odroid-C4 reset when booting over SDCard, a bug we had in our backlog for a long time ! The CI job is at https://gitlab.denx.de/u-boot/custodians/u-boot-amlogic/pipelines/5613 Thanks, Neil The following changes since commit a4391365995a00f196373cddd35d99f74a9e62ff: configs: Resync with savedefconfig (2020-12-16 10:58:24 -0500) are available in the Git repository at: https://gitlab.denx.de/u-boot/custodians/u-boot-amlogic.git tags/u-boot-amlogic-20201218 for you to fetch changes up to 21a1bc6a900c33efe4da4cc1b33efcfa543fd9d0: ARM: dts: meson: switch TFLASH_VDD_EN pin to open drain on Odroid-C4 (2020-12-18 11:50:27 +0100) ---------------------------------------------------------------- - fix Odroid-C4 soft-reboot caused by bad setup of SDCard VDD regulator ---------------------------------------------------------------- Marek Szyprowski (1): ARM: dts: meson: switch TFLASH_VDD_EN pin to open drain on Odroid-C4 arch/arm/dts/meson-sm1-odroid-c4-u-boot.dtsi | 4 ++++ 1 file changed, 4 insertions(+)

2 1

Support for Mediatek MT7621 (mipsel)?
by Matthias Urlichs 20 Dec '20

20 Dec '20

Hello, I have a bunch of MT7621-based devices (in particular, GnuBee disk servers) which would really really like to have a mainline U-Boot instead of the ancient *censored* they ship with. Is there anybody out there who wants to take a stab at forward-porting the stuff to mainline? As far as I can see, U-Boot currently only supports MT7628. Whoever does the work will get one of these GnuBee things to play with. I won't want it back if I get a working U-Boot instead. -- -- Matthias Urlichs

1 0

AXP803 Driver
by Anton Gorlov 20 Dec '20

20 Dec '20

Hi all. Are there any plans to support AXP803 power regulator in u-boot?

2 4

[PATCH v2 1/1] doc: man-page for bootefi command
by Heinrich Schuchardt 20 Dec '20

20 Dec '20

Provide a description of the bootefi command. Signed-off-by: Heinrich Schuchardt <xypron.glpk(a)gmx.de> --- v2: Replace ".. code-block::" by "::" as the build-system on Gitlab does not like code-block without language. The problem did not occur locally. --- MAINTAINERS | 1 + doc/usage/bootefi.rst | 135 ++++++++++++++++++++++++++++++++++++++++++ doc/usage/index.rst | 1 + 3 files changed, 137 insertions(+) create mode 100644 doc/usage/bootefi.rst diff --git a/MAINTAINERS b/MAINTAINERS index 127e30c0a5..8675965fe5 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -679,6 +679,7 @@ S: Maintained T: git https://gitlab.denx.de/u-boot/custodians/u-boot-efi.git F: doc/api/efi.rst F: doc/uefi/* +F: doc/usage/bootefi.rst F: drivers/rtc/emul_rtc.c F: include/capitalization.h F: include/charset.h diff --git a/doc/usage/bootefi.rst b/doc/usage/bootefi.rst new file mode 100644 index 0000000000..282f22aac9 --- /dev/null +++ b/doc/usage/bootefi.rst @@ -0,0 +1,135 @@ +.. SPDX-License-Identifier: GPL-2.0+ +.. Copyright 2020, Heinrich Schuchardt <xypron.glpk(a)gmx.de> + +bootefi command +=============== + +Synopsis +-------- + +:: + + bootefi [image_addr] [fdt_addr] + bootefi bootmgr [fdt_addr] + bootefi hello [fdt_addr] + bootefi selftest [fdt_addr] + +Description +----------- + +The *bootefi* command is used to launch a UEFI binary which can be either of + +* UEFI application +* UEFI boot services driver +* UEFI run-time services driver + +An operating system requires a hardware description which can either be +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 +this address is not specified, the bootefi command will try to fall back in +sequence to: + +* the device-tree specified by environment variable *fdt\_addr* +* the device-tree specified by environment variable *fdtcontroladdr* + +The load address of the binary is specified by parameter *image_address*. A +command sequence to run a UEFI application might look like + +:: + + load mmc 0:2 $fdt_addr_r dtb + load mmc 0:1 $kernel_addr_r /EFI/grub/grubaa64.efi + bootefi $kernel_addr_r $fdt_addr_r + +The last file loaded defines the image file path in the loaded image protocol. +Hence the executable should always be loaded last. + +The value of the environment variable *bootargs* is converted from UTF-8 to +UTF-16 and passed as load options in the loaded image protocol to the UEFI +binary. + +Note + UEFI binaries that are contained in FIT images are launched via the + *bootm* command. + +UEFI boot manager +''''''''''''''''' + +The UEFI boot manager is invoked by the *bootefi bootmgr* sub-command. +Here boot options are defined by UEFI variables with a name consisting of the +letters *Boot* followed by a four digit hexadecimal number, e.g. *Boot0001* or +*BootA03E*. The boot variable defines a label, the device path of the binary to +execute as well as the load options passed in the loaded image protocol. + +If the UEFI variable *BootNext* is defined, it specifies the number of the boot +option to execute next. If no binary can be loaded via *BootNext* the variable +*BootOrder* specifies in which sequence boot options shalled be tried. + +The values of these variables can be managed using the U-Boot command +*efidebug*. + +UEFI hello world application +'''''''''''''''''''''''''''' + +U-Boot can be compiled with a hello world application that can be launched using +the *bootefi hello* sub-command. A session might look like + +:: + + => setenv bootargs 'Greetings to the world' + => bootefi hello + Booting /MemoryMapped(0x0,0x10001000,0x1000) + Hello, world! + Running on UEFI 2.8 + Have SMBIOS table + Have device tree + Load options: Greetings to the world + +UEFI selftest +''''''''''''' + +U-Boot can be compiled with UEFI unit tests. These unit tests are invoked using +the *bootefi selftest* sub-command. + +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 +as 'on request' are executed. + +To show a list of the available unit tests the value *list* can be used + +:: + + => setenv efi_selftest list + => bootefi selftest + + Available tests: + 'block image transfer' - on request + 'block device' + 'configuration tables' + ... + +A single test is selected for execution by setting the *efi\_selftest* +environment variable to match one of the listed identifiers + +:: + + => setenv efi_selftest 'block image transfer' + => bootefi selftest + +Some of the tests execute the ExitBootServices() UEFI boot service and will not +return to the command line but require a board reset. + +Configuration +------------- + +To use the *bootefi* command you must specify CONFIG\_CMD\_BOOTEFI=y. +The *bootefi hello* sub-command requries CMD\_BOOTEFI\_HELLO=y. +The *bootefi selftest* sub-command depends on CMD\_BOOTEFI\_SELFTEST=y. + +See also +-------- + +* *bootm* for launching UEFI binaries packed in FIT images +* *booti*, *bootm*, *bootz* for launching a Linux kernel without using the + UEFI sub-system +* *efidebug* for setting UEFI boot variables diff --git a/doc/usage/index.rst b/doc/usage/index.rst index 6c4b5b9240..fbb2c0481c 100644 --- a/doc/usage/index.rst +++ b/doc/usage/index.rst @@ -11,6 +11,7 @@ Shell commands .. toctree:: :maxdepth: 1 + bootefi bootmenu button pstore -- 2.29.2

1 0