From patchwork Sat May 13 01:36:58 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ralph Siemsen X-Patchwork-Id: 681593 Delivered-To: patch@linaro.org Received: by 2002:adf:fd8f:0:0:0:0:0 with SMTP id d15csp62658wrr; Fri, 12 May 2023 18:39:08 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ6x5jKgePz7OBHk4gH7JFrpBSUngAou9heBv20mPJYV9M6yDMCp4eLQCKonvHw2EplJMPJf X-Received: by 2002:a17:902:da92:b0:1ac:94b3:3ab4 with SMTP id j18-20020a170902da9200b001ac94b33ab4mr18623544plx.27.1683941948093; Fri, 12 May 2023 18:39:08 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1683941948; cv=none; d=google.com; s=arc-20160816; b=NnRzc3Lu4TCUC7Zzco9r9UE2DN9LyefYgZx00Kub/F1eb+plZtDOJIRC1mD/EcsiDT iAUTdnhlJEB2OscnV86rqlsDyfjaCF7+d5GFpzjmE3N2la/+ghTnrBj+9MDL6ovnVOTb TO0Z0x6gP2zQECTXynBiRxfzpheaqYUJJBv3N5looIk7Gq8YDkakzIppT0DSe941b0C4 xMFzdhNBypzmKo2KDrAP3J0Hq97JqWKBPclow0RKjNmtvOXwiz4uKFuEGFftwS+ZLdSE lel48jcvfD3Km4gDD36Inu/r/r6pv1dvAXUiYnSaib1zC/ajqa+1LyfVZqVVMaFKQGOf Dl1A== 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=kANjpf3SikwHmeLu2D1otlJSlk70NCt5LjlVmg7EuHM=; b=yqAZPrGCCt2rmVEsNA9BmM7rw9ZqMk9O2qDm9Ak4mtDvaQIEaDKN4GRPSelx6BpaNi BWs+sJS8tWCI6ABTYUxjSbVReSRwKjMy7duVxACOwGXwBQTz347kuK5gVpJUpoJY19FO Rwi3gn5JfGh1jzRDLwtsHW/NPRrCxrWnHsK30vBcgGbP1uukBDrvRjeBXPZ4cxIHawAV i1Kf9umiezaWnypTRO8Oa+sfvtBhB5b7GmkoLE0ZIzwqz62cyDzB3fKpg6tPjOsFioeC bJhOZmvuL2HRWl22MiKS3wMhMYWlj98Z2FVIo9zfudd+ax6qs9gIF632EwREUrGl7WLN JS+w== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=cvPandN8; spf=pass (google.com: domain of u-boot-bounces@lists.denx.de designates 85.214.62.61 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. [85.214.62.61]) by mx.google.com with ESMTPS id z1-20020a170902708100b0019f25dae4f5si10052347plk.198.2023.05.12.18.39.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 May 2023 18:39:08 -0700 (PDT) Received-SPF: pass (google.com: domain of u-boot-bounces@lists.denx.de designates 85.214.62.61 as permitted sender) client-ip=85.214.62.61; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=cvPandN8; spf=pass (google.com: domain of u-boot-bounces@lists.denx.de designates 85.214.62.61 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 010B286357; Sat, 13 May 2023 03:37:31 +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="cvPandN8"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id C6BF48630B; Sat, 13 May 2023 03:37:21 +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-x72c.google.com (mail-qk1-x72c.google.com [IPv6:2607:f8b0:4864:20::72c]) (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 E021486332 for ; Sat, 13 May 2023 03:37:16 +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-x72c.google.com with SMTP id af79cd13be357-7577ef2fa31so2133726885a.0 for ; Fri, 12 May 2023 18:37:16 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1683941836; x=1686533836; 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=kANjpf3SikwHmeLu2D1otlJSlk70NCt5LjlVmg7EuHM=; b=cvPandN898xVUS16xElRGuk+3vIqZa3ykKo0W09H5rXkk6wj/dy403vFlqjCEbl3CT 4zv25TKLkRyyMueq0pgGPO9i/oPjtIiEWN8/RznrdUqwASkqeB1n3jDW+1mX54/EChP8 8toPwY3so8T8NddsONVWseiOjvTJrP0yw4aI/+iAnJ5KL7i0wqgNCeebNmFNvOSjtGxu G2LPbKlrEYLvgktJ61UmRp+0dFofKf1ZaFVQ52VD9yYXJVIg43zH1SgtLkgfVUHhCE5d HQVepMZZEfwUx1Wx7sJswzJLdG0yAchkMXey2r87A8y/BRbWsC7v5ob7AoDCLj5D2kpn m2mg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1683941836; x=1686533836; 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=kANjpf3SikwHmeLu2D1otlJSlk70NCt5LjlVmg7EuHM=; b=SMXMksvUhnE81reaPBe7QLkjYtQ397jRSTsJRsLZjSXYXD5SK0TZ48K9ZNM/yQUeDn O0VFTcE+tJaR0eepOWu37mJZ9SvvzQSneLPyxB7UWazsncVeCRH4g2hSKc+HHDam0w5e tq876BvGggcFCJIxqq1XjZy+pQizp0e0NjNWIseVDfaoTbCeD+YQeMhlmTwXrO+Nljhj oHIdWCb9ZUeRoakL8fI2+6u5KxHZ2YbAWl9SMAr9/hQeTwwV/+TmSq5EBWZWeWgQ9x3t uxXeOopZgGZmuZqpSWl0ssr9HkvkyyG40NJ2DAEd8x4j1E8P6lqDAFSoABJl8D3w5h6p yZXA== X-Gm-Message-State: AC+VfDzI2h37/NCfZwu8vDtsJvVDYp8VLKFklm6kNxtrlS/088fzgq87 2yJR62yXbPIM3zESdJflvkpazSjYTsJA9oSvFd7REw== X-Received: by 2002:ad4:5aa5:0:b0:5ef:8161:cb9a with SMTP id u5-20020ad45aa5000000b005ef8161cb9amr61446331qvg.7.1683941835656; Fri, 12 May 2023 18:37:15 -0700 (PDT) Received: from maple.netwinder.org (rfs.netwinder.org. [206.248.184.2]) by smtp.gmail.com with ESMTPSA id fi19-20020a0562141a5300b0061b608dc4c1sm3379399qvb.94.2023.05.12.18.37.14 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 May 2023 18:37:15 -0700 (PDT) From: Ralph Siemsen To: u-boot@lists.denx.de Cc: Marek Vasut , Ralph Siemsen , Marek Vasut , Adam Ford , Angus Ainslie , Fabio Estevam , Sebastian Krzyszkowiak , Tim Harvey , Weijie Gao , Yanhong Wang Subject: [PATCH v7 10/10] doc: renesas: add Renesas board docs Date: Fri, 12 May 2023 21:36:58 -0400 Message-Id: <20230513013658.2330651-11-ralph.siemsen@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230513013658.2330651-1-ralph.siemsen@linaro.org> References: <20230513013658.2330651-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 v7: - replace broken link to binman.rst 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 | 76 +++++++++++++++++++++++++++++++++++ 4 files changed, 132 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..04dee8da24 --- /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 (64-bit) + - 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..e6d636b89e --- /dev/null +++ b/doc/board/renesas/rzn1.rst @@ -0,0 +1,76 @@ +.. 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. +See tools/binman/binman.rst for details on this tool and its pre-requisites. + +.. 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.