From patchwork Mon Mar 29 17:05:15 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alexandru Gagniuc X-Patchwork-Id: 1459728 X-Patchwork-Delegate: trini@ti.com Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=lists.denx.de (client-ip=85.214.62.61; helo=phobos.denx.de; envelope-from=u-boot-bounces@lists.denx.de; receiver=) Authentication-Results: ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20161025 header.b=bto1/jJa; dkim-atps=neutral Received: from phobos.denx.de (phobos.denx.de [85.214.62.61]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 4F8Js135z1z9sVS for ; Tue, 30 Mar 2021 04:06:45 +1100 (AEDT) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 486348292B; Mon, 29 Mar 2021 19:05:44 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="bto1/jJa"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id B0EC2828B9; Mon, 29 Mar 2021 19:05:29 +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=-2.0 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FROM,SPF_HELO_NONE autolearn=ham autolearn_force=no version=3.4.2 Received: from mail-ot1-x332.google.com (mail-ot1-x332.google.com [IPv6:2607:f8b0:4864:20::332]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id 45021828BC for ; Mon, 29 Mar 2021 19:05:26 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=mr.nuke.me@gmail.com Received: by mail-ot1-x332.google.com with SMTP id l12-20020a9d6a8c0000b0290238e0f9f0d8so12951752otq.8 for ; Mon, 29 Mar 2021 10:05:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=o9Q3wfpYgCIfkZ4O0A9kVGvC6bEybiWrAf56+aKPk4E=; b=bto1/jJaHAXdcrSgSaQ65cX1IcQw8MjBBhrqtQEo25tBG1ot9qqYAuInYG6vCX/CS1 IJ+cWZzkNOvJguGn0UwmvEsuGHkvNkvf+u23OUzq9Vwjycn1k5lg6EkcQmtn/XAwwKpC oRCOWjH/UswXMeIvdoiOKuAq9S1r3YHc3yLDvdNyI/3IplcQxTdIA9Y2oWOUl6zFW/RK MeRcHMD+PcWsQNJ+A1WjjvxAv21DU4INyUuaqjXvitoYcnWC7dRgtNCCZDzIOSESRv/C jGH7Uz0ZSU4g/tBrv8tjqO5/j32zfzBCG+QhxHxrugpaNqQMrvLigvF/OyLoEaSFzmzD XMyg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=o9Q3wfpYgCIfkZ4O0A9kVGvC6bEybiWrAf56+aKPk4E=; b=IT9OjjXa5mKV5s5Hyb+HyS24pPMedPHhby3/2c8trFwebF9QHmDXpMrOPtUajxeKWu sFCv64gKsaZsxdbdmAWuEw32BXm7BOsmj8C2WdCJN77Z8G7TWZoJi9ZnzttxTVACUMfC uBsfTLGKxxMvTPzq3rRdBFjyZVRg/ivR52Lw0CFRmVEr8Ul+6liE5r57Fq0YrOV1M4Pp +U0L4g2RYao1FbKOEe8WTSrJ+FkSXzIY3VsKBRzRh5CzNd0LHiZaEZg+oHKIYFZ8tm9L KLAkA0c58ARROtsQ8zbLjjOEGFwOWzUVythp5DwMcdTanm4+5kkhFMK4kErcIYesqpTZ F9ow== X-Gm-Message-State: AOAM532q5CyxU7vFoACVSqZTT6UMZ8dR/Rl3G8BPoKSE18mW2MDj391X b63hqRUAT25dNMCUY4WtbJe+z731uKs= X-Google-Smtp-Source: ABdhPJz2cHwNOksW2ecfGzMSYvosf9r7Io+yTPuB5q0GzcGjUsidOBFKrmgykOX5lq5pnpd/z0ESjw== X-Received: by 2002:a05:6830:3197:: with SMTP id p23mr24290569ots.3.1617037524656; Mon, 29 Mar 2021 10:05:24 -0700 (PDT) Received: from nuclearis2-1.gtech (c-98-195-139-126.hsd1.tx.comcast.net. [98.195.139.126]) by smtp.gmail.com with ESMTPSA id n13sm4485049otk.61.2021.03.29.10.05.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 29 Mar 2021 10:05:24 -0700 (PDT) From: Alexandru Gagniuc To: u-boot@lists.denx.de, sjg@chromium.org Cc: Alexandru Gagniuc , trini@konsulko.com, marex@denx.de Subject: [PATCH v2 6/7] Kconfig: Document the limitations of the simple SPL_LOAD_FIT path Date: Mon, 29 Mar 2021 12:05:15 -0500 Message-Id: <20210329170516.1893519-7-mr.nuke.me@gmail.com> X-Mailer: git-send-email 2.26.3 In-Reply-To: <20210329170516.1893519-1-mr.nuke.me@gmail.com> References: <20210329170516.1893519-1-mr.nuke.me@gmail.com> MIME-Version: 1.0 X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.34 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.102.4 at phobos.denx.de X-Virus-Status: Clean The "simple" SPL_LOAD_FIT path is the most compliant with the format documented in doc/uImage.FIT/source_file_format.txt. The other two paths to load a FIT are SPL_LOAD_FIT_FULL and the "bootm" command. Since the Kconfig menu is the most likely place for a new user to see these options, it seems like the most logical candidate to document the limitations. This documents the _known_ issues, and is not intended to be a complete list of all follies. Signed-off-by: Alexandru Gagniuc Reviewed-by: Simon Glass --- common/Kconfig.boot | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/common/Kconfig.boot b/common/Kconfig.boot index 9c335f4f8c..5a18d62d78 100644 --- a/common/Kconfig.boot +++ b/common/Kconfig.boot @@ -202,6 +202,16 @@ config SPL_LOAD_FIT particular it can handle selecting from multiple device tree and passing the correct one to U-Boot. + This path has the following limitations: + + 1. "loadables" images, other than FTDs, which do not have a "load" + property will not be loaded. This limitation also applies to FPGA + images with the correct "compatible" string. + 2. For FPGA images, only the "compatible" = "u-boot,fpga-legacy" + loading method is supported. + 3. FDTs are only loaded for images with an "os" property of "u-boot". + "linux" images are also supported with Falcon boot mode. + config SPL_LOAD_FIT_ADDRESS hex "load address of fit image" depends on SPL_LOAD_FIT