From mboxrd@z Thu Jan 1 00:00:00 1970 Delivery-date: Tue, 03 Feb 2026 18:34:17 +0100 Received: from metis.whiteo.stw.pengutronix.de ([2a0a:edc0:2:b01:1d::104]) by lore.white.stw.pengutronix.de with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1vnKI5-008TTu-2K for lore@lore.pengutronix.de; Tue, 03 Feb 2026 18:34:17 +0100 Received: from localhost ([127.0.0.1] helo=metis.whiteo.stw.pengutronix.de) by metis.whiteo.stw.pengutronix.de with esmtp (Exim 4.92) (envelope-from ) id 1vnKI4-0003WA-Sx; Tue, 03 Feb 2026 18:34:16 +0100 Received: from drehscheibe.grey.stw.pengutronix.de ([2a0a:edc0:0:c01:1d::a2]) by metis.whiteo.stw.pengutronix.de with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1vnKHz-0003P5-FP; Tue, 03 Feb 2026 18:34:11 +0100 Received: from dude04.red.stw.pengutronix.de ([2a0a:edc0:0:1101:1d::ac] helo=dude04) by drehscheibe.grey.stw.pengutronix.de with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1vnKHz-003wdV-2y; Tue, 03 Feb 2026 18:34:11 +0100 Received: from rhi by dude04 with local (Exim 4.98.2) (envelope-from ) id 1vnKHz-0000000GmbS-0o5S; Tue, 03 Feb 2026 18:34:11 +0100 From: Roland Hieber To: distrokit@pengutronix.de Date: Tue, 3 Feb 2026 18:33:15 +0100 Message-ID: <20260203173409.3995749-5-rhi@pengutronix.de> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260203173409.3995749-1-rhi@pengutronix.de> References: <20260203173409.3995749-1-rhi@pengutronix.de> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [DistroKit] [PATCH 5/5] doc: add FairyTux 2 documentation 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: Ahmad Fatoum , Roland Hieber 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.whiteo.stw.pengutronix.de); SAEximRunCond expanded to false From: Ahmad Fatoum These are the steps needed to flash the FairyTux 2 eMMC. Signed-off-by: Ahmad Fatoum Tested-by: Roland Hieber [rhi: ported from distrokit-fairytux; adapt the image paths and fastboot partition names, remove the unneccesary usbgadget call since it starts automatically at boot, reformulate to make the fastboot process a bit clearer, and add the short Maintenance Status section.] Signed-off-by: Roland Hieber --- doc/hardware_v7a_fairytux_2.rst | 55 +++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 doc/hardware_v7a_fairytux_2.rst diff --git a/doc/hardware_v7a_fairytux_2.rst b/doc/hardware_v7a_fairytux_2.rst new file mode 100644 index 000000000000..ca9350ab7cac --- /dev/null +++ b/doc/hardware_v7a_fairytux_2.rst @@ -0,0 +1,55 @@ +LXA FairyTux 2 +============== + +The FairyTux 2 is a Octavo STM32MP1 SiP-based board like the MC-1, +but unlike it, exclusively boots from eMMC. + +Initial Setup +------------- + +If the eMMC is unprovisioned, the system must be bootstrapped via USB DFU +initially. + +On your development host, run: + +.. code-block:: bash + + $ cd platform-v7a/images + $ dfu-util --alt 1 -D stm32mp1-tf-a-stm32mp153c-lxa-fairytux2.stm32 + $ dfu-util --alt 3 -D stm32mp153c-lxa-fairytux2.fip + $ dfu-util --alt 0 -e + +Or via Labgrid: + +.. code-block:: bash + + $ cd platform-v7a/images + $ labgrid-client dfu download 1 stm32mp1-tf-a-stm32mp153c-lxa-fairytux2.stm32 + $ labgrid-client dfu download 3 stm32mp153c-lxa-fairytux2.fip + $ labgrid-client dfu detach 0 + +Then flash the eMMC via Android Fastboot from your development host: + +.. code-block:: bash + + $ fastboot flash bbu-mmc stm32mp153c-lxa-fairytux2-emmcboot.img + +Now Barebox will start from the eMMC boot partition on future boots. + +Flashing the eMMC +----------------- + +When the board is running barebox, +you can populate the eMMC with the Linux and userspace image with Fastboot: + +.. code-block:: bash + + $ fastboot flash mmc1 lxa-fairytux2.hdimg + +When Fastboot has finished, type ``boot`` on the Barebox prompt. + +Maintenance Status +------------------ +Pengutronix has at least two board running in a remote lab (labgrid place names +``gutefee-00001`` (Gen 1) and ``gutefee-00011`` (Gen 2)). -- 2.47.3