From: Jassi Brar <jaswinder.singh@linaro.org>
To: Sughosh Ganu <sughosh.ganu@linaro.org>
Cc: u-boot@lists.denx.de, Heinrich Schuchardt <xypron.glpk@gmx.de>,
Ilias Apalodimas <ilias.apalodimas@linaro.org>,
Takahiro Akashi <takahiro.akashi@linaro.org>,
Patrick Delaunay <patrick.delaunay@foss.st.com>,
Patrice Chotard <patrice.chotard@foss.st.com>,
Simon Glass <sjg@chromium.org>, Bin Meng <bmeng.cn@gmail.com>,
Tom Rini <trini@konsulko.com>,
Etienne Carriere <etienne.carriere@linaro.org>,
Michal Simek <monstr@monstr.eu>
Subject: Re: [PATCH v10 15/15] FWU: doc: Add documentation for the FWU feature
Date: Mon, 19 Sep 2022 16:37:51 -0500 [thread overview]
Message-ID: <CAJe_ZheSBURyHwBRt4DHnJV+NCkJBv-tM8XRj_xgxX3+GvwTiw@mail.gmail.com> (raw)
In-Reply-To: <20220915081451.633983-16-sughosh.ganu@linaro.org>
On Thu, 15 Sept 2022 at 03:16, Sughosh Ganu <sughosh.ganu@linaro.org> wrote:
> diff --git a/doc/develop/uefi/fwu_updates.rst b/doc/develop/uefi/fwu_updates.rst
> new file mode 100644
> index 0000000000..fad3fbb3a8
> --- /dev/null
> +++ b/doc/develop/uefi/fwu_updates.rst
> @@ -0,0 +1,165 @@
> +.. SPDX-License-Identifier: GPL-2.0+
> +.. Copyright (c) 2022 Linaro Limited
> +
> +FWU Multi Bank Updates in U-Boot
> +================================
> +
> +The FWU Multi Bank Update feature implements the firmware update
> +mechanism described in the PSA Firmware Update for A-profile Arm
> +Architecture specification [1]. Certain aspects of the Dependable
> +Boot specification [2] are also implemented. The feature provides a
> +mechanism to have multiple banks of updatable firmware images and for
> +updating the firmware images on the non-booted bank. On a successful
> +update, the platform boots from the updated bank on subsequent
> +boot. The UEFI capsule-on-disk update feature is used for performing
> +the actual updates of the updatable firmware images.
> +
> +The bookkeeping of the updatable images is done through a structure
> +called metadata. Currently, the FWU metadata supports identification
> +of images based on image GUIDs stored on a GPT partitioned storage
> +media. There are plans to extend the metadata structure for non GPT
> +partitioned devices as well.
> +
> +Accessing the FWU metadata is done through generic API's which are
> +defined in a driver which complies with the U-Boot's driver model. A
> +new uclass UCLASS_FWU_MDATA has been added for accessing the FWU
> +metadata. Individual drivers can be added based on the type of storage
> +media, and it's partitioning method. Details of the storage device
> +containing the FWU metadata partitions are specified through a U-Boot
> +specific device tree property `fwu-mdata-store`. Please refer to
> +U-Boot `doc <doc/device-tree-bindings/firmware/fwu-mdata-gpt.yaml>`__
> +for the device tree bindings.
> +
> +Enabling the FWU Multi Bank Update feature
> +------------------------------------------
> +
> +The feature can be enabled by specifying the following configs::
> +
> + CONFIG_EFI_CAPSULE_ON_DISK=y
> + CONFIG_EFI_CAPSULE_FIRMWARE_MANAGEMENT=y
> + CONFIG_EFI_CAPSULE_FIRMWARE=y
> + CONFIG_EFI_CAPSULE_FIRMWARE_RAW=y
> +
> + CONFIG_FWU_MULTI_BANK_UPDATE=y
> + CONFIG_CMD_FWU_METADATA=y
> + CONFIG_DM_FWU_MDATA=y
>
s/CONFIG_DM_FWU_MDATA/CONFIG_FWU_MDATA
next prev parent reply other threads:[~2022-09-19 21:38 UTC|newest]
Thread overview: 64+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-09-15 8:14 [PATCH v10 00/15] FWU: Add FWU Multi Bank Update feature support Sughosh Ganu
2022-09-15 8:14 ` [PATCH v10 01/15] dt/bindings: Add bindings for GPT based FWU Metadata storage device Sughosh Ganu
2022-09-15 8:14 ` [PATCH v10 02/15] FWU: Add FWU metadata structure and driver for accessing metadata Sughosh Ganu
2022-09-19 0:33 ` Jassi Brar
2022-09-19 12:39 ` Sughosh Ganu
2022-09-26 2:57 ` Jassi Brar
2022-09-26 10:00 ` Sughosh Ganu
2022-09-26 14:42 ` Jassi Brar
2022-09-27 7:14 ` Sughosh Ganu
2022-09-27 16:25 ` Jassi Brar
2022-09-28 6:00 ` Sughosh Ganu
2022-09-28 19:29 ` Jassi Brar
2022-09-29 6:01 ` Sughosh Ganu
2022-09-15 8:14 ` [PATCH v10 03/15] FWU: Add FWU metadata access driver for GPT partitioned block devices Sughosh Ganu
2022-09-22 8:46 ` Ilias Apalodimas
2022-09-26 8:46 ` Sughosh Ganu
2022-09-27 11:35 ` Etienne Carriere
2022-09-27 11:57 ` Ilias Apalodimas
2022-09-26 2:52 ` Jassi Brar
2022-09-26 8:48 ` Sughosh Ganu
2022-09-26 15:00 ` Jassi Brar
2022-09-15 8:14 ` [PATCH v10 04/15] stm32mp1: dk2: Add a node for the FWU metadata device Sughosh Ganu
2022-09-15 8:14 ` [PATCH v10 05/15] stm32mp1: dk2: Add image information for capsule updates Sughosh Ganu
2022-09-15 8:14 ` [PATCH v10 06/15] FWU: Add helper functions for accessing FWU metadata Sughosh Ganu
2022-09-22 8:59 ` Ilias Apalodimas
2022-09-22 9:35 ` Sughosh Ganu
2022-09-23 6:16 ` Ilias Apalodimas
2022-09-15 8:14 ` [PATCH v10 07/15] FWU: STM32MP1: Add support to read boot index from backup register Sughosh Ganu
2022-09-27 11:35 ` Etienne Carriere
2022-09-15 8:14 ` [PATCH v10 08/15] event: Add an event for main_loop Sughosh Ganu
2022-09-20 7:30 ` Ilias Apalodimas
2022-09-15 8:14 ` [PATCH v10 09/15] FWU: Add boot time checks as highlighted by the FWU specification Sughosh Ganu
2022-09-26 2:59 ` Jassi Brar
2022-09-26 10:08 ` Sughosh Ganu
2022-09-26 14:07 ` Jassi Brar
2022-09-27 7:00 ` Sughosh Ganu
2022-09-15 8:14 ` [PATCH v10 10/15] FWU: Add support for the FWU Multi Bank Update feature Sughosh Ganu
2022-09-16 1:47 ` Takahiro Akashi
2022-09-16 5:22 ` Sughosh Ganu
2022-09-16 6:50 ` Takahiro Akashi
2022-09-16 10:54 ` Sughosh Ganu
2022-09-20 8:16 ` Takahiro Akashi
2022-09-20 13:04 ` Sughosh Ganu
2022-09-21 5:28 ` Takahiro Akashi
2022-09-21 11:26 ` Sughosh Ganu
2022-09-22 5:21 ` Takahiro Akashi
2022-09-26 2:55 ` Jassi Brar
2022-09-26 9:01 ` Sughosh Ganu
2022-09-26 14:53 ` Jassi Brar
2022-09-27 7:22 ` Sughosh Ganu
2022-09-27 16:48 ` Jassi Brar
2022-09-28 6:22 ` Sughosh Ganu
2022-09-28 7:30 ` Etienne Carriere
2022-09-28 15:16 ` Jassi Brar
2022-10-03 11:54 ` Etienne Carriere
2022-10-03 12:21 ` Ilias Apalodimas
2022-10-03 13:29 ` Jassi Brar
2022-09-15 8:14 ` [PATCH v10 11/15] FWU: cmd: Add a command to read FWU metadata Sughosh Ganu
2022-09-15 8:14 ` [PATCH v10 12/15] test: dm: Add test cases for FWU Metadata uclass Sughosh Ganu
2022-09-15 8:14 ` [PATCH v10 13/15] mkeficapsule: Add support for generating empty capsules Sughosh Ganu
2022-09-15 8:14 ` [PATCH v10 14/15] mkeficapsule: Add support for setting OEM flags in capsule header Sughosh Ganu
2022-09-15 8:14 ` [PATCH v10 15/15] FWU: doc: Add documentation for the FWU feature Sughosh Ganu
2022-09-19 21:37 ` Jassi Brar [this message]
2022-09-27 12:01 ` Etienne Carriere
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=CAJe_ZheSBURyHwBRt4DHnJV+NCkJBv-tM8XRj_xgxX3+GvwTiw@mail.gmail.com \
--to=jaswinder.singh@linaro.org \
--cc=bmeng.cn@gmail.com \
--cc=etienne.carriere@linaro.org \
--cc=ilias.apalodimas@linaro.org \
--cc=monstr@monstr.eu \
--cc=patrice.chotard@foss.st.com \
--cc=patrick.delaunay@foss.st.com \
--cc=sjg@chromium.org \
--cc=sughosh.ganu@linaro.org \
--cc=takahiro.akashi@linaro.org \
--cc=trini@konsulko.com \
--cc=u-boot@lists.denx.de \
--cc=xypron.glpk@gmx.de \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).