From mboxrd@z Thu Jan 1 00:00:00 1970 Delivery-date: Fri, 31 Mar 2023 10:38:54 +0200 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 1piAHd-003vT6-KT for lore@lore.pengutronix.de; Fri, 31 Mar 2023 10:38:54 +0200 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 1piAHd-0005FM-I6; Fri, 31 Mar 2023 10:38:53 +0200 Received: from ptx.hi.pengutronix.de ([2001:67c:670:100:1d::c0]) by metis.ext.pengutronix.de with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1piAHX-0005Ek-VA; Fri, 31 Mar 2023 10:38:47 +0200 Received: from rhi by ptx.hi.pengutronix.de with local (Exim 4.92) (envelope-from ) id 1piAHX-0004zl-N0; Fri, 31 Mar 2023 10:38:47 +0200 Date: Fri, 31 Mar 2023 10:38:47 +0200 From: Roland Hieber To: Johannes Zink Message-ID: <20230331083847.hyi4wrr3x725mpdp@pengutronix.de> References: <20230324182952.501117-1-j.zink@pengutronix.de> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20230324182952.501117-1-j.zink@pengutronix.de> User-Agent: NeoMutt/20180716 Subject: Re: [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: distrokit@pengutronix.de, 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 On Fri, Mar 24, 2023 at 07:29:52PM +0100, Johannes Zink wrote: > 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. Hmm, "copy" could be misread as "cp" instead of "dd" here, which will not work… But that happens on more than just this one occurrence, I'll send a new patch. - Roland > 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 > > > -- Roland Hieber, Pengutronix e.K. | r.hieber@pengutronix.de | Steuerwalder Str. 21 | https://www.pengutronix.de/ | 31137 Hildesheim, Germany | Phone: +49-5121-206917-0 | Amtsgericht Hildesheim, HRA 2686 | Fax: +49-5121-206917-5555 |