Deploy A Disk Image; Deploy On Sd Card; Deploy On Internal Emmc - Cherry JAGUAR SBC-RK3588-AMR User Manual

7 Deploy a disk image

This chapter describes how to write a disk image of the Debian 12 bookworm variant as generated in the pre-
vious chapter.
Note: The variable SDCARD_IMG must be already set as described in respective chapter.
Warning: Avoid having the disk image on both the SD Card and the internal eMMC of the module.
As the Linux kernel on the module uses PARTLABEL and PARTUUID to identify partitions to mount, it will be
unpredictable whether the SD Card or the internal eMMC is used.

7.1 Deploy on SD Card

Insert an SD card into the host PC and check dmesg -w to find out the device name that was used.
To flash the image on an SD card, bmaptool can be used, it is both faster and safer than a traditional dd. For
that, the .bmap companion file, automatically built by the Yocto Project or build.sh debos-recipes wrapper
script, should be in the same directory as the SDCARD_IMG artifact.
Then run the following command, with /dev/sdX replaced by the block device representing the user's SD card:
sudo bmaptool copy "$SDCARD_IMG"

7.2 Deploy on internal eMMC

7.2.1 Compile rkdeveloptool
To write the image directly onto the on-board eMMC, the flashing tool rkdeveloptool is used, and it must be
compiled on the host PC:
# Install compile dependencies
sudo apt-get -y install git libudev-dev libusb-1.0-0-dev dh-autoreconf pkg-config build-essential
# Download rkdeveloptool source code
git clone https://github.com/rockchip-linux/rkdeveloptool.git
cd rkdeveloptool
# Compile rkdeveloptool
autoreconf -i
CPPFLAGS=-Wno-format-truncation ./configure
make
# Download miniloaders used for flashing
git clone https://github.com/rockchip-linux/rkbin.git tools/rk_tools
# Build miniloader binaries
pushd tools/rk_tools/
# Tag linux-5.10-gen-rkr4.1
git checkout "1356c978"
./tools/boot_merger RKBOOT/RK3588MINIALL.ini
popd
v1.0.1
Page 24
/dev/sdX
(continues on next page)