From patchwork Mon Jan 25 19:12:47 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Heinrich Schuchardt X-Patchwork-Id: 1431352 X-Patchwork-Delegate: xypron.glpk@gmx.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=85.214.62.61; helo=phobos.denx.de; envelope-from=u-boot-bounces@lists.denx.de; receiver=) Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; secure) header.d=gmx.net header.i=@gmx.net header.a=rsa-sha256 header.s=badeba3b8450 header.b=HfnhcQ/P; 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) server-digest SHA256) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 4DPffR4hz0z9rx8 for ; Tue, 26 Jan 2021 06:13:27 +1100 (AEDT) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 9A1FE82626; Mon, 25 Jan 2021 20:13:14 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=fail (p=none dis=none) header.from=gmx.de Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (1024-bit key; secure) header.d=gmx.net header.i=@gmx.net header.b="HfnhcQ/P"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id E17E48263A; Mon, 25 Jan 2021 20:13:12 +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.9 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,FREEMAIL_FROM,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL,SPF_HELO_NONE autolearn=ham autolearn_force=no version=3.4.2 Received: from mout.gmx.net (mout.gmx.net [212.227.15.18]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id 8BA8682603 for ; Mon, 25 Jan 2021 20:13:08 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=gmx.de Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=xypron.glpk@gmx.de DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1611601972; bh=F7LtNvNF82+elqfxMNxO5bLdUts0TmusnU8w0fGrRH8=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date; b=HfnhcQ/Pxs+WW1LP+bIHhjsUxrCS7HRwDaaAGNZrEKiQT+/75AxwhKE8ZGKIRemFI njEH5rA9DzN0/YKarjjGaU2rwAg6QMw4uJXeRN7zVrIkTXSArYp4zNZ64UHs0v1SiM 9qXe8LvXyq4mPSRUYaRZX1XVN3F6YEhu/xeI3oSw= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Received: from LT02.fritz.box ([62.143.246.89]) by mail.gmx.net (mrgmx005 [212.227.17.184]) with ESMTPSA (Nemesis) id 1M9Wys-1l7P4i2ahg-005b2u; Mon, 25 Jan 2021 20:12:52 +0100 From: Heinrich Schuchardt To: Tom Rini Cc: Bin Meng , Padmarao Begari , Anup Patel , u-boot@lists.denx.de, Heinrich Schuchardt Subject: [PATCH 1/1] doc: board: fix Microchip MPFS Icicle Kit doc Date: Mon, 25 Jan 2021 20:12:47 +0100 Message-Id: <20210125191247.22868-1-xypron.glpk@gmx.de> X-Mailer: git-send-email 2.29.2 MIME-Version: 1.0 X-Provags-ID: V03:K1:0aAtwDo3x9sVmcmUEzurLFXjbSFpDKokILyubwBHaL1BtJhVrsp PLBeePVy58TepQn3kThzVzLgCjpUG7S+eKUQCkVLXC4iK5RFAx7tmia8knj0CPUKIWfTj4C 12fvhFBN2BaiYSSEb67myMr7+E9iTGZWxUf4DEs8vGa8+Zl3OM15P0xy/GyK4HjtHJeD+aq nid2PT/3qXnn6vMY/rzuA== X-UI-Out-Filterresults: notjunk:1;V03:K0:6QyTBA9x9og=:zCQVZrba1eAGzCWzpIGVqS el7NsTT6pIb769Kse7929EqfTYTfQxmmy5pS9lnJzsndvkZzMwIKOuwq8gco17Radqq9T8NJa A92Zvx29/p563OIY4i0zsi4KaSVBj3Nt7l9HYz7Ky9vch1C89dwfFv6NVPNL5ffROFLLIMqxz G6CFpRTCsvdz29APFFs/l/tGHydnvWG24dNYcR7pjveL1KJ5SrTedYahT9zjnibWEMUQum0RF aRYKcgZEwCe0N/jG847/CDdp/FJhlHqT0Yl1yfdGcEfG9qBpipPu47jBeWEVyriQUKMX62iZJ aE5HVITxHplbC/FcWq9DlHeohqGviqGIZiTn//fltkWnPzjjsg/OPo8a2niH6zz1oZSJUUFpi BvLJLK/tZbun4Rp/xjqpPCRyEfm2AW9qhwIIIyRawWAszw0+zEiamXJsTQbEN1VSLVPLQsL9r QTlLhNLA1v4eAMYlrZL+lD7mLqOZtapZPS5tTBulbae4R2MsPgLa0tDdXhmCFAdYqAOJI4QgH iCToNyYnldmY1yVLOrJ3S1PkpvV/6BiNaIS3dYBXhxxX76KgIPFMdu3yRNWobfq3Os0HvQZtv qDhxyrou3YSxshjd/iJo9F8KFd6izK9tnx9SAnjEBSMhFO0kE1Evt/BbEhIC9MwHMPiU+W7PH MSHBJAGu4dPI3gAH3ZMZq0soJPjuIwkr43n9d6JeNbNYUBZ94ZcqztlJ4FyCtIkI+H1ZirE3E R8HHy4RNCVIPItNkq576dGNs0gyAMS+0++yi1IU/QC6NTMPMLz9tmsCEWQBrcsTOdGTi6V5v7 WWEdj/sZqCe735GPL6PXPe8Zj2Of/oGSwUmgsREUFYOAXD5tHYms+YoFXe5a/Sk03M4wDwvv8 U35hy+4Rv+IQiHUYydPQ== 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 Two sibling headings (here eMMC) cannot have the same title. Warning, treated as error: doc/board/microchip/mpfs_icicle.rst:423:duplicate label board/microchip/mpfs_icicle:emmc, other instance in doc/board/microchip/mpfs_icicle.rst make[1]: *** [doc/Makefile:69: htmldocs] Error 2 * Correct the heading levels. * Add missing empty lines after headings. Fixes: 9e550e18305f ("doc: board: Add Microchip MPFS Icicle Kit doc") Signed-off-by: Heinrich Schuchardt --- doc/board/microchip/mpfs_icicle.rst | 51 +++++++++++++++++++---------- 1 file changed, 33 insertions(+), 18 deletions(-) -- 2.29.2 diff --git a/doc/board/microchip/mpfs_icicle.rst b/doc/board/microchip/mpfs_icicle.rst index 7489761501..c71c2f3cab 100644 --- a/doc/board/microchip/mpfs_icicle.rst +++ b/doc/board/microchip/mpfs_icicle.rst @@ -5,6 +5,7 @@ Microchip PolarFire SoC Icicle Kit RISC-V PolarFire SoC -------------------- + The PolarFire SoC is the 4+1 64-bit RISC-V SoC from Microchip. The Icicle Kit development platform is based on PolarFire SoC and capable @@ -12,6 +13,7 @@ of running Linux. Mainline support ---------------- + The support for following drivers are already enabled: 1. NS16550 UART Driver. @@ -23,7 +25,7 @@ Booting from eMMC using HSS --------------------------- Building U-Boot ---------------- +~~~~~~~~~~~~~~~ 1. Add the RISC-V toolchain to your PATH. 2. Setup ARCH & cross compilation environment variable: @@ -36,7 +38,7 @@ Building U-Boot 4. make Flashing --------- +~~~~~~~~ The current U-Boot port is supported in S-mode only and loaded from DRAM. @@ -48,11 +50,13 @@ boot-flow) and OpenSBI generic platform fw_payload.bin (with u-boot.bin embedded as HSS payload (Custom boot-flow) Microchip boot-flow -------------------- +~~~~~~~~~~~~~~~~~~~ + HSS with OpenSBI (M-Mode) -> U-Boot (S-Mode) -> Linux (S-Mode) Build the HSS (Hart Software Services) - Microchip boot-flow ------------------------------------------------------------- +'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' + (Note: HSS git repo is at https://github.com/polarfire-soc/hart-software-services) 1. Configure @@ -74,13 +78,15 @@ Alternatively, copy the default config for Microchip boot-flow. The FPGA design will use the hss.hex or hss.bin. FPGA design with HSS programming file -------------------------------------- +''''''''''''''''''''''''''''''''''''' + https://github.com/polarfire-soc/polarfire-soc-documentation/blob/master/boards/mpfs-icicle-kit-es/updating-icicle-kit/updating-icicle-kit-design-and-linux.md The HSS firmware runs from the PolarFire SoC eNVM on reset. Creating the HSS payload - Microchip boot-flow ----------------------------------------------- +'''''''''''''''''''''''''''''''''''''''''''''' + 1. You will be creating a payload from `u-boot-dtb.bin`. Copy this file to the HSS/tools/hss-payload-generator/test directory. 2. Go to hss-payload-generator source directory. @@ -108,11 +114,12 @@ Please refer to HSS documenation to build the HSS firmware for payload. (Note: HSS git repo is at https://github.com/polarfire-soc/hart-software-services/blob/master/tools/hss-payload-generator/README.md) Custom boot-flow ----------------- +~~~~~~~~~~~~~~~~ + HSS without OpenSBI (M-Mode) -> OpenSBI (M-Mode) -> U-Boot (S-Mode) -> Linux (S-Mode) Build OpenSBI -------------- +''''''''''''' 1. Get the OpenSBI source @@ -132,7 +139,8 @@ Build OpenSBI "/build/platform/generic/firmware/fw_payload.bin" Build the HSS (Hart Software Services)- Custom boot-flow --------------------------------------------------------- +'''''''''''''''''''''''''''''''''''''''''''''''''''''''' + (Note: HSS git repo is at https://github.com/polarfire-soc/hart-software-services) 1. Configure @@ -154,7 +162,8 @@ Alternatively, copy the default custom config for Custom boot-flow. The FPGA design will use the hss.hex or hss.bin. Creating the HSS payload - Custom boot-flow -------------------------------------------- +''''''''''''''''''''''''''''''''''''''''''' + 1. You will be creating a payload from `fw_payload.bin`. Copy this file to the HSS/tools/hss-payload-generator/test directory. 2. Go to hss-payload-generator source directory. @@ -183,7 +192,8 @@ Please refer to HSS documenation to build the HSS firmware for payload. and also refer the HSS payload generator at https://github.com/polarfire-soc/polarfire-soc-documentation/blob/master/software-development/hss-payloads.md) eMMC ----- +~~~~ + Program eMMC with payload binary is explained in the PolarFire SoC documentation. (Note: PolarFire SoC Documentation git repo is at https://github.com/polarfire-soc/polarfire-soc-documentation/blob/master/boards/mpfs-icicle-kit-es/updating-icicle-kit/updating-icicle-kit-design-and-linux.md#eMMC) @@ -195,17 +205,19 @@ line interface, then type 'boot' and enter to boot the newly copied image. sudo dd if= of=/dev/sdX bs=512 GUID type ---------- +~~~~~~~~~ + The HSS always picks up HSS payload from a GPT partition with GIUD type "21686148-6449-6E6F-744E-656564454649" or sector '0' of the eMMC if no GPT partition. Booting -------- +~~~~~~~ + You should see the U-Boot prompt on UART0. Sample boot log from MPFS Icicle Kit ------------------------------------- +'''''''''''''''''''''''''''''''''''' .. code-block:: none @@ -414,13 +426,15 @@ Booting U-Boot and Linux from eMMC ---------------------------------- FPGA design with HSS programming file and Linux Image ------------------------------------------------------ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + https://github.com/polarfire-soc/polarfire-soc-documentation/blob/master/boards/mpfs-icicle-kit-es/updating-icicle-kit/updating-icicle-kit-design-and-linux.md The HSS firmware runs from the PolarFire SoC eNVM on reset. eMMC ----- +~~~~ + Program eMMC with payload binary and Linux image is explained in the PolarFire SoC documentation. The payload binary should be copied to partition 2 of the eMMC. @@ -440,13 +454,14 @@ copied payload and Linux image. You should see the U-Boot prompt on UART0. GUID type ---------- +~~~~~~~~~ + The HSS always picks up the HSS payload from a GPT partition with GIUD type "21686148-6449-6E6F-744E-656564454649" or sector '0' of the eMMC if no GPT partition. Sample boot log from MPFS Icicle Kit ------------------------------------- +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. code-block:: none