From patchwork Tue May 20 09:54:57 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jamin Lin X-Patchwork-Id: 63302 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 80AB8C3ABDD for ; Tue, 20 May 2025 09:55:11 +0000 (UTC) Received: from TWMBX01.aspeed.com (TWMBX01.aspeed.com [211.20.114.72]) by mx.groups.io with SMTP id smtpd.web11.17241.1747734901425885616 for ; Tue, 20 May 2025 02:55:01 -0700 Authentication-Results: mx.groups.io; dkim=none (message not signed); spf=pass (domain: aspeedtech.com, ip: 211.20.114.72, mailfrom: jamin_lin@aspeedtech.com) Received: from TWMBX01.aspeed.com (192.168.0.62) by TWMBX01.aspeed.com (192.168.0.62) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.1748.10; Tue, 20 May 2025 17:54:58 +0800 Received: from mail.aspeedtech.com (192.168.10.10) by TWMBX01.aspeed.com (192.168.0.62) with Microsoft SMTP Server id 15.2.1748.10 via Frontend Transport; Tue, 20 May 2025 17:54:58 +0800 From: Jamin Lin To: CC: , Subject: [PATCH v1] ref-manual: uboot-sign: Support firmware property in FIT config Date: Tue, 20 May 2025 17:54:57 +0800 Message-ID: <20250520095457.3642012-1-jamin_lin@aspeedtech.com> X-Mailer: git-send-email 2.43.0 MIME-Version: 1.0 List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Tue, 20 May 2025 09:55:11 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/6848 Add documentation for the UBOOT_FIT_CONF_FIRMWARE variable, which allows users to specify an image to be assigned to the "firmware" property of the FIT configuration node. This explicitly defines the primary image to boot, instead of relying on the first entry in the "loadables" list. Signed-off-by: Jamin Lin --- documentation/ref-manual/classes.rst | 2 ++ documentation/ref-manual/variables.rst | 8 ++++++++ 2 files changed, 10 insertions(+) diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst index 5187033f7..54a98bf24 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst @@ -3426,6 +3426,8 @@ The variables used by this class are: - :term:`UBOOT_FIT_USER_SETTINGS`: adds a user-specific snippet to the U-Boot Image Tree Source (ITS). Users can include their custom U-Boot Image Tree Source (ITS) snippet in this variable. +- :term:`UBOOT_FIT_CONF_FIRMWARE`: adds one image to the ``firmware`` property + of the configuration node. - :term:`UBOOT_FIT_CONF_USER_LOADABLES`: adds one or more user-defined images to the ``loadables`` property of the configuration node. diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 643a3e7ae..b430fa51f 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -10327,6 +10327,14 @@ system and gives an overview of their function and contents. do_compile[depends] += "trusted-firmware-a:do_deploy" + :term:`UBOOT_FIT_CONF_FIRMWARE` + Adds one image to the ``firmware`` property of the configuration node + of the U-Boot Image Tree Source (ITS). Sets the firmware property to select + the image to boot first. If not set, the first entry in "loadables" is used + instead.:: + + UBOOT_FIT_CONF_FIRMWARE = "fwa" + :term:`UBOOT_FIT_CONF_USER_LOADABLES` Adds one or more user-defined images to the ``loadables`` property of the configuration node of the U-Boot Image Tree Source (ITS). This variable