Interactive SD card to eMMC flasher and release script for Banana Pi BPI-F3 (riscv64) on openSUSE Tumbleweed.
Keywords: #opensuse #suse #tumbleweed #riscv64 #risc-v #bpif3 #bananapi #spacemitk1 #emmc #sdcard #flasher #installer #bianbu #dd
This repository provides a reproducible flashing workflow for moving an openSUSE Tumbleweed installation from an SD card to the internal eMMC on Banana Pi BPI-F3 systems.
The script supports both English and 한국어 prompts.
This workflow recreates the expected BPI-F3 eMMC GPT layout, flashes the vendor boot chain into the dedicated env, opensbi, and uboot partitions, copies the boot and root partitions from the selected openSUSE image, rewrites SD-card block-device references to the eMMC target, and writes bootinfo_emmc.bin plus FSBL.bin into the eMMC boot hardware area.
- Reference firmware bundle directory:
bianbu-23.10-nas-k1-v1.0rc1-release-20240429192450 - Reference image filename:
2024-09-09-openSUSE-Tumbleweed-RISC-V-LXQT.riscv64-rootfs.riscv64-2024.09.02-Build1.9.tar.xz-bpi-f3-7356MB.img - Download page: https://docs.banana-pi.org/en/BPI-F3/BananaPi_BPI-F3#_system_image
- Board: Banana Pi BPI-F3 / SpacemiT K1
- Architecture:
riscv64 - Host workflow: openSUSE Tumbleweed booted from SD card
- Default eMMC block device:
/dev/mmcblk2 - Default eMMC boot device:
/dev/mmcblk2boot0
bpi-f3-sdcard-emmc-flasher.shvalidates the host environment, confirms the target paths and devices, recreates the eMMC partition map, flashes the board-specific boot components, copies the boot and root filesystems from the selected image, updates boot-time storage references, writes the eMMC boot area, and optionally powers the machine off at the end.
Open a root shell before running the flasher.
The commands below are intended to be run as root.
chmod +x bpi-f3-sdcard-emmc-flasher.sh
./bpi-f3-sdcard-emmc-flasher.sh- Check that it is running as
rootand verify the required Linux utilities. - Confirm the firmware directory, OS image path, target eMMC device, and target
boot0device. - Wipe the target eMMC and recreate the fixed BPI-F3 partition layout:
env,opensbi,uboot,bootfs, androotfs. - Flash
env.bin,fw_dynamic.itb, andu-boot.itbinto the dedicated boot-chain partitions. - Attach the selected openSUSE image with
losetupand copy its first two partitions intobootfsandrootfs. - Mount the new eMMC filesystems and rewrite
env_k1-x.txt,armbianEnv.txt, and/etc/fstabso they point to the eMMC target instead of the SD card. - Unlock
boot0temporarily and writebootinfo_emmc.binplusFSBL.bin. - Print the final block-device layout and power the host off unless
--no-poweroffwas requested.
The latest release publishes the following assets:
bpi-f3-sdcard-emmc-flasher.sh
Banana Pi and the BPI-F3 / SpacemiT K1 platform provide the target hardware context for this workflow.
openSUSE provides the operating system environment used for the SD-card-to-eMMC migration workflow documented here.
itinfra7 is credited for the original BPI-F3 SD-card-to-eMMC flashing workflow and the script packaging behind this repository.