From patchwork Tue Jun 13 10:38:02 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sughosh Ganu X-Patchwork-Id: 691959 Delivered-To: patch@linaro.org Received: by 2002:a5d:4d91:0:0:0:0:0 with SMTP id b17csp342038wru; Tue, 13 Jun 2023 03:39:47 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ5M9xQQn2U/MLOY++MiU2q9JSMS59cuEfhNJUuQxYkLAziy7xwSqqw9XiHadTCm+ZWkkj49 X-Received: by 2002:a05:6a20:748e:b0:119:69ac:8a8e with SMTP id p14-20020a056a20748e00b0011969ac8a8emr15605709pzd.19.1686652787337; Tue, 13 Jun 2023 03:39:47 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1686652787; cv=none; d=google.com; s=arc-20160816; b=oH7oLnxcamWGkbzAlpp+tfAYfAnTfQj7hBA2KTV8ZU3lb2WP8eoyHF7lyoIBcG+eom tELsSYNUXencDQ7MKT4xuIRHQ96du77CCisnOXi3wGDGFL8OvqtxUPX72VYIqbERMMfI uG2nZ3re27MxVIpPx9gcOyC3Ic6m8CJJmOYOoptiAMRYz7TyRWy3vcyX9WgKk3+P6ZVS cTS6q8mDiMrbNxfX/3eYITdzcY61pBcDPWFUZOS1rxR8qYlLUzdOSdVva4SErq9qgRuO Ca7pA3Cju5XKWXF1eZ4WuRbmdYie9Zk+F9UfbvXZ6o4oPQOu5JinPgPQZdAzNBI36o7h bsXQ== 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=0FBiTdYIp8zniLDkQHf4L3rGNKbvUgevC+T3X9KUzKg=; b=j5d/MgKzTLAKX9Er+j9PyhKq5rfz48PMLmd3LxubQqtBz0bmyuQfkIJ9QaSGBqV8Sm uDqEmaM7GYdVoXANTV+J2g8If6gm8iFM6vhZx3eVkLnOX53b8KME7r4KUcjEROEQ66M7 e0m8dqZSR/NqDajeyWNwpQLOTuytwjsXiBDpCpXPzadNAXyUzBpZqUb5uD49n/KDnzoK 91zg4oBMwsbu/mMXalxPGfWYwrGUBpKpcah34gv7Egj6+ROkczWe70IRdgIDbFfNj7gk TjSgKh21QLFyRw8N7VfhgsKNeLvW82TA3d1nxrakIM9Sh/KO/qRwizF+30Ojw7jGS0kE 83EQ== 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 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 j69-20020a638048000000b0054b4670f5e3si5846901pgd.19.2023.06.13.03.39.46 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 13 Jun 2023 03:39:47 -0700 (PDT) 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 400F3862A7; Tue, 13 Jun 2023 12:39:17 +0200 (CEST) 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 A6CA586246; Tue, 13 Jun 2023 12:38:58 +0200 (CEST) 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 80ED986287 for ; Tue, 13 Jun 2023 12:38:54 +0200 (CEST) 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 8914D2F4; Tue, 13 Jun 2023 03:39:38 -0700 (PDT) Received: from a076522.blr.arm.com (unknown [10.162.46.7]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 877F73F71E; Tue, 13 Jun 2023 03:38:51 -0700 (PDT) From: Sughosh Ganu To: u-boot@lists.denx.de Cc: Heinrich Schuchardt , Ilias Apalodimas , Simon Glass , Michal Simek , Takahiro Akashi , Sughosh Ganu Subject: [PATCH 3/7] doc: capsule: Document the new mechanism to embed ESL file into dtb Date: Tue, 13 Jun 2023 16:08:02 +0530 Message-Id: <20230613103806.812065-4-sughosh.ganu@linaro.org> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20230613103806.812065-1-sughosh.ganu@linaro.org> References: <20230613103806.812065-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 Update the document to specify how the EFI Signature List(ESL) file can be embedded into the platform's dtb as part of the u-boot build. Signed-off-by: Sughosh Ganu --- doc/develop/uefi/uefi.rst | 19 +++++-------------- 1 file changed, 5 insertions(+), 14 deletions(-) diff --git a/doc/develop/uefi/uefi.rst b/doc/develop/uefi/uefi.rst index ffe25ca231..f96762af39 100644 --- a/doc/develop/uefi/uefi.rst +++ b/doc/develop/uefi/uefi.rst @@ -495,20 +495,11 @@ and used by the steps highlighted below. ... } -You can do step-4 manually with - -.. code-block:: console - - $ dtc -@ -I dts -O dtb -o signature.dtbo signature.dts - $ fdtoverlay -i orig.dtb -o new.dtb -v signature.dtbo - -where signature.dts looks like:: - - &{/} { - signature { - capsule-key = /incbin/("CRT.esl"); - }; - }; +You can perform step-4 by defining the Kconfig symbol +CONFIG_EFI_CAPSULE_ESL_FILE. This symbol defines the path to the esl +file generated in step-2. Once the symbol has been populated with the +path to the esl file, the esl file will automatically get embedded +into the platform's dtb as part of u-boot build. Executing the boot manager ~~~~~~~~~~~~~~~~~~~~~~~~~~