From mboxrd@z Thu Jan 1 00:00:00 1970 Delivery-date: Fri, 24 Mar 2023 19:29:59 +0100 Received: from metis.ext.pengutronix.de ([2001:67c:670:201:290:27ff:fe1d:cc33]) by lore.white.stw.pengutronix.de with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1pfmAo-00DRaH-49 for lore@lore.pengutronix.de; Fri, 24 Mar 2023 19:29:59 +0100 Received: from localhost ([127.0.0.1] helo=metis.ext.pengutronix.de) by metis.ext.pengutronix.de with esmtp (Exim 4.92) (envelope-from ) id 1pfmAn-0008C5-MP; Fri, 24 Mar 2023 19:29:57 +0100 Received: from drehscheibe.grey.stw.pengutronix.de ([2a0a:edc0:0:c01:1d::a2]) by metis.ext.pengutronix.de with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1pfmAm-0008B8-6t; Fri, 24 Mar 2023 19:29:56 +0100 Received: from [2a0a:edc0:0:1101:1d::39] (helo=dude03.red.stw.pengutronix.de) by drehscheibe.grey.stw.pengutronix.de with esmtp (Exim 4.94.2) (envelope-from ) id 1pfmAl-006RaF-Ha; Fri, 24 Mar 2023 19:29:55 +0100 Received: from jzi by dude03.red.stw.pengutronix.de with local (Exim 4.94.2) (envelope-from ) id 1pfmAk-0026NN-Oo; Fri, 24 Mar 2023 19:29:54 +0100 From: Johannes Zink To: distrokit@pengutronix.de Date: Fri, 24 Mar 2023 19:29:52 +0100 Message-Id: <20230324182952.501117-1-j.zink@pengutronix.de> X-Mailer: git-send-email 2.30.2 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [DistroKit] [PATCH] doc: v8a: ROCK 3A: add documentation on writing barebox-only images to SD-Card and NOR Flash X-BeenThere: distrokit@pengutronix.de X-Mailman-Version: 2.1.29 Precedence: list List-Id: DistroKit Mailinglist List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Johannes Zink , jzi@pengutronix.de Sender: "DistroKit" X-SA-Exim-Connect-IP: 127.0.0.1 X-SA-Exim-Mail-From: distrokit-bounces@pengutronix.de X-SA-Exim-Scanned: No (on metis.ext.pengutronix.de); SAEximRunCond expanded to false It may be useful to sometimes only write a barebox image to SD-Card, e.g. for chainloading, TFTP-Boot or if Android Fastboot is used for flashing the actual full image to a storage medium. Add documentation on which image to use. Also add a short section about how to write barebox to the fallback NOR SPI Flash on the ROCK 3A board. Signed-off-by: Johannes Zink --- doc/hardware_v8a_rock3a.rst | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/doc/hardware_v8a_rock3a.rst b/doc/hardware_v8a_rock3a.rst index 75acd4d84613..3aa5a62ea8bd 100644 --- a/doc/hardware_v8a_rock3a.rst +++ b/doc/hardware_v8a_rock3a.rst @@ -5,7 +5,11 @@ Boot Media ---------- Copy the image ``platform-v8a/images/rock3a.img`` onto a microSD card. Put the -microSD card into the Rock 3A and boot it. +microSD card into the Rock 3A and boot it, the system will autoboot to linux. + +If you just want to boot to barebox instead of a full linux image from microSD card +(e.g. for chainloading or tftpboot), +copy the image ``platform-v8a/images/barebox-rock3a.norimg`` onto a microSD card instead. Alternatively, you may put the Rock 3A into MASKROM mode following the `Rock 3 Hardware User Manual `_ and boot @@ -19,6 +23,10 @@ Once Barebox is booted, copy the image ``platform-v8a/images/rock3a.img`` via tftp or NFS to the eMMC to persist it. Disable MASKROM mode and reboot the board to start from eMMC. +Once booted to linux, you can write ``platform-v8a/images/barebox-rock3a.norimg`` using mtd-utils +to the NOR flash, which can then be used as fallback boot source whenever booting from microSD +card or eMMC fails. + Serial Console -------------- -- 2.30.2