From patchwork Mon Feb 12 07:47:12 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sughosh Ganu X-Patchwork-Id: 772043 Delivered-To: patch@linaro.org Received: by 2002:adf:9dca:0:b0:33b:4db1:f5b3 with SMTP id q10csp2001051wre; Sun, 11 Feb 2024 23:51:08 -0800 (PST) X-Forwarded-Encrypted: i=2; AJvYcCXir4LBUbTjsjD70uMrneNZx+jdMEJwj8nKb0FtftkEGg17eXS6cGGkvjnMz3I/sRHEA4oVLQGNh2t6MvIzuURs X-Google-Smtp-Source: AGHT+IFg2f7uMOfjVWCaKzEuOv26IuKRmgi8ieK9A7oFPMEjX9ZViaugjDmUqBSF5bq4wReA6PyV X-Received: by 2002:a17:906:552:b0:a38:a174:1316 with SMTP id k18-20020a170906055200b00a38a1741316mr4796843eja.72.1707724268182; Sun, 11 Feb 2024 23:51:08 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1707724268; cv=none; d=google.com; s=arc-20160816; b=jYKrE78ODf7lhP0nH1ehaPFfX/zh/5KsipySteYrjdeEKNS5Sff58i3tAXxDDR4Hj9 uzyHBadKjon5NRx6V3Jrxfjt0GjKXQgJPNDBJOA2tEaDrZy17TRvUd3e4a2d2fDud+6d YMo8aIp38QnYUFzdu6pb2BsvoC62k40oa8vIdoWDb4nwmcYfIK2XPZTKvZR64JokRWZ1 BDABdEB1Th81c3i3cLmuj3r1p1+OuQfRmlweMZMJAR5Tqk4/Wpkc7twglnoQir7Q37XH E0Q/3Zum/jlFkE/x5FnrMb9ZBmAjTsk78mJjaT+Z2Qltz2fmEEhY6FFd3E9Zx8SM65P9 uZBA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:content-transfer-encoding :mime-version:references:in-reply-to:message-id:date:subject:cc:to :from; bh=fBdT9YGMDt41jr/idPnszGetZNrVC6K6T3Kr+ITe0Vk=; fh=6Dd4NlVKI7ZC94T8G4HNieUf/tn/VeIZdapt665fUtI=; b=jrQdIX39snvM1aG3tQ8PnCLxOkcU07G0szJChL4yLNvSOLuzsZoXu/3vj80D0gkO9H VIcWjwE5PjN3Ta772PCbpz/dXKenzFlQve/5VaFjRiNmo5fYhw+rZ+8jJMy4PqI214u7 49qWUVPQvckZ+v38HR5RihcECOYqoleDhtXY20g5xC8w/vBAZrbPphOR/+Gg4EkD9Cd4 xu71coB1n5++/dHQ2bfONnjSjgtxADrWJxqkE7qnPgQryhDIxmsWYfmh63TlKVFgz0EG Y3ptF1pgKBnYR0A8a7ZK7bfcH24iy3bfyCw8l2yhcQDc9lv6wT8v/gBrsGPE0MwRZIp2 8a8w==; darn=linaro.org ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of u-boot-bounces@lists.denx.de designates 2a01:238:438b:c500:173d:9f52:ddab:ee01 as permitted sender) smtp.mailfrom=u-boot-bounces@lists.denx.de; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org X-Forwarded-Encrypted: i=1; AJvYcCX++YZboSOXOMwj3v4Ih+RW7K+B6YFDKTXLwnBviYsD1LvaPUIKRixgxHcWeOQyh58DPhaebUzDD6nz/8fro1ucF41dD/17qZuwzAkmj5Q0T4ajyrgnkN0w18zooB83ve+OeVqqahgy1TwEe5PkID8fnQF+bps1PuePIx7o4FlXLE1z70AVmMWx0kpxTsw7N0iXME/BuYEkn69hpD18nfAXtC9PVcAisS29hxX4wiHv7RouUFbgc3uhXUIdBCJonoeXp3TjvBMcBSXOHNgpu1bbIgPCaCW0nV34pWbEA/f8NSPSGFwQGkos0EP10beblH/XzHNzjA0QUeUic0R1yChr4X2TaVubEMw8jBCO+cftsqJT5GmfBUk7RyPY8XpyYz0NUtWv9k6j50es6AE5Ew+NGBWfyPxbVJVTSLhdATRQTHX5OhWz/nm1Mb3WigbYC5Stfdt1+EgBwDNfdowWO5HPH2vE+JNqH1/Jk8whrmXJbP1/BPpj/EAOB/ZPmaiNbWoahmMXmhWHLNwAJyJyNJoJDvqEbhM+HiFpJQizsO8wA89Abpf16nGJrjlmTzAJMk8hVILi6k5uJImkwRA8qpl3JT+iX5C97v5gFRnKxH2hoZDR9ocCU2zIZCNlhZFOxOnnXuM3DEVxzGINeN/GQKPC+E+GWYqD5CSqpSCNBm3yZl36S1P2vDGjvY3am/8T93Mv9LOMQN7e+DO9vN9VRdb2SHJGRsG8jTmvGzkjDeZb91AfyRVr/h+vUXkUJ78Maig+gDP/IELh7aeZYatR6TFrtr3QpXsecdvhMjmq8xSM7Y47I0gGDzI14wTgUD3ntQPvT82ED9BssbWxQpxqF33luNvfCXtqcVgE+cWmU/1xVFI= Return-Path: Received: from phobos.denx.de (phobos.denx.de. [2a01:238:438b:c500:173d:9f52:ddab:ee01]) by mx.google.com with ESMTPS id h26-20020a170906261a00b00a39e2f9cecdsi3564927ejc.559.2024.02.11.23.51.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 11 Feb 2024 23:51:08 -0800 (PST) Received-SPF: pass (google.com: domain of u-boot-bounces@lists.denx.de designates 2a01:238:438b:c500:173d:9f52:ddab:ee01 as permitted sender) client-ip=2a01:238:438b:c500:173d:9f52:ddab:ee01; Authentication-Results: mx.google.com; spf=pass (google.com: domain of u-boot-bounces@lists.denx.de designates 2a01:238:438b:c500:173d:9f52:ddab:ee01 as permitted sender) smtp.mailfrom=u-boot-bounces@lists.denx.de; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 4F21E87ECD; Mon, 12 Feb 2024 08:48:57 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=fail (p=none dis=none) header.from=linaro.org Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Received: by phobos.denx.de (Postfix, from userid 109) id 4387A87ECD; Mon, 12 Feb 2024 08:48:56 +0100 (CET) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de X-Spam-Level: X-Spam-Status: No, score=-1.2 required=5.0 tests=BAYES_00,SPF_HELO_NONE, SPF_SOFTFAIL,T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.2 Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by phobos.denx.de (Postfix) with ESMTP id 47BA387ECC for ; Mon, 12 Feb 2024 08:48:53 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=fail (p=none dis=none) header.from=linaro.org Authentication-Results: phobos.denx.de; spf=fail smtp.mailfrom=sughosh.ganu@linaro.org Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 555EADA7; Sun, 11 Feb 2024 23:49:34 -0800 (PST) Received: from a079122.blr.arm.com (a079122.arm.com [10.162.17.48]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 88DFF3F762; Sun, 11 Feb 2024 23:48:49 -0800 (PST) From: Sughosh Ganu To: u-boot@lists.denx.de Cc: Heinrich Schuchardt , Ilias Apalodimas , Masahisa Kojima , Patrice Chotard , Patrick Delaunay , Yann Gautier , Etienne Carriere , Michal Simek , Jassi Brar , Sughosh Ganu Subject: [PATCH v2 21/21] doc: fwu: make changes for supporting FWU Metadata version 2 Date: Mon, 12 Feb 2024 13:17:12 +0530 Message-Id: <20240212074712.3657076-22-sughosh.ganu@linaro.org> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20240212074712.3657076-1-sughosh.ganu@linaro.org> References: <20240212074712.3657076-1-sughosh.ganu@linaro.org> MIME-Version: 1.0 X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.39 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" X-Virus-Scanned: clamav-milter 0.103.8 at phobos.denx.de X-Virus-Status: Clean Make changes to the FWU documentation to reflect the changes made with migration of the FWU metadata to version 2. Signed-off-by: Sughosh Ganu --- Changes since V1: None doc/board/socionext/developerbox.rst | 9 +++------ doc/develop/uefi/fwu_updates.rst | 12 +++++------- doc/usage/cmd/fwu_mdata.rst | 12 ++++++++---- 3 files changed, 16 insertions(+), 17 deletions(-) diff --git a/doc/board/socionext/developerbox.rst b/doc/board/socionext/developerbox.rst index 46712c379b..d8c1bb4986 100644 --- a/doc/board/socionext/developerbox.rst +++ b/doc/board/socionext/developerbox.rst @@ -113,8 +113,6 @@ configs/synquacer_developerbox_defconfig enables default FWU configuration :: CONFIG_FWU_MULTI_BANK_UPDATE=y CONFIG_FWU_MDATA=y CONFIG_FWU_MDATA_MTD=y - CONFIG_FWU_NUM_BANKS=2 - CONFIG_FWU_NUM_IMAGES_PER_BANK=1 CONFIG_CMD_FWU_METADATA=y And build it:: @@ -126,10 +124,9 @@ And build it:: make -j `noproc` cd ../ -By default, the CONFIG_FWU_NUM_BANKS and CONFIG_FWU_NUM_IMAGES_PER_BANKS are -set to 2 and 1 respectively. This uses FIP (Firmware Image Package) type image -which contains TF-A, U-Boot and OP-TEE (the OP-TEE is optional). -You can use fiptool to compose the FIP image from those firmware images. +This uses FIP (Firmware Image Package) type image which contains TF-A, +U-Boot and OP-TEE (the OP-TEE is optional). You can use fiptool to +compose the FIP image from those firmware images. Rebuild SCP firmware -------------------- diff --git a/doc/develop/uefi/fwu_updates.rst b/doc/develop/uefi/fwu_updates.rst index e4709d82b4..7911c954d9 100644 --- a/doc/develop/uefi/fwu_updates.rst +++ b/doc/develop/uefi/fwu_updates.rst @@ -43,8 +43,6 @@ The feature can be enabled by specifying the following configs:: CONFIG_FWU_MULTI_BANK_UPDATE=y CONFIG_FWU_MDATA=y CONFIG_FWU_MDATA_GPT_BLK=y - CONFIG_FWU_NUM_BANKS= - CONFIG_FWU_NUM_IMAGES_PER_BANK= in the .config file @@ -94,12 +92,12 @@ of. Each GPT partition entry in the GPT header has two GUIDs:: * UniquePartitionGUID The PartitionTypeGUID value should correspond to the -``image_type_uuid`` field of the FWU metadata. This field is used to +``image_type_guid`` field of the FWU metadata. This field is used to identify a given type of updatable firmware image, e.g. U-Boot, OP-TEE, FIP etc. This GUID should also be used for specifying the `--guid` parameter when generating the capsule. -The UniquePartitionGUID value should correspond to the ``image_uuid`` +The UniquePartitionGUID value should correspond to the ``image_guid`` field in the FWU metadata. This GUID is used to identify images of a given image type in different banks. @@ -108,8 +106,8 @@ metadata partitions. This would be the PartitionTypeGUID for the metadata partitions. Similarly, the UEFI specification defines the ESP GUID to be be used. -When generating the metadata, the ``image_type_uuid`` and the -``image_uuid`` values should match the *PartitionTypeGUID* and the +When generating the metadata, the ``image_type_guid`` and the +``image_guid`` values should match the *PartitionTypeGUID* and the *UniquePartitionGUID* values respectively. Performing the Update @@ -181,5 +179,5 @@ empty capsule would be:: Links ----- -* [1] https://developer.arm.com/documentation/den0118/a/ - FWU Specification +* [1] https://developer.arm.com/documentation/den0118/ - FWU Specification * [2] https://git.codelinaro.org/linaro/dependable-boot/mbfw/uploads/6f7ddfe3be24e18d4319e108a758d02e/mbfw.pdf - Dependable Boot Specification diff --git a/doc/usage/cmd/fwu_mdata.rst b/doc/usage/cmd/fwu_mdata.rst index f1bf08fde1..1804422b33 100644 --- a/doc/usage/cmd/fwu_mdata.rst +++ b/doc/usage/cmd/fwu_mdata.rst @@ -26,10 +26,14 @@ The output may look like: => fwu_mdata_read FWU Metadata - crc32: 0xec4fb997 - version: 0x1 - active_index: 0x0 - previous_active_index: 0x1 + crc32: 0x13c330 + version: 0x2 + active_index: 0x1 + previous_active_index: 0x0 + bank_state[0]: 0xfc + bank_state[1]: 0xfc + bank_state[2]: 0xff + bank_state[3]: 0xff Image Info Image Type Guid: 19D5DF83-11B0-457B-BE2C-7559C13142A5