From mboxrd@z Thu Jan 1 00:00:00 1970 Delivery-date: Fri, 25 Aug 2023 12:54:11 +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 1qZUSC-008MmI-UU for lore@lore.pengutronix.de; Fri, 25 Aug 2023 12:54:11 +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 1qZUSA-000146-Kn; Fri, 25 Aug 2023 12:54:10 +0200 Received: from pty.hi.pengutronix.de ([2001:67c:670:100:1d::c5]) by metis.ext.pengutronix.de with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1qZUS8-00013w-Hp; Fri, 25 Aug 2023 12:54:08 +0200 Received: from rsc by pty.hi.pengutronix.de with local (Exim 4.94.2) (envelope-from ) id 1qZUS8-00EUA6-2h; Fri, 25 Aug 2023 12:54:08 +0200 Date: Fri, 25 Aug 2023 12:54:08 +0200 From: Robert Schwebel To: Juergen Borleis Message-ID: References: <20230825101559.29166-1-jbe@pengutronix.de> <20230825101559.29166-3-jbe@pengutronix.de> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20230825101559.29166-3-jbe@pengutronix.de> X-Sent-From: Pengutronix Hildesheim X-URL: http://www.pengutronix.de/ X-Accept-Language: de,en X-Accept-Content-Type: text/plain Subject: Re: [DistroKit] [PATCH 3/3] doc: RIoT: mention the 'fastboot' capabilities 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 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 Applied to next On Fri, Aug 25, 2023 at 12:15:59PM +0200, Juergen Borleis wrote: > Signed-off-by: Juergen Borleis > --- > doc/hardware_v7a_riot.rst | 66 +++++++++++++++++++++++++++++++++++++++ > doc/testing.rst | 2 ++ > 2 files changed, 68 insertions(+) > > diff --git a/doc/hardware_v7a_riot.rst b/doc/hardware_v7a_riot.rst > index 77b48cb..a6e2365 100644 > --- a/doc/hardware_v7a_riot.rst > +++ b/doc/hardware_v7a_riot.rst > @@ -24,3 +24,69 @@ The serial boot console is available at the debug-header J18 at 115200 Baud and > * J18.2: RxD > * J18.3: GND > > +Fast development > +---------------- > + > +For development the RIoT-Board bootloader supports 'fastboot'. Refer > +:ref:`fast_development` for Linux and BSP preparation on demand. > + > +RIoT i.MX6S > +~~~~~~~~~~~ > + > +The BSP already supports 'fastboot' and prepares the target accordingly. > +The PARTITION names might differ, so you should check first, what PARTITIONs > +are exported. > + > +To get the exported PARTITION names, available via 'fastboot', you can run:: > + > + $ fastboot getvar all > + (bootloader) version: 0.4 > + (bootloader) bootloader-version: barebox-2023.02.1 > + (bootloader) max-download-size: 8388608 > + (bootloader) partition-size:mmc1: 00000000 > + (bootloader) partition-type:mmc1: unavailable > + (bootloader) partition-size:mmc2: 00000000 > + (bootloader) partition-type:mmc2: unavailable > + (bootloader) partition-size:mmc3: e5000000 > + (bootloader) partition-type:mmc3: basic > + (bootloader) partition-size:ram-kernel: 00000000 > + (bootloader) partition-type:ram-kernel: file > + (bootloader) partition-size:ram-initramfs: 00000000 > + (bootloader) partition-type:ram-initramfs: file > + (bootloader) partition-size:ram-oftree: 00000000 > + (bootloader) partition-type:ram-oftree: file > + (bootloader) partition-size:bbu-emmc: 000e0000 > + (bootloader) partition-type:bbu-emmc: basic > + > +In this example, the PARTITION names are 'mmc1', 'mmc2', 'mmc3', 'ram-kernel', > +'ram-initramfs', 'ram-oftree' and 'bbu-emmc'. In this example the two possible > +SD cards are not plugged in (e.g. "unavailable"). > + > +.. note:: You need to restart the fastboot usbgadget, if you probe the SD cards > + later on. > + > +Just connect the USB OTG connector to your host and run:: > + > + $ fastboot flash ram-kernel platform-v7a/images/linuximage -S 1 > + $ fastboot flash ram-oftree platform-v7a/images/imx6dl-riotboard.dtb -S 1 > + $ fastboot flash ram-initramfs platform-v7a/images/root.cpio.gz -S 1 > + $ fastboot oem exec -- boot ram-fastboot > + > +You can populate local memory like the eMMC as well. But only full memory > +devices and no particular partitions. > + > +If inserted, the regular SD card:: > + > + $ fastboot flash mmc1 platform-v7a/images/riotboard.hdimg -S 1 > + > +If inserted, the µSD card:: > + > + $ fastboot flash mmc2 platform-v7a/images/riotboard.hdimg -S 1 > + > +The built-in eMMC:: > + > + $ fastboot flash mmc3 platform-v7a/images/riotboard.hdimg -S 1 > + > +.. note:: If you have no USB connection to the RIoT i.MX6S, you can use > + a network connection instead. Just run all the 'fastboot' commands > + shown above with the additional option '-s udp:'. > diff --git a/doc/testing.rst b/doc/testing.rst > index 83bdb71..ef477cb 100644 > --- a/doc/testing.rst > +++ b/doc/testing.rst > @@ -1,3 +1,5 @@ > +.. _fast_development: > + > Fast development > ================ > > -- > 2.30.2 > > > -- Pengutronix e.K. | Dipl.-Ing. Robert Schwebel | Steuerwalder Str. 21 | https://www.pengutronix.de/ | 31137 Hildesheim, Germany | Phone: +49-5121-206917-0 | Amtsgericht Hildesheim, HRA 2686 | Fax: +49-5121-206917-9 |