From patchwork Wed Mar 8 20:26:53 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ralph Siemsen X-Patchwork-Id: 660467 Delivered-To: patch@linaro.org Received: by 2002:adf:a3c6:0:0:0:0:0 with SMTP id m6csp523792wrb; Wed, 8 Mar 2023 12:29:22 -0800 (PST) X-Google-Smtp-Source: AK7set9IVa6qyncsnJjFdSuPkOjiUUWH7IpCJ8fV6wU8hhB2nk8vXlYAkqzfF5nbedcVrAs9MTCA X-Received: by 2002:a05:6830:3a0a:b0:690:eb17:89f4 with SMTP id di10-20020a0568303a0a00b00690eb1789f4mr11933778otb.3.1678307362117; Wed, 08 Mar 2023 12:29:22 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1678307362; cv=none; d=google.com; s=arc-20160816; b=KZOwG8byFQVpjyvNq+W089/X1CGoyj0sZeB9HmmYfYToe/w8ksgyyQHsIh6lCyDvRB LNGCLQhWjQgAnfe05604LLHenwi44rYMLkTmGvdMIhXe5ff3s0r1ylWe/eYJ6fSUC8+I B/TOmscY29x/xoOZKbKsd///eOhHGa/U9rHO8KHE7YqbyNhC2AN8h+vR5KTS4adi4gBa JG6+4aLTZ1v23ZmjwUVkcYCuWxD8xOsEIVqhtVlnDT3elXf4PFu7xdyXNyABuqYJU9RI IabT26synFpjoJ+p4V3U+CnsBMsqMxwL8MdX48kj4lZkm3JZBXZNXJV3e8pEPm+Y1YzO H1bA== 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=aTO4y/S5S8xbLiUHIE3OfIvXUCmsEgPjDYbBnYvRmIA=; b=o4PzAVUPgdPR4Z1JCYkSHXb/oP6R/guRLD3hyr4Aib600KqvWHdhQnqpDhKyYKp76L KmkOs+v2n+4z3tW4/tOvR+fjEyhC0/NB91cSm6wNhV4z1NUwK7MXPdYFWax9CuZfouMF ag8psdSYGbTJryHkVqXInMSoZhTmZcWRzAVGkpBoMm/VcpuYwrfQSBHJKx1BiqXBWKbm 6fnrEVAfOXH9R12jXNrnHtRN3pSNnmoAVV8uFEJrlIlCEiw7ugDd3KCB4ex4ywsbFnSn 6sZHriOMQJWgKsjtCoshzAvPXPs6cH+zL6J4UB8bewRPk8gWE3ZHquCTLiLG5VTRt5bt xZvA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=bNrxbkOu; 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 j20-20020a056830015400b0068bbff481c0si16050057otp.25.2023.03.08.12.29.21 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 08 Mar 2023 12:29:22 -0800 (PST) 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=bNrxbkOu; 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 6DB4685EE3; Wed, 8 Mar 2023 21:28:14 +0100 (CET) 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="bNrxbkOu"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 1D50785EAF; Wed, 8 Mar 2023 21:27:35 +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=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.2 Received: from mail-qt1-x82f.google.com (mail-qt1-x82f.google.com [IPv6:2607:f8b0:4864:20::82f]) (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 30AB785E99 for ; Wed, 8 Mar 2023 21:27:15 +0100 (CET) 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-qt1-x82f.google.com with SMTP id r16so17887255qtx.9 for ; Wed, 08 Mar 2023 12:27:15 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1678307234; 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=aTO4y/S5S8xbLiUHIE3OfIvXUCmsEgPjDYbBnYvRmIA=; b=bNrxbkOupmkiPMNIDJg+9garbdLeqzu9O+fIimN4V6nAlpWsqKx0F5BPHcvibosAbF dPSYs3oTCi+8poIMEUOC9U0PO2FcRNYPrqlpcDXplFbqy0InooGLq3wxK+4md9Km9wX/ SYNzqdkpZaZfDP4HGndJBTQTYxEV04xsp2I1FWaaoNTtobX8IDLVc08YuU+MF8iIVNXq 0qPqRnMTCxSWQt4/Wu++bdNEqv2JfXqT+fkV7DQbJ5WfnqdPFNxAPaoTYWwKRyg8eCTY IZDumOIbSCwyAM6e8CVh8u7AqA3qKahpKzvqnhSOznnAYlIltJ9TZUt6UmcTTfzTAD8Q Y4pQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1678307234; 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=aTO4y/S5S8xbLiUHIE3OfIvXUCmsEgPjDYbBnYvRmIA=; b=INeaRwIq90oQ48kRWs0YPYf4tXSfU/DY85Wcj/XLMck8jze0xx1IK7afFRenyG0xuz PnawkM1+SLAXXV9ijmhXWjW72oGL6adq/vY6HH/oaMDdKHhWF7li5ICcljqykCIWJv5r Uc9ijNvNIbPya1ocPtv+Zk0e21LRKaq/0dHOSkoviOWJG34nF7Ag6H5iLELk2JFjMPq4 m+JOcPCN6yYuqvRXZxpm1ebShNkK8n6Czod1AF5I17Ie2/SzSbt4YqfQtIsuidKIhBcV CbfPdy98cWi8yjDdjSHu1Ei4VITwtq1/ICUtMr2ivvaB8lItM31AJJnozz5GU2Rl5dA7 VI/A== X-Gm-Message-State: AO0yUKVic64Qo7qvsiQB2i1PByIBqO/zFtnN2nIuv7L0JiQ5gd+8VdL4 5XdfiqgEni7MZC6cyKpoyH/5G2mkicCKPMsd/9aWnQ== X-Received: by 2002:ac8:7f52:0:b0:3bf:bbb9:a301 with SMTP id g18-20020ac87f52000000b003bfbbb9a301mr34926268qtk.14.1678307233925; Wed, 08 Mar 2023 12:27:13 -0800 (PST) Received: from maple.netwinder.org (rfs.netwinder.org. [206.248.184.2]) by smtp.gmail.com with ESMTPSA id m2-20020ac84442000000b003b86b088755sm12144203qtn.15.2023.03.08.12.27.13 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 08 Mar 2023 12:27:13 -0800 (PST) From: Ralph Siemsen To: u-boot@lists.denx.de Cc: Marek Vasut , Ralph Siemsen Subject: [PATCH v4 10/10] doc: renesas: add Renesas board docs Date: Wed, 8 Mar 2023 15:26:53 -0500 Message-Id: <20230308202653.1926303-11-ralph.siemsen@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230308202653.1926303-1-ralph.siemsen@linaro.org> References: <20230308202653.1926303-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 Collect the list of currerently supported Renesas boards. For the RZ/N1 board, add details about booting and flashing. Signed-off-by: Ralph Siemsen --- (no changes since v1) doc/board/renesas/index.rst | 9 +++ doc/board/renesas/renesas.rst | 115 ++++++++++++++++++++++++++++++++++ 2 files changed, 124 insertions(+) create mode 100644 doc/board/renesas/index.rst create mode 100644 doc/board/renesas/renesas.rst diff --git a/doc/board/renesas/index.rst b/doc/board/renesas/index.rst new file mode 100644 index 0000000000..3244c9d45e --- /dev/null +++ b/doc/board/renesas/index.rst @@ -0,0 +1,9 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +Renesas +======= + +.. toctree:: + :maxdepth: 2 + + renesas diff --git a/doc/board/renesas/renesas.rst b/doc/board/renesas/renesas.rst new file mode 100644 index 0000000000..5ae84004cf --- /dev/null +++ b/doc/board/renesas/renesas.rst @@ -0,0 +1,115 @@ +.. 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 industrial applications. + +U-boot supports several Renesas SoC families: + +* rcar gen1/gen2 (32-bit) + - Blanche board + - Gose board + - Koelsch board + - Lager board + - Silk board + - Porter board + - Stout board +* rcar gen3 (64-bit) + - Condor board + - Draak board + - Eagle board + - Ebisu board + - Falcon board + - Salvator-x board + - Ulcb board + - Beacon-rzg2 board + - Hihope-rzg2 board + - ek874 board +* rza1 (32-bit) + - GR-PEACH board +* rzn1 (32-bit) + - Schneider rzn1-snarc board + +Building +-------- + +NOTE: the following information is for the rzn1 board only. + +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. + +SPKG image +^^^^^^^^^^ + +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 raw u-boot binary can be wrapped into SPKG format 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. + +Binman +^^^^^^ + +Alternatively `binman` 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. + +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. +This format is detailed in the RZ/N1 User Manual, and can be produced using +the u-boot `mkimage` utility. + +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.