From mboxrd@z Thu Jan 1 00:00:00 1970 Delivery-date: Fri, 25 Aug 2023 12:16:07 +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 1qZTrM-008L1I-Re for lore@lore.pengutronix.de; Fri, 25 Aug 2023 12:16:07 +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 1qZTrK-0004wX-RZ; Fri, 25 Aug 2023 12:16:06 +0200 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 1qZTrE-0004uh-Rf for distrokit@pengutronix.de; Fri, 25 Aug 2023 12:16:00 +0200 Received: from [2a0a:edc0:0:900:1d::45] (helo=ginster) by drehscheibe.grey.stw.pengutronix.de with esmtp (Exim 4.94.2) (envelope-from ) id 1qZTrE-001ULz-7A for distrokit@pengutronix.de; Fri, 25 Aug 2023 12:16:00 +0200 Received: from jbe by ginster with local (Exim 4.94.2) (envelope-from ) id 1qZTrD-0007bI-Gv for distrokit@pengutronix.de; Fri, 25 Aug 2023 12:15:59 +0200 From: Juergen Borleis To: distrokit@pengutronix.de Date: Fri, 25 Aug 2023 12:15:59 +0200 Message-Id: <20230825101559.29166-3-jbe@pengutronix.de> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20230825101559.29166-1-jbe@pengutronix.de> References: <20230825101559.29166-1-jbe@pengutronix.de> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Subject: [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: , 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 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