From patchwork Mon Apr 24 01:15:15 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ralph Siemsen X-Patchwork-Id: 676486 Delivered-To: patch@linaro.org Received: by 2002:a5d:4a41:0:0:0:0:0 with SMTP id v1csp1922999wrs; Sun, 23 Apr 2023 18:17:42 -0700 (PDT) X-Google-Smtp-Source: AKy350ZhIi3CPdQ07q/akIxp4R8eXMMx8EaYa2Tsw7veOaE/lsfG4Nx6LaY+R9hZpTL7xpxYtiep X-Received: by 2002:a17:90a:fd87:b0:23f:9439:9a27 with SMTP id cx7-20020a17090afd8700b0023f94399a27mr12062328pjb.20.1682299062302; Sun, 23 Apr 2023 18:17:42 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1682299062; cv=none; d=google.com; s=arc-20160816; b=petx1jmeh3vUkZPWVn8rMuJ9OdgAB6ufhU6aXpSWurZiH/Qo8IQbihRq37Cq00sv2R qog7lHf3kUnln+jaqq2ZpnO83QgBYVjWx+DlNkA7/nQx9gK/zgcBSwcsYRkidq8FCcpk hNM9KVOFDyEMNWUU4OU68jpHsXmL+CMS/5vCZWkOp+K1w9xl9dNqThue3w28jhM9qu50 mulPPKhh0OXrfdLH7rMh58SYiPnJnGg2LbgrMxEB+R2Ro0KLfTY5D6cnOUPwVhEArBLE 6/W/Fs5xdcWtDzv44O7jPrOVD+SAeNAXrRnQYh9EvK7hlwWx6v5Yx4Vs1gmQ/h0E2lzm ZgVg== 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:dkim-signature; bh=fcUJbtlAHQcgCg/Q/V2WTooUqNhaou2WTMde0dzkBRc=; b=IBM9r4+a5786PIMLMeS4z8hpH7+VCywaz+zpmdaIiy01EY7sxgdn0lyVuCe1ccL6pI WkRWN4lYPPgu4bBkZmNFeIfYUgU+Dt1rzicnnOmE0HylwIRB87rLiCdcfDSUFJFC/QCR fgv5/arsA+vvlMqXb1yUqOg47simdKHzxrapjqdt1l2JBzmDdMvEUL1dv+1oWxXsC+0i X5Sb4keB/IqOjTZgrdGGiCvhOkS4ewq6bpqFZUzdZbomTlJ/QtxqlOmdbF3+jGT/peqT B9+H4Faff3En3VY3Oqf/NlCliNU56QKw5vg1gr0E/cD7Gn0/AB2aR5MgDG0yPAVfjr+P cNOw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b="mh0/XVUu"; 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=pass (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 kk17-20020a17090b4a1100b0022c9cb7662csi14051486pjb.159.2023.04.23.18.17.41 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 23 Apr 2023 18:17:42 -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; dkim=pass header.i=@linaro.org header.s=google header.b="mh0/XVUu"; 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=pass (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 266F88611E; Mon, 24 Apr 2023 03:16:07 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=linaro.org 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=linaro.org header.i=@linaro.org header.b="mh0/XVUu"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 8D9F0860F1; Mon, 24 Apr 2023 03:15:48 +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.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_NONE,SPF_PASS, T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.2 Received: from mail-qk1-x734.google.com (mail-qk1-x734.google.com [IPv6:2607:f8b0:4864:20::734]) (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 71B238611C for ; Mon, 24 Apr 2023 03:15:38 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=linaro.org Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=ralph.siemsen@linaro.org Received: by mail-qk1-x734.google.com with SMTP id af79cd13be357-74adf6adac6so432046985a.0 for ; Sun, 23 Apr 2023 18:15:38 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1682298937; x=1684890937; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=fcUJbtlAHQcgCg/Q/V2WTooUqNhaou2WTMde0dzkBRc=; b=mh0/XVUu9gF8Jhr3E6ny+nYxS5dGd7BVgCee/TjeNr6OxiiF6ycX1o0DLA5MzBNYuX NJqW7MBc0QCSvDaB/JQG9avN5EigcAMICTjC5IyotYnzq+XsHieTTh5MECpR255EEbwZ tCHV5Jdjo9/UXy4lHaXY5UIFRluj49wnUvkiIRU7dvVjw7oXgGR7Es1AcQE3froxI+EO eDfEcNhHydmcUv6x+EwVpo6nfWjV5FJ4KmTeAQo6s/1NsjbpNP1L4duJvO6Uls9ofpuP nVIrIwTHA1MXlkn2BdMC9hY1L3RMRfxgAnBWq6ESqHEQ1tZkEDfP3NGGP/WOvfjU6+lx 2cGg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1682298937; x=1684890937; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=fcUJbtlAHQcgCg/Q/V2WTooUqNhaou2WTMde0dzkBRc=; b=TiqtPBrERg53PjXqyt2WCndgZ3GiaguDnPWQuA7nh0IoJdGFEbCZSmLahq1twdAGda zqXVo7awUE69mEytM+Lj1/toqbxEwhj96clK6gnM66MPsA1j6rYIFqFWaPYPN4Rc726I wwFxeVaq5aH1pegvLpCTl9cH5UF5SKOlHd+2OWQxivW65AJyXk5DMVVEZSLCMVJonx5D Ohvht2+RVoc9NpzQySe+HvT8jcJUIBXKhvP9GX1KCynTRT3xCVNAwgWaGr/66Orh7J0b JD9/PZ6g7XST+1RxfUrHBtY1U8jWqVMdFK1jRDzgFjJxUxDCQfStNEaBIMG9g1aEWu4D SZTw== X-Gm-Message-State: AAQBX9dj3n73meeqjKShK7oy1Jcwbn/B7w0xJMbsAYqnm1Dj5Pl6zuYB v7EEwTBxO+WneOcOcF1iZCw0JnMb5aewUU6FG5PnPw== X-Received: by 2002:a05:622a:15cd:b0:3ef:62df:f1de with SMTP id d13-20020a05622a15cd00b003ef62dff1demr13826691qty.43.1682298937044; Sun, 23 Apr 2023 18:15:37 -0700 (PDT) Received: from maple.netwinder.org (rfs.netwinder.org. [206.248.184.2]) by smtp.gmail.com with ESMTPSA id z20-20020ac87f94000000b003b635a5d56csm3225447qtj.30.2023.04.23.18.15.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 23 Apr 2023 18:15:36 -0700 (PDT) From: Ralph Siemsen To: u-boot@lists.denx.de Cc: Marek Vasut , Ralph Siemsen , Adam Ford , Angus Ainslie , Fabio Estevam , Tim Harvey , Weijie Gao , Yanhong Wang Subject: [PATCH v5 10/10] doc: renesas: add Renesas board docs Date: Sun, 23 Apr 2023 21:15:15 -0400 Message-Id: <20230424011515.1359255-11-ralph.siemsen@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230424011515.1359255-1-ralph.siemsen@linaro.org> References: <20230424011515.1359255-1-ralph.siemsen@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 As a starting point, list all currently supported Renesas boards. For the RZ/N1 board, add details about booting and flashing. Signed-off-by: Ralph Siemsen Reviewed-by: Marek Vasut --- Changes in v5: - added renesas dir to doc/board/index.rst - corrections to list of Renesas boards - move RZ/N1 detail into its own file - moved binman description ahead of mkimage doc/board/index.rst | 1 + doc/board/renesas/index.rst | 10 +++++ doc/board/renesas/renesas.rst | 45 ++++++++++++++++++++ doc/board/renesas/rzn1.rst | 77 +++++++++++++++++++++++++++++++++++ 4 files changed, 133 insertions(+) create mode 100644 doc/board/renesas/index.rst create mode 100644 doc/board/renesas/renesas.rst create mode 100644 doc/board/renesas/rzn1.rst diff --git a/doc/board/index.rst b/doc/board/index.rst index b2da6ec553..9040e16e01 100644 --- a/doc/board/index.rst +++ b/doc/board/index.rst @@ -33,6 +33,7 @@ Board-specific doc openpiton/index purism/index qualcomm/index + renesas/index rockchip/index samsung/index siemens/index diff --git a/doc/board/renesas/index.rst b/doc/board/renesas/index.rst new file mode 100644 index 0000000000..fb6558ec11 --- /dev/null +++ b/doc/board/renesas/index.rst @@ -0,0 +1,10 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +Renesas +======= + +.. toctree:: + :maxdepth: 2 + + renesas + rzn1 diff --git a/doc/board/renesas/renesas.rst b/doc/board/renesas/renesas.rst new file mode 100644 index 0000000000..33a21c64ac --- /dev/null +++ b/doc/board/renesas/renesas.rst @@ -0,0 +1,45 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +Renesas +======= + +About this +---------- + +This document describes the information about Renesas supported boards +and their usage steps. + +Renesas boards +-------------- + +Renesas is a SoC solutions provider for automotive and industrial applications. + +U-Boot supports several Renesas SoC families: + +* R-Car Gen2 (32-bit) + - Blanche board + - Gose board + - Koelsch board + - Lager board + - Silk board + - Porter board + - Stout board +* R-Car Gen3 (64-bit) + - Condor board + - Draak board + - Eagle board + - Ebisu board + - Salvator-X and Salvator-XS boards + - ULCB board +* R-Car Gen4 + - Falcon board + - Spider board + - Whitehawk board +* RZ/A1 (32-bit) + - GR-PEACH board +* RZ/G + - Beacon-rzg2 board + - Hihope-rzg2 board + - ek874 board +* RZ/N1 (32-bit) + - Schneider rzn1-snarc board diff --git a/doc/board/renesas/rzn1.rst b/doc/board/renesas/rzn1.rst new file mode 100644 index 0000000000..2750629e81 --- /dev/null +++ b/doc/board/renesas/rzn1.rst @@ -0,0 +1,77 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +Renesas RZ/N1 +============= + +Building +-------- + +This document describes how to build and flash U-Boot for the RZ/N1. + +U-Boot +^^^^^^ + +Clone the U-Boot repository and build it as follows: + +.. code-block:: bash + + git clone --depth 1 https://source.denx.de/u-boot/u-boot.git + cd u-boot + make rzn1_snarc_defconfig + make CROSS_COMPILE=arm-linux-gnu- + +This produces `u-boot` which is an ELF executable, suitable for use with `gdb` +and JTAG debugging tools. + +It also produceds `u-boot.bin` which is a raw binary. + +Binman +^^^^^^ + +The BootROM in the RZ/N1 SoC expects to find the boot image in SPKG format. +This format is documented in Chapter 7.4 of the RZ/N1 User Manual. + +The `binman` tool may be used to generate the SPKG format for booting. +This tool and its pre-requisites must be installed as per +:doc:`../../../tools/binman/binman.rst`` + +.. code-block:: bash + + binman -d arch/arm/dts/r9a06g032-rzn1-snarc.dtb -o + +This will produce `u-boot.bin.spkg` in the specified directory. It can +then be flashed into QSPI, NAND, or loaded via USB-DFU mode. + +SPKG image +^^^^^^^^^^ + +Alternatively, the same SPKG image can be built by calling `mkimage` as follows: + +.. code-block:: bash + + tools/mkimage -n board/schneider/rzn1-snarc/spkgimage.cfg \ + -T spkgimage -a 0x20040000 -e 0x20040000 \ + -d u-boot.bin u-boot.bin.spkg + +This produces `u-boot.bin.spkg` which can be flashed into QSPI, NAND, or loaded +via USB-DFU mode. + +Take note of the load and execution address, which are encoded into the SPKG +headers. For development convenience, mkimage computes the execution offset +(part of the SPKG header) by subtracting the supplied load address from the +supplied execution address. + +Also note there are other parameters, notably ECC configuration in the case of +boot from NAND, specified in the `spkgimage.cfg` configuration file. + +Flashing +-------- + +The RZ/N1 is able to boot from QSPI, NAND, or via USB (DFU). In all cases the +on-board BootROM expects for the binary to be wrapped with a "SPKG" header. + +It is possible to recover a bricked unit by using the USB (DFU) boot mode. This +allows uploading U-Boot into the internal RAM. Thereafter U-Boot can be used to +program the QSPI and/or NAND, making use of U-Boot dfu mode. + +Otherwise the only other option for recovery is via JTAG.