From patchwork Thu Oct 22 08:21:39 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Igor Opaniuk X-Patchwork-Id: 1386055 X-Patchwork-Delegate: sbabic@denx.de 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=2a01:238:438b:c500:173d:9f52:ddab:ee01; helo=phobos.denx.de; envelope-from=u-boot-bounces@lists.denx.de; receiver=) Authentication-Results: ozlabs.org; dmarc=pass (p=none dis=none) header.from=gmail.com 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=YcK5vk3g; dkim-atps=neutral Received: from phobos.denx.de (phobos.denx.de [IPv6:2a01:238:438b:c500:173d:9f52:ddab:ee01]) (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 4CH0hr3V6nz9sVN for ; Thu, 22 Oct 2020 19:22:20 +1100 (AEDT) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 40DC882468; Thu, 22 Oct 2020 10:22:05 +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="YcK5vk3g"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 0F49D82441; Thu, 22 Oct 2020 10:21:56 +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,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.2 Received: from mail-lj1-x230.google.com (mail-lj1-x230.google.com [IPv6:2a00:1450:4864:20::230]) (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 16AB482431 for ; Thu, 22 Oct 2020 10:21:52 +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=igor.opaniuk@gmail.com Received: by mail-lj1-x230.google.com with SMTP id d24so975097ljg.10 for ; Thu, 22 Oct 2020 01:21:52 -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; bh=+BOwvFMGr93MutdBNoYxiitykqWLoJJzUC74WBU7HZU=; b=YcK5vk3gH22hCbHcAMdd23EHn5BEHDULHXgXtUzyQt5B2tOCsGhcQ/6LztlipMidc5 ujtsIrGXBkjFDTzlVoo2BrLBPmaPcb7DfiB4OA/tW/9R4czVAST/TCLQxXD5KitSOH+d dArDXCgFKxf3NUftNWMYnHZkjdtTupywePYSoM6Y8nPZLquGQZPpQAzTSiB1CjQx+47G 3xI6DAy6b7um7G/yPBZv98WKw4gtkl5UKmpsAt0bcOd+DIxxOhTk4Bv/p82cD7g8VAFq deMOaLBiIAFAPB+p+RvESJBTV1+1ShXCWwXUjmnxB1zP88X5F6V1GtxisbcQ+kMu4K+n Z+Mg== 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; bh=+BOwvFMGr93MutdBNoYxiitykqWLoJJzUC74WBU7HZU=; b=cm8Jy2jdI/+QqCUBYbJXO25K8mWwREt/x+hg9vUvpahEqz5TF3HTcYY6JtVLi+4Klm cZ/RfipdcG3woxpkLpQChL9jGct7DWRyXWrlYEI/ebc6rxBWZ0rkGesKlWO7MSjarop1 jNmdyMucg6sy1OuKGAQo/lyawvS1CX9OZ+AsLIIj5hTsXCgm/EUa+61Ai1yrVo1VnR6H w7uiJnLRzJgdGla6NKz/YnTInZ9It83BjZguRh/xSl+VHAk1NxDJeE1BW1yv282UsAyz qaS7PPxOksFZGhQ9BFKM23GoFYMwsyf2VD/OCvdQdUoAoSJEWFq6OuJzVeDAgO8OupNS lK2w== X-Gm-Message-State: AOAM5333TZWCEI8YtPaJyIjI1yZLLvDcNgdBTmfPWCgkKUHKxCuiQAwN w/c4kuiG91DDym+O1RI0aabj2Nd08xz2Xg== X-Google-Smtp-Source: ABdhPJxE6YqtIc8bg/9lMRTb/KYLcGvW1gwn402Ij+MTl9sT3FGroXJzi7EtcW8EXkjPqfosTKWfRA== X-Received: by 2002:a05:651c:1341:: with SMTP id j1mr566705ljb.41.1603354910970; Thu, 22 Oct 2020 01:21:50 -0700 (PDT) Received: from localhost ([109.108.76.111]) by smtp.gmail.com with ESMTPSA id 73sm152857lff.125.2020.10.22.01.21.50 (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Thu, 22 Oct 2020 01:21:50 -0700 (PDT) From: Igor Opaniuk To: u-boot@lists.denx.de Cc: Max Krummenacher , Peng Fan , Stefano Babic , Marcel Ziswiler , Oleksandr Suvorov , Philippe Schenker , Igor Opaniuk , Bin Meng Subject: [PATCH v1 3/7] doc: board: apalis-imx8x: add documentation Date: Thu, 22 Oct 2020 11:21:39 +0300 Message-Id: <20201022082143.21170-4-igor.opaniuk@gmail.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20201022082143.21170-1-igor.opaniuk@gmail.com> References: <20201022082143.21170-1-igor.opaniuk@gmail.com> 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.3 at phobos.denx.de X-Virus-Status: Clean From: Igor Opaniuk This documents the u-boot build and deployment procedure. Signed-off-by: Igor Opaniuk Reviewed-by: Oleksandr Suvorov --- doc/board/toradex/apalix-imx8x.rst | 74 ++++++++++++++++++++++++++++++ doc/board/toradex/index.rst | 1 + 2 files changed, 75 insertions(+) create mode 100644 doc/board/toradex/apalix-imx8x.rst diff --git a/doc/board/toradex/apalix-imx8x.rst b/doc/board/toradex/apalix-imx8x.rst new file mode 100644 index 0000000000..ce7dde8d00 --- /dev/null +++ b/doc/board/toradex/apalix-imx8x.rst @@ -0,0 +1,74 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +Apalis iMX8X V1.1A Module +========================== + +Quick Start +----------- + +- Build the ARM trusted firmware binary +- Get scfw_tcm.bin and ahab-container.img +- Build U-Boot +- Load U-Boot binary using uuu +- Flash U-Boot binary into the eMMC +- Boot + +Get and Build the ARM Trusted Firmware +-------------------------------------- + +.. code-block:: bash + + $ git clone -b toradex_imx_5.4.24_2.1.0 http://git.toradex.com/cgit/imx-atf.git + $ cd imx-atf/ + $ make PLAT=imx8qx bl31 + +Get scfw_tcm.bin and ahab-container.img +--------------------------------------- + +.. code-block:: bash + + $ wget https://github.com/toradex/i.MX-System-Controller-Firmware/blob/master/src/scfw_export_mx8qx_b0/build_mx8qx_b0/mx8qx-apalis-scfw-tcm.bin + $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/imx-seco-3.6.3.bin + $ chmod +x imx-seco-3.6.3.bin + $ ./imx-seco-3.6.3.bin + +Copy the following binaries to the U-Boot folder: + +.. code-block:: bash + + $ cp imx-atf/build/imx8qx/release/bl31.bin . + $ cp imx-seco-3.6.3/firmware/seco/mx8qxb0-ahab-container.img mx8qx-ahab-container.imx8_defconfig + +Build U-Boot +------------ +.. code-block:: bash + + $ make apalis-imx8x_defconfig + $ make u-boot-dtb.imx + +Load the U-Boot Binary Using UUU +-------------------------------- + +Get the latest version of the universal update utility (uuu) aka ``mfgtools 3.0``: + +https://community.nxp.com/external-link.jspa?url=https%3A%2F%2Fgithub.com%2FNXPmicro%2Fmfgtools%2Freleases + +Put the module into USB recovery aka serial downloader mode, connect USB device +to your host and execute uuu: + +.. code-block:: bash + + sudo ./uuu u-boot/u-boot-dtb.imx + +Flash the U-Boot Binary into the eMMC +------------------------------------- + +Burn the ``u-boot-dtb.imx`` binary to the primary eMMC hardware boot area +partition and boot: + +.. code-block:: bash + + load mmc 1:1 $loadaddr u-boot-dtb.imx + setexpr blkcnt ${filesize} + 0x1ff && setexpr blkcnt ${blkcnt} / 0x200 + mmc dev 0 1 + mmc write ${loadaddr} 0x0 ${blkcnt} diff --git a/doc/board/toradex/index.rst b/doc/board/toradex/index.rst index 16b5a0770d..abba648f86 100644 --- a/doc/board/toradex/index.rst +++ b/doc/board/toradex/index.rst @@ -7,6 +7,7 @@ Toradex :maxdepth: 2 apalix-imx8 + apalix-imx8x colibri_imx7 colibri-imx8x verdin-imx8mm